Arduino-arduino/arduino-cli-行业智能，新时代，新科技，新码农

<p> <img src="https://drone.arduino.cc/api/badges/arduino/arduino-cli/status.svg" alt="Build status" /> </p>
 <h1> arduino-cli </h1>
 <p> <code>arduino-cli</code>是一款一体化解决方案，可提供构建器，电路板/库管理器，上传器，发现以及使用任何Arduino兼容板和平台所需的许多其他工具。 </p>
 <p>此软件目前处于alpha状态：将添加新功能，某些功能可能会更改。 </p>
 <p>它将很快用作Arduino IDE和Arduino Create中的构建块。 </p>
 <h2>如何安装</h2>
 <h3>下载最新的稳定版本</h3>
 <p>这是<strong>尚未提供的</strong>，直到第一个稳定版本发布。 </p>
 <h4>下载最新的不稳定“alpha”预览</h4>
 <p>请注意这些是<strong>预览版</strong>，可能有错误，某些功能可能无法正常更新，如有更改，恕不另行通知，最新预览版本为<code>0.3.6-alpha.preview</code>：</p>
 <ul>
 <li> <a href="https://downloads.arduino.cc/arduino-cli/arduino-cli-latest-linux64.tar.bz2"> Linux 64 bit </a> </li>
 <li> <a href="https://downloads.arduino.cc/arduino-cli/arduino-cli-latest-linux32.tar.bz2"> Linux 32 bit </a> </li>
 <li> <a href="https://downloads.arduino.cc/arduino-cli/arduino-cli-latest-linuxarm.tar.bz2"> Linux ARM </a> </li>
 <li> <a href="https://downloads.arduino.cc/arduino-cli/arduino-cli-latest-linuxaarch64.tar.bz2"> Linux ARM64 </a> </li>
 <li> <a href="https://downloads.arduino.cc/arduino-cli/arduino-cli-latest-windows.zip"> Windows </a> </li>
 <li> <a href="https://downloads.arduino.cc/arduino-cli/arduino-cli-latest-osx.zip"> Mac OSX </a> </li>
 </ul>
 <p>下载后，将可执行文件放入<code>PATH</code>环境变量中的目录中。要使用下面的入门指南（<code>arduino-cli</code>）中介绍的工具，您应该将可执行文件从<em> arduino-cli-X.Y.Z-alpha.preview-XYZ </em>重命名为<em> arduino-cli </em>。 </p>
 <h3>构建最新的“前沿”来自源</h3>
 <ul>
 <li>您应该安装最近的Go编译器。 </li>
 <li>运行<code>go get -u github.com/arduino/arduino-cli</code> </li>
 <li> <code>arduino-cli</code>可执行文件将在<code>$GOPATH/bin/arduino-cli</code> </li>中生成
 </ul>
 <p>您可能希望将可执行文件复制到<code>PATH</code>环境变量（例如<code>/usr/local/bin/</code>）中的目录中。 </p>
 <h2>用法</h2>
 <p> Arduino CLI的目标是将其包含在Makefile中或用于命令行的任何类型的脚本中。 Arduino CLI旨在取代Arduino IDE的大多数功能，而无需图形用户界面。 </p>
 <h2>快速入门</h2>
 <h3>步骤1.创建新草图</h3>
 <p>该命令将在$ HOME / Arduino / </p>下的默认目录中创建一个名为MyFirstSketch的新空草图
 <pre><code>$ arduino-cli sketch new MyFirstSketch
Sketch created in: /home/luca/Arduino/MyFirstSketch

$ cat /home/luca/Arduino/MyFirstSketch/MyFirstSketch.ino
void setup() {
}

void loop() {
}
</code></pre>
 <h3>步骤2.修改草图</h3>
 <p>使用您喜欢的文件编辑器或IDE修改.ino文件：<code>$HOME/Arduino/MyFirstSketch/MyFirstSketch.ino</code>并将文件更改为如下所示：</p>
 <pre><code>void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(1000);
  digitalWrite(LED_BUILTIN, LOW);
  delay(1000);
}
</code></pre>
 <h3>步骤3.将电路板连接到PC </h3>
 <p>如果您正在运行arduino-cli的全新安装，则可能需要运行以下命令来更新平台索引：</p>
 <pre><code>$ arduino-cli core update-index
Updating index: package_index.json downloaded
</code></pre>
 <p>现在，只需使用USB电缆将电路板连接到PC即可。在这个例子中，我们将使用MKR1000板。 </p>
 <pre><code>$ arduino-cli board list
FQBN    Port            ID              Board Name
        /dev/ttyACM0    2341:804E       unknown
</code></pre>
 <p>已经发现了该板但我们还没有正确的核心来编程它。我们安装吧！ </p>
 <h3>步骤4.找到并安装正确的内核</h3>
 <p>我们必须查看<code>core search</code>命令提供的核心。它将提供与名称arduino </p>匹配的可用内核列表
 <pre><code>$ arduino-cli core search arduino
