# ohos_ws63_1

**Repository Path**: wen-zhuangwei/ohos_ws63_1

## Basic Information

- **Project Name**: ohos_ws63_1
- **Description**: ohos_ws63仓是星闪ws63和ws63e解决方案代码仓，基于全量OpenHarmony-5.1.0-Release版本裁减，提供XTS认证指南、WSL镜像包、docker镜像包等。技术论坛：https://developers.hisilicon.com/forum/0133146886267870001
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2025-09-03
- **Last Updated**: 2025-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ohos_ws63开发指南
## 介绍

  ohos_ws63仓是星闪ws63和ws63e解决方案代码仓， 基于全量OpenHarmony-V5.1.0-Release + WS63 SDK 1.10.101版本裁减，软件包大小大约2-4G，提供XTS认证指南、WSL镜像包、docker镜像包等，主要用于智慧家居、IoT网关、电子消费类等应用场景。如果需要升级WS63 SDK版本参考[OpenHarmony_v5.1.0_release+WS63 SDK版本升级](tools/OpenHarmony_v5.1.0_release+WS63 SDK版本升级.md)

## 目录介绍

| 目录   | 介绍                                                         |
| ------ | ------------------------------------------------------------ |
| docs   | 存放软件资料手册、IO复用关系表、用户指南手册，帮助用户快速了解WS63系列 |
| tools  | 开发工具及环境搭建指南文档，帮助用户搭建开发环境             |
| vendor | 存放合作产商的开发板硬件和软件资料，包含案例代码、硬件原理图、案例开发指南文档 |

## 软件资料介绍

