MPLAB_XC32_UG_EE.fm

Transcription

1 注意 : この日本語版文書は参考資料としてご利用ください 最新情報は必ずオリジナルの英語版をご参照願います 組み込みエンジニア向け MPLAB XC32 ユーザガイド 組み込みエンジニア向け MPLAB XC32 ユーザガイド はじめに 本書には 32 ビットデバイスと MPLAB XC32 C コンパイラ向けの 7 つのサンプルコードを掲載しています 読者にはマイクロコントローラと C 言語プログラミングに関するある程度の知識が必要です 1. LED を点灯 / 消灯させる 2. 遅延関数を使って LED を点滅させる 3. 遅延用に割り込みを使って LED を点滅させる 4. ADC を使ってポテンショメータの値を LED で表示する (MPLAB Harmony を使用 ) 5. ADC を使ってポテンショメータの値を LED で表示する (MCC を使用 ) 6. フラッシュメモリへの書き込みステータスを LED で表示する (MPLAB Harmony を使用 ) 7. フラッシュメモリの値を LED で表示する (MCC を使用 ) 補遺 A 補遺 B MPLAB X IDE 内でのコード実行ソフトウェアとハードウェアの入手先 2018 Microchip Technology Inc. DS B_JP - p. 1

2 1. LED を点灯 / 消灯させる 以下のサンプルコードは PIC32MX470F512L プラグインモジュール (PIM) を挿した Explorer 16/32 開発ボード上の LED を点灯 / 消灯します 詳細は B. ソフトウェアとハードウェアの入手先 を参照してください // PIC32MX470F512L Configuration Bit Settings // 'C' source line config statements 1.1 参照 // DEVCFG3 // USERID = No Setting #pragma config FSRSSEL = PRIORITY_7 // Shadow Register Set Priority 7 #pragma config PMDL1WAY = ON // Peripheral Module - One Reconfig #pragma config IOL1WAY = ON // Peripheral Pin Select - One Reconfig #pragma config FUSBIDIO = ON // USB USID Selection - Port Function #pragma config FVBUSONIO = ON // USB VBUS ON Selection - Port Function // DEVCFG2 #pragma config FPLLIDIV = DIV_12 // PLL Input Divider - 12x #pragma config FPLLMUL = MUL_24 // PLL Multiplier - 24x #pragma config UPLLIDIV = DIV_12 // USB PLL Input Divider - 12x #pragma config UPLLEN = OFF // USB PLL Disabled and Bypassed #pragma config FPLLODIV = DIV_256 // Sys PLL Output Divide by 256 // DEVCFG1 #pragma config FNOSC = FRCDIV // Oscillator - Fast RC Osc w/div-by-n #pragma config FSOSCEN = ON // Secondary Oscillator Enabled #pragma config IESO = OFF // Internal/External Switch Over Disabled #pragma config POSCMOD = OFF // Primary Oscillator Disabled #pragma config OSCIOFNC = OFF // CLKO on OSCO Pin Disabled #pragma config FPBDIV = DIV_8 // Peripheral Clock Divisor:Sys_Clk/8 #pragma config FCKSM = CSDCMD // Clock Switch Disable, FSCM Disabled #pragma config WDTPS = PS // WDT Postscaler 1: #pragma config WINDIS = OFF // Watchdog Timer is in Non-Window Mode #pragma config FWDTEN = OFF // WDT Disabled (SWDTEN Control) #pragma config FWDTWINSZ = WINSZ_25 // Watchdog Timer Window 25% // DEVCFG0 #pragma config DEBUG = OFF // Background Debugger Disabled #pragma config JTAGEN = OFF // JTAG Disabled #pragma config ICESEL = ICS_PGx2 // ICE/ICD Comm Channel PGEC2/PGED2 #pragma config PWP = OFF // Program Flash Write Protect Disabled #pragma config BWP = OFF // Boot Flash Write Protect Disabled #pragma config CP = OFF // Code Protect Disabled // #pragma config statements should precede project file includes. // Use project enums instead of #define for ON and OFF. #include <xc.h> 1.2 参照 #define LEDS_ON_OFF 0x 参照 int main(void) { // Port A access TRISA = 0x0000; LATA = LEDS_ON_OFF; 1.4 参照 // set all port bits to be output // write to port latch return 0; DS B_JP - p Microchip Technology Inc.

3 1.1 コンフィグレーションビット Microchip 社製デバイスは 各種デバイス機能の動作を設定する ( または有効 / 無効にする ) ためのビットを格納したコンフィグレーションレジスタを備えています Note: コンフィグレーションビットを正しく設定しないと デバイスは期待通りに ( あるいは全く ) 機能しません 設定が必要なコンフィグレーションビット特に以下の設定が必要です オシレータの選択 - ハードウェアのオシレータ回路に適合させる必要があります 正しく選択しないとデバイスクロックは動作しません 一般的に 開発ボードは高速水晶振動子を使います 以下はサンプルコードからの抜粋です #pragma config FNOSC = PRI #pragma config POSCMOD = HS ウォッチドッグタイマ - このタイマは 必要になるまで無効にしておく事を推奨します そうする事で 予期せぬリセットを防ぎます 以下はサンプルコードからの抜粋です #pragma config FWDTEN = OFF コード保護 - コード保護は 必要になるまで無効にしておきます そうする事で デバイスメモリへのフルアクセスを確保します 以下はサンプルコードからの抜粋です #pragma config CP = OFF 本書のサンプルコードとは異なる 32 ビットデバイスを使う場合 上記とは異なるコンフィグレーションビットの設定が必要になる場合があります 対応するコンフィグレーションビットの番号と機能は 各デバイスのデータシートを参照してください データシートは で製品番号を使って検索できます 各デバイスが備えるコンフィグレーションビットの詳細は MPLAB XC32 インストールディレクトリに保存されている以下のファイルを参照してください MPLAB XC32 Installation Directory/docs/PIC32ConfigSet.html コンフィグレーションビットの設定方法 MPLAB X IDE では [Configuration Bits] ウィンドウを使ってコンフィグレーションビットを表示 / 設定できます このウィンドウは メニューを Window > PIC Memory Views > Configuration Bits と選択すると開きます 図 1: [Configuration Bits] ウィンドウ 必要な設定を済ませたら コード内で pragma ディレクティブを挿入する位置 (main() より前 ) をクリックしてから [Insert Source Code in Editor] アイコンをクリックします または [Generate Source Code to Output] をクリックした後に [Output] ウィンドウ内の pragma ディレクティブをコードにコピーする事もできます 2018 Microchip Technology Inc. DS B_JP - p. 3

4 1.2 ヘッダファイル <xc.h> このヘッダファイルは ソースファイル内のコードからコンパイラ固有またはデバイス固有の機能を使えるようにします xc.h とその他のヘッダファイルは MPLAB XC32 インストールディレクトリ内の pic32mx/include サブディレクトリに保存されています ユーザが選択したデバイスに基づき コンパイラは xc.h が適切なデバイス固有ヘッダファイルを指定できるようにマクロを設定します デバイス固有ヘッダは ユーザコード内でインクルードしない事が必要です ( コードの移植性が失われるため ) 1.3 LED 値マクロの定義 LED に書き込む値は マクロ記述 (LEDS_ON_OFF) に割り当て済みです (LED D3/D5/D7/D9 は ON LED D4/D6/D8/D10 は OFF) Explorer 16/32 開発ボード関連の文書 ( 回路図を含む ) は B.5 Explorer 16/32 開発ボードの入手先と設定方法 に記載したリンクから入手できます 1.4 ポートアクセスデジタル I/O デバイスピンは周辺モジュール I/O ピンと多重化されている場合があります デジタル I/O のみを使うため 多重化されている周辺モジュールは無効にします これには 周辺モジュールレジスタ内のビット値を定義済みの C 変数を使います これらの変数は デバイス固有ヘッダファイル ( コンパイラインストールディレクトリ内のpic32mx/include/proc,) に書かれています どの周辺モジュールがどのピンを共有しているかは 各デバイスのデータシートを参照してください 1. LED を点灯または消灯させる サンプルコードのデバイスでは ポート A ピンが周辺モジュール ( 既定値では無効 ) と多重化されています また ポート A はアナログ I/O 機能を備えないため 全てのポート A ピンは既定値によりデジタル I/O として動作します ポートがアナログ I/O 機能を備えている場合 ピンをデジタル I/O として動作させるには ADxPCFT レジスタを使ってアナログ機能を無効にする必要があります デバイスピンは デジタル I/O ポート (PORT) またはデバイス内のラッチ (LAT) レジスタのどちらかに接続します このサンプルコードでは LATA を使います 変数 portvalue に代入された値がラッチに代入されます LATA = portvalue; // write to port latch さらに ピン方向 ( 入力または出力 ) を指定するために TRIS レジスタを使います サンプルコードでは TRISA を使います このレジスタ内のビットを 0 にクリアすると対応するピンは出力として設定され 1 にセットすると入力として設定されます 以下に例を示します TRISA = 0x0000; // set all port bits to be output DS B_JP - p Microchip Technology Inc.

