AKI-SH2/7144プログラミング
Renesas HEW SuperH 9.4.0
 利用版
High-performance Embedded Workshop

Copyright(C)23Sep2011
coskx

1.はじめに

この文書は,Windows7パソコンにAKI-SH2/7144のC言語クロスコンパイル環境での,コンパイル作業のための方法を記述している。
コンパイラシステムは,RenesasHEW(High-performance Embedded Workshop)SuperH9.4.0を使う。あらかじめ指導者あるいはパソコン管理者が標準構築したHEWがインストールされている環境で,AKI-SH2/7144でプログラムが動作するまでを解説する。C言語のプログラミングについては別の文書で学んでほしい。

図1.1 AKI-SH2/7144とマザーボード

本解説中で使用しているファイルのダウンロード

FilesForHewPrg.zip

本解説中で使用している作業フォルダのダウンロード
適当な場所に解凍し,中のSH7144.hwsをダブルクリックすると,HEWが起動し,ワークスペースが現れる。
ただし,解凍されて出てくるフォルダ名は「SH7144」なので,衝突させないこと。

SH7144.zip

2.本文書で記述してある作業の特徴

HEWは大きな規模の組み込みシステムを作成することを前提にして作られているようである。学習する為の小さなプログラムを作ろうとするとかなり大げさな作業となる。できるだけデフォルトの設定でコンパクトな作業ができるようにしている。
なお,途中でPCからマイコンにファイル転送するが,これには転送ソフト「h8w.exe」を使う。

「h8w.exe」はyamasan氏のオープンツールです。次の場所から入手できます。
http://ym3.plala.jp/yamasan/

適当な場所にインストールし,h8w.exeと同じフォルダ内にフォルダ「CTRL_MOT」があることを確認しておく。
次のようなCMDファイルを作成しておく。

goH8W7144.cmd (FilesForHewPrg.zipに収録)

rem カレントドライブ・カレントディレクトリへ移動
%~d1
cd %~p1

rem ★フラッシュメモリ書き込みに使用するプログラム
set downloader="C:\Program Files\h8v2\WRITER\H8W\h8w.exe"
rem ★フラッシュメモリ書き込みのためのCOMポート番号を設定します
set ComPortNumber=1

echo [AutoPgm] >myAutoPgm.ini
echo AutoStart=1 >>myAutoPgm.ini
echo AutoExit=1 >>myAutoPgm.ini
echo CtrlProgam=7144_45_F50M_P384.MOT >>myAutoPgm.ini
echo ComPortNo=%ComPortNumber% >>myAutoPgm.ini
echo UserMotPath=%1 >>myAutoPgm.ini
echo on
%downloader% -GO .\myAutoPgm.ini
@echo off
del myAutoPgm.ini

ここで,★のついたところを,自分の環境に合わせる必要がある。
「h8w.exe」をフルパスで定義すること。


3.プログラムの作成から実行まで

シングルボードマイコンAKI-SH2/7144内で動作するプログラムはパソコン上で開発され、シングルボードマイコンAKI-SH2/7144のフラッシュメモリに書き込まれます。パソコンで開発されるソースプログラムはC言語で記述され、クロスコンパイラにより、オブジェクトプログラムに変換され、最後はフラッシュメモリ書き込み形式(XXXX.MOT)になる。
シングルボードマイコンAKI-SH2/7144を動作させるまでの大きな流れは以下のようになる。

(1)パソコン上でHEW作業用のワークスペースとプロジェクトを作る *1,*2
(2)パソコン上でHEWプロジェクト内のCソースプログラムの作成
(3) パソコン上でHEWのビルドコマンドでダウンロード形式ファイル(実行プログラム)の作成(クロスコンパイル、コード変換)
(4)パソコン上の転送ソフトによる,ダウンロード形式ファイル(実行プログラム)のAKI-SH2/7144への書き込み操作
これら四つの作業によりシングルボードマイコン内で動作させることが出来る。

*1 ワークスペース 作業用のフォルダのこと
*2 プロジェクト 1つのプログラムを作成するファイル群 ワークスペース内に作られる
   ワークスペース内に複数のプロジェクトを作ることもできるし,1ワークスペースに1プロジェクトという構成でもよい。

4.ワークスペース・プロジェクトの作成

HEWを起動すると,ワークスペースとプロジェクトの設定画面が次々と現れてくる。

(1)ワークスペースとプロジェクトの設定

