全志科技
直播中

倪love

11年用户 870经验值
私信 关注
[问答]

跑一跑XR806的自带demo

在WSL下如何对XR806开发板进行编译呢?有哪些过程?

回帖(1)

康沧鹤

2021-12-28 15:41:28

  • 众所周知,这个开发板的最大特点是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可以忽略)。


举报

更多回帖

发帖
×
20
完善资料,
赚取积分