Searching for platforms matching _arduino_

ID              Version Installed       Name
Intel:arc32     2.0.2   No              Intel Curie Boards
arduino:avr     1.6.21  No              Arduino AVR Boards
arduino:nrf52   1.0.2   No              Arduino nRF52 Boards
arduino:sam     1.6.11  No              Arduino SAM Boards (32-bits ARM Cortex-M3)
arduino:samd    1.6.18  No              Arduino SAMD Boards (32-bits ARM Cortex-M0+)
arduino:stm32f4 1.0.1   No              Arduino STM32F4 Boards
littleBits:avr  1.0.0   No              littleBits Arduino AVR Modules
</code></pre>
 <p>如果您不确定，可以尝试使用电路板名称</p>优化搜索
 <pre><code>$ arduino-cli core search mkr1000
Searching for platforms matching _mkr1000_

ID              Version Installed   Name
arduino:samd    1.6.19  No          Arduino SAMD Boards (32-bits ARM Cortex-M0+)
</code></pre>
 <p>所以，Arduino MKR1000的合适平台是arduino：samd，现在我们可以安装它</p>
 <pre><code>$ arduino-cli core install arduino:samd
Downloading tools...
arduino:arm-none-eabi-gcc@4.8.3-2014q1 downloaded
arduino:bossac@1.7.0 downloaded
arduino:openocd@0.9.0-arduino6-static downloaded
arduino:CMSIS@4.5.0 downloaded
arduino:CMSIS-Atmel@1.1.0 downloaded
arduino:arduinoOTA@1.2.0 downloaded
Downloading cores...
arduino:samd@1.6.19 downloaded
Installing tools...
Installing platforms...
Results:
arduino:samd@1.6.19 - Installed
arduino:arm-none-eabi-gcc@4.8.3-2014q1 - Installed
arduino:bossac@1.7.0 - Installed
arduino:openocd@0.9.0-arduino6-static - Installed
arduino:CMSIS@4.5.0 - Installed
arduino:CMSIS-Atmel@1.1.0 - Installed
arduino:arduinoOTA@1.2.0 - Installed
</code></pre>
 <p>现在验证我们是否已通过运行</p>正确安装了核心
 <pre><code>$ arduino-cli core list
ID              Installed       Latest  Name
arduino:samd    1.6.19          1.6.19  Arduino SAMD Boards (32-bits ARM Cortex-M0+)
</code></pre>
 <p>我们终于可以检查电路板现在是否被识别为MKR1000 </p>
 <pre><code>$ arduino-cli board list
FQBN                    Port            ID              Board Name
arduino:samd:mkr1000    /dev/ttyACM0    2341:804E       Arduino/Genuino MKR1000
</code></pre>
 <p>如果由于任何原因未检测到该板，您可以列出所有支持的板<code>arduino-cli board listall</code>并搜索特定板：</p>
 <pre><code>$ 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:mkr1000
</code></pre>
 <p>太棒了！现在我们有董事会FQBN（完全合格的董事会名称）<code>arduino:samd:mkr1000</code>和董事会名称看起来不错，我们准备编译并上传草图</p>
 <h4>添加第三方核心</h4>
 <p>要添加第三方核心软件包，请将附加软件包的链接添加到文件<code>arduino-cli.yaml</code> </p>
 <p>如果要添加ESP8266内核，例如：</p>
 <pre><code>board_manager:
  additional_urls:
    - http://arduino.esp8266.com/stable/package_esp8266com_index.json
</code></pre>
 <p>然后运行：</p>
 <pre><code>arduino-cli core update-index
arduino-cli core install esp8266:esp8266
</code></pre>
 <h3>步骤5.编译草图</h3>
 <p>要编译草图，我们必须使用我们在上一个命令中获得的正确FQBN运行<code>compile</code>命令。 </p>
 <pre><code>$ arduino-cli compile --fqbn arduino:samd:mkr1000 Arduino/MyFirstSketch
Sketch uses 9600 bytes (3%) of program storage space. Maximum is 262144 bytes.
</code></pre>
 <h3>步骤6.上传草图</h3>
 <p>我们最终可以上传草图并看到我们的电路板闪烁，我们现在必须指定除了FQBN之外我们的电路板使用的串口：</p>
 <pre><code>$ arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:samd:mkr1000 Arduino/MyFirstSketch
No new serial port detected.
Atmel SMART device 0x10010005 found
Device       : ATSAMD21G18A
Chip ID      : 10010005
Version      : v2.0 [Arduino:XYZ] Dec 20 2016 15:36:43
Address      : 8192
Pages        : 3968
Page Size    : 64 bytes
Total Size   : 248KB
Planes       : 1
Lock Regions : 16
Locked       : none
Security     : false
Boot Flash   : true
BOD          : true
BOR          : true
Arduino      : FAST_CHIP_ERASE
Arduino      : FAST_MULTI_PAGE_WRITE
Arduino      : CAN_CHECKSUM_MEMORY_BUFFER
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.
</code></pre>
 <h3>步骤7.添加图书馆</h3>
 <p>现在我们可以尝试在草图中添加一个有用的库。我们可以先看一下图书馆的名字，我们最喜欢的是wifi101，这里有获取更多信息的命令</p>
 <pre><code>$ arduino-cli lib search wifi101