| 名称                                                         | 介绍                                                         |
| :----------------------------------------------------------- | :----------------------------------------------------------- |
| [WS63系列用户指南.pdf](https://hispark-obs.obs.cn-east-3.myhuaweicloud.com/WS63%E7%B3%BB%E5%88%97%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97.pdf) | 本文档主要介绍WS63系列的各项基本功能，为用户提供WS63系列的功能描述、应用场景、应用配置方法等。 |
| [WS63系列硬件用户指南_04.pdf](https://hispark-obs.obs.cn-east-3.myhuaweicloud.com/WS63%E7%B3%BB%E5%88%97%E7%A1%AC%E4%BB%B6%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97_04.pdf) | 本文档主要介绍 WS63系列的封装管脚信息、电气特性参数、原理图设计建议、PCB 设计建议、热设计建议、焊接工艺、潮敏参数、接口时序、注意事项等内容。 |
| [软件系列文档](docs/software)                                | 该系列文档主要包括IO复用关系表、 AT命令使用、 CJSON 开发流程、HTTP开发流程、MQTT 开发流程、 NV存储开发流程、设备驱动开发流程、SLE/BLE开发流程、API接口等文档，文档路径存放于docs/software |

## 购买渠道

| 序号 | 硬件资料                                                     | 介绍                                                         |
| :--: | ------------------------------------------------------------ | ------------------------------------------------------------ |
|  1   | [购买链接](https://www.ickey.cn/detail/1003001013187550/Q353333N1100.html) | 云汉芯城的WS63芯片，采用WS63解决方案                         |
|  2   | [购买链接](https://www.ickey.cn/detail/1003001013187551/Q353333N1100E.html) | 云汉芯城的WS63E芯片，采用WS63E解决方案                       |
|  3   | [模组：购买链接](https://gitee.com/link?target=https%3A%2F%2Fitem.taobao.com%2Fitem.htm%3Fid%3D821194904380) | 深圳四博智联科技有限公司的星闪模组，采用WS63解决方案，支持WiFi6，硬件无天线、邮票孔 |
|  4   | [模组：购买链接](https://gitee.com/link?target=https%3A%2F%2Fitem.taobao.com%2Fitem.htm%3Fid%3D823544936579) | 深圳四博智联科技有限公司的星闪模组，采用WS63解决方案，支持星闪WiFi6模组，硬件支持板载天线和外置天线 |
|  5   | [模组：购买链接](https://gitee.com/link?target=https%3A%2F%2Fitem.taobao.com%2Fitem.htm%3Fid%3D820900594332) | 深圳四博智联科技有限公司的星闪模组，采用WS63解决方案，硬件支持板载天线和外置天线 |
|  6   | [烧录器：购买链接](https://holdiot001.feishu.cn/docx/L60wdrG7Fo314pxYyrbczZqVnSb) | 烧录器：可烧录开发板、模组等                                 |
|  7   | [模组：DyCloud_WF6301星闪模组](https://ic-item.jd.com/10151639839211.html) | 鼎云物联的星闪模组采用WS63解决方案                           |
|  8   | [模组：KHM-3863A 星闪模组购买链接](https://mall.kaihong.com/productDetail?skuId=1839224386385612801&goodsId=1839224386133954561) | 深开鸿的星闪模组，采用WS63解决方案，支持星闪、WiFi、蓝牙三模SoC通信，支持AT指令及OpenCPU二次开发，支持KaihongOS Lite版本及星闪链路软总线特性等 |

模组产品均由相应厂家自行销售，由其对产品质量负责，如侵犯他人知识产权的由其自行承担全部责任及赔偿。海思不提供任何保证及担保，亦不承担责任及赔偿。

## 支持的开发板

| 开发板介绍                                                   | 购买链接                                                     | 开发板图片                                                   |
| ------------------------------------------------------------ | ------------------------------------------------------------ | :----------------------------------------------------------- |
| [HiHope_NearLink_DK3863E_V03（润和）](https://developers.hisilicon.com/postDetail?tid=0224176485045269005) | [润和HiHope_NearLink_DK3863E_V03开发板（淘宝）](https://e.tb.cn/h.TyIdVOFouZyhA23?tk=vPA6eoh0e0u)<br/>[润和HiHope_NearLink_DK3863E_V03开发板（京东）](https://ic-item.jd.com/10150874487392.html) | <img src="vendor/HiHope_NearLink_DK_WS63_V03/doc/media/readme/image-20250508093435364.png" alt="image-20250508093435364" style="zoom:25%;" /> |
| [BearPi-Pico_H3863（小熊派）](https://developers.hisilicon.com/postDetail?tid=0268176458526990002) | [小熊派BearPi-Pico_H3863开发板（淘宝）](https://item.taobao.com/item.htm?id=821386760379) | <img src="vendor/HiHope_NearLink_DK_WS63_V03/doc/media/readme/bearpi_pico_h3863.png" alt="image-20240809164437807" style="zoom: 25%;" /> |
| [华清远见WS63星闪开发板](https://developers.hisilicon.com/postDetail?tid=0268176456950600001) | [华清远见WS63星闪开发板（淘宝）](https://item.taobao.com/item.htm?id=892481769813)<br/>[华清远见WS63星闪开发板（京东）](https://ic-item.jd.com/10152445103343.html) | <img src="vendor/HiHope_NearLink_DK_WS63_V03/doc/media/readme/HQYJ_WS63.png" alt="HQYJ_WS63" style="zoom: 25%;" /> |
| DyCloud_WF6301_DK开发板（鼎芯物联）                          | [DyCloud_WF6301_DK开发板（京东）](https://ic-item.jd.com/10151635371214.html) | <img src="vendor/HiHope_NearLink_DK_WS63_V03/doc/media/readme/image-20250425161456606.png" alt="image-20250425161456606" style="zoom: 25%;" /> |
| DTU_Car(大连理工大学)                                        | **暂不提供**                                                 | <img src="vendor/HiHope_NearLink_DK_WS63_V03/doc/media/readme/image-20250507183303684.png" alt="image-20250507183303684" style="zoom: 25%;" /> |
| [KHD-3863B 星闪开发板（深开鸿）](https://mall.kaihong.com/productDetail?skuId=1839195267891466241&goodsId=1839195267383955458) | [KHD-3863B星闪开发板（开鸿商城）](https://mall.kaihong.com/productDetail?skuId=1839195267891466241&goodsId=1839195267383955458) | <img src="vendor/Kaihong_KHD-3863B/doc/media/KHD-3863B.png" alt="KHD-3863B" style="zoom: 75%;" /> |
| [鸿蒙星闪创新开发套件(博赛)](https://item.taobao.com/item.htm?id=905112884644&pisk=gt8Zc3_gUV3NSpyI5pQ4UfwSr47OJZkS_E6fiIAc1OXGCE92is5Rso4gjJAhZ9aj6NiAuKWeHOs1SE-LuQdv5fQj6NdOkZDSF4T26CQxY2g_rFz3-_d3m-jiAwcYVp3-F4gW6cfOlBDWl9uM0657oZjGjWfhpseGiKjg-2XdMs2GiPcet9Bhst4Gn22hZ_ZgoKqMtyffgs20otqht_BhnZjDnBcFG9XcoZvDtjSXsI4FNGc3_o7mQqyfJTAGLr4zw1Sg8CrbrzxlsZYWB9SCAe5NbTjco5YBSpOD5FIKblbvO3J2mLDQfOxPapSWbYzwUdCDgsvZy7WH7I8FXHwgj_7NQgYGqqGWtixe8NTiHudBTOjPRHiKCi_wQ3BRjDHp3BW6nFS3Qv6XVBTGYLDQ8KI2mF_HSv0P4SwAtR9ekhy00GfdTTGETlBTi5jbkxXuDoIhy6WS11ZYDGfdTTGEToEAx9CFFf11.&spm=a21xtw.29178619.0.0&skuId=5930222054003) | [鸿蒙星闪创新开发套件(淘宝)](https://shop271679707.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.7a497dd60Nxipm) | <img src="vendor/Bossay_3863_Devkit/doc/media/devkit.png" alt="bossay_3863_devkit" style="zoom: 100%;" /> |

开发板产品均由相应厂家自行销售，由其对产品质量负责，如侵犯他人知识产权的由其自行承担全部责任及赔偿。海思不提供任何保证及担保，亦不承担责任及赔偿。

## 环境搭建指南

方式一：

- [WSL子系统开发环境搭建](tools/WSL子系统开发环境搭建.md)

- [WSL子系统代码编译及烧录](tools/WSL子系统编译及烧录.md)

方式二：

- [Windows系统下虚拟机安装](tools/Windows系统下虚拟机安装.md)
- [虚拟机环境代码编译及烧录](tools/虚拟机环境代码编译及烧录.md)

## XTS认证

- [WSL子系统开发环境搭建](tools/WSL子系统开发环境搭建.md)
- [xts认证指南](tools/XTS认证.md)
- [OpenHarmony_v5.1.0_release+WS63 SDK版本升级](tools/OpenHarmony_v5.1.0_release+WS63 SDK版本升级.md)

## 案例教程

### 润和星闪派物联网开发套件案例

本仓库案例取自于https://gitee.com/openharmony/vendor_hihope/tree/master/nearlink_dk_3863/ws63_sample目录，移植到本仓只是为了方便学习

| 案例名称       | 案例描述                                                     |
| -------------- | ------------------------------------------------------------ |
| 00_thread      | [线程](vendor/HiHope_NearLink_DK_WS63_V03/demo/00_thread)    |
| 01_timer       | [软件定时器](vendor/HiHope_NearLink_DK_WS63_V03/demo/01_timer) |
| 02_delay       | [延时（Delay）](vendor/HiHope_NearLink_DK_WS63_V03/demo/02_delay) |
| 03_mutex       | [互斥锁](vendor/HiHope_NearLink_DK_WS63_V03/demo/03_mutex)   |
| 04_semaphore   | [信号量](vendor/HiHope_NearLink_DK_WS63_V03/demo/04_semaphore) |
| 05_message     | [消息队列](vendor/HiHope_NearLink_DK_WS63_V03/demo/05_message) |
| 06_gpioled     | [IO输出控制](vendor/HiHope_NearLink_DK_WS63_V03/demo/06_gpioled) |
| 07_gpiobutton  | [IO输入控制](vendor/HiHope_NearLink_DK_WS63_V03/demo/07_gpiobutton) |
| 08_pwmled      | [pwm呼吸灯](vendor/HiHope_NearLink_DK_WS63_V03/demo/08_pwmled) |
| 09_adcbutton   | [adc按键](vendor/HiHope_NearLink_DK_WS63_V03/demo/09_adcbutton) |
| 10_adchuman    | [adc人体传感器](vendor/HiHope_NearLink_DK_WS63_V03/demo/10_adchuman) |
| 11_aht20       | [温湿度监测](vendor/HiHope_NearLink_DK_WS63_V03/demo/11_aht20) |
| 12_oled        | [ssd1306 OLED屏幕](vendor/HiHope_NearLink_DK_WS63_V03/demo/12_oled) |
| 13_adclight    | [adc读光敏电阻的电压值](vendor/HiHope_NearLink_DK_WS63_V03/demo/13_adclight) |
| 14_easy_wifi   | [Wi-Fi STA 和Wi-Fi AP两种模式](vendor/HiHope_NearLink_DK_WS63_V03/demo/14_easy_wifi) |
| 15_tcpclient   | [tcp客户端与远端进行通信](vendor/HiHope_NearLink_DK_WS63_V03/demo/15_tcpclient) |
| 16_tcpserver   | [tcp服务端与远端进行通信](vendor/HiHope_NearLink_DK_WS63_V03/demo/16_tcpserver) |
| 17_udpclient   | [udp客户端与远端进行通信](vendor/HiHope_NearLink_DK_WS63_V03/demo/17_udpclient) |
| 18_udpserver   | [udp服务端与远端进行通信](vendor/HiHope_NearLink_DK_WS63_V03/demo/18_udpserver) |
| 19_ble_uart    | [蓝牙通信转发串口数据](vendor/HiHope_NearLink_DK_WS63_V03/demo/19_ble_uart) |
| 20_mqtt_demo   | [MQTT和PC端进行MQTT通信](vendor/HiHope_NearLink_DK_WS63_V03/demo/20_mqtt_demo) |
| 21_mqtt_led    | [（MQTT）PC端控制WS63交通灯板亮灭](vendor/HiHope_NearLink_DK_WS63_V03/demo/21_mqtt_led) |
| 22_mqtt_sensor | [（MQTT）WS63发送温湿度传感器数据给PC端](vendor/HiHope_NearLink_DK_WS63_V03/demo/22_mqtt_sensor) |
| 23_sle_uart    | [（SLE）WS63使用星闪功能转发串口数据](vendor/HiHope_NearLink_DK_WS63_V03/demo/23_sle_uart) |
| 24_sle_humi    | [（SLE）WS63使用星闪功能发送温湿度传感器数据](vendor/HiHope_NearLink_DK_WS63_V03/demo/24_sle_humi) |
| 25_sle_led     | [（SLE）WS63使用星闪功能控制交通灯板LED灯亮灭](vendor/HiHope_NearLink_DK_WS63_V03/demo/25_sle_led) |
| 26_sle_gas     | [（SLE）WS63使用星闪功能发送燃气传感器数据](vendor/HiHope_NearLink_DK_WS63_V03/demo/26_sle_gas) |
| 27_sle_oled    | [（SLE）WS63使用星闪功能转发串口数据并显示在oled屏幕上](vendor/HiHope_NearLink_DK_WS63_V03/demo/27_sle_oled) |
| 28_paho_mqtt   | [paho_mqtt第三方软件](vendor/HiHope_NearLink_DK_WS63_V03/demo/28_paho_mqtt) |

### 深开鸿星闪开发板参考案例

本仓库案例取自于KaihongOS Lite二次开发包中的部分Demo案例，移植到本仓只是为了方便学习，为确保可行，暂未提供依赖于KaihongOS Lite二开包中闭源部门

| 案例名称                         | 案例描述                                                     |
| --------------------------------| ------------------------------------------------------------ |
| 一、开发指南                     | [开鸿星闪开发板 KHD-3863B开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md)    |
|                                 | 环境搭建、代码下载及编译、镜像烧录指导说明见-[开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md) |
| 二、SampleCode及模块开发说明      | 见[开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md)中第四部分  |
|    1. 编译配置SampleCode    | 见[开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md)中第四部分第1小节 |
|    2. 文件系统fs开发说明    | 见[开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md)中第四部分第2小节 |
|    3. 系统(含片上)接口开发说明    | 见[开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md)中第四部分第3小节 |
|       -gpio模块       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/peripheral_samples/gpio) |
|       -pwm模块       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/peripheral_samples/pwm) |
|       -adc模块       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/peripheral_samples/adc) |
|       -i2c模块       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/peripheral_samples/i2c) |
|       -spi模块       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/peripheral_samples/spi) |
|       -uart模块       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/peripheral_samples/uart) |
|    4. WiFi模块接口开发说明    | 见[开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md)中第四部分第4小节 |
|       -WiFi-AP开发说明       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/wifi_app/wifi_ap.c) |
|       -WiFi-STA开发说明       | [SampleCode代码路径](vendor/kaihong/khd_hi3863_b/app/wifi_app/wifi_sta.c) |
| 三、更多开发指导                 | 见[开发指导说明书](vendor/Kaihong_KHD-3863B/doc/README.md)中第五部分及开鸿开发者论坛 [开鸿开发服务平台](https://developer.kaihong.com/) |

 ### 博赛鸿蒙星闪创新开发套件参考案例

本仓库案例取自于鸿蒙星闪创新开发套件开发案例，其中包含智能电子秤、五角星跑马灯、数码管点阵、直流步进电机等多个示例案例。

| 案例名称                         | 案例描述                                                     |
| --------------------------------| ------------------------------------------------------------ |
| 一、套件开发指南                  | [博赛鸿蒙星闪创新开发套件开发指导说明书](vendor/Bossay_3863_Devkit/doc/README.md)    |
| 二、案例板开发说明                 | [套件开发指导说明书](vendor/Bossay_3863_Devkit/doc/README.md)  |
|    1. 01_smart_weigher           | [智能电子秤](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/01_smart_weigher/README.md) |
|    2. 02_star_led              | [五角星跑马灯](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/02_star_led/README.md) |
|    3. 03_digital_tube              | [数码管显示器](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/03_digital_tube/README.md) |
|    4. 04_matrix             | [点阵显示器](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/04_matrix/README.md) |
|    5. 05_dc_motor             | [直流电机控制器](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/05_dc_motor/README.md) |
|    6. 06_stepper_motor             | [步进电机控制器](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/06_stepper_motor/README.md) |
|    7. 07_led_tube             | [(SLE)WS63使用星闪功能发送LED状态至数码管显示](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/07_led_tube/README.md) |
|    8. 08_weigher_tube             | [(SLE)WS63使用星闪功能发送电子秤数据至数码管显示](vendor/Bossay_3863_Devkit/oh_63/vendor/Bossay/bossay_3863_devkit/demo/08_weigher_tube/README.md) |
| 三、更多套件开发指导               | [鸿闪智学开发云平台](http://www.ibossay.com/#/home/practice-course)|

 

## 环境搭建问题FAQ

- 如果根据文档没有编译成功，请参考https://developers.hisilicon.com/postDetail?tid=02110170392979486020
- 如果根据文档编译成功，但是在编写其他代码后，导致编译失败，可以在论坛提问，论坛链接：https://developers.hisilicon.com/forum/0133146886267870001