第30回 MPLAB Code Configurator（６）〜生成されたプログラム解読〜

今回は自動生成されたプログラムの内容を解読します。

MCC生成プログラムファイルの構成

最初に、MCCが生成したプログラムファイルの構成を確認します。

MPLAB X IDEのプロジェクトフォルダを開くと、MCCが生成したファイルが確認できます。

MCCが生成したファイルは「MCC Generated Files」フォルダに格納されていて、大きく分けて次のように2種類のファイルが生成されています。

「Header Files」フォルダの「MCC Generated Files」フォルダにはヘッダファイル、「Source FIles」の「MCC Generated Files」フォルダにはプログラムファイルが格納されています。

それぞれの「MCC Generated Files」フォルダはさらにサブフォルダがあり、次のように機能ごとにファイルがまとめられています。

ファイル概要

もしお時間に余裕があるようでしたら、実際にファイルを開いて中身を確認していただくと理解が深まると思います。

systemフォルダのファイル概要

最初は「system」のファイルです。これらのファイルはヘッダファイルとプログラムファイルが1対1対応していますので、まとめて説明します。

adcフォルダのファイル概要

「adc」フォルダのファイルは、ヘッダファイルが2つ、プログラムファイルが1つで、次のような内容になっています。

生成されたコードの処理の流れ

MCCではいろいろなファイルが生成されますので、処理の流れがわかりづらいところもあります。

そこで、main関数の最初の動作から処理の流れを追っていきたいと思います。

なお、説明は要点のみとしていますので、できれば実際に生成されたファイルの中身も確認していただけると理解が深まるかな、と思います。

int main(void)
{
    SYSTEM_Initialize();

    while(1)
    {
    }
}

void SYSTEM_Initialize(void)
{
    CLOCK_Initialize();
    PIN_MANAGER_Initialize();
    ADC_Initialize();
    INTERRUPT_Initialize();
}

作成するプログラムで利用できる関数

次回の記事では「押されたスイッチに応じて、LEDをONOFF制御する」という処理を行うプログラムを、main関数のwhile文の中に書いてきいきますが、その処理で利用できる関数をMCCが生成してくれています。

プログラムでは、ADコンバータでピンの電圧を読み取り、その結果に応じてピンの出力を制御します。

そこで、これらの処理ができる関数についてまとめておきます。

ピンの出力制御など、ピンのハードウェア制御する関数はpins.h/pins.cで用意されています。

また、ADコンバータ関連の関数はadc.h/adc.cで用意されています。

それぞれのファイルで用意されている関数や、関連する変数型を説明します。

「pins.h」と「pins.c」

主な定数

ピンのハードウェアをする際に引数として指定できるように、次の定数が定義されています。

LATA5レジスタなどを使用してピンの制御をする場合は、LATA5 = 1;と書くより、LATA5 = HIGH;と書いた方がわかりやすくなりますね。

ただ、ピンのハードウェア制御は関数が用意されていますので、関数を使う方がよりわかりやすいと思います。

主な関数

ピンのハードウェア制御する関数は、関数名の先頭にMCCで設定したピンのカスタム名がついています。

例えばMCCで基本設定を行ったとき、次のようにRA5ピンのカスタム名を「Led」としました。

ピンの出力を1にするカスタム名_SetHigh()という関数が用意されていますが、RA5ピン用の関数としてLed_SetHigh()という関数が生成されています。

プログラムでは、LATA5 = HIGH;と書くより、LedSetHigh();と書いた方がよりわかりやすくなりますね。

このように、ピンを制御する関数はピンごと（ピンのカスタム名ごと）に用意されています。

主な関数に次のようなものがあります。

今回は、これらの関数を使用してLEDの制御をします。

「adc.h」と「adc.c」

ADコンバータ関連の主な定数や型、関数には次のようなものがあります。

主な定数や型

主な関数

以上で、自動生成されたプログラムについて、必要な部分の確認ができましたので、次回はこれらを利用して実際にプログラムを作成、動作確認してみます。

更新履歴