開發(fā)工具嵌入式【免費(fèi)下載鏈接】arduino-cliArduino command line tool項(xiàng)目地址https://gitcode.com/gh_mirrors/ar/arduino-cli點(diǎn)擊查看免費(fèi)下載Arduino CLI 是 Arduino 官方出品的命令行一體化工具集 Boards/Library 管理器、Sketch 構(gòu)建器、板卡識別、程序上傳等功能于一身讓你能在命令行與機(jī)器接口中驅(qū)動(dòng)任何 Arduino 兼容開發(fā)板。本文圍繞其官方文檔主線完整講解安裝方式、從建 Sketch 到燒錄的完整工作流、第三方核心接入方法并結(jié)合倉庫源碼深入解析其 gRPC 服務(wù)接口與 Prometheus 監(jiān)控能力讀完即可獨(dú)立完成從零到自動(dòng)化開發(fā)的全流程。Arduino CLI 是什么根據(jù)官方文檔 docs/index.md 的定義Arduino CLI 是一個(gè) all-in-one一體化解決方案它提供Boards Manager / Library Manager管理開發(fā)板核心與庫的安裝、升級、卸載Sketch 構(gòu)建器sketch builder將.ino源碼預(yù)處理、編譯為固件板卡檢測board detection識別當(dāng)前連接到 PC 的開發(fā)板上傳器uploader將編譯產(chǎn)物燒錄到板卡以及其他眾多在命令行或機(jī)器接口下使用 Arduino 兼容板與平臺所需的工具。更關(guān)鍵的是它不僅是獨(dú)立工具還是所有官方 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ù)實(shí)現(xiàn)與 internal/cli命令行交互層命令層的每個(gè)動(dòng)作最終都落到同一套服務(wù)實(shí)現(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)置命令行補(bǔ)全文件安裝后即可直接使用。方式二官方安裝腳本倉庫根目錄提供了 install.sh 安裝腳本它僅依賴shLinux 與 macOS 原生自帶Windows 用戶需要 Git Bash 環(huán)境。腳本默認(rèn)將最新版安裝到當(dāng)前目錄的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í)將版本號作為參數(shù)傳入curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh -s 0.9.0需要注意Arduino CLI 每 24 小時(shí)會檢查一次新版本發(fā)布若不需要該行為可通過配置文件中的updater.enable_notification配置項(xiàng)或環(huán)境變量ARDUINO_UPDATER_ENABLE_NOTIFICATIONfalse關(guān)閉詳見 docs/configuration.md。方式三下載預(yù)編譯二進(jìn)制官方為所有主流平臺提供預(yù)編譯二進(jìn)制包包括 Linux32/64 位、Linux ARM32/64 位、Linux ARMv6、Windowsexe 與 msi 安裝包以及 macOSIntel 與 Apple Silicon。下載后解壓將arduino-cli可執(zhí)行文件放入PATH中的任意目錄即可使用。此外還有每日構(gòu)建nightly builds每天 01:00 GMT 從master分支自動(dòng)生成僅用于體驗(yàn)最新功能不應(yīng)在生產(chǎn)環(huán)境使用官方還同步提供校驗(yàn)和文件用于驗(yàn)證完整性。方式四從源碼構(gòu)建如果你熟悉 Go 語言或希望參與貢獻(xiàn)可以直接用 Go 工具鏈在本地構(gòu)建具體步驟參見 docs/CONTRIBUTING.md 中的構(gòu)建指引?？焖偕鲜謴牧銊?chuàng)建并燒錄第一個(gè)程序本節(jié)完整還原官方 docs/getting-started.md 的實(shí)戰(zhàn)流程并補(bǔ)充命令細(xì)節(jié)。1. 熟悉命令體系arduino-cli是命令的容器每個(gè)子命令都有專屬幫助文本$ 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.全局選項(xiàng)--json、--log-level、--no-color等對所有子命令通用是腳本化集成的關(guān)鍵。2. 生成配置文件CLI 不強(qiáng)制要求配置文件但創(chuàng)建一份能省去大量重復(fù)輸入。執(zhí)行$ arduino-cli config init Config file written: /home/luca/.arduino15/arduino-cli.yaml生成的arduino-cli.yaml中列出了所有可用配置項(xiàng)及默認(rèn)值完整參數(shù)說明見 docs/configuration.md。3. 創(chuàng)建新 Sketch在任意目錄創(chuàng)建名為MyFirstSketch的 Sketch$ arduino-cli sketch new MyFirstSketch Sketch created in: /home/luca/MyFirstSketchSketch 本質(zhì)是一個(gè)文件夾包含源碼與資源。new命令會生成帶 Arduino 樣板代碼的MyFirstSketch.ino$ cat $HOME/MyFirstSketch/MyFirstSketch.ino void setup() { } void loop() { }將其修改為經(jīng)典的點(diǎn)亮板載 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 字符串上傳依然可以工作。板卡未被識別時(shí)可用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驗(yàn)證安裝結(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. 編譯與上傳編譯時(shí)通過--fqbn指定目標(biāo)板卡$ arduino-cli compile --fqbn arduino:samd:mkr1000 MyFirstSketch Sketch uses 9600 bytes (3%) of program storage space. Maximum is 262144 bytes.上傳時(shí)用-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)部實(shí)現(xiàn)可分別在 internal/arduino/builderSketch 預(yù)處理與編譯流水線與 commands/service_upload.go 中找到對應(yīng)實(shí)現(xiàn)。7. 安裝庫需要為 Sketch 增加功能時(shí)先用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庫的安裝、依賴解析與索引管理實(shí)現(xiàn)位于 internal/arduino/libraries/librariesmanager 與 internal/arduino/libraries/librariesindex。接入第三方核心擴(kuò)展 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配置后支持自定義核心的命令會自動(dòng)使用這些附加 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全局選項(xiàng)臨時(shí)指定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ū)動(dòng) Arduino CLIArduino CLI 可通過daemon命令以 gRPC 服務(wù)器模式運(yùn)行將全部能力暴露為可編程服務(wù)。倉庫中的 rpc/internal/client_example 目錄提供了一份完整的示例客戶端Go 語言實(shí)現(xiàn)入口為 main.go演示了與 gRPC 服務(wù)交互的完整工作流。啟動(dòng) daemon 與建立連接示例客戶端通過grpc.NewClient(localhost:50051, ...)連接默認(rèn)端口50051的 gRPC 服務(wù)對應(yīng) main.go服務(wù)端由arduino-cli daemon啟動(dòng)。為避免污染現(xiàn)有安裝示例將數(shù)據(jù)目錄cores、libraries 等指向臨時(shí)目錄并通過SettingsSetValue動(dòng)態(tài)配置三個(gè)關(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。實(shí)例生命周期Create → InitgRPC 接口的核心抽象是Instance實(shí)例在調(diào)用任何業(yè)務(wù)方法前必須先創(chuàng)建并初始化實(shí)例main.goinstance : createInstance(client) // client.Create() initInstance(client, instance) // client.Init()流式返回下載/任務(wù)進(jìn)度Init是一個(gè)服務(wù)端流接口客戶端通過stream.Recv()持續(xù)讀取DownloadProgress索引下載進(jìn)度與TaskProgress任務(wù)進(jìn)度直到收到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ù)端實(shí)現(xiàn)在 commands 目錄的service_platform_*.go系列文件中。所有流式方法都遵循同一消費(fèi)模式循環(huán)Recv()io.EOF表示完成中途通過Progress/TaskProgress上報(bào)進(jìn)度。板卡查詢與編譯上傳示例還演示了板卡相關(guān)操作main.goBoardDetails(arduino:samd:mkr1000)查詢板卡詳情名稱、工具依賴、配置選項(xiàng)BoardSearch()全量列出板卡BoardListAll(mkr)帶關(guān)鍵字過濾的板卡列表BoardList()列出已連接板卡BoardListWatch()訂閱板卡插拔事件服務(wù)端流示例持續(xù)監(jiān)聽 10 秒。編譯通過Compile方法發(fā)起請求中攜帶Instance、Fqbn與SketchPath響應(yīng)流中的OutStream/ErrStream分別對應(yīng)編譯器標(biāo)準(zhǔn)輸出與錯(cuò)誤輸出main.go。上傳則調(diào)用Upload請求中除 FQBN 與 Sketch 路徑外還需Port地址如/dev/ttyACM0、協(xié)議serialmain.go。示例中上傳與調(diào)試Debug基于 GDB 的交互式調(diào)試會話默認(rèn)被注釋連接真實(shí)板卡后可取消注釋運(yùn)行。庫管理示例后半部分演示了完整的庫生命周期main.goUpdateLibrariesIndex更新庫索引LibraryDownload(WiFi1010.15.2)/LibraryInstall下載與安裝指定版本LibraryInstall支持NoDeps標(biāo)志跳過依賴安裝LibraryUpgradeAll升級全部庫LibrarySearch(audio)關(guān)鍵字搜索LibraryResolveDependencies(ArduinoIoTCloud)列出依賴及所需版本、已安裝版本LibraryList/LibraryUninstall列出與卸載。gRPC 服務(wù)定義與實(shí)現(xiàn)所有 gRPC 服務(wù)的消息與接口定義集中在 rpc/cc/arduino/cli含.proto定義與生成的 Go 代碼業(yè)務(wù)實(shí)現(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 指標(biāo)監(jiān)控 daemon 服務(wù)除日志外daemon模式默認(rèn)啟用并暴露一個(gè) Prometheus 指標(biāo)端點(diǎn)默認(rèn)地址http://localhost:9090/metrics可直接抓取服務(wù)活動(dòng)數(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可見每個(gè) RPC 方法都有獨(dú)立的計(jì)數(shù)器指標(biāo)如daemon_compile、daemon_board_list并攜帶方法級標(biāo)簽FQBN、Sketch 路徑哈希、成功狀態(tài)、installationID 等。指標(biāo)設(shè)置通過配置文件的metrics段控制metrics: enabled: true addr: :9090作為官方生態(tài)的引擎與 IDE / Web Editor 的關(guān)系再次強(qiáng)調(diào) index 文檔中的定位Arduino CLI 是所有官方 Arduino 開發(fā)軟件Arduino IDE、Arduino Web Editor的心臟。上層工具共享其核心能力——如果你打算開發(fā)自己的 IDE、CI 集成或云端編譯平臺rpc/internal/client_example 中的示例客戶端是絕佳的起點(diǎn)若要深入了解命令行為與配置項(xiàng)可繼續(xù)閱讀 docs/getting-started.md、docs/configuration.md 以及 docs/FAQ.mdgRPC 服務(wù)消息與字段的完整定義可直接查閱 rpc/cc/arduino/cli 中的.proto文件官方所有文檔頁面均由 docs 目錄統(tǒng)一維護(hù)。贊分享開發(fā)工具嵌入式【免費(fèi)下載鏈接】arduino-cliArduino command line tool項(xiàng)目地址https://gitcode.com/gh_mirrors/ar/arduino-cli點(diǎn)擊查看免費(fèi)下載相關(guān)推薦WinUtil終極指南一鍵搞定Windows系統(tǒng)優(yōu)化與軟件管理的免費(fèi)專業(yè)工具WinUtil終極指南一鍵搞定Windows系統(tǒng)優(yōu)化與軟件管理的免費(fèi)專業(yè)工具 想要快速優(yōu)化Windows系統(tǒng)、批量安裝軟件、修復(fù)常見問題嗎WinUtil就是桌面應(yīng)用運(yùn)維5 分鐘把機(jī)器學(xué)習(xí)模型裝進(jìn)容器Cog CLI 從構(gòu)建到部署實(shí)戰(zhàn)指南5 分鐘把機(jī)器學(xué)習(xí)模型裝進(jìn)容器Cog CLI 從構(gòu)建到部署實(shí)戰(zhàn)指南 Cog 是 Replicate 開源的機(jī)器學(xué)習(xí)容器化工具口號是 ContainersMLOps容器模型推理服務(wù)開發(fā)工具SVG-Morpheus創(chuàng)意應(yīng)用7個(gè)驚艷案例展示圖標(biāo)變形藝術(shù)SVG Morpheus創(chuàng)意應(yīng)用7個(gè)驚艷案例展示圖標(biāo)變形藝術(shù) SVG Morpheus是一款創(chuàng)新的JavaScript庫專為SVG圖標(biāo)變形動(dòng)畫設(shè)計(jì)完美實(shí)現(xiàn)前端上一篇Fleet 基于 mock APNs 的 Apple MDM 負(fù)載測試1 小時(shí)運(yùn)行指標(biāo)深度解讀下一篇Bash-it update 與 migrate 命令完全指南升級、遷移與自動(dòng)維護(hù)創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考