5 2. 遅延関数を使って LED を点滅させる 以下のサンプルコードでは 前のサンプルコードの一部を変更しています このサンプルコードは LED を単純に点灯するのではなく 自動的に点滅させます 追加したコードを赤字で示しています // PIC32MX470F512L Configuration Bit Settings // 'C' source line config statements // DEVCFG3 // USERID = No Setting #pragma config FSRSSEL = PRIORITY_7 // Shadow Register Set Priority 7 #pragma config PMDL1WAY = ON // Peripheral Module - One Reconfig #pragma config IOL1WAY = ON // Peripheral Pin Select - One Reconfig #pragma config FUSBIDIO = ON // USB USID Selection - Port Function #pragma config FVBUSONIO = ON // USB VBUS ON Selection - Port Function // DEVCFG2 #pragma config FPLLIDIV = DIV_12 // PLL Input Divider - 12x #pragma config FPLLMUL = MUL_24 // PLL Multiplier - 24x #pragma config UPLLIDIV = DIV_12 // USB PLL Input Divider - 12x #pragma config UPLLEN = OFF // USB PLL Disabled and Bypassed #pragma config FPLLODIV = DIV_256 // Sys PLL Output Divide by 256 // DEVCFG1 #pragma config FNOSC = FRCDIV // Oscillator - Fast RC Osc w/div-by-n #pragma config FSOSCEN = ON // Secondary Oscillator Enabled #pragma config IESO = OFF // Internal/External Switch Over Disabled #pragma config POSCMOD = OFF // Primary Oscillator Disabled #pragma config OSCIOFNC = OFF // CLKO on OSCO Pin Disabled #pragma config FPBDIV = DIV_8 // Peripheral Clock Divisor:Sys_Clk/8 #pragma config FCKSM = CSDCMD // Clock Switch Disable, FSCM Disabled #pragma config WDTPS = PS // WDT Postscaler 1: #pragma config WINDIS = OFF // Watchdog Timer is in Non-Window Mode #pragma config FWDTEN = OFF // WDT Disabled (SWDTEN Control) #pragma config FWDTWINSZ = WINSZ_25 // Watchdog Timer Window 25% // DEVCFG0 #pragma config DEBUG = OFF // Background Debugger Disabled #pragma config JTAGEN = OFF // JTAG Disabled #pragma config ICESEL = ICS_PGx2 // ICE/ICD Comm Channel PGEC2/PGED2 #pragma config PWP = OFF // Program Flash Write Protect Disabled #pragma config BWP = OFF // Boot Flash Write Protect Disabled #pragma config CP = OFF // Code Protect Disabled // #pragma config statements should precede project file includes. // Use project enums instead of #define for ON and OFF. #include <xc.h> #define LEDS_ON_OFF 0x55 #define LEDS_OFF_ON 0xAA void delay (void) { int n = 50000; while(n>0) {n--; 2018 Microchip Technology Inc. DS B_JP - p. 5

