この記事はeeic Advent Calendar 2016 20日目の記事 その1 です．（その2）
（※12/20 1:10 追記）

はじめに

ここでは，マイコンプログラミング入門について書こうと思います．
EEIC（東京大学工学部電気電子工学科・電子情報工学科）では，主に2つの言語を扱います．

C言語
Verilog HDL

また，BDMと呼ばれる製作課題などで，Arduino，ラズパイを使う人が多く，さらにFPGAを扱う実験もあり，ArduinoやFPGAは触ったことがある，という人が多いのではと思います．

さて，私がEEICに入った後，実験にも講義でも扱うことがなく不思議に思ったのが，マイコンプログラミングです．
高専時代，ロボコンに出場する団体に入りマイコンプログラミングの面白さから電気系に入った身としては，マイコンを触ってないのに，大して使い慣れていないVerilogHDLを使っていきなりCPUを作る実験とかあるのですごいなぁと思います．

以上の理由が，マイコンプログラミング入門という記事を書いてみようと思ったきっかけです．

※注意
以下では，マイコンを実際に試してみようということで，Nucleoというマイコンの評価キットのための環境構築について説明します．
環境構築の説明は非常に長いので，必要がないという方は，その2の方をごらんください．

マイコンの選定

私が初めてマイコンに触ったのは，高専でロボコンを始めた時で，その時はH8マイコンという，今はルネサスエレクトロニクスが作っているマイコンを使いました．おそらく授業で使わなくなったマイコンをもらっていたのだと思います．

「電子工作」とかで検索すると，Arduino以前は PICマイコン という，Microchipが作っているマイコンがよく出てきていましたが，今やトラ技ですら特集で扱わなくなってしまいました．トラ技，最近ラズパイ特集が多いですよね…

Arduinoの本体は，Atmelが作っている AVRマイコン というものです．Atmelは上述のMicrochipに買収されましたが…
しかし，AVRを直にかけるようになっても，「Arduinoでよくない？」となってしまいそうなので，今回は見送りました．

さて，もうひとつ選択肢があり，それがソフトバンクによる買収で話題になったARMマイコンです．
ARM社はマイコンを作っているのではなく，設計仕様書を作っています．ICメーカ各社は，ARMから設計図を購入して，それに独自技術を追加してICを製造しています．それらをまとめて ARMマイコン と呼んでいます．[1]

たくさんあるARMマイコンの中で，入手しやすく，安価に使えるものはないかと調べたところ，ありました．

STマイクロエレクトロニクスが製造している， STMマイコン の評価キットである，「Nucleo」というボードです．

秋月電子通商でも，1500円という値段で購入できます．さらに，ST-LINKというライタ・デバッガも付属しています．

マイコンを扱う上で障壁となるのが，ライタとデバッガです．
例えば上で述べたPICマイコンは，マイコン単体は数百円で購入できるのですが，肝心のライタ・デバッガが6000円近くします．

一方こちらは1500円でコミコミです．
さらにスペックもPICマイコンより上です．

環境構築

それでは，STMマイコンを扱う上で，必要な環境を構築していきます．
環境構築は，次のサイトを参考にさせていただきました．

これらのリンクは双方Windows環境のため，ほとんど同じですがMac版として以下に手順を書いておきます．
差別化としては，画像を多めに貼ったつもりです．

1. Eclipseのインストール

IDEとしては，Eclipseを使います．

https://eclipse.org/downloads/

からダウンロードし，インストールします．

2. C/C++ Development Tools のインストール

次に，Eclipse内のプラグインをインストールしていきます．
メニューのHelpを選択し，Install New Softwareをクリックします．

出てきた画面のWork withの欄に，"CDT"と入力すると，候補が出てくるので，新しい方を選択し，次のものを選択し，Nextを押します．
特に変更はないので，そのままインストールします．

3. GNU ARM plugin のインストール

