見出し画像

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

1. VScode インストール

Microsoft よりVScode を入手してインストールします。私は、Sysytem Installer を用いました。

画像2

2. "日本語環境"と"PlatformIO" の インストール。

”日本語環境”は①を選択し②テキストボックスに japanexe と入力して、選択+インストール。"PlatformIO IDE"は①を選択し②テキストボックスに、platformio と入力し、選択+インストール。

画像3

3. Platform(mbed)のインストール

①を選択し、PlatformIOを表示させます。②を選択しPlatform選択を表示させます。③のテキストボックスに STM32 と入力し、④検索します。⑤で"ST STM32"を選択し、インストールします。

画像4

4. "mbed-blink"のサンプルをbuild

①→ ②[Home] → ③[Project Example] と選択し、遷移後の画面から、④"mbed-legacy-example/mbed-blink"を選択し、⑤import します。かなり時間がかかります。

画像5

まだ、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が点滅します。

画像6

5. "mbed-blink"のサンプルをデバグ

①デバグを選択。②mbed-blinkを選択。③[▶]でデバグを実行できます。

画像7

ブレイクポイントを設定後、正常に起動して、デバッグコンソールを見てみると、下記のように動作します。

画像8

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]

画像9

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

この記事が気に入ったらサポートをしてみませんか?