開發(fā)工具嵌入式【免費下載鏈接】arduino-cliArduino command line tool項目地址https://gitcode.com/gh_mirrors/ar/arduino-cli點擊查看免費下載Arduino CLI 是 Arduino 官方出品的命令行一體化工具集 Boards/Library 管理器、Sketch 構(gòu)建器、板卡識別、程序上傳等功能于一身讓你能在命令行與機器接口中驅(qū)動任何 Arduino 兼容開發(fā)板。本文圍繞其官方文檔主線完整講解安裝方式、從建 Sketch 到燒錄的完整工作流、第三方核心接入方法并結(jié)合倉庫源碼深入解析其 gRPC 服務(wù)接口與 Prometheus 監(jiān)控能力讀完即可獨立完成從零到自動化開發(fā)的全流程。Arduino CLI 是什么根據(jù)官方文檔 docs/index.md 的定義Arduino CLI 是一個 all-in-one一體化解決方案它提供Boards Manager / Library Manager管理開發(fā)板核心與庫的安裝、升級、卸載Sketch 構(gòu)建器sketch builder將.ino源碼預(yù)處理、編譯為固件板卡檢測board detection識別當前連接到 PC 的開發(fā)板上傳器uploader將編譯產(chǎn)物燒錄到板卡以及其他眾多在命令行或機器接口下使用 Arduino 兼容板與平臺所需的工具。更關(guān)鍵的是它不僅是獨立工具還是所有官方 Arduino 開發(fā)軟件Arduino IDE、Arduino Web Editor的核心引擎——文檔明確指出本文檔中的大部分內(nèi)容同樣適用于這些上層工具。這意味著你學(xué)會的命令、配置與接口語義在 IDE 與 Web Editor 內(nèi)部同樣成立。從倉庫結(jié)構(gòu)看這一地位有清晰的代碼支撐程序入口 main.go 組裝了commands包對外提供 gRPC 服務(wù)的業(yè)務(wù)實現(xiàn)與 internal/cli命令行交互層命令層的每個動作最終都落到同一套服務(wù)實現(xiàn)上從而保證 CLI 與 gRPC 接口行為一致。安裝 Arduino CLI官方安裝文檔 docs/installation.md 提供了多種安裝途徑可按環(huán)境任選其一。方式一HomebrewmacOS / Linux自版本0.5.0起Arduino CLI 已作為 Homebrew 官方 formula 提供brew update brew install arduino-cliHomebrew 安裝包中已內(nèi)置命令行補全文件安裝后即可直接使用。方式二官方安裝腳本倉庫根目錄提供了 install.sh 安裝腳本它僅依賴shLinux 與 macOS 原生自帶Windows 用戶需要 Git Bash 環(huán)境。腳本默認將最新版安裝到當前目錄的bin/子目錄curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh可通過環(huán)境變量BINDIR指定安裝目錄例如安裝到~/local/bincurl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR~/local/bin sh如果希望在任何位置直接調(diào)用arduino-cli命令請將安裝路徑加入PATH環(huán)境變量。安裝特定版本例如0.9.0或nightly-latest時將版本號作為參數(shù)傳入curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh -s 0.9.0需要注意Arduino CLI 每 24 小時會檢查一次新版本發(fā)布若不需要該行為可通過配置文件中的updater.enable_notification配置項或環(huán)境變量ARDUINO_UPDATER_ENABLE_NOTIFICATIONfalse關(guān)閉詳見 docs/configuration.md。方式三下載預(yù)編譯二進制官方為所有主流平臺提供預(yù)編譯二進制包包括 Linux32/64 位、Linux ARM32/64 位、Linux ARMv6、Windowsexe 與 msi 安裝包以及 macOSIntel 與 Apple Silicon。下載后解壓將arduino-cli可執(zhí)行文件放入PATH中的任意目錄即可使用。此外還有每日構(gòu)建nightly builds每天 01:00 GMT 從master分支自動生成僅用于體驗最新功能不應(yīng)在生產(chǎn)環(huán)境使用官方還同步提供校驗和文件用于驗證完整性。方式四從源碼構(gòu)建如果你熟悉 Go 語言或希望參與貢獻可以直接用 Go 工具鏈在本地構(gòu)建具體步驟參見 docs/CONTRIBUTING.md 中的構(gòu)建指引?？焖偕鲜謴牧銊?chuàng)建并燒錄第一個程序本節(jié)完整還原官方 docs/getting-started.md 的實戰(zhàn)流程并補充命令細節(jié)。1. 熟悉命令體系arduino-cli是命令的容器每個子命令都有專屬幫助文本$ arduino-cli help core Arduino core operations. Usage: arduino-cli core [command] Examples: arduino-cli core update-index Available Commands: download Downloads one or more cores and corresponding tool dependencies. install Installs one or more cores and corresponding tool dependencies. list Shows the list of installed platforms. search Search for a core in Boards Manager. uninstall Uninstalls one or more cores and corresponding tool dependencies if no longer used. update-index Updates the index of cores. upgrade Upgrades one or all installed platforms to the latest version. Flags: -h, --help help for core Global Flags: --additional-urls strings Comma-separated list of additional URLs for the Boards Manager. --config-file string The custom config file (if not specified the default will be used). --json Print the output in JSON format. --log Print the logs on the standard output. --log-file string Path to the file where logs will be written. --log-format string The output format for the logs, can be: text, json --log-level string Messages with this level and above will be logged. Valid levels are: trace, debug, info, warn, error, fatal, panic --no-color Disable colored output.全局選項--json、--log-level、--no-color等對所有子命令通用是腳本化集成的關(guān)鍵。2. 生成配置文件CLI 不強制要求配置文件但創(chuàng)建一份能省去大量重復(fù)輸入。執(zhí)行$ arduino-cli config init Config file written: /home/luca/.arduino15/arduino-cli.yaml生成的arduino-cli.yaml中列出了所有可用配置項及默認值完整參數(shù)說明見 docs/configuration.md。3. 創(chuàng)建新 Sketch在任意目錄創(chuàng)建名為MyFirstSketch的 Sketch$ arduino-cli sketch new MyFirstSketch Sketch created in: /home/luca/MyFirstSketchSketch 本質(zhì)是一個文件夾包含源碼與資源。new命令會生成帶 Arduino 樣板代碼的MyFirstSketch.ino$ cat $HOME/MyFirstSketch/MyFirstSketch.ino void setup() { } void loop() { }將其修改為經(jīng)典的點亮板載 LED 程序void setup() { pinMode(LED_BUILTIN, OUTPUT); } void loop() { digitalWrite(LED_BUILTIN, HIGH); delay(1000); digitalWrite(LED_BUILTIN, LOW); delay(1000); }4. 連接板卡并識別新環(huán)境第一步是更新本地平臺與庫索引緩存$ arduino-cli core update-index Updating index: package_index.json downloaded用 USB 線連接開發(fā)板后檢查板卡是否被識別$ arduino-cli board list Port Type Board Name FQBN Core /dev/ttyACM1 Serial Port (USB) Arduino/Genuino MKR1000 arduino:samd:mkr1000 arduino:samd輸出中的arduino:samd就是該板卡對應(yīng)的平臺核心core。如果顯示為Unknown板卡只要確定平臺核心并使用正確的 FQBN 字符串上傳依然可以工作。板卡未被識別時可用board listall加關(guān)鍵字檢索所有支持板卡及其 FQBN$ arduino-cli board listall mkr Board Name FQBN Arduino MKR FOX 1200 arduino:samd:mkrfox1200 Arduino MKR GSM 1400 arduino:samd:mkrgsm1400 Arduino MKR WAN 1300 arduino:samd:mkrwan1300 Arduino MKR WiFi 1010 arduino:samd:mkrwifi1010 Arduino MKRZERO arduino:samd:mkrzero Arduino/Genuino MKR1000 arduino:samd:mkr10005. 安裝平臺核心安裝arduino:samd核心會同步下載工具鏈依賴如 arm-none-eabi-gcc、bossac、openocd、CMSIS 等$ arduino-cli core install arduino:samd Downloading tools... arduino:arm-none-eabi-gcc4.8.3-2014q1 downloaded arduino:bossac1.7.0 downloaded arduino:openocd0.9.0-arduino6-static downloaded arduino:CMSIS4.5.0 downloaded arduino:CMSIS-Atmel1.1.0 downloaded arduino:arduinoOTA1.2.0 downloaded Downloading cores... arduino:samd1.6.19 downloaded Installing tools... Installing platforms... Results: arduino:samd1.6.19 - Installed arduino:arm-none-eabi-gcc4.8.3-2014q1 - Installed arduino:bossac1.7.0 - Installed arduino:openocd0.9.0-arduino6-static - Installed arduino:CMSIS4.5.0 - Installed arduino:CMSIS-Atmel1.1.0 - Installed arduino:arduinoOTA1.2.0 - Installed驗證安裝結(jié)果$ arduino-cli core list ID Installed Latest Name arduino:samd 1.6.19 1.6.19 Arduino SAMD Boards (32-bits ARM Cortex-M0)6. 編譯與上傳編譯時通過--fqbn指定目標板卡$ arduino-cli compile --fqbn arduino:samd:mkr1000 MyFirstSketch Sketch uses 9600 bytes (3%) of program storage space. Maximum is 262144 bytes.上傳時用-p指定串口對應(yīng)board list顯示的端口$ arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:samd:mkr1000 MyFirstSketch No new serial port detected. Atmel SMART device 0x10010005 found Device : ATSAMD21G18A ... Erase flash done in 0.784 seconds Write 9856 bytes to flash (154 pages) [] 100% (154/154 pages) done in 0.069 seconds Verify 9856 bytes of flash with checksum. Verify successful done in 0.009 seconds CPU reset.編譯與上傳的內(nèi)部實現(xiàn)可分別在 internal/arduino/builderSketch 預(yù)處理與編譯流水線與 commands/service_upload.go 中找到對應(yīng)實現(xiàn)。7. 安裝庫需要為 Sketch 增加功能時先用lib search檢索 Arduino 生態(tài)中的庫例如搜索按鍵去抖相關(guān)的debouncer關(guān)鍵字會返回Debouncer、FTDebouncer、SoftTimer等候選庫及其作者、類別、架構(gòu)支持與版本列表。然后安裝選中的庫$ arduino-cli lib install FTDebouncer FTDebouncer depends on FTDebouncer1.3.0 Downloading FTDebouncer1.3.0... FTDebouncer1.3.0 downloaded Installing FTDebouncer1.3.0... Installed FTDebouncer1.3.0庫的安裝、依賴解析與索引管理實現(xiàn)位于 internal/arduino/libraries/librariesmanager 與 internal/arduino/libraries/librariesindex。接入第三方核心擴展 Boards Manager如果你的開發(fā)板需要第三方核心包如 ESP8266可在配置文件的board_manager段中列出額外的包索引 URLboard_manager: additional_urls: - https://arduino.esp8266.com/stable/package_esp8266com_index.json本地已有的包索引文件也可通過file://協(xié)議加入例如 NRF52832 核心board_manager: additional_urls: - https://arduino.esp8266.com/stable/package_esp8266com_index.json - file:///absolute/path/to/your/package_nrf52832_index.json配置后支持自定義核心的命令會自動使用這些附加 URL$ arduino-cli core update-index Updating index: package_index.json downloaded Updating index: package_esp8266com_index.json downloaded Updating index: package_nrf52832_index.json Updating index: package_index.json downloaded $ arduino-cli core search esp8266 ID Version Name esp8266:esp8266 2.5.2 esp8266也可以不寫配置文件每次命令通過--additional-urls全局選項臨時指定URL 與file://路徑均可$ arduino-cli core update-index --additional-urls https://arduino.esp8266.com/stable/package_esp8266com_index.json $ arduino-cli core search esp8266 --additional-urls file:///absolute/path/to/your/package_esp8266com_index.json通過 gRPC 接口編程驅(qū)動 Arduino CLIArduino CLI 可通過daemon命令以 gRPC 服務(wù)器模式運行將全部能力暴露為可編程服務(wù)。倉庫中的 rpc/internal/client_example 目錄提供了一份完整的示例客戶端Go 語言實現(xiàn)入口為 main.go演示了與 gRPC 服務(wù)交互的完整工作流。啟動 daemon 與建立連接示例客戶端通過grpc.NewClient(localhost:50051, ...)連接默認端口50051的 gRPC 服務(wù)對應(yīng) main.go服務(wù)端由arduino-cli daemon啟動。為避免污染現(xiàn)有安裝示例將數(shù)據(jù)目錄cores、libraries 等指向臨時目錄并通過SettingsSetValue動態(tài)配置三個關(guān)鍵路徑main.gocallSetValue(client, directories.data, dataDir) callSetValue(client, directories.downloads, path.Join(dataDir, staging)) callSetValue(client, directories.user, path.Join(dataDir, sketchbook))SettingsSetValue與SettingsGetValue對應(yīng)命令行config set/get可對任意配置鍵讀寫值以 JSON 編碼傳入ConfigurationSave則將全部配置以指定格式如 JSON導(dǎo)出main.go。實例生命周期Create → InitgRPC 接口的核心抽象是Instance實例在調(diào)用任何業(yè)務(wù)方法前必須先創(chuàng)建并初始化實例main.goinstance : createInstance(client) // client.Create() initInstance(client, instance) // client.Init()流式返回下載/任務(wù)進度Init是一個服務(wù)端流接口客戶端通過stream.Recv()持續(xù)讀取DownloadProgress索引下載進度與TaskProgress任務(wù)進度直到收到io.EOF。索引更新后不會被隱式感知必須再次顯式Init才能讓新索引生效——示例在每次UpdateIndex后都重復(fù)了這一步驟。平臺Core管理示例依次演示了平臺管理的完整閉環(huán)main.goPlatformSearch(samd)搜索平臺PlatformInstall(arduino, samd, 1.6.19)按包名 架構(gòu) 版本精確安裝PlatformUpgrade(arduino, samd)升級到最新版PlatformUninstall(arduino, samd)卸載。這些方法對應(yīng)命令行的core search / install / upgrade / uninstall其服務(wù)端實現(xiàn)在 commands 目錄的service_platform_*.go系列文件中。所有流式方法都遵循同一消費模式循環(huán)Recv()io.EOF表示完成中途通過Progress/TaskProgress上報進度。板卡查詢與編譯上傳示例還演示了板卡相關(guān)操作main.goBoardDetails(arduino:samd:mkr1000)查詢板卡詳情名稱、工具依賴、配置選項BoardSearch()全量列出板卡BoardListAll(mkr)帶關(guān)鍵字過濾的板卡列表BoardList()列出已連接板卡BoardListWatch()訂閱板卡插拔事件服務(wù)端流示例持續(xù)監(jiān)聽 10 秒。編譯通過Compile方法發(fā)起請求中攜帶Instance、Fqbn與SketchPath響應(yīng)流中的OutStream/ErrStream分別對應(yīng)編譯器標準輸出與錯誤輸出main.go。上傳則調(diào)用Upload請求中除 FQBN 與 Sketch 路徑外還需Port地址如/dev/ttyACM0、協(xié)議serialmain.go。示例中上傳與調(diào)試Debug基于 GDB 的交互式調(diào)試會話默認被注釋連接真實板卡后可取消注釋運行。庫管理示例后半部分演示了完整的庫生命周期main.goUpdateLibrariesIndex更新庫索引LibraryDownload(WiFi1010.15.2)/LibraryInstall下載與安裝指定版本LibraryInstall支持NoDeps標志跳過依賴安裝LibraryUpgradeAll升級全部庫LibrarySearch(audio)關(guān)鍵字搜索LibraryResolveDependencies(ArduinoIoTCloud)列出依賴及所需版本、已安裝版本LibraryList/LibraryUninstall列出與卸載。gRPC 服務(wù)定義與實現(xiàn)所有 gRPC 服務(wù)的消息與接口定義集中在 rpc/cc/arduino/cli含.proto定義與生成的 Go 代碼業(yè)務(wù)實現(xiàn)位于 commands 目錄的service_*.go文件如service_compile.go、service_upload.go、service_library_install.go命令行子命令internal/cli與 gRPC 服務(wù)最終共享同一套業(yè)務(wù)邏輯。這一架構(gòu)使得你可以用任意支持 gRPC 的語言不限于 Go構(gòu)建自己的 IDE、CI 流水線或物聯(lián)網(wǎng)設(shè)備管理平臺。用 Prometheus 指標監(jiān)控 daemon 服務(wù)除日志外daemon模式默認啟用并暴露一個 Prometheus 指標端點默認地址http://localhost:9090/metrics可直接抓取服務(wù)活動數(shù)據(jù)例如# TYPE daemon_compile counter daemon_compile{buildProperties,exportFile,fqbnarduino:samd:mkr1000,installationIDed6f1f22-1fbe-4b1f-84be-84d035b6369c,jobs0,libraries,preprocessfalse,quietfalse,showPropertiesfalse,sketchPath5ff767c6fa5a91230f5cb4e267c889aa61489ab2c4f70f35f921f934c1462cb6,successtrue,verbosetrue,vidPid,warnings} 1 1580385724726 # TYPE daemon_board_list counter daemon_board_list{installationIDed6f1f22-1fbe-4b1f-84be-84d035b6369c,successtrue} 1 1580385724833可見每個 RPC 方法都有獨立的計數(shù)器指標如daemon_compile、daemon_board_list并攜帶方法級標簽FQBN、Sketch 路徑哈希、成功狀態(tài)、installationID 等。指標設(shè)置通過配置文件的metrics段控制metrics: enabled: true addr: :9090作為官方生態(tài)的引擎與 IDE / Web Editor 的關(guān)系再次強調(diào) index 文檔中的定位Arduino CLI 是所有官方 Arduino 開發(fā)軟件Arduino IDE、Arduino Web Editor的心臟。上層工具共享其核心能力——如果你打算開發(fā)自己的 IDE、CI 集成或云端編譯平臺rpc/internal/client_example 中的示例客戶端是絕佳的起點若要深入了解命令行為與配置項可繼續(xù)閱讀 docs/getting-started.md、docs/configuration.md 以及 docs/FAQ.mdgRPC 服務(wù)消息與字段的完整定義可直接查閱 rpc/cc/arduino/cli 中的.proto文件官方所有文檔頁面均由 docs 目錄統(tǒng)一維護。贊分享開發(fā)工具嵌入式【免費下載鏈接】arduino-cliArduino command line tool項目地址https://gitcode.com/gh_mirrors/ar/arduino-cli點擊查看免費下載相關(guān)推薦WinUtil終極指南一鍵搞定Windows系統(tǒng)優(yōu)化與軟件管理的免費專業(yè)工具WinUtil終極指南一鍵搞定Windows系統(tǒng)優(yōu)化與軟件管理的免費專業(yè)工具 想要快速優(yōu)化Windows系統(tǒng)、批量安裝軟件、修復(fù)常見問題嗎WinUtil就是桌面應(yīng)用運維5 分鐘把機器學(xué)習(xí)模型裝進容器Cog CLI 從構(gòu)建到部署實戰(zhàn)指南5 分鐘把機器學(xué)習(xí)模型裝進容器Cog CLI 從構(gòu)建到部署實戰(zhàn)指南 Cog 是 Replicate 開源的機器學(xué)習(xí)容器化工具口號是 ContainersMLOps容器模型推理服務(wù)開發(fā)工具SVG-Morpheus創(chuàng)意應(yīng)用7個驚艷案例展示圖標變形藝術(shù)SVG Morpheus創(chuàng)意應(yīng)用7個驚艷案例展示圖標變形藝術(shù) SVG Morpheus是一款創(chuàng)新的JavaScript庫專為SVG圖標變形動畫設(shè)計完美實現(xiàn)前端上一篇Fleet 基于 mock APNs 的 Apple MDM 負載測試1 小時運行指標深度解讀下一篇Bash-it update 與 migrate 命令完全指南升級、遷移與自動維護創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Arduino CLI 完全指南：安裝部署、核心命令與 gRPC 編程接口
開發(fā)工具嵌入式【免費下載鏈接】arduino-cliArduino command line tool項目地址https://gitcode.com/gh_mirrors/ar/arduino-cli點擊查看免費下載Arduino CLI 是 Arduino 官方出品的命令行一體化工具集 Boards/Library 管理器、Sketch 構(gòu)建器、板卡識別、程序上傳等功能于一身讓你能在命令行與機器接口中驅(qū)動任何 Arduino 兼容開發(fā)板。本文圍繞其官方文檔主線完整講解安裝方式、從建 Sketch 到燒錄的完整工作流、第三方核心接入方法并結(jié)合倉庫源碼深入解析其 gRPC 服務(wù)接口與 Prometheus 監(jiān)控能力讀完即可獨立完成從零到自動化開發(fā)的全流程。Arduino CLI 是什么根據(jù)官方文檔 docs/index.md 的定義Arduino CLI 是一個 all-in-one一體化解決方案它提供Boards Manager / Library Manager管理開發(fā)板核心與庫的安裝、升級、卸載Sketch 構(gòu)建器sketch builder將.ino源碼預(yù)處理、編譯為固件板卡檢測board detection識別當前連接到 PC 的開發(fā)板上傳器uploader將編譯產(chǎn)物燒錄到板卡以及其他眾多在命令行或機器接口下使用 Arduino 兼容板與平臺所需的工具。更關(guān)鍵的是它不僅是獨立工具還是所有官方 Arduino 開發(fā)軟件Arduino IDE、Arduino Web Editor的核心引擎——文檔明確指出本文檔中的大部分內(nèi)容同樣適用于這些上層工具。這意味著你學(xué)會的命令、配置與接口語義在 IDE 與 Web Editor 內(nèi)部同樣成立。從倉庫結(jié)構(gòu)看這一地位有清晰的代碼支撐程序入口 main.go 組裝了commands包對外提供 gRPC 服務(wù)的業(yè)務(wù)實現(xiàn)與 internal/cli命令行交互層命令層的每個動作最終都落到同一套服務(wù)實現(xiàn)上從而保證 CLI 與 gRPC 接口行為一致。安裝 Arduino CLI官方安裝文檔 docs/installation.md 提供了多種安裝途徑可按環(huán)境任選其一。方式一HomebrewmacOS / Linux自版本0.5.0起Arduino CLI 已作為 Homebrew 官方 formula 提供brew update brew install arduino-cliHomebrew 安裝包中已內(nèi)置命令行補全文件安裝后即可直接使用。方式二官方安裝腳本倉庫根目錄提供了 install.sh 安裝腳本它僅依賴shLinux 與 macOS 原生自帶Windows 用戶需要 Git Bash 環(huán)境。腳本默認將最新版安裝到當前目錄的bin/子目錄curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh可通過環(huán)境變量BINDIR指定安裝目錄例如安裝到~/local/bincurl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR~/local/bin sh如果希望在任何位置直接調(diào)用arduino-cli命令請將安裝路徑加入PATH環(huán)境變量。安裝特定版本例如0.9.0或nightly-latest時將版本號作為參數(shù)傳入curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh -s 0.9.0需要注意Arduino CLI 每 24 小時會檢查一次新版本發(fā)布若不需要該行為可通過配置文件中的updater.enable_notification配置項或環(huán)境變量ARDUINO_UPDATER_ENABLE_NOTIFICATIONfalse關(guān)閉詳見 docs/configuration.md。方式三下載預(yù)編譯二進制官方為所有主流平臺提供預(yù)編譯二進制包包括 Linux32/64 位、Linux ARM32/64 位、Linux ARMv6、Windowsexe 與 msi 安裝包以及 macOSIntel 與 Apple Silicon。下載后解壓將arduino-cli可執(zhí)行文件放入PATH中的任意目錄即可使用。此外還有每日構(gòu)建nightly builds每天 01:00 GMT 從master分支自動生成僅用于體驗最新功能不應(yīng)在生產(chǎn)環(huán)境使用官方還同步提供校驗和文件用于驗證完整性。方式四從源碼構(gòu)建如果你熟悉 Go 語言或希望參與貢獻可以直接用 Go 工具鏈在本地構(gòu)建具體步驟參見 docs/CONTRIBUTING.md 中的構(gòu)建指引?？焖偕鲜謴牧銊?chuàng)建并燒錄第一個程序本節(jié)完整還原官方 docs/getting-started.md 的實戰(zhàn)流程并補充命令細節(jié)。1. 熟悉命令體系arduino-cli是命令的容器每個子命令都有專屬幫助文本$ arduino-cli help core Arduino core operations. Usage: arduino-cli core [command] Examples: arduino-cli core update-index Available Commands: download Downloads one or more cores and corresponding tool dependencies. install Installs one or more cores and corresponding tool dependencies. list Shows the list of installed platforms. search Search for a core in Boards Manager. uninstall Uninstalls one or more cores and corresponding tool dependencies if no longer used. update-index Updates the index of cores. upgrade Upgrades one or all installed platforms to the latest version. Flags: -h, --help help for core Global Flags: --additional-urls strings Comma-separated list of additional URLs for the Boards Manager. --config-file string The custom config file (if not specified the default will be used). --json Print the output in JSON format. --log Print the logs on the standard output. --log-file string Path to the file where logs will be written. --log-format string The output format for the logs, can be: text, json --log-level string Messages with this level and above will be logged. Valid levels are: trace, debug, info, warn, error, fatal, panic --no-color Disable colored output.全局選項--json、--log-level、--no-color等對所有子命令通用是腳本化集成的關(guān)鍵。2. 生成配置文件CLI 不強制要求配置文件但創(chuàng)建一份能省去大量重復(fù)輸入。執(zhí)行$ arduino-cli config init Config file written: /home/luca/.arduino15/arduino-cli.yaml生成的arduino-cli.yaml中列出了所有可用配置項及默認值完整參數(shù)說明見 docs/configuration.md。3. 創(chuàng)建新 Sketch在任意目錄創(chuàng)建名為MyFirstSketch的 Sketch$ arduino-cli sketch new MyFirstSketch Sketch created in: /home/luca/MyFirstSketchSketch 本質(zhì)是一個文件夾包含源碼與資源。new命令會生成帶 Arduino 樣板代碼的MyFirstSketch.ino$ cat $HOME/MyFirstSketch/MyFirstSketch.ino void setup() { } void loop() { }將其修改為經(jīng)典的點亮板載 LED 程序void setup() { pinMode(LED_BUILTIN, OUTPUT); } void loop() { digitalWrite(LED_BUILTIN, HIGH); delay(1000); digitalWrite(LED_BUILTIN, LOW); delay(1000); }4. 連接板卡并識別新環(huán)境第一步是更新本地平臺與庫索引緩存$ arduino-cli core update-index Updating index: package_index.json downloaded用 USB 線連接開發(fā)板后檢查板卡是否被識別$ arduino-cli board list Port Type Board Name FQBN Core /dev/ttyACM1 Serial Port (USB) Arduino/Genuino MKR1000 arduino:samd:mkr1000 arduino:samd輸出中的arduino:samd就是該板卡對應(yīng)的平臺核心core。如果顯示為Unknown板卡只要確定平臺核心并使用正確的 FQBN 字符串上傳依然可以工作。板卡未被識別時可用board listall加關(guān)鍵字檢索所有支持板卡及其 FQBN$ arduino-cli board listall mkr Board Name FQBN Arduino MKR FOX 1200 arduino:samd:mkrfox1200 Arduino MKR GSM 1400 arduino:samd:mkrgsm1400 Arduino MKR WAN 1300 arduino:samd:mkrwan1300 Arduino MKR WiFi 1010 arduino:samd:mkrwifi1010 Arduino MKRZERO arduino:samd:mkrzero Arduino/Genuino MKR1000 arduino:samd:mkr10005. 安裝平臺核心安裝arduino:samd核心會同步下載工具鏈依賴如 arm-none-eabi-gcc、bossac、openocd、CMSIS 等$ arduino-cli core install arduino:samd Downloading tools... arduino:arm-none-eabi-gcc4.8.3-2014q1 downloaded arduino:bossac1.7.0 downloaded arduino:openocd0.9.0-arduino6-static downloaded arduino:CMSIS4.5.0 downloaded arduino:CMSIS-Atmel1.1.0 downloaded arduino:arduinoOTA1.2.0 downloaded Downloading cores... arduino:samd1.6.19 downloaded Installing tools... Installing platforms... Results: arduino:samd1.6.19 - Installed arduino:arm-none-eabi-gcc4.8.3-2014q1 - Installed arduino:bossac1.7.0 - Installed arduino:openocd0.9.0-arduino6-static - Installed arduino:CMSIS4.5.0 - Installed arduino:CMSIS-Atmel1.1.0 - Installed arduino:arduinoOTA1.2.0 - Installed驗證安裝結(jié)果$ arduino-cli core list ID Installed Latest Name arduino:samd 1.6.19 1.6.19 Arduino SAMD Boards (32-bits ARM Cortex-M0)6. 編譯與上傳編譯時通過--fqbn指定目標板卡$ arduino-cli compile --fqbn arduino:samd:mkr1000 MyFirstSketch Sketch uses 9600 bytes (3%) of program storage space. Maximum is 262144 bytes.上傳時用-p指定串口對應(yīng)board list顯示的端口$ arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:samd:mkr1000 MyFirstSketch No new serial port detected. Atmel SMART device 0x10010005 found Device : ATSAMD21G18A ... Erase flash done in 0.784 seconds Write 9856 bytes to flash (154 pages) [] 100% (154/154 pages) done in 0.069 seconds Verify 9856 bytes of flash with checksum. Verify successful done in 0.009 seconds CPU reset.編譯與上傳的內(nèi)部實現(xiàn)可分別在 internal/arduino/builderSketch 預(yù)處理與編譯流水線與 commands/service_upload.go 中找到對應(yīng)實現(xiàn)。7. 安裝庫需要為 Sketch 增加功能時先用lib search檢索 Arduino 生態(tài)中的庫例如搜索按鍵去抖相關(guān)的debouncer關(guān)鍵字會返回Debouncer、FTDebouncer、SoftTimer等候選庫及其作者、類別、架構(gòu)支持與版本列表。然后安裝選中的庫$ arduino-cli lib install FTDebouncer FTDebouncer depends on FTDebouncer1.3.0 Downloading FTDebouncer1.3.0... FTDebouncer1.3.0 downloaded Installing FTDebouncer1.3.0... Installed FTDebouncer1.3.0庫的安裝、依賴解析與索引管理實現(xiàn)位于 internal/arduino/libraries/librariesmanager 與 internal/arduino/libraries/librariesindex。接入第三方核心擴展 Boards Manager如果你的開發(fā)板需要第三方核心包如 ESP8266可在配置文件的board_manager段中列出額外的包索引 URLboard_manager: additional_urls: - https://arduino.esp8266.com/stable/package_esp8266com_index.json本地已有的包索引文件也可通過file://協(xié)議加入例如 NRF52832 核心board_manager: additional_urls: - https://arduino.esp8266.com/stable/package_esp8266com_index.json - file:///absolute/path/to/your/package_nrf52832_index.json配置后支持自定義核心的命令會自動使用這些附加 URL$ arduino-cli core update-index Updating index: package_index.json downloaded Updating index: package_esp8266com_index.json downloaded Updating index: package_nrf52832_index.json Updating index: package_index.json downloaded $ arduino-cli core search esp8266 ID Version Name esp8266:esp8266 2.5.2 esp8266也可以不寫配置文件每次命令通過--additional-urls全局選項臨時指定URL 與file://路徑均可$ arduino-cli core update-index --additional-urls https://arduino.esp8266.com/stable/package_esp8266com_index.json $ arduino-cli core search esp8266 --additional-urls file:///absolute/path/to/your/package_esp8266com_index.json通過 gRPC 接口編程驅(qū)動 Arduino CLIArduino CLI 可通過daemon命令以 gRPC 服務(wù)器模式運行將全部能力暴露為可編程服務(wù)。倉庫中的 rpc/internal/client_example 目錄提供了一份完整的示例客戶端Go 語言實現(xiàn)入口為 main.go演示了與 gRPC 服務(wù)交互的完整工作流。啟動 daemon 與建立連接示例客戶端通過grpc.NewClient(localhost:50051, ...)連接默認端口50051的 gRPC 服務(wù)對應(yīng) main.go服務(wù)端由arduino-cli daemon啟動。為避免污染現(xiàn)有安裝示例將數(shù)據(jù)目錄cores、libraries 等指向臨時目錄并通過SettingsSetValue動態(tài)配置三個關(guān)鍵路徑main.gocallSetValue(client, directories.data, dataDir) callSetValue(client, directories.downloads, path.Join(dataDir, staging)) callSetValue(client, directories.user, path.Join(dataDir, sketchbook))SettingsSetValue與SettingsGetValue對應(yīng)命令行config set/get可對任意配置鍵讀寫值以 JSON 編碼傳入ConfigurationSave則將全部配置以指定格式如 JSON導(dǎo)出main.go。實例生命周期Create → InitgRPC 接口的核心抽象是Instance實例在調(diào)用任何業(yè)務(wù)方法前必須先創(chuàng)建并初始化實例main.goinstance : createInstance(client) // client.Create() initInstance(client, instance) // client.Init()流式返回下載/任務(wù)進度Init是一個服務(wù)端流接口客戶端通過stream.Recv()持續(xù)讀取DownloadProgress索引下載進度與TaskProgress任務(wù)進度直到收到io.EOF。索引更新后不會被隱式感知必須再次顯式Init才能讓新索引生效——示例在每次UpdateIndex后都重復(fù)了這一步驟。平臺Core管理示例依次演示了平臺管理的完整閉環(huán)main.goPlatformSearch(samd)搜索平臺PlatformInstall(arduino, samd, 1.6.19)按包名 架構(gòu) 版本精確安裝PlatformUpgrade(arduino, samd)升級到最新版PlatformUninstall(arduino, samd)卸載。這些方法對應(yīng)命令行的core search / install / upgrade / uninstall其服務(wù)端實現(xiàn)在 commands 目錄的service_platform_*.go系列文件中。所有流式方法都遵循同一消費模式循環(huán)Recv()io.EOF表示完成中途通過Progress/TaskProgress上報進度。板卡查詢與編譯上傳示例還演示了板卡相關(guān)操作main.goBoardDetails(arduino:samd:mkr1000)查詢板卡詳情名稱、工具依賴、配置選項BoardSearch()全量列出板卡BoardListAll(mkr)帶關(guān)鍵字過濾的板卡列表BoardList()列出已連接板卡BoardListWatch()訂閱板卡插拔事件服務(wù)端流示例持續(xù)監(jiān)聽 10 秒。編譯通過Compile方法發(fā)起請求中攜帶Instance、Fqbn與SketchPath響應(yīng)流中的OutStream/ErrStream分別對應(yīng)編譯器標準輸出與錯誤輸出main.go。上傳則調(diào)用Upload請求中除 FQBN 與 Sketch 路徑外還需Port地址如/dev/ttyACM0、協(xié)議serialmain.go。示例中上傳與調(diào)試Debug基于 GDB 的交互式調(diào)試會話默認被注釋連接真實板卡后可取消注釋運行。庫管理示例后半部分演示了完整的庫生命周期main.goUpdateLibrariesIndex更新庫索引LibraryDownload(WiFi1010.15.2)/LibraryInstall下載與安裝指定版本LibraryInstall支持NoDeps標志跳過依賴安裝LibraryUpgradeAll升級全部庫LibrarySearch(audio)關(guān)鍵字搜索LibraryResolveDependencies(ArduinoIoTCloud)列出依賴及所需版本、已安裝版本LibraryList/LibraryUninstall列出與卸載。gRPC 服務(wù)定義與實現(xiàn)所有 gRPC 服務(wù)的消息與接口定義集中在 rpc/cc/arduino/cli含.proto定義與生成的 Go 代碼業(yè)務(wù)實現(xiàn)位于 commands 目錄的service_*.go文件如service_compile.go、service_upload.go、service_library_install.go命令行子命令internal/cli與 gRPC 服務(wù)最終共享同一套業(yè)務(wù)邏輯。這一架構(gòu)使得你可以用任意支持 gRPC 的語言不限于 Go構(gòu)建自己的 IDE、CI 流水線或物聯(lián)網(wǎng)設(shè)備管理平臺。用 Prometheus 指標監(jiān)控 daemon 服務(wù)除日志外daemon模式默認啟用并暴露一個 Prometheus 指標端點默認地址http://localhost:9090/metrics可直接抓取服務(wù)活動數(shù)據(jù)例如# TYPE daemon_compile counter daemon_compile{buildProperties,exportFile,fqbnarduino:samd:mkr1000,installationIDed6f1f22-1fbe-4b1f-84be-84d035b6369c,jobs0,libraries,preprocessfalse,quietfalse,showPropertiesfalse,sketchPath5ff767c6fa5a91230f5cb4e267c889aa61489ab2c4f70f35f921f934c1462cb6,successtrue,verbosetrue,vidPid,warnings} 1 1580385724726 # TYPE daemon_board_list counter daemon_board_list{installationIDed6f1f22-1fbe-4b1f-84be-84d035b6369c,successtrue} 1 1580385724833可見每個 RPC 方法都有獨立的計數(shù)器指標如daemon_compile、daemon_board_list并攜帶方法級標簽FQBN、Sketch 路徑哈希、成功狀態(tài)、installationID 等。指標設(shè)置通過配置文件的metrics段控制metrics: enabled: true addr: :9090作為官方生態(tài)的引擎與 IDE / Web Editor 的關(guān)系再次強調(diào) index 文檔中的定位Arduino CLI 是所有官方 Arduino 開發(fā)軟件Arduino IDE、Arduino Web Editor的心臟。上層工具共享其核心能力——如果你打算開發(fā)自己的 IDE、CI 集成或云端編譯平臺rpc/internal/client_example 中的示例客戶端是絕佳的起點若要深入了解命令行為與配置項可繼續(xù)閱讀 docs/getting-started.md、docs/configuration.md 以及 docs/FAQ.mdgRPC 服務(wù)消息與字段的完整定義可直接查閱 rpc/cc/arduino/cli 中的.proto文件官方所有文檔頁面均由 docs 目錄統(tǒng)一維護。贊分享開發(fā)工具嵌入式【免費下載鏈接】arduino-cliArduino command line tool項目地址https://gitcode.com/gh_mirrors/ar/arduino-cli點擊查看免費下載相關(guān)推薦WinUtil終極指南一鍵搞定Windows系統(tǒng)優(yōu)化與軟件管理的免費專業(yè)工具WinUtil終極指南一鍵搞定Windows系統(tǒng)優(yōu)化與軟件管理的免費專業(yè)工具 想要快速優(yōu)化Windows系統(tǒng)、批量安裝軟件、修復(fù)常見問題嗎WinUtil就是桌面應(yīng)用運維5 分鐘把機器學(xué)習(xí)模型裝進容器Cog CLI 從構(gòu)建到部署實戰(zhàn)指南5 分鐘把機器學(xué)習(xí)模型裝進容器Cog CLI 從構(gòu)建到部署實戰(zhàn)指南 Cog 是 Replicate 開源的機器學(xué)習(xí)容器化工具口號是 ContainersMLOps容器模型推理服務(wù)開發(fā)工具SVG-Morpheus創(chuàng)意應(yīng)用7個驚艷案例展示圖標變形藝術(shù)SVG Morpheus創(chuàng)意應(yīng)用7個驚艷案例展示圖標變形藝術(shù) SVG Morpheus是一款創(chuàng)新的JavaScript庫專為SVG圖標變形動畫設(shè)計完美實現(xiàn)前端上一篇Fleet 基于 mock APNs 的 Apple MDM 負載測試1 小時運行指標深度解讀下一篇Bash-it update 與 migrate 命令完全指南升級、遷移與自動維護創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考