インストール - Arduino IDEのソースを表示

== 概要 ==
Arduino IDEとは、Arduino向けのスケッチ(プログラム)を作成する統合開発環境である。<br>
Arduino IDEを用いることで、スケッチを作成して、USBケーブルを通じてArduinoボードにアップロードするための環境が整う。<br>
<br>
ここでは、Arduino IDEをインストールする方法を記載する。<br>
<br>
<center>
{| class="wikitable"
|- style="text-align: center; background-color:white;"
| <yjshopping seller_id="bookfan">Prototyping Lab 「作りながら考える」ためのArduino実践レシピ</yjshopping>
|- style="text-align: center; background-color:white;"
| <yjshopping seller_id="hmv">Arduinoをはじめよう</yjshopping>
|}
</center>
<br><br>

== Arduino IDEのインストール ==
==== Windows ====
Arduino IDEをダウンロードしてインストールを開始する。<br>
基本的には、[Next]ボタンを押下し続けることでインストールは完了する。<br>
インストールの途中で、Arduino USB Driver、libusb-win32、Genuino USB Driver等のデバイスドライバがインストールされる。<br>
セキュリティメッセージが表示される場合は、[インストール]ボタンを押下する。<br>
<br>
==== CentOS / SUSE ====
Arduino IDEは、以下の3つのインストール方法がある。<br>
ここでは、リポジトリに追加してインストールする方法およびインストールせずに使用する方法を記載する。<br>
* ワンクリックインストール(SUSEのみ)
* リポジトリに追加してインストールする方法
* インストールせずに使用する方法
<br>
===== リポジトリを追加してインストール =====
まず、Arduino IDEのリポジトリを追加する。<br>
 sudo zypper --gpg-auto-import-keys ar -f https://download.opensuse.org/repositories/CrossToolchain:/avr/openSUSE_Leap_15.1 'CrossToolchain:avr'
 sudo zypper refresh
<br>
次に、Ardduino IDEをインストールする。<br>
 sudo zypper install arduino
