メインコンテンツへスキップ
見出し画像

Mac上にArduinoのソフトウェア開発環境を作成する

     Arduinoのソフトウェア開発環境を、Mac(Apple Silicon)上に構築したいと思います。ここでは、ちょっとした試作や実験ではなく、ある程度の規模のソフトウェア開発を想定します(初心者の方は、他の初心者向けのサイトを利用される方が良いでしょう)。また、ESP32-C6などを搭載したデバイスが増えてきていることも考慮し、開発環境には Visual Studio Code と PIOArduino を組み合わせた構成を採用するものとします。

     なお、ここで作成した環境を使用して、実際にLILYGO T-Display S3でプログラムを作成して遊ぶ話も記しました。以下のURLで行けますので、合わせてご覧ください。この環境により、本来行っているのはクロス開発であるのに、ネィティブ環境のような環境をVisual Studio Codeを統合環境(IDE)として利用する形態で実現できていることが分かると思います。

     https://note.com/sohmatrix/n/n162c6987c6b4?sub_rt=share_pw

     以下では、実際に開発環境を構築する手順について説明します。
     ここで構築する開発環境そのものに関する技術的な解説や、使用するソフトウェアのライセンスに関する情報については、後半でまとめて説明します。
     基本的に、個人でこの開発環境を構築し、学習や趣味としてプログラミングを楽しむ範囲では、ライセンスについて過度に意識する必要はないでしょう。ただし、作成したプログラムを公開・配布したり、商用目的のソフトウェア開発に利用したりする場合には、使用している開発ツール、フレームワーク、ライブラリなどのライセンス条件を確認し、それぞれの条件に応じた適切な対応が必要になりますので、注意してください。

    Visual Studio Code のインストール

     まず、Visual Studio Codeの公式サイトを開き、[無料ダウンロード] をクリックします。続いて、ダウンロードするバージョンとして 「macOS Universal」 を選択し、インストーラーをダウンロードします。

    画像
    Visual Studio Code の無料ダウンロード

     ダウンロードしたファイルはDMG形式なので、ダブルクリックしてマウントします。インストール画面が表示されたら、Visual Studio Code のアイコンを Applications フォルダへドラッグ&ドロップしてコピーし、インストールを完了します。

     次に、Visual Studio Codeを起動します。左側の [拡張機能(Extensions)] を選択し、検索ボックスに 「Japanese」 と入力します。表示された日本語言語パックの [Install] をクリックしてインストールします。
     インストール後に 「Change Language and Restart」 と表示されたら、それを選択してVisual Studio Codeを再起動します。再起動後は、日本語表示で利用できるようになります。

    画像
    Visual Studio Code に日本語パックの拡張機能を追加

    PIOArduino を Visual Studio Code の環境にインストール

     同様に、Visual Studio Codeの左側にある [拡張機能] を選択し、検索ボックスに 「pioarduino」 と入力します。検索結果に 「pioarduino IDE」 が表示されるので、[インストール] をクリックしてインストールします。

     PIOArduino IDEをインストールすると、開発に必要なツールやライブラリなどが必要に応じて自動的にダウンロードされるようになります(インターネット接続が必要です)。そのため、利用者が個別にこれらをインストールする手間を大幅に省くことができます。

     以上で、Visual Studio Code と PIOArduino の開発環境を使用したArduinoのソフトウェア開発を開始できるようになります。

    PIOAruduino環境でプロジェクトを作成

     実際のソフトウェア開発では、Visual Studio CodeのIDEとしての基本操作と、Arduino固有の設定や作成したソフトウェアのビルドおよびその書き込み(対象のマイコンへの転送)などを行うPIOArduinoの操作を組み合わせて、開発を進めていきます。

     Visual Studio Codeの左側にある 「pioarduino」 のアイコンを選択すると、[PROJECT TASKS] が表示されます。すでに作成済みのプロジェクトがある場合は、[Pick a Folder] を選択し、対象のプロジェクトフォルダを開きます。 
     一方、新しいプロジェクトを作成する場合は、[Create New Project] を選択します。すると、[PIO Home] が開き、プロジェクトの作成やサンプルプロジェクトの参照など、さまざまな機能を利用できるようになります。ここで [New Project] を選択すると、新しいプロジェクトの作成が始まります。プロジェクト名や保存先を指定した後、開発に使用するボード(Board)を選択します。ボードには、使用する開発ボードや搭載されているマイコン(MPU/MCU)に対応したものを指定します。

    画像
    Visual Studio Code 上で PIOArduino 環境を使用する

     このようにして、Visual Studio CodeとPIOArduinoを使用したArduino向けソフトウェアの開発を開始できます。

     なお、プロジェクト全体に関わる操作を行う場合は、基本的にPIOArduinoが提供するボタンやメニューなどを使用するよう注意してください。Visual Studio Codeは汎用的な開発環境であり、PIOArduino以外の拡張機能や開発環境を利用したソフトウェア開発も可能です。そのため、Visual Studio Code本体の機能とPIOArduinoが提供する機能を区別して使用する必要があります。
     ここで構築した開発環境では、PIOArduinoを利用して、作成したプログラムのビルド、ESP32などのマイコンへの書き込みと実行、さらにソースコードレベルでのデバッグなどを行うことができます。
     ただし、デバッグ方法や使用するマイコンボードによっては、通常のUSBケーブルによる接続だけでは対応できない場合があります。その場合には、USB-シリアル変換器やJTAGデバッガなどの追加機器が必要になることがあるため、使用するボードやデバッグ方式に応じて、必要な機器や接続方法をあらかじめ確認しておく必要があります。

    画像

    この開発環境の技術的な解説

     ここで使用しているPIOArduinoの開発環境は、Mac上で動作し、Arduinoで使用するマイコン向けのソフトウェアを開発するための環境です。そのため、macOS上で動作するアプリケーションを開発するための環境とは異なります。
     PIOArduinoでは、対象となるマイコンや開発ボードに応じて、ソフトウェアのビルドや書き込みに必要なコンパイラ、ライブラリ、各種ツールなどが自動的にインストールされ、それらを組み合わせて開発環境が構成されます。

     このように、ソフトウェアを開発するコンピュータと、そのソフトウェアを実際に動作させるコンピュータやマイコンが異なる開発形態を、一般に「クロス開発」と呼びます。今回の場合、Macが開発を行う「ホスト(Host)」であり、Arduinoとして使用するマイコンが、作成したプログラムを実行する「ターゲット(Target)」となります。
     また、PIOArduinoの開発環境で使用されるC/C++コンパイラもMac上で動作しますが、生成するのはmacOS上で動作するプログラムではなく、Arduino環境で使用するESP32-S3などのマイコン上で動作するバイナリプログラムです。このように、コンパイラ自身が動作する環境とは異なる環境向けのプログラムを生成するコンパイラを「クロスコンパイラ(Cross Compiler)」と呼びます。

    画像
    ネイティブ開発とクロス開発の違いのイメージ図

     これに対し、Visual Studio Codeは、ArduinoやESP32などのマイコン開発だけを目的としたソフトウェアではありません。Visual Studio Codeは、Microsoftが提供している汎用的なソースコードエディタであり、様々なプログラミング言語やソフトウェア開発環境で利用できます。

     Visual Studio Codeの大きな特徴の1つが、「拡張機能(Extension)」によって機能を追加できることです。標準のVisual Studio Codeは比較的シンプルな構成になっていますが、開発するソフトウェアや使用するプログラミング言語に応じて拡張機能を追加することで、コード補完、ビルド、デバッグ、Gitによるソースコード管理など、様々な開発機能を利用できるようになります。

     今回使用しているPIOArduinoも、このVisual Studio Codeの拡張機能として導入して利用します。PIOArduinoを導入することで、Visual Studio Code上からArduinoやESP32などを対象としたプロジェクトの作成、ソースコードの編集、ビルド、マイコンへのファームウェアの書き込みなどを行えるようになります。

     つまり、Visual Studio Code自体がArduino専用の開発環境なのではなく、必要な拡張機能や開発ツールを組み合わせることで、様々な用途に対応できる汎用的な開発環境として利用できるということです。そのため、同じVisual Studio Codeを使用しながら、Arduinoなどの組み込みソフトウェアだけでなく、C/C++、Python、JavaScriptなどを使用した様々なソフトウェアの開発を行うことができます。

     Visual Studio CodeはMac上で動作するソフトウェアの開発にも利用できます(この場合、開発環境と動作環境が同じなので、クロス開発に対して「ネイティブ開発」と呼んだりします)。ただし、Visual Studio Code自体に、コンパイラやデバッガなど、ソフトウェア開発に必要なすべての機能が内蔵されているわけではありません。実際の開発では、目的に応じた開発ツール(この場合は、ツールチェインなどと呼ばれます)とVisual Studio Codeを組み合わせて使用します。

     Macには、Appleが提供する「Xcode」という統合開発環境(IDE)があります。Xcodeは、macOS、iOS、iPadOSなど、Appleのプラットフォーム向けソフトウェアを開発するための標準的な開発環境です。ソースコードの編集だけでなく、コンパイラ、デバッガ、GUIを設計するための機能、シミュレータなど、Apple製品向けのソフトウェア開発に必要な様々な機能が統合されています。

     また、Xcodeのすべての機能を必要としない場合には、「Xcode Command Line Tools」を利用する方法もあります。Xcode Command Line Toolsには、ClangなどのC/C++コンパイラをはじめ、macOS上でソフトウェアを開発するための基本的なコマンドラインツールが含まれています。

     Visual Studio CodeとXcode Command Line Toolsを組み合わせれば、Visual Studio Codeをソースコードの編集などを行うフロントエンドとして使用し、実際のコンパイルにはMacにインストールされているClangなどの開発ツールを使用する、といった構成にすることができます。さらに、C/C++などに対応したVisual Studio Codeの拡張機能を追加することで、コード補完やデバッグなどの機能も利用できるようになります。

     ここで重要なのは、Visual Studio Codeとコンパイラなどの開発ツールの役割を分けて考えることです。Visual Studio Codeは様々な開発ツールと組み合わせて利用できる汎用的なソースコードエディタであり、使用するコンパイラやSDKなどは、開発するソフトウェアの種類によって異なります。

     たとえば、Mac上で動作するC/C++プログラムを開発する場合には、Visual Studio CodeとXcode Command Line ToolsのClangなどを組み合わせることができます。この場合、Mac上でコンパイラを実行し、生成されたプログラムもMac上で実行するため、基本的にはネイティブ開発となります。

     つまり、同じVisual Studio Codeを使用していても、その背後で使用する開発環境を切り替えることによって、Mac用のソフトウェアからESP32などのマイコン用ファームウェアまで、異なる種類のソフトウェアを開発することができます。このように、特定のプラットフォームに限定されず、拡張機能や外部の開発ツールと組み合わせることで様々なソフトウェア開発に対応できることが、Visual Studio Codeの大きな特徴です。

     それから、作成したプログラムの実行形態についてですが、PCのOS上で実行されるプログラムと、ESP32などのマイコンで実行されるプログラム(この場合は、ファームウェアと呼ばれることが多い)は、どちらもCPUが命令を順番に実行するという基本的な仕組みは同じですが、その実行環境には大きな違いがあります。

     PCなどでは、Windows、macOS、LinuxなどのOS(Operating System)が最初に起動し、そのOS上でアプリケーションを実行します。アプリケーションは、通常、SSDやHDDなどのストレージにファイルとして保存されており、起動するとOSによって必要なプログラムやデータがメモリ(RAM)に読み込まれ、CPUによって実行されます。また、アプリケーションがディスプレイ、ストレージ、ネットワーク、USBなどのハードウェアを利用する場合も、基本的にはOSが提供するAPIやデバイスドライバを介してアクセスします。そのため、PCではOSがアプリケーションとハードウェアの間に入り、メモリ管理、ファイル管理、入出力、通信、複数プログラムの同時実行などを管理しています。

     これに対して、ESP32などのマイコンでは、作成したプログラムは一般に「ファームウェア」として、(ESP32内蔵の)フラッシュメモリに書き込まれます。ESP32の電源を入れたりリセットしたりすると、内蔵されたBoot ROMやブートローダーによる初期化処理を経て、フラッシュメモリに保存されているファームウェアが自動的に実行されます。PCのように、利用者がOSを起動してからアプリケーションを選択して実行するという使い方ではなく、基本的には電源を入れると、その機器のために用意されたプログラムが動き始めます。このように、機器に組み込まれ、その機器の動作そのものを制御するソフトウェアであることが「ファームウェア」という名称の由来でもあります。
     また、ESP32のファームウェアは、GPIO、I²C、SPI、UART、PWM、ADCなどを利用して、センサー、LED、モーター、ディスプレイなどのハードウェアを比較的直接的に制御できます。たとえばGPIO端子の出力を変化させてLEDを点灯させたり、I²Cを使ってBME280などのセンサーから測定値を取得したりできます。このような物理的なハードウェアの制御は、組み込み機器で使用されるファームウェアの大きな特徴です。
     ただし、「ESP32ではOSを使用しない」と単純に考えるのは正確ではありません。ESP32の代表的な開発環境であるESP-IDFでは、リアルタイムOSであるFreeRTOSが利用されており、Arduino Core for ESP32もその仕組みの上に構築されています。今回作成したPIOAruduino環境でも、これを使用しますので、前述したハードウェアの制御において、複数の対象に対してそれぞれに個別の処理を並列に行うことを、効率的に行うことが容易に行えるようになります。
     FreeRTOSはWindowsやmacOSのような汎用OSとは異なり、組み込み機器で複数の処理を効率よく実行したり、一定時間内に処理することが重要なリアルタイム処理を管理したりするための軽量なOSです。

     さらに、利用できるハードウェア資源にも大きな違いがあります。一般的なPCではGB単位のRAMや大容量のSSDを使用できますが、ESP32ではRAMやFlashメモリの容量が大幅に限られています。そのため、ファームウェアの開発では、プログラムサイズ、RAM使用量、処理速度、消費電力などを意識して設計することがPC用アプリケーション以上に重要になります。

     したがって、両者の違いを簡単に整理すると、PCのアプリケーションは、汎用OSによって用意された実行環境の中で動作するプログラムであるのに対し、ESP32などのファームウェアは、機器のFlashメモリに組み込まれ、電源投入時からその機器固有の機能やハードウェアを制御するために動作するプログラムと考えることができます。

    画像

    この開発環境のライセンス関係の情報

    ここで、使用するソフトウェアのライセンスについても確認しておきます。

     まず、Visual Studio Code について見てみます。正確には、Visual Studio Code のライセンス情報を見てください。
     Visual Studio CodeはMicrosoftが提供しているソフトウェアで、Windows、macOS、Linuxなどで利用できます。個人での利用だけでなく、企業などにおけるソフトウェアの開発やテストにも利用できます。Microsoftのライセンス条項では、アプリケーションの開発やテストを目的として、Visual Studio Codeを任意の数のコンピュータにインストールして使用することが認められています。
     ただし、Visual Studio Codeのライセンスについては、オープンソースとして公開されているソースコードと、Microsoftが製品として配布しているVisual Studio Codeを区別して考える必要があります。 Visual Studio Codeの基礎となるソースコードは「Code - OSS」として公開されており、MIT Licenseが適用されています。
     一方、MicrosoftのWebサイトなどからダウンロードして使用する「Visual Studio Code」という製品そのものは、MIT Licenseではなく、Microsoftの「Microsoft Software License Terms」に基づいて提供されています。したがって、「Visual Studio Codeの基礎となるソースコードはオープンソースであるが、Microsoftが配布するVisual Studio Code製品そのものはMIT Licenseで提供されているわけではない」という点に注意が必要です。
     また、Visual Studio Codeでは、様々な拡張機能を追加して利用できますが、それぞれの拡張機能にはVisual Studio Code本体とは別のライセンスが適用されている場合があります。そのため、特に企業での利用やソフトウェアの配布などを行う場合には、使用する拡張機能についても、それぞれのライセンス条件を確認する必要があります。
     このように、Visual Studio Codeを利用する際には、オープンソースとして公開されているCode - OSS、Microsoftが製品として配布しているVisual Studio Code、さらに追加して使用する拡張機能では、それぞれ異なるライセンスが適用される可能性があることを理解しておく必要があります。

     次に、PIOArduinoについて見てみます。PIOArduinoの開発環境は、以下に示すように、様々なソフトウェアやツールを組み合わせて構成されています。そのため、PIOArduinoを利用する際には、PIOArduino本体のライセンスだけでなく、実際に使用するフレームワークやライブラリ、ツールなど、それぞれの構成要素に適用されているライセンスについても確認する必要があります。
     PIOArduinoは、ESP32などのマイコンを対象としたソフトウェア開発に利用できるオープンソースの開発環境です。PlatformIOを基礎としたコミュニティによるフォークとして開発されており、Visual Studio Codeの拡張機能として利用できるPIOArduino IDEや、コマンドラインから利用できるPIOArduino Coreなどが提供されています。
     PIOArduino CoreおよびVisual Studio Code向けのPIOArduino IDEには、「Apache License 2.0」というオープンソースライセンスが適用されています。Apache License 2.0は比較的制約の少ないライセンスであり、個人での利用だけでなく、企業などにおける商用目的での利用も可能です。また、ライセンスで定められた条件を守ることで、ソースコードの変更や再配布なども行うことができます。
     ただし、PIOArduinoを使用して作成したプログラムそのものに、必ずApache License 2.0が適用されるという意味ではありません。PIOArduinoはソフトウェアを開発するためのツールであり、PIOArduino自体のライセンスと、それを使用して作成したプログラムに適用されるライセンスは、分けて考える必要があります。
     さらに、実際のマイコン向けソフトウェア開発は、PIOArduinoだけで完結するわけではありません。PIOArduinoでは、対象となるマイコンや使用するフレームワークに応じて、コンパイラ、Arduino Core、ESP-IDF、各種ライブラリなど、様々なソフトウェアを組み合わせて開発環境を構成します。これらのソフトウェアには、PIOArduino本体とは異なるライセンスが適用されている場合があります。
     たとえば、ESP32向けのArduino Coreである「Arduino-ESP32」にはLGPL-2.1のライセンスが適用されるコードが含まれており、ESP-IDFではApache License 2.0を中心として、複数のライセンスのソフトウェアが使用されています。また、ユーザーが追加するArduinoライブラリについても、MIT License、BSD License、LGPL、GPLなど、それぞれ異なるライセンスが適用されている場合があります。
     したがって、PIOArduinoを使用して作成したソフトウェアを公開したり、製品に組み込んで配布したりする場合には、PIOArduino本体のライセンスだけでなく、実際にプログラムへ組み込んでいるフレームワークやライブラリなどについても、それぞれのライセンス条件を確認する必要があります。
     このように、PIOArduino自体はApache License 2.0で提供されているオープンソースの開発環境ですが、「PIOArduino自体のライセンス」と「PIOArduinoを利用して作成したプログラムに関係するライセンス」は分けて考えることが重要です。特に、作成したプログラムを第三者へ配布する場合には、使用しているフレームワークやライブラリを確認し、それぞれのライセンス条件に従う必要があります。

     
     
    コンピュータエンジニア。ネットワークデバイス開発のため、ハード・ソフト・無線ネットワーク関係で趣味の開発、おもしろいデバイスの収集等で遊んでいます。

    あなたへのおすすめ