記事ディレクトリ
0 まえがき
以前、VS Code をベースにコンピュータ上に Arduino 環境を構築しましたが、一般的な方法は、Arduino IDE のインストールを前提として、VS Code 上でプラグインをダウンロードし、Arduino IDE のパスを設定することでした。 。しかし今日、メモリ内の方法に従って設定すると、ポップアップウィンドウが表示されました。
試行錯誤の結果、従来通りArduino IDEベースで設定したい場合はこの設定を無視するしかなく、「バンドルされたarduino-cliを使用する」をクリックしないと問題が発生することが分かりました。
もともとこの問題はほぼ解決されていたのですが、忌まわしいことにウィンドウを更新するたびにこのポップアップが表示され、非常にうっとうしいのです。そこで、少し時間がかかりましたが、arduino-cli に関するすべての関連情報を注意深く読んだところ、この arduino-cli が非常に素晴らしいものであることがわかり、驚きました。開発環境を整えるだけでArduino IDEには一切依存しません！、このチュートリアルでは、VS Code の arduino-cli に基づいて Arduino フレームワーク開発環境を構成する方法を簡単に紹介します。
インターネット上にも同様のチュートリアルがいくつかありますが、詳細かつ明確ではありません。原則から始めて、ここではより詳細なチュートリアルを示し、より多くの内容を含んでいます。辛抱強く見てください。
1 VS CodeのメリットとArduino IDEのデメリット
Arduino IDEを使っている場合は公式サイトからダウンロードして何も考えずにインストールするだけなのでとても簡単です。ただし、VS Code を使用するには、比較的面倒な設定が必要です。ここでは、VS Code の利点と Arduino IDE の欠点について簡単に説明します。
時間を費やすかどうかを決める前に、メリットを確認してください。
- VS Code インターフェイスは Arduino IDE よりも優れており、それについては疑いの余地がありません。
- VS Code はソース コードをトレースできるため、サードパーティのライブラリを理解するのに非常に便利です
- VS Code インテリジェント プロンプト (IntelliSence) により、コードの作業負荷が大幅に軽減されます。
2 事前準備
- VSCode を所有し、その基本的な動作原理を理解し、基本的に使用できる
- Arduino IDE をダウンロードする必要はありません。ダウンロードした場合は完全にアンインストールできます。
3 Arduino CLI
3.1 Arduino CLI とは何ですか?
まず、この cli が何であるかを理解しましょう。いわゆるcli、つまりコマンドラインインターフェイスはgui (グラフィックユーザーインターフェイス)の逆で、コマンドラインを使用してグラフィカルインターフェイス上のボタンをクリックすることで完了できる機能を実現します。2018年に正式リリースされた統合ツールです。コンパイルやダウンロード、管理ライブラリやボードSDKなど、Arduino関連の組み込み開発プロセスをこのツールに統合しています。(もちろん、それ自体にコンパイルやダウンロードの機能はなく、他のツールを呼び出して操作するだけです。 ) このように、このツールだけでプロジェクト全体をビルドすることができ、非常に強力です。
このツールはクロスプラットフォームであり、VS Code や Eclipse などのさまざまな一般的なエディタに簡単に統合できます。
興味のある方は公式サイトの紹介文をご覧ください
3.2 ダウンロードとインストール
Arduino cli ツールは基本的に数日ごとに非常に迅速に更新されるため、公式 GitHub: https://github.com/arduino/arduino-cli/releasesからダウンロードすることをお勧めします。
Arduino cli は、圧縮パッケージとしてダウンロードしてコンピュータ上のどこかに配置できる単一の実行可能ファイルです。.msiただし、インストール時に環境変数にインストール パスが自動的に追加されるため、拡張子がのファイルをダウンロードすることをお勧めします。
インストール後、インストールが成功したかどうかを確認します。
arduino-cli -h #or --help
エラーがなければ、インストールは成功です。
上の図の赤い下線はより重要な指示であり、後で使用します。
3.3 基本的な使い方
ここでは 2 つの簡単な使用テクニックを紹介します。
-
ヘルプ手順をすばやく照会する
特定のコマンドの背後にある「サブコマンド」がわからない場合は、--helpまたは を使用し-hてコマンドの使用法を照会できます。または、パラメータを直接入力しないと、デフォルトでヘルプ ドキュメントが開きます。直接入力するとarduino-cliヘルプドキュメントも開きます -
タブ補完設定
公式が提供するタブ補完操作です, コマンド入力時に便利な全てのコマンドとパラメータの補完をサポートできます Power Shell7のインストールが前提のようです 具体的な設定チュートリアルはこちらを参照してください公式ウェブサイト。面倒な場合はスキップしても構いません。
3.4 開発環境の構成
前述したように、arduino-cli は基本的に Arduino IDE の共通機能を備えた統合ツールであり、Arduino IDE の中核とも言えますが、エディターはありません。したがって、構成のほぼすべてのステップを理解できるように、Arduino IDE の基本機能を理解することが最善です。
設定する前に、まず Arduino IDE にどのようなディレクトリがあるかを知っておく必要があります。
- 1 つ目は IDE のインストール ディレクトリであり、その
%ProgramFiles(X86)%\Arduino_1.8.19ディレクトリ (デフォルト パス) の下にあります。 - 次に、開発ボード SDK ディレクトリがあり、各開発ボードには、対応する基本コード、組み込みライブラリ、コンパイルおよびダウンロード ツールなどが含まれています
%LocalAppdata%\Arduino15。 - 使用中にサードパーティのライブラリがインストールされている場合、ライブラリ ファイルはプロジェクト フォルダーに配置されます。もちろん、これは IDE でカスタマイズすることもできます。
Arduino IDE のフォルダー構造を理解した後、その動作原理をある程度理解してから、インストールされた arduino-cli を使用して Arduino 開発環境を構築し始める必要があります。
VS Code の部分は最後にあり、少しわかりにくいかもしれませんが、慌てずに従ってください。読み終えると理解できると思います。
- 初期設定
arduino-cli config init --dest-dir "$env:LOCALAPPDATA\Arduino15"
このフォルダーを選択する理由は、VS Code の Arduino プラグインがこのフォルダー内の構成ファイルのみを認識するためです。これについては後で説明します。
構成を表示したい場合は、次のことができます。
arduino-cli config dump
これは基本的に、上記の初期構成ファイルを調べています。デフォルトのパスに設定ファイルがない場合は、組み込みのデフォルト設定が表示されます。
- 構成ファイルを変更します (オプション)
デフォルトの設定を確認すると、ライブラリ ファイルとボード SDK ファイルが同じパスにないことがわかります。これは個人的に非常に不便なので、設定を変更します。
arduino-cli config set directories.user "$env:LOCALAPPDATA\Arduino15"
このように、構成ファイル、ボード SDK ファイル、およびインストールされたサードパーティ ライブラリ ファイルはすべて 1 つのパスにあり、ターゲットを見つける必要がある場合に、より明確になります。
- 開発ボードコアをダウンロードする
これが上で繰り返し述べた SDK です。ボードが異なれば異なります。Arduino のみを開発する場合は、Arduino 開発キットをインストールするだけで済みます。
# 先更新一下板子列表（core list）
arduino-cli core update-index
# 再下载arduino核心（SDK）
arduino-cli core install arduino:avr
では、ESP8266 と ESP32 を開発したい場合はどうすればよいでしょうか? Arduino IDE でどのように設定したかを覚えていますか? まずボード リンクと json ファイルを追加し、ダウンロードしてインストールすると、ボード リストに多くのオプションの開発ボード モデルが表示されます。
Arduino IDE で設定する場合、失敗する可能性が非常に高く、ダウンロードに数回のクリックが必要になることがよくあることは、設定したことがある人ならご存知だと思います。
したがって、ここでの焦点はパッケージの json ファイルです。前のチュートリアルから、このリンクは常に失敗するため、比較的修正された GitHub リンクを見つけることをお勧めします。
インストール手順：
# 先添加额外的链接，按需选择，多个开发板用空格分隔
arduino-cli config set board_manager.additional_urls https://hub.yzuu.cf/esp8266/Arduino/releases/download/3.1.2/package_esp8266com_index.json https://hub.yzuu.cf/espressif/arduino-esp32/releases/download/2.0.7/package_esp32_index.json
# 然后再更新一下链接（实际上就是把上面两个文件下载下来）
arduino-cli core update-index
# 这个时候就可以根据需要下载对应的开发板包了
arduino-cli core install esp32:esp32
arduino-cli core install esp8266:esp8266
3 番目のステップで、ダウンロード速度が遅すぎる場合は、各ダウンロード パッケージが GitHub からダウンロードされるためです。パッケージ ファイルを変更し、ミラー Web サイトを使用してダウンロードすることをお勧めします。速度が大幅に速くなります。
github.com検索と置換を使用し、すべてを に置換してhub.yzuu.cfから、上記のコマンドを実行することをお勧めします。
インストールが完了したら、arduino-cli を使用してキャッシュ ファイルをクリアできます。
# 加上-v可以看到详细输出信息
arduino-cli cache clean -v
これまでのところ、arduino-cli 部分は構成されています。次に、VS Code 部分を構成する方法を見てみましょう。
4 VS コードの構成
- まずArduinoプラグインをインストールします。これについては間違いありません
私の提案は、「詳細」モジュールを詳しく見て、その後の操作をよりよく理解することです。このプラグインには、C/C++ プラグインとシリアル ポート プラグインという 2 つの依存関係があり、インストール中に自動的にインストールされる必要があります。
プラグインをインストールした後、このプラグインのインストール ディレクトリを見ると、Arduino CLI がデフォルトでディレクトリにダウンロードされていることがわかります (つまり、以前にインストールした Arduino CLI、おそらくバージョンのみ)は異なります）、プラグインのコンパイルとダウンロードの機能はすべてこのプログラムの実装に依存します。
理論的には実行プログラムがすでに存在しているので、自分でインストールする必要はありませんが、個人的には、それでも再度インストールする必要があると感じています。
- ① ファイル自体は 30M 未満とそれほど大きくないため、ダウンロード/コピーのコストが安く感じられます。
- ②このプログラムを任意の場所で使用するには、環境変数に追加するのがベストですが、VS Code プラグインは更新されるとディレクトリが変更されるため、一般に時間とともに変更されるため、環境変数に追加します。変数には意味がありません。
- プラグインの設定
このプラグインの設定は非常に簡単で、「Use Arduino Cli」にチェックを入れるだけです。
- 基本的な使い方
開発ボードの SDK がインストールされている場合は、VS Code で新しいファイルを作成し、.ino下部のステータス バーで開発ボードを選択すると、プログラムが自動的に更新され、現在のプロジェクト フォルダーにファイルが作成されますc_cpp_properties.json。対応する開発ボードの開発プロセスで使用する必要があるコンパイラ、含める必要があるライブラリ ファイルなど。表示されない場合は、Ctrl Shift P キーを押してウィンドウのリロードを選択し、数回更新してください。また、開発ボードを切り替えると、自動的に更新されます。これは VS Code の重要な役割であり、多くの作業を節約するのに役立ち、自分でコマンドを入力する必要がなく、非常に便利です。
- ライブラリファイルを追加する
プログラム開発プロセス中にサードパーティのライブラリを追加してプログラム内で使用したい場合はどうすればよいでしょうか? まず、コマンド ラインを使用してサードパーティ ライブラリをインストールします。
# 查看已安装的库
arduino-cli lib list
# 搜索某个库
arduino-cli lib search <name>
# 安装某个库
arduino-cli lib install <name>
# 升级
arduino-cli lib upgrade
サードパーティ製のライブラリをインストールすると、プログラム内で直接参照できるようになりますが、c_cpp_properties.json ファイルが更新されていないため、通常は波線が引かれます。ウィンドウを再読み込みしてみてください。ほぼ問題ありません。ウィンドウがリロードされるたびに、プラグインは開かれた ino ファイルを検証します (Verify)
-
使用上の注意
- 右下隅のステータス バー、つまりボード モデル、シリアル ポート番号、ターゲット ファイル (開いているファイルとは限りません) などに常に注意してください。
- arduino-cli は依然として Arduino IDE プロジェクト ファイルの概念を使用しているため、新しいファイルを作成するたびに、外部に同じ名前のフォルダーを設定することを忘れないでください。
要約すると、Arduino プラグインは実際にはインストール ディレクトリ内の cli プログラムに依存しており、その共通機能の一部が VS Code インターフェイス上のいくつかのボタンに統合されているため、開発者の使用が大幅に容易になります。 -cli 、サードパーティのライブラリをインストールするときなど、時折必要になる場合に使用しますが、実際の操作は依然として VS Code に付属の arduino-cli プログラムです。これは、2 つの同一のプログラムが同じファイルの山を読み書きすることに相当します。