# ohos_diting
**Repository Path**: HiSpark/ohos_diting
## Basic Information
- **Project Name**: ohos_diting
- **Description**: ohos_diting代码仓为开发者提供了镜像，开发者基于该镜像和JS接口快速开发OpenHarmony Watch应用和表盘。友好社区：https://gitee.com/cooperation-team-L0UI/
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-05-16
- **Last Updated**: 2025-09-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ohos_diting
ohos_diting代码仓为开发者提供了镜像，开发者基于该镜像和JS接口快速开发OpenHarmony Watch应用和表盘。友好社区：https://gitee.com/cooperation-team-L0UI/ ；北向应用市场：https://www.openwearplay.com/
## 目录介绍
| 目录 | 说明 |
| :------------------------------------------ | :-------------------------------------- |
| 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/ | 存放合作厂商的开发板硬件和软件资料 |
## 购买渠道
| 类型 | 介绍 |
| :----------------------------------------------------------: | :----------------------------------------------------------: |
| 开发板名称 | SZD_DEV_KIT_HY601M_V1.0开发板（速智达） |
| [开发板购买链接](https://item.taobao.com/item.htm?abbucket=7&id=972772452249&mi_id=0000Xm2dnzyEzqAyTNHk_sFczO9h90ZRaxt5k_euTweqFY4&ns=1&priceTId=215045c417567008776937489e1849&skuId=6087979882969&spm=a21n57.1.hoverItem.2&utparam=%7B%22aplus_abtest%22%3A%22da9831a61ee2f8ec489347119b69e8b7%22%7D&xxc=taobaoSearch) | SZD_DEV_KIT_HY601M_V1.0开发板是一款高度集成的轻智能手表开发板，支持OpenHarmony轻量系统 |
| 开发板示意图 | 
|
模组产品均由相应厂家自行销售，由其对产品质量负责，如侵犯他人知识产权的由其自行承担全部责任及赔偿。海思不提供任何保证及担保，亦不承担责任及赔偿。
## 开发板配套工具
使用SZD_DEV_KIT_HY601M_V1.0开发板（速智达）开发Watch应用和表盘所需配套工具如下：
1. **USB串口调试线1根**
2. **Type-C数据充电线1根**
3. **HiSpark Studio**
## 开发板镜像烧录
### 开发板连线
注意：开发板上有一个串口，用于烧录镜像文件或推送文件和抓取日志。
1. 使用一根Type-C充电线给开发板供电
2. 将表盘安装在图示位置，亮屏按钮即为开发板HOME键
3. 使用一根串口调试板一端与PC端相连，另外一端与开发板连接，接线方式：TXD-RXD，GND-GND，RXD-TXD
4. 串口调试线连接后查看设备管理器，可以看到新增的两个端口（本例为COM4）
1. 将当前仓库clone/下载到本地，比如下载到**D:\jsapp**目录
2. 打开HiSpark Studio，进入欢迎页面，单击"新建工程"，进入新建工程页面
3. 在新建工程窗口配置工程参数，可参考下图图示信息，单击“完成”
4. 在HiSpark Studio工具中点击“工程配置”按钮，选择“程序加载”，传输方式选择“serial”，端口选择用于烧录的“COM”端口，波特率选择“500k”
5. 配置完成后，点击工具“程序加载”-> “烧录配置”按钮烧录
6. 出现“Connecting, please reset device...”字样时，按一下板端复位键，等待烧录结束，预计烧录30分钟左右
7. 在HiSpark Studio底端选择“监视器”，选择端口用于抓取日志的“COM”端口，如果没有端口显示可以刷新一下，点击“开始监视”，拔插开发板电源线，出现“code start codeloader”字样代表编译烧录成功
## Watch应用开发、推送安装和卸载
### Watch应用开发指导
1. 应用开发工具：Brandy OpenHarmony JS应用开发 用户指南
注意：DevEco需配置图形转换工具环境变量配置说明：[image_converter_tool工具安装说明](docs/zh-CN/image_converter_tool工具安装说明.md)
3. 应用开发Demo：[点我查看](https://gitee.com/HiSpark/ohos_diting/tree/master/src/application/wearable/jsapp/acts_validator)
### Watch应用推送安装和卸载
在SZD_DEV_KIT_V1.0开发板上安装Watch应用需要先将编译出来的应用包推送到开发板上，然后通过串口发送AT命令进行安装或卸载。
1. 通过串口工具发送三个AT命令设置开发板屏幕为常亮状态（即保持开发板不息屏）
以下发送AT命令操作以SSCOM串口工具为例说明。
① 开发板通电开机后，连接开发板和PC，打开SSCOM串口工具，选择日志打印COM端口，设置波特率，勾选“加回车换行”
② 在输入框中依次输入以下三个AT命令，**每个AT命令返回OK~后才能输入下一个AT命令**:
`AT^PMADDVOTE`
`AT^SETSCREENFUNC=0`
`AT^SETSCREENSTATE=ON`
**注意**：输入AT命令时，须保持屏幕亮屏。
2.通过HiSpark Studio打开DebugKits工具 
3. 通过DebugKits工具将编译生成的应用包推送到开发板端，选择Options，chip list选择“sparta”
4.选择对应的串口，及波特率，波特率选择“500000”
5.将应用推送到板端
① 点击connect连接图标，选择推送文件COM端口，设置波特率500000
② 打开工具栏的"System"功能
③ 选择左侧控制面板的“Uploading And Downloading”菜单
④ 选择“To Board”选项卡
“To Board”：将PC端文件或目录推送到开发板端；
“From Board"：将开发板端的文件下载到PC端，或删除开发板端的文件/目录。
⑤ 点击"Choose File"按钮选择Dev Eco Studio编译生成的应用包entry-default-unsigned.bin，如图⑥所示
⑦ 在"Board File Path" 输入框中输入开发板端路径，比如："`/user/jsapp/sample.bin`"（应用包路径和名称可自定义）
⑧ 点击“Upload”按钮开始推送
**注意**：点击”Upload"前，需要通过串口工具发送AT命令使开发板屏幕为常亮状态！
6.通过串口工具发送AT命令安装应用
① 打开串口调试工具，选择开发板串口日志COM端口进行连接
② 在串口中发送如下AT命令安装应用包：**`AT^OHOSFWK_BM_INSTALL=/user/jsapp/sample.bin`**
如果在安装应用时不想进行签名校验或者签名校验失败了，可以在安装应用前通过串口发送如下AT命令手动关闭应用签名：**`AT^OHOSFWK_BM_SET=disable`**
PS：如果需要覆盖安装应用包，AT命令为：**`AT^OHOSFWK_BM_INSTALL=/user/jsapp/sample.bin rmdata`**
**注意**：此命令将删除应用沙箱中的历史数据。
7.通过串口工具发送AT命令卸载应用
① 在串口中发送如下AT命令查询已安装应用的包名：**`AT^OHOSFWK_BM_GET_APPLIST`**
② 根据应用包名发送如下AT命令进行应用卸载，以example应用包名为例：**`AT^OHOSFWK_BM_UNINSTALL=com.example.myapplication`**
8.通过DebugKits工具将开发板端的应用包删除
① 点击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. 离线表盘方案介绍，查看Brandy 离线表盘 开发指南
2. 离线表盘制作，查看Brandy 离线表盘 开发指南
3. 离线表盘参考Demo，查看Brandy 离线表盘 开发指南
1. 通过串口工具发送三个AT命令设置开发板屏幕为常亮状态（即保持开发板不息屏）
以下发送AT命令操作以SSCOM串口工具为例说明。
① 开发板通电开机后，连接开发板和PC，打开SSCOM串口工具，选择日志打印COM端口，设置波特率，勾选“加回车换行”
② 在输入框中依次输入以下三个AT命令，每个AT命令返回OK~后才能输入下一个AT命令:
`AT^PMADDVOTE`
`AT^SETSCREENFUNC=0`
`AT^SETSCREENSTATE=ON`
**注意**：输入AT命令时，须保持屏幕亮屏。
2. 通过DebugKits工具将制作好的表盘工具推送到开发板端
① 点击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/)