次に，ARMの開発用のプラグインであるGNU ARM Pluginをインストールします．Eclipse上でARM向けにコンパイルするためのツール集です．
Install New Softwareで出てくるウィンドウに，

Name: GNU ARM Eclipse Plug-ins
Location: https://sourceforge.net/projects/gnuarmeclipse/files/Eclipse/updates/

と入力します．
GNU ARM Eclipse Plug-ins を選択して，次の画像のものにチェックを入れインストールします．一応全てインストールした方がいいかもしれません．

（アイコンの色が違うのは，すでに私の環境ではインストール済みなためです）

4. GCC ARM Toolchainのインストール

ARMプロセッサのコンパイラ，デバッガです．
https://launchpad.net/gcc-arm-embedded/+download にアクセスし，対応するバージョンをインストールします．
今回はMacの環境なので，gcc-arm-none-eabi-5_4-2016q3-20160926-mac.tar.bz2をダウンロードし，解凍します．

解凍したファイルは，適当な場所に配置します．今回は，

/usr/local/gcc-arm-none-eabi-5_4-2016q3/

に配置しました．このパスは後で必要になるので，覚えておきます．

（Windowsの場合，Build Toolのインストールが必要みたいです．詳細は参考のリンクを参照してください）

5. OpenOCDのインストール

次に，OpenOCD (Open On Chip Debugger) をインストールします．こちらは書き込みなどに用いるデバッガソフトウェアです．
https://github.com/gnuarmeclipse/openocd/releases のリンクから，対応するバージョン（今回はgnuarmeclipse-openocd-osx-0.10.0-201610281609-dev.pkg）をインストールします．
インストーラを実行すると，/Applications/GNU\ ARM\ Eclipse/OpenOCD/にインストールされます．

6. ST-LINKのファームウェアアップグレード

http://www.st.com/ja/embedded-software/stsw-link007.html の一番下，Get Softwareからダウンロードします．
ダウンロードには会員登録かメールアドレスが必要となります．

いよいよここでNucleoボードをPCに接続します．
先ほどダウンロードしたフォルダを解凍した後，AllPlatforms/STLinkUpgrade.jarを実行します．

Eclipse上でプログラミング

お疲れ様でした．もう少しです！（うまくいっていればですが…）
ここから先も，http://qiita.com/Ted-HM/items/760759b6b152230b48a8#eclipse%E3%81%AE%E8%A8%AD%E5%AE%9A を大きく参考にしています．
ここでは，要点をまとめたいと思います．

1. プロジェクトの作成