<br>
===== インストールせずに使用 =====
[https://www.arduino.cc/en/Main/Software Arduinoの公式サイト]から、Arduino IDEをホームディレクトリにダウンロードする。<br>
解凍したarduino-<バージョン>ディレクトリにあるarduinoファイルが実行ファイルである。<br>
<br>
/home/ユーザ名/.local/share/applicationsディレクトリにorg.Arduino-IDE.desktopファイルを作成する。<br>
 vi /home/ユーザ名/.local/share/applications/org.Arduino-IDE.desktop
<br>
 # /home/ユーザ名/.local/share/applications/org.Arduino-IDE.desktopファイル
 
 [Desktop Entry]
 Type=Application
 Name=Arduino IDE <Arduinoのバージョン>
 GenericName=Arduino IDE
 Comment=Open-source electronics prototyping platform
 Exec="/home/ユーザ名/arduino-<Arduinoのバージョン>/arduino"
 Icon=arduino-arduinoide
 StartupWMClass=processing-app-Base
 Terminal=false
 MimeType=text/x-arduino;
 Categories=Development;IDE;Electronics;
 Keywords=embedded electronics;electronics;avr;microcontroller;
<br><br>

== Arduino IDEの設定 ==
==== Windows / CentOS / SUSE ====
Arduino IDEにおいて、標準フォントの表示が粗いため、別のフォントを使用することを推奨する。<br>
<br>
フォントの設定を行うため、preferences.txtファイルを以下のように編集する。<br>
* Windows
*: C:\Users\<ユーザ名>\AppData\Local\ArduinoXX\preferences.txt
* CentOS / SUSE
*: ~/.arduinoXX/preferences.txt
<br>
 # C:\Users\<ユーザ名>\AppData\Local\ArduinoXX\preferences.txtファイル
 # または
 # ~/.arduinoXX/preferences.txtファイル
 
 editor.font=Noto Sans,plain,14
<br>
==== CentOS / SUSE ====
Arduino IDEをインストール後、Arduino IDEを使用するユーザをdialoutグループ、lockグループ、uucpグループのメンバーにする必要がある。<br>
<u>ただし、ほとんどの環境では、dialoutグループにユーザを追加するだけでよい。</u><br>
<br>
これをYaSTで行うには、[セキュリティとユーザ]セクション - [ユーザとグループの管理]を選択して、必要な変更を行う。<br>
また、ターミナルから実行するには、以下のコマンドを実行する。<br>
 sudo usermod -aG dialout $USER
 # または
 sudo usermod -aG tty dialout lock uucp $USER
<br>
もし、上記のグループからユーザを削除する場合は、以下のコマンドを実行する。<br>
 sudo gpasswd -d $USER tty dialout lock uucp
<br>
設定を反映させるため、PCをログアウトまたは再起動する。<br>
<br><br>

== Fritzingデザインソフトウェア ==
Arduinoプロジェクトで使用するための推奨されるソフトウェアである。<br>
<br>
Fritzingは、インタラクティブな電子機器をクリエイティブに操作できるようにするためのオープンソースライブラリである。<br>
Fritzingは、Arduinoプロジェクトの文書化、電子回路の詳細の学習、他の人との作業の共有、製造設計に役立つ。<br>
<br>
fritzingは、SUSEのメインリポジトリを利用してインストールできる。<br>
 sudo zypper install fritzing
<br>
インストール後、デスクトップメニューの開発セクションからFritzingを起動できる。<br>
<br><br>

== AVR GCCツールチェーンの使用 ==
==== 公式のリポジトリからインストール ====
まず、以下のリポジトリを追加する。<br>
SLE向けのリポジトリは存在しないことに注意すること。<br>
 sudo zypper ar -cfp 90 https://download.opensuse.org/repositories/CrossToolchain:/avr/openSUSE_Leap_15.3/ AVR-GCC
<br>
インストールするライブラリは、以下の4つである。<br>
* avrdude
* avr-libc
* cross-avr-binutils
* cross-avr-gcc
<br>
もし、Arduino IDEがAVR-GCCを見つけることができない場合、/usr/local/binディレクトリ等にシンボリックリンクを作成する。<br>
例えば、AVR-GCCが/optディレクトリにインストールされている場合、以下のコマンドを実行する。<br>
 sudo find /opt/cross/bin/ -iname "avr*" -exec ln -s -t /usr/local/bin/ {} \;
<br>
==== サードパーティ製のインストール ====
Arduino IDEにおいて、Arduino付属のコンパイラが古いため、AVRの一部のライブラリとの互換性が無い場合がある。<br>
そのため、サードパーティ製の最新版に近いAVR GCCツールチェーンを使用することができる。<br>
<br>
まず、Arduino IDEの標準コンパイラをバックアップする。<br>
 cp -r /<Arduinoのインストールディレクトリ>/hardware/tools/avr /<Arduinoのインストールディレクトリ>/hardware/tools/avr_org
<br>
次に、以下のWebサイトにアクセスして、AVR GCCツールチェーンをダウンロードする。<br>
https://blog.zakkemble.net/avr-gcc-builds<br>
<br>
ダウンロードしたAVR GCCツールチェーンを解凍する。<br>
 tar xf avr-gcc-<バージョン名>-x64-linux.tar.bz2
<br>
解凍したAVR GCCツールチェーンのファイルおよびディレクトリを、/<Arduino IDEのインストールディレクトリ>/hardware/toolsディレクトリに上書きする。<br> 
 mv -f avr-gcc-<バージョン名>-x64-linux/* /<Arduinoのインストールディレクトリ>/Arduino/arduino-1.8.13/hardware/tools/avr
<br>
Arduino IDEを起動する時、サードパーティ製AVR GCCツールチェーンが自動的に検出される。<br>
<br>
AVR GCCツールチェーンが正常に動作するかどうかを確認するため、例えば、Blinkサンプル等をコンパイルしてArduinoにダウンロードする。<br>
<br><br>

== VSCodeでの開発 ==
VSCodeでは、コード補完機能も使用できることから、開発が効率化することができる。<br>
このセクションでは、Arduinoの開発をVSCodeで行うための設定に関する手順を記載する。<br>
<br>
==== 前提条件 ====
前提条件として、以下の導入が完了しているものとする。
* VSCode
* VSCodeの拡張機能(Arduino for Visual Studio Code、arduino-snippets、C/C++ for Visual Studio Code)
* Arduino IDE
<br>
==== VSCodeの設定 ====
VSCodeを起動して、[ファイル]メニュー - [ユーザー設定] - [設定]を選択して、設定画面を開く。<br>
設定画面右の[ユーザー]タブ - [拡張機能] - [ArduinoConfiguration]を選択する。<br>
<br>
以下に、設定項目と編集内容を記載する。<br>
* arduino.path
*: Arduino IDEの実行ファイルがあるディレクトリを入力する。
*: Windowsの場合 : C:\Program Files (x86)\Arduino
*: Linuxの場合 : <Arduino IDEのインストールディレクトリ>
*: <br>
* arduino.commandPath
*: Arduino IDEのインストールディレクトリにある実行ファイル名を入力する。
*: Windowsの場合 : arduino_debug.exe
*: Linuxの場合 : arduino
*: <br>
* arduino.defaultBaudRate
*: シリアルモニタのボーレートのデフォルト値を設定する。
*: ボーレートの値は、9600を推奨する。
*: <br>
* C_Cpp.intelliSenseEngine
*: コード補完機能の設定である。この設定項目では、<code>Tag Parser</code>を選択する。
*: <br>
* C_Cpp.default.includePath
*: インクルードする時に読み込むライブラリの場所を入力する。
*: [setting.jsonで編集]を選択する。
*: 以下に設定例を示す。
*: <br>
*: Windowsの場合
*: <code>"C_Cpp.default.includePath": [</code>
*: <code>   "C:\\Users\\<ユーザ名>\\Documents\\Arduino\\libraries",</code>
*: <code>   "C:\\Program Files (x86)\\Arduino\\tools",</code>
*: <code>   "C:\\Program Files (x86)\\Arduino\\libraries",</code>
*: <code>   "C:\\Program Files (x86)\\Arduino\\hardware"]</code>
*: <br>
*: Linuxの場合
*: <code>"C_Cpp.default.includePath": [</code>
*: <code>   "/home/<ユーザ名>/Arduino/libraries",</code>
*: <code>   "/home/<ユーザ名>/InstallSoftware/Arduino/arduino-<バージョン名>/libraries",</code>
*: <code>   "/home/<ユーザ名>/InstallSoftware/Arduino/arduino-<バージョン名>/tools",</code>
*: <code>   "/home/<ユーザ名>/InstallSoftware/Arduino/arduino-<バージョン名>/hardware"]</code>
<br>
以下に、setting.jsonの設定例を示す。<br>
 {
    // ...略
 
    // Arduino
    "arduino.defaultBaudRate": 9600,  // ボーレートの設定
    "arduino.path": "/home/<ユーザ名>/InstallSoftware/Arduino/arduino-<Arduino IDEのバージョン>",
    "arduino.commandPath": "arduino",
    "arduino.logLevel": "info",
    "arduino.enableUSBDetection": true,
    "arduino.disableTestingOpen": false,
    "arduino.skipHeaderProvider": false,
    "arduino.disableIntelliSenseAutoGen": true,  // VSCode起動時のIntelliSenseの自動生成を無効にする
 
    // C++
    "C_Cpp.intelliSenseEngine": "Tag Parser",
    "C_Cpp.default.includePath": [
        "/home/<ユーザ名>/Arduino/libraries",
        "/home/<ユーザ名>/InstallSoftware/Arduino/arduino-1.8.13/libraries",
        "/home/<ユーザ名>/InstallSoftware/Arduino/arduino-1.8.13/tools",
        "/home/<ユーザ名>/InstallSoftware/Arduino/arduino-1.8.13/hardware"]
 }
<br>
コンパイルまたはファームウェアのダウンロードにおいて、出力されるメッセージが文字化けする場合、<br>
以下のファイルを編集して、215〜225行目までのソースコードをコメントアウトする。<br>
* Windows
*: C:\Users\%USERNAME%\.vscode\extensions\vsciot-vscode.vscode-arduino-<バージョン名>\out\src\common\util.js
* Linux
*: ~/.vscode/extensions/vsciot-vscode.vscode-arduino-<バージョン名>/out/src/common/utils.js
<br><br>

__FORCETOC__
[[カテゴリ:CentOS]][[カテゴリ:SUSE]][[カテゴリ:Windows10]][[カテゴリ:Arduino]]