PICアセンブラコードのファイルを分割する ~番外編:インクルードファイル~

この文章は前回の話
http://blogs.yahoo.co.jp/gomisai/1662572.html
の続きです。今回は必須ではありませんが、コードを分割したときに複数のファイルで共通の定数を定義するときに便利な擬似命令INCLUDEと、定数の定義に使うDEFINE擬似命令やEQU擬似命令について書きたいと思います。

インクルードファイルと言えば、ほとんどの人がMPLAB IDEをインストールするとついてくる標準のインクルードファイルのお世話になっていると思います。ソースコードのはじめのほうに書き込んでいる

        INCLUDE "P16F84A.INC"

とかのことです。

INCLUDE擬似命令
はじめてPICのプログラムを書き方を習ったときにはおまじないと覚えた人も多いINCLUDEですが、いま、ちゃんと意味を確認しておきましょう。MPASM Assembler Helpには次のように書かれています。

#include - Include Additional Source File
Syntax
Preferred:
#include include_file
#include "include_file"
#include <include_file>

Supported:
include include_file
include "include_file"
include <include_file>

Description
The specified file is read in as source code. The effect is the same as if the entire text of the included file were inserted into the file at the location of the include statement. Upon end-of-file, source code assembly will resume from the original source file. Up to 5 levels of nesting are permitted. Up to 255 include files are allowed.

If include_file contains any spaces, it must be enclosed in quotes or angle brackets. If a fully qualified path is specified, only that path will be searched. Otherwise, the search order is:

* current working directory
* source file directory
* MPASM assembler executable directory

 ~ 後略 ~

正確な意味は自分で原文を訳してもらうとして、要点はINCLUDEで指定したファイルの内容がINCLUDEを書いた場所に書き込まれているのと同様にアセンブルしてくれると言うことです。

ただし、指定するインクルードファイルは
* current working directory
* source file directory
* MPASM assembler executable directory
のいずれかにおきます。自分の作ったインクルードファイルの場合source file directoryつまり、INCLUDEで呼び出す側のファイルと同じディレクトリに置くのが普通でしょう。

このようにインクルードファイルに分離したいものとはいったいどんなものがあるでしょうか?さしあたって私がインクルードファイルにまとめて書いているのは以下のようなものです。
* 各ファイルで共通する定数
* 各ファイル中で各回路ごとに編集する部分
* マクロ

各ファイルで共通する定数
真っ先に思い浮かぶのは使っているクロックの周波数でしょうか?タイミングを作る必要のあるルーチンを書く際にクロック周波数を参照するように書いておくと後々使い回しが楽です。
後は電源電圧かなぁ・・・ADCのリファレンスに電源電圧を使っているときや、R-2Rラダー抵抗によるDACとか・・・どちらにしろ精度がいるときには、ちゃんと外部にリファレンスを準備しないといけないから・・・うーん。

各ファイル内で各回路ごとに編集する部分
ケースバイケースかもしれませんが、ひとつのファイル内でしか使わない定数もインクルードファイルにまとめてしまったほうが面倒ごとが減るかも知れません。具体的に言うと外部回路と接続する端子名などです。例えば電子工作の定番であるキャラクタLCD
http://akizukidenshi.com/catalog/items2.php?p=1&q=%22P-00038%22
を接続する場合、

#DEFINE         LCD_E   PORTA,D'0'
#DEFINE         LCD_RS  PORTA,D'1'
#DEFINE         LCD_RW  PORTA,D'2'

のように端子の配置を#DEFINEで定義してしまえば、回路が変わってもこの定義部分だけを変更すれば対応できます。分割したファイルの先頭で定義してもよいのですが、この部分だけを取り出したファイルをひとつ作れば編集しなければならない部分が減ります。

マクロ
マクロと言うのはMACRO擬似命令で作成するマクロのことです。
頻繁に使うマクロはライブラリにしてひとつのインクルードファイルにすると便利でしょう。



comment

Secret

FC2カウンター
カテゴリ
ユーザータグ

LTspiceAkaiKKRmachikaneyamaScilabKKRPSoC強磁性OPアンプPICCPA常微分方程式モンテカルロ解析ecaljodeトランジスタ状態密度インターフェースDOS定電流スイッチング回路PDS5022半導体シェルスクリプトレベルシフト乱数HP6632AR6452AI2C可変抵抗分散関係トランジスタ技術ブレッドボード温度解析反強磁性確率論バンドギャップセミナー数値積分熱設計非線形方程式ソルババンド構造絶縁偏微分方程式ISO-I2CLM358フォトカプラ三端子レギュレータカオスLEDシュミットトリガGW近似A/Dコンバータ発振回路PC817C直流動作点解析USBマフィンティン半径数値微分アナログスイッチTL43174HC4053カレントミラーサーボ量子力学単振り子チョッパアンプ補間2ちゃんねる開発環境bzqltyFFT電子負荷LDAイジング模型BSch基本並進ベクトルブラべ格子パラメトリック解析標準ロジックアセンブラ繰り返し六方最密充填構造SMPコバルトewidthFET仮想結晶近似QSGW不規則合金VCAMaximaGGA熱伝導cygwinスレーターポーリング曲線キュリー温度スイッチト・キャパシタ失敗談ランダムウォークgfortran抵抗相対論位相図スピン軌道相互作用VESTA状態方程式TLP621ラプラス方程式TLP552条件分岐NE555LM555TLP521マントル詰め回路MCUテスタFXA-7020ZR三角波過渡解析ガイガー管自動計測QNAPUPSWriter509ダイヤモンドデータロガー格子比熱熱力学awkブラウン運動起電力スーパーセル差し込みグラフ第一原理計算フェルミ面fsolve最大値xcrysden最小値最適化ubuntu平均場近似OpenMP井戸型ポテンシャルシュレディンガー方程式固有値問題2SC1815結晶磁気異方性OPA2277非線型方程式ソルバTeXgnuplot固定スピンモーメントFSMPGAc/a全エネルギーfccフラクタルマンデルブロ集合正規分布縮退初期値interp1multiplotフィルタ面心立方構造ウィグナーザイツ胞L10構造半金属二相共存SICZnOウルツ鉱構造BaO重積分クーロン散乱磁気モーメント電荷密度化学反応CIF岩塩構造CapSenseノコギリ波デバイ模型ハーフメタルキーボードフォノンquantumESPRESSOルチル構造スワップ領域リジッドバンド模型edelt合金等高線線種凡例シンボルトラックボールPC軸ラベルグラフの分割トランス文字列CK1026MAS830L直流解析Excel不規則局所モーメントパラメータ・モデル入出力日本語最小二乗法等価回路モデルヒストグラムGimp円周率TS-110TS-112PIC16F785LMC662三次元specx.fifortUbuntu疎行列不純物問題Realforceジバニャン方程式ヒストグラム確率論マテリアルデザインP-10境界条件連立一次方程式熱拡散方程式AACircuitHiLAPW両対数グラフ片対数グラフ陰解法MBEナイキスト線図負帰還安定性Crank-Nicolson法EAGLE関数フィッティング

最新コメント
リンク

にほんブログ村 その他趣味ブログ 電子工作へ