导航

    全志在线开发者论坛
    • 注册
    • 登录
    • 搜索
    • 版块
    • 话题
    • 在线文档
    • 社区主页

    在WSL上编译并运行XR806的完全体demo

    XR系列-无线互联
    3
    5
    1837
    正在加载更多帖子
    • 从旧到新
    • 从新到旧
    • 最多赞同
    回复
    • 在新帖中回复
    登录后回复
    此主题已被删除。只有拥有主题管理权限的用户可以查看。
    • M
      metro LV 3 最后由 metro 编辑

      简介

      前几天刚刚收到极术社区发放的XR806开发板，先来拍个美图~

      XR806 Development Board

      众所周知，这个开发板的最大特点是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编译环境准备，但有几个地方需要注意：

      1. 在后续编译的过程中需要使用Python 3（主要是hb），因此设置python软链接的这一步是必须的，而这一步会导致repo使用的Python版本有误，如果后续需要拉取代码的话，记得重新设置一下软链接到python2。
      2. LLVM不需要下载和安装，这里使用的是gcc。在固件编译 - XR806中，会提到如何配置编译工具链，这里不再赘述。
      3. SDK中的mkimage是32位程序，但是WSL 1默认并不支持32位程序。这里可以参考让win10的WSL子系统支持32bit程序，需要注意的是每次启动WSL都需要来一句sudo service binfmt-support start（如果提示error可以忽略）。

      编译完全体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支持的大部分功能。这些命令又可以进一步被分为两大类，其中：

      • hm命令看起来是硬件相关的各种命令的集合，其中的iot子命令包括了gpio、uart等大家喜闻乐见的功能。这些命令对应的源文件主要在xr806/adapter/console/src文件夹中。
      • 其它命令则更加侧重应用层的相关功能，特别是几乎无所不包的net命令。这些命令对应的源文件主要在xr806/xr_skylark/project/common/cmd文件夹中。

      那么要怎么把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 # 需要搜索周围热点时可使用
hm net sta connect <ssid> <psk> # <ssid>和<psk>替换成热点的SSID和密码

      注：

      1. 关于hm net命令的用法，可以参考WiFi联网 - XR806，当然直接看代码也不错。
      2. 这里显然只能搜到2.4G的网络，如果实在没有可用热点的话，也可以使用AP模式，具体就不再赘述了，看上面的文档就好。

      在运行后，我们可以得到如下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 <network IPv6 state>

      下一步我们来演示httpd，也就是HTTP服务器的应用。这个说来简单，如果已经把完全体demo刷进去，只需要执行下面一行命令即可。

      net httpd 1

      接下来，我们直接访问http://192.168.31.156，稍等片刻，接下来就是见证奇迹的时刻：

      XR806 HTTPD Demo

      当然，这个demo里面还有非常多值得一试的功能，等待读者慢慢发掘。

      总结

      本文梳理了XR806的编译过程，并且通过不懈努力总算编译好了完全体demo，得到的回报是充分尝试了SDK支持的各种功能。如果还有后续文章的话，我想尝试一下这个移植好的shttpd，看看能不能在上面搭建更多有趣的应用。

      I 1 条回复 最后回复 回复 引用 分享 1
      • I
        i513536373 LV 2 @metro 最后由 编辑

        @metro 请问楼主是怎么在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

        I 1 条回复 最后回复 回复 引用 分享 0
        • I
          i513536373 LV 2 @i513536373 最后由 编辑

          @i513536373 在 在WSL上编译并运行XR806的完全体demo 中说：

          @metro 请问楼主是怎么在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

          不好意思，makeimage这个问题你文中有说明，现在就是第一个问题不知道是什么情况。

          M X 2 条回复 最后回复 回复 引用 分享 0
          • M
            metro LV 3 @i513536373 最后由 编辑

            @i513536373 编译不成功的现象是？贴一下错误信息吧。

            1 条回复 最后回复 回复 引用 分享 0
            • X
              xisecret LV 3 @i513536373 最后由 编辑

              @i513536373 这问题有解决吗，我也遇到了

              1 条回复 最后回复 回复 引用 分享 0
              • 1 / 1
              • First post
                Last post

              Copyright © 2024 深圳全志在线有限公司 粤ICP备2021084185号 粤公网安备44030502007680号

              行为准则 | 用户协议 | 隐私权政策