Name: "WiFi101OTA"
  Author:  Arduino
  Maintainer:  Arduino <info@arduino.cc>
  Sentence:  Update sketches to your board over WiFi
  Paragraph:  Requires an SD card and SAMD board
  Website:  http://www.arduino.cc/en/Reference/WiFi101OTA
  Category:  Other
  Architecture:  samd
  Types:  Arduino
  Versions:  [1.0.2, 1.0.0, 1.0.1]
Name: "WiFi101"
  Author:  Arduino
  Maintainer:  Arduino <info@arduino.cc>
  Sentence:  Network driver for ATMEL WINC1500 module (used on Arduino/Genuino Wifi Shield 101 and MKR1000 boards)
  Paragraph:  This library implements a network driver for devices based on the ATMEL WINC1500 wifi module
  Website:  http://www.arduino.cc/en/Reference/WiFi101
  Category:  Communication
  Architecture:  *
  Types:  Arduino
  Versions:  [0.5.0, 0.6.0, 0.10.0, 0.11.0, 0.11.1, 0.11.2, 0.12.0, 0.15.2, 0.8.0, 0.9.0, 0.12.1, 0.14.1, 0.14.4, 0.14.5, 0.15.1, 0.7.0, 0.14.0, 0.14.2, 0.14.3, 0.9.1, 0.13.0, 0.15.0, 0.5.1]
</code></pre>
 <p>我们现在准备安装它！请务必使用“名称：”中指定的lib的全名。之前见过的部分</p>
 <pre><code>$ arduino-cli lib install "WiFi101"
Downloading libraries...
WiFi101@0.15.2 downloaded
Installed WiFi101@0.15.2
</code></pre>
 <h2>内联帮助</h2>
 <p> <code>arduino-cli</code>是一个命令容器，只需运行完整列表即可：</p>
 <pre><code class="language-bash">$ arduino-cli
Arduino Command Line Interface (arduino-cli).

Usage:
  arduino-cli [command]

Examples:
arduino <command> [flags...]

Available Commands:
  board         Arduino board commands.
  compile       Compiles Arduino sketches.
  config        Arduino Configuration Commands.
  core          Arduino Core operations.
  help          Help about any command
  lib           Arduino commands about libraries.
  sketch        Arduino CLI Sketch Commands.
  upload        Upload Arduino sketches.
  version       Shows version number of Arduino CLI.
....
</code></pre>
 <p>每个命令都有自己的特定帮助，可以使用<code>help</code>命令获取，例如：</p>
 <pre><code class="language-bash">$ arduino-cli help core
Arduino Core operations.

Usage:
  arduino-cli core [command]

Examples:
arduino-cli core update-index # to update the package index file.

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 cores.
  update-index Updates the index of cores.

Flags:
  -h, --help   help for core

Global Flags:
      --config-file string   The custom config file (if not specified the default one will be used). (example  "/home/user/.config/arduino/arduino-cli/arduino-cli.yaml")
      --debug                Enables debug output (super verbose, used to debug the CLI).
      --format string        The output format, can be [text|json]. (default "text")

Use "arduino-cli core [command] --help" for more information about a command.

</code></pre>
 <h1> FAQ </h1>
 <h4>为什么运行<code>arduino-cli board list</code>时未检测到Arduino Uno / Mega / Duemilanove？ </h4>
 <p>因为：</p>
 <ul>
 <li>你的电路板是一个更便宜的克隆，或</li>
 <li>它安装了一个USB2Serial转换器，如FT232或CH320：这些芯片总是向操作系统报告相同的USB VID / PID，因此我们唯一知道的是该板安装了特定的USB2Serial芯片，但我们不知道哪个董事会是。 </li>
 </ul>
 <h4> Uno / Mega / Nano / Duemilanove的核心是什么？ </h4>
 <p> <code>arduino:avr</code> </p>
 <h4>什么是FQBN ...？ </h4>
 <ul>
 <li> Arduino UNO：<code>arduino:avr:uno</code> </li>
 <li> Arduino Mega：<code>arduino:avr:mega</code> </li>
 <li> Arduino Nano：<code>arduino:avr:nano</code>或<code>arduino:avr:nano:cpu=atmega328old</code>如果你有旧的bootloader </li>
 </ul>
 <h4>如何找到电路板的核心/ FQBN？ </h4>
 <p>请参阅：https：//github.com/arduino/arduino-cli#step-4-find-and-install-the-right-core </p>