6 int main(void) { // Port A access TRISA = 0x0; // set all port bits to be output while(1) { 2.1 参照 LATA = LEDS_ON_OFF; // write to port latch // delay value change delay(); 2.2 参照 LATA = LEDS_OFF_ON; // write to port latch // delay value change delay(); return -1; 2.1 while() ループと変数値 ループ内で最初に portvalue に値を代入し 次にその相補値を代入する事で ポート A の LED の状態 ( 点灯 / 消灯 ) を変更します このループは while(1) { を使って実行します 正常に動作している限り この while ループは終了しません エラーが発生すると main 関数は -1 を返します 2.2 delay() 関数 実行速度が速いため LED は点滅しているように見えません このため実行速度を遅くする必要があります このため 関数 delay() を main() の前で宣言および定義し main() コード内で 2 度呼び出します Note: コンパイル時は コードを最適化しない事が必要です ( 最適化オプションは -O0 を指定 ) 最適化すると遅延ループは削除されます 次のサンプルコードでは 別の方法でコード実行を遅延させます DS B_JP - p Microchip Technology Inc.

7 3. 遅延用に割り込みを使って LED を点滅させる 以下のサンプルコードでは 前のサンプルコードの一部を変更しています 前のサンプルコードでは ループの実行を遅らせるために遅延関数を使いましたが それによってプログラムにデッドタイムが生じました これを防ぐため 以下のサンプルコードではタイマ割り込みを使います 割り込みが発生するたびに変数値をインクリメントし この値を LED で表示します このサンプルコードでは コアタイマを使います プリスケーラ / ポストスケーラを設定しない場合 このタイマは 2 システムクロック周期でインクリメントします ( この動作は全ての PIC32 MCU で一貫しています ) その他のデバイスタイマも遅延用に使えますが 他のモジュールもそのタイマを使っている場合 注意が必要です 追加したコードを赤字で示しています // PIC32MX470F512L Configuration Bit Settings // 'C' source line config statements // DEVCFG3 // USERID = No Setting #pragma config FSRSSEL = PRIORITY_7 // Shadow Register Set Priority 7 #pragma config PMDL1WAY = ON // Peripheral Module - One Reconfig #pragma config IOL1WAY = ON // Peripheral Pin Select - One Reconfig #pragma config FUSBIDIO = ON // USB USID Selection - Port Function #pragma config FVBUSONIO = ON // USB VBUS ON Selection - Port Function // DEVCFG2 #pragma config FPLLIDIV = DIV_12 // PLL Input Divider - 12x #pragma config FPLLMUL = MUL_24 // PLL Multiplier - 24x #pragma config UPLLIDIV = DIV_12 // USB PLL Input Divider - 12x #pragma config UPLLEN = OFF // USB PLL Disabled and Bypassed #pragma config FPLLODIV = DIV_256 // Sys PLL Output Divide by 256 // DEVCFG1 #pragma config FNOSC = FRCDIV // Oscillator - Fast RC Osc w/div-by-n #pragma config FSOSCEN = ON // Secondary Oscillator Enabled #pragma config IESO = OFF // Internal/External Switch Over Disabled #pragma config POSCMOD = OFF // Primary Oscillator Disabled #pragma config OSCIOFNC = OFF // CLKO on OSCO Pin Disabled #pragma config FPBDIV = DIV_8 // Peripheral Clock Divisor:Sys_Clk/8 #pragma config FCKSM = CSDCMD // Clock Switch Disable, FSCM Disabled #pragma config WDTPS = PS // WDT Postscaler 1: #pragma config WINDIS = OFF // Watchdog Timer is in Non-Window Mode #pragma config FWDTEN = OFF // WDT Disabled (SWDTEN Control) #pragma config FWDTWINSZ = WINSZ_25 // Watchdog Timer Window 25% // DEVCFG0 #pragma config DEBUG = OFF // Background Debugger Disabled #pragma config JTAGEN = OFF // JTAG Disabled #pragma config ICESEL = ICS_PGx2 // ICE/ICD Comm Channel PGEC2/PGED2 #pragma config PWP = OFF // Program Flash Write Protect Disabled #pragma config BWP = OFF // Boot Flash Write Protect Disabled #pragma config CP = OFF // Code Protect Disabled // #pragma config statements should precede project file includes. // Use project enums instead of #define for ON and OFF. #include <xc.h> #include <cp0defs.h> #include <sys/attribs.h> 3.1 参照 2018 Microchip Technology Inc. DS B_JP - p. 7

8 // CORE_TICK_RATE = FOSC/2/TOGGLES_PER_SEC // FOSC/2 = Core timer clock frequency = 8MHz/2=4MHz // TOGGLES_PER_SEC = Toggle LED x times per second; x=5 #define CORE_TICK_RATE u // Interrupt function 3.2 参照 void ISR(_CORE_TIMER_VECTOR, IPL2SOFT) CTInterruptHandler(void) { // static variable for permanent storage duration static unsigned char portvalue = 0; // variables for Compare period unsigned long ct_count = _CP0_GET_COUNT(); unsigned long period = CORE_TICK_RATE; // write to port latch LATA = portvalue++; // update the Compare period period += ct_count; _CP0_SET_COMPARE(period); // clear the interrupt flag IFS0CLR = _IFS0_CTIF_MASK; int main(void) { unsigned int stat_gie, cause_val; // Disables interrupts by clearing the global interrupt enable bit // in the STATUS register. stat_gie = builtin_disable_interrupts(); // Port A access TRISA = 0x0; // set all port bits to be output LATA = 0x0; // clear all bits // Configure the core timer 3.3 参照 // clear the CP0 Count register _CP0_SET_COUNT(0); // set up the period in the CP0 Compare register _CP0_SET_COMPARE(CORE_TICK_RATE); // halt core timer and program at a debug breakpoint _CP0_BIC_DEBUG(_CP0_DEBUG_COUNTDM_MASK); // Set up core timer interrupt 3.4 参照 // clear core timer interrupt flag IFS0CLR = _IFS0_CTIF_MASK; // set core time interrupt priority of 2 IPC0CLR = _IPC0_CTIP_MASK; IPC0SET = (2 << _IPC0_CTIP_POSITION); // set core time interrupt subpriority of 0 IPC0CLR = _IPC0_CTIS_MASK; IPC0SET = (0 << _IPC0_CTIS_POSITION); // enable core timer interrupt IEC0CLR = _IEC0_CTIE_MASK; IEC0SET = (1 << _IEC0_CTIE_POSITION); DS B_JP - p Microchip Technology Inc.

9 // set the CP0 Cause register Interrupt Vector bit cause_val = _CP0_GET_CAUSE(); cause_val = _CP0_CAUSE_IV_MASK; _CP0_SET_CAUSE(cause_val); // enable multi-vector interrupts INTCONSET = _INTCON_MVEC_MASK; // enable global interrupts builtin_enable_interrupts(); while(1); return -1; 2018 Microchip Technology Inc. DS B_JP - p. 9

10 3.1 追加のヘッダファイル xc.h に加えて 2 つのヘッダファイル (CP0 マクロ用の cp0defs.h と ISR マクロ用の sys/attribs.h) をインクルードする必要があります 3.2 割り込み関数このサンプルコードでは ISR マクロ ISR(v,IPL) を使って CTInterruptHandler() を割り込み関数にします (v: コアタイマの割り込みベクタ IPL: 割り込み優先度 (2) とソフトウェアによるコンテクスト保存方法を IPL2SOFT として指定 ) ISR の詳細は MPLAB XC32 C/C++ コンパイラユーザガイド (DS ) 内の 割り込み を参照してください 割り込み関数内でカウンタ portvalue がインクリメントし LED で表示されます 割り込みをクリアするには CP0 コンペアレジスタに値を書き込む必要があります その後 コンペアレジスタ内の値とコアタイマの値が比較され 次の割り込みが生成されます コアタイマの現在の値は _CP0_GET_COUNT() により取得します 最終的に割り込みフラグがクリアされます 3.3 コアタイマの設定 32 ビットコアタイマは 0 に初期設定します コンペアレジスタは 初期値 CORE_TICK_RATE に設定します コアタイマ値がコンペアレジスタ値に達した時に割り込みがトリガされます 加えて デバッグを支援するため ブレークポイントでコアタイマが停止するよう設定します コアタイマの詳細は PIC32 ファミリリファレンスマニュアル セクション 2. M4K コア搭載デバイス用 CPU (DS61113) を参照してください 3.4 コアタイマ割り込みコアタイマ割り込みは以下の手順で設定します main コードの最初で builtin_disable_interrupts() を使ってグローバル割り込みを無効にします while(1) ループへジャンプする前に builtin_enable_interrupts() を使ってグローバル割り込みを有効にします デバイスヘッダファイル内のマクロを使ってコアタイマ割り込みフラグをクリアします (xc.h からアクセス ) デバイスマクロを使って割り込みの優先度と副優先度を設定します この優先度は 割り込み関数の優先度 (= 2) と一致する必要があります デバイスマクロを使ってコアタイマとマルチベクタ割り込みを有効にします デバイスマクロと CP0 マクロを使って CP0 Cause レジスタ内の割り込みベクタビットをセットします DS B_JP - p Microchip Technology Inc.

11 4. ADC を使ってポテンショメータの値を LED で表示する (MPLAB Harmony を使用 ) このサンプルコードは 3. 遅延用に割り込みを使って LED を点滅させる と同じデバイスとポート A LED を使います ただし このサンプルコードでは デモボード上のポテンショメータからの値をポート B (RB2/AN2) 経由でアナログ / デジタルコンバータ (ADC) に入力し その変換結果を LED で表示します また コードは手書きではなく MPLAB Harmony を使って生成します MPLAB Harmony 統合ソフトウェアフレームワークは以下からダウンロードできます MPLAB Harmony Configurator (MHC) は MPLAB Harmony の GUI をセットアップするための MPLAB X IDE プラグインです このプラグインは MPLAB X IDE の [Available Plugins] タブ (Tools > Plugins で開く ) を使ってインストールできます プラグインのインストール方法は MPLAB X IDE のヘルプを参照してください このサンプルコードは adc_pot サンプルコードに基づきます Windows PC の場合 このコードは以下に格納されています : C:\microchip\harmony\v1_10\apps\examples\peripheral\adc\adc_pot 4.1 MPLAB X IDE 内で MPLAB Harmony プロジェクトを作成する 以下のダイアログにより このサンプルコード向けに MPLAB Harmony プロジェクトを設定します MPLAB X IDE で メニューから File > New Project を選択します 図 2: 新しい MPLAB Harmony プロジェクト - ステップ Microchip Technology Inc. DS B_JP - p. 11

12 [Harmony Path] が MPLAB Harmony の実際のインストール先を指している事を確認します 図 3: 新しい MPLAB Harmony プロジェクト - ステップ 2 DS B_JP - p Microchip Technology Inc.

13 4.2 MPLAB Harmony プロジェクトの設定 プロジェクトの設定に従い MHC は実装済みクロックの情報を表示します 青でハイライト表示されたテキストは変更を示します このサンプルコードでは クロック設定を一切変更しません ADC ドライバを図 6 の通りに設定し BSP (Board Support Packages) を図 7 の通りに設定します 図 4: MPLAB Harmony プロジェクトと MHC 図 5: Harmony フレームワークの設定 - クロック 2018 Microchip Technology Inc. DS B_JP - p. 13

14 図 6: Harmony フレームワークの設定 - ADC ドライバ 図 7: ADC プロジェクトのリソース設定 DS B_JP - p Microchip Technology Inc.

15 図 8: ADC プロジェクトのピン設定 2018 Microchip Technology Inc. DS B_JP - p. 15

16 4.3 コードを生成してアプリケーションファイルを編集する 以上の図の通りに MHC を設定した後に [MPLAB Harmony Configurator] タブ上の [Generate Code] ボタンをクリックします 設定を保存し ( 図 9 参照 ) プロジェクトコードを生成します ( 図 10 参照 ) 図 9: 設定の保存 図 10: プロジェクトコードの生成 DS B_JP - p Microchip Technology Inc.

17 図 11 に示す通り MPLAB Harmony が生成するコードはモジュール化されています アプリケーションファイル (app.h と app.c) は 本サンプルコード向けに編集します フラッシュメモリの使い方の詳細は PIC32 ファミリリファレンスマニュアル セクション ビットアナログ / デジタルコンバータ (ADC) (DS61104) を参照してください 図 11: MHC が生成したコードの ADC プロジェクトツリー 2018 Microchip Technology Inc. DS B_JP - p. 17

18 4.4 編集後の app.h コード 編集後の app.h テンプレートファイルを以下に示します 一部のコメントは省略しました ( 省略箇所には < > で囲んだ注釈を記入しています ) 追加したコードを赤字で示しています /******************************************************************** MPLAB Harmony Application Header File <See generated app.h file for file information.> ******************************************************************* //DOM-IGNORE-BEGIN /******************************************************************** Copyright (c) released Microchip Technology Inc. All rights reserved. <See generated app.h file for copyright information.> ******************************************************************* //DOM-IGNORE-END #ifndef _APP_H #define _APP_H #define ADC_NUM_SAMPLE_PER_AVERAGE 16 // Section:Included Files #include <stdint.h> #include <stdbool.h> #include <stddef.h> #include <stdlib.h> #include "system_config.h" #include "system_definitions.h" // DOM-IGNORE-BEGIN #ifdef cplusplus // Provide C++ Compatibility extern "C" { #endif // DOM-IGNORE-END // Section:Type Definitions /* Application states Summary: Application states enumeration Description: DS B_JP - p Microchip Technology Inc.

19 This enumeration defines the valid application states.these states determine the behavior of the application at various times. typedef enum { /* Application's state machine's initial state. APP_STATE_INIT=0, APP_ADC_WAIT, APP_ADC_DISPLAY APP_STATES; /* Application Data Summary: Holds application data Description: This structure holds the application's data. Remarks: Application strings and buffers are be defined outside this structure. typedef struct { /* The application's current state APP_STATES state; /* Values for the conversions int potvalue; int ledmask; APP_DATA; // Section:Application Callback Routines /* These routines are called by drivers when certain events occur. // Section:Application Initialization and State Machine Functions /******************************************************************** Function: void APP_Initialize ( void ) Summary: MPLAB Harmony application initialization routine. <See generated app.h file for app init information.> 2018 Microchip Technology Inc. DS B_JP - p. 19

20 void APP_Initialize ( void ); /******************************************************************** Function: void APP_Tasks ( void ) Summary: MPLAB Harmony Demo application tasks function <See generated app.h file for app tasks information.> void APP_Tasks( void ); #endif /* _APP_H //DOM-IGNORE-BEGIN #ifdef cplusplus #endif //DOM-IGNORE-END /******************************************************************** End of File DS B_JP - p Microchip Technology Inc.

21 4.5 編集後の app.c コード 編集後の app.c テンプレートファイルを以下に示します 一部のコメントは省略しました ( 省略箇所には < > で囲んだ注釈を記入しています ) 追加したコードを赤字で示しています 一部の長いコード行は次のページにまたがっています これは 本書のコードをそのままエディタへカット & ペーストできるように配慮したためです /******************************************************************** MPLAB Harmony Application Source File <See generated app.c file for file information.> ******************************************************************* // DOM-IGNORE-BEGIN /******************************************************************** Copyright (c) released Microchip Technology Inc. All rights reserved. <See generated app.c file for copyright information.> ******************************************************************* // DOM-IGNORE-END // Section:Included Files #include "app.h" // Section:Global Data Definitions /* Application Data Summary: Holds application data Description: This structure holds the application's data. Remarks: This structure should be initialized by the APP_Initialize function. Application strings and buffers are be defined outside this structure. APP_DATA appdata; // Section:Application Callback Functions 2018 Microchip Technology Inc. DS B_JP - p. 21

22 /* TODO:Add any necessary callback functions. // Section:Application Local Functions /******************************************************************** Function: void Set_LED_Status ( void ) Description: Set LEDs to display the ADC average result. void Set_LED_Status(void) { int i; appdata.ledmask = 0; /* Creates a mask for the LEDs, corresponding to the value read * from the potentiometer appdata.potvalue >>= 7; /* 10-bit value to 3-bit value for (i = 0; i <= appdata.potvalue; i++) { appdata.ledmask = 1<<(i); /* Write the mask to the LEDs SYS_PORTS_Write( PORTS_ID_0, PORT_CHANNEL_A, (PORTS_DATA_MASK)appData.ledMask ); // Section:Application Initialization and State Machine Functions /******************************************************************** Function: void APP_Initialize ( void ) Remarks: See prototype in app.h. void APP_Initialize ( void ) { /* Place the App state machine in its initial state. appdata.state = APP_STATE_INIT; /* TODO:Initialize your application's state machine and other * parameters. DS B_JP - p Microchip Technology Inc.

23 /******************************************************************** Function: void APP_Tasks ( void ) Remarks: See prototype in app.h. void APP_Tasks ( void ) { /* Check the application's current state. switch ( appdata.state ) { /* Application's initial state. case APP_STATE_INIT: 4.6 参照 { /* Enable ADC DRV_ADC_Open(); appdata.state = APP_ADC_WAIT; break; /* Display pot value on LEDs case APP_ADC_DISPLAY: 4.7 参照 { Set_LED_Status(); appdata.state = APP_ADC_WAIT; break; /* Wait for ADC case APP_ADC_WAIT: 4.8 参照 { /* Wait for conversion if (DRV_ADC_SamplesAvailable()) { int i; //Read data for(i=0;i<adc_num_sample_per_average;i++) appdata.potvalue += PLIB_ADC_ResultGetByIndex(ADC_ID_1, i); appdata.potvalue = appdata.potvalue / ADC_NUM_SAMPLE_PER_AVERAGE; appdata.state = APP_ADC_DISPLAY; break; /* The default state should never be executed. default: 2018 Microchip Technology Inc. DS B_JP - p. 23

24 { /* TODO:Handle error in application's state machine. break; /******************************************************************** End of File 4.6 アプリケーションステート - APP_STATE_INIT タスクループの開始時にアプリケーションは初期ステートです この場合 ADC は自動サンプリングモードで有効になります 次に アプリケーションは待機ステート (APP_ADC_WAIT) に移行します アプリケーションステートは app.h 内で定義されます 4.7 アプリケーションステート - APP_ADC_DISPLAY APP_ADC_WAIT 中に ADC 値がキャプチャされると Application Local Functions セクション内で関数 Set_LED_Status() を呼び出す事によって その値を表示します この関数は マスク (appdata.ledmask) を使って ポテンショメータからの ADC 値 (appdata.potvalue) を LED に表示します これらの変数は app.h 内で定義されます この関数が戻ると アプリケーションステートは APP_ADC_WAIT に戻り 次のサンプルを待機します 4.8 アプリケーションステート - APP_ADC_WAIT 初期化 (APP_STATE_INIT) 後に アプリケーションはポテンショメータ値が変換されるまで待機します ADC 値が変数 appdata.potvalue に代入されると ステート APP_ADC_DISPLAY でその値が LED に表示されます ADC_NUM_SAMPLE_PER_AVERAGE は app.h 内で定義されます DS B_JP - p Microchip Technology Inc.

25 5. ADC を使ってポテンショメータの値を LED で表示する (MCC を使用 ) このサンプルコードは 3. 遅延用に割り込みを使って LED を点滅させる と同じデバイスとポート A LED を使います ただし このサンプルコードでは デモボード上のポテンショメータからの値をポート B (RB2/AN2) 経由でアナログ / デジタルコンバータ (ADC) に入力し その変換結果を LED で表示します コードは手書きではなくMPLAB Code Configurator (MCC) を使って生成します MCC プラグインは MPLAB X IDE の [Available Plugins] タブ (Tools > Plugins で開く ) を使ってインストールできます プラグインのインストール方法は MPLAB X IDE のヘルプを参照してください MCC のインストール情報と MPLAB Code Configurator ユーザガイド (DS ) は 以下の MPLAB Code Configurator ウェブページで入手できます このサンプルコードを生成するために使った MCC の設定を以下の図に示します 図 12: ADC プロジェクト - リソース - システムモジュール 2018 Microchip Technology Inc. DS B_JP - p. 25

26 図 13: ADC プロジェクト - システムモジュール - Easy Setup DS B_JP - p Microchip Technology Inc.

27 図 14: ADC プロジェクト - システムモジュール - レジスタ 2018 Microchip Technology Inc. DS B_JP - p. 27

28 図 15: ADC プロジェクト - リソース - ADC1 DS B_JP - p Microchip Technology Inc.

29 図 16: ADC プロジェクト - ADC1 - Easy Setup 図 17 での選択後に RB2 から AN2 への割り当てが表示されます 図 17: ADC プロジェクト - ADC1 - ピンリソース 2018 Microchip Technology Inc. DS B_JP - p. 29

30 図 18: ADC プロジェクト - リソース - ピンモジュール 図 19: ADC プロジェクト - ピンモジュール - Easy Setup 図 20 でピン RA0:7 が選択されている場合 これらのピンは上図のウィンドウに表示されます RB2 は図 17 で選択済みです RB6 と RB7 は 図 13 で PGEC2/PGED2 向けに選択済みです ウィンドウ内にピン設定が表示されたら 各ピンの設定を表示および選択できます DS B_JP - p Microchip Technology Inc.

31 図 20: ADC プロジェクト - ピンリソース 2018 Microchip Technology Inc. DS B_JP - p. 31

32 以上のようにコードを設定した後に [Project Resources] ウィンドウの [Generate] ボタンをクリックします ( 図 12) MCC はモジュール形式のコードを生成します 従って main システム 周辺モジュールコードは全て別々のファイルとして生成されます 各周辺モジュールのヘッダファイルも別々です 潜在的なエラーを捉えるために割り込みマネージャファイルが生成されます このアプリケーションでは割り込みは使いませんが 将来用に割り込みマネージャファイルが生成されます プログラムに機能を追加する場合 必ず main.c を編集する必要があります また そのコードに必要な全ての関数またはマクロが生成されたファイル内に含まれているかどうか確認する必要があります フラッシュメモリの使い方の詳細は PIC32 ファミリリファレンスマニュアル セクション ビットアナログ / デジタルコンバータ (ADC) (DS61104) を参照してください 図 21: MCC が生成したコードの ADC プロジェクトツリー DS B_JP - p Microchip Technology Inc.

33 5.1 編集後の main.c コード 編集後の main.c テンプレートファイルを以下に示します 一部のコメントは省略しました ( 省略箇所には < > で囲んだ注釈を記入しています ) main() に追加したコードを赤字で示しています /** Generated Main Source File <See generated main.c file for file information.> /* (c) 2016 Microchip Technology Inc. and its subsidiaries.you may use this software and any derivatives exclusively with Microchip products. <See generated main.c file for additional copyright information.> #include "mcc_generated_files/mcc.h" unsigned int value = 0; /* Creates a mask for the LEDs, corresponding * to the value read from the potentiometer unsigned int Mask_Value(unsigned int pot_value){ int i; unsigned int mask_value = 0; pot_value >>= 7; /* 10-bit value to 3-bit value for (i = 0; i <= pot_value; i++) { mask_value = 1<<(i); return mask_value; /* Main application int main(void) { // initialize the device SYSTEM_Initialize(); while (1) { // Wait for conversion 5.2 参照 // and then get result while(!adc1_isconversioncomplete()); value = ADC1_ConversionResultGet(); // Mark value value = Mask_Value(value); // Write to Port Latch/LEDs LATA = value; 5.3 参照 5.4 参照 return -1; 2018 Microchip Technology Inc. DS B_JP - p. 33

34 /** End of File 5.2 ADC 変換および結果 MCC は AD1CON1 レジスタ内のビットを次の通りに設定します : ADC を有効にする 自動サンプリングを使う 内部カウンタを使ってサンプリングを終了 / 変換を開始する 従って main() コードは変換の終了を待機し 結果を取得するだけで済みます adc1.c モジュールから以下の関数を使います bool ADC1_IsConversionComplete(void) uint16_t ADC1_ConversionResultGet(void) その他の ADC 機能の設定の詳細は PIC32 ファミリリファレンスマニュアル セクション ビットアナログ / デジタルコンバータ (ADC) (DS61104) を参照してください 5.3 ADC 変換結果のマスク ADC 変換結果は 10 ビットであるのに対し LED は 8 個しかないため 関数 Mask_Value() を使って変数 value 内の変換結果をマスクする事により 最上位の 3 ビットだけを 3 個の LED で表示します 5.4 ポートラッチと LED への書き込み マスクした ADC 変換結果は ポート A の LED で表示します DS B_JP - p Microchip Technology Inc.

35 6. フラッシュメモリへの書き込みステータスを LED で表示する (MPLAB Harmony を使用 ) このサンプルコードは 4. ADC を使ってポテンショメータの値を LED で表示する (MPLAB Harmony を使用 ) と同じデバイスとポート A LED を使います ただし このサンプルコードでは フラッシュ ( 不揮発性 ) メモリに対して値を読み書きし それが成功した時に LED2 を点灯させ 失敗した時に LED0 を点灯させます コードは手書きではなく MPLAB Harmony を使って生成します MPLAB Harmony 統合ソフトウェアフレームワークと MPLAB Harmony Configurator (MHC) MPLAB X IDE プラグインのダウンロード / インストール方法は 4. ADC を使ってポテンショメータの値を LED で表示する (MPLAB Harmony を使用 ) を参照してください MPLAB X IDE における MPLAB Harmony プロジェクトの作成方法については 4.1 MPLAB X IDE 内で MPLAB Harmony プロジェクトを作成する を参照してください 以下のサンプルコードのプロジェクト名は Expample6 です このサンプルコードは 以下の場所にあるフラッシュドライバアプリケーションに基づきます (Windows OS の場合 ): C:\microchip\harmony\v1_10\apps\examples\peripheral\flash\flash_modify 6.1 MPLAB Harmony プロジェクトの設定 プロジェクトの設定に従い MPLAB Harmony Configurator (MHC) は実装済みクロックの情報を表示します 青のハイライトは変更を示します このサンプルコードでは クロック設定を一切変更しません フラッシュドライバを図 22 の通りに設定し BSP (Board Support Packages) を図 23 の通りに設定します 図 22: Harmony フレームワークの設定 - フラッシュドライバ 2018 Microchip Technology Inc. DS B_JP - p. 35

36 図 23: フラッシュプロジェクトのリソース設定 DS B_JP - p Microchip Technology Inc.

37 6.2 コードを生成してアプリケーションファイルを編集する 以上の図の通りに MHC を設定した後に [MPLAB Harmony Configurator] タブ上の [Generate Code] ボタンをクリックします 設定を保存し プロジェクトコードを生成します (4.3 コードを生成してアプリケーションファイルを編集する 参照 ) 図 24 に示す通り MPLAB Harmony が生成するコードはモジュール化されています アプリケーションファイル (app.h と app.c) は 本サンプルコード向けに編集します フラッシュメモリの使い方の詳細は PIC32 ファミリリファレンスマニュアル セクション ビットアナログ / デジタルコンバータ (ADC) (DS ) を参照してください 図 24: MHC が生成したコードのフラッシュプロジェクトツリー 2018 Microchip Technology Inc. DS B_JP - p. 37

38 6.3 編集後の app.h コード 編集後の app.h テンプレートファイルを以下に示します 一部のコメントは省略しました ( 省略箇所には < > で囲んだ注釈を記入しています ) 追加したコードを赤字で示しています /******************************************************************** MPLAB Harmony Application Header File <See generated app.h file for file information.> ******************************************************************* //DOM-IGNORE-BEGIN /******************************************************************** Copyright (c) released Microchip Technology Inc. All rights reserved. <See generated app.h file for copyright information.> ****************************************************************** //DOM-IGNORE-END #ifndef _APP_H #define _APP_H #define USERLED_SUCCESS LED_2 //D5 on Explorer 16/32 #define USERLED_ERROR LED_0 //D3 on Explorer 16/32 // Section:Included Files #include <stdint.h> #include <stdbool.h> #include <stddef.h> #include <stdlib.h> #include "system_config.h" #include "system_definitions.h" // DOM-IGNORE-BEGIN #ifdef cplusplus // Provide C++ Compatibility extern "C" { #endif // DOM-IGNORE-END // Section:Type Definitions #define APP_DATABUFF_SIZE (sizeof(databuff) / sizeof(uint32_t)) /* Row size for device is 2Kbytes #define APP_DEVICE_ROW_SIZE_DIVIDED_BY_4 (DRV_FLASH_ROW_SIZE/4) DS B_JP - p Microchip Technology Inc.

39 /* Page size for device is 16Kbytes #define APP_DEVICE_PAGE_SIZE_DIVIDED_BY_4 (DRV_FLASH_PAGE_SIZE/4) #define APP_PROGRAM_FLASH_BASE_ADDRESS_VALUE (unsigned int) 0x9D #define APP_PROGRAM_FLASH_BASE_ADDRESS (unsigned int *) APP_PROGRAM_FLASH_BASE_ADDRESS_VALUE /* Application states Summary: Application states enumeration Description: This enumeration defines the valid application states.these states determine the behavior of the application at various times. typedef enum { /* Application's state machine's initial state. APP_STATE_INIT=0, APP_STATE_NVM_FILL_DATABUF_AND_ERASE_STATE, APP_STATE_NVM_ERASE_COMPLETION_CHECK, APP_STATE_NVM_WRITE_START, APP_STATE_NVM_WRITE_COMPLETION_CHECK_AND_VERIFY_CHECK, APP_STATE_NVM_ERROR_STATE, APP_STATE_NVM_SUCCESS_STATE, APP_STATES; /* Application Data Summary: Holds application data Description: This structure holds the application's data. Remarks: Application strings and buffers are be defined outside this structure. typedef struct { /* The application's current state APP_STATES state; DRV_HANDLE flashhandle; APP_DATA; 2018 Microchip Technology Inc. DS B_JP - p. 39

40 // Section:Application Callback Routines /* These routines are called by drivers when certain events occur. // Section:Application Initialization and State Machine Functions /******************************************************************** Function: void APP_Initialize ( void ) Summary: MPLAB Harmony application initialization routine. <See generated app.h file for app init information.> void APP_Initialize ( void ); /******************************************************************** Function: void APP_Tasks ( void ) Summary: MPLAB Harmony Demo application tasks function <See generated app.h file for app tasks information.> void APP_Tasks( void ); #endif /* _APP_H //DOM-IGNORE-BEGIN #ifdef cplusplus #endif //DOM-IGNORE-END /******************************************************************** End of File DS B_JP - p Microchip Technology Inc.

41 6.4 編集後の app.c コード 編集後の app.c テンプレートファイルを以下に示します 一部のコメントは省略しました ( 省略箇所には < > で囲んだ注釈を記入しています ) 追加したコードを赤字で示しています 一部の長いコード行は次のページにまたがっています これは 本書のコードをそのままエディタへカット & ペーストできるように配慮したためです /******************************************************************** MPLAB Harmony Application Source File <See generated app.c file for file information.> ****************************************************************** // DOM-IGNORE-BEGIN /******************************************************************** Copyright (c) released Microchip Technology Inc. All rights reserved. <See generated app.c file for copyright information.> ****************************************************************** // DOM-IGNORE-END // Section:Included Files #include "app.h" // Section:Global Data Definitions /***************************************************** * Initialize the application data structure.all * application related variables are stored in this * data structure. **************************************************** /* Array in the KSEG1 RAM to store the data uint32_t databuff[app_device_row_size_divided_by_4] attribute ((coherent, aligned(16))); /* Application Data Summary: Holds application data Description: This structure holds the application's data. Remarks: 2018 Microchip Technology Inc. DS B_JP - p. 41

42 This structure should be initialized by the APP_Initialize function. Application strings and buffers are be defined outside this structure. APP_DATA appdata; // Section:Application Callback Functions /* TODO:Add any necessary callback functions. // Section:Application Local Functions /* TODO:Add any necessary local functions. // Section:Application Initialization and State Machine Functions /******************************************************************** Function: void APP_Initialize ( void ) Remarks: See prototype in app.h. void APP_Initialize ( void ) { /* Place the App state machine in its initial state. appdata.state = APP_STATE_INIT; /* TODO:Initialize your application's state machine and other * parameters. /******************************************************************** Function: void APP_Tasks ( void ) Remarks: DS B_JP - p Microchip Technology Inc.

43 See prototype in app.h. void APP_Tasks ( void ) { unsigned int x; /* Check the application's current state. switch ( appdata.state ) { /* Application's initial state. 6.5 参照 case APP_STATE_INIT: appdata.flashhandle = DRV_FLASH_Open(DRV_FLASH_INDEX_0, intent); appdata.state = APP_STATE_NVM_FILL_DATABUF_AND_ERASE_STATE; break; /* Fill data buffer, clear LEDs, 6.6 参照 * and begin erase page case APP_STATE_NVM_FILL_DATABUF_AND_ERASE_STATE: for (x = 0; x < APP_DATABUFF_SIZE; x++) { databuff[x] = x; BSP_LEDOff(USERLED_SUCCESS); BSP_LEDOff(USERLED_ERROR); /* Erase the page which consist of the row to be written DRV_FLASH_ErasePage(appData.flashHandle, APP_PROGRAM_FLASH_BASE_ADDRESS_VALUE); appdata.state = APP_STATE_NVM_ERASE_COMPLETION_CHECK; break; /* Check for erase complete 6.7 参照 case APP_STATE_NVM_ERASE_COMPLETION_CHECK: if(!drv_flash_isbusy(appdata.flashhandle)) { appdata.state = APP_STATE_NVM_WRITE_START; break; /* Write row of Flash 6.8 参照 case APP_STATE_NVM_WRITE_START: /* Erase Success /* Write a row of data to PROGRAM_FLASH_BASE_ADDRESS, * using databuff array as the source DRV_FLASH_WriteRow(appData.flashHandle, APP_PROGRAM_FLASH_BASE_ADDRESS_VALUE, databuff); appdata.state = APP_STATE_NVM_WRITE_COMPLETION_CHECK_AND_VERIFY_CHECK; break; /* Check for write complete 6.9 参照 * and verify write operation case APP_STATE_NVM_WRITE_COMPLETION_CHECK_AND_VERIFY_CHECK: if(!drv_flash_isbusy(appdata.flashhandle)) { /* Verify that data written to flash memory is valid * (databuff array read from kseg1) if (!memcmp(databuff, (void *)KVA0_TO_KVA1(APP_PROGRAM_FLASH_BASE_ADDRESS), 2018 Microchip Technology Inc. DS B_JP - p. 43

44 sizeof(databuff))) { appdata.state = APP_STATE_NVM_SUCCESS_STATE; else { appdata.state = APP_STATE_NVM_ERROR_STATE; break; /* Write Failure 6.10 参照 case APP_STATE_NVM_ERROR_STATE: /*stay here, nvm had a failure BSP_LEDOn(USERLED_ERROR); BSP_LEDOff(USERLED_SUCCESS); break; /* Write Success 6.11 参照 case APP_STATE_NVM_SUCCESS_STATE: BSP_LEDOn(USERLED_SUCCESS); BSP_LEDOff(USERLED_ERROR); break; /******************************************************************** End of File 6.5 アプリケーションステート - 初期ステート タスクループの開始時にアプリケーションは初期ステート (APP_STATE_INIT) です このステートではフラッシュドライバが初期化され アプリケーションは次のステート (APP_STATE_NVM_FILL_DATABUF_AND_ERASE_STATE) に移行します アプリケーションステートは app.h 内で定義されます 6.6 アプリケーションステート - データバッファの書き込みとページ消去 初期化が完了すると 書き込みの準備を実行します 最初に フラッシュメモリに書き込むデータをデータバッファに書き込みます ( データバッファは Section: Global Data Definitions 内で定義されます ) 次に 動作の成功 / 失敗を示す LED をクリアします ( これらの値は app.h 内で設定されます ) その後 フラッシュメモリ (NVM) ページの消去を開始します 最後に アプリケーションはページ消去の完了を待機するためのステート (APP_STATE_NVM_ERASE_COMPLETION_CHECK) に移行します 6.7 アプリケーションステート - ページ消去の完了 このステートは 前のステートで開始したページ消去が完了するまで待機します ページ消去が完了すると アプリケーションはフラッシュメモリ (NVM) への書き込みを開始するためのステート (APP_STATE_NVM_WRITE_START) に移行します 6.8 アプリケーションステートフラッシュメモリの行書き込み フラッシュメモリ内の消去済みページへの行書き込みを開始します この行には データバッファ内の値を書き込みます その後 アプリケーションステートは書き込みの終了と検証のためのステート (APP_STATE_NVM_WRITE_COMPLETION_CHECK_AND_VERIFY_CHECK) に移行します DS B_JP - p Microchip Technology Inc.

45 6.9 アプリケーションステート行書き込みの完了と検証 このステートは 前のステートで開始した行書き込みが完了するまで待機します 完了すると 書き込んだ値とデータバッファ内の値を照合します 書き込みが成功していた場合 アプリケーションステートは APP_STATE_NVM_SUCCESS_STATE に移行します 失敗していた場合 アプリケーションステートは APP_STATE_NVM_ERROR_STATE に移行します 6.10 アプリケーションステート - エラーステート フラッシュメモリの書き込みに失敗した場合 エラーステートに移行します デモボード上の LED 3 (D3) を点灯させる事でエラーの発生を示します 6.11 アプリケーションステート - 成功ステート フラッシュメモリの消去 / 書き込みに成功した場合 成功ステートに移行します デモボード上の LED 5 (D5) を点灯させる事でアプリケーションの実行が成功した事を示します 2018 Microchip Technology Inc. DS B_JP - p. 45

46 7. フラッシュメモリの値を LED で表示する (MCC を使用 ) このサンプルコードは 5. ADC を使ってポテンショメータの値を LED で表示する (MCC を使用 ) と同じデバイスとポート A LED を使います ただし このサンプルコードでは フラッシュ ( 不揮発性 ) メモリに対して値を読み書きし それが成功した時に LED2 を点灯させ 失敗した時に LED0 を点灯させます コードの一部は MPLAB Code Configurator (MCC) で生成します MCC のインストール方法とユーザガイドの入手方法は 5. ADC を使ってポテンショメータの値を LED で表示する (MCC を使用 ) を参照してください このサンプルコードを生成するために使った MCC の設定を以下の図に示します 図 25: フラッシュプロジェクト - リソース - システムモジュール DS B_JP - p Microchip Technology Inc.

47 図 26: フラッシュプロジェクト - システムモジュール - Easy Setup 2018 Microchip Technology Inc. DS B_JP - p. 47

48 図 27: フラッシュプロジェクト - システムモジュール - レジスタ DS B_JP - p Microchip Technology Inc.

49 図 28: フラッシュプロジェクト - リソース - NVM 2018 Microchip Technology Inc. DS B_JP - p. 49

50 図 29: フラッシュプロジェクト - NVM - レジスタ DS B_JP - p Microchip Technology Inc.

51 図 30: フラッシュプロジェクト - リソース - ピンモジュール 図 31: フラッシュプロジェクト -I/O ピン設定 図 32 でピン RA0 と RA2 が選択されている場合 これらのピンは上図のウィンドウに表示されます RB6 と RB7 は 図 26 で PGEC2/PGED2 向けに選択済みです ウィンドウ内にピン設定が表示されたら 各ピンに対してピン設定を表示および選択できます 図 32: フラッシュプロジェクト - I/O ピンリソース 2018 Microchip Technology Inc. DS B_JP - p. 51

52 以上のようにコードを設定した後に [Project Resources] ウィンドウの [Generate] ボタンをクリックします ( 図 12) MCC はモジュール形式でコードを生成します 従って main システム 周辺モジュールコードは全て別々のファイルとして生成されます 各周辺モジュールのヘッダファイルも別々です 潜在的なエラーを捉えるために割り込みマネージャファイルが生成されます このアプリケーションでは割り込みは使いませんが 将来用に割り込みマネージャファイルが生成されます プログラムに機能を追加する場合 必ず main.c を編集する必要があります また そのコードに必要な全ての関数またはマクロが生成されたファイル内に含まれているかどうか確認する必要があります フラッシュメモリの使い方の詳細は PIC32 ファミリリファレンスマニュアル セクション ビットアナログ / デジタルコンバータ (ADC) (DS ) を参照してください 図 33: MCC が生成したコードのフラッシュプロジェクトツリー DS B_JP - p Microchip Technology Inc.

53 7.1 編集後の main.c コード 編集後の main.c テンプレートファイルを以下に示します 一部のコメントは省略しました ( 省略箇所には < > で囲んだ注釈を記入しています ) 追加済みコードは赤字で示しています /** Generated Main Source File <See generated main.c for file information.> /* (c) 2016 Microchip Technology Inc. and its subsidiaries.you may use this software and any derivatives exclusively with Microchip products. <See generated main.c for additional copyright information.> #include "mcc_generated_files/mcc.h" // Program Flash Physical Addresses:0x1D00_0000?0x1D07_FFFF // Program Flash Virtual Addresses:KSEG0:0x9D00_0000?0x9D07_FFFF // KSEG1:0xBD00_0000?0xBD07_FFFF #define NVM_PROGRAM_PAGE 0xbd unsigned int databuff[128]; /* int main(void) { Main application unsigned int x; // initialize the device SYSTEM_Initialize(); // Fill databuff with some data for(x =0; x < sizeof(databuff); x++) databuff[x] = x; // Erase second page of Program Flash NVM_ErasePage((void *)NVM_PROGRAM_PAGE); 7.2 参照 // Write 128 words starting at 7.3 参照 // Row Address NVM_PROGRAM_PAGE NVM_WriteRow((void *)NVM_PROGRAM_PAGE, (void*)databuff); // Verify data matches 7.4 参照 if(memcmp(databuff, (void *)NVM_PROGRAM_PAGE, sizeof(databuff))) { // If not turn led0 on to indicate an error IO_RA0_SetHigh(); else { // If true turn led2 on to indicate success IO_RA2_SetHigh(); 2018 Microchip Technology Inc. DS B_JP - p. 53

54 while (1) { // End of program return -1; /** End of File 7.2 フラッシュメモリのページ消去 フラッシュメモリの消去可能な最小領域は 1 ページです これには nvm.c ファイル内の NVM_ErasePage() 関数を使います 7.3 フラッシュメモリの行書き込みデータバッファの内容は フラッシュメモリ内の 1 行に書き込みます これには nvm.c ファイル内の NVM_WriteRow() 関数を使います 7.4 書き込みの検証と LED でのデータ表示 フラッシュメモリに書き込まれたデータとデータバッファの内容を比較します 両者が一致しない場合 LED0/D3 を点灯させてエラーが発生した事を示します 一致する場合 LED2/D5 を点灯させて書き込みが成功した事を示します DS B_JP - p Microchip Technology Inc.

55 補遺 A. MPLAB X IDE 内でのコード実行 サンプルコード のプロジェクトの作成手順は以下の通りです 1. MPLAB X IDE を起動します 2. IDE から [New Project] ウィザードを起動します (File > New Project) 3. 画面の指示に従って以下の手順で新しいプロジェクトを作成します a) プロジェクトの選択 : Microchip Embedded を選択し 次に Standalone Project を選択します b) デバイスの選択 : サンプルコードのデバイスを選択します c) ヘッダの選択 : 何も選択しません d) ツールの選択 : 使用するハードウェアデバッグツールのシリアル番号 (SNxxxxxx) を選択します デバッグツール名の下にシリアル番号 (SN) が表示されない場合 そのデバッグツールが正しくインストールされているか確認します 詳細はデバッグツールのマニュアルを参照してください e) プラグインボードの選択 : 何も選択しません f) コンパイラの選択 : XC32 ( 最新バージョン番号 ) を選択します ([bin location]) XC32 の下にコンパイラが表示されない場合 コンパイラが正しくインストールされているか および MPLAB X IDE がコンパイラを検出できているかを確認します Tools > Options を選択し [Build Tools] タブの [Embedded] ボタンをクリックして使用中のコンパイラを確認します 詳細は MPLAB XC32 と MPLAB X IDE のマニュアルを参照してください g) プロジェクト名とフォルダの選択 : プロジェクト名を指定します 4. [Projects] ウィンドウ内でプロジェクト名を右クリックし New > Empty FIle を選択します [New Empty File] ダイアログが開きます 5. File name に名前を入力します 6. [Finish] をクリックします 7. 本書のサンプルコードを空白のエディタウィンドウにコピー / ペーストし File > Save を選択します サンプルコード 4 および 6 のプロジェクトの作成手順は 4.1 MPLAB X IDE 内で MPLAB Harmony プロジェクトを作成する に記載した通りです プロジェクトを作成した後 MHC を設定してコードを生成し 本書に記載した通りに編集します サンプルコード 5 および 7 の場合 上記のステップ 1 ~ 3 を実行します その後 MCC を設定してコードを生成し 本書に記載した通りに編集します 最後に [Debug Run] を選択します これによりコードをビルドしてデバイスにダウンロードし 実行します そしてコードの出力を LED で確認します 実行を終了するには [Halt] をクリックします 図 34: ツールバーアイコン DEBUG RUN HALT 2018 Microchip Technology Inc. DS B_JP - p. 55

56 補遺 B. ソフトウェアとハードウェアの入手先 本書の MPLAB XC32 プロジェクトには PIC32 PIM を実装した Explorer 16/32 開発ボードを使います ボードには外部電源から 9 V を供給し 標準の (ICSP ) 通信を使います 開発には MPLAB X IDE を使いました B.1 MPLAB X IDE と MPLAB XC32 C コンパイラの入手先 MPLAB X IDE (v3.55 ~ ) は以下で入手できます MPLAB XC32 C コンパイラ (v1.42 ~ ) は以下で入手できます B.2 MPLAB Harmony および Configurator プラグインの入手先 MPLAB Harmony Configurator (v xx ~ ) は MPLAB X IDE の [Available Plugins] タブ (Tools > Plugins で開く ) で選択できます MPLAB Harmony (v1.10 ~ ) は以下で入手できます B.3 MPLAB Code Configurator (MCC) の入手先 MCC (v3.26 ~ ) は以下で入手できます B.4 PIC MCU プラグインモジュール (PIM) の入手先本書のサンプルコードで使う PIC MCU PIM は以下の Microchip 社ウェブページで入手できます PIC32MX470F512L: B.5 Explorer 16/32 開発ボードの入手先と設定方法 Explorer 16/32 開発ボードと回路図 マニュアルは以下のウェブページで入手できます ジャンパとスイッチは下表の通りに設定します 表 1-1: プロジェクト向けのジャンパ / スイッチの選択 ジャンパ / スイッチ 選択 ジャンパ / スイッチ 選択 JP2 ショート J37 オープン J19 オープン J38 オープン J22 オープン J39 既定値 J23 既定値 J41 オープン J25 ショート J42 オープン J26 ショート J43 既定値 J27 オープン J44 既定値 J28 オープン J45 既定値 J29 オープン J50 ショート J33 オープン DS B_JP - p Microchip Technology Inc.

57 B.6 Microchip 社製デバッグツールの入手先 エミュレータとデバッガは以下の開発ツールウェブページで入手できます B.7 サンプルコードの入手先本書に記載したサンプルコードは にアクセスし [Documentation] タブからダウンロードできます これらの MPLAB Harmony サンプルコードは 以下のフォルダに格納します C:\microchip\harmony\v1_10\apps 2018 Microchip Technology Inc. DS B_JP - p. 57

58 NOTE: DS B_JP - p Microchip Technology Inc.

59 Microchip 社製デバイスのコード保護機能に関して次の点にご注意ください Microchip 社製品は 該当する Microchip 社データシートに記載の仕様を満たしています Microchip 社では 通常の条件ならびに仕様に従って使用した場合 Microchip 社製品のセキュリティレベルは 現在市場に流通している同種製品の中でも最も高度であると考えています しかし コード保護機能を解除するための不正かつ違法な方法が存在する事もまた事実です 弊社の理解ではこうした手法は Microchip 社データシートにある動作仕様書以外の方法で Microchip 社製品を使用する事になります このような行為は知的所有権の侵害に該当する可能性が非常に高いと言えます Microchip 社は コードの保全性に懸念を抱くお客様と連携し 対応策に取り組んでいきます Microchip 社を含む全ての半導体メーカーで 自社のコードのセキュリティを完全に保証できる企業はありません コード保護機能とは Microchip 社が製品を 解読不能 として保証するものではありません コード保護機能は常に進歩しています Microchip 社では 常に製品のコード保護機能の改善に取り組んでいます Microchip 社のコード保護機能の侵害は デジタルミレニアム著作権法に違反します そのような行為によってソフトウェアまたはその他の著 本書に記載されているデバイスアプリケーション等に関する情報は ユーザの便宜のためにのみ提供されているものであり 更新によって無効とされる事があります お客様のアプリケーションが仕様を満たす事を保証する責任は お客様にあります Microchip 社は 明示的 暗黙的 書面 口頭 法定のいずれであるかを問わず 本書に記載されている情報に関して 状態 品質 性能 商品性 特定目的への適合性をはじめとする いかなる類の表明も保証も行いません Microchip 社は 本書の情報およびその使用に起因する一切の責任を否認します Microchip 社の明示的な書面による承認なしに 生命維持装置あるいは生命安全用途に Microchip 社の製品を使用する事は全て購入者のリスクとし また購入者はこれによって発生したあらゆる損害 クレーム 訴訟 費用に関して Microchip 社は擁護され 免責され 損害をうけない事に同意するものとします 暗黙的あるいは明示的を問わず Microchip 社が知的財産権を保有しているライセンスは一切譲渡されません 商標 Microchip 社の名称と Microchip ロゴ dspic FlashFlex KEELOQ KEELOQ ロゴ MPLAB PIC PICmicro PICSTART PIC 32 ロゴ rfpic SST SST ロゴ SuperFlash UNI/O は 米国およびその他の国における Microchip Technology Incorporated の登録商標です FilterLab Hampshire HI-TECH C Linear Active Thermistor MTP SEEVAL Embedded Control Solutions Company は 米国における Microchip Technology Incorporated の登録商標です Silicon Storage Technology は その他の国における Microchip Technology Incorporated の登録商標です Analog-for-the-Digital Age Application Maestro BodyCom chipkit chipkit ロゴ CodeGuard dspicdem dspicdem.net dspicworks dsspeak ECAN ECONOMONITOR FanSense HI-TIDE In-Circuit Serial Programming ICSP Mindi MiWi MPASM MPF MPLAB 認証ロゴ MPLIB MPLINK mtouch Omniscient Code Generation PICC PICC-18 PICDEM PICDEM.net PICkit PICtail REAL ICE rflab Select Mode SQI Serial Quad I/O Total Endurance TSHARC UniWinDriver WiperLock ZENA Z-Scale は 米国およびその他の国における Microchip Technology Incorporated の登録商標です SQTP は 米国における Microchip Technology Incorporated のサービスマークです GestICとULPPは その他の国におけるMicrochip Technology Germany II GmbH & Co. & KG (Microchip Technology Incorporated の子会社 ) の登録商標です その他 本書に記載されている商標は各社に帰属します 2013, Microchip Technology Incorporated, Printed in the U.S.A., All Rights Reserved. ISBN: QUALITY MANAGEMENT SYSTEM CERTIFIED BY DNV == ISO/TS == Microchip 社では Chandler および Tempe ( アリゾナ州 ) Gresham ( オレゴン州 ) の本部 設計部およびウェハー製造工場そしてカリフォルニア州とインドのデザインセンターが ISO/TS-16949:2009 認証を取得しています Microchip 社の品質システムプロセスおよび手順は PIC MCU および dspic DSC KEELOQ コードホッピングデバイス シリアル EEPROM マイクロペリフェラル 不揮発性メモリ アナログ製品に採用されています さらに 開発システムの設計と製造に関する Microchip 社の品質システムは ISO 9001:2000 認証を取得しています 2018 Microchip Technology Inc. DS B_JP - p. 59

60 各国の営業所とサービス 北米本社 2355 West Chandler Blvd. Chandler, AZ Tel: Fax: 技術サポート : support URL: アトランタ Duluth, GA Tel: Fax: オースティン (TX) Tel: ボストン Westborough, MA Tel: Fax: シカゴ Itasca, IL Tel: Fax: クリーブランド Independence, OH Tel: Fax: ダラス Addison, TX Tel: Fax: デトロイト Novi, MI Tel: ヒューストン (TX) Tel: インディアナポリス Noblesville, IN Tel: Fax: ロサンゼルス Mission Viejo, CA Tel: Fax: ニューヨーク (NY) Tel: サンノゼ (CA) Tel: カナダ - トロント Tel: Fax: アジア / 太平洋アジア太平洋支社 Suites , 37th Floor Tower 6, The Gateway Harbour City, Kowloon Hong Kong Tel: Fax: オーストラリア - シドニー Tel: Fax: 中国 - 北京 Tel: Fax: 中国 - 成都 Tel: Fax: 中国 - 重慶 Tel: Fax: 中国 - 東莞 Tel: 中国 - 杭州 Tel: Fax: 中国 - 香港 SAR Tel: Fax: 中国 - 南京 Tel: Fax: 中国 - 青島 Tel: Fax: 中国 - 上海 Tel: Fax: 中国 - 瀋陽 Tel: Fax: 中国 - 深圳 Tel: Fax: 中国 - 武漢 Tel: Fax: 中国 - 西安 Tel: Fax: アジア / 太平洋中国 - 厦門 Tel: Fax: 中国 - 珠海 Tel: Fax: インド - バンガロール Tel: Fax: インド - ニューデリー Tel: Fax: インド - プネ Tel: 日本 - 大阪 Tel: Fax: 日本 - 東京 Tel: Fax: 韓国 - 大邱 Tel: Fax: 韓国 - ソウル Tel: Fax: または マレーシア - クアラルンプール Tel: Fax: マレーシア - ペナン Tel: Fax: フィリピン - マニラ Tel: Fax: シンガポール Tel: Fax: 台湾 - 新竹 Tel: Fax: 台湾 - 高雄 Tel: 台湾 - 台北 Tel: Fax: タイ - バンコク Tel: Fax: ヨーロッパオーストリア - ヴェルス Tel: Fax: デンマーク - コペンハーゲン Tel: Fax: フランス - パリ Tel: Fax: ドイツ - デュッセルドルフ Tel: ドイツ - ミュンヘン Tel: Fax: ドイツ - プフォルツハイム Tel: イタリア - ミラノ Tel: Fax: イタリア - ベニス Tel: オランダ - ドリューネン Tel: Fax: ポーランド - ワルシャワ Tel: スペイン - マドリッド Tel: Fax: スウェーデン - ストックホルム Tel: イギリス - ウォーキンガム Tel: Fax: /27/15 DS B_JP - p Microchip Technology Inc.