基于润和ws63芯片的嵌入式智能仓库,大连海事大学
Access rate limit exceeded. Please log in to continue.

项目所有分支只需要在app目录(applications\sample\wifi-iot\app )下执行sh auto.sh 命令 即可在out文件夹获得可烧录文件
1 Ohos_ws63
只基于Open-Harmony系统,对通过 OpenHarmony 兼容性认证(XTS) 的厂商适配,可以深度集成 OpenHarmony 生态(使用 ArkTS、Stage 模型等),但是更加底层
Oh_ws63 代码开发仓库https://gitee.com/HiSpark/ohos_ws63
2 fbb_ws63
HiSilicon 星闪统一开发平台,FBB(Family Big Box) 是海思内部为 星闪(NearLink)系列芯片 打造的统一软件框架。提供标准化 API 接口(如 uapi_reg_clrbit 这类寄存器操作宏),屏蔽不同芯片(WS63/WS63E/WS72 等)的底层差异。 应用只需调用 FBB API,即可在不同硬件上编译运行,无需重写驱动或 HAL 层。 Fbb_ws63 代码开发仓库 https://gitee.com/HiSpark/fbb_ws63
课程要求OpenHarmony设计,因此选用使用虚拟机安装环境Oh_ws63模块,安装结束后回到项目根目录,名字为ws63_ohws,内有文件如下


