1# amebaz on RT-Thread 2 3## 1 简介 4 5amebaz 是由Realtek推出的Cortex-M4内核的WiFi SOC芯片，属于rtl8710b系列。硬件特性如下： 6 7| 硬件 | 描述 | 8| -- | -- | 9|芯片型号| amebaz | 10|CPU| Cortex-M4 | 11|主频| 125MHz | 12 13## 2 编译说明 14 15| 环境 | 说明 | 16| ------------ | ------------------------------------------------------------ | 17| PC操作系统 | Linux/MacOS/Windows | 18| 编译器 | arm-none-eabi-gcc version 6.3.1 20170620 (release) | 19| 构建工具 | scons | 20| 依赖软件环境 | Env工具/(IAR或arm-none-eabi-gcc)/git/调试器驱动 | 21 22## 3 下载源码 23 24```bash 25 git clone https://github.com/RT-Thread/rt-thread.git 26``` 27 28## 4 环境准备 29 30### 4.1 Windows 环境准备 31 32Windows环境下有两种开发环境，`GCC toolchain` 和 `IAR IDE`，根据不同的需求自行选择。 33 34#### 4.1.1 IAR 发开环境 35 36IAR 开发环境需要开发者自己安装软件，安装过程这里就不特别说明了。amebaz工程当前仅支持 `IAR 7.X` 的版本。 37 38#### 4.4.2 GCC 开发环境 39 40GCC开发使用 RT-Thread 官方提供的 env 工具，该工具集成 GCC 工具链，还具有编译构建环境、图形化系统配置及软件包管理功能。 41 42下载地址：[点击下载env工具](https://www.rt-thread.org/download.html#download-rt-thread-env-tool) 43 44第一次使用env工具的开发者可以去这里查看教程：[RT-Thread env 工具用户手册](https://www.rt-thread.org/document/site/#/development-tools/env/env)。 45 46### 4.2 Linux/Mac 环境准备 47 48Linux/Mac 仅支持 GCC 工具链。 49 50```bash 51 cd rt-thread/bsp/amebaz 52 scons --menuconfig 53 source ~/.env/env.sh 54 pkgs --upgrade 55``` 56 57## 5 配置工程（可选） 58 59### 5.1 Windows 配置工程 60 61配置工程，需要在相应的工程目录下使用 `menuconfig` 命令打开图形界面，开发者根据自己的需求开关功能组件。 62 63```bash 64 menuconfig 65``` 66 67### 5.2 Linux/Mac 配置工程 68 69（Linux/Mac） 70 71```bash 72 scons --menuconfig 73``` 74 75## 6 更新软件包 76 77amebaz 配套的驱动库以 package 形式提供，故需先下载对应的 package(realtek-ameba)，在工程目录下，使用下面命令下载软件包。 78 79```bash 80 pkgs --update 81``` 82 83## 7 编译 84 85### 7.1 Windows 编译工程 86 87#### 7.1.1 IAR 编译工程 88 89先打开工程目录下的IAR工程（project.eww），然后单击 Project 选项卡，单击 Rebuild All 选项，进行编译 90 91 92 93#### 7.1.2 GCC 编译工程 94 95可以使用env编译工程，无需设置GCC工具链路径，直接在 rt-thread/bsp/amebaz 工程目录下输入 `scons` 编译即可。编译完成后，在工程目录下生成 `image2_all_ota1.bin` 文件。 96 97```bash 98 scons 99``` 100 101### 7.2 Linux/Mac 编译工程 102 103如果没有配置GCC路径的环境变量，则需要使用以下指令设置gcc路径。 104 105```bash 106 export RTT_EXEC_PATH=[GCC路径] 107``` 108 109设置 GCC 路径后，使用 `scons` 编译工程。 110 111```bash 112 scons 113``` 114 115或者通过 `scons --exec-path="GCC工具链路径"` 命令，在指定工具链位置的同时直接编译。 116 117出现下列信息即为编译成功 118 119```bash 120LINK rtthread.axf 121arm-none-eabi-objcopy -j .ram_image2.entry -j .ram_image2.data -j .ram_image2.bss -j .ram_image2.skb.bss -j .ram_heap.data -Obinary rtthread.axf ram_2.r.bin 122arm-none-eabi-objcopy -j .xip_image2.text -Obinary rtthread.axf xip_image2.bin 123arm-none-eabi-objcopy -j .ram_rdp.text -Obinary rtthread.axf rdp.bin 124python gen_bin.py 125is_law = 1 126start = 10005000, end = 0, base = 10000000 127Input file size: 65852 128copy size 45372 129start = 10005000, end = 0, base = 10000000 130Input file size: 45372 131copy size 24892 132start = 0, end = 0, base = 0 133Input file size: 336816 134copy size 336816 135size = 361772 136checksum 209b36c 137'true' is not recognized as an internal or external command, 138operable program or batch file. 139Done... 140scons: done building targets. 141``` 142 143如果编译正确无误，会在工程目录下生成 image2_all_ota1.bin 文件。 144 145## 8 烧写及执行 146 147### 8.1 IAR下载 148 149下载程序分为两部分： 150 151（a）先使用jlink工具正确连接A14(CLK),A15(TMS),GND,VCC引脚 152 153（b）打开 IAR 工程并完成编译后，单击 Project 选项卡下 Download 选项，选择 Download active application 下载程序。 154 155 156 157（c）短按复位按钮，连接串口查看调试信息 158 159### 8.2 串口下载 160 161串口下载分为三个步骤 162 163（a）板子进入下载模式 164 165板子使用 `micros usb` 上电，然后按住 `FLASH` 键不放手，短按 `RST` 键，松开 `RST` 和 `FLASH` 键进入下载模式。 166 167（b）配置下载工具 168 169打开 Image Tool 下载工具配置使用，选择 `micros usb` 所对应的串口端口，选择波特率，默认波特率 1.5Mbps，然后打开串口端口，如下载工具图“①”所示 170 171 172 173boot选择工程提供的 `boot_all.bin`, OTA1 选择生成的 image2_all_ota1.bin 文件（通常在工程目录下），并且注意在这两个选项前面打勾确认，其他默认即可，如下载工具图“②”。 174 175（c）下载程序 176 177按下 Download（如下载工具图 “③”），即可开始下载程序，并且可以从日志窗口查看到下载信息。 178 179## 9 运行 180 181下载程序后，连接串口（默认使用板子上 `micro usb`），打开串口工具，配置串口波特率 115200，数据位 8 位，停止位 1 位，无校验，无流控；短按 `RST` 键复位，串口将输出调试信息，如下所示： 182 183```bash 184 \ | / 185- RT - Thread Operating System 186 / | \ 3.1.1 build Oct 25 2018 187 2006 - 2018 Copyright by rt-thread team 188lwIP-2.0.2 initialized! 189 190Initializing WIFI ... 191LDO Mode, BD_Info: 0 192 193LDO Mode, BD_Info: 0 194 195WIFI initialized 196[I/WIFI] amebaz_wifi_start success 197build time: Oct 25 2018 10:52:02 198Hello RT-Thread! 199[I/WLAN.dev] wlan init success 200[I/WLAN.lwip] eth device init ok name:w0 201msh > 202``` 203 204## 10 WIFI简单使用 205 206### wifi扫描命令 207 208wifi 扫描命令格式如下 209 210```bash 211 wifi scan 212``` 213 214命令说明 215 216| 字段 | 描述 | 217| ---- | ------------------------ | 218| wifi | 有关wifi命令都以wifi开头 | 219| scan | wifi执行扫描动作 | 220 221在调试工具中输入该命令，即可进行 wifi 命令扫描，调试信息如下 222 223```bash 224scan ap down 225 SSID MAC security rssi chn Mbps 226------------------------------- ----------------- -------------- ---- --- ---- 227NEO-shanghai-ap2 58:66:ba:a1:ee:71 WPA2_TKIP_PSK -74 11 0 228WQ1 88:25:93:94:51:54 WPA2_AES_PSK -76 13 0 229shyc1 a0:40:a0:a3:e8:c9 WPA2_AES_PSK -77 13 0 230KVIP 70:65:82:3b:71:43 WPA2_AES_PSK -83 11 0 231YST2016 88:25:93:c6:67:d1 WPA2_TKIP_PSK -84 4 0 232``` 233 234> 注：wifi 有关的命令，均以wifi开头。 235 236### wifi 接入 237 238接入 wifi 之前，先介绍一下其接入的命令 ，如下 239 240```bash 241 wifi join ssid 123456789 242``` 243 244命令说明 245 246| 字段 | 描述 | 247| --------- | ---------------------------------- | 248| wifi | 有关wifi命令都以wifi开头 | 249| join | wifi执行连接动作 | 250| ssid | 热点的名字 | 251| 123456789 | 热点的密码，没有密码可不输入这一项 | 252 253了解上述命令，并且成功完成前面步骤，在串口中输入 `wifi w0 join realthread_VIP 123456789` ，如下日志表示连接成功 254 255```bash 256 257WIFI wlan0 Setting: 258============================== 259 MODE => STATION 260 SSID => realthread_VIP 261 CHANNEL => 6 262 SECURITY => AES 263 PASSWORD => 123456789 264[I/WLAN.mgnt] wifi connect success ssid:realthread_VIP 265 266``` 267 268另外，提供一个简单的测试使用命令，查询设备IP地址命令：ifconfig。 269 270```bash 271network interface: w0 (Default) 272MTU: 1500 273MAC: 00 e0 4c d5 ac 46 274FLAGS: UP LINK_UP ETHARP BROADCAST 275ip address: 172.16.200.110 276gw address: 172.16.200.1 277net mask : 255.255.255.0 278dns server #0: 172.16.200.1 279dns server #1: 223.5.5.5 280``` 281 282## 驱动支持情况及计划 283 284| 驱动 | 支持情况 | 备注 | 285| ---------- | :------: | :--------------------------: | 286| UART | 支持 | UART0 | 287| WLAN | 部分支持 | 仅支持STA模式 | 288 289## 联系人信息 290 291维护人: 292[flyingcys][4] < [flyingcys@163.com][5] > 293 294 [1]: https://www.rt-thread.org/download.html#download-rt-thread-env-tool 295 [4]: https://github.com/flyingcys 296 [5]: mailto:flyingcys@163.com 297
