Azure Sphere の使用開始 | Microsoft Azure を参考に、開発環境をセットアップする。
開発キットをセットアップして Azure Sphere SDK for Windows をインストールする に記載ある通り、USBケーブルでPCと開発キットをつなぐだけでドライバが自動でダウンロードされる。デバイスマネジャーを確認すると4つのUSBシリアルコンバーターが確認できる。
Azure_Sphere_Win_SDK_20_07.exe を上記リンクからインストールする。この操作により、開発用のライブラリと、Azure Sphere Developer Command Prompt がインストールされる。
無料の IDE と開発者ツール | Visual Studio Community
Azure Sphere - Visual Studio Marketplace にアクセスし、 Visual Studio Extension for Azure Sphere をインストールする
デバイスを要求するクイックスタート-Azure Sphere
デバイスは、Azure Sphereテナントに関連付けられる必要がある。 テナントとサブスクリプションの関係についてはこちらで分かりやすく説明してくれている。
What is the difference between an Azure tenant and Azure subscription?
初めてのログインなので、Azure Sphere Developer Command Prompt から以下のように入力する
azsphere login --newuser example@az.com
Registration successful. Press any key to log in with your new account.
Azure ADが別ウィンドウで立ち上がるので、先ほど入力したユーザー情報でログイン。アクセス許可を確認されるので、同様に問題なければ承諾する。
完了するとAzure AD画面は閉じられ、cmdに以下のメッセージが表示される。
Login successful as 'example@az.com'.
warn: You don't have access to any Azure Sphere tenants.
warn: Type 'azsphere tenant create --name ' or, if you have used Azure Sphere before, type 'azsphere tenant migrate'.
次のリンクを参考に、Azure Sphereテナントを作成する。 Azure Sphere テナントを作成する デバイスがPCにUSBケーブルで接続済みであることを確認して、以下のコマンドを実行する。
azsphere tenant create --force --name mt3620
warn: You have logged in with the following account:
warn: example@az.com (0ef8954b-1234-5678-abcd-5a8efghjklm)
warn: Do you want to use this account to create a new Azure Sphere tenant using the attached device?
warn: You cannot change the tenant name 'mt3620' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
「yes」を入力
Created a new Azure Sphere tenant:
--> Tenant Name: mt3620
--> Tenant ID: 7c2c0fa6-1234-5678-abcd-efgh90d72555
Selected Azure Sphere tenant 'mt3620' as the default.
You may now wish to claim the attached device into this tenant using 'azsphere device claim'.
※tenant create時に発生したエラーの対応履歴
Failed to retrieve device ID from attached device: 'Could not connect to the device; please ensure it is attached.'
Troubleshoot Azure Sphere issues 接続されているデバイスを確認する
azsphere device list-attached
No attached devices
デバイスマネージャーからはデバイスが見えている、MT3620のPower Indicatorは点灯している
azsphere device rescan-attached
1 device attached:
--> Device ID: 698A60985xxxxxxx
--> Is responsive: yes
--> IP address: 192.168.35.2
--> Connection path: 133
これでデバイスが正しく認識されたので、次のステップへと進む。
azsphere device claim
warn: You are claiming a device to the following tenant:
warn: 7c2c0fa6-1234-5678-abcd-efgh90d72555 (MT3620)
warn: Do you want to claim the device ID 698A60985xxxxxxx to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
「yes」と入力
Claiming device.
Successfully claimed device ID '698A60985xxxxxxx' into tenant 'MT3620' with ID '7c2c0fa6-1234-5678-abcd-efgh90d72555'.
wifiのSSID(ここでは「mySSID」)とキー(ここでは「myKey」)を準備して以下の操作を行う。
azsphere device wifi add --ssid mySSID --psk myKey
問題なく接続できると、以下のように表示される。
warn: Your device's Azure Sphere OS version is deprecated. Run 'azsphere device recover' to erase your device and move it to a current OS version. See https://aka.ms/AzureSphereUpgradeGuidance for further advice and support. Add network succeeded: ID : 0
SSID : mySSID
Configuration state : enabled
Connection state : unknown
Security state : psk
Targeted scan : False
device wifi show-statusでステータスを確認したかったが、
warn: Your device's Azure Sphere OS version is deprecated. Run 'azsphere device recover' to erase your device and move it to a current OS version. See https://aka.ms/AzureSphereUpgradeGuidance for further advice and support. error: Device error 15.2
実際以下のコマンドで確認してみると...
azsphere device show-deployment-status
warn: Your device's Azure Sphere OS version is deprecated. Run 'azsphere device recover' to erase your device and move it to a current OS version. See https://aka.ms/AzureSphereUpgradeGuidance for further advice and support. Your device is running Azure Sphere OS version TP4.2.1.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version 20.07.
warn: Your device is running Azure Sphere OS version TP4.2.1. The latest release version is 20.07.
warn: Your device's Wi-Fi status could not be checked: Device error 15.2
Go to https://aka.ms/AzureSphereUpgradeGuidance for further advice and support.
この時点での最新OSは20.07なので、かなり古いOSが動作している。こちらを参考にボードを更新する。 初期の開発キットで OS を更新する
azsphere device recover
Downloading recovery images... Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5438976 bytes to send)
Sent 1 of 17 images. (5436600 of 5438976 bytes remaining)
Sent 2 of 17 images. (5410588 of 5438976 bytes remaining)
Sent 3 of 17 images. (5307636 of 5438976 bytes remaining)
Sent 4 of 17 images. (5307244 of 5438976 bytes remaining)
Sent 5 of 17 images. (5037264 of 5438976 bytes remaining)
Sent 6 of 17 images. (5020780 of 5438976 bytes remaining)
Sent 7 of 17 images. (4990728 of 5438976 bytes remaining)
Sent 8 of 17 images. (2397456 of 5438976 bytes remaining)
Sent 9 of 17 images. (885796 of 5438976 bytes remaining)
Sent 10 of 17 images. (861220 of 5438976 bytes remaining)
Sent 11 of 17 images. (758608 of 5438976 bytes remaining)
Sent 12 of 17 images. (135796 of 5438976 bytes remaining)
Sent 13 of 17 images. (70048 of 5438976 bytes remaining)
Sent 14 of 17 images. (41164 of 5438976 bytes remaining)
Sent 15 of 17 images. (32768 of 5438976 bytes remaining)
Sent 16 of 17 images. (16384 of 5438976 bytes remaining)
Sent 17 of 17 images. (0 of 5438976 bytes remaining)
Finished writing images; rebooting board.
Device ID: 698A60985D6C44C68C8F986AC5222529E5751A8793C47189DB61F62CF66FF3A8FBD1A2BAFC1646BB954EEA3CFBB385C8E29B72F7C31E67B689EF47FF1119BDC0
Device recovered successfully.
以上でセットアップ完了。