可执行文件(某个具体的功能) =(1) C源代码 + (2)外部依赖 + (3)构建规则
在具体开发中前往application目录下定义外面自己要实现的代码逻辑成型(1)源代码,需要用到openharmony_Liteos操作系统的的系统功能调用,如设计GPIO输出,线程创建,则去到(3)kernel寻找对应的头文件和功能说明,以include头文件和函数调用的方式作为(2)外部依赖写在源代码的最前面,先查阅手册获得函数原型,再使用find指令找到需要包含的头文件位置,这样(3)构建规则文件就可以使得编译器知道去哪里搜索这些外部依赖最后构建可执行文件
在学习的过程中也要按照这个路径进行学习分析,需要查阅下面的资料
1 https://docs.hisilicon.com/repos/fbb_ws63/zh-CN/master/ 为系统功能调用API说明表,函数调用规范和3 保持一致 详细说明了ws63芯片和liteos提供的可被使用的(2)include头文件和函数调用,但(3)没有说明位置,无法直观构建规则文件,缺少(1)源码
2https://gitee.com/HiSpark/fbb_ws63#https://gitee.com/link?target=https%3A%2F%2Fdocs.hisilicon.com%2Frepos%2Ffbb_ws63%2Fzh-CN%2Fmaster%2F ws63 使用示例,包含线程,GPIO等(1)源码,有头文件和函数调用等(2)外部依赖可以直接使用,包含了(3)BUILD.gn构建规则
3 https://gitee.com/HiSpark/fbb_ws63/tree/master/src/application/samples ws63使用示例,包含I2c等更丰富的调用与源码(1),(2)头文件在源码中被引用,但移植(3)缺少构建规则中的头文件路径,以至于(2)头文件原文也不能被找到仓库中并未给出需要自己寻找
(黑色加深为获知在哪里存在,可以直接移植,红色加深为缺失,需要寻找)
方法2 的 某例子程序来学习: 定时器 https://gitee.com/HiSpark/ohos_ws63/tree/master/vendor/HiHope_NearLink_DK_WS63_V03/demo/01_timer 逻辑如上
一,建立业务文件夹
源码作为文件夹(动态库)放入前述业务逻辑目录app下,文件目录名字为功能大意(01_timer 表示第一个子目标,功能为计时器),将01_timer目录复制到openharmony源码的applications\sample\wifi-iot\app
二,告诉上级目录:源码的构建规则
修改 applications\sample\wifi-iot\app\BUILD.gn文件 ,将其中的 features 改为,只有需要构建和执行的业务逻辑目录才需要写入其中,格式为“文件名:库名字”,这样的库名字需要在app目录下和app的子目录01_timer中BUILD.gn保持一致
文件 app\BUILD.gn:
features = [ ... "01_timer:timer_demo", ...]
文件 app\01_timer\BUILD.gn:
static_library("timer_demo") {
sources = [ "timer.c" ]
三,配置源码的构建规则
文件 app\01_timer\BUILD.gn:
include_dirs = [
"//utils/native/lite/include",
"//kernel/liteos_m/components/cmsis/2.0",
]
四,Sdk目标注册
在device\soc\hisilicon\ws63v100\sdk\build\config\target_config\ws63\config.py文件中,找到'ws63-liteos-app'部分,在其'ram_component'中,添加以下代码:这样的库名字需要在app目录下和app的子目录01_timer中BUILD.gn保持一致
"timer_demo"
五,Sdk动态库编译目录
在device\soc\hisilicon\ws63v100\sdk\libs_url\ws63\cmake\ohos.cmake文件中,找到"ws63-liteos-app"部分,在其set(COMPONENT_LIST部分,添加以下代码::这样的库名字需要在app目录下和app的子目录01_timer中BUILD.gn保持一致 "timer_demo"
六,构建和输出
回到项目根目录
rm -rf out && hb set -p nearlink_dk_3863 && hb build -f
七,更多信息获取
得到的头文件大致目录可以进行搜素和调用 如:需要记录时间的时候,查阅 https://docs.hisilicon.com/repos/fbb_ws63/zh-CN/master/
(通过例程学习或者是名字)找到驱动特性章节的systick目录,获得原型大意
一个库(配置了BUILD.gn的文件夹)来说,头文件的查找路径可以被搜索出来,下面叙述的脚本可以在定义的目录中递归的搜索,搜索到名字之后可以点击查看文件并搜素调用函数的名字,如果有,那么将这样的文件加入到构建规则中,就可以在头文件中引用了
找到外部依赖的头文件之后,也可以阅读解释和说明文档,这样会对函数原型有更深刻的认识
1,确定要查找的头文件名字和目录
1.1 根据头文件查找目录:
#!/bin/bash
# 定义路径数组(已去重)
paths=(
"./commonlibrary/utils_lite/include"
"./applications/sample/wifi-iot/app/00_include"
"./applications/sample/wifi-iot/app/12_oled/src"
"./device/soc/hisilicon/ws63v100/sdk/drivers/chips/ws63/porting/gpio/v150"
"./device/soc/hisilicon/ws63v100/sdk/middleware/utils/common_headers/native"
....
)
found=0
for path in "${paths[@]}"; do
if [ -d "$path" ]; then
result=$(find "$path" -name "commmon_def.h" -type f)
if [ -n "$result" ]; then
echo "✅ Found in: $path"
echo "$result"
found=1
fi
else
echo "⚠️ Directory not found: $path"
fi
done
if [ $found -eq 0 ]; then
echo "❌ com_def.h not found in any of the specified directories."
Fi
1.2 根据函数名字查找目录:
grep -rn "uapi_reg_clrbit" ./device/soc/hisilicon/ ./kernel/liteos_m/ ./drivers/
命令为递归的打开文件搜索 "uapi_reg_clrbit"函数 ,一般在以下目录就可以找到
./device/soc/hisilicon/
./kernel/liteos_m/
./drivers/
2,获得信息之后源文件目录绝对地址加入到引用该文件的BUILD.GN目录中就可以只能正常使用
到此文件已经已经可以被正确的编译,在这个过程中我学会了解到多个设备可以以多个文件夹(库) 的形式存在,每一个库都可以通过在自己的库内加入编译的c函数中写新建线程并绑定,进而获取执行的权限,可能是申请发送使能信息,也可能是进入到轮训中处理业务
自动并简化(gen,auto,git)编译
这也进一步启发了了进行测试和调整的思路,为了避免大文件编译产生许多错误无法定位,我们可以每个人负责并测试一个文件夹(库),先分别验证每个单独设备的功能是否完善,再总结结合在一起,上游开发单个模块并测试,下游集成多个模块并测试,每个模块的负责人就是分支的建立人
在main分支中 我将前述方法2中的6步编译方法,总结为:
阅读并理解app目录下的全部库,修改(3)构建文件,输入构建命令并复制输出文件,其中构建文件逻辑为(文件不变前部) + 变化的依赖和库 + (文件不变后部)
最后前叙述6步只需要一步编译指令就可以执行
gen.py开头部分
middle_content = """
"00_include:gpio_demo",
"01_sr04:sr04_demo" """
middle_content_out="""
,
"gpio_demo",
"sr04_demo",
"""
middle_content_out2="""
"gpio_demo"
"sr04_demo"
"""
auto.sh:
#!/bin/bash
set -e # 遇到错误立即退出
# 1. 记录初始目录
INIT_DIR="$(pwd)"
echo "[INFO] Initial directory: $INIT_DIR"
# 2. 执行当前目录下的 gen.py
if [ -f "./gen.py" ]; then
echo "[INFO] Running gen.py..."
python3 ./gen.py
else
echo "[WARN] gen.py not found in current directory, skipping."
fi
# 3. 向上查找 ws63_ohos 目录
CURRENT="$INIT_DIR"
WS63_OHOS_ROOT=""
while [ "$CURRENT" != "/" ]; do
if [ -d "$CURRENT/ws63_ohos" ]; then
WS63_OHOS_ROOT="$CURRENT/ws63_ohos"
break
fi
if [ "$(basename "$CURRENT")" = "ws63_ohos" ]; then
WS63_OHOS_ROOT="$CURRENT"
break
fi
CURRENT="$(dirname "$CURRENT")"
done
if [ -z "$WS63_OHOS_ROOT" ]; then
echo "[ERROR] ws63_ohos directory not found in parent paths." >&2
exit 1
fi
echo "[INFO] Found ws63_ohos root: $WS63_OHOS_ROOT"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
# 4. 在 ws63_ohos 目录下执行构建命令
echo "[INFO] Cleaning and building..."
cd "$WS63_OHOS_ROOT"
rm -rf out
hb set -p nearlink_dk_3863
hb build -f
# 5. 回到初始目录
cd "$INIT_DIR"
git add .
git commit -m "${TIMESTAMP} "
# # 6. 切换到 bin 分支并拉取最新代码
# echo "[INFO] Switching to 'bin' branch and pulling latest changes..."
# git switch bin
# git pull origin bin
# # 7. 定义源文件和目标文件
# FWPKG_SRC="$WS63_OHOS_ROOT/out/nearlink_dk_3863/nearlink_dk_3863/ws63-liteos-app/ws63-liteos-app_all.fwpkg"
# if [ ! -f "$FWPKG_SRC" ]; then
# echo "[ERROR] Firmware package not found: $FWPKG_SRC" >&2
# exit 1
# fi
# # 生成带时间戳的文件名:ws63-liteos-app_all_YYYYMMDD_HHMMSS.fwpkg
# FWPKG_NAME="ws63-liteos-app_all_${TIMESTAMP}.fwpkg"
# FWPKG_DST="$INIT_DIR/$FWPKG_NAME"
# # 拷贝并重命名
# echo "[INFO] Copying firmware to $FWPKG_DST"
# cp "$FWPKG_SRC" "$FWPKG_DST"
# echo "[SUCCESS] Build and copy completed: $FWPKG_DST"