EVK-ODIN-W2(技適付きWiFiモジュールEVK)を使ってデバッガーの起動まで[Platform IO編]
ココでEVK-NINA-W1をPlatform IOでのデバグ方法を紹介しましたが、EVK-ODIN-W2もPlatform IOでデバグ可能なので紹介します。ODIN-W2も技適付きです。
【EVK-ODIN-W2とは】
・機能:WiFi 2.4GHz/5GHz モジュール
・チップセット:STM32F439 (256K RAM / 2MB ROM )
・認証:日本の技適付き(204-510009)
・プログラム環境:mbed
・デバッガ機能:ST-LINVK -V2のJTAG機能
・デバグ環境:Platform IO などなど
【注意点】
まず注意点から。
わかっている人は、下記の注意点だけ知っていれば、自分で環境構築ができると思います。
[1] ST-LINKのドライバーのインストールが必要、下記からインストールします。https://www.st.com/ja/development-tools/stsw-link009.html
[2] RTCを接続しておく必要あり。
下記の”ココ”のジャンパを接続する必要あり。接続しないと実行時にエラーが出ます。
1. VScode インストール
Microsoft よりVScode を入手してインストールします。私は、Sysytem Installer を用いました。
2. "日本語環境"と"PlatformIO" の インストール。
”日本語環境”は①を選択し②テキストボックスに japanexe と入力して、選択+インストール。"PlatformIO IDE"は①を選択し②テキストボックスに、platformio と入力し、選択+インストール。
3. Platform(mbed)のインストール
①を選択し、PlatformIOを表示させます。②を選択しPlatform選択を表示させます。③のテキストボックスに STM32 と入力し、④検索します。⑤で"ST STM32"を選択し、インストールします。
4. "mbed-blink"のサンプルをbuild
①→ ②[Home] → ③[Project Example] と選択し、遷移後の画面から、④"mbed-legacy-example/mbed-blink"を選択し、⑤import します。かなり時間がかかります。
まだ、Buildできません。platformio.ini を下記に書き換えます。デフォルトでは、odin-w2の設定になっていないからです。
[env:ublox_evk_odin_w2]
platform = ststm32
board = ublox_evk_odin_w2
framework = mbed
debug_tool = stlink
upload_protocol = stlink
[✓]マークでBuildできます。[→]で書き込めます。正常に書き込まれ他場合のログが下記です。LEDが点滅します。
5. "mbed-blink"のサンプルをデバグ
①デバグを選択。②mbed-blinkを選択。③[▶]でデバグを実行できます。
ブレイクポイントを設定後、正常に起動して、デバッグコンソールを見てみると、下記のように動作します。
6."WiFi"を動作させるコードをbuild
6-1 "New Project"からスタート。
EVK-ODIN-W2はmbed6に対応していないので、Exampleからスタートすると WiFiのコードが動作しません。mbed5の環境を作るために、New Projectからスタートします。
①→②→③[+New Project]→④[EVK-ODIN-W2-WiFi-2]を入力→⑤ u-blox EVK-ODIN-W2を選択→⑥Mbedを選択→⑦[Finish]
6-2 main.cpp と platform.ini と、mbed_app.jsonの準備
main.cppを下記に置き換えます。
/* Copyright (c) 2018 Arm Limited
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#include "mbed.h"
#if !defined(MBED_SYS_STATS_ENABLED)
#error [NOT_SUPPORTED] test not supported
#endif
WiFiInterface *wifi;
const char *sec2str(nsapi_security_t sec)
{
switch (sec) {
case NSAPI_SECURITY_NONE:
return "None";
case NSAPI_SECURITY_WEP:
return "WEP";
case NSAPI_SECURITY_WPA:
return "WPA";
case NSAPI_SECURITY_WPA2:
return "WPA2";
case NSAPI_SECURITY_WPA_WPA2:
return "WPA/WPA2";
case NSAPI_SECURITY_UNKNOWN:
default:
return "Unknown";
}
}
int scan_demo(WiFiInterface *wifi)
{
WiFiAccessPoint *ap;
printf("Scan:\n");
int count = wifi->scan(NULL,0);
if (count <= 0) {
printf("scan() failed with return value: %d\n", count);
return 0;
}
/* Limit number of network arbitrary to 15 */
count = count < 15 ? count : 15;
ap = new WiFiAccessPoint[count];
count = wifi->scan(ap, count);
if (count <= 0) {
printf("scan() failed with return value: %d\n", count);
return 0;
}
for (int i = 0; i < count; i++) {
printf("Network: %s secured: %s BSSID: %hhX:%hhX:%hhX:%hhx:%hhx:%hhx RSSI: %hhd Ch: %hhd\n", ap[i].get_ssid(),
sec2str(ap[i].get_security()), ap[i].get_bssid()[0], ap[i].get_bssid()[1], ap[i].get_bssid()[2],
ap[i].get_bssid()[3], ap[i].get_bssid()[4], ap[i].get_bssid()[5], ap[i].get_rssi(), ap[i].get_channel());
}
printf("%d networks available.\n", count);
delete[] ap;
return count;
}
int main()
{
printf("WiFi example\n");
mbed_stats_sys_t stats;
mbed_stats_sys_get(&stats);
#ifdef MBED_MAJOR_VERSION
printf("Mbed OS version %d.%d.%d\n\n", MBED_MAJOR_VERSION, MBED_MINOR_VERSION, MBED_PATCH_VERSION);
#endif
/* CPUID Register information
[31:24]Implementer 0x41 = ARM
[23:20]Variant Major revision 0x0 = Revision 0
[19:16]Architecture 0xC = Baseline Architecture
0xF = Constant (Mainline Architecture)
[15:4]PartNO 0xC20 = Cortex-M0
0xC60 = Cortex-M0+
0xC23 = Cortex-M3
0xC24 = Cortex-M4
0xC27 = Cortex-M7
0xD20 = Cortex-M23
0xD21 = Cortex-M33
[3:0]Revision Minor revision: 0x1 = Patch 1
*/
printf("CPU ID: 0x%x \n", stats.cpu_id);
/* Compiler IDs
ARM = 1
GCC_ARM = 2
IAR = 3
*/
printf("Compiler ID: %d \n", stats.compiler_id);
/* Compiler versions:
ARM: PVVbbbb (P = Major; VV = Minor; bbbb = build number)
GCC: VVRRPP (VV = Version; RR = Revision; PP = Patch)
IAR: VRRRPPP (V = Version; RRR = Revision; PPP = Patch)
*/
printf("Compiler Version: %d \n", stats.compiler_version);
/* RAM / ROM memory start and size information */
for (int i = 0; i < MBED_MAX_MEM_REGIONS; i++) {
if (stats.ram_size[i] != 0) {
printf("RAM%d: Start 0x%lx Size: 0x%lx \n", i, stats.ram_start[i], stats.ram_size[i]);
}
}
for (int i = 0; i < MBED_MAX_MEM_REGIONS; i++) {
if (stats.rom_size[i] != 0) {
printf("ROM%d: Start 0x%lx Size: 0x%lx \n", i, stats.rom_start[i], stats.rom_size[i]);
}
}
/* WiFi Code Start */
wifi = WiFiInterface::get_default_instance();
if (!wifi) {
printf("ERROR: No WiFiInterface found.\n");
return -1;
}
int count = scan_demo(wifi);
if (count == 0) {
printf("No WIFI APs found - can't continue further.\n");
return -1;
}
printf("\nConnecting to %s...\n", MBED_CONF_APP_WIFI_SSID);
int ret = wifi->connect(MBED_CONF_APP_WIFI_SSID, MBED_CONF_APP_WIFI_PASSWORD, NSAPI_SECURITY_WPA_WPA2);
if (ret != 0) {
printf("\nConnection error: %d\n", ret);
return -1;
}
printf("Success\n\n");
printf("MAC: %s\n", wifi->get_mac_address());
printf("IP: %s\n", wifi->get_ip_address());
printf("Netmask: %s\n", wifi->get_netmask());
printf("Gateway: %s\n", wifi->get_gateway());
printf("RSSI: %d\n\n", wifi->get_rssi());
wifi->disconnect();
printf("\nDone\n");
/* WiFi Code End */
return 0;
}
platform.iniを下記に置き換えます。
[env:ublox_evk_odin_w2]
platform = ststm32
board = ublox_evk_odin_w2
framework = mbed
debug_tool = stlink
upload_protocol = stlink
build_flags = -D PIO_FRAMEWORK_MBED_RTOS_PRESENT
mbed_app.jsonを加えます。my-ssid / my-password に自分のAPの設定を書き込みます。
{
"macros": ["MBED_SYS_STATS_ENABLED"],
"config": {
"wifi-ssid": {
"help": "WiFi SSID",
"value": "\"my-ssid\""
},
"wifi-password": {
"help": "WiFi Password",
"value": "\"my-password\""
}
},
"target_overrides": {
"*": {
"platform.stdio-baud-rate": 115200,
"platform.stdio-convert-newlines": true
}
}
}
6.3 Buildと実行
前述のように[✓]マークでBuild。[→]で書き込みです。正常に書き込みが終わると下記のようなメッセージが出力されます。
> Executing task in folder EVK-ODIN-W2-WiFi-2: C:\Users\hiroa\.platformio\penv\Scripts\platformio.exe run --target upload --environment ublox_evk_odin_w2 <
Processing ublox_evk_odin_w2 (platform: ststm32; board: ublox_evk_odin_w2; framework: mbed)
---------------------------------------------------------------------------------------------------Verbose mode can be enabled via `-v, --verbose` option
CONFIGURATION: https://docs.platformio.org/page/boards/ststm32/ublox_evk_odin_w2.html
PLATFORM: ST STM32 (14.0.1) > u-blox EVK-ODIN-W2
HARDWARE: STM32F439ZIY6 168MHz, 256KB RAM, 2MB Flash
DEBUG: Current (stlink) External (blackmagic, cmsis-dap, jlink, stlink)
PACKAGES:
- framework-mbed 6.51506.201227 (5.15.6)
- tool-dfuutil 1.9.200310
- tool-openocd 2.1100.0 (11.0)
- tool-stm32duino 1.0.2
- toolchain-gccarmnoneeabi 1.90201.191206 (9.2.1)
Collecting mbed sources...
LDF: Library Dependency Finder -> http://bit.ly/configure-pio-ldf
LDF Modes: Finder ~ chain, Compatibility ~ soft
Found 0 compatible libraries
Scanning dependencies...
No dependencies
Building in release mode
Checking size .pio\build\ublox_evk_odin_w2\firmware.elf
Advanced Memory Usage is available via "PlatformIO Home > Project Inspect"
RAM: [== ] 19.0% (used 49916 bytes from 262144 bytes)
Flash: [== ] 21.5% (used 451760 bytes from 2097152 bytes)
Configuring upload protocol...
AVAILABLE: blackmagic, cmsis-dap, jlink, stlink
CURRENT: upload_protocol = stlink
Uploading .pio\build\ublox_evk_odin_w2\firmware.elf
xPack OpenOCD, x86_64 Open On-Chip Debugger 0.11.0-00155-ge392e485e (2021-03-15-16:44)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
debug_level: 1
hla_swd
target halted due to debug-request, current mode: Thread
xPSR: 0x01000000 pc: 0x08024498 msp: 0x20030000
** Programming Started **
** Programming Finished **
** Verify Started **
** Verified OK **
** Resetting Target **
shutdown command invoked
================================== [SUCCESS] Took 39.93 seconds ==================================
ターミナルはタスクで再利用されます、閉じるには任意のキーを押してください。
正常に動作した例が下記となります。
WiFi example
Mbed OS version 5.15.6
CPU ID: 0x410fc241
Compiler ID: 2
Compiler Version: 90200
RAM0: Start 0x20000000 Size: 0x30000
RAM1: Start 0x10000000 Size: 0x10000
ROM0: Start 0x8000000 Size: 0x200000
Scan:
Network: elecom-528e0d secured: WPA2 BSSID: 4:AB:18:52:8e:f RSSI: -90 Ch: 1
Network: e-tomo-528e0d secured: WPA2 BSSID: 4:AB:18:52:8e:10 RSSI: -90 Ch: 1
Network: elecom-528e0d secured: WPA2 BSSID: 4:AB:18:52:8e:12 RSSI: -91 Ch: 52
3 networks available.
Connecting to elecom-528e0d...
Success
MAC: d4:ca:6e:70:88:0f
IP: 192.168.2.107
Netmask: 255.255.255.0
Gateway: 192.168.2.1
RSSI: -91
Done
ちなみに、CPU ID: 0x410fc241の意味は、ARM/Cortex-M4/Ver1 の意味のようです。デバッガの起動も前述のとおりです。
(これを書いている間に、女子バレーが韓国に2-3で負けてしまった。良い試合でした。)
2021年7月31日@HoKoR