SH7144というワークスペース内にLed1stというプロジェクトを設定したところ
フォルダの実体は,デフォルトでC:\WorkSpaceに作られるようになっている。
この場所にWorkSpaceというフォルダがなかったら,自分で作っておく必要がある。
ワークスペース名のフォルダC:\WorkSpace\SH7144が作られる。
ワークスペースはほかの場所に作ってもよい。

(2)CPUの設定

CPUシリーズは「SH2」,CPUタイプは「SH7144f」を設定する

(3)動作モード,アドレス空間の設定

Endian選択は「Big」を設定する

(4)自動生成ルーチンの選択

標準入出力ライブラリは使わないので,「I/Oライブラリ使用」チェックを外す
動的メモリ確保(malloc,callocなど)は当面しないので,消しておく。
Cプログラムソースを作るのでmain関数を呼び出してもらう設定にしておく。
I/Oレジスタ定義(これは)は使用するのでチェックを付ける。
ハードウェアのセットアップは,行わないのでNoneのままにしておく。
そのほかのハードウェア設定は学習用のため,あとで自分で明示的にプログラムする。

ハードウェアのセットアップは,main関数呼び出し前に行うか,main関数内で行うか,2通りの考え方がある。
ここでは,外部メモリ設定はmain呼び出し前に行い,他の設定はmain関数内で行うことにする。

(5)ライブラリの使用

当面は使わないライブラリは消しておこう。

(6)これ以降は変更しないので,この段階で「完了」ボタンを押してよい。

「完了」ボタンを押すと,「概要」が表示されるので,そのまま「OK」を押す。

 

5.Workshopでの作業

ここでWorkshopが自動的に開く。
左側の「プロジェクトペイン」のところに,最初に命名したワークペース名「SH7144」とその中のプロジェクト「Led1st」が見える。

debugはしないので,下図の右赤丸のところをdebugからreleaseに変更して,debug構成からrelease構成に変更する。

 

参考

この段階でプロジェクト「Led1st」内に自動で作られたファイルは,次の通り。

dbsct.c

各セクションのアドレスなどの変数定義。このファイルには手を付けない。

intprg.c

割り込み関数の定義をするファイル,割り込みの記述をこのファイルに書いてもよいが,
ユーザ用のCファイルに割り込み関数を書いて,このファイル内の対応する関数をコメントアウトしてもよい。

Led1st.c

ここにmain関数をはじめ,必要なプログラムを書く。

resetprg.c

マイコンに電源が投入されてから,mainを呼び出すまでのスタートアップルーチン。
mainから制御が戻ってきてもsleep関数を使って暴走しないようになっている。
このファイルには手を付けない。

vecttble.c ベクタテーブル。
iodefine.h I/Oの定義。

stacksct.h

スタックサイズの定義。このファイルには手を付けない。

typedefine.h

標準Cから拡張した型の定義。この定義を使った方が型宣言のあいまいさがなくなる。
このファイルには手を付けない。

vect.h ベクタテーブル。

6.Cプログラミング

左側の「プロジェクトペイン」のところの「Led1st.c」をダブルクリックして開いて,中身をすべて消去して,下記のプログラムを書き込む。
(コピー&ペーストしてよい。)

リスト プログラムソースファイル"Led1st.c"(FilesForHewPrg.zipに収録)

/**********************************************************
マザーボード上のLEDの1秒周期のON-OFFを行う
**********************************************************/

#include "iodefine.h"           //IOポートの定義ファイル HEWが自動生成

void msecwait(int msec)
/*msec間なにもしない時間稼ぎ関数*/
{
    int i,j;
    for (i=0;i<msec;i++) {
        for (j=0;j<12500;j++);    /*12500は実測によって求めた値 50MHz駆動時*/
    }
}

int main(void)
{
    PFC.PEIORL.WORD |= 0x0003; /* PEのbit0,bit1を出力に設定 */
    while(1){
        PE.DRL.WORD |= 0x0001; /*LED0(赤)の点灯*/
        PE.DRL.WORD &= 0xfffd; /*LED1(緑)の消灯*/
        msecwait(500);
        PE.DRL.WORD &= 0xfffe; /*LED0の消灯*/
        PE.DRL.WORD = 0x0002; /*LED1の点灯*/
        msecwait(500);
    }
}

 

7.実行形式プログラムの転送形式ファイルのビルド

Cプログラムから実行形式プログラムを作り,さらに転送形式ファイルを作る。
Workshopのビルドメニューからビルドコマンドを選択すればよい。

左下に「Build Finished」が出てくる。
このとき「L1100 (W) Cannot find "C" specified in option "start"」のような警告が出てくるが,
使用していないセクションが見つからないと言っているだけなので,無視してよい。

 

