3-2 最初の起動と設定 (2) プロジェクト用ディレクトリを指定してソースファイル編集
次に、プロジェクト用のフォルダを選択します。[File]メニューの[Select Folder]で選択します。
以上で設定したコンパイラ環境パスや、プロジェクトフォルダの指定などは、ツール終了時に記憶され、
次回起動時は、この設定の継続ができます。（設定はappconf.txtに記憶されます）
3-3 ソースファイル編集、ビルド操作（.hexファイルを作る）
上記で、「umehoshiEdit」の中にある「samples」の中の「1_sample」を選択し、左に出現した
リストの[1.c]をダブルクリックした画面が次のイメージです。
(このプログラムは、LED1の点灯のON⇔OFFと、CN6,CN7の電圧の正⇔負の電圧印加を、実行ごとに切り替えるプログラムです。)
#include <xc.h>
#include "common.h"
__attribute__((address( 0x80005000 ))) void test (void);
void test()
{
PORTBCLR = 0b0110000000001100;// PORTBのB14,B13,B3,B2のビットを0
if( _RB15 == 1 ) {// D1 LED が点灯しているか？
PORTBCLR = 0x8000; // D1 LED 消灯(RB15を0)
PORTBSET = 0b0010000000001000;// RB13,RB3を1
} else {
PORTBSET = 0b1100000000000100;// RB15,RB14,RB2を1
}
_send_string("Turn LED1\r\n");
}
__attribute__((address( 0x80006000 ))) void test2 (void);
void test2(){
PORTBCLR = 0b0110000000001100;// PORTBのB14,B13,B3,B2のビットを0
}
左側リストビュー内のファイルをダブルクリックすることで、そのファイルを中央の編集画面に表示します。
拡張子が[.c]または[.S]のソースファイルを編集画面に表示している状態で、
[Build]メニューの[Build]項目を選択で、ビルドします。
これで、ビルドした時の情報がウインドウ下部の[mesage]タブに表示されます。以下はビルドが成功した画面です。
（エラーは、この[mesage]タブの表示内容から判断してください。）
この実行で、「1.c.bat」が作らて、それを内部で実行し、
「1.s」→「a.lst」,「a.o」→「a.map」,「a.elf」→「a.lst.txt」と生成します。
そして「a.lst.txt」から「1.c.hex」が作られます。
この「1.c.hex」が[UMEHOSHI ITA]に転送する専用のHEXファイルです。
（この過程で作られるa.lst,a.o,a.map,a.elf,a.lst.txtは、一時的なファイルで、他のソースのビルドで上書きされます。
各ファイルに興味がある方は、「1.c.bat」内容と[コンパイラ環境]フォルダ内のドキュメントをご参照してください）
「umehoshiEdit」ツールの左側リストビューのルートをダブルクリックすると、リストビューで見えるようになります。
（上記例で、1_sampleのフォルダをダブルクリックで、1.c.hexなどが見えるようになっています）
(下記イメージの16進数群の値は、バージョンによって変わる可能性があります)
この出来上がった「1.c.hex」を、USB接続した「UMEHOSHI ITA」に転送して動かすことになります。
3-4 「ビルドでできた.hexファイル」を[UMEHOSHI ITA]にUSBを介して転送
（USB接続設定は、「umehoshiEdit」ツールの起動後に1回行うだけで、次の転送時には必要ありません。）
まず、「umehoshiEdit」ツールを動かいているPCと「UMEHOSHI ITA」をUSBで接続します。
そして、デバイス マネージャー（エクスプローラのPC右クリックより）を次のCOMポートの確認します。
(これは、115200bps Parity無し 8bit 1StopBits 固定のシリアルポートです。)
上記例では、USB Serial Port(COM3)が確認できます。
それに合わせて、「umehoshiEdit」ツールのUSBポートの選択設定を次のように行います。
[communication]メニューの[Check COM]項目を選択で、使えるCOMポートをサーチする。
上記に続いて、デバイス マネージャーで確認したCOMポートを選択します。この例では、COM3を選択しています。
上記で正しく選択できれば、このCOMポートを介して、
「UMEHOSHI ITA」にプログラムやデータやコマンドなどの転送、
「UMEHOSHI ITA」内のメモリ内の所得、
メモリ内の絶対アドレスを指定して、その関数を起動呼び出すことができます。
「UMEHOSHI ITA」へのプログラム転送は、そのファイルを中央の編集画面に出す必要があります。
そして、[communication]メニューの[Hex Send]項目を選択します。
「UMEHOSHI ITA」のデフォルトでは、受信した文字を送り返すエコーモードになっています。
そして、「umehoshiEdit」ツールは受信した情報を下部の[Communication]タグに表示します。
この受信情報の例が上記イメージで表示されています。
Sから始まる文字列が、「UMEHOSHI ITA]へ送る指示のコマンド文字列です。
それがエコーモードで表示しています。このコマンドの応答としてSETから始まる文字列を受信しています。
なお、簡単に意味を説明します。
S10800050B000446B827C206162A421E8C0030400BE8F64
これは、S10で16個のデータが続くことを意味する命令で、種別を表す2文字、
続く800050B0が設定開始の絶対アドレス、
その次に16個のデータが並んでいます。
詳細は、UMEHOSHI IT] 基板のテスト用プログラム仕様を参照してください。
なおこのメモリ設定命令の実行に対して、[UMEHOSHI ITA]基板の応答情報がSET:800050B0です。
3-4 [UMEHOSHI ITA]のメモリ内で、指定アドレスの関数を呼び出す。(実行させる)
上記のC言語ソースで次の記述がありますが、これはtest関数の配置を絶対アドレス0x80005000に設定する指示です。
__attribute__((address( 0x80005000 ))) void test (void);
void test()
{
この関数testを呼び出し実行する場合は、[communication]メニューの[Command exec]項目を選択します。
これでメニューバーのすぐ下の箇所に、「Execute Address」の入力欄と、「Execute」ボタンが現れます。
この入力欄に関数絶対アドレスの0x80005000を入力して「Execute」ボタンを押したイメージを下記に示します。
D1のLEDを半田付けしている場合、それに繋がっているのが「_RB15 」のポートです。
_RB15 = ! _RB15; // 反転
のコードは、
「Execute」ボタンを押すと、LEDが消灯していれば点灯し、点灯していれば消灯と、
押すごとに切り替えする命令です。
（「Execute」ボタンを何度かクリックして、その都度LEDの状態が変わります。同様にモータの切り替えも行っています。）
なお、上記の「Communication」のメッセージでR00800050000061を送っているのが分かります。
またSTART:80005000のメッセージが実行時の応答メッセージです。
なお、ビルドによってどんなマシン語が生成されているかを 確認することができます。
ビルドが成功している場合、「a.lst.txt」のファイルにアセンブラとマシンコードが記録されます。
上記のC言語ソースの場合のtest関数の先頭アドレス部分を確認しているイメージを下記に示します。
【4】umehoshiEditを使ったプログラミング
[umehoshiEdit]には、新規プロジェクトを作る機能は用意しておりません。
最終的には、[UMEHOSHI ITA]に埋め込む転送用ファイル「拡張子.hex」を作ることが目標です。
そして、一つのソースファイル（.cまたは.S）に対して、一つのUME用HEXファイルがビルドで作られることになります。
なお、UME用HEXファイルは、ソースファイルの名前に「.hex」が付いた名前で、ソースと同じフォルダ内に生成されます。
その意味で、一つの作品用に一つのフォルダを用意して、その中にソースファイルを置いて、ビルドでそのフォルダ内にUME用HEXファイル
を生成させるのがよいでしょう。
[umehoshiEdit]には、フォルダを作る機能はないので、環境内に存在している[samples]内の適当な既存のプロジェクト用フォルダを複製して
、自身のプロジェクト用に名前を変更して使うのが良いでしょう。
なお、複製したプロジェクト用フォルダ内に
「common.h」と「mylinkerscript.ld」のファイルがありますがこの２つのファイルは、
ビルドで必要なファイルなので削除や変更しないように注意してください。
以下に各サンプルの説明に対するリンクを示します。
「テスト・ウメ・フラッシュ」をどのように利用して、
「ウメ・エディットプログラム」を
作るかの解説で、「umehoshiEditツール」の使用例を示しています。
各サンプルは、[
samples.zip]からダウンロードできます。
