# Hisi_Brandy **Repository Path**: cooperation-team-L0UI/hisi_brandy ## Basic Information - **Project Name**: Hisi_Brandy - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2025-05-27 - **Last Updated**: 2025-12-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 当前代码仓为支持海思Brandy芯片解决方案SDK包，该SDK包从海思统一开发平台HiSpark构建而来，支持开发者在海思芯片平台快速开发Watch应用和表盘。 # 目录介绍 | 目录 | 说明 | | :------------------------------------------ | :-------------------------------------- | | docs/ | 存放文档及相关配图 | | src/application/wearable/jsapp/ | **JS应用开发参考示例** | | src/application/wearable/res/ | 存放手表图形显示所需的图片资源 | | src/tools/bin/graphic_tools/ | 存放Watch应用开发和离线表盘制作相关脚本 | | src/tools/pkg/fwpkg/brandy/upload_app.fwpkg | **用于烧录的镜像文件** | | tools/ | 存放开发工具及环境构建指南文档 | | vendor/ | 存放合作厂商的开发板硬件和软件资料 | # 开发板说明 | 类型 | 内容 | | :--------------- | ------------------------------------------------------------ | | 支持的开发板名称 | brandy_evb开发板 | | 开发板介绍 | brandy_evb开发板是一款高度集成的轻智能手表开发板，支持OpenHarmony轻量系统 | | 开发板示意图 | ![开发板示意图](docs/figures/zh-cn_image_0000002308344853.png) | | 开发板获取 | 开发板获取请联系：[liliangqi@huawei.com](mailto:liliangqi@huawei.com) | # 开发板配套工具 使用海思Brandy 开发板开发Watch应用和表盘所需配套工具如下： 1. **RJ45转USB串口调试线2根** 2. **Type-C数据充电线1根** 3. **烧录工具BurnTool** 4. **传文件工具DebugKits** 5. **串口调试工具** Brandy开发板使用RJ45网口转接线连接PC，通过BurnTool工具烧录镜像文件，通过DebugKits工具推送应用包和表盘文件到开发板端，通过串口调试工具抓取日志和发送AT命令。 其中烧录工具BurnTool和推送文件工具DebugKits是海思提供的专属工具，目前这两个工具以及串口调试都已集成在海思的[HiSpark Studio IDE](https://gitee.com/HiSpark/fbb_bs2x/blob/master/tools/HiSparkStudio%E5%B7%A5%E5%85%B7%E4%B8%8B%E8%BD%BD%E5%8F%8A%E5%AE%89%E8%A3%85.md)工具中。 ## 串口调试线 Brandy开发板提供两个RJ45网口，其中一个网口用于烧录镜像/推送文件，另一个网口用于抓取日志，**不可混用**。开发者根据使用的PC类型选择对应的调试线（**需自行购买**）： - USB转RJ45调试线 - Type-C转RJ45调试线 | USB转RJ45 Console调试线 | Type-C转RJ45 Console调试线 | | :---------------------------------------- | :---------------------------------------------- | | ![usb调试线](docs/figures/usb_2_rj45.png) | ![type_c调试线](docs/figures/type_c_2_rj45.png) | **注意**：购买时须选择“Console调试线”类型的转接线！ ## Type-C口充电线 Brandy开发板采用一根Type-C数据线进行供电。供电线为普通Type-C数据线，可以通过PC供电，也可以用电源适配器供电。 ## 烧录工具：BurnTool - **工具获取方式一**：通过安装HiSpark Studio IDE工具获取BurnTool，[点我查看](https://gitee.com/HiSpark/fbb_bs2x/blob/master/tools/HiSparkStudio%E5%B7%A5%E5%85%B7%E4%B8%8B%E8%BD%BD%E5%8F%8A%E5%AE%89%E8%A3%85.md) HiSpark Studio安装完成后，BurnTool工具路径如下：**`C:\Program Files\HiSpark Studio\tools\cfbb\BurnTool`** - **工具获取方式二**：通过BurnTool安装包单独安装，安装包获取请联系开发板提供方。 ## 传文件工具：DebugKits - **工具获取方式一**：通过安装HiSpark Studio IDE工具获取DebugKits，[点我查看](https://gitee.com/HiSpark/fbb_bs2x/blob/master/tools/HiSparkStudio%E5%B7%A5%E5%85%B7%E4%B8%8B%E8%BD%BD%E5%8F%8A%E5%AE%89%E8%A3%85.md) HiSpark Studio安装完成后，DebugKits工具路径如下：**`C:\Program Files\HiSpark Studio\tools\cfbb\DebugKits_3.0.116`** - **工具获取方式二**：通过DebugKits安装包单独安装，安装包获取请联系开发板提供方。 ## 抓日志工具：串口调试工具 - **工具获取方式一**：安装SSCOM等串口调试工具。SSCOM工具获取，[点我查看](http://www.daxia.com/) 串口工具波特率建议设置为115200，端口号需要连接到日志端口。 - **工具获取方式二**：通过安装HiSpark Studio IDE工具获取串口调试工具，[点我查看](https://gitee.com/HiSpark/fbb_bs2x/blob/master/tools/HiSparkStudio%E5%B7%A5%E5%85%B7%E4%B8%8B%E8%BD%BD%E5%8F%8A%E5%AE%89%E8%A3%85.md) HiSpark Studio安装完成后，新建工程，然后新建终端，切换到"监视器"选项卡，即可使用串口调试： 1. 将Brandy SDK仓库clone/下载到本地，比如下载到**D:\jsapp**目录 2. 打开HiSpark Studio，进入欢迎页面，单击"新建工程"，进入新建工程页面 ![新建工程](docs/figures/zh-cn_image_0000002274384325.png) 3. 在新建工程窗口配置工程参数，可参考下图图示信息，单击“完成” ![配置工程](docs/figures/zh-cn_image_0000002281862837.png) 4. 工程创建完成后，点击菜单栏"终端->新建终端"，找到IDE下方终端区域，切换到"监视器"选项卡，即可使用串口调试 ![终端监视器](docs/figures/zh-cn_image_0000002264202130.png) # 开发板镜像烧录 ## 开发板连线 注意：开发板上有两个网口，其中一个网口专门用于抓取日志，另一个网口用于烧录镜像文件或推送文件，**一定不要插错网口！！！**如果要切换抓取日志网口和推送文件网口，要先在对应的工具里断开已连接的COM端口。 ![开发板连线](docs/figures/zh-cn_image_0000002308344853.png) 1. 使用一根Type-C充电线给开发板供电 2. 将表盘安装在图示位置，亮屏按钮即为开发板HOME键 3. 使用两根USB转RJ45调试线与PC端相连（建议使用两根调试线，避免频繁切换） 4. USB转RJ45调试线连接后查看设备管理器，可以看到新增的两个端口（本例为COM4、COM5） ![端口设备](docs/figures/zh-cn_image_0000002308393165.png) ​ 注意：如果未看到新增端口，考虑安装USB转串口驱动FT232_Driver（可通过公开渠道获取或联系开发板提供方） ## 镜像烧录 - ### **镜像烧录方式一**：使用BurnTool工具烧录 1. 打开BurnTool工具，配置波特率和芯片型号（烧录工具波特率建议设置为500000，芯片须配置为Sparta） ![烧写波特率](docs/figures/burntool_baud.png) ![烧写芯片](docs/figures/burntool_chip.png) 2. 点击select file选择Brandy SDK包中的镜像文件upload_app.fwpkg，点击烧录，然后拔插开发板电源线开始烧录 Brandy SDK包镜像文件路径：**`src/tools/pkg/fwpkg/brandy/upload_app.fwpkg`** ![开始烧写](docs/figures/burntool_start.png) **注意**：不可在烧录过程中突然断电，要下电先点击 "Stop burn"（点击Start burn后该按钮会变成Stop burn） 3. 查看BurnTool烧录进度条和烧录过程打印信息，烧录完成后开发板会自动重启 - ### **镜像烧录方式二**：使用HiSpark Studio工具烧录 1. 将当前仓库clone/下载到本地，比如下载到**D:\jsapp**目录 2. 打开HiSpark Studio，进入欢迎页面，单击"新建工程"，进入新建工程页面 ![新建工程](docs/figures/zh-cn_image_0000002274384325.png) 3. 在新建工程窗口配置工程参数，可参考下图图示信息，单击“完成” ![配置工程](docs/figures/zh-cn_image_0000002281862837.png) 4. 在HiSpark Studio工具中点击“工程配置”按钮，选择“程序加载”，传输方式选择“serial”，端口选择用于烧录的“COM”端口 ![工程配置](docs/figures/zh-cn_image_0000002274253574.png) 5. 配置完成后，点击工具“程序加载”-> “烧录配置”按钮烧录 ![程序加载](docs/figures/zh-cn_image_0000002308836225.png) 6. 出现“Connecting, please reset device...”字样时，拔插开发板电源线，等待烧录结束 ![开始烧录](docs/figures/zh-cn_image_0000002274274882.png) 7. 在HiSpark Studio底端选择“监视器”，选择端口用于抓取日志的“COM”端口，如果没有端口显示可以刷新一下，点击“开始监视”，拔插开发板电源线，出现“code start codeloader”字样代表编译烧录成功 ![烧录成功](docs/figures/zh-cn_image_0000002274339970.png) # 开发板图片资源文件推送 首次烧录镜像包开机后，如果开发板显示屏正常显示开机Logo和时间表盘，则跳过本节内容。 如果正常开机后显示黑屏，按HOME键无法看到时间表盘，则考虑黑屏原因为开发板未装载图片显示资源，此时需要参考以下步骤通过DebugKits工具将Brandy SDK包中的res资源文件夹推送到开发板端。 1. 通过串口工具发送三个AT命令设置开发板屏幕为常亮状态（即保持开发板不息屏） 以下发送AT命令操作以HiSpark Studio IDE工具为例说明。 ![常亮命令](docs/figures/zh-cn_image_0000002281955953.png) ① 通过HiSpark Studio打开监视器功能 ② 选择日志打印所在的COM端口 ③ 点击开始监视 ④ 通过监视器下方的输入文本框依次输入以下三个AT命令: ​ `AT^PMADDVOTE` ​ `AT^SETSCREENFUNC=0` ​ `AT^SETSCREENSTATE=ON` **注意**：输入AT命令时，须保持屏幕亮屏，且每个AT命令返回OK~后才能输入下一个AT命令。 2. 通过DebugKits工具推送res资源文件夹到开发板端 ![推送res目录](docs/figures/zh-cn_image_0000002281948993.png) ① 点击connect连接图标，选择推送文件COM端口，设置波特率115200 ② 打开工具栏的"System"功能 ③ 选择左侧控制面板的“Uploading And Downloading”菜单 ④ 选择“To Board”选项卡 ​ “To Board”：将PC端文件或目录推送到开发板端； ​ “From Board"：将开发板端的文件下载到PC端，或删除开发板端的文件/目录。 ⑤ 点击"Choose Folder"按钮选择Brandy SDK包中的res目录，如图⑥所示 ⑦ 在"Board File Path" 输入框中输入开发板端路径"/user"（请勿更改此路径！! res资源在开发板端的路径固定） ⑧ 点击“Upload”按钮开始推送（整个推送过程大约需要1小时左右） **注意**：点击”Upload"前，需要通过串口工具发送AT命令使开发板屏幕为常亮状态！ # Watch应用开发、推送安装和卸载 ## Watch应用开发指导 1. 应用开发工具：[点我查看](https://gitee.com/cooperation-team-L0UI/doc/tree/master/应用开发工具) 2. API接口：[点我查看](https://gitee.com/cooperation-team-L0UI/doc/blob/master/运动表应用开发/readme.md) 3. 应用开发Demo：[点我查看](https://gitee.com/openharmony/xts_acts/tree/master/validator_lite/acts_validator) 4. 多分辨率适配：[点我查看](https://gitee.com/cooperation-team-L0UI/doc/blob/master/运动表应用开发/其他/watch应用多分辨率的适配.md) ## Watch应用推送安装和卸载 在海思Brandy开发板上安装Watch应用需要先将编译出来的应用包推送到开发板上，然后通过串口发送AT命令进行安装或卸载。 1. 通过串口工具发送三个AT命令设置开发板屏幕为常亮状态（即保持开发板不息屏） 以下发送AT命令操作以HiSpark Studio IDE工具为例说明。 ![常亮命令](docs/figures/zh-cn_image_0000002281955953.png) ① 通过HiSpark Studio打开监视器功能 ② 选择日志打印所在的COM端口 ③ 点击开始监视 ④ 通过监视器下方的输入文本框依次输入以下三个AT命令: ​ `AT^PMADDVOTE` ​ `AT^SETSCREENFUNC=0` ​ `AT^SETSCREENSTATE=ON` **注意**：输入AT命令时，须保持屏幕亮屏，且每个AT命令返回OK~后才能输入下一个AT命令。 2. 通过DebugKits工具将编译生成的应用包推送到开发板端 ![推送应用包](docs/figures/zh-cn_image_0000002281948939.png) ① 点击connect连接图标，选择推送文件COM端口，设置波特率115200 ② 打开工具栏的"System"功能 ③ 选择左侧控制面板的“Uploading And Downloading”菜单 ④ 选择“To Board”选项卡 ​ “To Board”：将PC端文件或目录推送到开发板端； ​ “From Board"：将开发板端的文件下载到PC端，或删除开发板端的文件/目录。 ⑤ 点击"Choose File"按钮选择Dev Eco Studio编译生成的应用包，如图⑥所示 ⑦ 在"Board File Path" 输入框中输入开发板端路径，比如："`/user/jsapp/sample.bin`"（应用包路径和名称可自定义） ⑧ 点击“Upload”按钮开始推送 **注意**：点击”Upload"前，需要通过串口工具发送AT命令使开发板屏幕为常亮状态！ 3. 通过串口工具发送AT命令安装应用 ① 打开串口调试工具，选择开发板串口日志COM端口进行连接 ② 在串口中发送如下AT命令安装应用包：**`AT^OHOSFWK_BM_INSTALL=/user/jsapp/sample.bin`** ③ 当需要覆盖安装时，AT命令为：**`AT^OHOSFWK_BM_INSTALL=/user/jsapp/sample.bin rmdata`** ​ **注意**：此命令将删除应用沙箱中的历史数据。 如果在安装应用时不想进行签名校验或者签名校验失败了，可以在安装应用前通过串口发送如下AT命令手动关闭应用签名：**`AT^OHOSFWK_BM_SET=disable`** 4. 通过串口工具发送AT命令卸载应用 ① 在串口中发送如下AT命令查询已安装应用的包名：**`AT^OHOSFWK_BM_GET_APPLIST`** ② 根据应用包名发送如下AT命令进行应用卸载，以example应用包名为例：**`AT^OHOSFWK_BM_UNINSTALL=com.example.myapplication`** 5. 通过DebugKits工具将开发板端的应用包删除 ![删除应用包](docs/figures/zh-cn_image_0000002281948994.png) ① 点击connect连接图标，选择推送文件COM端口，设置波特率115200 ② 打开工具栏的"System"功能 ③ 选择左侧控制面板的“Uploading And Downloading”菜单 ④ 选择“From Board”选项卡 ​ “To Board”：将PC端文件或目录推送到开发板端； ​ “From Board"：将开发板端的文件下载到PC端，或删除开发板端的文件/目录。 ⑤ 在“File Path”输入框中输入开发板端应用包的上一级目录路径，比如：**`/user/jsapp/`** ⑥ 点击“Get File List”按钮，（点击前需要让开发板处于亮屏状态） ⑦ 点击完成后在"File Name"显示框会出现目录下的文件，比如：sample.bin ⑧ 点击“Delete”按钮开始删除 **注意**：点击“Get File List”和”Delete"前，需要通过串口工具发送AT命令使开发板屏幕为常亮状态！ # 离线表盘制作、推送安装和卸载 ## Watch表盘开发指导 当前仓库SDK包仅支持Watch表盘协议1.0版本，暂不支持表盘协议2.0版本。 以下操作，如无特殊说明，均为满足表盘协议1.0版本的表盘方案。 1. 离线表盘方案介绍，[点我查看](https://gitee.com/cooperation-team-L0UI/hisi_brandy/blob/master/docs/Brandy%20%E7%A6%BB%E7%BA%BF%E8%A1%A8%E7%9B%98%20%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97.md#%E6%96%B9%E6%A1%88%E4%BB%8B%E7%BB%8D) 2. 离线表盘制作，[点我查看](https://gitee.com/cooperation-team-L0UI/hisi_brandy/blob/master/docs/Brandy%20%E7%A6%BB%E7%BA%BF%E8%A1%A8%E7%9B%98%20%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97.md#%E8%A1%A8%E7%9B%98%E5%88%B6%E4%BD%9C) 3. 离线表盘参考Demo，[点我查看](https://gitee.com/cooperation-team-L0UI/hisi_brandy/tree/master/src/tools/bin/graphic_tools/dial_converter_tool) ## Watch表盘推送安装和卸载 1. 通过串口工具发送三个AT命令设置开发板屏幕为常亮状态（即保持开发板不息屏） 以下发送AT命令操作以HiSpark Studio IDE工具为例说明。 ![常亮命令](docs/figures/zh-cn_image_0000002281955953.png) ① 通过HiSpark Studio打开监视器功能 ② 选择日志打印所在的COM端口 ③ 点击开始监视 ④ 通过监视器下方的输入文本框依次输入以下三个AT命令: ​ `AT^PMADDVOTE` ​ `AT^SETSCREENFUNC=0` ​ `AT^SETSCREENSTATE=ON` **注意**：输入AT命令时，须保持屏幕亮屏，且每个AT命令返回OK~后才能输入下一个AT命令。 2. 通过DebugKits工具将制作好的表盘工具推送到开发板端 ![推动表盘](docs/figures/zh-cn_image_0000002281948995.png) ① 点击connect连接图标，选择推送文件COM端口，设置波特率115200 ② 打开工具栏的"System"功能 ③ 选择左侧控制面板的“Uploading And Downloading”菜单 ④ 选择“To Board”选项卡 ​ “To Board”：将PC端文件或目录推送到开发板端； ​ “From Board"：将开发板端的文件下载到PC端，或删除开发板端的文件/目录。 ⑤ 点击"Choose File"按钮选择表盘脚本生成的表盘，比如图上⑥所示：`D:\jsapp\src\tools\bin\graphic_tools\dial_converter_tool\out\kaleidoscope_dial.bin` ⑦ 在"Board File Path" 输入框中输入开发板端路径，比如："**`/user/dial/dial01.bin`**"（请勿修改“/user/dial/”路径，开发板端表盘名称可自定义） ⑧ 点击“Upload”按钮开始推送 **注意**：点击”Upload"前，需要通过串口工具发送AT命令使开发板屏幕为常亮状态！ 3. 通过拔插电源使开发板重新开机，表盘将自动安装，开机后长按表盘，即可选择新制作的表盘 ## 表盘协议2.0介绍 1. 表盘数据标准，[点我查看](https://gitee.com/cooperation-team-L0UI/watch_face/blob/master/face_tool/%E8%A1%A8%E7%9B%98%E5%B7%A5%E5%85%B7%E6%A0%87%E5%87%86/README.md) 2. 表盘制作工具，[点我查看](https://gitee.com/cooperation-team-L0UI/watch_face/blob/master/face_tool/README.md) 3. 表盘市场，[点我查看](https://gitee.com/cooperation-team-L0UI/watch_face/blob/master/face_store/watch-face-store-interface-android.md) # Watch应用/表盘上架 1. 先到 **OpenHarmony智能穿戴聚合平台** 注册 **开发者/设计师**账号，进入后台操作 2. 平台地址：[https://www.openwearplay.com/](https://www.openwearplay.com/)