次の画像のように，~~C++ Project~~ C Project (※12/20 1:10 追記，次の画像とは違うので注意）を選択します．

次に，

ProjectName（任意）
ProjectType: STM32F10x C/C++ Project
Toolchains: Cross ARM GCC

としてNextを押します．

しばらくは（ほとんどの場合）変更はいらないはずなので，Nextを押していきます．
最後のこのページでは，先ほどGNU ARM Toolchainをインストールしたパスを指定しまう．今回は/usr/local/gcc-arm-none-eabi-5_4-2016q3/bin/となります．

2. OpenOCDの接続テスト

Run -> External Tools -> External Tools Configration...
を選択します．

表示された画面で，左上の新規作成アイコンを押し，Name, Location , Working Directory, Argumentsを次のように入力します．

Name: 任意（例えばnucleo_OpenOCD）
Location: ${openocd_path}\${openocd_executable}
Working Directory: ${openocd_path}\..\scripts
Arguments: -s "${openocd_path}\..\scripts" -f board/st_nucleo_f103rb.cfg

別のタブに移動し

Buildタブ: Build before launchのチェックを外す
Commonタブ: Display in Favorites Menuにチェック

を行います．あとは，Apply -> Closeで大丈夫です．

さて，OpenOCDを起動させてみます．
Run -> External Tools -> nucleo_OpenOCDか，
画像のように下三角ボタンから選択し，起動します．

すると次のようにコンソール画面に赤文字が表示されると思います．（これは環境によって異なるかもしれません）

TargetVoltageが表示されていれば，正しく起動できていると思います．
これで確認は終了なので，コンソール画面の右上にある赤い四角ボタンを押して終了し，×ボタンを押して消去しておきます．

3. デバッグ設定

さて，この設定が終われば，ついにマイコンにプログラムを書き込むことができます．

まずは，プロジェクトをビルドしておきます．MacではCmd+Bで，またはProject -> Build Allからビルドできます．
おそらくエラーは出ないはずです．

Run -> Debug Configrationを選択します．

右の"GDB OpenOCD Debugging"を選択して，左上の新規作成ボタンを押します．そしたら，

Mainタブ
- Name: 任意（ここではnucleo_Debug）
- Project: Browseから先ほど作成したプロジェクトを選択
- C/C++ Application: Search Projectから作成したプロジェクト名のelfファイルを選択
Debuggerタブ
- Executable: ${openocd_path}/${openocd_executable}
- GDB Port: 3333
- Telnet Port: 4444
- Config Options: -s "${openocd_path}/../scripts" -f board/st_nucleo_f103rb.cfg
Commonタブ
- Display in favorites menuのDebugにチェック

と設定します．Apply -> Closeで終了します．
私の環境ではこれで動作しましたが，うまくいかない場合，http://qiita.com/Ted-HM/items/760759b6b152230b48a8#eclipse%E3%81%AE%E8%A8%AD%E5%AE%9A のサイトに詳しい説明があるので，試してみてください．
画像を示します．

4. 書き込みテスト

それでは，いよいよ書き込みを行います．
BuildAll（Cmd+B）を実行し，虫のようなアイコンの下三角を押し，
先ほど設定したデバッガを実行します．ここではnucleo_Debugです．

うまく実行されれば，Perspectiveを変更しますか？と聞かれるのでYesと答えて，次のようにデバッグ専用の見た目に変化します．

ここまできたら，左上の右三角の実行ボタンを押せば，

Hello ARM World!
System clock: 72000000 Hz
Second 1
Second 2
Second 3
…

とコンソールに表示されるはずです．成功です．おめでとうございます．

この画面では，左上の一時停止ボタンを押せば一時停止されますし，停止ボタンを押せば終了します．
ソースの行番号をクリックすればブレークポイントも設定できます．
コンソール右上の停止ボタン，×ボタンを押せばデバッガは終了し，元の見た目に戻したければ，画面右上のC/C++と言う名前のボタンを押せば元に戻ります．

さて，プログラムは動いたのですが，本当はこのプログラム，LEDも点滅するはずです．BlinkLED.cとかあるんでそう思いますよね．
LEDが光らないのは，どうやら設定されているピン番号が違うかららしいです．
右のProjectExplorerから，プロジェクト名 -> src -> BlinkLed.cpp -> BlinkLed.hを選択すると，BlinkLed.cppの中の#include "BlinkLed.h"の部分にハイライトがかかるので，右クリック -> Open DeclarationでBlinkLed.hが開きます．
19行目と20行目を次のように修正します．
LEDはPORTAの5番に接続されているようなので，そのように変更します．

#define BLINK_PORT_NUMBER (0)
#define BLINK_PIN_NUMBER (5)

先程と同様にBuildAllからDebugで書き込むと，ボード上のLD2が点滅していることがわかります．
これで LEDチカチカ ，いわゆる 電子工作におけるHello World ができました．

終わりに

ここまでで，Nucleoボードの環境構築が終了しました．
その2では，いよいよ 伝統的な マイコンプログラミングを行なっていきたいと思います．

その2

参考文献

[1] 『トランジスタ技術2011年3月号合点! ARMマイコン超入門』CQ出版

Arduino未満，HDL以上．〜マイコンプログラミング入門 その1 環境構築編〜