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強磁性CPAPICOPアンプecalj常微分方程式モンテカルロ解析状態密度トランジスタodeDOSインターフェース定電流スイッチング回路PDS5022半導体シェルスクリプト分散関係レベルシフト乱数HP6632AR6452A可変抵抗トランジスタ技術温度解析ブレッドボードI2C反強磁性確率論数値積分セミナーバンドギャップバンド構造偏微分方程式非線形方程式ソルバ熱設計絶縁ISO-I2Cカオス三端子レギュレータLM358GW近似マフィンティン半径A/DコンバータフォトカプラシュミットトリガLEDPC817C発振回路数値微分直流動作点解析サーボカレントミラーTL431アナログスイッチUSB74HC4053bzqltyVESTA補間電子負荷アセンブライジング模型BSch量子力学単振り子2ちゃんねるチョッパアンプLDA開発環境基本並進ベクトルFFT標準ロジックブラべ格子パラメトリック解析抵抗SMPMaxima失敗談ラプラス方程式繰り返し位相図スイッチト・キャパシタ熱伝導状態方程式キュリー温度gfortranコバルトTLP621不規則合金Quantum_ESPRESSO六方最密充填構造ランダムウォーク相対論ewidthスピン軌道相互作用FETQSGWVCAcygwinスレーターポーリング曲線GGA仮想結晶近似PWscfシュレディンガー方程式LM555ハーフメタル固有値問題NE555最小値ガイガー管QNAPUPS自動計測ダイヤモンドマントルTLP552格子比熱最適化MCU井戸型ポテンシャル最大値xcrysdenCIF条件分岐詰め回路フェルミ面差し込みグラフスーパーセルfsolveブラウン運動awk過渡解析起電力三角波第一原理計算FXA-7020ZRWriter509Ubuntuテスタ熱力学データロガーTLP521OpenMPubuntu平均場近似MAS830LトランスCK1026PIC16F785PGA2SC1815EAGLEノコギリ波負帰還安定性ナイキスト線図MBEOPA2277P-10フィルタCapSenseAACircuitLMC662文字列固定スピンモーメントFSMTeX結晶磁気異方性全エネルギーc/a合金multiplotgnuplot非線型方程式ソルバL10構造正規分布等高線ジバニャン方程式初期値interp1fcc面心立方構造ウィグナーザイツ胞半金属デバイ模型電荷密度重積分SIC二相共存磁気モーメント不純物問題PWgui擬ポテンシャルゼーベック係数ZnOウルツ鉱構造edeltquantumESPRESSOフォノンリジッドバンド模型スワップ領域BaO岩塩構造ルチル構造ヒストグラム確率論マテリアルデザインフラクタルマンデルブロ集合キーボードRealforceクーロン散乱三次元疎行列縮退化学反応関数フィッティング最小二乗法Excel直流解析PCTS-110TS-112日本語パラメータ・モデル等価回路モデルcif2cell入出力陰解法熱拡散方程式HiLAPW両対数グラフCrank-Nicolson法連立一次方程式specx.fifort境界条件片対数グラフグラフの分割円周率ヒストグラム不規則局所モーメントGimpシンボル軸ラベル凡例線種トラックボール

最新コメント
リンク

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