- 众所周知,这个开发板的最大特点是WiFi/BLE两大无线协议一片配齐。得益于OpenHarmony的加持,在上面搭建复杂应用是个相对轻松的工作。不信?下面我们就来跑一跑XR806的自带demo。
注:本文主要参考了全志在线的XR806文档,很多问题都可以在这里找到答案。
准备工作
以下主要介绍的是在WSL 1(Ubuntu 20.04)下编译XR806所需的准备工作,如果是在Linux系统下直接安装,建议参考官方文档。
代码下载
首先我们需要准备好repo。这里推荐使用全志的版本,好处是服务器比较稳定,一般都能顺利下载,不过需要事先注册一下全志客户服务平台的账号,并且需要添加公钥才行,具体的下载和安装方式可以参考源码下载 - D1。最后记得把repo移到指定位置,或是至少添加到PATH变量中。
接下来我们尝试拉取SDK相关的代码。由于SDK存放于Gitee,因此需要在Gitee上也添加相同的公钥才能拉取代码,这个就不解释了。
注:在这一步中,需要保证当前的python版本是2.6或2.7。如果不是的话,可以通过apt安装python-is-python2,安装好后python就是Python 2.7了。
- # 创建文件夹,名称和路径随意
mkdir sdk
cd sdk
# 初始化
repo init -u ssh://git@gitee.com/openharmony-sig/manifest.git -b OpenHarmony_1.0.1_release --no-repo-verify -m devboard_xr806.xml
# 拉取代码
repo sync -c
# 下载通过LFS存储的二进制文件,需要提前通过`apt`安装`git-lfs`
repo forall -c 'git lfs pull'
- 上面一通操作完后,所有编译需要的代码应该静静地躺在应有的位置了。
环境配置
环境配置的话,推荐看看获取源码及Ubuntu编译环境准备,但有几个地方需要注意:
编译完全体demo
第一次编译
第一次编译我们选择了默认的demo,这里我们基本上直接照搬了固件编译 - XR806。
# 编译libSDK
cd device/xradio/xr806/xr_skylark
make PRJ=demo/wlan_ble_demo defconfig
make menuconfig
make lib -j
# 编译完整app
cd -
hb set
hb build -f
注:这一步make menuconfig必须要执行,否则会提示找不到device/xradio/xr806/liteos_m/SDKconfig.gni这个文件。
编译完成后,我们在device/xradio/xr806/xr_skylark/out文件夹下得到了名为xr_system.img的文件。之后参考固件烧录 - XR806即可。
这里我把第一次编译后得到的xr_system.img文件分享出来,大家可以自取:xr_system_default.img 。
demo内容探究
我们花了不少力气,终于把demo编译好了。那么,这个demo到底是个啥呢?其实答案都在xr806/adapter/console/src/command.c这个文件里面。
注:为啥会在这个文件夹呢?聪明如你,只要打开xr806/BUILD.gn这个文件,看到"adapter/console:app_console"这一行,应该就会有答案啦。
可以看到,这个demo实际上支持非常多的命令,足以涵盖XR806支持的大部分功能。这些命令又可以进一步被分为两大类,其中:
那么要怎么把demo玩起来呢?其实很简单,只要使用熟悉的串口工具,以115200 bps的波特率连接XR806的USB转串口(CP2102N),就可以通过类似于console的方式输入命令了。
注:如果使用PuTTY的话,推荐在连接时勾选Terminal的Implicit CR in every LF选项,这样可以避免回显字符换行不回车的尴尬。
如果你在使用XR806的官方开发板,那么就可以利用挂在PWM2上的LED实现最简单的blink(闪烁),只需要输入以下命令即可:
hm iot pwm init p=2
- hm iot pwm start p=2 d=50 f=5这些命令的使用方法推荐直接看源代码,因为有不少命令并没有给出完整的帮助文档,感觉这个可以在后续优化一下。
全功能demo编译
在阅读到xr806/adapter/console/src/command.c这个文件时,我们会注意到在#if PRJCONF_NET_EN下有一些开关,这些开关控制了一些命令是否编译。那么,如果我们把这些开关都打开,不就可以得到一个全功能的demo了吗?说干就干!
看起来,我们需要做的工作就是把这些开关都打开,然后重新编译即可。不过事情的发展一般都没有这么顺利,我们等下会遇到两个问题(剧透了哈)。
改好文件后,我们在device/xradio/xr806/xr_skylark文件夹下重新编译一下libSDK:
make build_clean
- make lib -j
- 看着似乎没问题对不对?不急,我们再回到sdk目录,开始进行二阶段编译:
hb build -f
- 这次编译看起来一切顺利,直到……最后遇到了这么一个编译错误:
- [OHOS ERROR] /home/metro/tools/gcc-arm-none-eabi-10-2020-q4-major/bin/../lib/gcc/arm-none-eabi/10.2.1/../../../../arm-none-eabi/bin/ld: ../../../../lib/libnopoll.a(nopoll_conn.o): in function `__nopoll_conn_new_common':
[OHOS ERROR] /home/metro/xr806/sdk/device/xradio/xr806/xr_skylark/src/net/nopoll/src/nopoll_conn.c:927: undefined reference to `mbedtls_debug_set_threshold'
[OHOS ERROR] /home/metro/tools/gcc-arm-none-eabi-10-2020-q4-major/bin/../lib/gcc/arm-none-eabi/10.2.1/../../../../arm-none-eabi/bin/ld: ../../../../lib/libnopoll.a(nopoll_conn.o): in function `__nopoll_conn_accept_complete_common':
[OHOS ERROR] /home/metro/xr806/sdk/device/xradio/xr806/xr_skylark/src/net/nopoll/src/nopoll_conn.c:5047: undefined reference to `mbedtls_debug_set_threshold'
[OHOS ERROR] collect2: error: ld returned 1 exit status
- 这里提示找不到一个名为mbedtls_debug_set_threshold的函数。这个问题是怎么出现的呢?一通搜索之后,我们找到了这个函数,它是在xr806/xr_skylark/src/net/mbedtls-2.16.8/library/debug.c中被定义的,看起来功能非常简单:
- static int debug_threshold = 0;void mbedtls_debug_set_threshold( int threshold ){ debug_threshold = threshold;}
- 注:实际上mbedtls_debug_set_threshold这个函数在多个文件中被定义了,但是实际使用的是上述文件。为什么这么肯定呢?看了xr806/xr_skylark/src/net/Kconfig中关于MBEDTLS_VER的默认选项,懂得都懂。
这个函数看起来有被正确定义,那么为什么会找不到呢?抬头看上面的几行代码,发现有一行非常显眼的预编译指令:
#if defined(MBEDTLS_DEBUG_C)
- 啊哈,看来可能是这个宏没定义造成的(实际上在这里已经被VSCode的代码高亮实锤了)。问题看来是这样的:xr806/xr_skylark/src/net/nopoll/src/nopoll_conn.c这个文件使用了mbedtls_debug_set_threshold这个函数,但这个函数只在MBEDTLS_DEBUG_C被定义的情况下才可用,因此需要在某个地方打开这个宏(当然在相应文件删除掉这个函数的调用也是一种解决方法)。
但是,在尝试搜索MBEDTLS_DEBUG_C的时候,会发现在xr806/xr_skylark/include/net/mbedtls-2.16.8/mbedtls/configs文件夹中定义了很多不同的配置,显然最终只会取到其中一个配置。那么到底是谁才是最终使用到的头文件呢?最终我们在xr806/xr_skylark/src/net/mbedtls-2.16.8/Makefile中找到了答案:是xr806/xr_skylark/include/net/mbedtls-2.16.8/mbedtls/configs/config-xr-mini-cliserv.h这个文件。解决方案就很简单了:直接来到第113行,把//注释符干掉就行了。
解决了这个问题,我们开心地重新编译libSDK,然后回到sdk目录重新二次编译,然后就结……等下,怎么又一个错误呢?定睛一看,这回的问题看起来在打包上:
[OHOS ERROR] chmod 777 ../../../../../tools/mkimage && ../../../../../tools/mkimage -c .image.cfg -o xr_system.img
- OHOS ERROR] err: bin 1 and bin 2 were overlaped!
- [OHOS ERROR] Overlapped size: 3072 Byte(3kB)
- [OHOS ERROR] bin 1 name:app.bin begin: 0x00008000 end: 0x00018C00
- [OHOS ERROR] bin 2 name:app_xip.bin begin: 0x00018000
- [OHOS ERROR][OHOS ERROR] We've rearranged bin files and generated new cfg file 'image_auto_cal.cfg', the new one is recommended.
- [OHOS ERROR] Generate image file failed
- [OHOS ERROR] cfg string:
- [OHOS ERROR] /*
- [OHOS ERROR] *
- [OHOS ERROR] * Automatically generated file; DO NOT EDIT.
- [OHOS ERROR] * XR806 SDK Configuration[OHOS ERROR] *[OHOS ERROR] */
- [OHOS ERROR] {
- [OHOS ERROR] "magic" : "AWIH",
- [OHOS ERROR] "version" : "0.5",
- [OHOS ERROR] "OTA" : {"addr": "1536k", "size": "4K"},
- [OHOS ERROR] "image" : {"max_size": "1532k"},
- [OHOS ERROR] "section" :[
- [OHOS ERROR] {"id": "0xa5ff5a00", "bin" :"boot_40M.bin", "cert": "null", "flash_offs": "0K", "sram_offs": "0x00230000", "ep": "0x00230101", "attr":"0x1"},[OHOS ERROR] {"id": "0xa5fe5a01", "bin" :"app.bin", "cert": "null", "flash_offs": "32K", "sram_offs": "0x00201000", "ep": "0x00201101", "attr":"0x1"},
- [OHOS ERROR] {"id": "0xa5fd5a02", "bin" :"app_xip.bin", "cert": "null", "flash_offs": "96K", "sram_offs": "0xffffffff", "ep": "0xffffffff", "attr":"0x2"},
- [OHOS ERROR] {"id": "0xa5fa5a05", "bin" :"wlan_bl.bin", "cert": "null", "flash_offs": "1070K", "sram_offs": "0xffffffff", "ep": "0xffffffff", "attr":"0x1"},[OHOS ERROR] {"id": "0xa5f95a06", "bin" :"wlan_fw.bin", "cert": "null", "flash_offs": "1073K", "sram_offs": "0xffffffff", "ep": "0xffffffff", "attr":"0x1"},[OHOS ERROR] {"id": "0xa5f85a07", "bin" :"sys_sdd_40M.bin", "cert": "null", "flash_offs": "1098K", "sram_offs": "0xffffffff", "ep": "0xffffffff", "attr":"0x1"},[OHOS ERROR] {}
- [OHOS ERROR] ]
- [OHOS ERROR] }看样子,这里虽然报错了,但是顺手就告诉了你问题所在和解决方案:其实就是app.bin这个文件太大,导致原来的分区装不下了,这边只要使用自动生成好的xr806/xr_skylark/project/demo/wlan_ble_demo/image/xr806/image_auto_cal.cfg文件,替换掉原有的xr806/xr_skylark/project/demo/wlan_ble_demo/image/xr806/image_wlan_ble.cfg就行啦。再来一次hb build -f,这回终于成!功!了!
这回生成的xr_system_full.img ,老规矩放在这边让读者自取,只要按照之前步骤直接刷机就可以啦。
demo完全体演示
这回我们挑个和WiFi有关的应用。首先,我们先让开发板通上网(也就是STA模式),这个只需要通过以下几行命令即可实现:
hm net sta enable
- # hm net scan # 需要搜索周围热点时可使用
- net sta connect # 和替换成热点的SSID和密码
注:
在运行后,我们可以得到如下log,说明已经成功分配了IP地址,正式连上网了:
...
- ======== Callback: connected
- [net INF] IPv6 addr state change: 0x0 --> 0x1
- [net INF] msg <>[net INF] netif (IPv4) is up
- [net INF] address: 192.168.31.156
- [net INF] gateway: 192.168.31.1
- [net INF] netmask: 255.255.255.0
- [net INF] msg
- 下一步我们来演示httpd,也就是HTTP服务器的应用。这个说来简单,如果已经把完全体demo刷进去,只需要执行下面一行命令即可。
net httpd 1
- 接下来,我们直接访问http://192.168.31.156,稍等片刻,接下来就是见证奇迹的时刻:
当然,这个demo里面还有非常多值得一试的功能,等待读者慢慢发掘。
总结
本文梳理了XR806的编译过程,并且通过不懈努力总算编译好了完全体demo,得到的回报是充分尝试了SDK支持的各种功能。如果还有后续文章的话,我想尝试一下这个移植好的shttpd,看看能不能在上面搭建更多有趣的应用。
- 请问楼主是怎么在WLS下编译成功的,现在我遇到2个问题,第一是编译不成功,第二是makeimage运行不起来。错误如下:
[OHOS INFO] [251/252] ACTION //device/xradio/xr806:libSDK(//build/lite/toolchain:arm-none-eabi-gcc)
[OHOS ERROR] [251/252] ACTION //device/xradio/xr806:libSDK(//build/lite/toolchain:arm-none-eabi-gcc)
[OHOS ERROR] FAILED: obj/device/xradio/xr806/libSDK_build_ext_components.txt
[OHOS ERROR] true &&
[OHOS ERROR] chmod 777 ../../../../../tools/mkimage && ../../../../../tools/mkimage -c .image.cfg -o xr_system.img
[OHOS ERROR] /bin/sh: 5: ../../../../../tools/mkimage: Exec format error
[OHOS ERROR] ../../../../project/project.mk:519: recipe for target 'image' failed
- 关于hm net命令的用法,可以参考WiFi联网 - XR806,当然直接看代码也不错。
- 这里显然只能搜到2.4G的网络,如果实在没有可用热点的话,也可以使用AP模式,具体就不再赘述了,看上面的文档就好。
- hm命令看起来是硬件相关的各种命令的集合,其中的iot子命令包括了gpio、uart等大家喜闻乐见的功能。这些命令对应的源文件主要在xr806/adapter/console/src文件夹中。
- 其它命令则更加侧重应用层的相关功能,特别是几乎无所不包的net命令。这些命令对应的源文件主要在xr806/xr_skylark/project/common/cmd文件夹中。
- 在后续编译的过程中需要使用Python 3(主要是hb),因此设置python软链接的这一步是必须的,而这一步会导致repo使用的Python版本有误,如果后续需要拉取代码的话,记得重新设置一下软链接到python2。
- LLVM不需要下载和安装,这里使用的是gcc。在固件编译 - XR806中,会提到如何配置编译工具链,这里不再赘述。
- SDK中的mkimage是32位程序,但是WSL 1默认并不支持32位程序。这里可以参考让win10的WSL子系统支持32bit程序,需要注意的是每次启动WSL都需要来一句sudo service binfmt-support start(如果提示error可以忽略)。
|
|
2021-12-28 15:41:28
评论
举报
|
|
|