本節內容如下:
一、安裝開發工具包(本文以windows 版爲例)
二、新的Azure Sphere 開發板手動更新Azure Sphere操作系統
三、配置VS Code及Azure Sphere擴展
四、聲明 Azure Sphere 設備(本文中均以一個新設備來進行演示)
使用Microsoft 賬戶創建用戶並登錄到Azure Sphere 服務;
使用用戶(Microsoft 賬戶)創建租戶;
聲明:將Azure Sphere 設備ID綁定到租戶,該過程也稱爲認領;
五、配置設備通過WIFI聯網
六、啓用設備上的應用開發
視頻講解:
您可以在B站觀看視頻講解:https://www.bilibili.com/video/av98009311/
圖文講解:
一、安裝開發工具(本文以windows 版爲例)
參考文檔:https://docs.microsoft.com/zh-cn/azure-sphere/install/install-sdk
Azure Sphere 開發板通過USB接口插入電腦後,會在設備管理器中提示三個com口,如下圖:
如果發生其他錯誤,或者看到的 COM 端口少於三個,請參閱排查 Windows 安裝問題以獲取幫助。
Windows 平臺下的Azure Sphere SDK 有兩類,只安裝一類即可,不能同時安裝兩個:
1. 用於Visual Studio 的Azure Sphere SDK:
使用Visual studio 開發,需要: Visual Studio Enterprise、Professional 或 Community 2019 版本 16.4 或更高版本。
使用Visual Studio Code 開發。
2. 用於Windows 的Azure Sphere SDK:
使用Windows 命令提示符開發;
使用Visual Studio Code 開發。
本文中,採用 “用於Windows的Azure Sphere SDK” + VS Code 開發。
SDK 下載地址:https://docs.microsoft.com/zh-cn/azure-sphere/install/install-sdk#azure-sphere-sdk-for-windows
SDK安裝:
安裝完成後,會在開始菜單中,出現如下圖所示程序:
二、新的Azure Sphere 開發板手動更新Azure Sphere操作系統
在開發板背部安裝鈕釦電池
通過附帶的USB連接線連接至Windows 電腦
對於未使用過的Azure Sphere開發板,首次使用,需要參照如下文檔進行Azure Sphere OS升級:
https://docs.microsoft.com/zh-cn/azure-sphere/resources/update-old-seeed-os
升級過程很簡單:
1. 打開Azure Sphere Develop Command Prompt
2. 輸入命令並等待執行成功:azsphere device recover
三、配置VS Code及Azure Sphere擴展
VS Code 安裝Azure Sphere 擴展:
對於本文中的“用於Windows的Azure Sphere SDK” 和VS Code 開發應用程序,還需要安裝如下兩個程序:
1. CMake https://cmake.org/download/
2. Ninja https://github.com/ninja-build/ninja/releases
對於CMake的安裝,直接下一步下一步就可以了:
對於Ninja,需要解壓到某目錄後,設置環境變量:
Azure Sphere 開發板支持兩種應用程序:
1.高級應用程序
2.RTApp實時應用程序
實時應用程序主要利用MCU中的兩個ARM Cortex-M4 處理器在實時操作系統上RTOS進行開發,本系列文章暫時不做該內容的介紹。
截至到此,我們已經配置完成了開發高級應用程序的環境,對於RTApp的開發環境配置,本文不再介紹,請參見官網:
四、聲明 Azure Sphere 設備(本文中均以一個新設備來進行演示)
使用Microsoft 賬戶創建用戶並登錄到Azure Sphere 服務;
使用用戶(Microsoft 賬戶)創建租戶;
聲明:將Azure Sphere 設備ID綁定到租戶,該過程也稱爲認領;
三個步驟的最終目的就是聲明設備,聲明設備是將設備ID和Azure Sphere 租戶綁定,也稱之爲“認領”的過程,一旦綁定,即使你將Azure Sphere 設備進行二次銷售,該綁定也不能修改。
關於聲明的詳細步驟,請參見官網:https://docs.microsoft.com/zh-cn/azure-sphere/install/claim-device
本文中,簡化了官網文檔,僅假設我們操作的設備是一臺全新的Azure Sphere,故而很多步驟是不需要操作的。
1. 通過命令登錄Azure Shpere,對於剛裝好SDK並第一次使用SDK,使用 --newuser
參數以及 Microsoft 帳戶電子郵件地址可以創建一個賬戶並登錄:
azsphere login --newuser <email-address>
按照提示輸入Microsoft 賬戶的密碼:
同意授權:
登錄成功之後:
如果你有權訪問單個租戶,則默認選中該租戶,此時可繼續執行下一步。
如果你無權訪問任何租戶,則需要創建租戶。
如果以前已將 Azure Sphere 與 19.09 SDK(或早期版本)配合使用,則可能需要遷移租戶。
如果你有權訪問多個租戶,則需要選擇一個。 有關詳細信息,請參閱 azsphere tenant select。 選擇租戶後,請繼續執行下一步。
在本例中,這是我們第一次使用Azure Sphere,故而沒有權限訪問任何Azure Sphere 租戶,需要先進行創建:
執行如下命令:
azsphere tenant create --name <my-tenant>
將 <my-tenant> 替換爲其他用戶可識別的名稱,例如“Contoso Ltd”或“Contoso Dishwasher Division”。 如果名稱包含空格,請將其用引號括起來。 名稱必須全部是無符號的字母數字字符。
租戶創建完成後,執行如下命令,認領設備,認領成功後,無法再次將設備遷移至其他租戶。
azsphere device claim
五、配置設備通過WIFI聯網
使用如下命令進行wifi配置:
azsphere device wifi add --ssid <yourSSID> --psk <yourNetworkKey>
配置完成顯示state unknown 是正常現象,使用如下命令再次查詢網絡狀態:
azsphere device wifi show-status
使用如下命令,查看Azure Sphere 開發板的OS版本:
azsphere device show-deployment-status
本例中的20.01 是截至到2020.03月的最新版本,也是我們本文開始手動升級到的最新版本。
正常情況下,Azure Sphere 設備每次開機後,都會自動檢查更新,如果長時間爲關機,設備也會24小時檢查一次,如果有更新則會自動下載並安裝,此過程可能15-20分鐘,安裝完成後,設備可能會重啓。
六、啓用設備上的應用開發
執行如下命令,啓動設備上的應用開發
azsphere device enable-development
該過程會下載一些配置文件對開發板進行配置,然後在本機Windows系統上安裝調試服務。