.. _00_pre2025:

事前準備 (2026年度)
==============================================================================

`M5StickC Plus2 <https://www.switch-science.com/products/9350>`_ に、プログラムを書き込むには、
おもに以下の方法があります。

1. Arduino IDE
#. arduino-cli (Command-Line Interface) 
#. PlatformIO 

2024年度は `2. の方法 および 独自プログラムIoTP <https://cit.istlab.info/m5stickcplus/pre2023.html>`_ を用いました。
2025年度も、基本的に 2. の方法で、各自のパソコンに arduino-cli を入れてもらいますが、Windowsだとやたらとビルドに時間がかかるので `講義システム <https://lattr.istlab.info>`_ を併用します。
講義システムでは、Webインタフェースで編集したコードを **サーバ上で** ビルドし、書き込み用のバイナリファイルをダウンロードできます。
複数のソースファイルやデータを含む複雑なプロジェクトを作成する場合は、`m5scp2_exe <https://git.istlab.info/miura250/m5scp2_exp>`_ のなかの FactoryTest を参考にしてください。また、`Arduino IDE <https://docs.m5stack.com/ja/arduino/arduino_ide>`_ や Visual Studio Code 等を入れてください。

.. note::  以下、Windows と MacOS の場合にわけて、動画を示しながら説明します。



Windows の場合
~~~~~~~~~~~~~~~~~

.. raw:: html

   <video controls width="640">
     <source src="_static/win_inst.mp4" type="video/mp4">
     Your browser does not support the video tag.
   </video>

1. `Git for Windows <https://gitforwindows.org>`_ → Download をクリック → Git-2.XX.X-64-bit.exe をダウンロードして、インストールしてください。Setup時にいろいろ訊かれますが、すべてそのまま「Next」を押して進めて大丈夫です。
#. Git Bash （Windowsのスタートボタンのメニュー画面でbashで検索するとでてきます）を起動して、黒い画面のターミナル（例： :numref:`fig_cli_iotinst` ）に以下のコマンドを入力してください。（この下の灰色のテキストエリアの右端の四角アイコンを押すと、コマンドをコピーできます。） ::

	git clone https://git.istlab.info/git/miura250/m5scp2_exp.git

#. git clone に成功すると、ホームディレクトリに m5scp2_exp フォルダができるので、cd します。なお、bash のおかげで、ファイル名は全部入力しなくても、``cd m5s【Tabキー】`` のように先頭数文字とタブキーで補完できます。 ::

	cd m5scp2_exp
    
#. Git Bash の黒い画面で ``python`` と入力してみてください。Pythonがインストールされていなければ、Microsoft Store画面からインストールしてください。すでにインストールされている場合は、>>> のような文字がでるので、CTRL+D で終了します。 ::

	python

#.  ``ls`` を実行して、m5scp2_exp フォルダのなかに、いくつかのシェルスクリプトファイル（〜.sh）があることを確認してください。以下のように入力して、 ``./01_download_factorytest.sh`` を実行してください。なお、bash のおかげで、ファイル名は全部入力しなくても、``01【Tabキー】`` のように先頭数文字とタブキーで補完できます。  ::

	./01_download_factorytest.sh


#.  以下のように ``./11_write_factorytest_by_esptool.sh`` を実行してください。なお、bash のおかげで、ファイル名は全部入力しなくても、``11【Tabキー】`` のように先頭数文字とタブキーで補完できます。また、以前入力したコマンドは ``上矢印キー（↑）`` で呼び出せます。 ::

	./11_write_factorytest_by_esptool.sh

	
.. _fig_cli_iotinst:

.. figure:: img/22_0323_144455.png
   :scale: 90%
   :alt: インストールスクリプト実行後の画面（例）
   :name: f_cli_iotinst

   インストールスクリプト実行後の画面（例）



Mac の場合
~~~~~~~~~~~~~~~~~~

.. raw:: html

   <video controls width="640">
     <source src="_static/mac_inst.mp4" type="video/mp4">
     Your browser does not support the video tag.
   </video>

1. `Homebrew パッケージマネージャ <https://brew.sh/ja>`_ をまだ入れていない場合は、インストールしてください。ターミナルを開き、以下のコマンドを実行します。 :: 

	/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"    


#. 続けて、ターミナルで、以下のコマンドを実行してください。 ::

	brew install git esptool 
	git clone https://git.istlab.info/git/miura250/m5scp2_exp.git
	cd m5scp2
	./01_download_factorytest.sh
	./11_write_factorytest_by_esptool.sh