8.転送形式ファイルの転送

転送形式ファイル「Led1st.mot」が,ワークスペースフォルダ「SH7144」内のプロジェクトフォルダ「Led1st」内のフォルダreleaseにある。
これを転送プログラムでマイコンのフラシュメモリに書き込み,実行する。

フラッシュメモリ書き込み形式ファイルの作成とROMライター書き込み操作から実行までの手順

 

パソコン側

マイコンSH2/7144側

(1)  

SH2/7144のマザーボード上のモードスイッチを
 PRG MODE   : 0
 MD1        : 0
に設定してから電源スイッチをONにします。
MD0,MD2,MD3はすべて1です。
電源LEDが点灯します。

重要 電源をONしてからモードスイッチを切り替えるという逆手順では動作しません。

(2)

転送形式ファイル「Led1st.mot」を最初に作成しておいたgoH8W7144.cmdにドラッグ&ドロップする。
h8w.exeの画面が開いて転送される。

 
(3)  

<1>転送が終了したら、マザーボード上の電源スイッチをOFFにします。
<2>モードスイッチを
 PRG MODE : 1
 MD1      : 1
に設定してから電源スイッチをONにします。
MD0,MD2,MD3はすべて1です。
電源LEDが点灯します。

重要 電源をONしてからモードスイッチを切り替えるという逆手順では動作しません。

ここまでの作業が順調に出来ていたら,SH2/7144マザーボード上の2つのLEDが点滅して動作が確認できるはずです。

 

9.Workshopの終了と,再起動

Workshopを終了する。
終了した状態で,ワークスペースフォルダ「SH7144」を見ると。そのなかにプロジェクトフォルダ「Led1st」がある。
ワークスペースフォルダ「SH7144」内のファイル「SH7144.hws」をダブルクリックすると,Workshopが再起動する。
このときワークスペース「SH7144」がWorkshop上に開いている。
Led1st.cがエディタ上で開いているので,左下のLed1st.cのタグ上を右クリックして閉じておく。
「プロジェクトペイン」でLed1st.cをダブルクリックすると再びエディタで編集することができる。
最後に,ここではLed1st.cは閉じておこう。

 

10.新規プロジェクトの追加,サービス関数(sh_7144.h)の利用

ここでは,次の2つのことを行う。
A.新規プロジェクトLed2ndをワークスペースSH7144に追加すること
B.サービス関数定義が記述されたsh_7144.hの利用
  これを利用するとSH7144のポートに対する記述が隠ぺいされ,移植性の良いプログラミングができる。

注 新規プロジェクトは,別な新規ワークスペース上に作ることもできるが,それは「4.ワークスペース・プロジェクトの作成」ですでに述べた方法で作成できる。

(1)プロジェクトの構築

「8」で述べたように,ワークスペースフォルダ「SH7144」内のファイル「SH7144.hws」をダブルクリックすると,Workshopが再起動すると,ワークスペース「SH7144」がWorkshop上に開いている。
Led1st.cがエディタ上で開いている場合は,エディタ左下のLed1st.cのタグ上を右クリックして閉じておく。

「プロジェクトペイン」の一番上の「SH7144」はワークスペースを表している。
SH7144のところで,右クリックして「プロジェクトの挿入...」で,新規プロジェクトをワークスペース「SH7144」に追加することができる。
「4.ワークスペース・プロジェクトの作成」とおなじように,プロジェクトの設定画面が次々と現れてくる。

「4.(1)」のところで,ワークスペース名は「SH7144」そのままにし,プロジェクト名のみ「Led2nd」に設定し,ディレクトリ名はHEWが自動でつくるのに任せる。
「4.(2)」〜「4.(5)」までは全く同じ設定でよい。
設定が終わると,プロジェクト「Led2nd」が見えてくる。

「プロジェクトペイン」で,Led2ndの文字が強調されているが,ビルドを行うと,Led2ndがビルドされることを示している。
別な表現をすれば,Led2ndが作業対象になっているという意味だが,このことをアクティブプロジェクトと呼んでいる。
もし,Led1stをアクティブプロジェクトにしたければ,Led1stのところで右クリックし,「アクティブプロジェクトに設定」でよい。
元に戻すには,Led2ndのところで右クリックし,「アクティブプロジェクトに設定」でよい。

プロジェクトLed2ndがアクティブになっていることを確認して,
「5」とおなじように,設定する。

(2) 「sh_7144.h」(小坂のサービス関数群)の利用

