NUCLEO-F401RE で TOPPERS/ASP3(RTOS)を動かす

はじめに

Windows上でEclipseベースのTrueSTUDIOを用いて．RTOSであるTOPPERS/ASP3カーネル(以下，ASP3カーネル)をNUCLEO-F401REで動作させる方法について説明します．

一般的に，WindowsでASPカーネルのビルドするには，Cygwin環境，クロスコンパイラ，デバッガを別々にインストールする必要があり環境構築の手順が煩雑でした．TrueSTUDIOは，ASPカーネルに必要なツール類がまとめてインストールできるため，環境構築の手間が省けます．

基本的にはこちらの記事のASP3版です．一部画像はASPのものを使用しているのでご了承下さい．

用意するハードウェア

• NUCLEO-F401RE

• 秋月電子やスイッチサイエンス等から2000円程度で購入可能です．amazonでポチるのが最も簡単な入手方法です．

• 様々な種類がリリースされていますが，現状はF401REのみをサポートしています．STM32F4シリーズを搭載しているNUCLEOなら簡単にポーティング可能です．ポーティング方法は別途記載します．

• USB(miniB)ケーブル

• ボードには付属していないので用意して下さい．

• Windows PC

• Windows7とWindows10で動作を確認しています．

#ソフトウェア

• TrueSTUDIO

• v7.0.1 で動作確認しています．これより古いバージョンは問題が発生する可能性があります．

• Atollicのサイトにアクセスすると**DOWNLOAD NOW!**というボタンがあるので押すとダウンロードが始まります．サイズが1G程度あるので注意して下さい．

• ダウンロード後インストールして下さい．

• Ruby

• ASP3からコンフィギュレータがRubyで記述されているため必要になります．

• RubyInstaller for windowsを使いました．

• インストールの際にPATHを通すかのチェックボックスがあるのでチェックします．

• TOPPERS/ASP3カーネル
• 上記リンクからasp3_nucleo_f401re_gcc-20170113.zipをダウンロードして展開して下さい．

ビルド&実行の手順

1.TrueSTUDIOを実行

TOPPERS/ASPカーネルに含まれているTrueSTUDIOのプロジェクトファイルをエクスプローラからダブルクリックしてTrueSTUDIOを起動します．

asp_3.1.0\target\nucleo_f401re_gcc\truestudio\asp.cproject

TrueSTUDIOが起動するとワークスペースの指定画面が表示されるため適当なワークスペースを指定する．.cprojectのフォルダの一つ上のフォルダを指定すると管理が楽です．.cprojectと同じフォルダは指定しないで下さい．

3秒ほど宣伝画面が出るので"ウィンドウを閉じて下さい"のボタンが有効になるまで待って，有効になったらボタンを押して下さい．

左上のInformation Centerの右の×ボタンを押すとプロジェクトが表示されます．

左のペインのプロジェクトビューからaspを選択し，ツリーを展開するとサンプルプログラムとASPカーネルの各ファイルを見ることができます．

2.ビルド

ビルドボタンを押すとビルドが開始されます．

3.ボードの接続

NUCLEO-F401REをUSBケーブルでwindowsPCに接続して下さい．ドライバのインストールが開始され，COMポートが１つ追加されます．

4.ダウンロード&実行

ボードの接続後，デバッグボタンを押すとダウンロードが開始されます．

1回目はSTLINKのファームウェアのアップデートが発生する場合があります．その場合は，画面に従ってファームウェアをアップデートしてから，USBケーブルを一旦外してから，Teratermの再接続を行い，デバッグボタンを押して下さい．

次に上記で追加されたポートに対して，ターミナルを開きます．メニューのビューからターミナルを選択します．左下ペインにターミナルが追加されるので，接続ボタンを押して，接続タイプをシリアルとして，115200bps, 8bit, Parity none, Stop 1bit, フロー制御なしとてしてOKを押します．

ダウンロード後停止した状態なので，メニューから"再開"ボタンを押すとカーネルが起動して，main_taskの先頭で停止します．この状態で"再開"ボタンを押すと実行が再開されます．

ターミナルにはログが出力されます．入力も可能です．

#新規プロジェクト

新規にプロジェクトを作成する場合はフォルダtruestudioをコピーしてtruestudio2等に名前を変更します．

次にtruestudio2以下のaspの.cprojectを開いた場合にワークスペースの指定画面が出るのでtruestudio2を指定します．

あとは最初に書いたようにビルドが可能です．

#プロジェクトへのファイルの追加

例えばpoi.cをビルド対象としたい場合には，poi.cをプロジェクトファイル(sample1.c)があるフォルダに置いて，Makefileに以下の様に記載すればよいです．

#
#  アプリケーションプログラムに関する定義
#
APPLNAME = sample1
APPLDIR = 
APPL_CFG = $(APPLNAME).cfg

APPL_DIR = $(APPLDIR) $(SRCDIR)/library
APPL_ASMOBJS =
ifdef USE_CXX
  APPL_CXXOBJS = $(APPLNAME).o 
  APPL_COBJS =
else
  APPL_COBJS = $(APPLNAME).o  poi.o
endif

sample1.h/sample1.h/sample1.cfgの名前を変更したい場合は，MakfileのAPPLNAMEを変更すればよいです．

おわりに

TOPPERS/ASP3カーネル(以下，ASP3カーネル)を手軽にビルド＆実行する方法について説明しました．是非ASP3を試して見てください．