FilesForHewPrg.zipに収録されている「sh_7144.h」をWindows上で,プロジェクトフォルダ「Led2nd」にコピーする。
コピーしただけでは,Workshop上に反映されてこない。
「プロジェクトペイン」の「Led2nd」を右クリックして,「ファイルの追加...」でプロジェクトフォルダ「Led2nd」内の「sh_7144.h」を追加する。
「プロジェクトペイン」のLed2nd配下に「sh_7144.h」が見えてくる。

(3)Cプログラミング

「6」と同じように操作して,「Led2nd.c」を次の内容にする。

リスト プログラムソースファイル"Led2nd.c" (FilesForHewPrg.zipに収録)

/**********************************************************
マザーボード上のLEDの1秒周期のON-OFFを行う
**********************************************************/

#include "iodefine.h" //IOポートの定義ファイル HEWが自動生成
#include "sh_7144.h"  //サービス関数群の定義ファイル 小坂が作成したもの

void msecwait(int msec)
{
    int i,j;
    for (i=0;i<msec;i++) {
        for (j=0;j<12500;j++);    /*12500は実測によって求めた値 50MHz駆動時*/
    }
}

main()
{
    initLed();  /*LED初期化*/
    while(1) {
        turnOnLed(0); /*LED0(赤)のON*/
        turnOffLed(1); /*LED1(緑)のOFF*/
        msecwait(500);
        turnOnLed(1);  /*LED1のON*/
        turnOffLed(0); /*LED0のOFF*/
        msecwait(500);
    }
}

 

「7.」と同じように,ビルドする。

「8.」と同じように,マイコンに転送し,LEDが点滅すれば成功。

 

11.割り込み処理(例外処理)の記述

ここでは,割り込み処理の記述についてのべる。

「10.」を参考に,新規プロジェクトint1stを作成する。

プロジェクトint1stがアクティブになっていることを確認して,「10(1)」〜「10(2)」まで作業を行う。


「6」と同じように操作して,「int1st.c」を次の内容にする。

リスト プログラムソースファイル"int1st.c" (FilesForHewPrg.zipに収録)

/**********************************************************
時間割り込みによってLEDのON-OFFを行う
**********************************************************/
#include "machine.h"  //低レベル関数ヘッダ   Renesasが提供 imask関連で使用
#include "vect.h"     //割り込み関数ヘッダ   INT_CMT1_CMI1が割り込み関数であることが定義
#include "iodefine.h" //IOポートの定義ファイル HEWが自動生成
#include "sh_7144.h"  //サービス関数群の定義ファイル 小坂が作成したもの

main()
{
    initLed();
    set_imask(14);                  //レベル15は割り込み許可
    initCMTInt(500000,1,15); /*500000μsec,CMT.ch1使用,割り込みレベル15*/
    startCMT1(); /* コンペアマッチタイマ1スタート */
    while(1);       /*なにもしないループ*/
}

/******************************************************
コンペアマッチタイマ割り込み関数
関数名はvecttbl.c,vect.h中で決められている
INT_CMT_CMT0はコンペアマッチタイマch0の割り込み
INT_CMT_CMT1はコンペアマッチタイマch1の割り込み
コンペアマッチフラッグのクリアを割り込み関数中で行なうこと
******************************************************/
void INT_CMT_CMT1(void)
{
    static int tick=0;
    if (tick==1) {
        turnOnLed(0);
        turnOffLed(1);
    } else {
        turnOffLed(0);
        turnOnLed(1);
    }
    tick=1-tick;
    clearCMFlag1(); /* コンペアマッチフラッグのクリア */
}

説明

割り込み関数名はHEWが決めている。この関数名が割り込み関数であることは,
vect.h中に次のように記述されている。これは変更してはいけない。
148はCPUの割り込みベクタ番号である。

// 148 CMT CMT1
#pragma interrupt INT_CMT_CMT1
extern void INT_CMT_CMT1(void);

INT_CMT1_CMI1の割り込み関数は,HEWも自動で「intprg.c」に生成している(何もしない関数が書かれている)ため,
それを消さなければ,二重定義になってしまう。
そこで,プロジェクトペインのプロジェクトintist配下に「intprg.c」を修正する。
以下のようにvoid INT_CMT1_CMI1の定義をコメントアウトする。

変更前 // 148 CMT CMT1
void INT_CMT_CMT1(void){/* sleep(); */}
変更後 // 148 CMT CMT1
//void INT_CMT_CMT1(void){/* sleep(); */}

「7.」と同じように,ビルドする。

「8.」と同じように,マイコンに転送し,LEDが点滅すれば成功。