mplab x ide user’s guideww1.microchip.com/downloads/jp/devicedoc/50002027d_jp.pdf1.7...

2016 Microchip Technology Inc. DS50002027D_JP

MPLAB® X IDEユーザガイド

注意 : この日本語版文書は参考資料としてご利用ください。新情報は必ずオリジナルの英語版をご参照願います。

Microchip 社製デバイスのコード保護機能に関して以下の点にご注意ください。

• Microchip 社製品は、該当する Microchip 社データシートに記載の仕様を満たしています。

• Microchip 社では、通常の条件ならびに仕様に従って使用した場合、Microchip 社製品のセキュリティレベルは、現在市場に

流通している同種製品の中でもも高度であると考えています。

• しかし、コード保護機能を解除するための不正かつ違法な方法が存在する事もまた事実です。弊社の理解では、こうした手法

は Microchip 社データシートにある動作仕様書以外の方法で Microchip 社製品を使用する事になります。このような行為は知

的所有権の侵害に該当する可能性が非常に高いと言えます。

• Microchip 社は、コードの保全性に懸念を抱いているお客様と連携し、対応策に取り組んでいきます。

• Microchip 社を含む全ての半導体メーカーで、自社のコードのセキュリティを完全に保証できる企業はありません。コード保

護機能とは、Microchip 社が製品を「解読不能」として保証するものではありません。

コード保護機能は常に進歩しています。Microchip 社では、常に製品のコード保護機能の改善に取り組んでいます。Microchip 社の

コード保護機能の侵害は、デジタルミレニアム著作権法に違反します。そのような行為によってソフトウェアまたはその他の著作

物に不正なアクセスを受けた場合、デジタルミレニアム著作権法の定めるところにより損害賠償訴訟を起こす権利があります。

本書に記載されているデバイスアプリケーション等に関する

情報は、ユーザの便宜のためにのみ提供されているものであ

り、更新によって無効とされる事があります。お客様のアプ

リケーションが仕様を満たす事を保証する責任は、お客様に

あります。Microchip 社は、明示的、暗黙的、書面、口頭、法

定のいずれであるかを問わず、本書に記載されている情報に

関して、状態、品質、性能、商品性、特定目的への適合性を

はじめとする、いかなる類の表明も保証も行いません。

Microchip 社は、本書の情報およびその使用に起因する一切の

責任を否認します。生命維持装置あるいは生命安全用途に

Microchip 社の製品を使用する事は全て購入者のリスクとし、

また購入者はこれによって発生したあらゆる損害、クレーム、

訴訟、費用に関して、Microchip 社は擁護され、免責され、損

害を受けない事に同意するものとします。暗黙的あるいは明

示的を問わず、Microchip 社が知的財産権を保有しているライ

センスは一切譲渡されません。

DS50002027D_JP - p. 2

商標

Microchip 社の名称とロゴ、Microchip ロゴ、dsPIC、FlashFlex、flexPWR、JukeBlox、KEELOQ、KEELOQlogo、Kleer、LANCheck、MediaLB、MOST、MOST logo、MPLAB、OptoLyzer、PIC、PICSTART、PIC32　logo、RightTouch、SpyNIC、SST、SSTLogo、SuperFlash および UNI/O は米国およびその他の国に

おける Microchip Technology Incorporated の登録商標です。

Embedded Control Solutions Company、mTouch は米国に

おける Microchip Technology Incorporated の登録商標です。

Analog-for-the-Digital Age、BodyCom、chipKIT、chipKIT logo、CodeGuard、dsPICDEM、dsPICDEM.net、ECAN、In-Circuit SerialProgramming、ICSP、Inter-Chip Connectivity、KleerNet、KleerNetlogo、MiWi、motorBench、MPASM、MPF、MPLAB Certified logo、MPLIB、MPLINK、MultiTRAK、NetDetach、Omniscient CodeGeneration、PICDEM、PICDEM.net、PICkit、PICtail、RightTouchlogo、REAL ICE、SQI、Serial Quad I/O、Total Endurance、TSHARC、USBCheck、VariSense、ViewSpan、WiperLock、Wireless DNA、および ZENA は米国およびその他の MicrochipTechnology Incorporated の商標です。

SQTP は米国における Microchip Technology Incorporated の

サービスマークです。

Silicon Storage Technology は他の国における MicrochipTechnology Inc. の登録商標です。

GestIC は Microchip Technology Inc. の子会社である MicrochipTechnology Germany II GmbH & Co. & KG 社の他の国における

登録商標です。

その他本書に記載されている商標は各社に帰属します。

© 2016, Microchip Technology Incorporated, All Rights Reserved.

ISBN: 978-1-5224-0619-8

2016 Microchip Technology Inc.

Microchip 社では、Chandler および Tempe ( アリゾナ州 )、Gresham ( オレゴン州 ) の本部、設計部およびウェハー製造工場そしてカリフォルニア州とインドのデザインセンターが ISO/TS-16949:2009 認証を取得しています。Microchip 社の品質システムプロセスおよび手順は、PIC® MCU および dsPIC® DSC、KEELOQ® コードホッピングデバイス、シリアル EEPROM、マイクロペリフェラル、不揮発性メモリ、アナログ製品に採用されています。さらに、開発システムの設計と製造に関する Microchip 社の品質システムは ISO 9001:2000 認証を取得しています。

MPLAB® X IDE
ユーザガイド
目次

序章 ................................................................................................................................. 9第 1 章 MPLAB X IDE とは

1.1 はじめに ....................................................................................................... 131.2 組み込みシステムの概要 .............................................................................. 141.3 開発サイクル ................................................................................................ 211.4 プロジェクトマネージャ ............................................................................. 221.5 言語ツール ................................................................................................... 231.6 デバッグ ....................................................................................................... 241.7 デバイスのプログラミング .......................................................................... 251.8 MPLAB X IDE の構成要素 ............................................................................ 261.9 MPLAB X IDE オンラインヘルプ ................................................................. 271.10 その他の MPLAB X IDE 関連文書 .............................................................. 281.11 ウェブサイト .............................................................................................. 301.12 MPLAB X ストア ........................................................................................ 301.13 MPLAB X IDE の更新 ................................................................................. 30

第 2 章使用前の準備

2.1 はじめに ....................................................................................................... 312.2 JRE と MPLAB X IDE のインストール ......................................................... 312.3 USB ドライバ ( ハードウェアツール用 ) のインストール .......................... 322.4 ターゲットとハードウェアツールの接続 .................................................... 362.5 言語ツールのインストール .......................................................................... 362.6 MPLAB IDE の起動とデスクトップの表示 .................................................. 372.7 [Start Page] からのアクセス情報 ................................................................. 382.8 [MPLAB X Store] での購入 ........................................................................... 402.9 IDE で複数のインスタンスを使う方法 ........................................................ 412.10 IDE で複数のバージョンを使う方法 .......................................................... 43

第 3 章チュートリアル

3.1 はじめに ....................................................................................................... 453.2 ハードウェアとソフトウェアのセットアップ ............................................. 463.3 プロジェクトの作成と設定 .......................................................................... 473.4 コードの実行とデバッグ .............................................................................. 64

第 4 章基本作業

4.1 MPLAB X IDE プロジェクトの作業手順 ...................................................... 714.2 新規プロジェクトの作成 .............................................................................. 724.3 プロジェクト作成後のデスクトップペイン ................................................ 82

2016 Microchip Technology Inc. DS50002027D_JP - p.3

MPLAB® X IDE ユーザガイド

4.4 プロジェクトプロパティの表示と変更 ....................................................... 834.5 デバッガ / プログラマツールオプションをセットアップまたは

変更する方法 .......................................................................................... 844.6 言語ツールオプションを設定または変更する方法 ...................................... 854.7 言語ツールのパスの指定 .............................................................................. 864.8 その他のツールオプションの設定 ............................................................... 884.9 ファイルの新規作成 ..................................................................................... 894.10 既存ファイルのプロジェクトへの追加 ...................................................... 914.11 エディタの使い方 ...................................................................................... 924.12 ライブラリやオブジェクトファイルの追加と設定 ................................... 934.13 ファイルおよびフォルダプロパティの設定 .............................................. 964.14 ビルドプロパティの設定 ............................................................................ 984.15 プロジェクトのビルド ............................................................................. 1024.16 コードの実行 ............................................................................................ 1034.17 コードのデバッグ実行 ............................................................................. 1044.18 ブレークポイントによるプログラム実行の制御 ...................................... 1064.19 コードのステップ実行 ............................................................................. 1094.20 シンボル値の変化の観察 .......................................................................... 1104.21 ローカル変数値の変化の観察 .................................................................. 1124.22 デバイスメモリ ( コンフィグレーションビットを含む ) の表示 / 変更 ... 1134.23 デバイスのプログラミング ...................................................................... 116

第 5 章追加作業

5.1 追加作業の概要 .......................................................................................... 1195.2 レガシー MPLAB プロジェクトのインポート ............................................ 1205.3 プリビルドプロジェクト ........................................................................... 1235.4 読み込み可能なプロジェクト、ファイル、シンボル ................................ 1245.5 読み込み可能なプロジェクトとファイル : ブートローダ .......................... 1295.6 ライブラリプロジェクト ........................................................................... 1305.7 その他の組み込みプロジェクト ................................................................. 1315.8 サンプルプロジェクト .............................................................................. 1315.9 他のタイプのファイルを使った作業 .......................................................... 1315.10 コードテンプレートの変更または作成 ................................................... 1325.11 ハードウェアツールまたは言語ツールの切り換え ................................. 1345.12 プロジェクトフォルダとエンコードの変更 ............................................ 1355.13 ビルド時間の短縮 .................................................................................... 1365.14 ストップウォッチの使用 .......................................................................... 1365.15 [Disassembly] ウィンドウの表示 ............................................................. 1375.16 コールスタックの表示 ............................................................................. 1375.17 コールグラフの表示 ................................................................................. 1385.18 ダッシュボードの表示 ............................................................................. 1395.19 コードの改良 ............................................................................................ 1425.20 ソースコードの管理 ................................................................................. 1425.21 コード開発とエラー追跡の連携 ............................................................... 1455.22 プラグインツールの追加 .......................................................................... 146

DS50002027D_JP - p.4 2016 Microchip Technology Inc.

目次

第 6 章高度な作業とコンセプト

6.1 はじめに ..................................................................................................... 1516.2 MPLAB X IDE の高速化 .............................................................................. 1516.3 複数プロジェクトを使った作業 ................................................................. 1536.4 複数コンフィグレーションを使った作業 ................................................... 1556.5 ユーザ Makefile プロジェクトの作成 ......................................................... 1586.6 MPLAB X IDE プロジェクトのパッケージ化 ............................................. 1666.7 サードパーティ製ハードウェアツール ..................................................... 1676.8 ログデータ ................................................................................................. 1676.9 ツールバーのカスタマイズ ........................................................................ 1686.10 チェックサム ............................................................................................ 1736.11 コンフィグレーション ............................................................................. 174

第 7 章エディタ

7.1 はじめに ..................................................................................................... 1757.2 ソースエディタの一般操作クイックリファレンス ................................... 1757.3 エディタの使い方 ....................................................................................... 1767.4 エディタのオプション ............................................................................... 1787.5 エディタの赤の感嘆符 ............................................................................... 1807.6 コード折り畳み .......................................................................................... 1817.7 C コードのリファクタリング ..................................................................... 185

第 8 章プロジェクトファイルおよびフォルダ

8.1 はじめに ..................................................................................................... 1878.2 [Projects] ウィンドウの表示 ....................................................................... 1878.3 [Files] ウィンドウの表示 ............................................................................ 1888.4 [Classes] ウィンドウの表示 ....................................................................... 1908.5 [Favorites] ウィンドウの表示 ..................................................................... 1908.6 ファイルまたはフォルダ名の制約 ............................................................. 1918.7 ユーザコンフィグレーションデータの表示 ............................................. 1918.8 MPLAB IDE v8 プロジェクトのインポート – 相対パス ............................. 1918.9 プロジェクトの移動、コピー、リネーム ................................................... 1918.10 プロジェクトの削除 ................................................................................. 192

第 9 章トラブルシュート

9.1 はじめに ..................................................................................................... 1939.2 USB ドライバのインストールに関する問題 .............................................. 1939.3 異なるプラットフォーム ( オペレーティングシステム ) で使う場合の

問題 ...................................................................................................... 1939.4 Windows OS で使う場合の問題 ................................................................. 1939.5 NetBeans プラットフォームの問題 ........................................................... 1949.6 MPLAB X IDE の問題 ................................................................................. 1959.7 エラー ......................................................................................................... 1989.8 フォーラム ................................................................................................. 202

第 10 章 MPLAB X IDE と MPLAB IDE v8 の相違点

10.1 はじめに ................................................................................................... 20310.2 主な相違点 ............................................................................................... 203



10.3 メニューの相違点 .................................................................................... 20610.4 ツールのサポートに関する相違点 ........................................................... 21310.5 その他の注意事項 .................................................................................... 214

第 11 章デスクトップの詳細

11.1 はじめに ................................................................................................... 21511.2 メニュー ................................................................................................... 21611.3 Toolbars ................................................................................................... 22811.4 ステータスバー ........................................................................................ 23111.5 メニュー項目とボタンの灰色表示または非表示 ...................................... 231

第 12 章 MPLAB X IDE のウィンドウとダイアログ

12.1 はじめに ................................................................................................... 23312.2 MPLAB X IDE のウィンドウの管理 ......................................................... 23312.3 MPLAB X IDE のウィンドウと関連するメニューとダイアログ .............. 23412.4 [Call Stack] ウィンドウ ............................................................................ 23512.5 [Breakpoints] ウィンドウ ......................................................................... 23612.6 [Customize Toolbars] ウィンドウ ............................................................ 24012.7 [Dashboard] ウィンドウ ........................................................................... 24012.8 [Hardware Stack] ウィンドウ ................................................................... 24112.9 [Memory] ウィンドウ ............................................................................... 24212.10 [Message Center] ウィンドウ ................................................................ 25212.11 [Output] ウィンドウ ................................................................................ 25312.12 [Project Properties] ウィンドウ .............................................................. 25412.13 [Projects] ウィンドウ ............................................................................. 25412.14 [Tools] > [Options] > [Embedded] ウィンドウ ........................................ 25912.15 [Trace] ウィンドウ ................................................................................. 26512.16 [Watches] ウィンドウ ............................................................................ 26612.17 ウィザードウィンドウ .......................................................................... 270

第 13 章 NetBeans のウィンドウとダイアログ

13.1 はじめに ................................................................................................... 27113.2 NetBeans ウィンドウとウィンドウメニュー .......................................... 27113.3 NetBeans ダイアログ ............................................................................... 271

補遺 A コンフィグレーション設定のまとめ

A.1 はじめに .................................................................................................... 273A.2 XC ツールチェーン .................................................................................... 273A.3 MPASM ツールチェーン ............................................................................ 274A.4 C18 ツールチェーン .................................................................................. 275A.5 HI-TECH® PICC™ ツールチェーン ........................................................... 276A.6 HI-TECH® PICC-18™ ツールチェーン ...................................................... 276A.7 ASM30 ツールチェーン ............................................................................. 277A.8 C30 ツールチェーン .................................................................................. 277A.9 C32 ツールチェーン .................................................................................. 279


目次

補遺 B IDE 外部での作業手順

B.1 はじめに ..................................................................................................... 281B.2 MPLAB X IDE 外部でのデバッグのためのコンパイル .............................. 282B.3 MPLAB X IDE の外部でのプロジェクトのビルド ..................................... 283B.4 MPLAB X IDE 外部での Makefile の作成 ................................................... 284B.5 リビジョン管理システムの使い方 ............................................................. 293

補遺 C 改訂履歴 .......................................................................................................... 295サポート ...................................................................................................................... 299用語集 ......................................................................................................................... 303索引 ............................................................................................................................. 323各国の営業所とサービス.............................................................................................. 330


MPLAB® X IDE
ユーザガイド
序章

はじめに

序章には、MPLAB® X IDE を使い始める前に知っておくと便利な一般情報を記載しています。主な内容は以下の通りです。

• 本書の構成

• 表記規則

• 推奨参考資料

本書の構成

本書では MPLAB X IDE の使い方を説明します。以下に本書の構成を示します。

• 第 1 章「MPLAB X IDE とは」 – MPLAB X IDE の概要とヘルプの使い方

• 第 2 章「使用前の準備」 – ハードウェアツール用 USB ドライバと、コードのコンパイル / アセンブルに使う言語ツールパッケージのインストール方法

• 第3章「チュートリアル」 – MPLAB X IDEを使うための各種機能の手順を追った説明

• 第 4 章「基本作業」 – MPLAB X IDE の基本機能 ( 前章「チュートリアル」で使った機能の詳細な説明 )

• 第 5 章「追加作業」 – MPLAB X IDE の追加機能 ( 例 : MPLAB IDE v8 プロジェクトのインポート、ストップウォッチ )

• 第 6 章「高度な作業とコンセプト」 – MPLAB X IDE の高度な機能 ( 例 : 複数プロジェクトの使用、プロジェクトコンフィグレーション )

• 第 7 章「エディタ」 – エディタ機能の概要 ( エディタの詳細は NetBeans のヘルプを参照してください )

お客様へのご注意

どのような文書でも内容は時間が経つにつれ古くなります。本書も例外ではありません。お客様のニーズを満たすため、Microchip 社の製品は常に改良を重ねており、実際のダイアログやツールが本書の内容とは異なる場合があります。新文書はMicrochip社のウェブサイト (www.microchip.com)をご覧ください。

文書は「DS」番号によって識別します。この識別番号は各ページのフッタのページ番号の前に表記しています。DS 番号「DSXXXXXXXXA」の「XXXXXXXX」は文書番号、「A」は文書のリビジョンレベルを表します。

開発ツールの新情報は MPLAB® X IDE のオンラインヘルプでご覧になれます。[Help] メニューから[Topics] を選択すると、オンラインヘルプファイルのリストが表示されます。



• 第 8 章「プロジェクトファイルおよびフォルダ」 – ファイルとフォルダの表示の他に、ファイル操作に関する情報の表示とファイル操作方法の表示に使う MPLAB XIDE のウィンドウ

• 第 9 章「トラブルシュート」 – 問題への対処方法

• 第 10 章「MPLAB X IDE と MPLAB IDE v8 の相違点」 – MPLAB IDE v8 との主な相違点 ( 機能、メニュー、ツールサポート等 )

• 第 11 章「デスクトップの詳細」 – MPLAB X IDE デスクトップアイテム ( メニュー、ツールバー、ステータスバー等 )

• 第 12 章「MPLAB X IDE のウィンドウとダイアログ」 - MPLAB X IDE 専用ウィンドウおよびダイアログ

• 第 13 章「NetBeans のウィンドウとダイアログ」- MPLAB X IDE で利用できるNetBeans™ ウィンドウおよびダイアログ

• 補遺 A「コンフィグレーション設定のまとめ」 – 各種の言語ツールを使ってコード内でコンフィグレーションビットをセットする方法 ([Configurations Settings] 設定ウィンドウは、デバッグ用に一時的にコンフィグレーションビットを設定するだけであるため、MPLAB X IDE ではこの手順が必要です )

• 補遺 B「IDE 外部での作業手順」 – IDE 外で使える MPLAB X IDE のファイルの作成方法 (IDE 外で作成されたファイルの、MPLAB X IDE へのインポート方法も説明します )

• 補遺 C「改訂履歴」 – 本書の変更履歴


序章

表記規則

本書では以下の表記規則を適用します。

本書の表記規則

表記適用例

Arial、MS ゴシックフォント

二重かぎカッコ : 『』参考資料『MPLAB® IDE ユーザガイド』

太字テキストの強調 ... は唯一のコンパイラです ...角カッコ : [ ] ウィンドウ名 [Output] ウィンドウ

ダイアログ名 [Settings] ダイアログ

メニューの選択肢 [Enable Programmer] を選択

ウィンドウまたはダイアログ内のフィールド名、メニュー項目名

[Save project before build]

右山カッコ (>) で区切り角カッコで囲んだテキスト( 下線付き )

メニューの選択方法( テキスト内に記載の場合 )

[File] > [Save]

右山カッコ (>) で区切り角カッコで囲んだテキスト( 下線なし )

メニューの選択方法( 表セル内に記載の場合 )

[File] > [Save]

角カッコ ([ ]) で囲んだ太字のテキスト

ダイアログのボタン [OK] をクリックする

タブ [Power] タブをクリックする

山カッコ (< >) で囲んだテキスト

キーボードのキー <Enter>、<F1> を押す

Courier New フォント

標準書体の Courier New サンプルソースコード #define STARTファイル名 autoexec.batファイルパス c:\mcc18\hキーワード _asm, _endasm, staticコマンドラインオプション -Opa+, -Opa-ビット値 0, 1定数 0xFF,’A’

斜体の Courier New 変数の引数 file.o (fileは有効な任意のファイル名 )

角カッコ : [ ] オプションの引数 mpasmwin [options] file [options]

中カッコとパイプ文字 : { | } どちらかの引数を選択する場合 (OR 選択 )

errorlevel {0|1}

省略記号 : ... 繰り返されるテキスト var_name [, var_name...]

ユーザが定義するコード void main (void){ ...}



推奨参考資料

本書は、MPLAB X IDE の使い方を記載したユーザガイドです。参考資料として、Microchip 社が提供する以下の文書を推奨します。

MPLAB IDE の Reademe ファイル

MPLAB X IDE の使い方に関する新情報は、[Start Page] の [Release Notes andSupport Documentation] の見出しからリリースノートを開いてお読みください。リリースノートには、本書に記載できなかった新情報と既知の問題を記載しています。

Readme ファイル

各種ツールの新の使用方法は、MPLAB X IDE インストールフォルダの「Readmes」サブフォルダ内にある各ツールの Readme ファイルを参照してください。Readmeファイルには、ユーザガイドに記載できなかった新情報と既知の問題を記載しています。

オンラインヘルプファイル - MPLAB X IDEMPLAB X IDE、MPLAB エディタ、MPLAB SIM シミュレータ、Microchip 社のコンパイラ、その他の開発ツールではチュートリアル、機能説明、参照資料を含む包括的なヘルプファイルを利用できます。

オンラインヘルプファイル - NetBeans プラットフォーム

プラットフォーム関連の内容に対するヘルプを利用できます。オンライン上の文書は以下を参照してください。

『NetBeans Developing Applications with NetBeans IDE, Release 8.0, E50452-06』

デバイスデータシートとファミリリファレンスマニュアル

全てのPIC® MCUとdsPIC® DSCのデータシートと関連するデバイスファミリリファレンスマニュアルの新版は、Microchip 社ウェブサイト (http://www.microchip.com)でご覧になれます。


http://docs.oracle.com/cd/E50453_01/doc.80/e50452/toc.htm

http://www.microchip.com

MPLAB® X IDE
ユーザガイド
第 1 章 MPLAB X IDE とは

1.1 はじめに

MPLAB® X IDE は、Microchip 社製マイクロコントローラとデジタルシグナルコントローラ向けのアプリケーション開発用ソフトウェアです ( 組み込みシステムの設計に既に詳しい読者は、この章を読まずに次章へ進んでもかまいません )。この開発ツールは統合開発環境 (IDE) と呼ばれ、組み込みマイクロコントローラのコード開発向けに 1 つに統合された「環境」を提供します。この章では、組み込みシステムの開発を説明し、その過程における Microchip 社のMPLAB X IDE の使われ方を簡単に説明します。

本章の内容は以下の通りです。

•「組み込みシステムの概要」

•「開発サイクル」

•「プロジェクトマネージャ」

•「言語ツール」

•「デバッグ」

•「デバイスのプログラミング」

•「MPLAB X IDE の構成要素」

•「MPLAB X IDE オンラインヘルプ」

•「その他の MPLAB X IDE 関連文書」

•「ウェブサイト」

•「MPLAB X ストア」

•「MPLAB X IDE の更新」



1.2 組み込みシステムの概要

一般的に組み込みシステムとは、Microchip 社の PIC® マイクロコントローラ (MCU)や dsPIC® デジタルシグナルコントローラ (DSC) 等の小型マイクロコントローラの機能を利用したシステムを指します。このようなマイクロコントローラは、マイクロプロセッサユニット (PC の CPU に相当 ) と「周辺モジュール」と呼ぶ付加回路で構成され、さらに、外部デバイスの数を減らすために、小規模の制御モジュール回路が同一チップ上に追加されています。このように 1 つのチップに集積されたデバイスを電子 / 機械装置に組み込む事により、低コストのデジタル制御が実現します。

1.2.1 組み込みコントローラと PC の違い

組み込みコントローラは、1 つまたは複数の限定されたタスクだけを実行するという点で、PC とは大きく異なります。PC は不特定のプログラムを実行でき、各種の外部デバイスへ接続できます。組み込みコントローラは 1 つのプログラムだけを実行するため、そのタスクの実行に必要な処理能力とハードウェアだけを実装するだけで済み、結果として価格を低く抑える事ができます。

対して PC は、比較的高価な汎用中央演算装置 (CPU) を核とし、多数の外部デバイス( メモリ、ディスクドライブ、ビデオコントローラ、ネットワークインターフェイス回路等 ) を備える必要があります。組み込みシステムは、演算装置として低コストのMCU を使い、同一チップに各種の周辺回路を含める事により、比較的少数の外部デバイスしか必要としません。多くの場合、組み込みシステムは各種製品 ( コードレスドリル、冷蔵庫、車庫用のオートシャッター等 ) の内部製品またはサブモジュールとして使われます。このようなコントローラは、製品の全体機能の中のごく限られた部分だけに関与します。また、コントローラは、デバイス内の重要サブシステムの一部に低コストのインテリジェンス機能を付加します。

組み込みシステムの例として煙感知器があります。煙感知器はセンサの信号を評価し、煙の発生を示す信号を検出すると警報を鳴らします。煙感知器が内蔵する小規模のプログラムは、無限ループを実行して煙センサの信号をサンプリングするか、あるいは普段は低消費電力の「スリープ」で待機し、センサからの信号によって復帰します。復帰したプログラムは、その時点で警報を鳴らします。通常、このようなプログラムは、動作テストや電池残量アラーム等の機能も備えています。センサとオーディオ出力を備えた PC にも同様の機能を持たせる事は可能ですが、対費用効果が低く、9 V のバッテリ 1 個だけで何年間も無人稼動させる事はできません。煙感知器、カメラ、携帯電話、家電製品、自動車、スマートカード、セキュリティシステム等の日用品へのインテリジェンス機能の組み込みには、多くの場合安価なマイクロコントローラが使われます。

1.2.2 マイクロコントローラの構成要素

PIC MCU は、プログラム ( 図 1-2) を実行するためのファームウェア ( コード化された命令 ) を格納するプログラムメモリ ( 図 1-1) を内蔵しています。プログラムメモリのアドレス ( リセットおよび割り込みアドレスを含む ) 指定には、プログラムカウンタ(PC) を使います。コード内のコールおよびリターン命令では、ハードウェアスタックを使います。このスタックはプログラムメモリと連携して動作しますが、プログラムメモリの一部ではありません。プログラムメモリの動作の詳細 ( ベクタ、スタック等 ) は、デバイスデータシートに記載しています。


MPLAB X IDE とは

図 1-1: PIC® MCU のデータシート – プログラムメモリとスタック

図 1-2: PIC® MCU のデータシート – 命令 ( 抜粋 )

マイクロコントローラは、データ ( またはファイルレジスタ ) メモリも内蔵しています。このメモリは、特殊機能レジスタ (SFR) と汎用レジスタ (GPR) で構成されます( 図 1-4 参照 )。SFR は、デバイスの動作を制御するために CPU と周辺機能が使うレジスタです。GPR は、プログラムの計算に必要な変数等の一時的なデータの格納用に使います。マイクロコントローラには、データ EEPROM メモリを内蔵するものもあります。プログラムメモリと同様に、データメモリの使い方と動作の詳細も、デバイスデータシートに記載しています。

PC<12:0>

13

0000h

0004h

1000h

1FFFh

Stack Level 1

Stack Level 8

Reset Vector

Interrupt Vector

CALL, RETURNRETFIE, RETLW

Stack Level 2

Access 0-FFFh

0005h

07FFh0800h

Page 0

Page 10FFFh

On-ChipProgramMemory



図 1-3: PIC® MCU のデータシート – ファイルレジスタ File File File FileAddress Address Address Address

Indirect addr.(1) 00h Indirect addr.(1) 80h Indirect addr.(1) 100h Indirect addr.(1) 180hTMR0 01h OPTION_REG 81h TMR0 101h OPTION_REG 181hPCL 02h PCL 82h PCL 102h PCL 182h

STATUS 03h STATUS 83h STATUS 103h STATUS 183hFSR 04h FSR 84h FSR 104h FSR 184h

PORTA 05h TRISA 85h PORTA 105h TRISA 185hPORTB 06h TRISB 86h PORTB 106h TRISB 186hPORTC 07h TRISC 87h PORTC 107h TRISC 187h

08h 88h 108h 188h09h 89h 109h 189h

PCLATH 0Ah PCLATH 8Ah PCLATH 10Ah PCLATH 18AhINTCON 0Bh INTCON 8Bh INTCON 10Bh INTCON 18Bh

PIR1 0Ch PIE1 8Ch EEDAT 10Ch EECON1 18ChPIR2 0Dh PIE2 8Dh EEADR 10Dh EECON2(1) 18Dh

TMR1L 0Eh PCON 8Eh EEDATH 10Eh 18EhTMR1H 0Fh OSCCON 8Fh EEADRH 10Fh 18FhT1CON 10h OSCTUNE 90h 110h 190hTMR2 11h 91h 111h 191h

T2CON 12h PR2 92h 112h 192hSSPBUF 13h SSPADD(2) 93h 113h 193hSSPCON 14h SSPSTAT 94h 114h 194hCCPR1L 15h WPUA 95h WPUB 115h 195hCCPR1H 16h IOCA 96h IOCB 116h 196h

CCP1CON 17h WDTCON 97h 117h 197hRCSTA 18h TXSTA 98h VRCON 118h 198hTXREG 19h SPBRG 99h CM1CON0 119h 199hRCREG 1Ah SPBRGH 9Ah CM2CON0 11Ah 19Ah

1Bh BAUDCTL 9Bh CM2CON1 11Bh 19BhPWM1CON 1Ch 9Ch 11Ch 19Ch

ECCPAS 1Dh 9Dh 11Dh PSTRCON 19DhADRESH 1Eh ADRESL 9Eh ANSEL 11Eh SRCON 19EhADCON0 1Fh ADCON1 9Fh ANSELH 11Fh 19Fh

General Purpose Register

96 Bytes

20h


80 Bytes

A0h


80 Bytes

120h 1A0h

EFh 16Fhaccesses70h-7Fh

F0h accesses70h-7Fh

170h accesses70h-7Fh

1F0h7Fh FFh 17Fh 1FFh

Bank 0 Bank 1 Bank 2 Bank 3

未実装のデータメモリ領域、「0」として読み出し

Note 1: 物理レジスタではありません。

2: アドレス 93h は、特定条件において SSP マスク (SSPMSK) にもアクセスします。


MPLAB X IDE とは

メモリ以外にも、マイクロコントローラは同一チップ上に多数の周辺デバイス回路を内蔵しています ( 図 1-4)。周辺デバイスには入出力 (I/O ポート ) を含みます。I/O ポートとは出力として使用可能なマイクロコントローラのピンであり、High/Low に駆動する事により信号の送信、ランプの点滅、スピーカの駆動等、配線を通して実行できます。多くの場合これらのピンは双方向であり、入力として構成する事もできます。入力として使う場合、外部スイッチまたはセンサからの入力に対する応答、外部デバイスとの通信が可能です。

図 1-4: PIC® MCU のデータシート – ブロック図 ( 抜粋 )

このようなシステムを設計する場合、まずアプリケーションに必要な周辺モジュールを選択します。

一般的な周辺モジュールは以下の通りです。

• A/D コンバータ (ADC) を使うと、マイクロコントローラに接続したセンサから電圧信号を取り込めます。

• シリアル通信モジュールを使うと、配線を通して別のマイクロコントローラ、ローカルネットワーク、インターネットとストリーム通信できます。

• PIC MCU 上の「タイマ」周辺モジュールは、信号イベントの正確な計測、通信信号の生成 / 受信、正確な波形生成を行うだけでなく、電源瞬断やハードウェア誤作動によるハングアップやフリーズが発生した場合に、マイクロコントローラを自動リセットします。

• その他に、外部電源が危険レベルまで低下した事を検出し、電力供給が完全に途絶える前に重要な情報を保存して、マイクロコントローラを安全にシャットダウンするための周辺モジュールもあります。

PORTA

PORTB

PORTC

RA4/T0CKIRA5/AN4/LVDIN

RB0/INT0

RC0/T1OSO/T13CKIRC1/T1OSI/CCP2RC2/CCP1RC3/SCK/SCLRC4/SDI/SDARC5/SDORC6/TX1/CK1RC7/RX1/DT1

RA3/AN3/VREF+RA2/AN2/VREF-RA1/AN1RA0/AN0

RB1/INT1

Data Latch

Data RAM

Address Latch

Address<12>12

Bank0, FBSR FSR0FSR1FSR2

Inc/DecLogicDecode

4 12 4PCH PCL

PCLATH

8

31 Level Stack

Program CounterAddress Latch

Program

Data Latch

21

21

16

Table Pointer<21>218

Data Bus<8>

Table Latch

8

IR

12

ROM Latch

RB2/INT2RB3/INT3

PCLATU

PCU

RA6

RB4/KBI0RB5/KBI1/PGMRB6/KBI2/PGCRB7/KBI3/PGD

Memory

Inc/Dec Logic



使うべき PIC MCU は、アプリケーションプログラムが必要とする周辺モジュールとメモリ容量によってほぼ決まります。その他の選択基準としては、マイクロコントローラの消費電力とフォームファクタ ( 回路に実装可能なサイズとパッケージ形態( 図 1-5)) が挙げられます。

図 1-5: PIC® MCU のパッケージ例

電力が供給され、オシレータがクロック信号 ( 図 1-6) を生成し始めるとマイクロコントローラはアクティブになります。マイクロコントローラによっては、複数の内部または外部オシレータ動作モードを備えている場合があります。

図 1-6: PIC® MCU のデータシート – タイミング ( 抜粋 )

c

21

n

DD1

B

p

#leads=n1E1E

A2

A1

A

L

CH x 45

(F)

Q3Q2Q1Q4Q3Q2

OSC1

Internal

SCS(OSCCON<0>)Program PC + 2PC

Q1

T1OSI

Q4 Q1

PC + 4

Q1

TSCS

Clock

Counter

System

Q2 Q3 Q4 Q1

TDLY

TT1P

TOSC

21 3 4 5 6 7 8


MPLAB X IDE とは

1.2.3 MPLAB X IDE による組み込みシステム回路の実装

組み込みコントローラ用開発システムは PC 上で動作し、組み込みシステムアプリケーションのコード作成、編集、デバッグと、デバイスへの書き込みを支援するソフトウェアです。MPLAB X IDE は、組み込みシステムアプリケーションの設計と実装に必要な全ての要素を備えています。

組み込みコントローラアプリケーションの開発における代表的な作業手順は以下の通りです。

1. まず全体的な回路構成を設計します。次に、必要な機能と性能に基づいて、そのアプリケーションに適な PIC MCU または dsPIC DSC を選択し、関連するハードウェア回路を設計します。ハードウェアを制御する周辺モジュールとピンを決定したら、ファームウェア ( 組み込みアプリケーションのハードウェアを制御するためのソフトウェア ) を作成します。これには、マシンコードに直接変換可能なアセンブラや、高級プログラミング言語 (C 言語、BASIC 等 ) 用のコンパイラを使います。アセンブラやコンパイラでは、関数や変数にプログラム内の参照先ルーチンや用途に対応した名前を付けてコードを読みやすくできます。また、コードを構造化する事により、良好な保守性が得られます。

2. アセンブラ、コンパイラ、リンカを使ってソフトウェアをコンパイル、アセンブル、リンクします。これにより、コードを 1 と 0 だけで記述したマシンコード (PICMCU が実行できるコード ) に変換します。終的には、このマシンコードをファームウェアとしてマイクロコントローラに書き込みます。

3. 作成したコードをマイクロコントローラに書き込む前に、動作をテストします。複雑なプログラムでは、初から期待通りに動作する事は稀であり、正しく動作させるためにプログラムの「バグ」を取り除く必要があります。デバッガを使うと、マシンコードの実行状態をソースコード内の関数名と変数名に対応させて観察できます。デバッグ作業では、プログラムのシングルステップ実行による変数値の確認や、その値を変更してルーチンの動作を確認する「what if」チェックが可能です。

4. 後に、マシンコードをマイクロコントローラに「書き込んで」、終的にアプリケーション内で正しく動作する事を確認します。

上記の手順はいずれも非常に複雑な作業を伴います。このような作業では、設計そのものに専念できる環境が重要です。MPLAB X IDE を使う事により、煩わしい操作の習得に時間を費やさずに、本来の設計作業に集中できます。



ステップ 1 は設計段階ですが、設計上の重要な判断を下すために、MPLAB X IDE を回路とコードのモデル化に役立てる事ができます。

MPLAB X IDE は、特にステップ 2 ～ 4 で真価を発揮します。プログラミング用エディタは各種言語ツールに対応し、コード作成を支援します。このエディタは、アセンブラとコンパイラのプログラミング構造を認識して、自動的にソースコードを色分け表示します。このため、構文の誤り等を容易に見つけ出せます。プロジェクトマネージャにより、アプリケーションで使う各種ファイル ( ソースファイル、プロセッサ記述ヘッダファイル、ライブラリファイル ) を容易に管理できます。コードをビルドする際に、コンパイラによるコードの適化 ( 実行速度またはバイナリサイズ優先 ) レベル、変数とプログラムデータのメモリ格納領域を設定できます。マイクロコントローラのメモリをアプリケーション用に大限に活用するために、「メモリモデル」を指定する事もできます。アプリケーションのビルド中に言語ツールでエラーが発生すると、エラー発生行が表示されます。その行をダブルクリックしてソースファイルを即座に修正できます。コード修正後にアプリケーションを再ビルドして、エラーがないか確認します。複雑なコードでは、複数のサブセクションを作成してテストする必要があるため、記述 - コンパイル - 修正のループを繰り返すのが普通です。MPLAB X IDE を使うと、このループを短時間で終わらせて次のステップへ進む事ができます。

コードのビルドでエラーが発生しなくなったら、次はコードの動作をテストします。MPLAB X IDE は、コードのテストを支援するために、全ての PIC MCU と dsPIC DSCに対応するデバッガとソフトウェアシミュレータを備えています。ソフトウェアシミュレータを使うと、ハードウェアが完成する前に、マイクロコントローラの動作をシミュレートしてコードをテストできます。シミュレータは、外部信号に対するファームウェアの応答をモデル化します。このため、シミュレートした外部信号( スティミュラス ) を入力する必要があります。シミュレータでは、実行時間の計測、コードのシングルステップ実行による変数と周辺モジュールの観察、コードのトレースによるプログラム実行状態の詳細な記録等が可能です。

プロトタイプのハードウェアをアプリケーションに組み込める段階になると、インサーキットエミュレータやインサーキットデバッガ等のハードウェアデバッガを使えます。これらのデバッグツールは、フラッシュメモリ内蔵デバイスの多くが備える特殊な回路を使って、実際のアプリケーション上でコードをリアルタイムに実行します。これらのツールを使うと、プログラムの実行を停止 / 再開して、ターゲットマイクロコントローラのプログラムメモリとデータメモリの内容を観察できるため、アプリケーションにマイクロコントローラを組み込んだ状態でコードをテストできます。

アプリケーションが正常に動作したら、Microchip 社のデバイスプログラマまたは開発用プログラマを使って、マイクロコントローラにプログラムを書き込みます。これらのプログラマは、完成したコードが設計通りに動作する事を検証します。MPLAB X IDE は、ほとんどの PIC MCU と全ての dsPIC DSC をサポートします。


MPLAB X IDE とは

1.3 開発サイクル

アプリケーションコードを作成するプロセスは、しばしば開発「サイクル」と呼ばれます。これは、設計から実装までの一連のステップを 1 回で問題なく完了できる事は稀なためです。正しく動作するアプリケーションを開発するには、コードの記述 /テスト / 修正を何度も繰り返す必要があります。統合開発環境は、このような開発において複数のツールを何度も切り換える煩わしさからエンジニアを解放します。全ての機能を統合する MPLAB X IDE を使えば、ツールや動作モードの切り換えのたびに作業を中断する必要がなくなるため、アプリケーション開発に集中できます。

図 1-7: 設計サイクル

MPLAB X IDE は、共通のグラフィカルユーザインターフェイスを介して全てのツールを ( 通常は自動的に ) 連動させる「ラッパー」として機能します。例えば、ソースコードを記述し、これを実行可能なマシンコードに変換し、マイクロコントローラに書き込み、その動作を確認するといった一連の作業を共通の環境内で実行できます。開発プロセスでは、コードを記述するためのエディタ、ファイルと設定を管理するためのプロジェクトマネージャ、ソースコードをマシンコードに変換するためのコンパイラまたはアセンブラ、マイクロコントローラと接続またはマイクロコントローラの動作をシミュレートするための各種ハードウェア / ソフトウェア等、複数のツールが必要です。

Download Code toDebugger

Analyze/DebugCode

Compile/Assemble/Link Code

Edit/Create/DesignSource Code



1.4 プロジェクトマネージャ

プロジェクトマネージャは、編集したファイルを他の関連ファイルと一緒にまとめて、アセンブルまたはコンパイル用の言語ツールに渡します。これらのファイルは終的にリンカへ渡されます。リンカは、アセンブラ / コンパイラ / ライブラリから受け取った複数のオブジェクトコードを組み込みコントローラのメモリ空間に適切に配置して、各モジュールが相互に機能できるようにリンクさせます。このようなアセンブル / コンパイルからリンクまでのプロセス全体を、プロジェクトの「ビルド」と呼びます。必要に応じて、ファイルごとに異なる言語ツール向けのプロパティを呼び出す事ができます。このような場合でも、ビルドプロセスが全ての言語ツールの動作を統合します。

図 1-8: MPLAB® X IDE のプロジェクトマネージャ

ソースファイルは、アセンブラまたはコンパイラの規則に従って書かれたテキストファイルです。アセンブラとコンパイラは、これらのソースファイルを複数の中間的なマシンコードモジュールに変換します。この際、関数とデータを参照するためにプレースホルダも生成されます。リンカはこれらのプレースホルダを解決し、全てのモジュールから実行可能なマシンコードファイルを生成します。リンカはデバッグファイルも生成します。MPLAB XIDE は、このデバッグファイルに基づいて、実行用マシンコードを元のソースファイルに関連付けます。

コードの作成にはテキストエディタを使います。このエディタはテキストの構造を認識し、命令ニーモニック、C 言語の構造体、コメント等の各種エレメントを色分け表示します。エディタは、ソースコードの作成に必要な一般的な機能を備えています。コード作成後、エディタは他のツールと連携してデバッガ内でのコードの実行状態を表示します。エディタでブレークポイント ( コードの実行を一時停止 ( ブレーク ) する位置 ) を設定してプログラムを実行し、変数名の上にマウスポインタを置くと変数値を表示できます。変数名をソーステキストウィンドウからウォッチウィンドウにドラッグ & ドロップすると、各ブレークポイントで停止した時またはコード実行中に変数値の変化を観察できます。

IndividualBuild

Options

LinkerScript

Linker

DebugFile

ExecutableFile

Assembler Compiler

SourceFiles

ObjectFile

Libraries


MPLAB X IDE とは

1.5 言語ツール

「言語ツール」とは、クロスアセンブラやクロスコンパイラ等のプログラムを指します。Visual Basic や C コンパイラのように、PC 上で動作する言語ツールが一般的によく知られていますが、組み込みシステムでは「クロスアセンブラ」または「クロスコンパイラ」を言語ツールとして使います。これらのツールも PC 上で動作しますが、その PC ではなく別のマイクロプロセッサ (またはマイクロコントローラ )上で動作するコードを生成します。

これらの言語ツールはデバッグファイルも生成します。MPLAB X IDE は、デバッグファイルを使って、マシン語命令とメモリ領域をソースコードに関連付けます。この関連付けにより、MPLAB X IDE エディタによるブレークポイントの設定とウォッチウィンドウによる変数の表示が可能となり、ソースコードをシングルステップ実行してアプリケーションの動作を観察できるようになります。

組み込みシステムの言語ツールは、コードサイズが非常に重要視されるという点でも、一般的なコンパイラと異なります。これは、コードサイズを小さくできればマイクロコントローラのメモリサイズを小さくでき、それだけコストを削減できるからです。このため、ターゲットデバイスを熟知してコードを適化するための技量が求められます。

一般的な PC 用プログラムの場合、ある程度複雑なプログラムになると、そのサイズは数 MB に達します。これに対し、単純な組み込みシステムのプログラムであれば、1 KB 以下に収める事ができます。比較的複雑な機能を実行する中規模の組み込みシステムになると、32K または 64K のメモリサイズが必要になる場合もあります。組み込みシステムの中には、大規模なテーブル、ユーザテキストメッセージ、データのロギングに何 MB ものストレージを使うものもあります。

図 1-9: コンパイラによるソースコードからマシンコードへの変換

int main (void){ counter = 1; TRISB =0; while (input1 = 0) { PORTB = count; counter++; }}

COMPILER

0110111110001000110011011010000100110011010111010011000111100101



1.6 デバッグ

アプリケーション開発では、コードの動作をテストするためにデバッガを使います。デバッガには、マイクロコントローラの動作を PC 上でシミュレートするソフトウェアプログラム ( シミュレータ ) と、実際のアプリケーション内でプログラムの動作を解析できるハードウェアデバイス ( ハードウェアデバッガ ) があります。

1.6.1 ソフトウェアデバッガ

MPLAB X IDE はシミュレータを内蔵しているため、ハードウェアを追加しなくても、PC 上でプログラムをテストできます。シミュレータはソフトウェアデバッガとも呼ばれ、その機能はハードウェアデバッガとほぼ同じです。このためシミュレータの使い方を習得すれば、ハードウェアデバッガも容易に使えます。シミュレータは PCの CPU を使ってマイクロコントローラの動作をシミュレートするため、通常は実際のマイクロコントローラよりも低速で動作します。

1.6.2 ハードウェアデバッガ

MPLAB X IDE で使えるハードウェアには、プログラマとハードウェアデバッガの2 種類があります。プログラマは、PC 上で作成したマシンコードを、マイクロコントローラの内部メモリに書き込みます。これにより、アプリケーションに組み込んだマイクロコントローラ上でプログラムを実行できるようになります。

しかし、初からコードが期待通りに機能する事はきわめて稀です。そこで実際のアプリケーションでプログラムの動作をよく観察して、期待通りの動作が得られるようにソースコードを修正する必要があります。このプロセスを「デバッグ」と呼びます。既に説明した通り、シミュレータは PC 上でコードの動作をテストできますが、マイクロコントローラにプログラムを書き込んで実際のアプリケーションで動作させると、シミュレータでは見つからなかった問題が多数発生します。プログラマだけでも、コードを変更してマイクロコントローラにプログラムし直し、ターゲットにプラグインして再テストできますが、コードが複雑な場合、長い時間と労力を要するサイクルになる可能性があります。また、ハードウェア内の問題を正確に理解する事が困難です。

このような場合、ハードウェアデバッガが有効です。ハードウェアデバッガには、特殊なデバッグ用回路を内蔵したマイクロコントローラを使うインサーキットエミュレータまたはインサーキットデバッガがあります。ハードウェアデバッガは、この特殊な回路を使う事により、シミュレータと同様にコード内の任意ステップでの変数の観察や、シングルステップ実行を可能にします。

1.6.3 統合開発環境

通常、プロジェクトの設計サイクルが終段階に近づくと、デバッグは緊急の問題になります。製品化の終ステップでは、アプリケーションを当初の設計通りに機能させる必要がありますが、多くの場合この段階が製品の完成に遅れを生じる大の要因となります。このような製品開発において、統合開発環境がきわめて重要な役割を果たします。コードの「微調整」、リコンパイル、ダウンロード、テストは全てそれなりに時間を要します。全て同じ環境内のツールを使う事で、サイクル時間を短縮できます。致命的なバグを全て取り除く必要がある終ステップでは、組み込みエンジニアの腕が試されます。適切なツールはエンジニアを支援して開発期間を短縮します。MPLAB X IDE では、各種ツールを共通のインターフェイスで使えるため、ソフトウェアシミュレータから低コストのインサーキットデバッガへ、さらには強力なインサーキットエミュレータへとツールをアップグレードする際にも習熟が容易です。


MPLAB X IDE とは

1.7 デバイスのプログラミング

アプリケーションのデバッグが終わって、開発環境で完全に動作する事を確認できたら、今度は実際のデバイス上で動作をテストする必要があります。デバイスのプログラミングには、インサーキットエミュレータ、インサーキットデバッガ、開発用プログラマ、デバイスプログラマを使えます。MPLAB X IDE をプログラマとして設定し、デバイスにプログラムを書き込む事ができます。これにより、アプリケーションを完成品とほぼ同じ状態で観察できるようになります。エンジニアリングプロトタイププログラマを使うと、プロトタイプを素早く作成して評価できます。アプリケーションによっては、デバイスをプリント基板にはんだ実装後でもプログラミングできます。In-Circuit Serial Programming™ (ICSP™) プログラミング機能を使うと、製造時にファームウェアを書き込み、さらに後から書き直す事もできます。インサーキットデバッグをサポートしているデバイスなら、完成品をインサーキットデバッガに接続して製造後の品質検査とファームウェアの改良開発が可能です。

量産時のプログラミングには量産プログラマと MPLAB IPE を使います。MPLAB IPEは MPLAB X IDE と共にインストールされます。



1.8 MPLAB X IDE の構成要素

MPLAB X IDE は以下の要素で構成されています。

• プログラマ用テキストエディタ : このエディタはデバッガ用のウィンドウとしても機能します。

• プロジェクトマネージャ ( プロジェクトウィンドウとして表示 ): IDE と言語ツール間の統合と通信を提供します。

• 各種アセンブラ / リンカパッケージ : ターゲットデバイスのファームウェアの開発用です。

• デバッガエンジン : ブレークポイント、シングルステップ実行、ウォッチウィンドウ等、今日のデバッガが備えるべき全ての機能を提供します。デバッガは、ソフトウェアおよびハードウェアデバッグツールと連携して機能します。

• ソフトウェアシミュレータ : 全ての PIC MCU と dsPIC DSC に対応します。シミュレータの実行ファイルは、デバイス別に用意しています。MPLAB X IDE は、それらのファイルの中から、ターゲットデバイスに適合するファイルを選択します。

以下の MPLAB X IDE 用オプションコンポーネントもご利用またはご購入頂けます。

• コンパイラ言語ツール

Microchip 社の MPLAB XC C コンパイラは、PIC MCU と dsPIC DSC 向けに、完全に統合および適化したコードを提供します。microEngineering Labs、CCS、SDCC が提供するコンパイラを MPLAB X IDE のプロジェクトマネージャから起動してコードをコンパイルする事もできます。コンパイルしたコードは自動的にターゲットデバッガに読み込まれ、即座にテストおよび検証できます。

• プログラマ

MPLAB ICD 3 インサーキットデバッガ、MPLAB REAL ICE™ インサーキットエミュレータ、MPLAB PM3 プログラマを使うと、ターゲットデバイスの量産プログラミングが可能です。PICkit™ 3 インサーキットデバッガを使うと、ターゲットデバイスへのコードの開発プログラミングが可能です。

これらのツールは全て MPLAB X IDE と組み合わせて使う事で、コードとデータのプログラミングだけでなく、ターゲットデバイスの各種動作モードを設定するコンフィグレーションビットも制御できます。

また、これらのツールは全て MPLAB IPE と組み合わせて使う事で、コード、データ、コンフィグレーションビットをプログラミングできます。MPLAB IPE は、量産プログラミング向けに設計されており、そのインターフェイスは単純化されています。

• インサーキットデバッガ / エミュレータ

PICkit 3/MPLAB ICD 3 インサーキットデバッガ、MPLAB REAL ICE インサーキットエミュレータを使うと、ターゲットデバイス上でアプリケーションコードをデバッグできます。これらのツールは、一部のデバイスが内蔵する特殊なリソースを使って、アプリケーションに実装済みのターゲットマイクロコントローラにコードをダウンロードし、ブレークポイントの設定、コードのシングルステップ実行、レジスタと変数の監視を可能とします。エミュレータでは、その他のデバッグ機能 ( トレース等 )も利用できます。

• プラグインツール

MPLAB X IDE に機能を追加するために、各種のプラグインを利用できます。例えば、DMCI (Data Monitor and Control Interface) を使うと、コード内の変数を表示および制御し、それらの値をリアルタイムに変更できます。また、DMCI を使うと、出力データをグラフィカルに表示する事もできます。

サポートするプラグインツールの詳細はセクション 5.22「プラグインツールの追加」を参照してください。


MPLAB X IDE とは

1.9 MPLAB X IDE オンラインヘルプ

MPLAB X IDE は、NetBeans プラットフォームに基づいて構築されています。従って、多くの NetBeans 機能を MPLAB X IDE の機能として利用できます。

NetBeans に関する情報は、[Help] ウィンドウの左の [Contents] タブ内で、[NetBeansHelp] の下に表示される各種のオンラインヘルプファイルを参照してください。MPLAB X IDE 開発ツールに関する情報は、[Help] ウィンドウの左の [Contents] タブ内で、[MPLAB X IDE Help] の下に表示される各種のオンラインヘルプファイルを参照してください。

MPLAB X IDE と MPLAB IDE v8 の相違点は第 10 章「MPLAB X IDE と MPLAB IDEv8 の相違点」を参照してください。

1.9.1 ヘルプ

MPLAB X IDE の挙動を完全に理解するには、全てのヘルプファイルを参照してください。ヘルプを開くには [Help] > [Help Contents] を選択します。この操作により全ヘルプファイルが 1 つに結合されます。そのため開くのに少し時間がかかります。

1.9.2 ツールのヘルプ

[Help] > [Tool Help Contents] で選択したツールの個別のヘルプファイルを参照する事もできます。個別のヘルプファイルを開く事で、素早く範囲を絞って内容を検索できます。



1.10 その他の MPLAB X IDE 関連文書

ヘルプ以外の文書、ビデオとフォーラムへのリンク、Wiki は [Start Page] から利用できます ( 図 1-10)。

図 1-10: MPLAB X IDE の [Start Page]


MPLAB X IDE とは

Microchip Wiki は、先進機能のヒントを探すのに便利です ( 図 1-11)。このリンクをクリックすると Wiki を閲覧できます。https://microchip.wikidot.com

図 1-11: Microchip Wiki


https://microchip.wikidot.com


1.11 ウェブサイト

Microchip 社は自社が運営するウェブサイト (www.microchip.com) を通してオンラインサポートを提供しています。

http://www.microchip.com/devtools

このウェブサイトを通じて、お客様はファイルと情報を簡単に入手できます。詳細は本書の「サポート」を参照してください。

1.12 MPLAB X ストア

MPLAB X IDE v3.xx を入手するには、開発ツールソフトウェア / ハードウェア製品のMicrochip 社のストアに IDE 経由でアクセスしてください。

• [MPLAB X Store] タブ – [Start Page] タブの隣がこのタブです。このタブは各種製品へのリンクを提供します。

• [Help] > [MPLAB X Store] – [Help]メニューの下に [MPLAB X Store]タブを開くリンクがあります。

• [MPLAB X Store]ツールバーアイコン – [MPLAB X IDE]ツールバー上のアイコンで[MPLAB X Store] タブが開きます。

セクション 2.8「[MPLAB X Store] での購入」も参照してください。

1.13 MPLAB X IDE の更新

MPLAB X IDE はユーザの皆様にお使い頂くだけでなく、Microchip 社内でも新機能を採用した新型マイクロコントローラの開発に使っています。MPLAB X IDE の新機能の多くは、お客様からのご要望と Microchip 社内での使用経験を基に開発しています。新設計のマイクロコントローラのリリースが続く限り、MPLAB X IDE も進化し続けます。

新しいデバイスのサポートと新機能を追加するために、MPLAB X IDE のバージョンはほぼ数ヶ月に 1 回のペースで更新されます。

開発プロジェクトの途中で MPLAB X IDE の新バージョンがリリースされた場合、特別な理由 ( 例 : 現在の作業を阻害しているバグの修正 ) がない限り、その時点での新バージョンへの更新は推奨しません。新しいプロジェクトの開始時に更新する事を推奨します。

新バージョンへの更新のたびに、MPLAB X IDE ソフトウェアに新機能が追加されるため、マニュアル等の印刷文書の更新はオンラインヘルプよりも遅れます。このため、MPLAB X IDE で疑問が生じた場合、オンラインヘルプが良の参照資料です。

MPLAB X IDE と関連要素の変更通知サービスをご希望のお客様は、myMICROCHIPPersonalized Notification Service (http://www.microchip.com/pcn) で開発ツールのセクションにご登録ください。

詳細は本書の「サポート」を参照してください。

ストアのアイコン


http://www.microchip.com/devtools

http://www.microchip.com/pcn

MPLAB® X IDE
ユーザガイド
第 2 章使用前の準備

2.1 はじめに

MPLAB X IDE を使う準備をする場合、以下の作業を行います。

• JRE と MPLAB X IDE のインストール

• USB ドライバ ( ハードウェアツール用 ) のインストール

• ターゲットとハードウェアツールの接続

• 言語ツールのインストール

• MPLAB IDE の起動とデスクトップの表示

• [Start Page] からのアクセス情報

• [MPLAB X Store] での購入

• IDE で複数のインスタンスを使う方法

• IDE で複数のバージョンを使う方法

2.2 JRE と MPLAB X IDE のインストール

MPLAB X IDE (NetBeansプラットフォームベース)をインストールする際、Windows®

または Linux® 用の Java Runtime Environment (JRE) もインストールされます。MacOS® の場合、適切な JRE が既にインストールされていれば、MPLAB X IDE のインストールはそのまま進行します。JRE がインストールされていない場合、その適切なバージョンの入手先を示すダイアログが表示されます。表示される指示に従って JREをインストールしてから、MPLAB X IDE をインストールします。



2.3 USB ドライバ ( ハードウェアツール用 ) のインストール

ツールを正しく動作させるために、USB ドライバをインストールする必要があります。

2.3.1 Mac または Linux 用 USB ドライバのインストール

Mac または Linux PC に MPLAB X IDE をインストールする場合、インストーラは自動的に USB ドライバもインストールします。特別な操作は不要です。

2.3.2 Windows® XP/7/8 OS 用の USB ドライバのインストール

MPLAB X IDE を Windows PC にインストールする場合、以下の手順で USB ドライバをインストールする必要があります (Note: MPLAB IDE v8.xx 用の USB ハードウェアツールドライバは、MPLAB X IDE 用とは異なります )。これらの手順は以下のツールを使う場合に必要です。

• MPLAB REAL ICE インサーキットエミュレータ

• MPLAB ICD 3 インサーキットデバッガ

• MPLAB PM3 デバイスプログラマ

• PIC32 スタータキット

PICkit 2、PICkit 3、上記以外の MPLAB スタータキットに対しては、以下の操作は不要です。

以下の説明に従い、インストール方法を決定してください。

2.3.2.1 ドライバのインストール前に

Switcher ユーティリティを使う場合、またはプリインストーラを起動してドライバをインストールする場合 ( どちらも後続セクションで詳述 )、既存の WinUSB ドライバのシステムバージョンが、Switcher またはプリインストーラのバージョンより古いと、新しいものに置き換えられる事に注意してください。WinUSB ドライバの既存のバージョンを残しておきたい場合、Microchip 社のデバイスドライバをインストールする前に、これらのファイルの名前を変更します。

WinUSB ドライバファイルは以下の場所に保存されています。

32 ビット OS の場合 :C:\Windows\system32\WinUSB.dll (32 ビット )C:\Windows\system32\drivers\WinUSB.sys (64 ビット )64 ビット OS の場合 :C:\Windows\SysWOW64\WinUSB.dll (32 ビット )C:\Windows\system32\WinUSB.dll (64 ビット )C:\Windows\system32\drivers\WinUSB.sys (64 ビット )

2.3.2.2 手動切り換え (Windows XP 64 の場合 )

Windows XP 64 ビット OS を使っている場合、デバイスドライバを手動で切り換える必要があります。セクション 2.3.2.6「ドライバの手動インストールが必要な場合」を参照してください。


使用前の準備

2.3.2.3 管理者モードの使用 (Windows 7 または 8 OS の場合 )

Windows 7 または 8 OS 上で Switcher の実行ファイルを使ってデバイスドライバをインストールする場合、管理者モードで実行する必要があります。

「Device Driver Switcher」GUI アプリケーションを管理者として実行するには、実行ファイル (MPDDSwitch.exe または MPDDSwitch64.exe) を右クリックして [ 管理者として実行 ] を選択します。

ドライバの切り換えには、この GUI アプリケーションを推奨します。このアプリケーションで問題が生じた場合にのみ、コマンドラインアプリケーションを使ってください。

コマンドラインアプリケーション (mchpdds32.exeまたは mchpdds64.exe) を管理者として実行するには、まずコマンドプロンプトを管理者モードで起動します。[ スタート ] > [ 全てのプログラム ] > [ アクセサリ ] > [ コマンドプロンプト ] を右クリックして [ 管理者として実行 ] を選択します。これにより管理者用コマンドプロンプト画面が開きます。ここで、ReadMe32.txtまたは ReadMe64.txtファイルに記載されているコマンドを入力してドライバを切り換えます。

2.3.2.4 MPLAB IDE v8.xx がシステムにインストールされている場合

コンピュータに MPLAB IDE v8.xx 以前のバージョンがインストール済みの場合、Switcher プログラムを実行して MPLAB IDE v8 ドライバから MPLAB X IDE ドライバに切り換えます。MPLAB X IDE ドライバは、初に切り換えを実行した時にインストールされます。

Switcher プログラムは、「MPDDSwitch」(32 ビット OS) または「MPDDSwitch64」(64 ビット OS) という名の GUI アプリケーションです。このアプリケーションは、デスクトップアイコン [MPLAB Driver Switcher] から起動できます。

図 2-1: Swithcer ユーティリティ



1. ツールハードウェアを PC の USB コネクタに接続します。

2. PC の [ デバイスマネージャ ] ウィンドウを開きます。Windows XP PC を例に取ると、[ マイコンピュータ ] アイコンを右クリックして [ プロパティ ] を選択すると表示されます。[ システムのプロパティ ] ダイアログ内の [ ハードウェア ] タブを選択し、[ デバイスマネージャ ] ボタンをクリックします。

3. [Microchip Tools] セクションを展開して、接続したツールに現在割り当てられているドライバを表示します。ドライバは、「Microchip ツール名」というフォーマットで表示されます。

4. MPLAB X IDE インストール先フォルダにある「Swithcer」サブフォルダを開きます。このフォルダの既定値のパスは以下の通りです。

32 ビット OS の場合 : C:\Program Files\Microchip\MPLABX\vx.xx\Switcher64 ビット OS の場合 : C:\Program Files (x86)\Microchip\MPLABX\vx.xx\Switcher(vx.xxは MPLAB X IDE のバージョンです。)

5. 「Switcher」フォルダで OS に対応したサブフォルダ (「32Bit」または「64Bit」)を開きます。

6. その中の MPDDSwitch.exe (32 ビット OS) または MPDDSwitch64.exe (64 ビットOS) を起動します。

7. MPLAB IDE v8 または MPLAB X IDE を既定値とは異なるフォルダにインストールしている場合、[ 詳細 ] をクリックして、ドライバファイルの格納場所を指定します。

8. USB ドライバのインストールまたは切り換え方法

a) [Tool Group and Action] の下で、ドライバを切り換える接続済みのツールをクリックして選択する。

b) ラジオボタンで [MPLAB 8] または [MPLAB X] のどちらかを選択する。

c) [Apply All] をクリックする。切り換えの進捗状況が大きなテキストウィンドウに表示されます。切り換えには若干の時間を要します。

9. GUI によるドライバのインストールに失敗した場合、[Advanced] をクリックしてドライバファイルへのパスを確認した上で、Switcher を再度実行します。

10. それでも GUI からドライバをインストールできない場合、手動でインストールする必要があります。その手順とドライバの保存場所はセクション 2.3.2.6「ドライバの手動インストールが必要な場合」を参照してください。

11. プログラムまたはバッチの実行が完了したら、[ デバイスマネージャ ] ウィンドウにドライバの名前が表示される事を確認します。「Microchip WinUSB Device」と表示されるはずです。

MPLAB X IDE 用ドライバをインストールした後は、ドライバを MPLAB IDE v8.xx 用と MPLAB X IDE 用の間で切り換える事ができます。

2.3.2.5 MPLAB IDE v8.xx がシステムにインストールされていない場合

特別な操作は必要ありません。MPLAB X IDE のインストール時に USB ドライバもインストールされます。PC の USB ポートにツールを接続すると、[ 新しいハードウェアが見つかりました ] というバルーンメッセージが表示されます。次に、ドライバが自動的にインストールされます。またはウィザードに従い [ 自動的にドライバを選択する ] ように設定します。しかし、どちらの手順も失敗した場合、手動でインストールする必要があります。その手順とドライバの保存場所はセクション 2.3.2.6「ドライバの手動インストールが必要な場合」を参照してください。

Note: Switcher 実行時にツールを接続していないと、ツールに対応するドライバはインストールまたは切り換えが行われません。


使用前の準備

2.3.2.6 ドライバの手動インストールが必要な場合

ドライバの手動インストールが必要な場合、以下の手順を実行します。

1. [ コントロールパネル ] の [ デバイスマネージャ ] を開きます。[Microchip Tools]の下に対象のツールを探します。見つからない場合、[ その他のデバイス ] の下の[ 不明なデバイス ] を探します。

2. ツール名または [ 不明なデバイス ] を右クリックして、[ ドライバソフトウェアの更新 ] を選択します。

3. [ドライバソフトウェアの更新 ]ダイアログで [コンピュータを参照してドライバソフトウェアを検索します ] を選択します。

4. デバイスドライバの正しい保存場所を参照します。デバイスドライバの既定値の保存場所は以下の通りです。

C:\Program Files\Microchip\MPLABX\vx.xx\Switcher\32Bit\ winusb\x86\MCHPWinUSBDevice.infまたは

C:\Program Files\Microchip\MPLABX\vx.xx\Switcher\64Bit\ winusb\amd64\MCHPWinUSBDevice.infvx.xxは、MPLAB X IDE のバージョン番号です。

Windows 8 の場合、ドライバは x86_Windows8サブフォルダまたはamd64_Windows8サブフォルダのどちらかにあります。

5. Windows のセキュリティダイアログが表示された場合、[ このドライバソフトウェアをインストールします ] を選択してドライバをインストールします。

2.3.2.7 ツールの通信の問題

1. ドッキングステーションまたはハブを介してツールを接続すると問題が生じる場合、PC の USB ポートに直接ツールを接続する必要があるかもしれません。これは WinUSB ドライバの既知の問題です。

2. ドライバを手動で再インストールする必要がある場合、「32Bit」または「64Bit」フォルダ内の INF ファイルを指定する必要があります : 詳細はセクション 2.3.2.6

「ドライバの手動インストールが必要な場合」を参照してください。

Note: [ ドライバソフトウェアの新版を自動検索します ] は選択しないでください。誤ったデバイスドライバがインストールされます。誤って選択した場合、元に戻るかダイアログを終了し、上記の手順を再度実行して正しいドライバをインストールしてください。



2.4 ターゲットとハードウェアツールの接続

インサーキットデバッガやエミュレータを使う場合、以下を参照してハードウェアツールをターゲットに接続します。

• 開発ツールの設計注意書

• ヘッダの仕様書 ( ヘッダを使う場合 )• ツールのマニュアル

プログラマ専用機の場合、プログラマのマニュアルを参照してください。

Microchip 社のデモボード、評価用キット、リファレンスデザインをターゲットとして使う場合、セットアップに関する情報は、それらに付属する文書を参照してください。

2.5 言語ツールのインストール

MPLAB X IDE をインストールする際に、言語ツールの MPASM ツールチェーンも一緒にインストールされます (ASM30 ツールチェーンは付属しません )。MPLAB X IDE では、各種の C コンパイラツールパッケージ ( コンパイラ、アセンブラ、リンカ等 ) を使えます。Microchip 社のウェブサイト

http://www.microchip.com/xc

からインストールするコンパイラを入手できます。後ほど、無償のコンパイラ (Free、Evaluation) またはコードを適化できる有償のコンパイラ (Standard、Pro) として、それらのライセンスを取得できます。

コンパイラを選ぶ際には、設計に使うデバイスがサポートされているか注意します。

必要なコンパイラのインストールとライセンス取得の方法は『Installing and LicensingMPLAB XC C Compilers』(DS50002059) を参照してください。MPLAB X IDE は、インストール済みコンパイラのライセンス取得とネットワークライセンスの取得 /返却の機能を備えています。セクション 11.2.10「[Tools] メニュー」の [Licenses] のメニュー項目を参照してください。



使用前の準備

2.6 MPLAB IDE の起動とデスクトップの表示

[MPLAB X IDE] アイコンをダブルクリックするとプログラムが起動します。

MPLAB X IDE は、NetBeans プラットフォームに基づいて構築されています。NetBeans IDE を使い慣れていれば、MPLAB X IDE デスクトップはすぐに使えます。しかし、以下のタブと図 2-2 に示すタブは MPLAB X IDE に特有です。

• [Start Page]• [MPLAB X Store]

図 2-2: MPLAB X IDE のデスクトップ



2.7 [Start Page] からのアクセス情報

[Start Page] は、各種のリンクを収めた 3 つのタブで構成されます。下表に各タブの内容を示します。

起動時に [Start Page] を表示しない場合、各タブの下部の [Show on Startup] のチェックを外します。

表 2-1: [Learn ＆ Discover] タブ

Getting StartedQuick Start プロジェクトを作成およびセットアップして、すぐに使えるよう

にします。

Get Started Microchip Wikiに掲載されているMPLAB X IDEの使用方法です。

MPLAB® IDE v8 Users – IMPORTANT

ハードウェアツール向けの WinUSB ドライバをインストールします。

Download Compilers and Assemblers

MPLAB XC C コンパイラとその他の言語ツールのダウンロードとインストールについて学べます。

MPLAB® Harmony PIC32 MCU 向けアプリケーションの開発において MPLABHarmony がどのように役立つかについて学べます。

User’s Guide, Release Notes and Support Docs

MPLAB X IDE インストーラに含まれている文書へのリンクです。ユーザガイド、ツールのリリースノート、デバイスの予約済みリソース ( ツールごと )、デバイスのサポート文書を含みます。

Dive InOpen Sample Project 実行可能なサンプルプロジェクトを開きます。

Create New Project 新しい MPLAB X IDE プロジェクトを作成します。初めてプロジェクトを作成する場合、「Quick Start」をご覧になる事を推奨します。

Import Legacy Project 既存の MPLAB IDE v8 プロジェクトをインポートします。インポートしたプロジェクトで作業を始める前に、「Quick Start」をご覧になる事を推奨します。

Import Hex (Prebuilt) Project

別のツールでプリビルドしたプロジェクトから HEX ファイルをインポートします。

What’s New & TutorialsMPLAB X IDE Developer Help

Microchip Wiki のページに移動し MPLAB X IDE アプリケーション開発に関する情報を入手します。

MPLAB Harmony PIC32 MCU 向けの柔軟で包括的なファームウェア統合開発プラットフォームであるMPLAB Harmonyについて学び、MPLABHarmony をダウンロードおよびインストールします。

MPLAB Code Configurator 周辺モジュールを設定し、設定済み周辺モジュールのコードを生成できる MPLAB Code Configurator (MCC) について学び、MCC をダウンロードおよびインストールします。8 ビットおよび 16ビット MCU に対応します。

Microchip Libraries for Applications

MLA のスタックとライブラリを使うプリビルドしたアプリケーションに便利な MLA について学び、MLA をダウンロードおよびインストールします。

Difference from MPLAB v8 MPLAB X IDE と MPLAB IDE v8 の相違点をご覧になれます。

New Features in v3 MPLAB X IDE v3.00 で利用できる新機能の一覧をご覧になれます。

CommunityForums Microchip 社のフォーラムウェブページを開きます。

MPLAB X IDE Forum MPLAB X IDE フォーラムに登録します。

MPLAB Harmony Forum MPLAB Harmony フォーラムに登録します。

MPLAB Code Configurator Forum

MPLAB Code Configurator フォーラムに登録します。


使用前の準備

表 2-2: [My MPLAB X IDE] タブ

表 2-3: [What's New] タブ

Recent ProjectsMyProject.c: 近開いたプロジェクトの一覧を表示します。

Extend MPLABSelecting Simple or Full Featured Menus

MPLAB X IDE を初めて起動した時は、一部の項目を省略したメニューが表示されますが、全ての項目を含むメニューを選択する事もできます。

Download Compilers and Assemblers

MPLAB XC C コンパイラとその他の言語ツールのダウンロードとインストールについて学べます。

Install More Plug-Ins プラグイン用のダイアログを開きます。

Notes & NewslettersANxxxx, TBxxxx 推奨のアプリケーションノートと技術概要を表示します。

microSOLUTIONS E-newsletter

推奨のニュースレターを表示します。

All App Notes/Newsletters

全てのアプリケーションノートとニュースレターを表示します。

References & Featured LinksData Sheets 等リンクをクリックしてデータシート等の参考文書を閲覧できます。

Data Sheets & Errataデータシートとエラッタ推奨のデータシートとエラッタの一覧を表示します。[All Data

Sheets] または [All Errata] をクリックすると、全てのデータシートまたはエラッタを表示します。

Reference Manuals & Programming Specファミリリファレンスマニュアル、デバイスプログラミング仕様

推奨のリファレンスマニュアルとプログラミング仕様の一覧を表示します。[All Reference Manuals] または [All ProgrammingSpecs] をクリックすると、これらの全ての文書を含む一覧を表示します。

Recently Released Softwareソースコード Microchip 社のデバイスを使った開発をサポートする新のソフト

ウェアの一覧を表示します。[All Recently Released Software] をクリックすると、これらの全てのソフトウェアを含む一覧を表示します。

Product & Corporate News新規資料、新規ニュース推奨 Microchip 社製品とニュースを表示します。[All News] を

クリックすると、これら全てのニュースを表示します。



2.8 [MPLAB X Store] での購入

[MPLAB X Store] タブをクリックすると Microchip 社のストアからツールを購入できます。このタブは MPLAB X IDE に関する新の商品を紹介するように構成されています。各種カテゴリを参照して他の商品を見つける事もできます。

このタブは [Help] メニューまたはツールバーアイコンから直接アクセスする事もできます。

図 2-3: [MPLAB X Store]

追加の機能が予定されています。[Start Page] の [My MPLAB IDE] からmicrochipDIRECT へのログインが可能になる予定です。その場合、

• ソフトウェアに関する警告 (HPA の失効等 ) をご覧になれます。

• ユーザの mySoftware アカウントにアクセスできます。mySoftware アカウントでは各種ライセンスを登録およびダウンロードし、HPA を更新できます。


使用前の準備

2.9 IDE で複数のインスタンスを使う方法

MPLAB X IDE の各インスタンスでハードウェアツール (PICkit 3 等 ) を使うには、事前に設定が必要です。ハードウェアツールの準備が完了したら、IDE のインスタンスを IDE と同じフォルダから起動できます。

• 複数のインスタンスを使うためのハードウェアツールの設定方法

• IDE のインスタンスの呼び出し方

2.9.1 複数のインスタンスを使うためのハードウェアツールの設定方法

既定値では、IDE で大 5 つのインスタンスが使えます。それ以上のインスタンスを使う場合、「mchpdefport」ファイルを手動で変更する必要があります。

2.9.1.1 「mchpdefport」ファイルの使い方とフォーマット

「mchpdefport」ファイルは、IDE とローレベル USB ライブラリ (DLL、so、dylibファイル ) の両方に利用するツールのホットプラグに必要な情報を提供します。このファイルのフォーマットを以下に示します。

localhost3000030002300043000630008

1 行目は IDE を実行するホスト名を示します。

その他の行は、ローレベルのライブラリがハイレベルの IDE と通信するポートまたはソケットの番号を表します。IDE のインスタンスは、それぞれ異なるポートまたはソケットに割り当てられます。IDE のインスタンス間の通信は全てユーザからは見えません。

MPLAB X IDE のインスタンスは大 5 つまでこのファイルを変更する必要はありません。5 つより多いインスタンスを使う場合、このファイルを編集する事でポートまたはソケットの数を追加できます。

2.9.1.2 「mchpdefport」ファイルの位置

IDE の既定値のインストール内で、「mchpdefport」ファイルはオペレーティングシステムに応じて以下の場所に保存されます。

OS 場所

Windows (64 ビット ) C:\Windows\system32とC:\Windows\SysWOW64(Note: 両方の「mchpdefport」を変更する必要があります。)

Windows (32 ビット ) C:\Windows\system32Linux /etc/.mplab_ideMac (OS X) /etc/.mplab_ide



2.9.2 IDE のインスタンスの呼び出し方

MPLAB X IDE では、各インスタンスが独自のユーザフォルダを持つ必要があります。従って、あるインスタンスに対するプリファレンスの設定またはプラグインの追加は、他のインスタンスには反映されません。

複数のインスタンスを使い分けるには、[–-userdir] オプションでフォルダを指定して IDE を起動する必要があります。

2.9.2.1 Windows OS

[–-userdir] オプションを使ってショートカットを作成します。例 : Windows 7 OS:1. デスクトップで右クリックし、[ 新規作成 ] > [ ショートカット ] を選択します。

2. [ 参照 ] をクリックして、インストールした MPLAB X IDE の実行ファイルを指定します ( 以下は既定値 )。C:\Program Files (x86)\Microchip\MPLABX\vx.xx\mplab_ide\bin\mplab_ide.exe(vx.xxは MPLAB X IDE のバージョンです。)

3. その行の末尾にユーザフォルダの場所を入力します。このタイプの MPLAB X IDE情報の場合、既定値の場所の下にユーザフォルダを置く事ができます。--userdir "C:\Users\MyFiles\AppData\Roaming\.mplab_ide\dev\anydir"または、任意の場所に置いてもかまいません。--userdir anydir

4. [OK] をクリックします。

2.9.2.2 Linux OS

インストールしたバージョンを、パラメータを何も指定せずに実行 ( デスクトップアイコンをクリックして実行 ) した場合、ユーザフォルダとして「$(HOME)/.mplab_ide」を使います。ユーザフォルダを変更するには、シェルスクリプト「$InstallationDir/mplab_ide/bin/mplab_ide」に引数[--userid anydir] を指定して実行します。以下は、MPLAB X IDE を 2 つの異なるインスタンスで実行する場合の例です。

$ /opt/microchip/mplabx/vx.xx/mplab_ide/bin/mplab_ide --userdir ~/.anydir1 &$ /opt/microchip/mplabx/vx.xx/mplab_ide/bin/mplab_ide --userdir ~/.anydir2 &(vx.xxは MPLAB X IDE のバージョンです )ユーザ ID を埋め込んだデスクトップアイコンを作成する事もできます。

2.9.2.3 Mac OS

シェルウィンドウを開き、以下のコマンド行をタイプ入力して、インストールしたMPLAB X IDE を別のユーザフォルダで実行します。このタイプの MPLAB X IDE 情報の場合、既定値の場所の下にユーザフォルダを置く事ができます。

$/bin/sh /Applications/microchip/mplabx/vx.xx/mplab_ide.app/Contents/Resources/mplab_ide/bin/mplab_ide --userdir "${HOME}/Library/Application Support/mplab_ide/dev/anydir"

または、任意の場所に置いてもかまいません。

$/bin/sh /Applications/microchip/mplabx/vx.xx/mplab_ide.app/Contents/Resources/mplab_ide/bin/mplab_ide --userdir anydir


使用前の準備

2.10 IDE で複数のバージョンを使う方法

MPLAB X IDE v3.00 がリリースされる前は、異なるバージョンの MPLAB X IDE をインストールする場合、異なるフォルダにインストールする必要がありました。MPLAB X IDE v3.00 からは、これは既定値で行われます。例を以下に示します。

C:\Program Files (x86)\Microchip\MPLABX\v3.00複数のバージョンを同時に起動および実行できます。各バージョンは独自のユーザフォルダを持ちます。

任意のバージョンの MPLAB X IDE と MPLAB IDE (v8 以前 ) を同一 PC 上で実行できます。しかし、セクション 2.3.2「Windows® XP/7/8 OS 用の USB ドライバのインストール」に記載した USB ハードウェアドライバの制約に留意する必要があります。



NOTE:


MPLAB® X IDE
ユーザガイド
第 3 章チュートリアル

3.1 はじめに

チュートリアルでは、例を示しながら MPLAB X IDE の使い方を説明します。

• ハードウェアとソフトウェアのセットアップ

- チュートリアルで使うツール

- インストールと設定

• プロジェクトの作成と設定

- 新規プロジェクトの作成

- プロジェクト作成後のデスクトップ画面 – [File] および [Navigation] ペイン

- プロジェクトプロパティの表示と変更

- デバッガ / プログラマツールオプションを設定または変更する方法

- 言語ツールオプションを設定または変更する方法

- 言語ツールのパスの指定

- プロジェクトへの新規ファイルの追加

- プロジェクト作成後のデスクトップ画面 – [Editor] ペイン

- コンフィグレーションビット

- プロジェクト作成後のデスクトップ画面 – [Task] ペイン

• コードの実行とデバッグ

- プロジェクトのビルド

- コードの実行

- コードのデバッグ実行

- ブレークポイントによるプログラム実行の制御

- コードのステップ実行

- シンボル値の変化の観察

- デバイスメモリ ( コンフィグレーションビットを含む ) の表示

- デバイスのプログラミング



3.2 ハードウェアとソフトウェアのセットアップ

ここでは MPLAB X IDE を使い始める際の準備に関して説明します。

3.2.1 チュートリアルで使うツール

チュートリアルでは下表の製品を使います。

3.2.2 インストールと設定

第 2 章「使用前の準備」に従って MPLAB X IDE をインストールし、エミュレータをセットアップし (USB ドライバをインストールしてターゲットに接続 )、32 ビット言語ツールをインストールします。次に MPLAB X IDE を起動して、このチュートリアルを始めます。

ツールウェブページ注文番号

MPLAB® X IDE http://www.microchip.com/mplabx 無償

MPLAB® XC32 C コンパイラ *

http://www.microchip.com/xc SW006023-1( 標準バージョン )

MPLAB® REAL ICE™ インサーキットエミュレータ

http://www.microchip.com/realice DV244005

Explorer 16 開発ボード

http://www.microchip.com/explorer16 DM240001

PIC32MX360F512L PIM http://www.microchipdirect.com/productsearch.aspx?Keywords=MA320001 MA320001

* このコンパイラのFreeまたはEvaluationエディションはMicrochip社のウェブサイトからダウンロードできます。コンパイラをダウンロードしてインストールする際は、ライセンス番号を入力しないでください。


http://www.microchip.com/mplabx


http://www.microchip.com/realice

http://www.microchip.com/explorer16

http://www.microchipdirect.com/productsearch.aspx?Keywords=MA320001

チュートリアル

3.3 プロジェクトの作成と設定

ここでは MPLAB X IDE 内で、アプリケーションコード開発に必要となるプロジェクトを設定する方法を解説します。

3.3.1 新規プロジェクトの作成

MPLAB X IDE はプロジェクトを基本とするため、アプリケーションごとにプロジェクトを作成する必要があります。

以下の操作のどちらかを実行してプロジェクトを新規作成します。

• [Start Page] の [Learn & Discover] タブで、[Dive In] の下の [Create New Project]を選択する

• ウィンドウ上部のメニューバーから [File] > [New Project] をクリックする ( または<Ctrl>+<Shift>+<N>)

[New Project] ウィザードが起動し、新規プロジェクトの作成を支援します。

STEP 1

Step 1 では、プロジェクトカテゴリを選びます。本チュートリアルでは [MicrochipEmbedded] を選びます。次にプロジェクトタイプを選びます。本チュートリアルでは [Standalone Project] を選びます。

[Next>] をクリックして次のダイアログへ進みます。

図 3-1: プロジェクトウィザード – プロジェクトの選択



STEP 2

Step 2 では、デバイスを選びます。この例では PIC32MX360F512L です。デバイスを選択したら [Next>] をクリックします。

図 3-2: プロジェクトウィザード – デバイスの選択

STEP 3

Step 3 は、選択したデバイスでヘッダが利用可能である場合に表示されます。PIC32MX360F512L にはヘッダがないため、MPLAB X IDE は自動的にこのステップをスキップします。



STEP 4

Step 4 ではツールを選択します。選択したデバイスをサポートしているツールは、ツール名の左側の丸いマーク ( 信号灯 )の色で識別できます。色を識別できない場合、マウスカーソルをマークの上に置くと、サポートに関する情報を表示できます。

ツールの中には 2 つのツール名の左に 2 つマークが表示されるものがあります。左側のマークがマーク番号 1、その右隣のマークがマーク番号 2 です。

ハードウェアツール接続時、ツール名の下にシリアル番号 (SN) が表示されます。これにより、同じハードウェアツールを複数接続していても個別のツールを識別できます。

ツールを選択して [Next>] をクリックします。

図 3-3: プロジェクトウィザード – ツールの選択

マーク色サポート

緑完全サポート ( 実装と完全なテスト済み )

黄ベータ版サポート ( 実装済み、ただし完全なテストは未完 )

赤未サポート

マーク番号デバッグツールシミュレータ

1 デバッガのサポートコア ( 命令セット ) のサポート

2 プログラマのサポート周辺モジュールのサポート



STEP 5

Step 5 は、ツールとして MPLAB REAL ICE インサーキットエミュレータを選んだ場合のみ表示されます。

MPLAB REAL ICE インサーキットエミュレータを使う場合、プラグインボードを指定できます。プラグインボードとはエミュレータのドライバボードスロットに挿入する回路基板です。Explorer 16 ボードは標準通信ドライバボードまたは高速通信ドライバボードで動作するため、[Supported Plugin Board] は [None] のままにします。


図 3-4: プロジェクトウィザード – プラグインボードの選択



STEP 6

Step 6 では、言語ツール (C コンパイラまたはアセンブラ ) を選択します。ここでも、コンパイラ名の左側のマーク ( 信号灯 ) の色で、選択したデバイスに対するサポートレベルを識別できます。マウスカーソルをマークの上に置くと、サポートに関する説明を表示できます。

インストールされている各ツール名の右側に、バージョンとインストール先のパスも表示されます。これにより、インストールされている複数の言語ツールから必要なツールを選択できます。


図 3-5: プロジェクトウィザード – 言語ツールの選択



STEP 7

Step 7 では、プロジェクトの名前と保存場所、その他のプロジェクト設定を選択します。

プロジェクト名として「MyProject」と入力します。

既定値では、プロジェクトは以下のパスに保存されます。

• Windows XP – C:\Documents and Settings\UserName\MPLABXProject • Windows 7/8 – C:\Users\UserName\MPLABXProjects • Linux – /home/UserName/MPLABXProjects • Mac – /Users/UserName/MPLABXProjects

[Project Location]の右にある [Browse...]ボタンをクリックすると上記以外のフォルダを指定できます。

[Set as main project] を選択して、このプロジェクトをメインプロジェクトに設定します。[Use project location as project folder] はチェックを外したままにします。

このチュートリアルは ISO-8859-1 (Latin 1)エンコードセットで作成されているため、[Encoding] の設定を変更する必要はありません。

上記完了後に [Finish] をクリックすると、新規プロジェクトの作成が完了します。

図 3-6: プロジェクトウィザード – プロジェクト名と保存先フォルダの選択



3.3.2 プロジェクト作成後のデスクトップ画面 – [File] および[Navigation] ペイン

プロジェクトの作成が完了すると、プロジェクトツリーが [File] ペイン内の [Projects]ウィンドウに表示されます。プロジェクトの情報を表示する [Dashboard] ウィンドウはその下の [Navigation] ペイン内に表示されます。

• [File] ペイン – 4 つのウィンドウを含みます。このチュートリアルでは、ファイルをカテゴリごとにグループ化したプロジェクトツリーが表示される、[Projects]ウィンドウに注目します。

- [Projects]- [Files]- [Classes] および [Services] ウィンドウ ( 自動的には表示されません )

• [Navigation]ペイン – 選択中のファイルまたはプロジェクトに関する情報を表示します。プロジェクトについては、[Dashboard] に詳細な情報が表示されます。


[File] ペインでファイルをダブルクリックすると、そのファイルの内容が [Editor] ペインに表示されます(セクション3.3.8「プロジェクト作成後のデスクトップ画面 – [Editor]ペイン」参照 )。タブを閉じるには、[x] をクリックします。

[File] ペインの [Projects] ウィンドウ内でプロジェクト名を右クリックすると、コンテクストメニューが開きます。プロジェクトのサブフォルダに対しても同様の操作が可能です。



3.3.3 プロジェクトプロパティの表示と変更

プロジェクト作成後は、[Project Properties] ダイアログを開いてプロパティを編集できます。このダイアログは以下のどちらかの方法で開く事ができます。

• [File] ウィンドウの [Projects] ウィンドウ内でプロジェクト名を右クリックし、[Properties] を選択する

• [File] ウィンドウの [Projects] ウィンドウ内でプロジェクト名を左クリックし、メニューから [File] > [Project Properties] を選択する

開いたダイアログで、[Conf: [default]] カテゴリをクリックすると、プロジェクトコンフィグレーション ( デバイス、デバッガ / プログラマツール、言語ツール等 ) が表示されます。前章までに説明したセットアップ手順に誤りがなければ、チュートリアルでこれらのコンフィグレーションを変更する必要はありません。 [Apply] をクリックして、このダイアログの内容を適用します。

図 3-8: [Project Properties] ダイアログ



3.3.4 デバッガ / プログラマツールオプションを設定または変更する方法

デバッガ / プログラマツールオプションを設定または変更する方法

[REAL ICE] をクリックして、セットアップオプションを表示します。これらのオプションの意味は、エミュレータのマニュアルを参照してください。

このチュートリアルでは何も変更しないでおきます。

図 3-9: ツールの設定ページ



3.3.5 言語ツールオプションを設定または変更する方法

言語ツールオプションを設定または変更する方法

言語ツールをクリックして、設定オプションを表示させます。これらのオプションの機能は、言語ツールの文書を参照してください。

このチュートリアルでは何も変更しないでおきます。

図 3-10: 言語ツールの設定ページ



3.3.6 言語ツールのパスの指定

MPLAB X IDE で利用できる言語ツールとそれらのパスを表示 / 変更する方法

• Mac OS X の場合 : メインメニューバーから [mplab_ide] > [Preferences] > [Embedded] > [Build Tools]を選択してビルドツールにアクセスする

• その他の OS の場合 : [Tools] > [Options] > [Embedded] > [Build Tools] を選択してビルドツールにアクセスする

ウィンドウには、インストールされている全てのツールチェーンが自動的に表示されます。インストール済みのツールが表示されない場合、以下を試します。

• [Scan for Build Tools] ボタン – 環境パスをスキャンし、PC にインストールされている言語ツールの一覧を表示します。

• [Add] ボタン – ツールの実行ファイルを格納したフォルダ ( ベースフォルダ ) へのパスを入力する事により、手動でリストにツールを追加します。一般的に実行ファイルは、ツールをインストールしたフォルダ内の「bin」サブフォルダに保存されています。

同じコンパイラの複数のバージョンをインストールしている場合、リストからいずれか 1 つのバージョンを選択します。

このチュートリアルでは XC32 ツールチェーンが選択されている事を確認します。

図 3-11: 言語ツール ( コンパイラ ) のパス



3.3.7 プロジェクトへの新規ファイルの追加

このチュートリアルでは、以下のコードを含む新規ファイルを作成します。

1. [Projects] ウィンドウ内のプロジェクトツリーの Source Files フォルダの上で右クリックし、[New] > [C Main File] を選択する。

2. [New C Main File] ウィンドウで、ファイル名として led_message.c を入力し[Finish] をクリックする ( すると、そのファイルは Source Files の下に表示されます。また、タブにそのファイル名が付いたエディタウィンドウが表示されます )。

3. エディタウィンドウのコードを削除し、以下に示すコードをペーストする( これは「PIC32 Explorer 16 LED サンプルアプリケーション」のコードです )。

Led_message.c:のコード : /********************************************************************* * * Message via 8 LEDs * ********************************************************************* * FileName: led_message.c * Dependencies: xc.h * * * Processor: PIC32 * * Complier: MPLAB XC32 v1.40 * MPLAB X IDE v3.05 * Company: Microchip Technology, Inc. * * Software License Agreement * * The software supplied herewith by Microchip Technology Incorporated * (the “Company”) for its PIC32 Microcontroller is intended * and supplied to you, the Company’s customer, for use solely and * exclusively on Microchip PIC32 Microcontroller products. * The software is owned by the Company and/or its supplier, and is * protected under applicable copyright laws.All rights are reserved. * Any use in violation of the foregoing restrictions may subject the * user to criminal sanctions under applicable laws, as well as to * civil liability for the breach of the terms and conditions of this * license. * * THIS SOFTWARE IS PROVIDED IN AN “AS IS” CONDITION.NO WARRANTIES, * WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED * TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A * PARTICULAR PURPOSE APPLY TO THIS SOFTWARE.THE COMPANY SHALL NOT, * IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL OR * CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER. * * $Id: led_message.c 5898 2007-10-23 19:39:48Z rajbhartin $ * ********************************************************************/

/*** Message in a bottle**** Explorer 16 version (long delays)**** Thanks to Lucio DiJasio for letting us use this example.**



** Run this example on Explorer 16 board with a PIC32MX PIM.** Hold the board vertically from the PICtail connector size** and wave the board back-and-forth to see message "HELLO" on LEDs*/

#include <xc.h>

// Config settings// POSCMOD = HS, FNOSC = PRIPLL, FWDTEN = OFF// PLLIDIV = DIV_2, PLLMUL = MUL_16// PBDIV = 8 (default)// Main clock = 8MHz /2 * 16 = 64MHz// Peripheral clock = 64MHz /8 = 8MHz

// Configuration Bit settings// SYSCLK = 64 MHz (8MHz Crystal/ FPLLIDIV * FPLLMUL / FPLLODIV)// PBCLK = 8 MHz// Primary Osc w/PLL (XT+,HS+,EC+PLL)// WDT OFF// Other options are don't care//#pragma config FPLLMUL = MUL_16, FPLLIDIV = DIV_2, FPLLODIV = DIV_1, FWDTEN = OFF#pragma config POSCMOD = HS, FNOSC = PRIPLL, FPBDIV = DIV_8

// 1. define timing constant#define SHORT_DELAY (50*8)#define LONG_DELAY(400*8)

// 2. declare and initialize an array with the message bitmapchar bitmap[30] = { 0xff,// H 0x08, 0x08, 0xff, 0, 0, 0xff,// E 0x89, 0x89, 0x81, 0, 0, 0xff,// L 0x80, 0x80, 0x80, 0, 0, 0xff,// L 0x80, 0x80, 0x80, 0, 0, 0x7e,// O 0x81, 0x81,



0x7e, 0, 0 };

// 3. the main programmain(){ // disable JTAG port DDPCONbits.JTAGEN = 0;

// 3.1 variable declarations int i; // i will serve as the index

// 3.2 initialization TRISA = 0; // all PORTA as output T1CON = 0x8030; // TMR1 on, prescale 1:256 PB

// 3.3 the main loop while( 1) { // 3.3.1 display loop, hand moving to the right for( i=0; i<30; i++) {// 3.3.1.1 update the LEDs PORTA = bitmap[i];

// 3.3.1.2 short pause TMR1 = 0; while ( TMR1 < SHORT_DELAY) { } } // for i

// 3.3.2 long pause, hand moving back to the left PORTA = 0; // turn LEDs off TMR1 = 0; while ( TMR1 < LONG_DELAY) { } } // main loop} // main



3.3.8 プロジェクト作成後のデスクトップ画面 – [Editor] ペイン

このファイルは、[File] ペインでプロジェクトの下に表示されると共に、[Editor] ペインにこのファイルと同名のタブが開きます。

[Editor]ペイン – プロジェクトファイルの内容を表示して編集します。ここには [StartPage] も表示されます。

図 3-12: MPLAB X IDE のデスクトップ – [File] および [Editor] ペイン



3.3.9 エディタの使い方

このサンプルコードを編集する必要はありません。しかし実際にコードを編集する場合、NetBeans エディタを使います。エディタに関連する C コンパイラ情報は、NetBeansヘルプトピック ([C/C++/Fortran Development] > [C/C++/Fortran Project Basics] >[Navigating and Editing C/C++/Fortran Source Files]) を参照してください。エディタ機能の一覧は、第 7 章「エディタ」に記載しています。

エディタの各種機能は以下からアクセスします。

• [Edit] メニュー ( セクション 11.2.2「[Edit] メニュー」参照 )• 各ファイルのエディタウィンドウの上にあるエディタ用ツールバー

• ウィンドウ内で右クリックして開くコンテクストメニュー

図 3-13: エディタ用ツールバー

3.3.10 コンフィグレーションビット

Microchip 社製デバイスには、正しく動作させるための設定が必要です。これには、デバイスメモリの特殊な部分 ( コンフィグレーションメモリ ) に格納されているレジスタ内のコンフィグレーションビットを使います。コンフィグレーションビットはコードで設定する必要があります。しかし、デバッグセッションで [ConfigurationBits] ウィンドウを使うと、コンフィグレーションビットを一時的に変更できます([Window] > [PIC Memory Views] > [Configuration Bits])。変更後、ウィンドウ内を右クリックして [Generate Source Code to Output] を選ぶと、その設定をエクスポートできます。コードが [Output] ウィンドウにエクスポートされますので、これをアプリケーションコードにコピーできます。

このサンプルコードでは、コンフィグレーションビットを設定済みです。実際のコード作成では、自分でコンフィグレーションビットを設定する必要があります。

各種デバイスのコンフィグレーションビットの設定に関するまとめは、本書の補遺 A「コンフィグレーション設定のまとめ」に記載しています。



3.3.11 プロジェクト作成後のデスクトップ画面 – [Task] ペイン

[PIC Memory Views] で [Configuration Bits] 等のウィンドウを開いた場合、[Task] ペイン内に表示されます。

[Task] ペイン – アプリケーションのビルド、デバッグ、実行からのタスク出力を表示します。

図 3-14: MPLAB X IDE のデスクトップ – [Task] ペイン



3.4 コードの実行とデバッグ

ここではコードを実行またはデバッグする際のMPLAB X IDEの使い方を検討します。

3.4.1 プロジェクトのビルド

MPLAB X IDE では、実行またはデバッグの前にプロジェクトをビルドしておく必要はありません。ビルドは、実行とデバッグの一部として処理されます。しかし、開発の初期段階または既存プロジェクトの大幅変更時には、プロジェクトを実行またはデバッグする前に、プロジェクトのビルドを確認する場合もあります。

プロジェクトのビルド方法

• [Projects] ウィンドウのプロジェクト名を右クリックして [Build] を選択するか、[Clean and Build] を選択して中間ファイルを削除してからビルドする

• ツールバーの [Build Project] または [Clean and Build Project] アイコンをクリックする

ビルドの進捗状況は [Task] ペイン内の [Output] ウィンドウに表示されます。本チュートリアルのコードは問題なくビルドされるはずです。

図 3-15: ビルドに成功した場合の出力

チェックサム情報の表示方法

ビルド後のチェックサムは [Dashboard] ウィンドウに表示されます。このウィンドウが開いていない場合、[Window] > [Dashboard] を選択して開きます。

[Build] アイコン

[Clean and Build] アイコン



3.4.2 コードの実行

コードのビルドに成功すれば、アプリケーションを実行できます。プログラムを実行するには、[Make and Program Device Project]アイコンをクリックするか [Run] > [RunProject] を選択します。

プログラムを実行すると、デモボード上のランプが点滅します。ボードを左右に振ると「Hello」という文字が浮かび上がります。

実行の進捗状況も [Output] ウィンドウに表示されます。

[Hold in Reset] ボタンを使うと、デバイスをリセットと実行の間で交互に切り換える事ができます。

[Run Project] アイコンをツールバーに追加する事も可能です ([View] > [Toolbars] >[Customize])。

3.4.3 コードのデバッグ実行

本チュートリアルで使うコードの動作はテスト済みです。しかし、アプリケーションを開発する場合、コードをデバッグする必要があります。

チュートリアルのコードをデバッグ実行するには、[Debug Project] アイコンをクリックするか、[Debug] > [Debug Project] または [Debug] > [Step Into] を選択して、デバッグセッションを始めます。

デバッグ実行の進捗状況は [Output] ウィンドウに表示されます。

アプリケーションコードの実行を一時停止する方法

[Pause] アイコンをクリックするか、[Debug] > [Pause] を選択すると、プログラムの実行が一時停止する。

コードの実行を再開する方法

[Continue] アイコンをクリックするか、[Debug] > [Continue] を選択すると、プログラムの実行が再開する。

コードの実行を終了する方法

[Finish] アイコンをクリックするか、[Debug] > [Finish Debugger Session] を選択すると、プログラムの実行が終了する。

C コードプロジェクトのデバッグに関する詳細は NetBeans ヘルプトピック([C/C++/Fortran Development] > [Debugging C/C++/Fortran Applications with gdb]) を参照してください。

通常の実行とデバッグ実行の違いは、セクション 3.4.4「ブレークポイントによるプログラム実行の制御」以降で説明します。

[Make and Program Device Project] アイコン

[Hold in Reset] アイコン

[Run] アイコン

[Debug Run] アイコン



3.4.4 ブレークポイントによるプログラム実行の制御

コードをデバッグする際に、コードの特定位置で実行を一時停止して、変数値を調べる事ができると便利です。そのためにブレークポイントを使います。

例として、コードの以下の行にブレークポイントを設定します。

PORTA = bitmap[i];以下のどちらかの方法により、コード行にブレークポイントを設定できます。

• ソースエディタで左側の余白をクリックする

• <Ctrl>+<F8> を押す

図 3-16: コードのブレークポイントの設定

ブレークポイントを設定した後に、チュートリアルのプログラムを再度デバッグ実行すると、プログラムはブレークポイントの位置で一時停止します。bitmap[]変数の上にマウスカーソルを置くと、その値が表示されます。

図 3-17: ブレークポイントで一時停止したプログラム



以下のどちらかの方法により、設定したブレークポイントをクリアできます。

• ブレークポイント設定の時と同じ操作を繰り返す

• [Debug] > [Toggle Breakpoint] を選択する

ブレークポイントの詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] > [Debugging C/C++/Fortran Applications with gdb] >[Setting C/C++/Fortran Breakpoints]) を参照してください。

3.4.5 コードのステップ実行

[Debug] メニューと [Debug] ツールバーのステップ実行機能を使うと、コードの先頭またはブレークポイントでの停止状態からコードをステップ実行できます。これにより、変数値の変化を観察 ( 次セクション参照 )、プログラムフローが正しいかどうかを判断できます。

コードのステップ実行は、以下の方法で行えます。

• Step Over – プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数全体を実行した後に停止します。

• Step Into – プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数の先頭の命令文を実行した後に停止します。

• Step Out - プログラムのソースを 1 行実行します。関数をステップ実行中である場合、関数の残りを全て実行した後に、呼び出し元のルーチンに戻って停止します。

• Run to Cursor - プロジェクトをカーソル位置まで実行して、停止します。

ステップ実行の詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] > [Debugging C/C++/Fortran Applications with gdb] >[C/C++/Fortran Debugging Sessions] > [Stepping Through Your C/C++/FortranProgram]) を参照してください。



3.4.6 シンボル値の変化の観察

選択したシンボルの値の変化を [Watches] ウィンドウで観察します。これらの値がプログラム実行中に予測通りに変化するか確認する事により、コードのデバッグに役立てる事ができます。

ウォッチの新規作成方法

1. [Debug] > [New Watch]を選択する。[New Watch]ダイアログ (以下を参照 )が開く。

2. ウォッチ式 ( この例では「PORTA」) を入力し、[OK] をクリックする。デスクトップに [Watches] ウィンドウが開き、指定したシンボルが表示される。

または

1. コード内の PORTA を右クリックし、[New Watch] を選択する。

2. PORTA が含まれた [Watches] ウィンドウが開く。

または

1. [Window] > [Debugging] > [Watches] を選択する。

2. エディタウィンドウから [Watches] ウィンドウに PORTA をドラッグ & ドロップする。

図 3-18: [Watches] ウィンドウに表示されたシンボル

シンボル値の変化を観察する方法

1. プログラムをデバッグ実行し、一時停止する。

2. [Watches] タブをクリックしてウィンドウを開くと、シンボル値が表示される ( 変化した値は赤字で示されます )。

ウォッチの詳細は NetBeans ヘルプトピック([C/C++/Fortran Development] > [Debugging C/C++/Fortran Applications with gdb] >[Viewing C/C++/Fortran Program Information] > [Creating a C/C++/Fortran Watch]) を参照してください。



3.4.7 デバイスメモリ ( コンフィグレーションビットを含む ) の表示

MPLAB X IDE は柔軟で簡潔な [Memory] ウィンドウを備えています。このウィンドウには、デバッグ中に各種タイプのデバイスメモリの内容を表示できます。[Memory]ウィンドウでは、メモリのタイプとメモリのフォーマットをドロップダウンボックスで選択します。

まずフラッシュメモリを表示します。

1. [Window] > [PIC Memory Views] > [Execution Memory] を選択する。

2. [Execution Memory] ウィンドウが開き、直前の一時停止位置が表示される。

図 3-19: [Memory] ウィンドウの内容

以下の方法により、[Memory] ウィンドウの表示を変更できます。

• [Window] > [PIC Memory Views] を選択してリストを開き、そこで別のウィンドウを選択する

• ウィンドウ上でドロップダウン [Memory] メニューを使う

[Memory] ウィンドウのオプションを設定する方法

[Memory] ウィンドウ内で右クリックすると、各種オプション ( 表示オプション、メモリの書き込み、テーブルのインポート / エクスポート、ファイルへの出力等 ) を含むコンテクストメニューが開きます。このメニューの詳細はセクション 12.9.13「[Memory] ウィンドウのメニュー」を参照してください。

[Flash Memory] ウィンドウは、以下の方法で更新できます。

1. プログラムを一時停止する ( デバッガのセッションを終了する )。2. [Read Device Memory] アイコンをクリックする。

[Read Device Memory] アイコン



3.4.8 デバイスのプログラミング

コードのデバッグ後は、そのコードをターゲットデバイスにプログラミングします。

まず、[Project Properties] ウィンドウでプログラミングオプションを確認します。本チュートリアルではオプションは変更しません。

次に、以下の 2 つの方法のどちらかでデバイスをプログラミングします。

• [Run] をクリックする : プロジェクトがビルドされ ( 必要な場合のみ )、デバイスがプログラミングされます。プログラミングが完了すると、即座にプログラムの実行が始まります。

• [Make and Program Device] をクリックする : プロジェクトがビルドされ ( 必要な場合のみ )、デバイスがプログラミングされます。プログラミングが完了すると、即座にプログラムの実行が始まります。プログラム端子がアプリケーション使われる場合、ターゲットボードからハードウェアツールを取り外してリセットします。

その他のプログラミング関連の機能 :• [Hold in Reset]: デバイスをリセットと実行の間で交互に切り換えます。

• [Read Device Memory]: ターゲットデバイスのメモリの内容をMPLAB X IDEに転送します。

プログラミング関連のアイコンには以下のようなものがあります。

[Run] アイコン


[Make and Program Device] アイコン


Note: MPLAB X IDE は、全てのプログラミング機能を備えている訳ではありません。その他のプログラミング機能のサポートについては、MPLAB X IDEに付属してインストールされる MPLAB IPE を参照してください。


MPLAB® X IDE
ユーザガイド
第 4 章基本作業

4.1 MPLAB X IDE プロジェクトの作業手順

MPLAB X IDE におけるプロジェクトの作業手順は以下の通りです。

準備

1. MPLAB X IDE をインストールし、ハードウェアツールをセットアップし(USB ドライバをインストールしてターゲットを正しく接続し )、選択したデバイス向けの言語ツールをインストールする。次に MPLAB X IDE を起動して、チュートリアルを始める ( 使用前の準備 )。

プロジェクトの作成とビルド

1. [New Project]ウィザードを使って新しいプロジェクトを作成する (新規プロジェクトの作成 )。デスクトップ表示に切り換わる ( プロジェクト作成後のデスクトップペイン )。

2. [Project Properties] ダイアログでプロジェクトのプロパティを確認または編集する ( プロジェクトプロパティの表示と変更 )。同じダイアログでデバッガ、プログラマ、言語ツールも設定する ( デバッガ / プログラマツールオプションをセットアップまたは変更する方法、言語ツールオプションを設定または変更する方法 )。

3. [Options] ダイアログ ([Tools] > [Options]) で、言語ツールのパスと、追加のツールオプションを設定する ( 言語ツールのパスの指定、その他のツールオプションの設定 )。

4. ファイルを新規作成してプロジェクトに追加します (ファイルの新規作成 )。または、既存のファイルをプロジェクトに追加する ( 既存ファイルのプロジェクトへの追加 )。追加したファイルは [File] ウィンドウに表示され、エディタを使ってアプリケーションコードを入力または編集できる。

5. エディタの機能については「エディタの使い方」を参照してください。6. ライブラリ、オブジェクトファイルを追加および設定する ( ライブラリや

オブジェクトファイルの追加と設定 )。7. 各ファイルまたはフォルダ全体のプロパティ ( ビルドに含めるかどうか ) を

設定する ( ファイルおよびフォルダプロパティの設定 )。8. プロジェクトのコンフィグレーションタイプ、ビルド前後のステップ、

ユーザ ID としてのチェックサムの使用、ビルド完了時の代替 HEX ファイルの読み込みに関するビルドプロパティを設定する (ビルドプロパティの設定 )。

9. プロジェクトのビルド

コードの実行

1. [Run] メニューを使ってコードを実行する ( コードの実行 )。2. [Debug]メニューを使ってコードをデバッグ実行する(コードのデバッグ実行)。

コードのデバッグ

1. ブレークポイントは、エディタ内で行を選択して設定するか、[Breakpoint]ウィンドウを使って設定する(ブレークポイントによるプログラム実行の制御)。

2. コードをステップ実行する ( コードのステップ実行 )。3. [Watches]および [Variables]ウィンドウでシンボルと変数の値の変化を観察

する ( シンボル値の変化の観察 )。4. デバイスメモリ (コンフィグレーションビットを含む )を表示または変更する。

メモリタイプはデバイスによって異なる ( デバイスメモリ ( コンフィグレーションビットを含む ) の表示 / 変更 )。

デバイスのプログラミング

1. ツールバーボタンを使ってデバイスをプログラミングする (デバイスのプログラミング )。



4.2 新規プロジェクトの作成

MPLAB X IDE はプロジェクトを基本とするため、アプリケーションごとにプロジェクトを作成する必要があります。

プロジェクトは以下のどちらかの方法で作成できます。

• [Start Page] の [Learn & Discover] タブで、「Dive In」の下の [Create New Project]を選択する

• [File] > [New Project] を選択する ( または <Ctrl>+<Shift>+<N>)[New Project] ウィザードが起動し、新規プロジェクトの作成を支援します。

4.2.1 Step 1: Choose Project

Step 1 では、プロジェクトカテゴリを選びます。ほとんどの場合、以下を含む[Microchip Embedded] のプロジェクトタイプを選択します。

以下のオプションを使ってプロジェクトカテゴリを選択できます。

• Standalone Project – 新しいプロジェクト (C 言語またはアセンブリコード ) を作成します。本セクションでは、このプロジェクトタイプを解説します。

• Existing MPLAB IDE v8 Project – 既存の MPLAB IDE v8 用プロジェクトを MPLABX IDE 用に変換します。詳細はセクション 5.2「レガシー MPLAB プロジェクトのインポート」を参照してください。

• Prebuilt (Hex, Loadable Image) Project – 既存のプロジェクトイメージをMPLAB XIDE に読み込みます。詳細はセクション 5.3「プリビルドプロジェクト」を参照してください。

• User Makefile Project – 外部 make ファイルを使うプロジェクトを作成します。詳細はセクション 6.5「ユーザ Makefile プロジェクトの作成」を参照してください。

• Library Project – 実行用HEXファイルではなくライブラリをビルドする新しいプロジェクト (C 言語および / またはアセンブリコード ) を作成します。詳細はセクション5.6「ライブラリプロジェクト」を参照してください。

その他に以下を選択できます。

• その他の組み込みプロジェクト - 他ベンダーのプロジェクトを基にプロジェクトを新規作成します。

• サンプルプロジェクト - 各種デバイスファミリ向けの既製のプロジェクトやプロジェクトテンプレートを選ぶ事ができます。

項目を選択したら、[Next>] をクリックして次のダイアログへ進みます。


基本作業

図 4-1: プロジェクトウィザード – プロジェクトの選択



4.2.2 Step 2: Select Device

Step 2 では、アプリケーションで使う予定のデバイスを [Device] ドロップダウンリストから選択します。選択肢を絞り込むために、初にデバイスファミリを選択します。

LF デバイスの場合、デバイスに「F」タイプより低い電圧 (5.0 V ではなく 3.3 V (typ.))を供給するように設定する必要があります。今の設定では過電圧でデバイスを損傷してしまう場合、MPLAB X IDE は警告ダイアログを表示して注意を喚起します。

[Next>] をクリックします。

図 4-2: プロジェクトウィザード – デバイスの選択


基本作業

4.2.3 Step 3: Select Header

Step 3 は、選択したデバイスでヘッダが利用可能である場合に表示されます。デバイスがヘッダを必要とするか、またはデバッグ回路を内蔵しているかどうかは、以下のどちらかの文書 (PDF またはオンラインヘルプバージョン ) で確認できます。

•『Processor Extension Pak and Debug Header Specification』(DS51292)•『エミュレーション拡張パック (EEP) およびエミュレーションヘッダユーザガイド』

(DS50002243)

上記を確認してからヘッダを使うかどうかを選択します。選択したら [Next>] をクリックします。

図 4-3: プロジェクトウィザード – ヘッダの選択

Note: ヘッダは [Project Properties] ウィンドウを使って、後で選択する事もできます ( ヘッダが使える場合 )。



4.2.4 Step 4: Select Tool

Step 4 ではツールを選択します。

選択したデバイスをサポートしているツールは、ツール名の左側の丸いマーク ( 信号灯 )の色で識別できます。色を識別できない場合、マウスカーソルをマークの上に置くと、サポートに関する情報を表示できます。

ツールの中には 2 つのツール名の左に 2 つマークが表示されるものがあります。左側のマークがマーク番号 1、その右隣のマークがマーク番号 2 です。

ハードウェアツール接続時、ツール名の下にシリアル番号 (SN) が表示されます。これにより、同じハードウェアツールを複数接続していても個別のツールを識別できます。

お使いのサードパーティ製ハードウェアツールがここに表示されない場合、そのツールが適切にインストールされているかどうか確認します。詳細はセクション 6.7「サードパーティ製ハードウェアツール」を参照してください。


図 4-4: プロジェクトウィザード – ツールの選択

マーク色サポート

緑完全サポート ( 実装と完全なテスト済み )

黄ベータ版サポート ( 実装済み、ただし完全なテストは未完 )

赤未サポート

マーク番号デバッグツールシミュレータ

1 デバッガのサポートコア ( 命令セット ) のサポート

2 プログラマのサポート周辺モジュールのサポート


基本作業

4.2.5 Step 5: Select Plug-In Board

Step 5 ではプラグインボードを選択します。

MPLAB REAL ICE インサーキットエミュレータを使う場合、プラグインボードを指定できます。プラグインボードとはエミュレータのドライバボードスロットに挿入する回路基板です。


図 4-5: プロジェクトウィザード – プラグインボードの選択

表 4-1: エミュレータプラグインボード

「Supported Plugin Board」ボードの説明

None 標準通信ドライバボード

None 高速通信ドライバボード

JTAG Driver Board JTAG アダプタボード

Power Monitor Board 電源モニタボード ( ロジックプローブコネクタにも挿入する必要があります )



4.2.6 Step 6: Select Compiler

Step 6 では、言語ツール (C コンパイラまたはアセンブラ ) を選択します。ここでも、コンパイラ名の左側のマーク ( 信号灯 ) の色で、選択したデバイスに対するサポートレベルを識別できます。マウスカーソルをマークの上に置くと、サポートに関する説明を表示できます。

ここに必要な言語ツールが表示されない場合、またはサポートツールが 1 つも表示されない場合、ツールがインストール済みであるかどうか確認します。次に、[Tools] >[Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Embedded]ボタンをクリックし、[Build Tools] タブを確認して、MPLAB X IDE がツールを認識するようにしてください。[Build Tools] タブにツールが表示されている場合、選択したデバイスがそのツールによってサポートされていない可能性があります。そのデバイスをサポートする他の言語ツールを選ぶかインストールする必要があります。

現行の言語ツールは新規デバイスをサポートします。レガシーツールは新規デバイスをサポートしません。

各言語ツールの詳細はそれぞれの文書を参照してください。

サードパーティ製言語ツールチェーン (CCS 等 ) については、[Start Page] の「ReleaseNotes and Support Documentaion」より [Readme for Third Party Tools.htm] ファイルを参照してください。

表 4-2: Microchip 社製言語ツール – 現行

ツールチェーン正式名サポートするデバイス

XC8 MPLAB XC8 C Compiler 8 ビット



MPASM MPASM Assembler, MPLINK Object Linker and Utilities 8 ビット

表 4-3: Microchip 社製言語ツール – レガシー

ツールチェーン正式名

8 ビットデバイス向け言語ツール

C18* MPLAB C Compiler for PIC18 MCUsHI-TECH PICC HI-TECH C Compiler for PIC10/12/16 MCUsHI-TECH PICC18 HI-TECH C Compiler for PIC18 MCUs


ASM30** MPLAB Assembler, Object Linker and Utilities for PIC24 MCUs and dsPIC DSCs

C30 MPLAB C Compiler for PIC24 MCUs and dsPIC DSCsC24 MPLAB C Compiler for PIC24 MCUs (C30 のサブセット )dsPIC MPLAB C Compiler for dsPIC DSCs (C30 のサブセット )HI-TECH DSPICC HI-TECH C Compiler for PIC24 MCUs and dsPIC DSCs


C32 MPLAB C Compiler for PIC32 MCUsHI-TECH PICC32 HI-TECH C Compiler for PIC32 MCUs* ほとんどのコンパイラには、アセンブラ、リンカ、ユーティリティが付属しています。しかし、MPLAB C18 は MPASM ツールチェーンでサポートされています。** MPLAB X IDE の v1.30 以降には付属していません。16 ビットコンパイラに付属するアセンブラをお使いください。


基本作業


図 4-6: プロジェクトウィザード – 言語ツールの選択



4.2.7 Step 7: Select Project Name and Folder

Step 7 では、プロジェクトの名前と保存場所、その他のプロジェクト設定を選択します。[Finish] をクリックすると、新規プロジェクトの作成が完了します。

プロジェクト名、保存場所、フォルダ

プロジェクト名を入力します。既定値では、名前の後ろに .X が付加されます。これは必須ではなく、便宜的なものです。不要なら [Project Folder] テキストボックスで削除できます。

フォルダの場所を参照します。必要に応じてプロジェクトフォルダを新規作成する事もできます。既定値では、プロジェクトは以下のパスに保存されます。

• Windows XP – C:\Documents and Settings\UserName\MPLABXProject • Windows 7/8 – C:\Users\UserName\MPLABXProjects • Linux – /home/UserName/MPLABXProjects • Mac – /Users/UserName/MPLABXProjects

しかし、既定値以外のパスを選択する事もできます。

メインプロジェクト

[Set as main project] を選択して、このプロジェクトをメインプロジェクトに設定します。

プロジェクトの保存場所、フォルダ

[Use project location as project folder] にチェックを入れて、プロジェクトの格納場所と同じフォルダ内にプロジェクトを作成します。

これは、MPLAB IDE v8 プロジェクトをインポートする際、MPLAB X IDE のプロジェクトを同じフォルダにする場合 ( ビルドも同様にする場合 ) に便利です。

MPLAB IDE v8 が .mcp ファイルを使ってプロジェクト情報を保存するのに対し、MPLAB X IDE はフォルダを使います。従って、MPLAB IDE v8 プロジェクト (.mcpファイル ) とフォルダを共有させる事ができる MPLAB X IDE プロジェクトは 1 つだけです。

エンコード

プロジェクトのエンコードを選択します。既定値の文字セットは ISO-8859-1 (Latin 1)です。

この選択によって、コード構文の色分け設定が決まります。色分けは [Tools] >[Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Fonts andColors] ボタンをクリックして、[Syntax] タブより編集できます。


基本作業

図 4-7: プロジェクトウィザード – プロジェクト名と保存先フォルダの選択

4.2.8 プロジェクトコンフィグレーションタイプの変更

コンフィグレーションタイプを変更する事でスタンドアロン ( アプリケーション )プロジェクトをライブラリプロジェクトに変更できます。詳細はセクション 4.14.1

「プロジェクトコンフィグレーションタイプの変更」を参照してください。



4.3 プロジェクト作成後のデスクトップペイン

プロジェクトの作成が完了すると、プロジェクトツリーが [File] ペイン内の [Projects]ウィンドウに表示されます。プロジェクトの情報を表示する [Dashboard] ウィンドウも [Navigation] ペイン内に表示されます。後述のようにプロジェクトにファイルを追加すると、[Editor] ペイン内のエディタウィンドウにファイルの内容が開きます。デバッグおよびメモリウィンドウは [Task] ペイン内に表示されます。

• [File] ペイン – ファイルに関連する 4 つのタブを表示します。

- [Projects] ウィンドウには、ファイルがカテゴリごとにグループ分けされたプロジェクトツリーが表示されます。

- [Files] ウィンドウには、コンピュータ上のフォルダ構成に従って、プロジェクトファイルが表示されます。

- [Classes] ウィンドウには、コード内の全てのクラスと、それらの関数、変数、定数が表示されます。その宣言部分を見るには、項目をダブルクリックします。

- [Services] ウィンドウには、コード開発に使えるサービスが表示されます。

• [Navigator] ペイン – [File] ペインで選択されているファイル内のシンボルと変数に関する情報を表示します。

• [Editor] ペイン – プロジェクトファイルの内容を表示して編集します。ここには[Start Page] と [MPLAB X Store] も表示されます。

• [Task] ペイン – アプリケーションのビルド、デバッグ、実行からのタスク出力を表示します。



基本作業

[File] ペインでファイルをダブルクリックすると、そのファイルの内容が [Editor] ペインに表示されます。タブを閉じるには、[x] をクリックします。

[File] ペインの [Projects] ウィンドウ内でプロジェクト名を右クリックすると、コンテクストメニューが開きます。プロジェクトのサブフォルダに対しても同様の操作が可能です。

4.4 プロジェクトプロパティの表示と変更

プロジェクト作成後は、[Project Properties] ダイアログを開いてプロパティを編集できます。このダイアログは以下のどちらかの方法で開く事ができます。

• [File] ペインの [Projects] ウィンドウ内でプロジェクト名を右クリックし、[Properties] を選択する

• [File] ペインの [Projects] ウィンドウ内でプロジェクト名を左クリックし、メニューから [File] > [Project Properties] を選択する

開いたダイアログで、[Conf: [default]] カテゴリをクリックすると、プロジェクトコンフィグレーション ( デバイス、デバッガ / プログラマツール、言語ツール等 ) が表示されます。これらの項目を変更するには、セクション 4.2「新規プロジェクトの作成」の Step 4 および 5 を参照してください。

図 4-9: [Project Properties] ダイアログ



4.5 デバッガ / プログラマツールオプションをセットアップまたは変更する方法

[Project Properties] ウィンドウでは、ツールのオプションも設定します。

ハードウェアツールまたはシミュレータ (Conf: [default] の下 ) をクリックして、関連するオプションメニューを表示させます。これらのオプションの意味は、各ツールの文書を参照してください。

図 4-10: ツールの設定ページ


基本作業

4.6 言語ツールオプションを設定または変更する方法

[Project Properties] ウィンドウの言語ツールをクリックして、設定オプションを表示させます。これらのオプションの意味については、言語ツールの文書を参照してください。

その他のヘルプについては、NetBeans ヘルプトピック ([C/C++/Fortran Development] >[Working with C/C++/Fortran Projects] > [Setting Project Properties]) を参照してください。

図 4-11: 言語ツールの設定ページ

4.6.0.1 IDE オプションとコマンドラインオプション

IDE に入力するオプションは、コマンドラインで入力するオプションとフォーマットが異なる場合があります。[Option Description] タブのオプション名をクリックするとオプションの詳細が表示されます。また、オプションデータを入力または選択してから、[Generated Command Line] タブをクリックして内容を表示させ、オプションで生成されたコマンドラインコードが正しい事を確認します。

4.6.0.2 グローバルオプション

グローバルオプションを設定すると、言語ツールスイート内の全ての言語ツールに適用されます。また、[User Comments] タブを使うと特定のオプションを選択した理由を入力できます。



4.7 言語ツールのパスの指定

MPLAB X IDE で利用できる言語ツールとそれらのパスを表示 / 変更するには、以下の手順に従います。

• Mac OS X の場合 : メインメニューバーから [mplab_ide] > [Preferences] > [Embedded] > [Build Tools] を選択してビルドツールにアクセスする

• その他の OS の場合 :[Tools] > [Options] > [Embedded] > [Build Tools] を選択してビルドツールにアクセスする

ウィンドウには、インストールされている全てのツールチェーンが自動的に表示されます。

図 4-12: 言語ツール ( コンパイラ ) のパス

4.7.1 ツールチェーンの追加または変更

[Toolchain] 欄にインストール済みのツールが表示されない場合、以下を試します。

• [Scan for Build Tools] ボタン – 環境パスをスキャンし、PC にインストールされている言語ツールの一覧を表示します。

• [Add] ボタン – ツールの実行ファイルを格納したフォルダ ( ベースフォルダ ) へのパスを入力する事により、手動でリストにツールを追加します。一般的に、実行ファイルは、ツールをインストールしたフォルダ内の「bin」サブフォルダに保存されています。

同じコンパイラの複数のバージョンをインストールしている場合、リストからいずれか1 つのバージョンを選択します。

ツールのパスを変更するには、新しいパスを手入力するか、[...] ボタンをクリックして選択します。


基本作業

4.7.2 ツールチェーンの削除

既存のツールチェーンを削除するには、以下の手順に従います。

1. リストからツールチェーンをクリックして選択する。

2. [Remove] ボタンをクリックする。

この操作では、コンパイラは PC からアンインストールされません。MPLAB X IDE がこのコンパイラを認識しなくなるだけです。ツールチェーンを元に戻すにはセクション4.7.1「ツールチェーンの追加または変更」を参照してください。

コンパイラを PC からアンインストールする場合、上記のように MPLAB X IDE 内のコンパイラの参照を初に削除します。その後、コンパイラをアンインストールします。コンパイラを先にアンインストールし、MPLAB X IDE を起動した場合、ツールチェーンパスが赤で表示されます。このアンインストール済みコンパイラへの参照を削除するには、既述の手順で行います。

4.7.3 ツールチェーンパス

MPLAB X IDE は、既定値のインストールパスと PATH 環境変数でツールチェーンを検索します。Windows 64 ビット OS における MPLAB XC16 の既定値のパスの例を以下に示します。

C:\Program Files (x86)\Microchip\xc16\vx.xx\binコンパイラをインストールする際、インストール先を選択できます。以下のどちらかを行う事ができます。

• 既定値の場所またはそれ以外の場所にインストールする

または

• PATH にインストール場所を追加する

既定値以外の場所にインストールする場合、その場所を PATH に追加する必要があります。

PATH に新規の場所を追加しない場合、MPLAB X IDE でコンパイラの場所を指定できます([Tools] > [Options]で[Build Tools]タブを開き、[Embedded]ボタンをクリック)。

後に、インストール場所を PATH 変数に手動で追加できます。

MPLAB X IDE がツールチェーンを認識しているにもかかわらずパスが見つからない場合、そのパスは赤の文字で表示されます。



4.8 その他のツールオプションの設定

ビルド用パス以外のオプションも設定できます。[Options] ウィンドウの [Embedded]カテゴリでは、以下のタブを選択できます。

• Project Options – プロジェクト関連のオプション (make オプション、ファイルパスオプション ( 自動 / 相対 / 絶対 ) 等 ) を設定します ( セクション 12.14.2「[ProjectOptions] タブ」参照 )。

• Generic Settings – ログファイル等のプロジェクト機能を設定します ( セクション12.14.1「[Generic Settings] タブ」参照 )。

• Suppressible Messages – 抑止するメッセージを選択します ( セクション 12.14.5「[Suppressible Messages] タブ」参照 )。

• Diagnostics – エラーとその他の問題を詳しく調べるために記録します (セクション12.14.6「[Diagnostics] タブ」参照 )。

• Other – C ソースファイルとヘッダファイルに使えるファイル拡張子のリストを編集します ( セクション 12.14.7「[Other] タブ」参照 )。


基本作業

4.9 ファイルの新規作成

新しいファイルは、以下のいずれかの方法で作成できます。

• [File] > [New File] を選択する ( または <Ctrl>+<N>)• [Project/File] ウィンドウ内のプロジェクトを右クリックし、[New] > [Other] を選択する

• [Project/File] ウィンドウ内の論理フォルダ ( 例 : Source Files) を右クリックし、[New] >[Other] を選択する

[New File] ウィザードが起動し、ファイルの新規作成を支援します。

Step 1. Choose File Type[Microchip Embedded] を展開して、その中のファイルカテゴリを選択します。次にファイルタイプを選択します。

図 4-13: ファイルウィザード – カテゴリとタイプの選択



Step 2. Name and Locationファイルに名前を付け、そのファイルをプロジェクトフォルダに格納します。

図 4-14: ファイルウィザード – 関連付けるプロジェクトの選択

このファイルは、[File] ペインでプロジェクトの下に表示されると共に、[Editor] ペインにこのファイルと同名のタブが開きます。このタブでファイルを編集します。ファイル内のテキストは、構文に基づいて色分け表示されます ( 色分けはファイルタイプによって異なります )。

図 4-15: 新規ファイル – MyFile.c


基本作業

4.10 既存ファイルのプロジェクトへの追加

以下のどちらかの方法により、既存ファイルをプロジェクトに追加できます。

• [Project/File] ウィンドウ内のプロジェクトを右クリックし、[Add Existing Item] を選択する

• [Project/File] ウィンドウ内の論理フォルダ ( 例 : Source Files) を右クリックし、[AddExisting Item] を選択する

4.10.1 プロジェクトフォルダ内のファイル

ファイルを追加する際に、パスの指定方法を以下から選択できます。

• Auto – MPLAB X IDE がファイルのパスの指定方法を自動的に選択します。

• Relative – ファイルのパスをプロジェクトフォルダに対して相対的に指定します( も移植性に優れます )。

• Absolute – ファイルのパスを絶対パスで指定します。

• Copy – 指定したファイルをプロジェクトフォルダにコピーします。

このファイルは、[File] ペインでプロジェクトの下に表示されると共に、[Editor] ペインにこのファイルと同名のタブが開きます。

4.10.2 プロジェクトフォルダ外のファイル

プロジェクトフォルダ以外の場所に保存されているソースファイルは、「Relative」として追加します。これにより、外部ファイル用フォルダ (_ext) が作成され、プロジェクトはビルド時にそのファイルを見つける事ができるようになります。

//TODO やファイルコンテクストメニュー等のナビゲーション機能を使えるようにするために、ファイルの格納場所をプロジェクト内で指定しておく必要があります。このために、以下を行います。

1. [Projects] ウィンドウ内のプロジェクト名の上で右クリックして、[Properties] を選択する。

2. [Categories] の下で [General] をクリックする。

3. [Source Folders] の横の [Add] をクリックする。

4. プロジェクトに追加した外部ファイルのパスを表示させ、[Select] をクリックする。

5. [Apply] または [OK] をクリックして、プロジェクトをリビルドする。

MPLAB IDE v8 プロジェクトをインポートした場合、ソースファイルはプロジェクトフォルダ内に保存されません。自動的にファイルをインポートするには、[File] >[Import] > [MPLAB IDE v8 Project] を使います。

4.10.3 プロジェクト内のファイルの順序

リンク処理の順序は、プロジェクトにファイルを追加した順序で決まります。MPLABIDE v8 からプロジェクトをインポートする場合、その順序は .mcpファイルで決まります。

プロジェクトに新規に追加したファイルが後にリンクされます。ファイルを削除した後で再度追加した場合、そのファイルはリンクリストの末尾に移動します。



4.11 エディタの使い方

コードの編集には、NetBeans エディタを使います。エディタに関連する C コンパイラ情報は、NetBeans ヘルプトピック ([C/C++/Fortran Development] > [C/C++/FortranProject Basics] > [Navigating and Editing C/C++/Fortran Source Files]) を参照してください。エディタ機能の一覧は、第 7 章「エディタ」に記載しています。

エディタの各種機能は以下からアクセスします。

• [Edit] メニュー ( セクション 11.2.2「[Edit] メニュー」参照 )• 各ファイルのエディタウィンドウの上にあるエディタ用ツールバー

• ウィンドウ内で右クリックして開くコンテクストメニュー


エディタプロパティの設定方法

1. [Tools] > [Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択して[Options] ダイアログを開く。

2. [Editor] ボタンをクリックする。タブをクリックしてエディタ機能を設定する。

3. [Fonts and Colors] ボタンをクリックする。タブをクリックして色オプションを設定する。

ファイルをナビゲートする方法とコードをフォーマットする方法

1. [Navigate] メニューから項目を選択し、ファイルの内外を検索して移動する。

2. [Source] メニューから項目を選択して、コードのフォーマット、コメント化、オートコンプリートを実行する。

コード折り畳みの使い方

コード折り畳みの詳細はセクション 7.6「コード折り畳み」を参照してください。


基本作業

4.12 ライブラリやオブジェクトファイルの追加と設定

リンカが使うライブラリファイルは以下の場所より参照できます。

• [Projects] ウィンドウの [Libraries] フォルダ

• [Project Properties] ダイアログ

言語ツールのライブラリアンを使えば、その他のライブラリファイルも設定できます。

4.12.1 [Libraries] フォルダ

[Projects] ウィンドウで [Libraries] フォルダを右クリックすると、以下の項目が表示されます。

• [Add Library Project] プロジェクトに必要なライブラリを出力として生成するプロジェクトを作成します( 依存性の確立 )。詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] >[C/C++/Fortran Project Basics] > [Building C/C++/Fortran Projects] > [CreatingDependencies Between C/C++/Fortran Projects]) を参照してください。

• [Add Library/Object File] 既存のライブラリファイルまたはプリビルド ( オブジェクト ) ファイルをプロジェクトに追加します。

• [Properties] その他の設定を行う[Project Properties]ウィンドウを開きます(次セクション参照)。

4.12.2 [Project Properties] ウィンドウ : [Libraries] カテゴリ

[Project Properties]ウィンドウを開き、[Libraries]カテゴリをクリックします。[Projects]ウィンドウの [Libraries] フォルダに追加した全てのファイルが表示されます。ウィンドウ右側のボタンを使って、さらにファイルを追加したり、表示されているファイルを管理する事ができます。

ライブラリリスト内のファイルの順序でリンクの順序が決まります。これは、プロジェクト内のライブラリが相互参照している場合、重要です。セカンダリライブラリのオブジェクトを参照するライブラリは、リンク順のリスト内でより上位に位置している必要があります。リンク順が正しくない場合、リンク処理中に「undefinedreference to」エラーが発生する場合があります。リンク処理の順序の詳細は『MPLABXC16 Assembler, Linker and Utilities User’s Guide』(DS50002106)のセクション8.4.16

「--library libname (-l libname)」を参照してください。



図 4-17: ライブラリ / オブジェクトファイルの管理とリンク順の設定

4.12.3 [Project Properties] ウィンドウ : ライブラリアンカテゴリ

[Project Properties] ウィンドウを開き、使う言語ツールのカテゴリの下のライブラリアンをクリックします。ライブラリアンの実行ファイル名は、言語ツールのマニュアルで調べます。

左側のペイン内で、[Option categories] で [Libraries] を選択します。このリストからライブラリのオプションを選択します。


基本作業

図 4-18: ライブラリアンのライブラリオプションの設定



4.13 ファイルおよびフォルダプロパティの設定

[File Properties] ダイアログを使うと、プロジェクトファイルを、プロジェクト内の他のファイルとは異なる方法でビルドできます。このダイアログは、[File] ペインの[Projects] ウィンドウ内でファイル名を右クリックし、[Properties] を選択すると開きます。[Exclude from build] にチェックを入れると、このファイルをプロジェクトのビルドから除外できます。[Override build options] にチェックボックスを入れると、プロジェクトコンフィグレーション内のビルドオプションよりもここで選択したオプションを優先させる事ができます。[Override build options] にチェックを入れてから [Apply] をクリックすると、選択したオプションが [Categories] の下に表示されます。

図 4-19: ファイルプロパティ


基本作業

(仮想 )フォルダ全体は、[File]ウィンドウの [Projects]タブ内でフォルダ名を右クリックし、[Properties] を選択する事でビルドプロセスから除外できます。フォルダまたは個々のファイルを選択してビルドから除外します。上位のフォルダを選択すると、そのフォルダの内容全体が選択されます。ファイルまたは他のフォルダは自由に選択を解除できます。

図 4-20: フォルダプロパティ



4.14 ビルドプロパティの設定

プロジェクトをビルドする前に、必要に応じて以下のビルドプロパティを設定できます。

• プロジェクトコンフィグレーションタイプの変更

• ビルド前後でのスクリプト / マクロ実行

• ユーザ ID メモリへのチェックサムの挿入

• HEX ファイルの正規化

図 4-21: ビルドプロパティ - make オプション

4.14.1 プロジェクトコンフィグレーションタイプの変更

MPLAB X IDE v2.15 では、[New Project] ウィザードでスタンドアロンまたはライブラリプロジェクトを作成する場合、「application」と「library」のどちらかのコンフィグレーションタイプのプロジェクトが作成されます。これは、以下のセクションで示す事項に注意した上で、既存のプロジェクトのコンフィグレーションタイプを必要に応じて切り換える事ができる事を意味しています。

プリビルドおよびユーザ Makefile プロジェクトは、この機能によって影響されません( これらは一度作成すると別のタイプのプロジェクトには変更できません )。

図 4-22: コンフィグレーションタイプドロップダウンボックス


基本作業

4.14.1.1 スタンドアロンプロジェクトからライブラリプロジェクトへの切り換え

プロジェクトコンフィグレーションタイプを「application」から「library」に切り換える場合、ユーザが main() を削除する必要があります。コンフィグレーションタイプが「library」になると、「application」プロジェクト内の全ての読み込み可能ファイルはビルド / リンクされません。読み込み可能ファイルの詳細はセクション 5.4「読み込み可能なプロジェクト、ファイル、シンボル」を参照してください。

ツールチェーン (XC8) がライブラリをサポートしていない場合、コンボボックスは無効になりコンフィグレーションを「library」に切り換える事はできません。

4.14.1.2 ライブラリプロジェクトからスタンドアロンプロジェクトへの切り換え

プロジェクトコンフィグレーションタイプを「library」から「application」に切り換える場合、ユーザが main()を追加する必要があります。

4.14.2 ビルド前後でのスクリプト / マクロ実行

ビルドプロセスの先頭または末尾に実行するコマンドを入力します。これらのコマンドを nbproject/Makefile-$CONF.mk ファイルに挿入すると、ビルドプロセスをカスタマイズできます。呼び出すスクリプトまたはプログラム内でプロジェクト関連のアイテム ( 画像名等 ) を参照する必要がある場合、マクロを使います。

マクロを直接入力するか、[Insert Macro] をクリックして編集ボックス内の現在の位置にマクロ名をコピーします。コマンドは、カレントフォルダを MPLAB X IDEプロジェクトフォルダに設定して、make プロセスで実行されます。プロジェクトフォルダは、nbprojectフォルダを含むプロジェクトとして定義されます。

表 4-4: マクロ

名前 * 機能

Device 現在選択中のプロジェクトコンフィグレーションのデバイス

IsDebug デバッグ実行は「true」、それ以外は「false」ProjectDir PC 上のプロジェクトファイルの位置

ConfName 現在選択中のプロジェクトコンフィグレーションの名前

ImagePath ビルドイメージへのパス

ImageDir ビルドイメージを含むフォルダ

ImageName ビルドイメージの名前

* 使うコンパイラによっては、その他のマクロも選択できる場合があります。



例 4-1: デバッグ中にのみプロセスを実行する

以下に示すウィンドウ上で、IsDebug マクロをクリックして選択し、次に [InsertMacro] をクリックしてスクリプトに挿入します。

図 4-23: ビルドプロパティ - プリ / ポストビルド

実行するスクリプトで、$1 (Linux または Mac OS) または %1 (Windows OS) の値にチェックを入れます。

Bash のサンプルコード

#!/bin/bashecho is $1if [ "$1" == "true" ]; then echo We are in debugelse echo We are in productionfiBatch のサンプルコード

@echo offif "%1" == "true" goto debug:production@echo We are in productiongoto end:debug@echo We are in debug:end

4.14.3 ユーザ ID メモリへのチェックサムの挿入

チェックボックスをクリックすると、ビルドで生成されるチェックサムをユーザ IDとして使います ( デバイスがサポートしている ( 灰色表示されていない ) 場合 )。PIC32 ファミリのデバイスでは、チェックサムはユーザ ID によって異なります。従って、PIC32 デバイスはこの機能をサポートしていません。


基本作業

4.14.4 HEX ファイルの正規化

行アドレスが昇順であり、データが 1 サイズ (16 バイト ) にバッファリングされている場合、可能であれば HEX ファイルは正規化されます。

例えば、myfile.hex ファイルの行 ( レコード ) と MPLAB XC16 C コンパイラ /リンカの出力を以下に示します。

:0801f800361e0000361e000057:020000040000fa:10020800361e0000361e0000361e0000361e000096このファイルを正規化した場合、ファイルのデータは以下のようになります。

:10022800361E0000361E0000361E0000361E000076:10023800361E0000361E0000361E0000361E000066:10024800361E0000361E0000361E0000361E000056フォーマットは以下の通りです。

:bbaaaarrdd...ddcc

MPLAB X IDE では、HEXMATE と呼ぶアプリケーションを使って Intel HEX ファイルを正規化します。[Normalize hex file] オプションにチェックを入れると、ビルド後に以下が呼び出されます。

hexmate myfile.hex -omyfile.hex基本的に、HEXMATE は HEX ファイル全体を解凍し HEX ファイルで指定したアドレスにデータを配列します。次に、結果のメモリイメージを新規 HEX ファイルに圧縮し直します。結果ファイルでは全データは昇順であり、かつ連続しています。アドレスに隙間がある場合、出力ファイルにも隙間ができます ( 未使用アドレスは埋め込まれません )。HEXMATE の使い方の詳細はインストールした MPLAB XC8 C コンパイラの docsフォルダにある『MPLAB XC8 C Compiler User’s Guide』(DS50002053) を参照してください。HEXMATE は MPLAB XC8 の文書に記載されていますが、どのコンパイラと組み合わせても使えます。

正規化された HEX ファイルは、レコードバイトのばらつきが小化されているため、シリアル接続でのブートローダ等のプログラミングコードとして便利です。

: 開始レコード

bb バイトカウント

aaaa アドレス

rr レコードタイプ

dd データ

cc チェックサム



4.15 プロジェクトのビルド

MPLAB X IDE では、実行またはデバッグの前にプロジェクトをビルドしておく必要はありません。ビルドは、実行とデバッグの一部として処理されます。しかし、開発の初期段階または既存プロジェクトの大幅変更時には、プロジェクトを実行またはデバッグする前に、プロジェクトのビルドを確認する場合もあります。

プロジェクトのビルド方法

• [Projects] ウィンドウのプロジェクト名を右クリックして [Build] を選択するか、[Clean and Build] を選択して中間ファイルを削除してからビルドする

• ツールバーの [Build Project] または [Clean and Build Project] アイコンをクリックする

ビルドの進捗状況は [Output] ウィンドウに表示されます。

ビルドには以下の機能があります。

表 4-5: ツールバーボタンのビルドオプション

[Output] ウィンドウへのエラーの表示方法

1. [Output] ウィンドウを右クリックして [Filter] を選択する。

2. [Filter] ダイアログの [Match] にチェックを入れて「: error」と入力すると、ビルドを停止させたエラーだけが [Output] ウィンドウに表示される。

3. フィルタの ON/OFF 切り換えには <Ctrl>+<G> を使う。

エラーに関する詳細は言語ツールのマニュアルを参照してください。

チェックサム情報の表示方法

• [Dashboard] ウィンドウ ( セクション 5.18「ダッシュボードの表示」参照 ) を開いて、ビルド後のチェックサムを確認する。

プロジェクトのビルドに関する詳細は NetBeans ヘルプトピック ([C/C++/FortranDevelopment] > [C/C++/Fortran Project Basics] > [Building C/C++/Fortran Projects]) も参照してください。

ボタンアイコン

機能説明

Build Project プロジェクト内の全ファイルに対して make を実行します。

Build for Debugging プロジェクト内の全ファイルに対して make を実行し、ビルドされたイメージにデバッグ実行ファイルを追加します。

Clean and Build 前回のビルドファイルを削除してから、プロジェクト内の全ファイルに対して make を実行します。

Clean and Build for Debugging 前回のビルドファイルを削除してから、プロジェクト内の全ファイルに対して make を実行します。ビルドされたイメージにデバッグ実行ファイルを追加します。


基本作業

4.16 コードの実行

コードのビルドに成功すれば、アプリケーションを実行できます。

4.16.1 コード実行時の動作

[Run Project] ツールバーボタンをクリックすると以下の動作が実行されます。

• make 処理がビルドを必要と判断した場合、ビルドを実行します。

• インサーキットデバッガ / エミュレータまたはプログラマを使う場合、ターゲットデバイスには自動的にイメージ ( デバッグ実行ファイルは含まず ) がプログラミングされ、次いでデバイスが実行に向けてリリースされます。この場合、ブレークポイント等のデバッグ機能は有効になりません。 Note: プログラミング後にデバイスをリセット状態に保持するには、[Run Project]ではなく [Hold in Reset] をクリックします。

• シミュレータの場合、アプリケーションは一切のデバッグ機能を使わずコードを実行します。

コード実行の進捗状況が [Output] ウィンドウに表示されます。

4.16.2 実行に関する注意事項

プログラムを実行する場合、MPLAB X IDE は実行時 (Run または Debug Run) のみハードウェアツールに接続する事に注意してください。従って、MPLAB X IDE の設定は、実行時にのみツールに反映します。停止中に変更された設定は、実行が再開した時にのみ更新されます。

MPLAB IDE v8 のように常時ハードウェアツールに接続するには、[Tools] > [Options](Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Embedded] ボタンをクリックし、[Generic Settings] タブで [Maintain active connection to hardware tool]にチェックを入れます。

セクション 4.23「デバイスのプログラミング」を参照してください。

4.16.3 アプリケーションコードの実行

1. [Projects] ウィンドウでプロジェクトを選択するか、そのプロジェクトをメインプロジェクトに指定する ( 右クリックして [Set as main] を選択 )。

2. プログラムを実行するには、[Make and Program Device] アイコンをクリックするか[Run] > [Run Project] を選択する。

コード実行の進捗状況が [Output] ウィンドウに表示されます。


[Make and Program Device] アイコン



4.17 コードのデバッグ実行

コードが正常に動作しない場合、デバッグが必要です。デバッグモードでコードを実行する事を「デバッグ実行」と呼びます。

4.17.1 デバッグ実行時の動作

[Debug Project] ツールバーボタンをクリックすると以下の動作が実行されます。 • make 処理がビルドを必要と判断した場合、ビルドを実行します。

• インサーキットデバッガ / エミュレータを使う場合、ターゲットデバイスまたはヘッダは自動的にイメージ (デバッグ実行ファイルを含む )がプログラミングされ、デバッグセッションが始まります。

• シミュレータの場合、即座にデバッグセッションが始まります。

デバッグ実行の進捗状況は [Output] ウィンドウに表示されます。

4.17.2 デバッグ用マクロの生成

MPLAB X IDE は、Microchip 社製言語ツール向けのデバッグ用マクロを生成します。Microchip 社製コンパイラおよびアセンブラで使うマクロを表 4-6 に示します。

表 4-6: Microchip 社製ツールのデバッグ用マクロ

これらのマクロはユーザコード内で使えます。例 :#ifdef __DEBUG fprintf(stderr,"This is a debugging message\n");#endif

4.17.3 デバッグに関する注意事項

コードをデバッグする場合、以下の事項に注意します。

• デバッグ機能 (ウォッチウィンドウやメモリウィンドウでの変数の値の表示等 )の多くは、デバッグセッション ( デバッグモード ) 内でのみ使えます。

• MPLAB X IDEは実行時 (RunまたはDebug Run時 )にのみハードウェアツールに接続します。これは、MPLAB X IDE で行った設定が、実行時にのみツールに反映される事を意味します。停止中に変更された設定は、実行が再開した時にのみ更新されます。

MPLAB IDE v8 のように常時ハードウェアツールに接続するには、[Tools] >[Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Embedded]ボタンをクリックし、[Generic Settings] タブで [Maintain active connection tohardware tool] にチェックを入れます。

• アプリケーションによっては、個別に実行するためにデバッグステップの分割が必要になる場合があります。それには、[Debug] > [Discrete Debugger Operation] による手順を使います。

マクロ名関連ツール

機能

__DEBUG 全てデバッグ用のビルドである事を示します。

__MPLAB_REAL_ICE____MPLAB_ICD3____MPLAB_PK3____MPLAB_PICKIT2__

XC8 使用中のハードウェアデバッグツールを示します。

フォーマットは __MPLAB_xxx__ (xxx はハードウェアツールの指定子 ) です。

__MPLAB_DEBUGGER_REAL_ICE__MPLAB_DEBUGGER_ICD3__MPLAB_DEBUGGER_PK3__MPLAB_DEBUGGER_PICKIT2

XC16, XC32,MPASM

使用中のハードウェアデバッグツールを示します。

フォーマットは __MPLAB_DEBUGGER_xxx(xxxはハードウェアツールの指定子)です。

__MPLAB_DEBUGGER_PIC32MXSK XC32 使用中のスタータキットを示します。


基本作業

4.17.4 アプリケーションコードのデバッグ

アプリケーションコードをデバッグする方法

1. [Projects] ウィンドウでプロジェクトを選択するか、そのプロジェクトをメインプロジェクトに指定する ( 右クリックして [Set as main] を選択 )。

2. [Debug Project] アイコンをクリックするか、[Debug] > [Debug Project] または[Debug] > [Step Into] を選択して、デバッグ実行を始める。

アプリケーションコードの実行を一時停止する方法

[Pause] アイコンをクリックするか、[Debug] > [Pause] を選択すると、プログラムの実行が一時停止する。

コードの実行を再開する方法

[Continue] アイコンをクリックするか、[Debug] > [Continue] を選択すると、プログラムの実行が再開する。

コードの実行を終了する方法

[Finish] アイコンをクリックするか、[Debug] > [Finish Debugger Session] を選択すると、プログラムの実行が終了する。

通常の実行とデバッグ実行の違いは、セクション 4.18「ブレークポイントによるプログラム実行の制御」以降で説明します。

デバッガを起動する方法

コードがデバッグ用にビルドされたもので、単にデバッグツールを起動するだけならば、[Debug Project] アイコン横の下矢印をクリックして、[Launch Debugger] を選択する。

[Debug Project] アイコン



4.18 ブレークポイントによるプログラム実行の制御

コードをデバッグする際に、コードの特定位置で実行を一時停止して、変数値を調べる事ができると便利です。そのためにブレークポイントを使います。

ブレークポイントの詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] >[Debugging C/C++/Fortran Applications with gdb] > [Setting C/C++/FortranBreakpoints]) を参照してください。

図 4-24: [Breakpoints] ウィンドウ内のブレークポイント

4.18.1 単純なブレークポイントのセット / クリア

以下のどちらかの方法により、コード内にブレークポイントを設定できます。

• ソースエディタで左側の余白をクリックする

• <Ctrl>+<F8> を押す

以下のどちらかの方法により、設定したブレークポイントをクリアできます。

• ブレークポイント設定の時と同じ操作を繰り返す

• [Debug] > [Toggle Breakpoint] を選択する

4.18.2 [New Breakpoint] ダイアログによるブレークポイントの設定

[New Breakpoint] ダイアログを使ってブレークポイントを設定する方法

1. [Debug] > [New Breakpoint] を選択する。 2. [New Breakpoint] ダイアログで、ブレークポイントタイプおよびその他のオプ

ションを設定する。

各ブレークポイントタイプで利用できるオプションの詳細はセクション12.5.1「[NewBreakpoint] ダイアログ」で説明しています。


基本作業

4.18.3 [Breakpoints] ウィンドウによるブレークポイントのセット / クリア

[Breakpoints] ウィンドウを使ってブレークポイントを表示し、有効 / 無効にするには以下を実行します。

1. [Window] > [Debugging] > [Breakpoints] を選択する。

2. チェックボックスを使ってブレークポイントの有効 / 無効を切り換える。

[New Breakpoint] ダイアログを使ってブレークポイントを設定するには、ダイアログの左上にあるアイコンをクリックします。

4.18.4 ブレークポイントシーケンスの設定 ( 一部デバイスのみ )ブレークポイントシーケンスは複数のブレークポイントのリストです。プログラムの実行は、各ブレークポイントでは停止せず、後のブレークポイントの実行後に停止します。ブレークポイントシーケンスは、特定の命令に至るまでに複数の実行パスが存在する場合、その中の 1 つのパスの動作だけを調べる時に便利です。

ブレークポイントシーケンスの作成方法

1. 既存のブレークポイントを右クリックするか、複数の既存ブレークポイントを<Shift>+ クリックで選択して右クリックする。

2. コンテクストメニューから [Complex Breakpoint] へ進み、[Add a New Sequence]を選択する。

3. ダイアログボックスにシーケンス名を入力し、[OK] をクリックする。

4. 新しく作成したシーケンスの下に、初に選択したブレークポイントが表示される。

5. 別の既存ブレークポイントをシーケンスに追加するには、そのブレークポイントを右クリックし、[Complex Breakpoint] > [Add to Name] を選択する (Name はシーケンス名 )。

6. シーケンスに既存ではない新しいブレークポイントを追加するには、シーケンスを右クリックし、コンテクストメニューから [New Breakpoint] を選択する。

シーケンスの並び順を選択する方法

1. 全ての項目が表示されるように、シーケンスを展開する。

2. 項目を右クリックして、[Complex Breakpoints] > [Move Up] または [ComplexBreakpoints] > [Move Down] を選択する ( ブレークポイントのシーケンスはボトムアップ方式で実行されます。つまり、シーケンスの後のブレークポイントが

初に発生します )。

シーケンスまたはブレークポイントの無効化 / 削除方法

1. 項目を右クリックし、[Disable] を選択すると、その項目は一時的に無効になる。

2. 項目を右クリックし、[Delete] を選択すると、その項目は完全に削除される。

4.18.5 ブレークポイントタプルの設定 ( 一部デバイスのみ )MPLAB X IDE では、「タプル」は AND 演算されるブレークポイントのリストを意味します。ブレークポイントの AND 演算は、複数箇所で変更される変数が特定の箇所で変更された時にだけブレークさせたい場合に便利です。

AND 演算は 2 点のみ可能です。1 つはプログラムメモリブレークポイント、もう 1 つはデータメモリブレークポイントである事が必要です。両方のブレークポイントが同時に発生した時にのみ、プログラムが一時停止します。



ブレークポイントタプルの作成方法

1. [Breakpoints] ウィンドウの左上のアイコンをクリックすると、[New Breakpoint]ダイアログが開く。

2. アドレスブレークポイントを作成する。[OK] をクリックして、作成したブレークポイントを [Breakpoints] ウィンドウに追加する。

3. 上記 1 と 2 を繰り返して、データブレークポイントを作成する。

4. いずれかのブレークポイントを右クリックし、[Complex Breakpoint] > [Add toNew Tuple] を選択する。

5. ダイアログボックスにタプル名を入力し、[OK] をクリックする。

6. 新しく作成したタプルの下に、そのブレークポイントが表示される。

7. もう 1 つのブレークポイントを右クリックし、[Complex Breakpoint] > [Move toName] を選択する (Name はタプル名 )。

タプルまたはブレークポイントを削除するには、以下のどちらかの操作を行います。

1. 項目を右クリックし、[Disable] を選択すると、その項目は一時的に無効になる。

2. 項目を右クリックし、[Delete] を選択すると、その項目は完全に削除される。

4.18.6 ハードウェアブレークポイントの使い方

コードの行で一時停止する場合、以下のどちらかを実行します。

ソフトウェアブレークポイントからハードウェアブレークポイントへ切り換えるまたは

ハードウェアブレークポイントを設定する

[Debug Run] を実行すると、同じコード行で停止する事に注意が必要です。[DebugRun] を再実行してプログラム実行を継続するか、シングルステップ実行でブレークポイント行のコードを実行します。

4.18.7 ブレークポイント用のアプリケーション

ブレークポイントから次のブレークポイントまでの実行時間を計測するにはストップウォッチを使います ( セクション 5.14「ストップウォッチの使用」参照 )。ブレークポイントリソースを確認するため、[Dashboard] ウィンドウ ( セクション5.18「ダッシュボードの表示」参照 ) を開いて、ブレークポイントの利用可能数と使用数、ソフトウェアブレークポイントがサポートされているかどうかを調べます。

4.18.8 ブレークポイントの使用に関する注意事項

スタータキット、インサーキットデバッガ (PICkit 2 と 3 を含む )、MPLAB REAL ICEインサーキットエミュレータでは、使えるブレークポイントの数に制限があります。利用可能なブレークポイントの数は、選択したデバイスによって異なります。利用可能なブレークポイントの数と、既に使用中のブレークポイントの数は、[Dashboard]ウィンドウ ( セクション 5.18「ダッシュボードの表示」) で調べる事ができます。

以下の MPLAB X IDE 機能は、ブレークポイントを必要とします。 • Step Over• Step Out• Run to Cursor• Reset to Main

利用可能なブレークポイントが残っていない時にこれらの機能を使おうとすると、ダイアログが開いて、全てのリソースが使用中である事を知らせます。


基本作業

4.19 コードのステップ実行

[Debug] メニューと [Debug] ツールバーのステップ実行機能を使うと、コードの先頭またはブレークポイントでの停止状態からコードをステップ実行できます。これにより、変数値の変化を観察したり ( 次セクション参照 )、プログラムフローが正しいかどうかを判断したりできます。

コードのステップ実行は、以下の方法で行えます。

• Step Over – プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数全体を実行した後に停止します。

• Step Into – プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数の先頭の命令文を実行した後に停止します。

• Step Out - プログラムのソースを 1 行実行します。この行が関数コールの場合、実行後に呼び出し元に戻ります。


[Editor]ウィンドウ以外に、[Disassembly]ウィンドウ (セクション 5.15「[Disassembly]ウィンドウの表示」) と、[Memory] ウィンドウ内のプログラムメモリでも、コードをシングルステップ実行できます。

ステップ実行の詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] >[Debugging C/C++/Fortran Applications with gdb] > [C/C++/Fortran DebuggingSessions] > [Stepping Through Your C/C++/Fortran Program]) を参照してください。



4.20 シンボル値の変化の観察

選択したシンボルの値の変化を [Watches] ウィンドウで観察します。これらの値がプログラム実行中に予測通りに変化するか確認する事により、コードのデバッグに役立てる事ができます。

以下のシンボルを [Watches] ウィンドウに追加できます。

• グローバルシンボル – ビルド後に表示されます。

• SFR – 特殊機能レジスタ ( デバイスによって異なります )• 絶対アドレス

一般的に、値の変化を観察するにはデバッグ実行を一時停止する必要があります。しかし、ツールによっては実行時の更新が可能です ( プログラム実行中に値の変化を観察できます )。この機能が使えるかどうかは、ツールのマニュアルを参照してください。

PIC32 MCU 以外のデバイスでは、ランタイムウォッチに使うシンボルはデバイスメモリに適合したサイズである必要があります。つまり、8 ビットデバイスを使う場合、8 ビットのシンボルを使う必要があります。

C 言語エニュメレートタイプでは、enum ラベル ( テキスト ) と整数値のどちらかをウィンドウで入力できます。ラベルは、大文字と小文字を区別する事に注意します。

図 4-25: [Watches] ウィンドウ – プログラムの一時停止

[Watches] ウィンドウは、以下のどちらかの方法で表示できます。

• [Window] > [Debugging] > [Watches] を選択して、[Watches] ウィンドウを開く

• [Watches] ウィンドウが既に開いている場合、[Output] ウィンドウ内の [Watches] タブをクリックする

新規ウォッチを直接作成する方法

以下のいずれかの方法により、シンボルを [Watches] ウィンドウに直接追加できます。

• [Name] 列をダブルクリックして、グローバルシンボル、SFR、絶対アドレス (0x300)を入力する

• [Editor] ウィンドウのグローバルシンボルまたは SFR を右クリックして、[NewWatch] を選択する

• [Editor]ウィンドウ内でグローバルシンボルまたはSFRを選択し、これを [Watches]ウィンドウにドラッグ & ドロップする

[New Watches] ダイアログを使って新規ウォッチを作成する方法

以下のどちらかの方法により、シンボルまたは SFR を [Watches] ウィンドウに追加できます。

• [Watches] ウィンドウ内で右クリックして [New Watch] を選択するか、[Debug] >[New Watch] を選択する。ラジオボタンで、[Global Symbols] または [SFRs] のどちらをリストに表示するのかを選択する。リスト内でいずれかの名前をクリックし、[OK] をクリックする

• [Editor] ウィンドウ内でシンボルまたは SFR 名を選択し、右クリックで開いたメニューから [New Watch] を選択すると、その名前がウィンドウに表示される。[OK] をクリックする


基本作業

ランタイムウォッチの新規作成方法

ランタイムウォッチを [Watches] ウィンドウに追加する前に、クロックを以下のように設定する必要があります。

1. プロジェクト名の上で右クリックして [Properties] を選択する。 2. デバッグツールの名前 (REAL ICE 等 ) をクリックし、オプションカテゴリ [Clock]

を選択する。 3. 命令実行速度を設定する。

グローバルシンボルまたは SFR をランタイムウォッチとして追加する方法は、上記の「[New Watches] ダイアログを使って新規ウォッチを作成する方法」と基本的に同じですが、[New Watch] ではなく [New Runtime Watch] を選択する必要があります。

PIC32 MCU 以外のデバイスでは、ランタイムウォッチに使うシンボルはデバイスメモリに適合したサイズである必要があります。つまり、8 ビットデバイスを使う場合、8 ビットのシンボルを使う必要があります。

シンボル値の変化を表示する方法


2. [Watches] タブをクリックしてアクティブにする。

3. シンボルをウォッチする場合、コードをデバッグ実行し、一時停止して値の変化を観察する ( シンボルをランタイムウォッチする場合、コードをデバッグ実行すると、プログラムを実行しながら値の変化を観察できます。

シンボル ( グローバルシンボル、SFR、配列、レジスタのビットフィールド等 ) の値を表示するには、デバッグセッションを実行している必要があります )。ウォッチシンボルの基数を変更する方法

シンボルの行で右クリックし、[Display Value As] を選択する。

その他の作業の方法

ウォッチの詳細はセクション 12.16「[Watches] ウィンドウ」を参照してください。



4.21 ローカル変数値の変化の観察

ローカル変数の値の変化を [Variables] ウィンドウで観察します。これらの値がプログラム実行中に予測通りに変化するか確認する事により、コードのデバッグに役立てる事ができます。

一般的に、値の変化を観察するにはデバッグ実行を一時停止する必要があります。しかしツールによっては、実行中に値の変化を観察できます。この機能が使えるかどうかは、ツールのマニュアルを参照してください。

図 4-26: [Variables] ウィンドウ – プログラムの一時停止

[Variables] ウィンドウは、以下のどちらかの方法で開けます。

• [Window] > [Debugging] > [Variables] を選択して、[Variables] ウィンドウが開く

• [Variables] ウィンドウが既に開いている場合、[Output] ウィンドウ内の [Variables]タブをクリックする

変数の変化を観察する方法


2. [Variables] タブをクリックしてウィンドウを開くと、ローカル変数値が表示される。

変数の基数を変更する方法

• 変数の行で右クリックし、[Display Value As] を選択する。

その他の作業の方法

変数の詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] > [DebuggingC/C++/Fortran Applications with gdb] > [Viewing C/C++/Fortran Program Information] >[C and C++ Variables and Expressions in the IDE]) を参照してください。


基本作業

4.22 デバイスメモリ ( コンフィグレーションビットを含む ) の表示 / 変更

MPLAB X IDE は柔軟で簡潔な [Memory] ウィンドウを備えています。このウィンドウには、デバッグ中に各種タイプのデバイスメモリの内容を表示できます。このウィンドウ内の値を更新するには、デバッグ実行を一時停止する必要があります。

4.22.1 デバイスメモリの表示

1. ペイン内のウィンドウをクリックしてペインをアクティブにする([Memory]ウィンドウはこのペイン内に開きます )。

2. [Window] > [PIC Memory Views] を選択する。選択肢を下表に示す。

3. [Memory] ウィンドウでは、ドロップダウンボックスからメモリタイプと表示形式を選択できる。

図 4-27:メモリとメモリフォーマットの選択

表 4-7: メモリ画面 – 8/16 ビットデバイス

タイプ説明

Program MemoryFile RegistersSFRsPeripheralsConfiguration BitsEE Data MemoryUser ID Memory

デバイス上の全てのプログラムメモリ (ROM)デバイス上の全てのファイルレジスタ (RAM)全ての特殊機能レジスタ (SFR)周辺モジュールごとの全ての SFR全てのコンフィグレーションレジスタ

デバイス上の全ての EE データメモリ

ユーザ ID メモリ

表 4-8: メモリ画面 – 32 ビットデバイス

タイプ説明

Execution MemoryData MemoryPeripheralsConfiguration BitsCPU MemoryUser ID Memory

デバイス上の全てのフラッシュメモリ

デバイス上の全ての RAM全ての特殊機能レジスタ (SFR)全てのコンフィグレーションレジスタ

全ての CPU メモリ


表 4-9: [Memory] ウィンドウのオプション – 8/16 ビットデバイス

オプション値説明

Memory File RegistersProgramSFRConfiguration BitsEEPROMUser ID

デバイス上の全てのファイルレジスタメモリ

デバイス上の全てのプログラムメモリ

全ての特殊機能レジスタ (SFR)全てのコンフィグレーションレジスタ

全ての EEPROM メモリ


Format DataCode

データメモリ (RAM)プログラムメモリ (ROM)



4. デバッグ実行を一時停止すると、選択したメモリの内容が [Memory] ウィンドウに表示される。

5. ウィンドウを閉じるには、そのウィンドウのタブの [x] をクリックする。

図 4-28:[Memory] ウィンドウの内容

4.22.2 デバイスメモリの変更

メモリの値を変更するにはコードをデバッグ実行する必要があります。実行中はメモリを変更できません。

メモリの値を変更するには以下の情報を使います。

• 列をクリックしてデータを選択または入力すると、[Memory] ウィンドウ内の値を変更できます。ウィンドウによっては、変更されたデータを赤いテキストで表示します。

• [Fill Memory] 機能は、ほとんどの [Memory] ウィンドウのコンテクスト ( 右クリック )メニューに表示されます。

• プログラムメモリの場合、変更を表示するにはリビルドする必要があります。変更したデータをデバイスに書き込んでデバッガを起動するには、[Debug] > [DiscreteDebugger Operation] を選択します。

表 4-10: [Memory] ウィンドウのオプション – 32 ビットデバイス

オプション値説明

Memory RAM MemoryFlash MemoryPeripheralConfiguration BitsCPU MemoryMemoryUser ID

デバイス上の全ての RAMデバイス上の全てのフラッシュメモリ

全ての特殊機能レジスタ (SFR)全てのコンフィグレーションレジスタ

全ての CPU メモリ

全てのメモリ


Format DataCode

データメモリ (RAM)プログラムメモリ (ROM)

Note: 変更したデータは、デバッグ実行にのみ反映されます。アプリケーションコードは変更されません。


基本作業

4.22.3 コンテクストメニューを使った [Memory] ウィンドウのオプション設定

[Memory] ウィンドウ内で右クリックすると、各種オプション ( 表示オプション、メモリの書き込み、テーブルのインポート / エクスポート、ファイルへの出力等 ) を含むコンテクストメニューが開きます。このメニューの詳細はセクション 12.9.13「[Memory] ウィンドウのメニュー」を参照してください。

4.22.4 コンフィグレーションビットの設定

コンフィグレーションビットはコードで設定する必要があります。[Configuration Bits]ウィンドウは、コンフィグレーションビットの設定作業に役立ちます ( セクション4.22.1「デバイスメモリの表示」参照 )。デバッグセッションで [Configuration Bits] ウィンドウを使うと、コンフィグレーションビットを一時的に変更できます ( セクション 4.22.2「デバイスメモリの変更」参照 )。設定が決まったら [Generate Source Code to Output] を選択します。コードが [Output]ウィンドウにエクスポートされますので、これをアプリケーションコードにコピーできます。

コンフィグレーションビットを編集できるのはデバッグセッション中のみです。リビルドすると [Configuration Bits] ウィンドウによる変更は全て失われます。

各種デバイスのコンフィグレーションビットの設定に関するまとめは、本書の補遺 A「コンフィグレーション設定のまとめ」に記載しています。

図 4-29: [Configuration Bits] ウィンドウ



4.22.5 [Memory] ウィンドウの更新

プログラムメモリ、EEPROM、ユーザ ID メモリ、コンフィグレーションビットを表示する [Memory] ウィンドウは、以下の方法で更新できます。

1. デバッグ中の場合、プログラムを一時停止する ( ただし、ツールとデバイスがデバッグ読み出し ( 以下参照 ) をサポートしている場合、一時停止の必要はありません )。

2. [Read Device Memory] アイコンをクリックする。

デバッグ読み出し

ほとんどのデバイスでは、デバイスメモリの読み出し前にプログラムを一時停止する( デバッガセッションを終了する ) 必要があります。しかし、中にはデバッグモード中の読み出し ( デバッグ読み出し ) が可能なデバイスもあります。この機能を使えるかどうかは、デバッグ中に [Read Device Memory] アイコンが灰色表示になるか否かによって判別できます。

現在、MPLAB REAL ICE インサーキットエミュレータと MPLAB ICD 3 がデバッグ読み出しに対応しています。

デバッグ読み出しは、ターゲットのオシレータ速度で実行されるため、ターゲットが非常に低速で動作している場合、読み出されるまでに長時間を要する可能性があります。デバッグセッションを終了してから読み出しを実行する事で、強制的に高速の ICSP読み出しを使う事もできます。デバッグセッション中以外は必ず ICSP 読み出しが実行されるためです。

4.23 デバイスのプログラミング

コードのデバッグ後は、そのコードをターゲットデバイスにプログラミングします。

4.23.1 プロジェクトのプログラミングプロパティの設定

[Project Properties] ウィンドウでプログラミングオプションを設定します。

1. [Projects]ウィンドウでプロジェクト名を右クリックして[Properties]を選択する。

2. [Categories]でプログラミングに使うハードウェアツール (例 : PM3)を選択する。

3. [Option categories] で [Memories to Program] の設定を確認する。([Preserve Memory] オプションを使う場合、コード保護が有効でない事を確認します。プログラマが書き込みに必要なデータを読み出し、デバイスのバルク消去を実行し、デバイスを再プログラミングして、保護する領域にデータを再度書き込む事で、コードは保護されます。)

4. [Option categories] で [Program Options] の設定を確認する。

5. ハードウェアツールによって、プログラミングのオプションカテゴリが異なる。各オプションカテゴリを確認しプロジェクトに対して設定が正しい事を確かめる。

6. DMCI、モータ制御アプリケーション等と一緒に RTDM を使う場合、[Loading]カテゴリの [Load symbols when programming or building for production (slowsprocess)] チェックボックスにチェックを入れる必要がある。

プログラミングオプションの詳細は、ハードウェアツールの文書を参照してください。

必要なプログラミングオプションを設定したら、デバイスをプログラミングできます。



基本作業

4.23.2 プログラミングの実行

デバッグ済みコードでターゲットデバイスをプログラミングするには、ツールバーの[Make and Program Device Project] ボタンをクリックします。

表 4-11 に、その他のプログラミング関連の機能を示します。各アイコンの先頭の機能は、ボタンをクリックするだけで起動します。その他の機能を選択するにはボタンアイコン横の下矢印をクリックします。

表 4-11: プログラミング関連機能のツールバーボタン

4.23.3 MPLAB 統合量産環境を使ったプログラミング

MPLAB X IDE は、全てのプログラミング機能を備えている訳ではありません。その他のプログラミング機能のサポートについては、MPLAB X IDE に付属してインストールされる MPLAB IPE を参照してください。

ボタンアイコン

機能説明

Make and Program Device プロジェクトがビルドされ (必要な場合のみ )、デバイスがプログラミングされます。プログラミングが完了すると、即座にプログラムの実行が始まります。

Program Device for Debugging デバイスがデバッグイメージに基づいてプログラミングされます。プログラミングが完了すると、即座にプログラムの実行が始まります。

Program Device for Production デバイスが量産イメージに基づいてプログラミングされます。プログラミングが完了すると、即座にプログラムの実行が始まります。

Programmer to Go PICkit 3 PICkit 3のProgrammer to Go機能を使います。

Read Device Memory ターゲットデバイスのメモリの内容を MPLABX IDE に転送します。

Read Device Memory to File ターゲットデバイスのメモリの内容を指定したファイルに転送します。

Read EE/Flash Data Memory to a File

ターゲットデータメモリの内容を指定したファイルに転送します。

Hold In Reset デバイスをリセットと実行の間で交互に切り換えます。

MPLAB IPE のデスクトップアイコン



NOTE:


MPLAB® X IDE
ユーザガイド
第 5 章追加作業

5.1 追加作業の概要

以下は、MPLAB X IDE の追加作業の要約です。

プロジェクト関連作業

1. ウィザードを使って MPLAB IDE v8 のプロジェクトを MPLAB X IDE 内で開く( レガシー MPLAB プロジェクトのインポート )。

2. ウィザードを使ってプリビルドイメージ (HEX, COF, ELF) を開く ( プリビルドプロジェクト )。

3. 読み込み可能なプロジェクトとファイルによってプロジェクトの HEX ファイルを結合または置換する ( 読み込み可能なプロジェクト、ファイル、シンボル )。( 一般的なアプリケーションでは、読み込み可能なプロジェクトとファイル : ブートローダのように、読み込み可能なプロジェクト / ファイルを使ってブートローダとアプリケーションコードを結合しています。)

4. ライブラリプロジェクトを作成し、その出力をライブラリとしてビルドする( ライブラリプロジェクト )。

5. その他の組み込みプロジェクトまたはサンプルプロジェクトからプロジェクトを作成する ( その他の組み込みプロジェクト、サンプルプロジェクト )。

6. Microchip 社製に限らず他のタイプのファイルを使って作業する ( 他のタイプのファイルを使った作業 )。プロジェクトで使う既定値のファイルテンプレートを変更するためにコードテンプレートを変更または作成する (コードテンプレートの変更または作成 )。

7. プロジェクトで使うハードウェアまたは言語ツールを切り換える ( ハードウェアツールまたは言語ツールの切り換え )。

8. 既存プロジェクトのプロジェクトフォルダとエンコードを変更する ( プロジェクトフォルダとエンコードの変更 )。

9. 並列 make を使ってビルド時間を短縮する ( ビルド時間の短縮 )。

コードのデバッグ

1. ストップウォッチを使ってブレークポイント間のタイミングを調べる(ストップウォッチの使用 )。

2. ウィンドウに逆アセンブルコードを表示する([Disassembly]ウィンドウの表示)。3. 関数コールをたどるため、コールスタックまたはコールグラフを表示する (

コールスタックの表示、コールグラフの表示 )。4. ダッシュボード画面にブレークポイントリソース、チェックサム、メモリ

使用率等のプロジェクト情報を表示する ( ダッシュボードの表示 )。

コードの管理

1. ファクタリングおよびプロファイリングツールを使ってコードを改良する( コードの改良 *)。

2. ビルトインファイル履歴機能またはバージョン管理システムを使ってソースコードを管理する ( ソースコードの管理 )。

3. チームサーバと問題追跡システムを使って、コード開発とエラー追跡を連携する ( コード開発とエラー追跡の連携 *)。

機能拡張

1. コード開発を支援するためにプラグインツールを追加する(プラグインツールの追加 )。

* この機能については、[Start Page] の [My MPLAB X IDE] タブを開き、[ExtendMPLAB] セクションの [Selecting Simple or Full-Featured Menus] トピックを参照してください。



5.2 レガシー MPLAB プロジェクトのインポート

[Import Legacy Project] ウィザードを使うと、MPLAB IDE v8 プロジェクトを MPLABX IDE プロジェクトにインポートできます。以下にその際の注意事項を示します。

• MPLAB IDE v8 のワークスペースの設定は転送されません。

MPLAB IDE v8 のワークスペースに保存されている設定 ( ツール設定等 ) は、新しい MPLAB X IDE プロジェクトに転送されません。ワークスペースに保存されている情報の内容については、MPLAB IDE v8 ヘルプ ([MPLAB IDE Reference] >[Operational Reference] > [Saved Information]) を参照してください。

プロジェクトの設定 ( コンパイラ、リンカ、アセンブラの設定等 ) は、新しいMPLAB X IDE プロジェクトに転送されます。

• インポートする MPLAB IDE v8 プロジェクトが、「MPLAB C Compiler for PIC24MCUs and dsPIC DSCs」(MPLAB C30とも呼ぶ)とCOFFデバッグファイルフォーマットを使っている場合、以下のように変換されます。

- MPLAB X IDE プロジェクトが COFF ライブラリを使わない場合、デバッグファイルフォーマットは ELF/DWARF に変換されます。MPLAB X IDE プロジェクトが COFF ライブラリを使う場合、フォーマットは COFF のままとなります。

- MPLAB IDE v8はファイル拡張子の大文字 /小文字 (.cと .C等 )を区別しませんが、MPLAB X IDE はこれらを区別し、.cを C のコードファイル、.Cを C++ のコードファイルに関連付けます。従って、.C拡張子を持つ C コードを含む MPLAB IDEv8 プロジェクトをインポートすると、MPLAB X IDE はその .Cファイルを .cにリネームし、コンパイラの誤動作を防ぎます。

• MPLAB X IDE にインポートした MPLAB IDE v8 プロジェクトは元のプロジェクトと同じようにはビルドされません。

プロジェクトコード内で __FILE__, assert(), __TIME__, __DATE__を使ってはいけません。ビルド ( とチェックサム ) の結果が元のプロジェクトと異なってしまいます。

5.2.1 ウィザードを開く

このウィザードは、以下 2 通りの方法で開く事ができます。

5.2.1.1 [Start Page] から開く方法

• [Start Page] で、[Learn & Discover] タブを開き、[Dive In] セクションで [ImportMPLAB Legacy Project] へのリンクを選択する。または、[File] > [Import] > [MPLABIDE v8 Project] を選択する。

• すると [Import Legacy Project] ウィザードが開く。

5.2.1.2 [New Project] ウィザードを使う方法

[New Project] ウィザードは、以下のどちらかの方法で開けます。

• [Start Page] で、[Learn & Discover] タブを開き、[Dive In] セクションで [CreateNew Project] へのリンクを選択する

• [File] > [New Project] を選択する ( または <Ctrl>+<Shift>+<N>)[New Project] ウィザードが起動し、プロジェクトの新規作成を支援します。

• Step 1. Choose Project: [Microchip Embedded] カテゴリを選択し、プロジェクトタイプ [Existing MPLAB IDE v8 Project] からプロジェクトを選択します。 [Next>] をクリックします。

• すると [Import Legacy Project] ウィザードが開きます。


追加作業

5.2.2 [Import Legacy Project] ウィザード

以下の手順により、MPLAB IDE v8 プロジェクトをインポートします。各ステップの手順を終えたら、[Next>] をクリックして次のステップへ進んでください。

• Step 1 または 2. Import Legacy Project: レガシープロジェクトを選択します。

• Step 2または3. Select Device: アプリケーションで使う予定のデバイスを [Device]ドロップダウンリストから選択します。選択肢を絞り込むために、初にデバイスファミリを選択します。

• Step 3 または 4. Select Header:このステップは、選択したデバイスでヘッダが利用可能である場合に表示されます。デバイスがヘッダを必要とするか、またはデバッグ回路を内蔵しているかどうかは、

『Processor Extension Pak (PEP) およびデバッグヘッダ仕様』(DS51292 またはオンラインヘルプ ) で確認できます。上記を確認してからヘッダを使うかどうかを選択します。

• Step 4 または 5. Select Tool: アプリケーションの開発に使う開発ツールをリストから選択します。

選択したデバイスに対するツールのサポートレベルが、ツール名の横のマークで色分け表示されます。緑は完全サポート、黄はベータサポート、赤は未サポートを意味します。

• Step 5 または 6. Select Compiler: アプリケーションの開発に使う言語ツール( コンパイラ ) をリストから選択します。

選択したデバイスに対するツールのサポートレベルが、ツール名の横のマークで色分け表示されます。緑は完全サポート、黄はベータサポート、赤は非サポートを意味します。

• Step 6 または 7. Select Project Name and Folder: 双方のプロジェクトの保守性を保つために、既定値の名前とフォルダは変更しない事を推奨します。

File Locations: 新規プロジェクトは、ソースファイルをプロジェクトフォルダにコピーしません。その代わりに、v8 フォルダ内のファイル格納場所を参照します。独立した MPLAB X IDE プロジェクトを作成するには、新規プロジェクトを作成して、MPLAB IDE v8 のソースファイルを、そのプロジェクトにコピーする必要があります。

Main Project: インポート時にこのプロジェクトをメインプロジェクトとするために、チェックを入れます。

File Formatting: MPLAB IDE v8 からプロジェクトをインポートする際に使う文字エンコードの既定値は「ISO-8859-1」です。インポート元のプロジェクトで実際に使っているエンコードを選択する必要があります。例えば、MPLAB IDE v8 のフォーマットが「950 (ANSI/OEM – TraditionalChinese Big5)」である場合、ドロップダウンリストから [Big5] を選択します。

• Step 7 または 8. Summary: [Finish] をクリックする前に、設定した内容を確認します。不適切な設定が見つかった場合、[Back] ボタンを使って以前のステップに戻って修正します。

• レガシープロジェクトが [Projects] ウィンドウ内に開きます ( 図 5-1 参照 )。



図 5-1: [Import Legacy Project] ウィザード – プロジェクト名とフォルダの選択


追加作業

5.3 プリビルドプロジェクト

[Import Image File] ウィザードを使って、プリビルドした読み込み可能イメージ (HEX,COF, ELF ファイル ) からプロジェクトを作成します。

このウィザードは、以下の 2 通りの方法で開く事ができます。

5.3.1 [Start Page] から開く方法

• [Start Page] で、[Learn & Discover] タブを開き、[Dive In] セクションで [ImportHex (Prebuilt) Project] へのリンクを選択する。または、[File] > [Import] > [Hex/ELF(Prebuilt) File] を選択する。

• すると [Import Image File] ウィザードが開く。

5.3.2 [New Project] ウィザードを使う方法




• Step 1. Choose Project: [Microchip Embedded] カテゴリを選択し、プロジェクトタイプ[Prebuilt (Hex, Loadable Image) Project]からプロジェクトを選択します。[Next>]をクリックします。

• すると [Import Image File] ウィザードが開く。

5.3.3 [Import Image File] ウィザード

以下の手順により、イメージファイルをインポートします。各ステップの手順を終えたら、[Next>] をクリックして次のステップへ進んでください。

• Step 1または2. Import Image File: イメージファイルの名前と格納場所を選択します。ダイアログを使って格納場所を選択できます。

• Step 2または3. Select Device: アプリケーションで使う予定のデバイスを [Device]ドロップダウンリストから選択します。選択肢を絞り込むために、初にデバイスファミリを選択します。

• Step 3 または 4. Select Header: このステップは、選択したデバイスでヘッダが利用可能である場合に表示されます。デバイスがヘッダを必要とするか、またはデバッグ回路を内蔵しているかどうかは、『Processor Extension Pak (PEP) およびデバッグヘッダ仕様』(DS51292 またはオンラインヘルプ ) で確認できます。上記を確認してからヘッダを使うかどうかを選択します。

• Step 4 または 5. Select Tool: アプリケーションの開発に使う開発ツールをリストから選択します。選択したデバイスに対するツールのサポートレベルが、ツール名の横のマークで色分け表示されます。緑は完全サポート、黄はベータサポート、赤は未サポートを意味します。

• Step 6 または 7.Select Project Name and Folder: 新規プロジェクトの名前と格納場所を選択します。

• ダイアログを使って格納場所を選択できます。• Step 7 または 8. Summary: [Finish] をクリックする前に、設定した内容を確認します。不適切な設定が見つかった場合、[Back] ボタンを使って以前のステップに戻って修正します。

• 作成したプロジェクトが [Projects] ウィンドウ内に表示されます。

プロジェクトを HEX ファイルとしてエクスポートする方法はセクション 12.13.2「[Projects] ウィンドウ – [Project] メニュー」を参照してください。

Note: デバイスにプリビルドイメージをプログラミングする場合、デバイスをプログラミングするだけで make は実行しないのですが、[Make andProgram Device] ボタンをクリックします。



5.4 読み込み可能なプロジェクト、ファイル、シンボル

複数のプロジェクトの結合、複数の HEX ファイルの結合、プロジェクトと HEXファイルの結合、プロジェクト HEX ファイルの置換には、読み込み可能なプロジェクトおよびファイルを使います。HEXMATE アプリケーションを使って、プロジェクトまたは読み込んだ HEX ファイルを 1 つのファイルにマージします。このアプリケーションの使い方の詳細は、インストールした MPLAB XC8 C コンパイラの docsフォルダにある『MPLAB XC8 C Compiler User’s Guide』(DS50002053) を参照してください。セクション 9.7.8「HEXMATE Conflict Report Address Error」も参照してください。

RTDM (Real Time Data Monitoring) と DMCI (Data Monitoring and Control Interface)を使う場合 ( モータ制御アプリケーション等 ) のように、量産ビルドまたはプログラミング中にデバッグシンボルを読み込むには、読み込み可能なシンボルを使います。

読み込み可能なプロジェクトまたはファイルは、ブートローダとアプリケーションを結合したコードを作成する場合に便利です。セクション 5.5「読み込み可能なプロジェクトとファイル : ブートローダ」を参照してください。

以下に、現在のプロジェクトと読み込み可能なプロジェクトおよびファイルの組み合わせを示します。

以下にオプションを示します。

読み込み可能プロジェクト / ファイルの設定については、以下を参照してください。

• [Projects] ウィンドウ – [Loadables] フォルダによる設定

• [Project Properties] ウィンドウ – [Loading] カテゴリによる設定

• 読み込み可能プロジェクト / ファイルの推奨使用法

表 5-1: 読み込み可能プロジェクト / ファイルの組み合わせ

現在のプロジェクト読み込み可能プロジェクト / ファイル

注意

既存のスタンドアロンMPLAB IDE v8ライブラリ

スタンドアロンなし

HEX ファイルなし

COF/ELF ファイル • デバッグできますがビルドはできません。 • エラーが [Output]ウィンドウに表示されます。

ビルド済み (HEX) HEX ファイル • 重複しているメモリ領域は自動ではチェックしません。

• デバッグできますがビルドはできません。 • [Build] ボタンは無効になります。

COF/ELF ファイル

ビルド済み (COF/ELF) HEX ファイル

COF/ELF ファイル

表 5-2: 読み込み可能プロジェクト / ファイルのオプション

読み込み可能プロジェクトの追加

現在のプロジェクトに既存のプロジェクトを読み込みます。現在のプロジェクトをビルドする際に、全てのプロジェクトがビルドされHEX ファイルが 1 つに結合されます。デバッグファイルも全てが結合されます(COFF または ELF)。

読み込み可能ファイルの追加

現在のプロジェクトに既存の HEX ファイルを読み込みます。現在のプロジェクトをビルドする際に、読み込んだ HEX ファイルとその他のHEX ファイルが 1 つのファイルに結合されます。Note: HEX ファイルを読み込んだプロジェクトはデバッグできません。デバッグが必要な場合、読み込み可能プロジェクトを使います。

代替ファイルの追加

代替 HEX ファイルを読み込みます。このオプションを使うとビルド後の処理を設定できます。この処理では、プロジェクトの HEX ファイルを別の場所にコピーまたは移動し、HEXMATE等のツールを使ってファイルを別の HEX ファイルとマージし、IDE に読み戻す事ができます。


追加作業

5.4.1 [Projects] ウィンドウ – [Loadables] フォルダによる設定

[Projects] ウィンドウの [Loadables] フォルダを右クリックして、以下のオプションを選択します ( 図 5-2)。• Add Loadable Project – 既存のプロジェクトを選択して、現在のプロジェクトに追加します。さらにプロジェクトを追加するには手順を繰り返します。

• Add Loadable Files – 既存の HEX ファイルを選択して、現在のプロジェクトに追加します。さらに HEX ファイルを追加するには手順を繰り返します。

• Properties – 読み込みのために [Project Properties] ウィンドウを開きます。セクション5.4.2「[Project Properties] ウィンドウ – [Loading] カテゴリによる設定」を参照してください。

全てのプロジェクトをビルドして HEX ファイルを 1 つに結合するには、現在のプロジェクトをビルドします。デバッグファイルも全て結合されます。

図 5-2: [Projects] ウィンドウ – [Loadables] フォルダ

5.4.2 [Project Properties] ウィンドウ – [Loading] カテゴリによる設定

[Project Properties] ウィンドウを開き ([File] > [Project Properties])、[Loading] カテゴリをクリックします。

• 現在のプロジェクトを他のプロジェクトと結合する方法

• 現在のプロジェクト HEX ファイルを他の HEX ファイルと結合する方法

• 代替 HEX ファイルを読み込む方法

• プログラミング / ビルド中にデバッグシンボルを読み込む方法

セクション 9.6「MPLAB X IDE の問題」も参照してください。



図 5-3: [Project Properties] ウィンドウ – [Loading] カテゴリ

5.4.2.1 現在のプロジェクトを他のプロジェクトと結合する方法

1. [Add Loadable Project] をクリックする ([Add Loadable Project] ダイアログが開きます )。

2. プロジェクトを選択する。

3. [Configurations] からこのプロジェクトで使うビルドコンフィグレーションを選択する ( このプロジェクトに他のコンフィグレーションを追加していなければ、ここには [default] しか表示されません )。

4. [Store path as] から、読み込み可能プロジェクトへのパス情報の保存方法を選択する。以下から選択する。

a) Auto – 読み込み可能プロジェクトへのパスを相対パスと絶対パスのどちらにするかを、その格納場所に基づいて MPLAB IDE が決定できるようにします。メインプロジェクトのフォルダに読み込み可能プロジェクトが含まれている場合、参照は相対パスになります。それ以外の場合、参照は絶対パスになります。

b) Relative – 読み込み可能プロジェクトを (メインプロジェクトへの )相対パスで参照します。これは、パスを追加する際に推奨する方法です。

c) Absolute – 読み込み可能プロジェクトを絶対パスで参照します。このモードが便利な場合もありますが、プロジェクトを別のシステムに移動する場合、しばしばパスの修正が必要です。

5. [Add] をクリックしてダイアログを閉じる。

6. 現在のプロジェクトのビルドにこのプロジェクトを含める場合、[ProjectProperties] ウィンドウで [Build] にチェックを入れる。

7. 追加の順序を変更するには、[Up] および [Down] ボタンを使う ( 複数のプロジェクトを追加した場合、ここに表示される順序が、現在のプロジェクトの HEX ファイルにこれらの HEX ファイルが追加される順序を決定します )。

8. [Apply] または [OK] をクリックして変更を確定する。

次に現在のプロジェクトをビルドする際は、ここに表示されたプロジェクトも ([Build]がチェックされていれば ) ビルドされ、それらの HEX ファイルが現在のプロジェクトのHEX ファイルと結合されて、1 つの出力 HEX ファイルが生成されます。デバッグファイルも全て結合されます。


追加作業

図 5-4: [Add Loadable Project] ダイアログ

5.4.2.2 現在のプロジェクト HEX ファイルを他の HEX ファイルと結合する方法

1. [Add Loadable File]をクリックする([Add Loadable File]ダイアログが開きます)。2. HEX ファイルを選択する。

3. [Store path as] から、読み込み可能ファイルへのパス情報の保存方法を選択する。以下から選択する。

a) Auto – 読み込み可能ファイルへのパスを相対パスと絶対パスのどちらにするかを、その格納場所に基づいて MPLAB IDE が決定できるようにします。メインプロジェクトのフォルダに読み込み可能ファイルが含まれている場合、参照は相対パスになります。それ以外の場合、参照は絶対パスになります。

b) Relative – 読み込み可能ファイルを ( メインプロジェクトへの ) 相対パスで参照します。これは、パスを追加する際に推奨する方法です。

c) Absolute – 読み込み可能ファイルを絶対パスで参照します。このモードが便利な場合もありますが、プロジェクトをあるシステムから別のシステムに移動する場合の多くで、これらのパスは修正が必要です。

4. [Add] をクリックしてダイアログを閉じる。

5. 追加の順序を変更するには、[Up]および[Down]ボタンを使う([Project Properties]ウィンドウで、複数のファイルを追加した場合、ここに表示される順序が、現在のプロジェクトの HEX ファイルにこれらの HEX ファイルが追加される順序を決定します )。

6. [Apply] または [OK] をクリックして変更を確定する。

次に現在のプロジェクトをビルドする際は、ここに表示された HEX ファイルが現在のプロジェクトの HEX ファイルと結合されて、1 つの出力 HEX ファイルが生成されます。

量産ビルドまたはプログラミング中にデバッグシンボルを読み込む方法

既定値では、[Load symbols when programming or building for production (slowsprocess)] のチェックボックスはチェックが外れています。この場合、HEX ファイルのみが読み込まれます。



このチェックボックスにチェックを入れると、HEX ファイルと全てのデバッグシンボルが読み込まれます。この場合、プログラミング / ビルドの処理速度は遅くなります。しかしこの方法は、RTDM と DMCI を使う場合 ( モータ制御アプリケーション等 ) に必要です。

図 5-5: 読み込み可能ファイルの追加

5.4.2.3 代替 HEX ファイルを読み込む方法

1. [Use this .hex file instead of MainProjectHexFile] にチェックを入れます。

2. [...] をクリックして、[Add Loadable File] ダイアログを開きます。このダイアログを使った HEX ファイルの追加の詳細はセクション 5.4.2.2「現在のプロジェクトHEX ファイルを他の HEX ファイルと結合する方法」を参照してください。

次に現在のプロジェクトをビルドする際、その完了時に代替 HEX ファイルが読み込まれます。

5.4.2.4 プログラミング / ビルド中にデバッグシンボルを読み込む方法

RTDM と DMCI を使う場合 ( モータ制御アプリケーション等 )、[Load symbols whenprogramming or building for production (slows process)] のチェックボックスにチェックを入れると、プログラミング中にデバッグシンボルを読み込む事ができます。それ以外の場合、チェックボックスのチェックは外したまま ( 既定値 ) にしてプログラミングとビルドの速度を向上させます。

5.4.3 読み込み可能プロジェクト / ファイルの推奨使用法

読み込み可能プロジェクト / ファイルは、以下の方法で使う事を推奨します。

1. デバイスのコンフィグレーションビットの設定と初期化を行うプロジェクトをメインプロジェクトとして選択します ( 右クリックして [Set as Main Project] を選択 )。メインプロジェクトと競合するため、読み込み可能プロジェクト / ファイルにデバイスコンフィグレーション設定を持たせる事はできません。

2. 他のプロジェクトを、読み込み可能プロジェクト / ファイルとしてメインプロジェクトに追加します。読み込むプロジェクトに複数のプロジェクトコンフィグレーションが設定されている場合、読み込む際にそれらを全て指定します。

読み込み可能プロジェクト/ファイルを含むプロジェクトをメインプロジェクトに指定しておく事で、どの読み込み可能プロジェクト / ファイルに変更が生じても、ビルドを実行する際にその変更が確実に反映されるようにします。


追加作業

5.5 読み込み可能なプロジェクトとファイル : ブートローダ

ブートローダとアプリケーションのコードを結合する方法

1. アプリケーション用とブートローダ用にそれぞれ1つずつプロジェクトを作成する。

2. ブートローダのプロジェクトまたは HEX ファイルをアプリケーションプロジェクトに読み込む (その方法はセクション5.4.1「[Projects]ウィンドウ – [Loadables]フォルダによる設定」またはセクション 5.4.2「[Project Properties] ウィンドウ –[Loading] カテゴリによる設定」を参照してください )。

次にアプリケーションプロジェクトをビルドすると、ブートローダとアプリケーションの HEX ファイルが結合されたものが生成されます。デバッグファイルも全て結合されます。

ビルドのエラーはセクション 5.4.3「読み込み可能プロジェクト / ファイルの推奨使用法」または以下のセクションを参照してください。

注意事項 #1: PIC18 MCU (MPLAB C18) 向け MPLAB C コンパイラ

このコンパイラはアプリケーションの起動コード (c018x.o) を生成します。リセットベクタ ( アドレス 0) で始まるこの起動コードはソフトウェアスタックの初期化、必要に応じて idata セクションの初期化、main() へのジャンプを含みます。この起動コードがアプリケーション内に残っていると、ブートローダコードリセットと競合が生じ、データ競合に関するリンカエラーメッセージが表示されます。

解決策の 1 つは、0 以外のアドレスで始まるように起動コードを編集する事です。

注意事項 #2: MPLAB XC8 – PIC18 MCU の例

以下の Microchip 社ウェブセミナーでは、PIC18 MCU 向けにブートローダとアプリケーションコードを組み合わせる方法を、MPLAB XC8 と MPLAB X IDE を使って詳しく説明しています。「Linking PIC18 Bootloaders & Applications」


http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=2813&dDocName=en558478


5.6 ライブラリプロジェクト

IDE が生成した makefile を使うライブラリプロジェクトを新規作成し、プロジェクトを実行ファイルではなくライブラリファイルとしてビルドします (赤のテキストを参照 )。

図 5-6: ライブラリプロジェクトの例

まず、以下のどちらかの方法で [New Project] ウィザードを開きます。


• [File] > [New Project] を選択する ( または <Ctrl>+<Shift>+<N>)[New Project] ウィザードが起動し、プロジェクトの新規作成を支援します。[Next>]をクリックすると次のステップに進みます。

• Step 1. Choose Project: [Microchip Embedded] カテゴリを選択し、プロジェクトタイプ [Library Project] からプロジェクトを選択します。

• Step 2. Select Device: アプリケーションで使う予定のデバイスを [Device] ドロップダウンリストから選択します。選択肢を絞り込むために、初にデバイスファミリを選択します。

• Step 3. Select Header: このステップは、選択したデバイスでヘッダが利用可能である場合に表示されます。デバイスがヘッダを必要とするか、またはデバッグ回路を内蔵しているかどうかは、『Processor Extension Pak (PEP) およびデバッグヘッダ仕様』(DS51292 またはオンラインヘルプ ) で確認できます。上記を確認してからヘッダを使うかどうかを選択します。

• Step 4. Select Tool: アプリケーションの開発に使う開発ツールをリストから選択します。

選択したデバイスに対するツールのサポートレベルが、ツール名の横のマークで色分け表示されます。緑は完全サポート、黄はベータサポート、赤は未サポートを意味します。

• Step 5. Select Compiler: アプリケーションの開発に使う言語ツール ( コンパイラ ) をリストから選択します。

選択したデバイスに対するツールのサポートレベルが、ツール名の横のマークで色分け表示されます。緑は完全サポート、黄はベータサポート、赤は非サポートを意味します。

• Step 6. Select Project Name and Folder: 新規プロジェクトの名前と格納場所を選択します。ダイアログを使って格納場所を選択できます。

作成したプロジェクトが [Projects] ウィンドウ内に表示されます。

必要に応じてライブラリプロジェクトをスタンドアロン ( アプリケーション ) プロジェクトに変更できます。詳細はセクション 4.14.1「プロジェクトコンフィグレーションタイプの変更」を参照してください。


追加作業

5.7 その他の組み込みプロジェクト

MPLAB X IDE では、他の組み込みプロジェクトを選択して、そこからプロジェクトを作成できます。

1. [File] > [New Project] を選択します。

2. [Categories] の下の [Other Embedded] をクリックし、使用可能な組み込みプロジェクトのリストから選択します。

3. MPLAB X IDE プロジェクトの作成を継続します。

この機能は既存ファイルを MPLAB X IDE プロジェクトにインポートします。他の組み込みプロジェクト設定の変換やコード変換には未対応です。

MPLAB X IDE の使い方の詳細は以下を参照してください。

• 第 3 章「チュートリアル」

• 第 4 章「基本作業」

使用可能なコンパイラの詳細は以下を参照してください。


5.8 サンプルプロジェクト

サンプルプロジェクトを作成すると、Microchip 社のデバイス、ツール、MPLAB XIDE の習得に役立ちます。

1. [File] > [New Project] を選択します。

2. [Categories] の下の [Samples]>[Microchip Embedded] をクリックし、使用可能な組み込みプロジェクト (デモボードのライトを点滅させるもの )またはテンプレートプロジェクトのリストから選択します。詳細は説明を参照してください。

デモボードの製品番号は以下の通りです。

Explorer16 デモボード : DM240001PICDEM 2 Plus: DM163022-1

5.9 他のタイプのファイルを使った作業

[File] > [New File] を選択すると、多くのタイプのファイルが提示されますここまでは、Microchip 社のコンパイラファイルを使った作業を検討してきました。しかし、使うプロジェクト言語ツールや特定のファイルを作成する必要性に応じて、他のタイプのファイルを選択する事もできます。

表 5-3: ファイルタイプ

カテゴリファイルタイプ

MicrochipEmbedded

MPLAB X IDE がサポートする言語ツール用のファイルです。

利用可能なファイルタイプは、コンパイラフォルダを選択すると表示されます。

C 汎用 C ファイル

C++ 汎用 C++ ファイル

Assembler 汎用アセンブリファイル

Shell Scripts シェルスクリプトファイル : Bash, C, Korn 等

Makefiles Makefile ファイル

XML XML ファイル

Other HTML、JavaScript 等の他のタイプのファイル

一覧に必要なファイルタイプが表示されない場合、[Empty File] を選択し、次のウィンドウで、拡張子と共にファイルに名前を付けます。




5.10 コードテンプレートの変更または作成

プロジェクトに追加するファイルを作成 ( セクション 4.9「ファイルの新規作成」参照 )する際に、新規ファイル用のテンプレートを使います。このテンプレートを編集するには、[Tools] > [Templates] から [Open in Editor] を選択します。このダイアログの[Add] または [Duplicate] ボタンを使って、テンプレートを新規作成する事もできます。

[New Folder] ボタンを使うと、テンプレートを保存する新しいフォルダを作成できます。MPLAB X IDE は「Microchip Embedded」、「Shell Scripts」、「Makefiles」、「Other」以外の全てのフォルダを無視するため、ファイルまたはフォルダは、これらのフォルダの下に作成する必要がある事に注意してください。

図 5-7: テンプレートマネージャ

テンプレートオプションは、[Tools] > [Options] (Mac OS X の場合、[mplab_ide] >[Preferences]) を選択し、[Editor] ボタンをクリックし、[Code Templates] タブで設定できます ( 以下を参照 )。

「fcom」オプションは、C コード用のコメントオプションです。[Editor] ウィンドウに「fcom」と入力して <Tab> キーを押すと、以下のテキストが挿入されます。

// <editor-fold defaultstate="collapsed" desc="${comment}">${selection}${cursor}// </editor-fold>

このオプションを使うと、上記テキストで囲まれたコードセクションを非表示 ( 折り畳み )/ 表示 ( 展開 ) できます。


追加作業

図 5-8: テンプレートオプション



5.11 ハードウェアツールまたは言語ツールの切り換え

現在接続しているものと異なるデバッグツールを選択しているプロジェクトを実行またはデバッグ実行しようとした場合、接続中のハードウェアツールをそのプロジェクト用に使うかどうかを確認する以下のダイアログが表示されます。

図 5-9: [Switch Hardware Tool] ダイアログ

複数のハードウェアツールを接続しておき、[Project Properties] ダイアログ ([File] >[Project Properties]) でそれらのツールを切り換える事もできます。

複数バージョンのコンパイラツールチェーン ( 言語ツール ) を切り換える場合も、[Project Properties] ダイアログを使います。


追加作業

5.12 プロジェクトフォルダとエンコードの変更

プロジェクトを作成した際、プロジェクトフォルダとエンコードを指定しました。プロジェクト作成後は、[Project Properties] ウィンドウの [General] カテゴリを使ってプロジェクトフォルダを追加または無視し、プロジェクトエンコードを変更できます。

図 5-10: [Project Properties] ウィンドウ – [General] カテゴリ

表 5-4: [Project Properties] ウィンドウ – [General] カテゴリ

オプション説明

[Project Location]

現在のプロジェクトの格納場所を表示します。プロジェクトの格納場所の変更はセクション 8.9「プロジェクトの移動、コピー、リネーム」を参照してください。

[Source Folders]

プロジェクトファイルを探す際に MPLAB X IDE が検索するフォルダを追加します。

Note: プロジェクトフォルダの外にファイルを追加するとプロジェクトの移植性が損なわれる場合があります。

[Ignored Folders Pattern]

指定した正規表現パターンに従ってプロジェクトフォルダ内のフォルダを無視します。

[Encoding] プロジェクトエンコードを変更します。

この選択によって、コード構文の色分け設定が決まります。色分けは [Tools] >[Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Fontsand Colors] ボタンをクリックして、[Syntax] タブより編集できます。



5.13 ビルド時間の短縮

PC によっては、並列 make( セクション 12.14.2「[Project Options] タブ」参照 ) を使ってプロジェクトのビルド時間を短縮できる場合があります。並列 make をサポートしていない言語ツールもあります。

オペレーティングシステム (OS) の変更を検討する方法もあります。OS によっては、より高速にファイルをアクセスできます。MPLAB X IDE は Windows, Linux, Mac OSをサポートしているため、その中でどれが適しているかを検討します。

5.14 ストップウォッチの使用

ストップウォッチを使うと、2 つのブレークポイント間のタイミングを調べる事ができます。

ストップウォッチの使い方

1. ストップウォッチを開始するブレークポイントを追加する。 2. ストップウォッチを停止するブレークポイントを追加する。

3. [Window] > [Debugging] > [Stopwatch]を選択し、ウィンドウの左にある[Properties]アイコンをクリックし、開始および停止ブレークポイントを選択する。

4. その後にプログラムをデバッグ実行すると、ストップウォッチのタイミング結果が表示される。

図 5-11: ストップウォッチの設定

図 5-12: [Stopwatch] ウィンドウの内容


追加作業

[Stopwatch] ウィンドウの左側には以下のアイコンが表示されます。

5.15 [Disassembly] ウィンドウの表示

このウィンドウは逆アセンブルコードを表示します。このウィンドウは、[Window] >[Debugging] > [Output] > [Disassembly Listing File] と選択して開きます。

この情報は、リンカが生成したリスティングファイルにも含まれている場合があります。このファイルを開くには、[File] > [Open File] を選択し、ProjectName.lstファイルを選択します。

逆アセンブルファイル全体を素早く表示するには、[Disassembly] ウィンドウで右クリックして [Disassembly Listing File] を選択します。

5.16 コールスタックの表示

16/32 ビットデバイスでは、[Call Stack] ウィンドウを使って、実行中の C コード内のCALLと GOTOを表示できます。このウィンドウは、アセンブリコードには対応していません ( コールスタックを使う場合、コードの適化を OFF にする事を推奨します )。[Call Stack] ウィンドウは、関数とその引数を、実行中のプログラムで呼び出された順番に一覧表示します。

コールスタックの表示方法


2. [Window] > [Debugging] > [Call Stack] を選択して [Call Stack] ウィンドウを開く。セクション 12.4「[Call Stack] ウィンドウ」も参照してください。

コールスタックの詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] >[Debugging C/C++/Fortran Applications With gdb] > [Using the C/C++/Fortran CallStack]) を参照してください。

表 5-5: ストップウォッチアイコン

アイコンアイコンテキスト説明

Properties ストップウォッチのプロパティを設定します。現在のブレークポイントまたはトリガの 1 つを開始する時点、もう1 つを停止する時点として選択します。

Reset Stopwatch on Run

実行開始時にストップウォッチの時間を 0にリセットします。

Clear History [Stopwatch] ウィンドウをクリアします。

Clear Stopwatch ( シミュレータのみ ) デバイスのリセット後にストップウォッチをリセットします。

Note: [Disassembly] ウィンドウは各命令を逆アセンブルします。しかし、命令に関連したバンク切り換えの履歴は保持していません。従って、ウィンドウに表示される SFR 名は Bank 0 用です。



5.17 コールグラフの表示

[Call Graph] ウィンドウは、選択した関数からコールされている関数、または、選択した関数をコールしている関数をツリー構造で表示します。

コールグラフの表示方法

選択 ( 強調表示 ) した関数を右クリックし、ドロップダウンメニューから [ShowCall Graph] を選択する。

詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] > [Working WithC/C++/Fortran Projects] > [Navigating Source Files and Projects] > [Using the CallGraph]) を参照してください。

図 5-13: main 関数のコールグラフ


追加作業

5.18 ダッシュボードの表示

[Window] > [Dashboard] を選択すると、プロジェクト情報を表示できます。

図 5-14: ダッシュボードの表示

ダッシュボードは、以下のどちらかのプロジェクトを表示します。

• メインプロジェクトが未選択 ([Run] > [Set Main Project] > [None]) の場合、[Projects] ウィンドウ内でアクティブなプロジェクト ([Projects] ウィンドウ内でいずれかのプロジェクトをクリックすると、そのプロジェクトがアクティブになります )

• メインプロジェクト ( 他のプロジェクトは、アクティブ / 非アクティブに関係なく表示されません )



5.18.1 ダッシュボードのグループ

[Dashboard] ウィンドウのプロジェクト情報はグループごとに表示されています。

表 5-6: ダッシュボードのグループ

グループ定義と説明

プロジェクト名 • アクティブ / メインプロジェクトの名前• プロジェクトタイプ ( アプリケーションまたはライブラリ ) とプロジェ

クトコンフィグレーション ( 既定値またはユーザ定義 )Device • プロジェクトデバイス

• 実行またはデバッグ実行中に生成された全てのステータスフラグ• デバイスのメモリに読み込んだ内容のチェックサム

( チェックサムを表示するにはビルドする必要があります。) セクション6.10「チェックサム」を参照してください。

Compiler Toolchain

• プロジェクトツールチェーン名 ( 例 : XC8)、( ツールのバージョン番号 )、[ 実行ファイルへのパス ]

• イメージタイプ ( 量産またはデバッグ )、ツールチェーンのライセンスタイプに対応する適化レベル( 適化の詳細は言語ツールの文書を参照してください。)

• コンパイラライセンス * の情報 : (コンパイラライセンスの詳細はhttp://www.microchip.com/mplabxcを参照してください。)

- license type: ワークステーションまたはネットワーク- license mode: FREE, STD, PRO- license seats: 利用できるシートの総数- licenses available: 利用できるライセンスの数- HPA – HPA が終了するまでの日数- Expire – ライセンスが失効するまでの日数- Press for status – [Output] ウィンドウにステータスを表示します。

* コンパイラライセンスを表示するには MPLAB XC8 v1.34, MPLAB XC16v1.25, MPLAB XC32 v1.40 のいずれかを入手する必要があります。

Memory • Usage Symbols disabled. のアラートが出ている場合、アラートをクリックして有効にします。[Project Properties] ウィンドウの [Loading] カテゴリをクリックして開きます。[Load symbols when programming or building forproduction (slows process)] チェックボックスにチェックを入れます。

• メモリのタイプ (Data または Project) とデバイスでの利用可能容量• 使用済みメモリは残りのメモリ容量の目安になります。コンパイラはプログラム空間の使用率、コンフィグレーションビット、ID 位置、EEPROM( デバイスに内蔵されている場合 ) の詳細を記載したメモリ概要を出力します。これらのメモリ空間の合計は、ワードサイズで考えると [Dashboard] の[Program Used] と一致します。メモリ容量が比較的少ないデバイスでは、マップファイルを確認する必要があります。

Debug Tool ハードウェアデバッグツール• デバッグツールの名前とシリアル番号• デバッグツールの接続接続はデバッグ実行、実行、プログラミング中にのみアクティブになります。その他の状態での接続は非アクティブです。ツールの接続を常時アクティブにするには、[Tools] > [Options] (Mac OS Xの場合、[mplab_ide] > [Preferences]) を選択し、[Embedded] ボタンをクリックし、[Generic Settings] タブを開いて、[Maintain active connectionto hardware tool] にチェックを入れます。

• [Refresh Debug Tool Status] ボタンをクリックすると、ハードウェアデバッグツールのファームウェアバージョンと現在の電圧レベルが表示されます。

シミュレータ• デバッグツールの名前 ( 例 : シミュレータ )• シミュレートする周辺モジュールをクリックしてサポートされている周辺モジュールを表示します。


http://www.microchip.com/mplabxc

追加作業

5.18.2 [Dashboard] アイコン

[Dashboard] ウィンドウの左側のアイコンで、下表の各種機能にアクセスできます。

Debug Resources

ハードウェアブレークポイント現在使用中のブレークポイント数とプロジェクトデバイス向けに使用可能なブレークポイント数を示します。ソフトウェアブレークポイントプロジェクトデバイスでソフトウェアブレークポイントがサポートされているかどうかを示します。デバッグツールアクセサリこのプロジェクトで使っているデバッグツールアクセサリ ( デバッグヘッダ等 ) の種類を示します。

表 5-7: サイドバーのアイコン

アイコン機能

プロジェクトプロパティ :[Project Properties] ダイアログを表示します。

デバッグツールのステータス表示を更新する :クリックすると、ハードウェアデバッグツールの詳細を表示します。

ソフトウェアブレークポイントをトグル ( 有効化 / 無効化 ) する :クリックするたびにソフトウェアブレークポイントの有効 / 無効が切り換わります。この機能の状態はアイコンに表示されています。中心が赤 : 無効中心が緑 : 有効中心が黒 : サポートしていない – 使用中のデバイスまたはツールで利用できるブレークポイント数を超えている場合

デバイスデータシートを開く :Microchip 社ウェブサイトから (http://www.microchip.com/) デバイスのデータシートを開きます。ローカルに保存したデータシートを開くか、ブラウザを開いて Microchip 社ウェブサイトでデータシートを検索できます。

コンパイラのヘルプ :クリックすると、コンパイラインストールフォルダの「docs」フォルダ内の文書の主索引 ( 利用できる場合 ) が開きます。

表 5-6: ダッシュボードのグループ ( 続き )グループ定義と説明


http://www.microchip.com/


5.19 コードの改良

リファクタリングおよび / またはプロファイリングを使ってコードを改良します。

コードのリファクタリングは、コードの機能を変更せずにコードを単純化します。現在、C コードでは以下を行えます。

• 複数ファイルを通して、関数の使用箇所を検出する

• 複数ファイルを通して、関数とパラメータの名前を変更する

詳細はセクション 7.7「C コードのリファクタリング」を参照してください。

コードのプロファイリングは、プログラムの実行中に CPU 使用率、メモリ使用率、スレッド使用率を常時監視します。プロファイリングツールは、C プロジェクト実行時に常時動作します。

5.20 ソースコードの管理

多数のファイルを含む複雑なアプリケーションをチームで開発する場合、ソースコードの変更管理が必要です。MPLAB X IDE はソースファイルのバージョン管理機能を備えています。さらに、外部のリビジョン ( ソースまたはバージョン ) 管理プログラムもサポートしています。

5.20.1 ローカル履歴

MPLAB X IDE は、NetBeans プラットフォームの特長であるローカルファイル履歴機能を内蔵しています。この機能は、ローカルプロジェクトおよびファイル向けの、従来のバージョン管理システムのようなバージョン管理機能です。これにはローカル DIFFおよびファイル復元ツールが含まれます。

ファイルのローカル履歴を表示させるには、[Project] または [File] ウィンドウでファイルを右クリックし、[History] > [Show History] を選択します。そのファイルの全変更履歴が表示されます。

前のバージョンに戻すには、[Project] または [File] ウィンドウでファイルを右クリックし、[History] > [Revert to] を選択します。すると、[Revert to] ダイアログが開き、そのファイルの全変更履歴が表示されます。いずれかのバージョンを選択し、[OK] をクリックすると、そのバージョンが復元されます。

5.20.2 リビジョン ( ソース / バージョン ) 管理システム

各種のリビジョン管理システム (RCS) を MPLAB IX DE と組み合わせて使う事ができます。一度設定すると、リビジョン管理操作はコンテクストメニューからアクセスできます。

5.20.2.1 対応システム

現在サポートしているソース / バージョン管理システムは以下の通りです。

• Git – http://git-scm.com/• Subversion – http://subversion.tigris.org/• Mercurial – http://mercurial.selenic.com/

5.20.2.2 リビジョン管理システムの使用

ソース / バージョン管理の使い方

1. [Team] メニューからバージョン管理プログラムのサブメニューを選択し、そのバージョン管理プログラムを設定する。

2. [Tools] > [Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択して[Options] ウィンドウを開き、[Miscellaneous] アイコンをクリックし、[Versioning] タブを開いてバージョン管理機能を設定する。

3. [Window] > [Versioning] を選択して [Version Control] ウィンドウを開く。

Note: この機能については、[Start Page] の [My MPLAB X IDE] タブを開き、[Extend MPLAB] セクションの「Selecting Simple or Full-Featured Menus」トピックを参照してください。


http://git-scm.com/

http://subversion.tigris.org/

http://mercurial.selenic.com/

追加作業

図 5-15: バージョン管理のオプション

5.20.2.3 リビジョン管理されたファイルの競合の解消

チェックインしようとするファイルと、リビジョンシステムのリポジトリ内の他の人が変更した同じファイルとの間に競合が発生する場合があります。これらの問題の解決方法は以下の例を参照してください。

例 5-1: CONFIGURATIONS.XML の競合

configurations.xmlファイルの競合の解消方法

1. 競合は以下によって通知されます。

a) 警告ダイアログ

b) [Output] ウィンドウ

2. [Projects] ウィンドウの [Files] タブをクリックし、nbprojectフォルダを展開する。configurations.xml という名前のファイルを見つける ( 競合を示す赤いフォントで表示 )。

3. configurations.xmlを右クリックして [RCS] > [Resolve Conflicts] (RCS はリビジョン管理システム ) を選択すると、[Merge Conflicts Resolver] ウィンドウが開く。

4. [Merge Conflicts Resolver] ウィンドウを使って競合を解消する。詳細は NetBeansヘルプトピック ([IDE Basics] > [Using the IDE Help System] > [VersioningApplications with Version Control]) を参照してください。



5. エラーが解決したらプロジェクトを閉じる。右クリックのコンテクストメニューが動作しない場合、[File] > [Close Project] を使ってプロジェクトを閉じる。

6. 再度プロジェクトを開く ( 競合は解消済みのはずです )。

5.20.2.4 保存するプロジェクトファイル

リポジトリに保存する必要があるプロジェクトファイル

下表に、プロジェクトファイルをバージョン管理リポジトリにコミットする必要があるかどうかを示します。

プロジェクトの構成の詳細はセクション 8.3「[Files] ウィンドウの表示」を参照してください。

ローカルファイルの履歴およびソース管理機能の詳細は NetBeans ヘルプトピック([IDE Basics] > [Using the IDE Help System] > [Versioning Applications with VersionControl]) を参照してください。

5.20.2.5 読み出し専用ファイルを使ったプロジェクトのビルド

ファイルがリポジトリにチェックイン済みであり、一部のファイルが読み出し専用である場合、プロジェクトをビルドするには以下の手順で行います。

1. 小限のファイルをソース管理にコミットする ( セクション 5.20.2.4「保存するプロジェクトファイル」参照 )。

2. ファイル nbproject/configurations.xmlおよびnbproject/project.xmlを書き込み可能にする。

表 5-8: リポジトリに保存するプロジェクトファイル

フォルダまたはファイルコミットの要否

プロジェクトフォルダ

makeファイル (Makefile)

ソースファイル

build フォルダ

dist フォルダ

nbproject フォルダ

configurations.xml

project.properties

project.xml

Makefile-*

Package-*

private フォルダ

緑のチェック : プロジェクトのイメージを生成する必要があります。赤の X 印 : これらのフォルダ / ファイルは再生成されるため保存する必要はありません。


追加作業

5.21 コード開発とエラー追跡の連携

MPLAB X IDE は、チームサーバ (Kenai.com 等 ) によるグループ間で連携したコード開発をサポートします。

サポートするメニュー項目は以下の通りです。

• [Team] – チームサーバのメインメニューです ( アカウントへのログイン、プロジェクトの作成または読み込み、プロジェクトの共有、リソースの取得、チャットメッセージの送信、コンタクトリストの表示 )。

• [File] > [Open Team Project] – 既存のチームプロジェクトを開きます。

問題追跡システム (Bugzilla™ と JIRA®、要プラグイン ) を使って、バグ追跡で連携します。これに関しては、以下のメニュー項目をサポートします。

• [Windows] > [Services] – [Issue Tracker] を右クリックし、問題トラッカーを追加します。

• [Team] > [Find Issues] – [Issue Tracker] ウィンドウ内で、プロジェクトで使う問題トラッカーと評価基準を選択し、[Search] をクリックします。

• [Team] > [Report Issues] – [Issue Tracker] ウィンドウで問題トラッカーを選択し、問題の詳細を指定し、[Submit] をクリックします。

チームプロジェクトと問題追跡の詳細は NetBeans ヘルプトピック ([IDE Basics] >[Using the IDE Help System] > [Working in a Collaborative Environment]) を参照してください。

これらのツールの詳細は以下を参照してください。

• Kenai – http://kenai.com/• Bugzilla – http://www.bugzilla.org/• JIRA – http://www.atlassian.com/software/jira/

Note: この機能については、[Start Page] の [My MPLAB X IDE] タブを開き、[Extend MPLAB] セクションの [Selecting Simple or Full-Featured Menus]トピックを参照してください。


http://kenai.com/

http://www.bugzilla.org/

http://www.atlassian.com/software/jira/


5.22 プラグインツールの追加

DMCI 等の MPLAB X IDE のプラグインツールは、IDE のプラグインマネージャとEmbedded Code Source ウェブサイトのどちらからでも追加できます。

• デバイスマネージャからのプラグインの追加

• 組み込みコード集からのプラグインの追加

• プラグインの更新

• 更新センターの設定

• プラグインコードの格納場所

5.22.1 デバイスマネージャからのプラグインの追加

利用可能なプラグインを表示およびインストールする方法

1. MPLAB X IDEで[Tools] > [Plugins]を選択し、[Available Plugins]タブをクリックする。

2. 追加したいプラグインにチェックを入れ、[Install] をクリックする ( 図 5-16)。3. 画面の指示に従って、プラグインをダウンロードおよびインストールする。

4. インストール後、プラグインは [Installed] タブに表示される ( このプラグインに対して無効にする、再度有効にする、アンインストールする、のいずれかの操作を実行できます )。

5. [Tools] > [Embedded] を選択して、追加したツールを確認する ( 追加したツールが表示されない場合、MPLAB X IDE を一度終了してから再起動すると表示される場合があります )。

[Help] ボタンをクリックすると、プラグインのインストールに関するヘルプを表示できます。

図 5-16: 利用可能な Microchip 社製プラグインツール

Note: プラグインによっては、インストールされる機能が他のプラグイン内のモジュールに依存するものがあります。そのような場合、プラグインマネージャは警告を表示します。


追加作業

5.22.2 組み込みコード集からのプラグインの追加

利用可能なプラグインを表示、ダウンロード、インストールする方法

1. Embedded Code Source ウェブサイトhttp://www.embeddedcodesource.com/category/mplab-x-plugins を開く。

2. プラグインを選択し、ウェブページの指示に従ってローカルフォルダにダウンロードする。

3. ダウンロードした ZIP ファイルを解凍して .nbmファイルを復元する。

4. MPLAB X IDEで [Tools] > [Plugins]を選択し、[Downloaded]タブをクリックする。

5. [Add Plugins] をクリックする。.nbmファイルを選択し、[Open] をクリックして開く ( 図 5-17)。

6. プラグイン名の隣のチェックボックスがチェックされている事を確認し、[Install] をクリックしてプラグインをインストールする ( 図 5-18)。

7. 画面の指示に従って、プラグインをダウンロードおよびインストールする。

8. インストール後、プラグインは [Installed] タブに表示される ( このプラグインに対して無効にする、再度有効にする、アンインストールする、のいずれかの操作を実行できます )。

9. [Tools] > [Embedded] を選択して、追加したツールを確認する追加したツールが表示されない場合、MPLAB X IDE を一度終了してから再起動すると表示されます。

図 5-17: ダウンロード済みの Microchip 社製プラグインツール

Note: プラグインによっては、インストールされる機能が他のプラグイン内のモジュールに依存するものがあります。そのような場合、プラグインマネージャが警告を表示します。


http://www.embeddedcodesource.com/category/mplab-x-plugins


図 5-18: ダウンロード済み Microchip 社製プラグインツールのインストール

5.22.3 プラグインの更新

使用中のプラグインに更新版が存在するかどうかを判断する方法

1. MPLAB X IDE で [Tools] > [Plugins] を選択し、[Updates] タブをクリックする。

2. [Check for Updates] をクリックする。

3. 更新版が表示される場合、プラグイン名がチェックされている事を確認し、[Update] をクリックする。

4. 画面の指示に従って、プラグインを更新する。

MPLAB X IDE の新バージョンをインストールしても、インストール済みのプラグインは更新されません。プラグインは、そのリリースに付けられたバージョンのインターフェイスでテストされています。全てのプラグインがバージョン間で移行可能とは限らず、そのまま流用される事はありません。これは NetBeans に対してもあてはまります。従って、新しいバージョンの MPLAB X IDE をインストールした場合、プラグインの再インストールが必要な場合があります。


追加作業

5.22.4 更新センターの設定

[Plugins] ウィンドウに利用可能なプラグインを表示させるには、更新センターを設定する必要があります。MPLAB X IDE には 2 つの Microchip 更新センターがあらかじめ設定されています。

• http://ww1.microchip.com/downloads/mplab/X/plugins/updates.xml• http://ww1.microchip.com/downloads/mplab/X/thirdpartyplugins/updates.xml

プラグインマネージャで別の更新センターを設定する方法

1. [Tools] > [Plugins] を選択し、[Settings] タブをクリックする。

2. [Add] ボタンをクリックして、[Update Center Customizer] ダイアログを開く。

3. 更新センターの名前を入力する。

4. 更新センターの URL を入力する。

5. [OK] をクリックする。

図 5-19: Microchip 更新センターの設定

5.22.5 プラグインコードの格納場所

プラグインコードは MPLAB X IDE のユーザコンフィグレーションデータと一緒に保存されています。セクション 8.7「ユーザコンフィグレーションデータの表示」を参照してください。


http://ww1.microchip.com/downloads/mplab/X/plugins/updates.xml

http://ww1.microchip.com/downloads/mplab/X/thirdpartyplugins/updates.xml


NOTE:


MPLAB® X IDE
ユーザガイド
第 6 章高度な作業とコンセプト

6.1 はじめに

本章では、MPLAB X IDE の高度な作業を解説します。これ以外の作業に関する説明は、第 4 章「基本作業」と第 5 章「追加作業」に記載しています。

作業

• MPLAB X IDE の高速化

• 複数プロジェクトを使った作業

• 複数コンフィグレーションを使った作業

• ユーザ Makefile プロジェクトの作成

• MPLAB X IDE プロジェクトのパッケージ化

• サードパーティ製ハードウェアツール

• ログデータ

• ツールバーのカスタマイズ

コンセプト

• チェックサム

• コンフィグレーション

6.2 MPLAB X IDE の高速化

MPLAB X IDE の動作が遅過ぎる場合、以下を考慮します。

• PC のヒープの増加

• デバッグツールの使用

6.2.1 PC のヒープの増加

mplab_ide.confファイルを編集すると、MPLAB X IDE に割り当てられているメモリ容量を変更できます。このファイルは、編集する前にバックアップしておく事を推奨します。このファイルの内容を変更する場合、その変更は次回 MPLAB X IDE を起動した時に有効になります。

Windows OS (64 ビット )C:\Program Files (x86)\Microchip\MPLABX\vx.xx\mplab_ide\etcWindows OS (32 ビット )C:\Program Files\Microchip\MPLABX\vx.xx\mplab_ide\etcLinux OS/opt/microchip/mplabx/vx.xx/mplab_ide/etcMac OS X/Applications/microchip/mplabx/vx.xx/Contents/Resources/mplab_ide/etc

(vx.xxは MPLAB X IDE のバージョンです。)



以下の行は既定値を収めています。

default_options="-J-Dnb.FileChooser.useShellFolders=false -J-Dcrownking.stream.verbosity=very-quiet -J-Xms256m -J-Xmx512m -J-XX:PermSize=128m -J-XX:MaxPermSize=384m -J-XX:+UseConcMarkSweepGC -J-XX:+CMSClassUnloadingEnabled"太字の部分は以下の通りです。

-Xms256m: JVM が、256 MB 以上のヒープを割り当てる事を意味します。

-Xmx512m: JVM が、512 MB 以下のヒープを割り当てる事を意味します。

-XX:PermSize=128m: JVM が、ヒープに収まらないデータの追加に必要な空間として 128 MB を割り当てる事を意味します。

-XX:MaxPermSize=384m: JVM が、ヒープに収まらないデータの追加に必要な空間として 384 MB 未満を割り当てる事を意味します。

以下のエラーが発生しない限り、PermSize または MaxPermSize を変更する必要はありません。java.lang.OutOfMemoryError: PermGen space

も重要な部分は -Xmx512mです。この値は MPLAB X IDE が使うヒープ量の大値を指定しています。一見、大きなヒープ量を設定した方が良いように見えるかもしれません。しかし、MPLAB X IDE にメモリを使う事は他のアプリケーションとシステム機能に使うメモリが少なくなる事を意味しています。

メモリモニタを有効にすると、IDE が使うメモリの量を監視できます。ツールバー領域の空いた所を右クリックして [Memory] を選択します。または、[View] > [Toolbars] >[Memory] を選択します。

mplab_ide.confの値を変えない限り、上限値は 512 MB です。 -Xmx512mの設定は128 MB 刻みで変更する事を推奨します。大容量のメモリを使える場合、128 MB を超える刻みで増やす事もできます。しかし、システムの他の部分のために十分なメモリが残っている事を確認してください。

6.2.2 デバッグツールの使用

デバッグツールを使うと MPLAB X IDE が遅くなる場合、以下を試します。

• 必要なウィンドウのみを表示させる (MPLAB X IDE デバッガは、デバッグツールの使用中、開いているウィンドウを全て監視するためです )。

• デバッグのステップ実行中の [Stack] ウィンドウの更新頻度を低くする。[Tools] >[Options] ウィンドウの [Embedded] ボタンをクリックし、[Generic Settings] タブの [Disable auto refresh for call stack view during debug sessions] と [On mouse-overstructure and array expressions, evaluate integral members only] にチェックを入れる。


高度な作業とコンセプト

6.3 複数プロジェクトを使った作業

MPLAB X IDE では、複数のプロジェクトを開いて作業できます。

MPLAB X IDE で複数のプロジェクトを開いて [Projects] ウィンドウに表示できます。このウィンドウの詳細は本書のセクション 12.13「[Projects] ウィンドウ」を参照してください。

図 6-1: [Projects] ウィンドウに表示した複数のプロジェクト

アクティブなプロジェクト

[Projects] ウィンドウ内でいずれかのプロジェクトをクリックすると、そのプロジェクトがアクティブになります。

アクティブなプロジェクトを設定しないで作業する事もできます。その場合 IDE は、作業中のプロジェクトをコンテクストで判断します。すなわち、あるファイルにフォーカスするようにエディタを設定すると、そのファイルを含むプロジェクトが操作を受けるプロジェクトになります ( 例 : [Debug Run] ボタン押下時 )。メインプロジェクト

以下のどちらかの方法により、1つのプロジェクトをメインプロジェクトにできます。

• プロジェクト名を右クリックし、[Set as Main Project] を選択する

• [Run] > [Set Main Project] を選択する

メインプロジェクトの名前は太字で表示されます。

あるプロジェクトを明示的にメインプロジェクトに指定するか、エディタのフォーカスを使ってメインプロジェクトを選択するかはユーザが選択できます。

メインプロジェクトの設定を解除する場合、以下を実行します。

1. [Projects] 画面の空いた場所で右クリックする。

2. [Set as Main Project] を使ってアクティブなプロジェクトを変更する。または、アクティブなプロジェクトの設定を解除する。



複数プロジェクトを使った作業

1. 2 つまたは 3 つのプロジェクトを作成 ([File] > [New Project]) または開く ([File] >[Open Project])。

2. 各プロジェクトのデバッグを開始する ([Projects] ウィンドウ内のプロジェクトをクリックし、[Degug] > [Debug Project] を選択する )。

3. [Sessions] ウィンドウを開くと ([Window] > [Debugging] > [Sessions])、現在実行中のデバッグセッション間で切り換える事ができる。

デバッグセッションを切り換えると、[Watches] ウィンドウ、変数、メモリ表示が現在選択しているデバッグ中のプロジェクトのものに切り換わります。ステータスビットも現在のプロジェクトのものに切り換わります。ダッシュボードは、デバッグプロジェクトまたは [Projects] ウィンドウ内のプロジェクトのどちらであれ、後に選択したプロジェクトの内容を表示します。これは設計仕様に基づいた動作です。

複数プロジェクトのグループ化

複数プロジェクトを使うもう 1 つの方法はグループ化です。[File] > [Project Group] を選択し、プロジェクトグループを選択するか新規に作成します。

プロジェクトグループの作成の詳細は NetBeans ヘルプトピックの「Project Group:Create New Group Dialog Box」を参照してください。



6.4 複数コンフィグレーションを使った作業

MPLAB X IDE では、同一プロジェクトで複数のビルドコンフィグレーションを使えます。これは、複数のプラットフォームでコンパイル可能なコード (Microchip 社のアプリケーションライブラリデモプロジェクト等 ) にとって便利です。

新規プロジェクトを作成すると、「default」という名前のコンフィグレーションが作成されます。ユーザコンフィグレーションの作成は、以下のどちらかの手順で始めます。

• ツールバーのドロップダウンメニュー(図6-2)から[Customize]を選択して、[ProjectProperties] ダイアログを開く

• プロジェクト名を右クリックして [Properties] を選択し、[Project Properties] ダイアログを開く

図 6-2: [Project Configuration] ドロップダウンボックス

[Project Properties] ダイアログで [Manage Configurations] をクリックして、[Configurations] ダイアログを開きます。このダイアログでは、既存のコンフィグレーションの名前を変更するか、新規コンフィグレーションを追加するか、既存のコンフィグレーションを複製できます。

1 つのプロジェクトに対して複数のコンフィグレーションを作成した場合、[ManageConfigurations] ボタンまたはドロップダウンメニューを使って、いずれか 1 つのコンフィグレーションをアクティブにします。

図 6-3: [Project Properties] – [Configurations] ダイアログ



6.4.1 新規コンフィグレーションの追加

新規コンフィグレーションを追加した場合、複数の項目を [Project Properties] ダイアログで割り当てる必要があります。

• デバイス – ハードウェアツールとコンパイラのサポートを確認するため、これを初に選択する必要があります。

• ハードウェアツール

• コンパイラツールチェーン

図 6-4: 新規コンフィグレーション



6.4.2 複製したコンフィグレーションの追加

既存のコンフィグレーションの複製を追加し、これを編集して使う事ができます。

複製コンフィグレーションを作成する理由の 1 つは、デバッグ用コンフィグレーションを作成するためです。MPLAB X IDE は Microchip 社製ツールと組み合わせて使うデバッグ用マクロ ( セクション 4.17.2「デバッグ用マクロの生成」) を提供しています。しかし、専用のコンフィグレーションを作成する事で、ユーザ独自のデバッグ用マクロを使えるようになります。またはサードパーティのツールで同じデバッグ機能を使えるようになります。

デバッグコンフィグレーションの設定方法

1. [Configuration] ダイアログで、プロジェクトコンフィグレーションを選択して[Duplicate] をクリックする。

2. [Rename] をクリックし、[New Configuration Name] ダイアログで名前 ( 例 :「MyDebug」) を入力する。

3. [OK] を 2 回クリックして [Project Properties] ダイアログに戻る (「MyDebug」コンフィグレーション (Conf: MyDebug) が表示されるようになる )。

4. ツールチェーン内のコンパイラをクリックする。[Preprocessing and messages]オプションカテゴリで、マクロを定義できるオプションを選択し、関連するテキストボックスをクリックする。

5. ポップアップダイアログでマクロ名 ( 例 : __MyDebug) を入力し、[OK] をクリックする。

以上により、デバッグする際に「MyDebug」コンフィグレーションに切り換える事ができるようになります。プロセッサマクロは、以下のコンディショナルテキスト内で使えます。

#ifdef __MyDebug fprintf(stderr,"This is a debugging message\n");#endif

図 6-5: デバッグコンフィグレーション



6.5 ユーザ Makefile プロジェクトの作成

外部 makefile を使うプロジェクを作成します。これは、プロジェクトが MPLAB X IDE の外にビルドされているが、MPLAB X IDE を使ってデバッグを実行する場合に便利です。

makefile プロジェクトを作成するには、[New Project] ウィザードを使います。

6.5.1 新規プロジェクトの設定




• Step 1. Choose Project: [Microchip Embedded] カテゴリを選択し、プロジェクトタイプ [User Makefile Project] からプロジェクトを選択します。

• Step 2. Select Device: プロジェクトで使うデバイスを [Device] ドロップダウンリストから選択します。選択肢を絞り込むために、初にデバイスファミリを選択します。

• Step 3. Select Header: このステップは、選択したデバイスでヘッダが利用可能である場合に表示されます。デバイスがヘッダを必要とするか、またはデバッグ回路を内蔵しているかどうかは、『Processor Extension Pak (PEP) およびデバッグヘッダ仕様』(DS51292)(DS51292U_JP)、『エミュレーション拡張パック (EEP)およびエミュレーションヘッダユーザガイド』(DS50002243) で確認できます。上記を確認してからヘッダを使うかどうかを選択します。

• Step 4. Select Tool: アプリケーションの開発に使う開発ツールをリストから選択します。選択したデバイスに対するツールのサポートレベルが、ツール名の横のマークで色分け表示されます。緑は完全サポート、黄はベータサポート、赤は未サポートを意味します。

• Step 5. Select Plugin Board: このステップは、選択したデバイスでプラグインボードが利用可能である場合に表示されます。[Supported Plugin Board] のドロップダウンリストで利用可能なプラグインボードを調べます。

• Step 6. Select Project Name and Folder: 新規プロジェクトの名前と格納場所を選択します。

• Step 7. Create User Makefile Project: データを入力して makefile プロジェクトを設定します。

表 6-1: [Select Project Name and Folder] の設定項目

項目説明

Project Name プロジェクトの名前を指定します。Project Location プロジェクトの格納場所を入力または参照します。Project Folder プロジェクト名とプロジェクトの格納場所に基づいて、プロジェクトフォルダの格納場所を

表示します。プロジェクトフォルダと作業フォルダの関係はセクション 6.5.2「ユーザ Makefile プロジェクトフォルダおよび作業フォルダ」を参照してください。

Set as main project 作成されるプロジェクトをメインプロジェクトに設定します。既定値でチェックが入っています。

Use project location as project folder

プロジェクトの格納場所と同じフォルダ内にプロジェクトを作成します。これは、MPLAB IDE v8 プロジェクトをインポートする際、MPLAB X IDE のプロジェクトを同じフォルダにする場合 ( ビルドも同様にする場合 ) に便利です。MPLAB IDE v8 が .mcp ファイルを使ってプロジェクト情報を保存するのに対し、MPLAB XIDE はフォルダを使います。従って、MPLAB IDE v8 プロジェクト (.mcp ファイル ) とフォルダを共有させる事ができる MPLAB X IDE プロジェクトは 1 つだけです。

エンコード既定値で ISO-8859-1 に設定されます。通常これを変更する必要はありません。



作成したプロジェクトが [Projects] ウィンドウ内に表示されます。プロジェクト作成後、[Project Properties] ウィンドウの [Makefile] カテゴリで Makefile プロジェクトの設定を変更します。

プロジェクトを HEX ファイルとしてエクスポートする方法はセクション 12.13.2「[Projects] ウィンドウ –[Project] メニュー」を参照してください。

表 6-2: [Create User Makefile Project] の設定項目

項目説明

Working Directory 外部プロジェクトの格納場所を指定します。これは各種コマンド ( ビルド、デバッグビルド、クリーン ) が実行される既定値の格納場所です。

プロジェクトフォルダと作業フォルダの関係はセクション 6.5.2「ユーザ Makefile プロジェクトフォルダおよび作業フォルダ」を参照してください。このフォルダはユーザに代わってフォーマットの問題を処理するため、[Browse...] クリック時のフォルダを参照する事を推奨します。

Build command MPLAB X IDE( アイコンまたはメニュー) で [Run] コマンドが要求された場合、代わりにこのコマンドに従ってビルドを実行します。

ビルドパス *: Windows の場合、引用符を使います。Linux または Mac OS の場合、スペースはエスケープする必要があります。

Debug build command MPLAB X IDE( アイコンまたはメニュー ) で [Debug Run] コマンドが要求された場合、代わりにこのコマンドに従ってデバッグビルドを実行します。

デバッグビルドパス *: Windows の場合、引用符を使います。Linux または Mac OS の場合、スペースはエスケープする必要があります。セクション B.2「MPLAB X IDE 外部でのデバッグのためのコンパイル」も参照してください。

Clean command MPLAB X IDE( アイコンまたはメニュー ) で [Clean] コマンドが要求された場合、代わりにこのコマンドに従ってクリーンを実行します。

クリーンパス *: Windows の場合、引用符を使います。Linux または Mac Os の場合、スペースは全てエスケープする必要があります。

Image name 量産イメージファイル (HEX) のパスと名前を入力します。

イメージパス *: スペースは全てエスケープする必要があります。

Debug image name デバッグイメージファイル (elf または cof) のパスと名前を入力します。

デバッグイメージパス *: スペースは全てエスケープする必要があります。

User Include Paths インクルードファイルを入力 * または参照します。

User Macros マクロを追加または「解析および追加」します。

[Edit]: マクロ名を入力します。またはマクロを含むファイルを参照します。

[Parse]: マクロを自動的に解析します (MPLAB XC コンパイラのみ )。ダイアログの指示に従います。完了後、表示されている現在のマクロを選択して置換します。または、現在のマクロの一覧に付け加えます。

* 一般的なデータ入力の方法 :パスにはフォワードスラッシュ「/」を推奨します。しかし、代わりにバックワードスラッシュ「\」も使えます。パスとファイル名にスペースを使わない事を推奨します。しかし、このウィンドウでパスおよびファイル名を入力する際にどうしてもスペースを使わなくてはいけない場合、エスケープスペース ( スペースの前にバックスラッシュ ) を使います。スペースは GNU Make の区切り文字であるため、スペースを使うと GNU Make は問題を引き起こす事が分かっています。



6.5.2 ユーザ Makefile プロジェクトフォルダおよび作業フォルダ

プロジェクトフォルダは、Makefile と nbproject/Makefiles を格納しています。MPLAB X IDE はプロジェクトフォルダ内で makefile を実行します。次に、作業フォルダに移動し、「Build command」または「Debug build command」を実行します。これにより GNU Make が実行され、「Build command」として指定した処理が実行されます。

プロジェクトフォルダは、絶対パスで格納場所を定義する場合、作業フォルダに対してどこにでも配置できます。しかし、この方法を使うとプロジェクトの移植性が損なわれます。プロジェクトを移植しやすくするには、作業フォルダはプロジェクトフォルダに対して相対パス ( 例 : プロジェクトフォルダの 1 レベル下 ) で指定します。

6.5.3 Makefile プロジェクトの例

この例では、MPLAB X IDE でユーザ makefile プロジェクトを作成する方法を示します。この makefile プロジェクトは、バッチファイルと IDE 外で作成したユーザコード上の make のどちらかを実行します。このユーザコードは、1 つのファイル (t.c) から成ります。このファイルに格納されているシンプルなコードを以下に示します。

例 6-1: t.c のコード

#include <xc.h>

int main(void) { while(1) { } return 0;}

本コードは、量産向けには t_production.hex にリンクし、デバッグ向けにはt_debug.elfにリンクします。

この例では、t.c、バッチファイル (makeme.bat)、ユーザ makefile (Makefile) は以下のフォルダ (Windows OS の場合 ) に格納されていると仮定します。

C:\Users\MCHP\MPLABXProjects\makestuff\myOwnCodeWithItsOwnMakefile使用中の PC 上でこの例を再現する場合、MCHPをユーザのユーザ名で置き換えます。

• [User Makefile Project] – バッチファイルからコードを作成

• [User Makefile Project] – ユーザ Makefile からコードを作成

• [User Makefile Project] – 完了



6.5.3.1 [User Makefile Project] – バッチファイルからコードを作成

コードをコンパイルするため、シンプルなバッチファイル (makeme.bat) は引数としてproduction, debug, cleanのいずれかを取ります。productionが引数として渡された場合、t_production.hexがビルドされます。debugが引数として渡された場合、t_debug.elfがビルドされます。cleanが引数として渡された場合、.elfと .hexファイルが消去されます。

例 6-2: makeme.bat のコード

::assumes xc32-gcc and xc32-bin2hex are on the pathrem @echo offset COMPILER=xc32-gccset BIN2HEX=xc32-bin2hexset PROCESSOR=32MX360F512L

if "%1" == "production" goto production

if "%1" == "clean" goto clean

:debug%COMPILER% -mprocessor=%PROCESSOR% -g -D_DEBUG -o t_debug.elf t.cgoto end

:production%COMPILER% -mprocessor=%PROCESSOR% -o t_production.elf t.c%BIN2HEX% t_production.elfgoto end

:cleandel /F *.elfdel /F *.hexgoto end

:end



MPLAB X IDE 内でユーザ makefile プロジェクトを作成するには、セクション 6.5.1「新規プロジェクトの設定」の手順を実行します。

• Step 1. Choose Project: [Microchip Embedded]、[User Makefile Project] を選択します。

• Step 2. Select Device: デバイスとして PIC32MX360F512L を選択します。

• Step 3. Select Header: このデバイスに利用できるヘッダはありません。

• Step 4. Select Tool: SN でハードウェアツールまたは [Simulator] を選択します。この例では「Simulator」を使います。

• Step 5. Select Plugin Board: この例で使うヘッダはありません。

• Step 6. Select Project Name and Folder: この例では「Project Folder」はmyOwnCodeWithItsOwnMakefile と同じフォルダの中に作成します。従って、

「Project Location」は C:\Users\MCHP\MPLABXProjects\makestuff とし、「Project Name」は MPLABXProjectTとします。

図 6-6: [User Makefile Project] – プロジェクト名とフォルダの選択



• Step 7. Create User Makefile Project: 情報を入力して makefile プロジェクトを設定します。

作業フォルダでは、各種コマンド ( バッチファイルのビルド、デバッグビルド、クリーン ) が実行されます。このフォルダは絶対パスとして設定できます。C:\Users\MCHP\MPLABXProjects\makestuff\myOwnCodeWithItsOwnMakefile.しかし、この方法を使うと MPLAB X IDE プロジェクトの移植性が損なわれます。従って、作業フォルダ、イメージ名、デバッグイメージ名は相対パス (MPLAB XIDE プロジェクトフォルダ基準 ) で入力します。

[Finish] をクリックするとプロジェクトが作成されます。

図 6-7: [User Makefile Project] – バッチファイルからコードを作成



6.5.3.2 [User Makefile Project] – ユーザ Makefile からコードを作成

コードをコンパイルするため、シンプルなユーザ makefile (Makefile) は引数としてproduction, debug, cleanのいずれかを取ります。productionが引数として渡された場合、t_production.hex がビルドされます。debug が引数として渡された場合、t_debug.elfがビルドされます。cleanが引数として渡された場合、.elfと .hexファイルが消去されます。

例 6-3: ユーザ Makefile のコード

# Assumes xc32gcc and xc32bin2hex are on the pathCOMPILER=xc32gccBIN2HEX=xc32bin2hexPROCESSOR=32MX795F512L

production: t_production.hexdebug: t_debug.elf

t_debug.elf: t.c$(COMPILER) mprocessor=$(PROCESSOR) -g -D_DEBUG -o t_debug.elf

t.c

t_production.hex: t_production.elf$(BIN2HEX) t_production.elf

t_production.elf: t.c$(COMPILER) mprocessor=$(PROCESSOR) o t_production.elf t.c

clean:del /F *.hexdel /F *.elf

MPLAB X IDE 内でユーザ makefile プロジェクトを作成するには、セクション 6.5.3.1「[User Makefile Project] – バッチファイルからコードを作成」の手順 1 ～ 6 を実行します。Step 7 は図 6-8 に従って設定します。

作業フォルダでは、各種コマンド ( ユーザ Makefile のビルド、デバッグビルド、クリーン ) が実行されます。作業フォルダ、イメージ名、デバッグイメージ名は相対パス (MPLAB X IDE プロジェクトフォルダ基準 ) で入力します。

MPLAB X IDE はビルド、デバッグビルド、クリーンに GNU Make を使います。セクション 6.5.2「ユーザ Makefile プロジェクトフォルダおよび作業フォルダ」に従って、MPLAB X IDE はプロジェクトフォルダ内で Makefile を実行すると、作業フォルダがカレントフォルダになります。作業フォルダ内で make は makefile を検索し、ユーザ定義の Makefile を見つけます。この Makefile はビルド、デバッグビルド、クリーンの方法を定義します。

[Finish] をクリックするとプロジェクトが作成されます。

Note: 「Build command」等のコマンドを定義するもう 1 つの方法は、-f オプションを使ってユーザ makefile を指定する事です( 例 : make -f Makefile production)。



図 6-8: [User Makefile Project] – ユーザ Makefile からコードを作成

6.5.3.3 [User Makefile Project] – 完了

プロジェクト作成後、[Projects] ウィンドウに以下が表示されます。プロジェクト名を右クリックしてプロジェクトをビルドできます。

図 6-9: [User Makefile Project] – プロジェクトツリー

設定を変更する場合、プロジェクト名を右クリックして [Properties] を選択します。



図 6-10: [User Makefile Project] – [Project Properties] ダイアログ

この例では、ビルドの結果 (t_production.hex) とデバッグビルドの結果(t_debug.elf)は作業フォルダmyOwnCodeWithItsOwnMakefileに格納されています。MPLAB X IDE では MPLABXProjectTプロジェクトフォルダのみが表示されるため、ビルド後の IDE の [Projects] ウィンドウでは変化が見られません。

6.6 MPLAB X IDE プロジェクトのパッケージ化

プロジェクトを右クリックして [Package] を選択し、プロジェクトを zip ファイル(.zip) にパッケージします。MPLAB X IDE はファイルを ZIP に圧縮できますが、解凍する事はできません。従って、プロジェクトの解凍には別のプログラムが必要です。

この機能は、プロジェクトをパッケージする際にプロジェクトファイルを解析し、パッケージに含めるべきプロジェクトファイルのフォルダを決定します。すなわち、プロジェクトフォルダと、その相対パス ( 絶対パスではない ) を使うフォルダ内のファイルだけをパッケージに含めます。

パッケージにはソースファイル、makefile、「nbproject」フォルダが含まれます。

ヘッダファイルは、プロジェクトに追加していない限り含まれません。従って、ユーザ作成のヘッダファイルが必要な場合、解凍済みのプロジェクトはビルドできません。



6.7 サードパーティ製ハードウェアツール

サードパーティ製ハードウェアツールを使う場合、以下の要件があります。

• 必要なする USB ドライバを入手しインストールします。USB ドライバとインストール説明書は、通常サードパーティから入手できます。

• このツールの MPLAB X IDE プラグインをインストールします。詳細はセクション5.22「プラグインツールの追加」を参照してください。

インストールが完了すると、[Project Properties] ダイアログにハードウェアツールが表示され選択できるようになります ( セクション 4.4「プロジェクトプロパティの表示と変更」参照 )。

6.8 ログデータ

ログファイルは、プログラム実行状況の把握と問題の解決に役立ちます。

MPLAB X IDE に問題やエラーが発生して技術サポートに問い合わせる場合 (「お客様サポート」参照 )、2 つのログファイル (MPLAB X IDE のログファイルと NetBeansプラットフォームのログファイル ) のデータを保存する必要があります。

6.8.1 MPLAB® X IDE のログファイル

MPLAB X IDE のログファイル機能は、Java Logger クラスに基づいてデータを生成します。

ログファイルの設定方法

1. [Tools] > [Options] (Mac OS X では [mplab_ide] > [Preferences]) を選択して[Embedded] ボタンをクリックし、[Diagnostics] タブを開く。

2. ドロップダウンボックスからログレベルを選択する ( セクション 12.14.6「[Diagnostics] タブ」参照 )。

3. ログファイルの格納場所 ( パス ) を選択する。

データを記録する方法

1. ログレベル「Finest」を設定する。

2. ログファイルの名前とパスをメモする。

3. 問題やエラーが発生するまでステップを繰り返す。

4. 生成されたログファイルを技術サポートに送信する。

6.8.2 NetBeans プラットフォームのログファイル

NetBeans のログファイル機能は、NetBeans プラットフォームの実行に関する情報を生成します。

データをログに記録する方法

5. [View] > [IDE Log] を選択して [Output] ウィンドウにログファイルを開く。

6. [Output] ウィンドウを右クリックして [Clear] を選択する。

7. 問題やエラーが発生するまでステップを繰り返す。

8. ウィンドウを右クリックし、[Save As] を選択してテキストをファイルに保存する。

9. 保存したファイルを技術サポートに送信する。

Note: ログレベルが高いほど収集データは増えますが、アプリケーション実行速度は低下します。



6.9 ツールバーのカスタマイズ

[Customize Toolbars]ウィンドウを使うとMPLAB X IDEのツールバーをカスタマイズできます。このウィンドウは、[View] > [Toolbars] > [Customize] で開きます。

[Clean Only]、[Run]、[Set PC to Cursor] 等のアイコンを使えます。

ツールバーに機能を追加する方法

[Customize Toolbars] ウィンドウからツールバーにアイコンをドラッグする。

ツールバーから機能を削除する方法

ツールバーから [Customize Toolbars] ウィンドウにアイコンをドラッグする。

独自のツールバーを追加する方法

[New Toolbar] をクリックして、新規ツールバーに名前を付ける。

ツールバーアイコンのサイズを変更する方法

• アイコンを小さくするには、[Small Toolbar Icons] にチェックを入れる。

• アイコンを大きくするには、チェックを外す。

既定値のツールバーに戻す方法

[Reset Toolbars] をクリックする。

下表に、使用可能な機能を示します。

表 6-3: 「Build」機能

機能説明

Make クリーンせずに make を実行します ( プロジェクトファイルが更新されている場合、ビルドします )。

Make Clean プロジェクトに対してクリーン ( 以前にビルドしたプロジェクトファイルの削除 ) を実行してから make を実行します。

表 6-4: 「Debug」機能

機能説明

New Data Breakpoint 新しいデータブレークポイントを設定します。

New Run Time Watch 指定したシンボルを、プログラム実行中に値の変化を観察するウォッチに追加します。

New Watch [Watches] ウィンドウで観察するために式を入力するか、SFR を選択します。

PIC AppIO [PIC AppIO] ウィンドウを開きます。デバッグツールとデバイスがアプリケーション I/O をサポートしている必要があります。詳細はデバッグツールのマニュアルを参照してください。

Program Device for Debugging Main Project

デバッグイメージをデバイスに書き込みます。書き込みが完了すると、即座にプログラムの実行が始まります。

Disassembly [Disassembly] ウィンドウを開きます。

Disconnect from Debug Tool

MPLAB® X IDE とデバッグツール間の通信を切断します。[Run] または [Debug Run] を選択すると再接続します。

Focus Cursor at PC カーソルを現在のPCアドレス位置へ移動し、このアドレスをウィンドウの中心に表示します。

PC Profiling [PC Sampling] ウィンドウを開きます。 PC サンプリングとプロファイリングの詳細は MPLAB REAL ICE インサーキットエミュレータのマニュアルを参照してください。

Reset デバイスをリセットします。

Set PC at Cursor プログラムカウンタ (PC) の値を、カーソル位置の行アドレスに設定します。

Step Instruction マシン命令を 1 つ実行します。命令が関数呼び出しの場合、その関数を実行してから呼び出し元の制御に戻ります。

Status Toolbar Action ステータスツールバーを表示します。

Launch Debugger Main Project

メインプロジェクトに対してデバッガを起動します。個別ビルド処理 ( ビルド、ターゲットのプログラミング、デバッガの起動 ) の後のステップです。これは、スタータキットを使ってデバッグ中に [Memory] ウィンドウの設定を変更する場合に便利です。



Debug Main Project メインプロジェクトをデバッグします。

New Watch [Watches] ウィンドウで観察するために式を入力します。

Attach Debugger MPLAB® X IDE とデバッグツール間の通信を確立します。デバッグツールは実行またはデバッグ実行時に自動的に接続され、実行が終了すると切断されます。デバッグツールを常時接続するには、[Tools] > [Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Embedded] ボタンをクリックし、[General Settings] タブを開いて、[Maintain active connection to hardware tool] にチェックを入れます。

Continue 「一時停止」したデバッグを再開します。デバッグは次のブレークポイントまたはプログラムの末尾で再び停止します。

Debug File 現在選択しているファイルのデバッグセッションを始めます。

Debug Test File ファイルの JUnit デバッグテストを始めます (Java 関連 )。Apply Code Changes コード内の全ての変更を実行中のプログラムに適用します。

Finish Debugger Session

デバッグセッションを終了します。

Make Callee Current 呼び出される側のメソッドを現在の呼び出しとします。この機能は、[Call Stack] ウィンドウで呼び出しを選択している場合にのみ利用できます。

Make Caller Current 呼び出す側のメソッドを現在の呼び出しとします。この機能は、[Call Stack] ウィンドウで呼び出しを選択している場合にのみ利用できます。

Pause デバッグを一時停止します。[Continue] で再開します。

Run to Cursor プロジェクトをカーソル位置まで実行して、停止します。

Step Into プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数の先頭の命令文を実行した後に停止します。

Step Over Expression 式をステップオーバーし、その後にデバッグを停止します。

Step Out プログラムのソースを 1 行実行します。関数をステップ実行中である場合、関数の残りを全て実行した後に、呼び出し元のルーチンに戻って停止します。

Step Over プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数全体を実行した後にデバッグは停止します。

表 6-5: 「Edit」機能

機能説明

Next Bookmark 次のブックマークに移動します ( 順方向に循環 )。Previous Bookmark 1 つ前のブックマークに移動します ( 逆方向に循環 )。Clear Document Bookmarks 文書内の全てのブックマークをクリアします。

Quick Search [Quick Search] ツールバーを表示します。

Find in Projects 指定したテキスト、オブジェクト名、オブジェクトタイプをプロジェクト内で検索します。

Replace in Projects テキスト、オブジェクト名、オブジェクトタイプをプロジェクト内で置換します。

Copy 現在選択している内容をクリップボードにコピーします。

Cut 現在選択している内容を削除し、クリップボードに移動します。

Delete 現在選択している内容を削除します。

Find 文字列を検索します。

Paste クリップボードの内容を現在の選択位置に挿入します。

Redo 以前の [Undo] 操作を 1 つずつ元に戻します。

Undo 以前のエディタ操作を 1 つずつ遡って取り消します ( 保存操作は取り消せません )。

表 6-4: 「Debug」機能 ( 続き )機能説明



表 6-6: 「Help」機能

機能説明

Start Page [Start Page] を表示します。

Individual Help Files 個別のポップアップヘルプファイルを表示します ( 例 : MPLAB® X IDE Help)。Help [Help] ウィンドウを表示します。

表 6-7: 「Profile」機能

機能説明

Start Sampling IDE PC プロファイリング / サンプリングのためのサンプリングを開始します。PC サンプリングとプロファイリングの詳細は MPLAB® REAL ICE™ インサーキットエミュレータのマニュアルを参照してください。

表 6-8: 「Project」機能

機能説明

Programmer to Go PICkit™ 3 Main Project

PICkit™ 3 の Programmer to Go 機能を使います。

Erase Device Memory Main Project

メインプロジェクトのデバイスメモリを消去します。

Hold in Reset デバイスをリセットと実行の間で交互に切り換えます。

Make and Program Device Main Project

必要に応じてメインプロジェクトをビルドして、デバイスに書き込みます。書き込みが完了すると、即座にプログラムの実行が始まります。

Read Device Memory Main Project #TOIN#

ターゲットデバイスのメモリの内容を MPLAB® X IDE に転送します。

Read Device Memory to File ターゲットデバイスのメモリの内容を指定したファイルに転送します。

Build Main Project メインプロジェクトの全ファイルをビルドします。

Build for Debugging Main Project メインプロジェクトの全ファイルをデバッグ用にビルドします。

Clean and Build Main Project 生成済みのファイルを全てクリーン ( 削除 ) してから、メインプロジェクトの全ファイルをリビルドします。

Build Project 選択したプロジェクトの全ファイルをビルドします。

Clean Main Project メインプロジェクトの生成済みファイルを全てクリーン ( 削除 ) します。

Clean Project 選択したプロジェクトの生成済みファイルを全てクリーン ( 削除 ) します。

Compile File 選択したファイルをプロジェクトコンパイラによってコンパイルします。

New File [New File] ウィザードを起動します。

New Project [New Project] ウィザードを起動します。

Open Project 既存のプロジェクトを開きます。

Clean and Build Project 生成済みのファイルを全てクリーン ( 削除 ) してから、選択したプロジェクトの全ファイルをリビルドします。

Run Main Project 必要に応じてメインプロジェクトをビルドして、デバイスに書き込みます。書き込みが完了すると、即座にプログラムの実行が始まります。「Make and Program Device Main Project」と同じです。

Run Project 必要に応じて選択したプロジェクトをビルドして、デバイスに書き込みます。書き込みが完了すると、即座にプログラムの実行が始まります。

Run File 現在選択中のファイルを実行します。

Test Project 現在のプロジェクトの JUnit テストを始めます (Java 関連 )。Test File 現在のファイルの JUnit テストを始めます (Java 関連 )。Open Required Projects 依存関係のあるプロジェクトを開きます。

Projects [Projects] ウィンドウを開きます。

Files [Files] ウィンドウを開きます。



表 6-9: 「CVS*」機能

機能説明

Commit ローカルファイルへの変更をリポジトリにコミットします。

Diff リポジトリ内のバージョンと、作業中のローカルコピーの間の変更箇所を表示します。

Show Annotations コミットメッセージ、作成者、日付、リビジョン番号情報をソースエディタで開いたファイルの左余白に表示します。

Revert Modifications ファイルのローカルバージョンをリポジトリに保存されたバージョンに戻します。

Update ファイルのローカルバージョンに、リポジトリにコミットされた変更を適用します。

* CVS は MPLAB® X IDE には付属していません。別途ご用意ください。CVS の詳細は http://www.nongnu.org/cvsを参照してください。

表 6-10: システム機能

機能説明

Next Error 次のビルドエラーを含む行にジャンプします。

Previous Error 1 つ前のビルドエラーを含む行にジャンプします。

Run SQL SQL 文とスクリプトを実行します。SQL とデータベースのサポートは以下を参照してください。

[NetBeans Help] > [IDE Basics] > [Using the IDE Help System] > [Working with Web and Application Servers] [NetBeans Help] > [IDE Basics] > [Using the IDE Help System] > [Working and Connecting with Databases]

SQL History SQL エディタ内でこれまでに実行した SQL 文の一覧を表示します。

Keep Prior Tabs 前回実行した SQL の実行結果タブを開いたままにするか閉じるかを切り換えます。

Open File [Open] ダイアログを開きます。

Properties [Project Properties] ウィンドウを開きます。

Save 現在のファイルを保存します。

Save All 開いている全てのファイルを保存します。[Compile on Save] を設定している場合、保存時にプロジェクトファイルをコンパイル / ビルドします。

表 6-11: ターミナル機能

機能説明

org-netbeans-modules-dlight-terminal-action-LocalTerminal() [Terminal] ウィンドウを開きます。

org-netbeans-modules-dlight-terminal-action-RemoteTerminal() [Remote Terminal] ウィンドウを開きます。

表 6-12: ツール機能

機能説明

Check CVS CVS バージョン管理アイテムを選択します。 CVS の詳細は http://www.nongnu.org/cvs を参照してください。

表 6-13: 表示機能

機能説明

Web Browser ブラウザで NetBeans のダウンロードページを開きます。

IDE Log [View] > [IDE Log] と同じ情報を表示します。

Classes [Classes] ウィンドウを開きます。

Customize Zoom データズーム機能をカスタマイズします。

Zoom In データにズームインします。

Zoom Out データからズームアウトします。


http://www.nongnu.org/cvs




表 6-14: ウィンドウ機能

機能説明

Debug>Breakpoints [Breakpoints] ウィンドウを開きます。

Debug>Call Stack [Call Stack] ウィンドウを開きます。

Debug>Variables [Variables] ウィンドウを開きます。

Debug>Sessions [Sessions] ウィンドウを開きます。

Debug>Sources [Sources] ウィンドウを開きます。

Debug>Threads [Threads] ウィンドウを開きます。このウィンドウには、現在のデバッグセッションの全スレッドが表示されます。

Debug>Watches [Watches] ウィンドウを開きます。

Select Document In>Select In Favorites

[Favorites] ウィンドウを開いて、その中で現在の文書を選択します。

Terminal [Terminal] ウィンドウを開きます。

Remote Terminal [Remote Terminal] ウィンドウを開きます。

Terminal (Experimental) [Experimental Terminal] ウィンドウを開きます。

Stopwatch [Stopwatch] ウィンドウを開きます。

Trace [Trace] ウィンドウを開きます。

Disassembly Listing File エディタウィンドウに逆アセンブルリスティングファイルを開きます。

Project Environment [Project Environment] ( ダッシュボード ) ウィンドウを開きます。

Analyzer [Simulator Analyzer] ウィンドウを開きます。

Stimulus [Simulator Stimulus] ウィンドウを開きます。

Services [Services] ウィンドウを開きます。

Output [Output] ウィンドウを開きます。

Properties [Project Properties] ウィンドウを開きます。

Call Graph [Call Graph] ウィンドウを開きます。

Hierarchy [Include Hierarchy] ウィンドウを開きます。あるソースファイルに直接または間接的にインクルードされているヘッダファイルとソースファイルを全て調べる事ができます。または、あるヘッダファイルを直接または間接的にインクルードしているソースファイルとヘッダファイルを全て調べる事ができます。

Macro Expansion [Macro Expansion] ウィンドウを開きます。このウィンドウは、マクロをコードに展開します。

Thread Map [Threads] ウィンドウを開きます。

Reporter Result 例外ブレークポイント用の [Exception Reporter] ウィンドウを開きます。

Favorites [Favorites] ウィンドウを開きます。

Test Results C/C++ プロジェクトの [Test Results] ウィンドウを開きます。

Chat [Team Chat] ウィンドウを開きます。

Team チームプロジェクトを開きます。#TOIN#チームサーバプロジェクトの詳細は NetBeans ヘルプトピック ([IDE Basics] > [Using theIDE Help System] > [Working in a Collaborative Environment]) を参照してください。

Navigator [Navigator] ウィンドウを開きます。

Palette [Palette] ウィンドウを開きます (Java 関連 )。Find Usages Results [Find Usages] ウィンドウを開きます。

Refactoring Preview リファクタリング結果の [Preview] ウィンドウを開きます。

Search Results [Search] ウィンドウを開きます。

Tasks [Tasks] ウィンドウを開きます。



6.10 チェックサム

チェックサムとは、アプリケーションコードと、MCU または DSC のその他の設定から得られる 16 進数です。チェックサムの生成方法の詳細はデバイスのプログラミング仕様を参照してください。

チェックサムは、プロジェクトのビルド時に生成されます。生成されたチェックサムは [Dashboard] ウィンドウに表示されます ( セクション 5.18「ダッシュボードの表示」)。

チェックサムはビルドエラーの検出に役立ちます。例として、あるプロジェクトをあるコンピュータでビルドした場合について考えます。同じプロジェクトを別のコンピュータにコピーしてビルドした時に、チェックサムが同じであればプロジェクトが正常にコピーされた事を意味します。チェックサムが異なれば、コピーに失敗した事を意味します。

チェックサムをエラー検出に使う場合、プロジェクトコードを開発する際以下に注意する必要があります。コンパイラマクロの __TIME__ と __DATE__ を使ってはいけません。ファイルパスを変更する場合、マクロの __FILE__ と assert() を使ってはいけません。

デバイスによって、チェックサムをユーザ ID として使う場合があります ( セクション4.14.3「ユーザ ID メモリへのチェックサムの挿入」)。

表 6-15: XML 機能

機能説明

Check File XML ファイルが整形式であるか確認します。

Check DTD [DTDs and XML Schemas Manager] を開きます。

Validate File XML スキーマまたは DTD に従って XML ファイルの構文エラーを確認します。

XSL Transform XSL スタイルシートを使って XML 文書を変換します。



6.11 コンフィグレーション

「コンフィグレーション」という用語は様々な文脈で使われます。下表にそれらの用語と定義を示します。

表 6-16: コンフィグレーションの文脈

用語定義

コンフィグレーションビットコンフィグレーションヒューズコンフィグレーションワードコンフィグレーションバイトコンフィグレーションレジスタ

これらの用語は全て、デバイスを設定するために使うデバイスメモリの物理領域を指します。利用可能なコンフィグレーションは、デバイスのデータシートを参照してください。

[Configuration Bits] ウィンドウプロジェクトで設定したデバイスで利用可能なコンフィグレーションを表示するウィンドウです。このウィンドウの詳細は本書のセクション 4.22.4「コンフィグレーションビットの設定」を参照してください。

プロジェクトコンフィグレーション

プロジェクトのビルド設定です。プロジェクト作成後、コンフィグレーション名は「[default]」となっています。この名前は変更できます。また、1 つのプロジェクトに対して複数のコンフィグレーションを作成できます。詳細はセクション 6.4「複数コンフィグレーションを使った作業」を参照してください。このデータは configurations.xmlファイルに保存されます。

プロジェクトコンフィグレーションタイプ

特定タイプのプロジェクト向けの設定です。プロジェクトコンフィグレーションタイプは、「アプリケーション」として設定したスタンドアロンプロジェクトと

「ライブラリ」として設定したライブラリプロジェクトにのみ適用されます。詳細はセクション 4.14.1「プロジェクトコンフィグレーションタイプの変更」を参照してください。

ユーザコンフィグレーションデータ

ユーザが作成した MPLAB X IDE のコンフィグレーションです。セクション 8.7「ユーザコンフィグレーションデータの表示」を参照してください。


MPLAB® X IDE
ユーザガイド
第 7 章エディタ

7.1 はじめに

MPLAB X IDE は NetBeans プラットフォームをベースとしているため、コードの編集には NetBeans プラットフォームのエディタを使います。

エディタに関する C コンパイラ情報は、NetBeans ヘルプトピック ([C/C++/FortranDevelopment] > [Working with C/C++/Fortran Projects] > [Editing Source Files inC/C++/Fortran Projects] > [About Editing C and C++ Files]) を参照してください。ここでは、MPLAB X IDE のエディタ機能を説明します。

• ソースエディタの一般操作クイックリファレンス

• エディタの使い方

• エディタのオプション

• エディタの赤の感嘆符

• コード折り畳み

• C コードのリファクタリング

7.2 ソースエディタの一般操作クイックリファレンス

ここでは、ソースエディタにおける一般的な操作について説明します。

表 7-1: エディタのクイックリファレンス

操作手順

[Projects] ウィンドウまたは[Files] ウィンドウでは開けないファイルを開く

1. [File] > [Open File] を選択する。

2. ファイル選択ダイアログでファイルを参照する。次に [Open] をクリックする。

ソースエディタのウィンドウを大化する

以下のいずれかを行う。• ソースエディタのファイルのタブをダブルクリックする。• ソースエディタのウィンドウを選択し、<Shift>+<Esc> を押す。• [Window] > [Configure Window] > [Maximize] を選択する。

大化したソースエディタを元のサイズに戻す

以下のいずれかを行う。• ソースエディタのファイルのタブをダブルクリックする。• <Shift>+<Esc> を押す。• [Window] > [Configure Window] > [Restore] を選択する。

行番号を表示する [View] > [Show Line Numbers] を選択する。

2 つのファイルを同時に表示する

1. 2 つ以上のファイルを開く。

2. 1 つのファイルのタブをクリックし、ファイルを配置するウィンドウの側面にドラッグする。ウィンドウの配置場所を示す赤いプレビューボックスが表示された状態でマウスボタンを放すと、エディタウィンドウがそこに配置される。

タブをドラッグする場所によって、ウィンドウは水平または垂直に分割できます。

1 つのファイルの表示画面を分割する

1. ソースエディタのファイルのタブを右クリックし、[Clone] を選択する。

2. コピーしたファイルのタブをクリックし、コピーしたファイルを配置するウィンドウの部分にドラッグする。

コードを自動的にフォーマットする

ソースエディタ内で右クリックし、[Format] を選択する。テキストを選択している場合、そのテキストのみがフォーマットされます。テキストを選択していない場合、そのファイル全体がフォーマットされます。



7.3 エディタの使い方

エディタを使うには、[File] > [New File] を使ってファイルを作成します。または [File] >[Open File] を使って既存のファイルを開きます。以下のセクションでは、その他の操作と機能について説明します。

7.3.1 デスクトップ

エディタに関連するデスクトップ項目には以下のようなものがあります。

• [File]メニュー – [Editor]ウィンドウでファイルを開きます (セクション 11.2.1「[File]メニュー」参照 )。

• [Edit] メニュー – 編集コマンドを利用できます ( セクション 11.2.2「[Edit] メニュー」参照 )。

• エディタツールバー – これでも編集コマンドを利用できます。各ファイルのエディタウィンドウの上にあります ( セクション 11.3.10「エディタ用ツールバー」参照 )。

• ウィンドウ内で右クリックして開くコンテクストメニュー – その他のコマンドを利用できます。

7.3.2 C コードのハイパーリンク

ハイパーリンクナビゲーションを使うと、関数、変数、定数のいずれかの呼び出しからその宣言にジャンプできます。

以下のどちらかの方法により、ハイパーリンクを使えます。

• <Ctrl> (Windows, Linux) または <Command> (Mac) を押しながら関数、変数、定数のいずれかの上にマウスカーソルを置く。その要素に関する情報とハイパーリンクが表示される。ハイパーリンクをクリックすると宣言にジャンプする。<Alt>+< 左矢印 > を押すと、呼び出し元に戻る。

• マウスカーソルを識別子の上に置き、<Ctrl>+<B> または <Command>+<B> を押すと、エディタは宣言にジャンプする。<Alt>+< 左矢印 > を押すと、呼び出し元に戻る。

<Alt>+< 左矢印 > または <Alt>+< 右矢印 > を押すと、カーソル位置の履歴で後方または前方に移動します。

以下の NetBeans ヘルプトピックも参照してください。

[C/C++/Fortran Development] > [Working with C/C++/Fortran Projects] > [NavigatingSource Files and Projects] > [Using Hyperlink Navigation]

7.3.3 ASM コードのハイパーリンク

アセンブリソースファイルに含まれているヘッダファイルを参照するには、#include 文で参照されているファイル名の上にマウスカーソルを置き <Ctrl>(Windows, Linux) または <Command> (Mac) を押します。マウスをクリックすると、エディタのファイルタブ内にインクルードファイルが開きます。

7.3.4 注目すべきエディタ機能

下表に、頻繁に使われるエディタ機能をまとめます。


エディタ

7.3.5 エディタのトラブルシュート

エディタ内でハイライトされたコードのエラーは、コンパイラのマニュアルを参照してください。ハイライトされたエラーの詳細は NetBeans ヘルプトピック([C/C++/Fortran Development] > [Working with C/C++/Fortran Projects] > [EditingSource Files in C/C++/Fortran Projects] > [Error Highlighting]) を参照してください。

個々のエラーはセクション 9.7「エラー」に記載しています。

表 7-2: エディタ機能

エディタ機能参考文献

ユニコードのサポート既定値では、新規作成した IDE プロジェクトは ISO-8859-1文字エンコードを使います。これを変更するには以下を行います。• [Projects] ウィンドウでプロジェクト名を右クリックして

[Properties] を選択する。• 左側の [Categories] の下の列で [General] を選択する。• ページ下部の [Encoding] を変更する。

構文に基づくコードの色分け [Tools] > [Options] (Mac OS X の場合、[mplab_ide] >[Preferences])、[Fonts and Colors] ボタン、[Syntax] タブ色分けは、プロジェクト作成時のエンコード設定で決まります。

コード入力中のエラー表示以下の NetBeans ヘルプトピックを参照してください。[C/C++/Fortran Development] > [Working with C/C++/Fortran Projects] > [Editing Source Files in C/C++/Fortran Projects] > [Error Highlighting]

シンボル、エラー等の色付きマーカによる識別 [Tools] > [Options] (Mac OS X の場合、[mplab_ide] > [Preferences])、[Fonts and Colors] ボタン、[Annotations] タブ

候補とヒントを表示するスマートコード補完 [Tools] > [Options] (Mac OS X の場合、[mplab_ide] > [Preferences])、[Editor] ボタン、[Code Completion] タブ

アセンブリと C コードの折り畳みおよび展開表示セクション 7.6「コード折り畳み」

関数 ( 例 : delay(x)) を右クリックして、その関数が使われている箇所を検索する。検索を関数内のみに制限する事もできます ( 例 : ローカル変数 iの検索 )。

以下の NetBeans ヘルプトピックを参照してください。[Find Usages] ダイアログ

関数 ( 例 : delay(x)) を右クリックして、コールグラフを表示する。コールグラフの横のボタンを使って順番の入れ換え等を行う

セクション 5.17「コールグラフの表示」

ソースコード内でキーワード ( 例 : //TODO) を使ってコメントを作成し、それらの要処理事項をスキャンして [Action Items] ウィンドウに自動的に追加する

以下の NetBeans ヘルプトピックを参照してください。[Tools] > [Options] > [Team] > [Action Items]

バージョン管理システムがなくてもローカルファイル履歴機能を使って以前のバージョンを復元する

セクション 5.20「ソースコードの管理」 – ローカル履歴

[Go to File]、[Go to Type]、[Go to Symbol]、[Go toHeader]、[Go to Declaration] 等を使って、素早く移動する

セクション 11.2.4「[Navigate] メニュー」

リファクタリングオプション(関数と変数の名前変更、全関数の検索等 ) を使ってコードの構造を改良する

セクション 7.7「C コードのリファクタリング」



7.4 エディタのオプション

エディタオプションの設定方法


2. [Editor] ボタンをクリックする。タブをクリックしてエディタ機能を設定する。下表に各タブとそのオプションを示します。

表 7-3: [General] タブ

項目説明

Code Folding コード折り畳みを有効にする場合にチェックを入れます。また折り畳むコードの種類を選択します。コード折り畳みの詳細はセクション7.6「コード折り畳み」を参照してください。

Camel Case Behavior キャメルケースナビゲーションを有効にする場合にチェックを入れます。

表 7-4: [Formatting] タブ

項目説明

Language フォーマット設定を適用するプログラミング言語を選択します。

Category カテゴリを選択します。現在は [Tabs and Indents] のみです。

Expand Tabs to Spaces タブをスペースに変換する場合、チェックを入れます。

Number of Spaces per Indent インデント 1 段をスペース何文字にするか入力します。

Tab Size タブのサイズを入力します。

Right Margin 右余白のサイズを入力します。

表 7-5: [Code Completion] タブ

項目説明

Language コード補完機能を適用するプログラミング言語を選択します。

Completion コード補完機能を有効にする場合、チェックを入れます。コード補完の詳細は NetBeans ヘルプトピックを参照してください。[C/C++/Fortran Development] > [Working with C/C++/Fortran Projects] > [Editing Source Files in C/C++/Fortran Projects] > [Using Code Completion]

表 7-6: [Code Templates] タブ

項目説明

Language テンプレートを適用するプログラミング言語を選択します。

Templates 上記で指定した言語に対するテンプレート情報を入力します。Abbreviation: エディタに入力する省略形を入力します。Expanded Text: 上記の省略形と [Expand template on] で選択したキーを入力すると、ここで指定するテキストに展開します。Description: テンプレート項目に説明を追加します ( 任意 )。コードテンプレートの詳細は NetBeans ヘルプトピック ([C/C++/FortranDevelopment] > [Working with C/C++/Fortran Projects] > [Editing SourceFiles in C/C++/Fortran Projects] > [Using Code Templates]) を参照してください。

Expand template on

省略形を展開するトリガとなるキーを選択します。


エディタ

表 7-7: [Hints] タブ

項目説明

Language ヒントを適用するプログラミング言語を選択します。

[Hint]ウィンドウ

[Hint] ウィンドウでは、エラー、警告等どれをどのように表示するかを指定します。

表 7-8: [Macros] タブ

項目説明

Macros エディタマクロを作成、編集、削除します。• マクロを新規作成するには、[New] ボタンをクリックしてマクロ名を入力します。その後、リストでそのマクロを選択し、マクロコードエディタでコードを入力します。

• マクロのキーボードショートカットを設定するには、リストからマクロを選択し、[Set Shortcut] ボタンをクリックし、ダイアログボックスにショートカットを入力します。このショートカットを使ってマクロを実行します。

• マクロを削除するには、リストからマクロを選択して [Remove] をクリックします。

• マクロコードを変更するには、リストからマクロを選択してエディタでコードを編集します。

Macro Code 上記のマクロ名をクリックして、マクロコードを入力します。マクロのキーワードの一覧は、以下の URL を参照してください。https://netbeans.org/kb/docs/ide/macro-keywords.html

Note: 通常、エディタでゼロから入力するよりも、操作を記録してマクロとして追加する方が簡単です。マクロの記録には、[Edit] > [Start/Stop MacroRecording] を使います。


https://netbeans.org/kb/docs/ide/macro-keywords.html


7.5 エディタの赤の感嘆符

ソースエディタは、ソースコード中の構文およびセマンティックエラー ( 例 : セミコロンの欠落、未解決の識別子 ) をハイライト表示します。エラーは赤の下線で表示されます。また、エラーを含む各行の隣のエディタウィンドウ左側の余白に赤の感嘆符「グリフ」が表示されます。グリフの上にマウスカーソルを置くとエラーメッセージが表示されます。

7.5.1 エラー条件とその他のマーク表示

エラーは、以下のいずれかを実行した場合に発生する可能性があります。

• 新規のコードを入力した

• 既存のコードを編集した

• 既存のファイルをプロジェクトに追加した

• 別の場所にファイルを移動した

• プロジェクトのプロパティまたはソースファイルを変更した

ファイル内にエラーがある場合、エディタウィンドウ右側のエラーストライプに赤のマークが表示されます。エラーストライプは、現在表示されている行だけではなくファイル全体を表しています。エラーストライプのマークをダブルクリックすると、マークが表す行にジャンプします。

7.5.2 未認識のシンボルによるエラー

コンパイラのプリパーサまたはパーサによって認識されないシンボルは、エラーとして表示されていても実際にはエラーではない ( コードはビルドされる ) 場合があります。従って、このタイプのエラーが疑われる場合、プロジェクトのビルドを試みます。

例えば以下を参照してください。

• セクション 9.7.6「For 8-bit code, #asm and #endasm cause red bangs in the Editorwindow」

• セクション 9.7.7「For 16-bit code, MPLAB XC16 packed attribute statement causesred bangs in the Editor window」

Note: エディタに表示されるエラーが全て本当のエラーとは限りません。認識できないシンボルである可能性もあります。コードをビルドしてみてビルドに成功するかどうか確かめます。詳細はセクション 7.5.2「未認識のシンボルによるエラー」を参照してください。


エディタ

7.6 コード折り畳み

コードの一部を折り畳んで非表示にする事で、コードを読みやすくします。選択したオプションに応じて、C またはアセンブリコードの一部を折り畳み ( 非表示 ) または展開 ( 表示 ) できます。

• コード折り畳みの使い方

• コード折り畳みのカスタマイズ

• コード折り畳みのカスタマイズ – ASM• カスタマイズしたコード折り畳み / 展開

7.6.1 コード折り畳みの使い方

コード折り畳みは既定値で有効になっています。ほとんどの C またはアセンブリコードでは、折り畳む事ができるコード部分はコード左の [-] および [+] アイコンで示されています。

• コード折り畳みの有効化と設定

• コード折り畳み / 展開

• コード折り畳み – インラインアセンブリと MPLAB C18 C

7.6.1.1 コード折り畳みの有効化と設定

コード折り畳みは以下の手順で有効化および設定します。


2. [Editor] ボタンをクリックする。

3. [General] タブをクリックし、[Use code folding] にチェックを入れる。

4. その下で折り畳むセクションを指定する ( 折り畳みを実行するコードタイプが表示されない場合、カスタムの折り畳み機能を設定できます )。

7.6.1.2 コード折り畳み / 展開

エディタで、メソッドの隣の [-] アイコンをクリックすると、コードは折り畳まれます。折り畳まれたメソッドの隣の [+] アイコンをクリックすると、コードは展開されます。折り畳まれたコードは省略記号の箱で表されます。省略記号の箱の上にカーソルを置くと、IDE は折り畳まれたメソッドを表示します。

図 7-1: 展開されたコード



図 7-2: 折り畳まれたコード

7.6.1.3 コード折り畳み – インラインアセンブリと MPLAB C18 C

_asmおよび _endasmディレクティブを使っている場合、コード折り畳みは MPLABC18 のインラインアセンブリコードに対して機能しません。その回避策は、コードブロックをコード / ファイルの末尾付近に配置する事です。

7.6.2 コード折り畳みのカスタマイズ

カスタマイズしたコード折り畳みを使うと、コードを希望の領域で折り畳む事ができます。

• コード折り畳みのカスタマイズ – C• コード折り畳みのカスタマイズ – ASM• カスタマイズしたコード折り畳み / 展開

7.6.2.1 コード折り畳みのカスタマイズ – C

C コードをカスタム設定で折り畳む方法は以下の通りです。

• 折り畳むコードの前後に以下のコメントを入力します。

// <editor-fold defaultstate="collapsed" desc="user-description">C code block to fold// </editor-fold>または

• fcomと入力して <Tab> キーを押すと、自動的に上記のコメントが挿入されます。

コメントが入力されたら、自分のコード向けにカスタマイズできます。

defaultstate 「collapsed」または「expanded」のどちらかを指定します。

desc 折り畳むコードブロックの説明を入力します。折り畳んでも、参考のためにこの説明だけは表示されたままになります。


エディタ

以下に、カスタムコード折り畳みの例を示します。

図 7-3: 展開されたコード

図 7-4: 折り畳まれたコード

詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] > [Working withC/C++/Fortran Projects] > [Editing Source Files in C/C++/Fortran Projects] > [FoldingBlocks of Code]) を参照してください。



7.6.2.2 コード折り畳みのカスタマイズ – ASM

アセンブリコードをカスタム設定で折り畳む方法は以下の通りです。

• MPASM アセンブラまたは MPLAB XC16 アセンブラのコードの場合、以下のコメントをコードの前後に入力します。

; <editor-fold defaultstate="collapsed" desc="user-description">ASM code block to fold; </editor-fold>• MPLAB XC32 アセンブラのコードの場合、以下のコメントをコードの前後に入力します。

// <editor-fold defaultstate="collapsed" desc="user-description">ASM code block to fold// </editor-fold>または

• MPASM アセンブラまたは MPLAB XC16 アセンブラのコードの場合、fcom; と入力して <Tab> キーを押すと、自動的に上記のコメントが挿入されます。

• MPLAB XC32 アセンブラのコードの場合、fcom//と入力して <Tab> キーを押すと、自動的に上記のコメントが挿入されます。

アセンブリコードは、C コードと同じように折り畳まれます。コード折り畳みの例は、上記の C コードの例を参照してください。

7.6.2.3 カスタマイズしたコード折り畳み / 展開

コードブロックを展開または折り畳むには、[View] メニューを選択するか、[Editor]ウィンドウを右クリックして、以下を選択します。

1. [Code Folds] > [Collapse Fold] - コードブロックを非表示 ( 折り畳み )2. [Code Folds] > [Expand Fold] - コードブロックを表示 ( 展開 )3. [Code Folds] > [Collapse All] - 折り畳み設定したコードブロックの全てを非表示

4. [Code Folds] > [Expand All] - 折り畳み設定したコードブロックの全てを表示

コード折り畳み / 展開の図はセクション 7.6.2.1「コード折り畳みのカスタマイズ – C」を参照してください。


エディタ

7.7 C コードのリファクタリング

リファクタリングは、プログラムの挙動を一切変更する事なくコードを再構成します。リファクタリングによりコードが読みやすくなり、内容の理解と編集が容易になります。式をリファクタリングした場合、同じ結果が得られる必要があるのと同様に、リファクタリング後のプログラムも元のプログラムと機能的に等価である事が必要です。

一般的に、以下を目的としてコードをリファクタリングします。

• コードの編集や機能の追加を容易にする

• コードを単純化して理解しやすくする

• 不要な繰り返しを取り除く

• コードを他の用途またはより一般的な用途で使えるようにする

• コードの性能を改善する

IDE のリファクタリング機能は、ユーザが加えようとしている変更を評価してコードを再構成し、その変更によってアプリケーションのどの部分が影響を受けるのかを示します。これにより、必要な全ての箇所でコードを変更してコードを単純化できます。例えば、クラス名を変更する場合、IDE はコード内でその名前が使われている箇所を全て検出し、その名前が使われている箇所を全て変更するようユーザに提示します。

• [Refactor] メニュー

• リファクタリングした変更の取り消し

• 関数の使用箇所の検索

• 関数またはパラメータの名前変更

• C コードの移動、コピー、安全な削除

7.7.1 [Refactor] メニュー

IDE のリファクタリング機能は、ユーザがある箇所でコードの構造を変更した時に、その変更を反映してコード全体を更新します。

リファクタリング機能は、[Refactor]メニュー (セクション11.2.6「[Refactor]メニュー」参照 ) から利用できます。

7.7.2 リファクタリングした変更の取り消し

[Refactor] メニュー内のコマンドを使って適用した変更は、以下の手順で取り消す事ができます。リファクタリングを取り消すと、IDE は、リファクタリングの影響を受けた全てのファイル内の全ての変更箇所を元に戻します。

リファクタリングを取り消す手順は以下の通りです。

1. メインメニューバー内の [Refactor] メニューを開く。

2. [Undo] を選択する。IDE は、リファクタリングの影響を受けた全てのファイル内の全ての変更を元に戻します。

リファクタリングを実行した後に、その影響を受けたファイルのいずれかを変更した場合、リファクタリングの [Undo] は利用できなくなります。

Note: この機能については、[Start Page] の [My MPLAB X IDE] タブを開き、[Extend MPLAB] セクションの [Selecting Simple or Full-Featured Menus]トピックを参照してください。



7.7.3 関数の使用箇所の検索

[Find Usages] コマンドを使うと、プロジェクトのソースコード内で特定の関数が使われている全ての箇所を検出できます。

プロジェクト内で関数が使われている箇所を検出する方法

1. [Navigator]ウィンドウまたは[Source Editor]ウィンドウ内で関数を右クリックし、[Find Usages] を選択します ( または <Alt>+<F7> を押す )。

2. [Find Usages]コマンドは、指定された関数を呼び出しているコード行を表示します。[Find Usages] ダイアログボックス内で [Find] をクリックすると、

[Usages] ウィンドウに、その関数が見つかったファイルの名前と、そのファイル内で関数が使われているコード行が表示されます。

見つかった関数使用行のいずれかを選択して、その位置へジャンプする方法

• [Usages] ウィンドウの左ペイン内で、上向きまたは下向き矢印ボタンを使って、関数使用行を選択します。

• コードの 1 行をダブルクリックしてファイルを開くと、カーソルはそのコード行を指します。

その他の IDE 検索機能

以下の IDE ツールにより、プロジェクト内で特定テキストが使われている全ての箇所を検索できます。

• テキストの検索と置換 : エディタで開いたソースファイル内で、特定テキストを検索するには、[Edit] > [Find] を選択して [Find] ダイアログボックスを開くか、[Edit] >[Replace]を選択して [Replace]ダイアログボックスを開きます。これらのコマンドは、文字列が C コードエレメントであるかどうかに関係なく、一致する文字列を全て検索します。

• プロジェクト内の検索 : [Find] コマンドと同様に、[Find in Projects] コマンドも、関数名かどうかに関係なく、一致する文字列を検索します。[Edit] > [Find in Projects]を選択して [Find in Projects]ダイアログボックスを開き、検索文字列を入力します。

[Navigator] ウィンドウ内で関数をダブルクリックすると、ソースファイル内でその関数が宣言されている箇所を検索できます。その関数が別のソースファイル内で宣言されている場合、関数を右クリックしてコンテクストメニューから [Navigate] > [Go ToDeclaration] を選択します。

7.7.4 関数またはパラメータの名前変更

関数またはパラメータの名前を変更し、プロジェクト全体を通してその関数またはパラメータへの参照を更新するには、以下の手順を実行します。

1. エディタで関数またはパラメータを右クリックし、コンテクストメニューから[Refactor] > [Rename] を選択します。

2. [Rename] ダイアログボックスに、新しい名前を入力します。

3. 必要に応じて [Preview] をクリックします。すると、[Refactoring] ウィンドウ内の [Source Editor] の下段に、変更対象のコード行が表示されます。チェックを外すとその行は変更されません。

4. [Do Refactoring] をクリックして、変更を適用します。

関数またはパラメータにカーソルを合わせて <Ctrl>+<R> を押して新しい名前を入力すると、直接簡単に名前を変更できます。名前の変更作業を終了するには [Escape]を押します。

7.7.5 C コードの移動、コピー、安全な削除

これらの機能は C++ コード専用です。セクション 11.2.6「[Refactor] メニュー」を参照してください。


MPLAB® X IDE
ユーザガイド
第 8 章プロジェクトファイルおよびフォルダ

8.1 はじめに

本章では、MPLAB X IDE 内のプロジェクトファイルとプロジェクトフォルダを表示する以下のウィンドウを説明します。

• [Projects] ウィンドウの表示

• [Files] ウィンドウの表示

• [Favorites] ウィンドウの表示

• [Classes] ウィンドウの表示

その他に、MPLAB X IDE のファイルとフォルダに関する以下の内容も記載しています。

• ファイルまたはフォルダ名の制約

• ユーザコンフィグレーションデータの表示

• MPLAB IDE v8 プロジェクトのインポート – 相対パス

• プロジェクトの移動、コピー、リネーム

• プロジェクトの削除

8.2 [Projects] ウィンドウの表示

[Projects] ウィンドウが表示するプロジェクトフォルダは論理 ( 仮想 ) フォルダです。このウィンドウの詳細は本書のセクション 12.13「[Projects] ウィンドウ」を参照してください。

ユーザは少なくともソースファイルを追加する必要があります。MPLAB X IDE は、各種の既定値ファイル ( ヘッダファイル、リンカスクリプト ) を自動的に見つけます。ユーザはライブラリファイル、プリコンパイル済みオブジェクトファイル、編集済みのヘッダおよびリンカスクリプトファイルを追加できます。ビルドに含めないファイルは「Important Files」の下に保存できます。

図 8-1: [Projects] ウィンドウ – シンプルな C コードプロジェクト



8.3 [Files] ウィンドウの表示

[Files] ウィンドウに表示されるプロジェクトフォルダは、実在するフォルダです。Cコードプロジェクトでこのウィンドウを使う場合の詳細はNetBeansヘルプトピック

「Files Window」を参照してください。

図 8-2: [Files] ウィンドウ – シンプルな C コードプロジェクト

表 8-1: [Projects] ウィンドウのフォルダ定義

仮想フォルダ格納するファイル

Header Files ヘッダファイル (.h, .inc)

Library Files ライブラリファイル (.a, .lib)

Linker Files リンカファイル (.ld, .gld, .lkr)

Object Files プリコンパイル済みオブジェクトファイル (.o)

Source Files ソースファイル (.c, .asm)

Important Files その他の重要ファイル (makefile 等 ) やデータシート PDF 等の文書ファイルをここに含める事ができます。


プロジェクトファイルおよびフォルダ

表 8-2: [Files] ウィンドウのフォルダ定義

フォルダ説明

MyProject MakefileファイルとCコードまたはアセンブリのアプリケーションファイルを格納するプロジェクトフォルダです。Makefileは、プロジェクトのマスタ makefile です。このファイルはプロジェクト作成時に生成され、それ以降は一切変更されません ( 再生成されません )。GNU の make に詳しければ、このファイルを編集してもかまいません。しかし、MPLAB X IDE では、Makefile 自体を編集する代わりに、プリビルド /make ステップとポストビルド /make ステップを追加する方法を使えます。

build(1) 中間生成ファイルを格納するフォルダです。プロジェクトコンフィグレーション、使い方、格納場所に応じたサブフォルダにファイルを格納します。このフォルダは以下のファイルを格納します。実行ファイル (.o)依存関係ファイル (.o.d)HI-TECH® の中間生成ファイル (.p1)

dist(1) 出力ファイルを格納するフォルダです。プロジェクトコンフィグレーション、使い方、格納場所に応じたサブフォルダにファイルを格納します。このフォルダは以下のファイルを格納します。実行ファイル (.hex)ELF または COFF オブジェクトファイル (.elf, .cof)ライブラリファイル (.a, .lib)

nbproject makefile とメタデータファイルを格納するフォルダです。このフォルダは以下のファイルを格納します。プロジェクトの makefileコンフィグレーション別の makefileproject.xml: IDE が生成したメタデータファイルconfigurations.xml: メタデータファイル

default, MyConfig(2)

プロジェクトコンフィグレーションを格納するフォルダです。ユーザがコンフィグレーションを一切作成しなかった場合、全てのコードは「default」フォルダに格納されます。

production, debug(2)

量産バージョンとデバッグバージョンのフォルダです。

_ext(2) 外部プロジェクトのファイルを格納するフォルダです。プロジェクトフォルダの外部にあるファイルを参照する場合、そのファイルがこのフォルダに表示されます。

Note 1: これらのフォルダをソース管理に含める必要はありません。これらのフォルダはビルド

によって作成されます。セクション 5.20「ソースコードの管理」も参照してください。

2: これらの項目は、図 8-2 には示していません。



8.4 [Classes] ウィンドウの表示

C++ をサポートするコンパイラでは、[Classes] ウィンドウを使ってプロジェクトのクラスファイルを表示できます ([Window] > [Classes])。このウィンドウの詳細は NetBeans ヘルプトピック ([C/C++/Fortran Development] >[Working With C/C++/Fortran Projects] > [Navigating Source Files and Projects] >[Using the Classes Window]) を参照してください。

図 8-3: [Classes] ウィンドウ – シンプルな C コードプロジェクト

8.5 [Favorites] ウィンドウの表示

[Favorites] ウィンドウ ([Window] > [Favorites]) を使うと、プロジェクトの内外にかかわらず、コンピュータまたはネットワーク上の任意のファイルまたはフォルダにアクセスできます。

[Favorites] ウィンドウを初めて開いた時には、コンピュータのホームフォルダのみが含まれています。

• ファイルまたはフォルダを追加するには、[Favorites] ウィンドウ内で右クリックして [Add to Favorites] を選択する

• ファイルを追加するには、[Projects] ウィンドウ内でファイル名を右クリックして[Tools] > [Add to Favorites] を選択する

このウィンドウの詳細は NetBeans ヘルプトピック「Favorites Window」を参照してください。


プロジェクトファイルおよびフォルダ

8.6 ファイルまたはフォルダ名の制約

ファイルまたはフォルダ名に、以下の文字を使わないでください。

• 空白

• タブ : \t• バックスラッシュ : \• アスタリスク : *• 角カッコ : [ ]• 丸カッコ : ( )• セミコロン : ; 丸カッコには特に注意してください。

この制約は MPLAB X IDE がビルドツールとして使う GNU Make によるものです。

8.7 ユーザコンフィグレーションデータの表示

MPLAB X IDE のユーザフォルダ (userdir) は、ユーザコンフィグレーションデータ( 例 : ウィンドウ構成、エディタ設定、メニューとツールバーのカスタマイズ、各種モジュールの設定 ( 既知のコンパイラ一覧等 )) を格納しています。また、プラグインをインストールする場合 ([Tools] > [Plugins])、プラグイン情報 ( コード ) は、MPLABX インストールフォルダではなく、ユーザフォルダに格納されます。

ユーザフォルダの格納場所を調べるには、[Help] > [About] を選択し Userdir の次のパスを見つけます。

この情報は MPLAB X IDE が作成および管理します。

8.8 MPLAB IDE v8 プロジェクトのインポート – 相対パス

MPLAB IDE v8 プロジェクトは以下のパスに格納されています。

C:\MyProjects\mplab8projectMPLAB IDE v8 プロジェクトを MPLAB X IDE にインポートした場合、以下のファイルが作成されます。

C:\MyProjects\mplab8project\mplab8project.X既定値では、MPLAB X IDE にインポートしたプロジェクトは、両方のプロジェクトの保守性を維持するために、MPLAB IDE v8 プロジェクトの下に置かれます。これに対し、MPLAB X IDE のプロジェクトフォルダはどこに置いてもかまいません。また、プロジェクト名は mplab8project.Xに設定されますが、変更してもかまいません。MPLAB X IDE のプロジェクト名は .X で終わるという規則がありますが、あくまで便宜的なものです。

新規プロジェクトは、ソースファイルをプロジェクトフォルダにコピーしません。その代わりに、v8 フォルダ内のファイル格納場所を参照します。独立した MPLAB XIDE プロジェクトを作成するには、新規プロジェクトを作成して、MPLAB IDE v8 のソースファイルを、そのプロジェクトにコピーする必要があります。

詳細はセクション 5.2「レガシー MPLAB プロジェクトのインポート」を参照してください。

8.9 プロジェクトの移動、コピー、リネーム

プロジェクトを作成した後で、変更する必要がある事に気付く場合があります。プロジェクトを右クリックすると開くコンテクストメニューを使うと、MPLAB X IDE 内でプロジェクトを移動、コピー、リネームできます。プロジェクトを削除する事もできます。詳細はセクション 12.13.2「[Projects] ウィンドウ – [Project] メニュー」を参照してください。



外部ツールを使う事もできます。プロジェクトファイルの構造は、MPLAB X IDE を使わなくても問題ないようになっています。

8.10 プロジェクトの削除

MPLAB X IDE でプロジェクトを削除する方法

1. [Projects] ウィンドウでプロジェクト名を右クリックして [Delete] を選択する。

2. [Delete Project] ダイアログで、プロジェクトファイル ( または、プロジェクトファイルと全てのソースファイル ) をコンピュータから削除する。ソースファイルも削除するかどうかを選択して [Yes] をクリックする。

3. プロジェクトは削除され、MPLAB X IDE からは見えなくなる ( しかし、一部のmakefile 情報はコンピュータに残ります )。

全てのプロジェクトファイルをコンピュータから削除する方法

1. MPLAB X IDE 内でプロジェクトを削除する。またはプロジェクトを閉じる。

2. MPLAB X IDE を終了する ( 以下の Note を参照 )。3. これらのファイルを削除する。

Note: MPLAB X IDE は終了時に、プロジェクトに割り当てられた全てのリソースを解放する訳ではありません。MPLAB X IDEは Java上で動作しているため、リソースの解放は即座には行われません。Java では、ガーベジコレクション(GC) を呼び出すタイミングを JRE に決定させるのが善の方法です。しかし、メモリツールバーを有効にしてクリックする事で、GC を強制的に実行する事もできます。


MPLAB® X IDE
ユーザガイド
第 9 章トラブルシュート

9.1 はじめに

本章には、MPLAB X IDE の使用中に問題やエラーが発生した場合の対処に役立つ情報を記載しています。ここに記載した方法では対処できなかった場合は Microchip 社までお問い合わせください。連絡先は本書の「サポート」に記載しています。

• USB ドライバのインストールに関する問題

• 異なるプラットフォーム ( オペレーティングシステム ) で使う場合の問題

• Windows OS で使う場合の問題

• NetBeans プラットフォームの問題

• MPLAB X IDE の問題

• エラー

• フォーラム

9.2 USB ドライバのインストールに関する問題

正しい USB ドライバのインストール方法はセクション 2.3「USB ドライバ ( ハードウェアツール用 ) のインストール」を参照してください。

問題が生じた場合の対処方法はセクション 2.3.2.7「ツールの通信の問題」を参照してください。

9.3 異なるプラットフォーム ( オペレーティングシステム ) で使う場合の問題

MPLAB X IDE を複数の異なるプラットフォーム (Windows、Mac、Linux オペレーティングシステム ) で使う場合、以下の点に注意してください。

• 相対パスにはフォワードスラッシュ「/」を使う必要があります。バックスラッシュ「\」は、Windows OS プラットフォーム以外では使えません。例 : #includeheaders/myheader.h.

• Linux OS は大文字と小文字を区別します。従って generictypedefs.hとGenericTypeDefs.hは区別されます。

9.4 Windows OS で使う場合の問題

Windows オペレーティングシステムの大パス長は 260 文字です。Microsoft 社による説明は以下の URL をご覧ください。

https://msdn.microsoft.com/en-us/library/aa365247.aspx#maxpath

Windows は、ユーザが長過ぎるパスを作成する事を妨げようとしますが、特定のアプリケーション、カット & ペースト等で、260 文字を超えるパスを指定する事は可能です。しかし、プロジェクトのソースファイルが長過ぎるパスを使っている場合、プロジェクトは正常にビルドされません。

また、コマンドラインに関して以下の制約があります。

セクション 9.7.1「Command line too long (Windows XP 以降 )」


https://msdn.microsoft.com/en-us/library/aa365247.aspx#maxpath


9.5 NetBeans プラットフォームの問題

NetBeans プラットフォームのリリースバージョンによっては、MPLAB X IDE の使用に際して問題が生じる可能性があります。詳細は NetBeans ウェブサイトをご覧ください。

http://www.netbeans.org

以下も参照してください。

http://netbeans.org/community/releases/index.html

9.5.1 前景色として [Inherited] を選択すると、カテゴリのテキストがエディタ内で見えなくなる

フィールドの前景色 ([Foreground]) が [Inherited] の場合、ポップアップ完了ウィンドウ( ヒント ) 内のテキストが見えなくなります。ポップアップ完了ウィンドウには、未選択のエントリが白の背景上の白のテキストとして表示されます。一覧を下にスクロールすると、エントリごとに青の背景上の白のテキストで表示されます。それ以外の機能は正常に働いているように見えます。

この問題は Netbeans Bugzilla の [Fonts & Colors] の問題として登録されています。

https://netbeans.org/bugzilla/show_bug.cgi?id=249766[Options] > [Fonts & Colors]。[Syntax]タブの任意のカテゴリで前景色として[Inherited]を選択すると、エディタ内でテキストが見えなくなります。プリファレンス xml ファイル「org-netbeans-modules-editor-settings-CustomFontsColors-tokenColorings.xml」を見ると、問題のあるカテゴリ ( 例 : 「Field」、「Identifier」) の前景の属性に有効な色へのリンクが存在しない事が分かります。

回避策 :1. [Tools] > [Options]、[Fonts & Colors] ボタン、[Syntax] タブを選択する。

2. [Language] に [C] を選択する。

3. [Category] で [Field] をクリックする。

4. [Foreground] に [Inherited] が選択されている事を確認する。リストから任意の色を選択する。

5. [OK] をクリックする。


http://www.netbeans.org

http://netbeans.org/community/releases/index.html

https://netbeans.org/bugzilla/show_bug.cgi?id=249766

トラブルシュート

9.6 MPLAB X IDE の問題

下表に MPLAB X IDE の問題を示します。この表で問題の解決策が見つからない場合、プロジェクトのデバッグおよびコンパイルツールに関連する文書もご覧ください。

• MPLAB IDE v8 プロジェクトのインポート – 設定

• MPLAB IDE v8 プロジェクトのインポート – 変更されたリンカスクリプト

• Windows XP と読み込み可能プロジェクト / ファイル

• MPLAB C18 C コンパイラと構造

• プロジェクトがエンプティである / プロジェクトファイルが灰色表示されている

9.6.1 MPLAB IDE v8 プロジェクトのインポート – 設定

MPLAB IDE v8 のワークスペースに保存されている設定 ( ツール設定等 ) は、新しいMPLAB X IDE プロジェクトに転送されません。ワークスペースに保存されている情報については、MPLAB IDE v8 ヘルプ ([MPLAB IDE Reference] > [OperationalReference] > [Saved Information]) を参照してください。

9.6.2 MPLAB IDE v8 プロジェクトのインポート – 変更されたリンカスクリプト

MPLAB IDE v8プロジェクトのリンカスクリプトを変更してオブジェクトファイルをインクルードするようにしていた場合、MPLAB X IDE にインポートすると、リンカはそのファイルを見つける事ができません。MPLAB IDE v8 と MPLAB X IDE ではビルドパスが異なるからです。

従って、以下のようなエラーが表示されます。

<install path>ld.exe: cannot find file.oMPLAB IDE v8 では、ビルド関連ファイルが全て 1 つのフォルダに保存されるのに対し、MPLAB X IDE ではビルドファイルが別々のサブフォルダに保存されるためです。

既存のリンカスクリプトにワイルドカードを使うと、MPLAB X IDE でも動作させる事ができます。例えば、

/* Global-namespace object initialization - MPLAB v8*/ .init : { KEEP (crti.o(.init)) : } >kseg0_program_memというスクリプトを、以下のように編集します。

/* Global-namespace object initialization - MPLAB X*/ .init : { KEEP (*crti.o(.init)) : } >kseg0_program_mem

これとは別に、C コードに関数を配置できるアドレス属性を使う方法もあります。

int __attribute__((address(0x9D001000))) myfunction (void) {}

これによって、既定値のリンカスクリプトを変更する事なく、アドレスに関数を配置できます。



9.6.3 Windows XP と読み込み可能プロジェクト / ファイル

Windows XP の場合、[Add Loadable Project/File] ダイアログの [Store path as] の選択肢 [Auto] と [Absolute] は機能しません。[Relative] を使う必要があります。

9.6.4 MPLAB C18 C コンパイラと構造

RAM メモリ内の構造のポインタ値は、[Watches] ウィンドウ内では正しく表示されません。これは、コンパイラが完全なデバッグ情報を保存しないためです。この問題の回避策は、MPLAB XC8 C コンパイラを代わりに使う事です。

9.6.5 プロジェクトがエンプティである / プロジェクトファイルが灰色表示されている

破損したプロジェクトを読み込み、かつダイアログの質問の答えを間違えた場合、[Projects] ウィンドウが灰色表示され、「ソースファイルがないためプロジェクトをビルドできない」というメッセージが表示されます。

図 9-1: プロジェクトエンプティエラー

この問題は、破損したプロジェクトを MPLAB X IDE に読み込んだ場合に発生します。Cソースファイルをヘッダファイルに関連付けられるかどうか尋ねるダイアログが表示されます。この時点で [No] (既定値 )をクリックする事で、この問題を回避できます。

図 9-2: [New Header Extension] ダイアログ



しかし、[Yes] をクリックするとソースファイルがヘッダファイルとして認識されてしまい、プロジェクトは空のように見えます。プロジェクトを修復するため、以下のどちらかの方法が使えます。

• MPLAB X IDE を終了する。

• [Help] > [About] ダイアログで指定されている MPLAB X IDE のユーザフォルダに移動し、MPLAB X IDE の使用中のバージョンのフォルダを削除する ( 例えば、フォルダv3.05をC:\Users\UserName\AppData\Roaming\mplab_ide\dev\v3.05から削除します )。

• MPLAB X IDE を再起動する。

または

• [Tools] > [Options]を選択し、[Embedded]ボタンをクリックし、[Other]タブを開く。

• ヘッダファイルの関連付けから「c」を削除する。

• ソースファイルの関連付けに「c」を追加する。

• [OK] をクリックする。



9.7 エラー

IDE は様々な形でエラーを示しますが、多くの場合ウィンドウ内のアイコンまたは[Output] ウィンドウ内のメッセージとしてエラーを表示します。アイコンにカーソルを合わせると、問題の内容を示すメッセージが表示されます。テキストメッセージについては、オンラインヘルプで該当するエラーを検索してください。

IDE とエディタの一般的なエラーと解決方法を以下に示します。

• Command line too long (Windows XP 以降 )• Couldn’t reserve space for Cygwin™ heap (Windows 7 または 8)• Could not access the URL through the external browser. Check the browser

configuration• Destination Path Too Long/The filename or extension is too long (Windows OS)• The project ProjectName is empty• For 8-bit code, #asm and #endasm cause red bangs in the Editor window• For 16-bit code, MPLAB XC16 packed attribute statement causes red bangs in the

Editor window• HEXMATE Conflict Report Address Error• プログラムエラー

9.7.1 Command line too long (Windows XP 以降 )プロジェクトの makefile 実行時、各コマンドはローカルネイティブシェルに渡されます。Windows XP 以降の OS では、8191 文字という制限があります。従って、数百 C ファイルをリンクするプロジェクトでは、この制限を超えて上記のエラーが表示される事があります。

Linux OS と Mac OS X は、通常非常に長いコマンドラインを扱う事ができます。使用中のシステムでその長さを調べるには、コマンドラインで getconf ARG_MAX を入力します。

応答ファイルを使った回避策

MPLAB XC8/MPLAB XC32 C コンパイラの v1.01 以降、MPLAB XC16 C コンパイラの v1.22 以降の場合、リンカを呼び出す際に応答ファイルを使えば、この問題を回避できる場合があります。

• MPLAB XC8 の場合、[Project Properties] ウィンドウを開き ([File] > [ProjectProperties])、[Categories] の [XC8 linker] をクリックする。[Option categories] で[Additional Options] を選択する。[Use response file to link] にチェックを入れる。

• MPLAB XC16 の場合、[Project Properties] ウィンドウを開き ([File] > [ProjectProperties])、[Categories]の[xc16-ld]をクリックする。[Option categories]で[General]を選択する。[Use response file to link] にチェックを入れる。

• MPLAB XC32 の場合、[Project Properties] ウィンドウを開き ([File] > [ProjectProperties])、[Categories]の[xc32-ld]をクリックする。[Option categories]で[General]を選択する。[Use response file to link] にチェックを入れる。

ライブラリによる回避策

その他全てのコンパイラの場合、MPLAB X IDE ライブラリプロジェクトを作成し、メインプロジェクトからライブラリプロジェクトにいくつかのソースファイルを移動します。その後、ライブラリプロジェクトをメインプロジェクトに追加する事で、この問題を回避できます。

ライブラリプロジェクトを作成するには、[File] > [New Project] を選択し、[MicrochipEmbedded] カテゴリをクリックし、プロジェクトとして [Library project] を選択します。

ライブラリをメインプロジェクトに追加するには、[Project Properties] ウィンドウを開き ([File] > [Project Properties])、[Categories] の [Libraries] を選択し、[Add LibraryProject] ボタンをクリックします。



アーカイブチェックボックスによる回避策

現在では全ての MPLAB XC16 と MPLAB XC32 は、長いファイルセットをライブラリにアーカイブする際にリンク行が文字数の制限を超える可能性がある場合に使えるチェックボックスを備えています。「Break into multiple lines」を使ってアーカイブ行を短い行に分割し、この制限を回避するようにコンパイラを設定できます。

このオプションは、[Project Properties] ウィンドウで [xc16-ar] または [xc32-ar] カテゴリを選択した後、[General] オプションカテゴリの [Break into multiple lines] チェックボックスで設定します。

9.7.2 Couldn’t reserve space for Cygwin™ heap (Windows 7 または 8)MPLAB X IDE は、make 処理に Cygwin MinGW を使います。Windows 7 または 8 では、仮想メモリの割り当てエラーが発生する可能性があります。

仮想メモリの設定を変更するには、[ スタート ] > [ コントロールパネル ] をクリックしてコントロールパネルを開き、[ システム ] をクリックし、[ システムとセキュリティ] > [ システム ] > [ システムの詳細設定 ] または [ システムの保護 ] を選択します。[ 詳細設定 ] タブで、[ パフォーマンス ] の [ 設定 ] ボタンをクリックします。このダイアログで、[ 詳細設定 ] タブをクリックし、[ 変更 ] ボタンをクリックします。[ カスタムサイズ ] に以下の値を入力します。 • 初期サイズ (MB) = 「現在の割り当て」の値 ( 下段に表示されている値 ) • 大サイズ (MB) = 「推奨」の値 ( 下段に表示されている値 ) [ 設定 ] をクリックし、[OK] をクリックしてから、PC を再起動します。

9.7.3 Could not access the URL through the external browser. Check the browser configuration

MPLAB X IDE で [Tools] > [Options] を選択し、[General] タブを開きます。[WebBrowser] ドロップダウンリストから使用中のブラウザを選択して、[OK] をクリックします。

詳細は以下を参照してください。

「Bug 21236 – Ext-Browser: Message “Could not access the URL” to guide from Toolsmenu」:http://netbeans.org/bugzilla/show_bug.cgi?id=21236

「Bug 38211 – A problem with using IE external browser in the IDE」:http://netbeans.org/bugzilla/show_bug.cgi?id=38211

9.7.4 Destination Path Too Long/The filename or extension is too long (Windows OS)

Windows OS の大パス長は 260 文字です。詳細はセクション 9.4「Windows OS で使う場合の問題」を参照してください。

9.7.5 The project ProjectName is empty

セクション 9.6.5「プロジェクトがエンプティである / プロジェクトファイルが灰色表示されている」を参照してください。


http://netbeans.org/bugzilla/show_bug.cgi?id=21236

http://netbeans.org/bugzilla/show_bug.cgi?id=38211


9.7.6 For 8-bit code, #asm and #endasm cause red bangs in the Editor window

#asm文と#endasm文は、HI-TECH PICCまたはMPLAB XC8 Cプログラム内でインラインアセンブリコードを宣言するのに有効な構造です。しかし IDE のエディタでは、C プリパーサはこれらを有効なディレクティブとは認識せず、これらの文の隣に赤の感嘆符を表示します。しかし、このコードはこのままでも動作します。

エディタ内の赤の感嘆符を除去する場合、asm() 文を使えます。これは、全てのMPLAB XC C コンパイラでインラインアセンブリを使う際に推奨する方法です。

例 :// Inline Code that causes error #asm movlw 0x20; nop; nop; #endasm

// Workaround for inline assembly - that will not cause error// (Multi line asm code) asm("\ movlw 0x20;\ nop;\ nop;");

// Workaround for inline assembly - that will not cause Error// (Single line asm code) asm("movlw 0x20; nop; nop");

9.7.7 For 16-bit code, MPLAB XC16 packed attribute statement causes red bangs in the Editor window

コンパイラのパーサは以下の文をエラーとしてマーク表示します。しかし、これらの文はビルドされます。

unsigned long long Bits8 : 8 __attribute__ ((packed));修飾子に対するパーサのルールでは順序は決まっていません。通常は修飾子は全て識別子の前に指定します。従って、これらの文は望ましい形式であり、エラーは発生しません。

unsigned long long attribute ((packed)) Bits8 : 8;または

attribute ((packed)) unsigned long long Bits8 : 8;



9.7.8 HEXMATE Conflict Report Address Error

HEXMATE が競合レポートを生成した場合、HEX ファイル内の競合アドレスがデータが格納されているメモリの [Memory] ウィンドウに表示されるアドレスと異なる場合があります。以下に例を示します。

9.7.9 プログラムエラー

デバイスが意図せずにコード保護されていた場合、特定のアドレス領域に対してプログラミングエラーが出力されます。

[Erase Device Memory Main Project] 機能は、これがプログラミングの問題かどうかを判断するのに役立ちます。この機能を利用するには追加アイコン ( セクション 6.9

「ツールバーのカスタマイズ」) または MPLAB IPE を使います。

1. コード内でコード保護が無効になっている事を確認する。

2. デバイスメモリを消去する ( これによりコンフィグレーションビットの設定が消去されます )。

3. デバイスを再プログラミングする。

プログラミングが正常終了した場合、コード保護が原因であった事が分かります。

表 9-1: HEX アドレスとメモリアドレスの関係

デバイスファミリ HEX ファイル内のアドレスメモリ内のアドレス

ベースライン 0x100 0x80*ミッドレンジ 0x100 0x80*PIC18 MCU 0x100 0x10016 ビットデバイス 0x100 0x80*32 ビットデバイス 0x100 0x100* デバイスによっては、競合レポートに表示されたアドレスはメモリ内のデータのアドレスの 2 倍の値となります。

[Erase Device Memory Main Project] アイコン



9.8 フォーラム

上記では問題の解決策が見つからない場合、以下の Microchip 社フォーラムもご覧ください。

http://www.microchip.com/forums/f238.aspx

このフォーラムには、問題に関するディスカッションや近投稿された解決策が掲載されています。


http://www.microchip.com/forums/f238.aspx

MPLAB® X IDE
ユーザガイド
第 10 章 MPLAB X IDE と MPLAB IDE v8 の相違点

10.1 はじめに

MPLAB X IDE は MPLAB IDE v8 以前のバージョンから大きく変更されています。本章には、MPLAB X IDE に移行する際に役立つ情報を記載しています。

• 主な相違点

• メニューの相違点

• ツールのサポートに関する相違点

• その他の注意事項

10.2 主な相違点

MPLAB X IDEはNetBeansプラットフォームを使っているため、多くの機能がMPLABIDE v8 とは異なります。詳細は以下を参照してください。

• 第 2 章「使用前の準備」

• 第 3 章「チュートリアル」

• 第 5 章「追加作業」

機能的相違点を以下にまとめます。

1. MPLAB X IDE はオープンソースのクロスプラットフォーム NetBeans を使っています。サードパーティは、プラグインとして機能を容易に追加できます。Microchip 社製品固有の MPLAB X IDE コンポーネントは、当社独自の機能です。

MPLAB IDE v8 は独自プラットフォームで Windows オペレーティングシステムベースです。サードパーティは、MPLAB 開発グループからの設計情報に基づいて機能を v8 に追加できます。

2. MPLAB X IDE はプロジェクトベースです ( ワークスペースを使いません )。MPLAB X IDE でアプリケーションを開発する場合、プロジェクトを作成する必要があります。プロジェクトを作成するには、デバイス、言語 / デバッグ / プログラミングツールとその他のプロジェクト仕様を選択および設定する必要があります。これにより、アプリケーションの開発に必要な全てのアイテムを確保します。1 つのプロジェクトに複数のコンフィグレーションを設定する事が可能です。

MPLAB IDE v8 はデバイスベースです。v8 でも、プロジェクトを使ってアプリケーションを作成する事を強く推奨しますが、必須ではありません。ワークスペースは、一部の設定情報 ( 複数プロジェクトのグループ化等 ) を格納するために使います。

プロジェクトの機能には大幅な変更が加えられているため第 3 章「チュートリアル」をお読み頂く事を推奨します。

3. MPLAB X IDE では、複数のツールを選択できます。

例 1: 複数台の MPLAB ICD 3 デバッガを、コンピュータの複数の USB ポートに接続し、[Project Properties] ダイアログでこれらのデバッガを容易に切り換える事ができます。デバッガはシリアル番号 (SN) で識別します。

例2:ターゲットボードに接続した1台のMPLAB ICD 3デバッガと1台のMPLABPM3 プログラマを、それぞれコンピュータの USB ポートに接続し、[ProjectProperties] ダイアログでこれらのツールを容易に切り換える事ができます。

MPLAB IDE v8 では、複数のツールを選択する事はできません。



4. MPLAB X IDE では、言語ツールの複数のバージョンを選択できます。

例 : PIC18 MCU向けMPLAB Cコンパイラの 2つのバージョンをインストールし、[Project Properties] ダイアログでコンパイラツールチェーンのバージョンを容易に切り換える事ができます。

MPLAB IDE v8 では、複数の言語ツールバージョンを選択する事はできません。

5. MPLAB X IDE では、複数のデバッグとプログラミングセッションを実行できます。MPLAB X IDE では、複数のデバッグセッションを 1 つの IDE でアクティブにする事ができます。詳細はセクション 6.3「複数プロジェクトを使った作業」を参照してください。

MPLAB IDE v8 では、デバッグまたはプログラミングセッションを 1 つしか実行できません。MPLAB IDE v8 でも IDE で複数のプロジェクトを開く事はできます。しかし、複数のプロジェクトを同時にデバッグまたはプログラミングする事はできません。

6. MPLAB X IDE では、複数のビルドコンフィグレーションを使えます。MPLAB XIDE では、複数のビルドコンフィグレーションを使えます。詳細はセクション6.4「複数コンフィグレーションを使った作業」を参照してください。

MPLAB IDE v8 で使えるコンフィグレーションは 2 つだけです。MPLAB IDEv8 では、[Build Configuration] ドロップダウンボックスから [Release] または[Debug] のどちらかしか選択できず、コード内で __DEBUGを使いました。

セクション 6.4.2「複製したコンフィグレーションの追加」の説明に従ってユーザ独自のデバッグコンフィグレーションと __DEBUG マクロを作成する事により、MPLAB IDE v8 の機能を MPLAB X IDE でも再現できます。

7. MPLAB X IDE は、デバッグとプログラミングにマルチステップのオプションを備えています。MPLAB X IDE には [Debug Project] アイコンがあり、ビルド、プログラムとデバッグ実行プログラムによるターゲットデバイスのプログラミング ( ハードウェアツールの場合 )、コードのデバッグ実行を、1 クリックで実行できます。ビルド、ターゲットデバイスのプログラミング ( ハードウェアツールの場合 )、コード実行を 1 クリックで実行できる [Make and Program] アイコンも備えています。make 処理とプログラミングの後にプログラムを実行したくない場合、上記のアイコンの代わりに、[Hold in Reset] アイコンを使います。

MPLAB IDE v8 では、デバッグまたはプログラミングにいくつかの手動のステップが必要でした。MPLAB IDE v8 には、デバッグまたはコード実行の前に完了しておくべき以下の手順がありました。 a) 正しいビルド設定 ([Release] または [Debug]) を選択する。

b) コードをビルドまたは make する。

c) その(ハードウェアツールに適合した)コードでターゲットをプログラミングする。

d) コードを実行する。

MPLAB スタータキット等、一部のツールでは依然として別々に実行する必要のあるステップがあります。MPLAB X IDE では、この機能を [Debug] > [DiscreteDebugger Operation] によって提供します。

8. MPLAB X IDE では、コード内に設定されたコンフィグレーションビットを使います。MPLAB X IDE では、コンフィグレーションビットをコード内で設定する必要があります。しかし、デバッグセッションで [Configuration bits] ウィンドウからコンフィグレーションビットを一時的に変更し、それらの設定をファイルに保存しておいて、後ほどコードに貼り付ける事ができます ( セクション 4.22.4「コンフィグレーションビットの設定」参照 )。MPLAB IDE v8 では、コードまたはウィンドウで設定したコンフィグレーションビットを使っていました。MPLAB IDE v8 では、コンフィグレーションビットをコードまたは [Configuration bits]ウィンドウのどちらでも設定できました。しかし、ウィンドウからの設定は、後ほど手動でコードに入力する必要がありました。


MPLAB X IDE と MPLAB IDE v8 の相違点

9. MPLAB X IDE の場合、デバッグツールはセッション中のみ接続されます。MPLABX IDEはデバッグ /プログラマツールをデバッグ /プログラミング実行中のみターゲットに接続します。それ以外の期間は切り離します。

MPLAB IDE v8 では、デバッグツールが常時接続されていました。MPLAB IDEv8 では、デバッグツールとプログラマツールが選択されるとすぐに接続していました。このため、複数セッションを同時実行できませんでした。

もし MPLAB X IDE で、MPLAB IDE v8 のようにツールを常時接続しておきたい場合、[Tools] > [Options] (Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Embedded] ボタンをクリックし、[Generic Settings] タブを開いて、[Maintain active connection to hardware tool] にチェックマークを付けます。

10. MPLAB X IDE の情報は 1 つの表示に統合されています。MPLAB X IDE には、ブレークポイントリソース、チェックサム、メモリゲージ情報を収めた[Dashboard] ウィンドウがあります。セクション 5.18「ダッシュボードの表示」を参照してください。このウィンドウは、プロジェクトの情報を 1ヶ所にまとめて表示します。

MPLAB IDE v8 の情報は、複数の表示に分散されていました。MPLAB IDE v8には、ブレークポイントリソースのツールバー、チェックサムのツールバー、メモリゲージのウィンドウがあり、それぞれへのアクセス方法も異なりました。

11. MPLAB X IDE は、NetBeans の機能を多数備えています。MPLAB X IDE は、NetBeans の編集とデバッグの機能を多数備えています。詳細は NetBeans のヘルプを参照してください。MPLAB X IDE は、ベースとなっている NetBeansプラットフォームを定期的に更新します。それに伴い、IDE にも NetBeans の新機能が導入されます。MPLAB X IDE の各バージョンがベースとしているNetBeans プラットフォームのバージョンは、リリースノートに記載しています。

MPLAB IDE v8 は独自の機能を備えていました。MPLAB IDE v8 は独自製品でした。そのため、サードパーティとコミュニティによる開発は困難でした。



10.3 メニューの相違点

下表に、MPLAB IDE v8 から MPLAB X IDE へのメニューの変更点を示します。MPLABX IDE と MPLAB IDE v8 のメニュー項目は一対一に対応しません。主な相違点を表の

「コメント」列に記載しています。

MPLAB X IDE で追加されたメニュー項目もあります。詳細は NetBeans ヘルプトピックを参照してください。

表 10-1: [File] メニューの相違点

MPLAB® IDE v8 MPLAB® X IDE コメント

New File>New File ファイルウィザードで関連するプロジェクトを選択します。Add New File to Project

Open File>Open FileClose File>CloseSave File>SaveSave As File>Save AsSave All File>Save AllOpen Workspace 利用不可全てのデータはプロジェクトに

保存されます。Save WorkspaceSave Workspace AsClose WorkspaceImport File>Import プリビルドした HEX/ELF ファ

イル、MPLAB IDE v8 プロジェクト、その他の組み込みプロジェクトのインポートに便利です。

Export 利用不可既定値設定では、プロジェクトのHEXファイルはプロジェクトフォルダ (「dist」 > 「default」 >

「production」フォルダ ) に格納されています。

Print File>PrintFile>Print to HTMLFile>Page Setup

Recent Files File>Open Recent FileRecent Workspaces 利用不可全てのデータはプロジェクトに

保存されます。

Exit File>Exit



表 10-2: [Edit] メニューの相違点


Undo Edit>UndoRedo Edit>RedoCut Edit>CutCopy Edit>CopyPaste Edit>Paste

Edit>Paste FormattedDelete Edit>DeleteSelect All Edit>Select All

Edit>Select IdentifierFind Edit>Find

Edit>Find SelectionFind Next Edit>Find Next

Edit>Find PreviousFind In Files Edit>Find in Projects

Edit>Replace in ProjectsReplace Edit>ReplaceGo To Navigate>Go to Line

Navigate>Go to DeclarationGo To Locator Navigate>Go to SymbolGo Backward Navigate>BackGo Forward Navigate>ForwardExternal DIFF Tools>Diff 以下も参照してください。[Tools] >

[Options] (Mac OS X の場合、[mplab_idePreferences])、[Miscellaneous] の [Diff] タブ

Advanced Source>FormatSource>Shift Left/RightSource>Move Up/DownSource>Toggle Comment

Bookmarks Navigate>Toggle BookmarkNavigate>Next BookmarkNavigate>Previous Bookmark

Properties Tools>Options>Editor アイコンTools>Options>Fonts & Colorsアイコン

Mac OS X の場合、[Tools] > [Options] の代わりに[mplab_idePreferences] を使います。



表 10-3: [View] メニューの相違点


Project Window>ProjectsOutput Window>OutputToolbars View>ToolbarsCPU Registers** Window>PIC Memory

Views>CPUCall Stack Window>Debugging>Call StackDisassembly Listing Window>Debugging>Output>Di

sassembly Listing FileEEPROM Window>PIC Memory Views>EE

Data MemoryFile Registers* Window>PIC Memory

Views>Data MemoryFlash Data Window>PIC Memory

Views>Data MemoryHardware Stack Debug>StackLCD Pixel 利用不可

Locals Window>Debugging>VariablesMemory** Window>PIC Memory

Views>Execution MemoryProgram Memory* Window>PIC Memory

Views>Flash MemorySFR/Peripherals** Window>PIC Memory

Views>PeripheralsSpecial Function Registers*

Window>PIC Memory Views>SFRs

Watch Window>Debugging>Watches 以下も参照してください。[Debug] > [New Watch]

Memory Usage Gauge Window>DashboardTrace Window>Debugging>Trace 以下も参照してください。

[File] > [Project Properties] でトレースを有効にします。

* 8 ビットおよび 16 ビットデバイス** 32 ビットデバイス



表 10-4: [Project] メニューの相違点


Project Wizard File>New Project プロジェクトの新規作成時に起動します。New

Open File>Open ProjectFile>Open Recent Project

Close File>Close ProjectSet Active Project Run>Set Main ProjectQuickbuild 利用不可全ての開発にプロジェクトが必

要です。

Package in .zip [Projects] ウィンドウ内のプロジェクトを右クリックして[Package] を選択する

Clean [Projects] ウィンドウ内のプロジェクトを右クリックして[Clean] または [Clean and Build]を選択する

Locate Headers [Projects] ウィンドウ内のプロジェクトを右クリックして[Locate Headers] を選択する

Export Makefile 利用不可補遺 B「IDE 外部での作業手順」を参照してください。

Build All Run>Run ProjectDebug>Debug Project

プログラマによるビルド / 実行デバッガによるビルド / 実行Make

ビルドコンフィグレーション

[File] > [Project Properties] で、[Manage Configurations] をクリックする

MPLAB IDE v8 では 2 つのコンフィグレーションしかありませんでした。[Release] と [Debug]です。MPLAB X IDE では、必要な数だけ使えます。

Build Options [File] > [Project Properties] で、ツールスイートのツールをクリックする

言語ツールを設定します。

Save Project File>SaveFile>Save All

Save Project As File>Save AsAdd Files to Project [Projects] ウィンドウ内のプロ

ジェクトフォルダを右クリックして[Add Existing Item]を選択する

Add New File to Project [Projects] ウィンドウ内のプロジェクトフォルダを右クリックして [New] を選択する

Remove File from Project [Projects] ウィンドウ内のプロジェクトファイルを右クリックして[Remove From Project]を選択する

Select Language Toolsuite

File>New ProjectFile>Project Properties

Set Language Tool Locations

[Tools] > [Options] の[Embedded] タブの [Build Tools]を選択する

Mac OS X の場合、[Tools] > [Options] の代わりに[mplab_idePreferences] を使います。

Version Control [Team] メニューの項目プラグインとしてその他のバージョン管理も利用できます。



表 10-5: [Debugger] メニューの相違点


Select Tool File>New ProjectFile>Project Properties

新規に選択します。既存の選択を変更します。

Clear Memory 利用不可 ([Fill Memory] を使います。)

[Window] > [PIC Memory Views]のプルダウンメニューで [Memory]ウィンドウを選択し、ウィンドウ内を右クリックして [Fill Memory]選択します。

Run Run>Run ProjectDebug>Debug ProjectDebug>Continue

プログラマによる実行です。デバッガによる実行です。一時停止後の実行再開です。

Animate 利用不可

Halt Debug>PauseStep Into Debug>Step IntoStep Over Debug>Step OverStep Out Debug>Step OutReset Debug>ResetBreakpoints Debug>New Breakpoint

Debug>Toggle Breakpointコード行の隣の [ ガーター ] をクリックして、コードにブレークポイントを設定します。

Settings File>Project PropertiesStopwatch Window>Debugging>Stopwatch

表 10-6: [Programmer]* メニューの相違点


Select Programmer File>New ProjectFile>Project Properties


Enable Programmer 利用不可 ( プログラミング時に自動的に有効になります。)

[Tools] > [Options] で [Embedded]ボタンをクリックし、[GenericSettings] タブで [Maintain activeconnection to hardware tool] にチェックを入れた場合は除きます。

Disable Programmer 利用不可 ( プログラミング時に自動的に無効になります。)

Program Make and Program Device [Run] ツールバーから選択します。

Verify 利用不可 MPLAB IPEを参照してください。

Read Read Device Memory [Run] ツールバーから選択します。

Blank Check All 利用不可 MPLAB IPEを参照してください。

Blank Check OTP 利用不可 MPLAB IPEを参照してください。

Erase Flash Device カスタムツールバーで利用可能セクション 6.9「ツールバーのカスタマイズ」と MPLAB IPE を参照してください。

Reset Program Statistics 利用不可 MPLAB IPEを参照してください。

Download OS [File] > [Project Properties]ダイアログの [Categories] でデバッグツールを選択し、[Option categories]で [Firmware]を選択する

IDE が新ファームウェアを自動選択します。

Settings File>Project Properties* プログラマについては MPLAB IPE も参照してください。



表 10-7: [Tools] メニューの相違点


Data Monitor and Control Interface (DMCI) and other plugins

Tools>PluginsTools>Embedded

ツールをインストールします。ツールを使います。

MPLAB® Macros Edit>Start Macro RecordingEdit>Stop Macro Recording

記録した後、マクロ名とショートカットを入力できます。

RTOS Viewer Tools>PluginsTools>Embedded

ツールをインストールします。ツールを使います。

表 10-8: [Configure] メニューの相違点


Select Device File>New ProjectFile>Project Properties


Configuration Bits Window>PIC Memory Views>Configuration Bits

External Memory Window>PIC Memory Views>Program Memory

外部メモリはプログラムメモリの一部として表示されます。

ID Memory Window>PIC Memory Views>User ID Memory

Settings Tools>Options Mac OS X の場合、[Tools] > [Options] の代わりに[mplab_idePreferences] を使います。

表 10-9: [Window] メニューの相違点


Close All Window>Close All DocumentsCascade 利用不可文書管理については [Window] >

[Documents]を参照してください。Tile HorizontallyTile VerticallyArrange IconsWindow SetsCreate Window SetDestroy Window SetRecent Windows



表 10-10: [Help] メニューの相違点


Topics Help>Contents PDF の表示についてはセクション 8.2「[Projects] ウィンドウの表示」参照してください。

Release Notes Help>Online Docs and Support

Driver Installation Help>Online Docs and Support

Check for Updates 利用不可新情報は、Microchip 社ウェブサイトをご覧ください。

Web Links Help>Online Docs and Support

About MPLAB® IDE Help>About



10.4 ツールのサポートに関する相違点

下の Microchip 社製開発ツールの一覧表に、MPLAB X IDE におけるサポートの有無を示します。

表 10-11: MPLAB X IDE におけるツールのサポート

開発ツール MPLAB® X IDE でのサポート

PICkit™ 3

PICkit 2

PICkit 1

MPLAB® ICD 3

MPLAB ICD 2

MPLAB REAL ICE™ インサーキットエミュレータ

MPLAB ICE 2000

MPLAB ICE 4000

MPLAB PM3

PRO MATE II

PICSTART® Plus

MPLAB VDI

表 10-12: MPLAB X IDE におけるプラグインのサポート

プラグイン * MPLAB® X IDE でのサポート

DMCI

dsPIC® Filter Design**

dsPICworks Data Analysis**

Graphical Display Designer

KEELOQ® Plugin

メモリスタータキット

PC-Lint

RTOS Viewer



10.5 その他の注意事項

MPLAB IDE v8 から MPLAB X IDE への移行の際のその他の注意事項を以下に示します。

• セクション 9.6「MPLAB X IDE の問題」

AN851 ブートローダ

AN901 BLDC チューニングインターフェイス

AN908 ACIM チューニングインターフェイス

dsPIC30F SMPS 降圧型コンバータ

dsPIC33F SMPS 昇降圧型コンバータ

MATLAB®/Simulink®

Segmented Display Designer

* 利用できるプラグインを表示するには、[Tools] > [Plugins] の [Available Plugins] タブを選択します。** Windows® オペレーティングシステムのみに対応しています。

表 10-12: MPLAB X IDE におけるプラグインのサポート ( 続き )プラグイン * MPLAB® X IDE でのサポート


MPLAB® X IDE
ユーザガイド
第 11 章デスクトップの詳細

11.1 はじめに

MPLAB® X IDE デスクトップは、他のデスクトップアイテムとは独立して動作するサイズ変更可能なウィンドウです。デスクトップはメニュー、ツールバー、ステータスバー、タブ形式のウィンドウで構成されます ( 図 11-1)。本章ではメニュー、ツールバー、ステータスバーについて説明します。ウィンドウとダイアログについては次章で説明します。

• メニュー

• Toolbars• ステータスバー

• メニュー項目とボタンの灰色表示または非表示

図 11-1: MPLAB® X IDE のデスクトップ

Note: NetBeans ヘルプトピックで「workspace」と書かれている場合、それは「デスクトップ」の事を意味します。この「workspace」は、MPLAB IDEv8 以前のバージョンの「ワークスペース」の事ではありません。

MENUS TOOLBARS

STATUS BAR

WINDOWS

2011-2015 Microchip Technology Inc. DS50002027D_JP - p.215


11.2 メニュー

MPLAB® X IDE の多くの機能は、デスクトップ上段にあるメニューバーからメニュー項目として選択できます。メニュー項目の右側に「...」が付く場合、その項目を選択するとダイアログが開きます。ダイアログの詳細は第 12 章「MPLAB X IDE のウィンドウとダイアログ」を参照してください。

メニュー項目の横にはショートカットキーも表示されます例 : [New File] のショートカットキーは <Ctrl>+<N> です。ショートカットキーの詳細は [Help] > [KeyboardShortcuts Card] を参照してください。

メニュー項目は状況に応じて無効化 ( 灰色表示 ) される場合があります。セクション11.5「メニュー項目とボタンの灰色表示または非表示」を参照してください。

ウィンドウ内で右クリックすると、コンテクストメニューが表示されます。これらのメニューの詳細は本書のセクション 12.13「[Projects] ウィンドウ」を参照してください。

メニュー一覧を以下に記載します。

• [File] メニュー

• [Edit] メニュー

• [View] メニュー

• [Navigate] メニュー

• [Source] メニュー

• [Refactor] メニュー

• [Run] メニュー

• [Debug] メニュー

• [Team] メニュー

• [Tools] メニュー

• [Window] メニュー

• [Help] メニュー

Note: [Start Page] で [My MPLAB IDE] > [Extend MPLAB] > [Selecting Simple orFull-Featured Menus] を選択すると、全てのメニューとメニュー項目を表示できます。それらのメニュー項目には、組み込みシステムの開発では使わない項目も含まれています。

DS50002027D_JP - p.216 2011-2015 Microchip Technology Inc.

デスクトップの詳細

11.2.1 [File] メニュー

下表に [File] メニューの項目を示します。

これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-1: [File] メニューの項目

コマンド動作

New Project [New Project] ウィザードを使ってプロジェクトを新規作成します。

New File [New File] ウィザードを使ってファイルを新規作成します。


Open Recent Project 近開いた全てのプロジェクトの一覧を表示します。

Import 以下のいずれかをインポートします。Hex/ELF...(Prebuilt) File – 別のツールを使ってビルドしたファイルMPLAB IDE v8 Project – [Import Legacy Project] ウィザードを起動その他の組み込み – その他の組み込みプラットフォームからのインポートZIP から – アーカイブしたプロジェクトからのインポート ( ファイルを解凍してインポート )

Close Project 現在のプロジェクトを閉じます。

Close Other Projects メインプロジェクト以外の全プロジェクトを閉じます。

Close All Projects 開いている全てのプロジェクトを閉じます。

Open File 既存のファイルを開きます。

Open Recent File ファイルを選択するために、近開いた全てのファイルの一覧を表示します。

Project Group 現在のプロジェクトをグループに割り当てます。

Project Properties [Project Properties] ダイアログを開きます。

Export Project 現在のプロジェクトをエクスポートします。To zip – 現在のプロジェクトファイルをアーカイブします。

Save 現在のファイルを保存します。

Save As 現在のファイルを、パス / 名前を変更して保存します。

Save All 開いている全てのファイルを保存します。 [Compile on Save] オプションを選択した場合、保存時にプロジェクトファイルをコンパイル / ビルドします。

Page Setup 印刷用にページを設定します。 Print 現在のファイルを印刷します ( プレビュー付き )。Print to HTML 現在のファイルを HTML 形式で書き出します。

Exit MPLAB® X IDE を終了します。



11.2.2 [Edit] メニュー

下表に [Edit] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-2: [Edit] メニューの項目

コマンド動作

Undo 以前のエディタ操作を 1つずつ遡って取り消します (保存操作は取り消せません )。

Redo 以前の [Undo] 操作を 1 つずつ元に戻します。

Cut 現在選択している内容を削除し、クリップボードに移動します。

Copy 現在選択している内容をクリップボードにコピーします。

Paste クリップボードの内容を現在の選択位置に挿入します。

Paste Formatted クリップボードの内容を、書式設定付きで現在の選択位置に挿入します。

Paste from History コピー履歴の内容を現在の選択位置に挿入します。

Delete 現在選択している内容を削除します。

Select All 現在の文書またはウィンドウ内の全ての内容を選択します。

Select Identifier カーソルにも近い単語を選択します。

Find Selection 現在選択している内容に一致するインスタンスを検索します。

Find Next 一致するテキストのインスタンスを順方向に検索します。

Find Previous 一致するテキストのインスタンスを逆方向に検索します。

Find 文字列を検索します。

Replace 文字列を検索し、一致した文字列を指定した別の文字列に置換します。

Find Usages 選択したコードが使われている箇所とサブタイプを検索します。

Find in Projects 指定したテキスト、オブジェクト名、オブジェクトタイプをプロジェクト内で検索します。

Replace in Projects テキスト、オブジェクト名、オブジェクトタイプをプロジェクト内で置換します。

Start Macro Recording マクロ用のキー操作の記録を始めます。

Stop Macro Recording キー操作の記録を終了します。マクロを管理するには、[Tools] > [Options] を選択し、[Editor] ボタンをクリックし、[Macros] タブを開きます。



11.2.3 [View] メニュー

下表に [View] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-3: [View] メニューの項目

コマンド動作

Editors ファイルを表示するエディタを選択します。History – このファイルの編集履歴を表示します。Source – このファイルのソースコードを表示します。

Split 現在のエディタウィンドウを、垂直または水平方向に 2 分割します。

Code Folds>Collapse Fold カーソル位置が折り畳み可能なテキスト内である場合、そのセクションを折り畳みます。

Code Folds>Expand Fold カーソル位置が折り畳まれたセクションである場合、そのセクションを展開して表示します。

Code Folds>Collapse All 折り畳み可能なテキストセクションを全て折り畳みます。

Code Folds>Expand All 折り畳まれているテキストセクションを全て展開します。

Code Folds>Collapse Fold Tree

ネスティングされた複数の折り畳みを全て折り畳みます。

Code Folds>Expand Fold Tree

ネスティングされた複数の折り畳みを全て展開します。

Web Browser 既定値のウェブブラウザを開いて、NetBeans ホームページを表示します。

IDE Log [Output] ウィンドウのタブにログファイルを開きます。

Toolbars>File, etc. 関連ツールバーを表示します。

Toolbars>Small Toolbar Icons ツールバーのアイコンを小さくします。

Toolbars>Reset Toolbars ツールバーを既定値の状態に戻します。

Toolbars>Customize 既存ツールバーのカスタマイズまたはツールバーを新規作成できます。

Show Editor Toolbar [File] タブにエディタのツールバーを表示します。

Show Line Numbers 左の余白に行番号を表示します。

Show Non-printable Characters

印刷できない文字 ( 非 ASCI) であっても表示します。

Show Breadcrumbs エディタウィンドウ下部にブレッドクラム ( プロジェクトファイルからそのファイルまでのパス ) を表示します。

Show Indent Guide Lines インデントを表す薄い線を表示します。

Show Diff Sidebar DIFF サイドバーを表示します。

Show Versioning Labels バージョンラベルを表示します。

Synchronize Editor with Views 開いている画面にエディタを同期させます。

Show Only Editor IDE ウィンドウ全体にエディタウィンドウを表示します。

Full Screen ウィンドウを全画面表示にします。



11.2.4 [Navigate] メニュー

下表に [Navigate] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-4: [Navigate] メニューの項目

コマンド動作

Go to File 指定したファイルを検索して開きます。

Go to Type 指定したクラスまたはインターフェイスを検索して開きます。

Go to Symbol 指定したシンボル名を検索します。

Go to Previous Window 1 つ前に選択したウィンドウにフォーカスします。

Go to Source 選択したクラスの定義を含むソースファイルを表示します。

Go to Declaration カーソル位置のアイテムの宣言位置へ移動します。

Go to Super Implementation カーソル位置のアイテムのスーパー実装位置へ移動します。

Last Edit Location 直前に編集した位置にジャンプします。

Back 逆方向に移動します。

Forward 順方向に移動します。

Go to Line 指定した行に移動します。

Toggle Bookmark コード行にブックマークを設定します。

Bookmark History Popup Next

[Bookmark] ウィンドウの次のブックマークに移動します ([Window] > [IDE Tools] > [Bookmarks])。

Bookmark History Popup Previous

[Bookmark] ウィンドウの 1 つ前のブックマークに移動します ([Window] > [IDE Tools] > [Bookmarks])。

Next Error 次のビルドエラーを含む行にジャンプします。

Previous Error 1 つ前のビルドエラーを含む行にジャンプします。

Select in Projects [Projects]ウィンドウを開いて、その中で現在の文書を選択します。

Select in Files [Files] ウィンドウを開いて、その中で現在の文書を選択します。

Select in Classes [Classes]ウィンドウを開いて、その中で現在の文書を選択します。

Select in Favorites [Favorites] ウィンドウを開いて、その中で現在の文書を選択します。



11.2.5 [Source] メニュー

下表に [Source] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-5: [Source] メニューの項目

コマンド動作

Format 選択したコード ( 何も選択していない場合はファイル全体 ) をフォーマットします。

Remove Trailing Spaces 行末のスペースを削除します。

Shift Left 選択した行をタブ 1 つ左へシフトします。

Shift Right 選択した行をタブ 1 つ右へシフトします。

Move Up 選択した行を 1 行上へ移動します。

Move Down 選択した行を 1 行下へ移動します。

Move Code Element Up 選択したコードエレメントを 1 行上へ移動します。

Move Code Element Down 選択したコードエレメントを 1 行下へ移動します。

Duplicate Up 選択した行を 1 行上に複製します。

Duplicate Down 選択した行を 1 行下に複製します。

Toggle Comment 選択した行をコメント化 ( または解除 ) します。

Complete Code コード補完ボックスを表示します。

Insert Code コンストラクタ、ゲッター、セッター等、一般的な構造体の生成に使えるコンテクストメニューを開きます。

Fix Code エディタが提示するヒントを表示します。ユーザに提示可能なヒントが存在する場合、IDE は電球アイコンを表示します。

Show Method Parameters 次のパラメータを選択します。このショートカットを使う前に、1 つのパラメータを選択 ( ハイライト表示 ) しておく必要があります。

Show Documentation カーソル位置のアイテムの説明を表示します。

Insert Next Matching Word 入力した文字列から始まる ( 不完全な ) 単語を、コード内で順方向に検索し、初に見つかった単語に基づいて、入力した文字列を補完します。

Insert Previous Matching Word

入力した文字列から始まる単語を、コード内で逆方向に検索し、初に見つかった単語に基づいて、入力した文字列を補完します。

Inspect 選択中のファイル、パッケージ、プロジェクトのいずれかに関する指定した検査を実行します。

Scan for External Changes ファイルをスキャンして、MPLAB® X IDE の外部で加えられた変更を見つけます。



11.2.6 [Refactor] メニュー

下表に [Refactor] メニューの項目を示します。メニューに表示される項目は、リファクタリングするオブジェクトのタイプ ( 変数、関数等 ) によって異なります。詳細はセクション 7.7「C コードのリファクタリング」を参照してください。


11.2.7 [Run] メニュー

下表に [Run] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-6: [Refactor] メニューの項目

コマンド動作

Rename 変数または関数名を変更し、プロジェクト内の全ソースコードを更新します。

Move クラスを別のパッケージまたはクラスに移動し、プロジェクト内の全てのコードを更新します。

Copy クラスを同じパッケージまたは別のパッケージにコピーします。

Safely Delete コードエレメントへの参照を確認し、他のコードから参照されていなければそのエレメントを削除します。

Change Function Parameter 関数のパラメータの数と名前を変更します。

表 11-7: [Run] メニューの項目

コマンド動作

Run Project メインプロジェクトまたは選択したプロジェクトを実行します。

Test Project プロジェクトの JUnit テストを始めます (Java 関連 )。Build Project プロジェクト内の全ファイルをビルドします。

Clean and Build Project 以前に生成済みのプロジェクトファイルを全てクリーニング(削除 )してから、プロジェクト内のファイルをリビルドします。

Batch Build Project プロジェクトの複数のコンフィグレーションをビルドします ( 組み込みのみ利用可能 )。

Set Project Configuration プロジェクトコンフィグレーションを選択します (「既定値」を選択します )。

Set Main Project 開かれているプロジェクトの一覧の中から、メインプロジェクトを選択します。

Run File 現在選択中のファイルを実行します。

Test File 現在のファイルの JUnit テストを始めます (Java 関連 )。Check File ファイルが規格に従っているかどうかチェックします(XML関連)。Validate File ファイルが規格に従っているかどうか検証します (XML 関連 )。Repeat Build/Run 一時停止から再度実行します。

Stop Build/Run 実行を終了します。



11.2.8 [Debug] メニュー

下表に [Debug] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card]を参照してください。

表 11-8: [Debug] メニューの項目

コマンド動作

Debug Project メインプロジェクトまたは選択したプロジェクトをデバッグします。

Debug File 現在選択しているファイルのデバッグセッションを始めます。

Debug Test File ファイルの JUnitによるデバッグテストを始めます (Java関連 )。Discrete DebuggerOperation

デバッグ作業を 1 ステップずつ ( ビルド、ターゲットのプログラミング、デバッガの起動 ) 別々に実行します。これは、スタータキットを使ってデバッグ中に [Memory] ウィンドウの設定を変更する場合に便利です。

Finish Debugger Session デバッグセッションを終了します。

Pause デバッグを一時停止します。[Continue] で再開します。

Continue 「一時停止」したデバッグを再開します。デバッグは次のブレークポイントまたはプログラムの末尾で再び停止します。

Step Over プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数全体を実行後に停止します。

Step Into プログラムのソースを 1 行実行します。その行が関数コールである場合、呼び出した関数の先頭の命令文を実行した後に停止します。

Step Out プログラムのソースを 1 行実行します。現在の関数の実行を完了し、その関数の呼び出しの直後のソース行で停止します。

Step Instruction マシン命令を 1 つ実行します。その命令が関数コールの場合、その関数を実行してから呼び出し元の制御に戻ります。

Run to Cursor プロジェクトをカーソル位置まで実行して、停止します。

Reset デバイスをリセットします。

Set PC at cursor プログラムカウンタ (PC) の値を、カーソル位置の行アドレスに設定します。

Focus Cursor at PC カーソルを現在の PC アドレス位置へ移動し、このアドレスをウィンドウの中心に表示します。

Stack>Make Callee Current 呼び出される側のメソッドを現在の呼び出しとします。この機能は、[Call Stack] ウィンドウで呼び出しを選択している場合にのみ利用できます。

Stack>Make Caller Current 呼び出す側のメソッドを現在の呼び出しとします。この機能は、[Call Stack] ウィンドウで呼び出しを選択している場合にのみ利用できます。

Stack>Pop Topmost Call top of the stack の呼び出しをポップします。

Stack>Pop To Current Stack Frame

Top Of Stack から１フレームをポップして捨てます。

Stack>Pop Last Debugger Call

デバッグツールからの新のコールを top of the stack にポップします。

Toggle Line Breakpoint プログラム内のカーソル行のブレークポイントを設定/解除します。

New Breakpoint 指定した行、例外、メソッドに新しいブレークポイントを設定します。

New Watch 指定したシンボルをウォッチに追加します。

New Run Time Watch 指定したシンボルを、プログラム実行中に値の変化を観察するウォッチに追加します。



11.2.9 [Team] メニュー

下表に [Team] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

11.2.10 [Tools] メニュー

下表に [Tools] メニューの項目を示します。


Disconnect from Debug Tool

MPLAB® X IDE とデバッグツール間の通信を切断します。 [Run] または [Debug Run] を選択すると再接続します。

Run Debugger/Programmer Self Test

デバッグツールのセルフテストを実行します。ツールがセルフテスト機能をサポートしている場合、このテストを実行して動作を確認できます。このためのハードウェアの設定については、そのツールの文書を参照してください。

表 11-9: [Team] メニューの項目

コマンド動作

Shelve Changes まだコミットしていない変更をパッチファイルとして作業フォルダに一時的に保存します。

Git, Mercurial, Subversion バージョン管理システムによって表示されるサブメニューが異なります。サブメニューの詳細は各製品のマニュアルを参照してください。

History ファイルの履歴を表示します。ファイルを以前のバージョンに復元する事もできます。

Find Issues バージョン管理システムで問題を見つけます。

Report an Issue バージョン管理システムに問題を報告します。

Create Build Job バージョン管理システムを使ってビルドを作成します。

表 11-10: [Tools] メニューの項目

コマンド動作

Embedded 追加されているプラグインを表示します。サブメニューからプラグインを選択します。

Licenses • コンパイラライセンスの取得 / 返却を可能にします。• ライセンスの有効化を可能にします。詳細は使用中のコンパイラのインストールパスの docs フォルダにある XCLM 文書を参照してください。

Apply Diff Patch 差分パッチファイルを選択し、コードに適用します。

Diff IDE 内で選択した 2 つのファイルを比較します。

Templates [Template Manager] ウィンドウを開きます。

DTDs and XML Schemas [DTDs and XML Schemas Manager] を開きます。

Plugins [Plugins Manager] を開きます。詳細は以下の NetBeans ヘルプトピックを参照してください。「Managing Plugins in the IDE」

Options [Options] ダイアログを開きます。Mac OS X の場合、[Mplab_ide] > [Preferences] を使います。

表 11-8: [Debug] メニューの項目 ( 続き )コマンド動作


http://docs.oracle.com/cd/E50453_01/doc.80/e50452/working_nbeans.htm#A1154745


11.2.11 [Window] メニュー

下表に [Window] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-11: [Window] メニューの項目

コマンド動作

Projects [Projects] ウィンドウを開きます。

Files [Files] ウィンドウを開きます。

Classes [Classes] ウィンドウを開きます。

Favorites [Favorites] ウィンドウを開きます。

Services [Services] ウィンドウを開きます。

Dashboard [Dashboard] ウィンドウを開きます。セクション 5.18「ダッシュボードの表示」を参照してください。

Navigator [Navigator] ウィンドウを開きます。

Action Items [Action Items] ウィンドウを開きます。

Tasks [Task List] ウィンドウを開きます。

Output [Output] ウィンドウを開きます。

Editor 空のエディタウィンドウを開きます。

Debugging>Output デバッグ用の [Output] ウィンドウ (Disassembly Listing File) を開きます。

Debugging>Variables [Local Variables] デバッガウィンドウを開きます。

Debugging>Watches [Watches] デバッガウィンドウを開きます。

Debugging>Call Stack [Call Stack] デバッガウィンドウを開きます。

Debugging>Breakpoints [Breakpoints] ウィンドウを開きます。

Debugging>Sessions [Sessions] ウィンドウを開きます。

Debugging>Sources [Sources] ウィンドウを開きます。

Debugging>Disassembly [Disassembly] ウィンドウを開きます。

Debugging>PIC AppIO [Application In/Out] ウィンドウを開きます。MPLAB® REAL ICE™ インサーキットエミュレータに適用します。

Debugging>Trace [Trace] ウィンドウを開きます。シミュレータまたはMPLAB REAL ICEインサーキットエミュレータに適用します。

Debugging>Stopwatch [Stopwatch] ウィンドウを開きます。

Debugging>Other 選択済みデバッグツールとインストール済みプラグインに応じて、その他のデバッグ機能を利用できます。

Web>Web Browser 既定値のウェブブラウザを開きます。

Web>CSS [CSS Styles] ウィンドウを開きます。このウィンドウを使うと、CSS ファイル内の HTML 要素向けのルールとセレクタの宣言を編集できます。

IDE Tools>Bookmarks [Bookmarks] ウィンドウを開きます。開いたプロジェクトのファイルのブックマークの一覧を表示します。

IDE Tools>Notifications [Notifications] ウィンドウを開きます。現在の IDE セッションで発生した IDE のエラーと警告のリストを表示します。

IDE Tools>Terminal ローカルまたはリモート用の [Terminal] ウィンドウを開きます。

IDE Tools>Processes [Processes] ウィンドウを開きます。デバッグツールを実行中のプロセスに接続する。



PIC Memory Views>Memory 指定した [Memory] ウィンドウを開きます。プロジェクトデバイスによって表示されるメモリが異なります。

Simulator>Stimulus [Simulator Stimulus] ウィンドウを開きます。

Simulator>Analyzer [Simulator Analyzer] ウィンドウを開きます。

Simulator>IOPin [I/O Pins] ウィンドウを開きます。

Configure Window>Maximize

アクティブなウィンドウをIDEウィンドウの大サイズに広げます。

Configure Window>Float フローティングのタブ付き IDE ウィンドウを開きます。

Configure Window>Float Group

フローティングのタブ付き IDEウィンドウグループを開きます。

Configure Window>Minimize アクティブなウィンドウを小化します。

Configure Window>Minimize Group

アクティブなウィンドウグループを小化します。

Configure Window>Dock フローティングのタブをメインウィンドウに復元します。

Configure Window>Dock Group

フローティングのタブグループをメインウィンドウに復元します。

Configure Window>Clone Document

同じ文書に対して新規タブを開きます。

Configure Window>Split Window

アクティブな文書を垂直または水平に分割します。

Configure Window>New Document Tab Group

エディタウィンドウを 2 つのタブグループに分割し、選択したタブを新規グループに分けます。

Configure Window>Collapse Document Tab Group

独立したタブグループを 1 つのグループに結合します。

Reset Windows ウィンドウを既定値状態にリセットします。

Close Window ウィンドウ内で現在表示しているタブを閉じます。ウィンドウにタブがない場合、そのウィンドウを閉じます。

Close All Documents ソースエディタで開いている全ての文書を閉じます。

Close Other Documents 現在アクティブな文書以外の全ての文書を閉じます。

Document Groups 名前が付いた文書グループを作成します。

Documents [Documents] ダイアログボックスを開きます。このダイアログでは、現在開いている文書を保存、閉じる事ができます。

表 11-11: [Window] メニューの項目 ( 続き )コマンド動作



11.2.12 [Help] メニュー

下表に [Help] メニューの項目を示します。これらのメニュー項目の一部に割り当てられているキーボードショートカットについては [Help] > [Keyboard Shortcuts Card] を参照してください。

表 11-12: [Help] メニューの項目

コマンド動作

Help Contents JavaHelp ビューアを開いて、インストールされている全てのヘルプファイルを表示します。

Tool Help Contents 1 つの JavaHelp ビューアを開いて、1 つのツールヘルプファイルを表示します。

Online Docs and Support NetBeans のサポートウェブページを開きます。

Keyboard Shortcuts Card キーボードショートカットマニュアルを表示します。

Report Issue IDE の問題を NetBeans に報告するウィンドウを開きます。

MPLAB X Store [MPLAB X Store] タブを開きます。

Start Page [Start Page] タブを開きます。

About [about MPLAB® IDE] ウィンドウを開きます。



11.3 ToolbarsMPLAB IDE は、現在使用中の機能またはツールに応じて、各種ツールバーを表示します。これらのツールバーを使うと、頻繁に行う操作に素早くアクセスできます。ツールバーのカスタマイズ、新規作成の方法は、セクション 6.9「ツールバーのカスタマイズ」を参照してください。

ツールバーのボタンは状況に応じて無効 ( 灰色表示 ) になります。セクション 11.5「メニュー項目とボタンの灰色表示または非表示」を参照してください。

利用できるツールバー

以下の基本的なツールバーを利用できます。

• [File] ツールバー

• [Clipboard] ツールバー

• [Status Flags] ツールバー

• [Undo/Redo] ツールバー

• [Run] ツールバー

• [Debug] ツールバー

• [Performance] ツールバー

• [MPLAB X Store]• [How Do I] ツールバー

• エディタ用ツールバー

ツールバーの特長

ツールバーは以下の特長を備えています。

• マウスポインタをアイコンに合わせると機能を表示します。

• ドラッグ操作により、ツールバーを移動できます。

• ツールバー領域内で右クリックして、ツールバーの表示 / 非表示を切り換えたり、一部のツールバーの内容を変更したりする事ができます。

• [View] > [Toolbars] を選択すると、ツールバーの表示 / 非表示の切り換え、一部ツールバーの内容の変更、カスタムツールバーの作成を実行できます。

11.3.1 [File] ツールバー

[File] ツールバーは以下の機能のアイコンを収めます。これらの機能は [File] メニューからも利用できます。

• New File – [New File] ウィザードを使ってファイルを新規作成します。

• New Project – [New Project] ウィザードを使ってプロジェクトを新規作成します。

• Open Project – 既存のプロジェクトを開きます。

• Save All Files – 開いている全てのファイルを保存します。

11.3.2 [Clipboard] ツールバー

[Clipboard] ツールバーは以下の機能のアイコンを収めます。これらの機能は [Edit]メニューからも利用できます。

• Cut – 現在選択している内容を削除し、クリップボードに移動します。

• Copy – 現在選択している内容をクリップボードにコピーします。

• Paste – クリップボードの内容を現在の選択位置に挿入します。

11.3.3 [Status Flags] ツールバー

[Status Flags] ツールバーは以下の機能のアイコンを収めます。

• PC – プログラムカウンタ (PC) の現在値



11.3.4 [Undo/Redo] ツールバー

[Undo/Redo] ツールバーは以下の機能のアイコンを収めます。これらの機能は [Edit]メニューからも利用できます。

• Undo – 以前のエディタ操作を1つずつ遡って取り消します (保存操作は取り消せません )。

• Redo – 以前の [Undo] 操作を 1 つずつ元に戻します。

11.3.5 [Run] ツールバー

[Run]ツールバーは以下の機能のアイコンを収めます。これらの機能は[Run]、[Debug]、[Project] コンテクストメニューからも利用できます。

• Set Project Configuration – プロジェクトのコンフィグレーションを選択します。[default] または [Customize] を選択します。

• Build Project – 全てのプロジェクトファイルをビルドします。下矢印をクリックするとオプションが表示されます。

• Clean and Build Project – 以前のビルドで作成されたファイルを削除した後に、全てのプロジェクトファイルをビルドします。下矢印をクリックするとオプションが表示されます。

• Make and Program Device Project – 選択したプロジェクトをビルドし、ターゲットにプログラミングした後に、プログラムを実行します。下矢印をクリックするとオプションが表示されます。

• Hold in Reset – 選択したプロジェクトをビルドし、ターゲットにプログラミングした後に、リセット状態に保持します。

• Read Device Memory – ターゲットデバイスのメモリの内容を MPLAB X IDE に読み込みます。下矢印をクリックするとオプションが表示されます。

• Debug Project – 選択したプロジェクトをビルドし、ターゲットをプログラミングした後に、デバッグ実行します。

11.3.6 [Debug] ツールバー

[Debug] ツールバーは以下の機能のアイコンを収めます。これらの機能は [Debug]メニューからも利用できます。

• Finish Debugger Session – デバッグセッションを終了します。

• Pause – デバッグを一時停止します。[Continue] で再開します。

• Reset – 実行中のプロジェクトをファイル内のカーソル位置まで実行した後にプログラムの実行を停止します。

• Continue – デバッグを再開します。デバッグは次のブレークポイントまたはプログラムの末尾で再び停止します。

• Step Over – プログラムの 1 ソース行を実行します。その行が関数コールである場合、呼び出した関数全体を実行した後に停止します。

• Step Over Expression – 式をステップオーバーし、その後にデバッグを停止します。 • Step Into – プログラムの 1 ソース行を実行します。その行が関数コールである場合、呼び出した関数の先頭の命令文を実行した後に停止します。

• Step Out – プログラムの 1 ソース行を実行します。この行が関数コールの場合、実行後に呼び出し元に戻ります。


• Apply Code Changes – コード内の全ての変更を実行中のプログラムに適用します。

• Set PC at cursor - プログラムカウンタ (PC) の値を、カーソル位置の行アドレスに設定します。

• Focus Cursor at PC – カーソルを現在の PC アドレス位置へ移動し、このアドレスをウィンドウの中心に表示します。



11.3.7 [Performance] ツールバー

[Performance] ツールバーは、性能向上に役立つ項目 ( 例 : ガーベジコレクション機能付きのメモリ使用量表示、アプリケーションのプロファイリング ) を表示します。

11.3.8 [MPLAB X Store]

[MPLAB X Store] ツールバーアイコンを使って、MPLAB X IDE のデスクトップに[MPLAB X Store] タブを開きます。

11.3.9 [How Do I] ツールバー

この機能はインターネットを必要とします。

Microchip Wiki で情報を検索します。テキストボックスに質問を入力します。

セクション 11.2.12「[Help] メニュー」も参照してください。

11.3.10 エディタ用ツールバー

エディタのツールバーは以下の機能のアイコンを収めています。これらの機能は[Edit]および [Source] メニューからも利用できます。このツールバーは、現在のソースコードファイルを表示しているタブの上段に表示されます。


• Source – ソースコードを表示します。

• History – ソースコードの履歴を表示します。

• Last Edited – 直前に編集した行へジャンプします。

• Back – 逆方向に移動します。

• Forward – 順方向に移動します。

• Find Selection – 選択したテキストに初に一致するテキストを検索します。

• Find Previous Occurrence – 選択したテキストを逆方向に検索します。

• Find Next Occurrence – 選択したテキストを順方向に検索します。

• Toggle Highlight Search – 検索に一致したテキストの強調表示を ON/OFF します。

• Previous Bookmark – ブックマークを逆方向に循環します。

• Next Bookmark – ブックマークを正方向に循環します。

• Toggle Bookmark – ブックマークを設定します。

• Shift Left – 選択した行をタブ 1 つ左へシフトします。

• Shift Right – 選択した行をタブ 1 つ右へシフトします。

• Start Macro Recording – マクロ用のキー操作の記録を始めます。

• Stop Macro Recording – キー操作の記録を終了します。

• Comment – 選択したコード行に「//」を追加してコメント行にします。

• Uncomment – 選択したコメント行の「//」を削除してコード行にします。

• Go to Header/Source – 対応するヘッダとソースコードの間を移動します。



11.4 ステータスバー

ステータスバーは、MPLAB IDE セッションの新のステータス情報を表示します。エディタの情報も表示します。

図 11-3: ステータスバーの例 – デバッグ実行

11.5 メニュー項目とボタンの灰色表示または非表示

以下のような条件では、メニュー項目、ツールバーボタン、ステータスバーアイテムは灰色で表示 ( 無効化 ) されるか、表示されません。

• その項目 / ボタンの機能が、選択したデバイスでは利用できないデバイス機能である場合 ( 例 : PIC16F877A は外部メモリをサポートしない )

• その項目 / ボタンの機能が、選択したツールでは利用できないツール機能である場合 ( 例 : MPLAB ICD 3 では [Step Out] は使えない )

• その項目 / ボタンの機能がプロジェクトに関連し、プロジェクトが何も選択されていない場合 ( 例 : アクティブなプロジェクトが存在しないと、プロジェクトのビルド機能は使えない )

• その項目 / ボタンの機能が、選択したデバイスまたはツール向けにサポートされていない場合

• その項目 / ボタンの機能が既に実行中である場合 ( 例 : プログラムの実行中、[RunProject] は灰色表示になる )

• その項目 / ボタンの機能が他の項目 / ボタンと排他的な関係にある場合 ( 例 : プログラム実行中は [Pause] が使えて [Continue] は灰色表示、プログラム停止中は[Continue] が使えて [Pause] は灰色表示になる )



NOTE:


MPLAB® X IDE
ユーザガイド
第 12 章 MPLAB X IDE のウィンドウとダイアログ

12.1 はじめに

MPLAB X IDE のデスクトップは、タブ形式の複数のペインに分割されます。これらの一部は、特定の機能を選択するまで表示されません。

例えば、MPLAB X IDE の初回起動時には、[Start Page] だけが開きます。プロジェクトを開くと、基本的なウィンドウ ( 左上ペインに [Project] と [Files]、左下ペインに[Navigator]、右下ペインに [Output]) が開きます。[Start Page] ウィンドウは、右上ペインに移動します。

MPLAB X IDE では、NetBeans のウィンドウと MPLAB X IDE 専用のウィンドウの両方を使います。各種ダイアログは、メニューから対応する項目を選択すると開きます。これらのダイアログも、ウィンドウと同様に NetBeans と MPLAB X IDE のダイアログ両方です。NetBeans のウィンドウとダイアログの詳細は第 13 章「NetBeans のウィンドウとダイアログ」を参照してください。

12.2 MPLAB X IDE のウィンドウの管理

IDE のウィンドウの管理に関する情報は NetBeans ヘルプトピック [Managing IDEWindows] を参照してください。

その他のウィンドウの情報は以下を参照してください。

12.2.1 ウィンドウのデータの更新

開いたウィンドウ ( 読み出し専用のフラッシュメモリのウィンドウを除く ) は、プログラムの停止時に更新されます。プログラムの停止には、実行後の停止とステップ実行があります。停止による更新は以下の事項に影響します。

• 速度 – 更新には時間がかかります。更新時間を短縮するには、使っていないウィンドウを閉じます。

• データの上書き – 開いたウィンドウに表示されたファイルレジスタ値は、停止時に読み出されます。読み出し時のレジスタ動作は、使うデバイスのデータシートを参照してください。

12.2.2 ウィンドウのデータの変更

MPLAB X IDE のウィンドウのデータは、以下に示すように編集できる場合があります。データを編集できない場合、この情報を利用して変更する事はできません。

• データを直接編集する(アイテムをダブルクリックして選択し新規の値を入力します。または、アイテムの隣の省略記号 [...] をクリックしポップアップウィンドウに新規の値を入力します。)

• データをドロップダウンリストから選択する ( 特定の選択肢のみが利用できる場合 )

12.2.3 ウィンドウのフォーカス

ウィンドウを確実にフォーカスするには、ウィンドウフレームだけでなくボタン、表のセル、ドロップダウン、コンボボックスをクリックします。



12.3 MPLAB X IDE のウィンドウと関連するメニューとダイアログ

MPLAB X IDE では NetBeans のウィンドウをそのまま使う場合もありますが、組み込み開発専用にカスタマイズまたは作成したウィンドウと、それらに関連するメニューも使います。

専用ウィンドウ * 関連メニュー

「[Call Stack] ウィンドウ」 Window>Debugging>Call Stack「[Breakpoints] ウィンドウ」 Window>Debugging>Breakpoints「[Customize Toolbars] ウィンドウ」 View>Toolbars「[Dashboard] ウィンドウ」 Window「[Hardware Stack] ウィンドウ」 Window>PIC Memory Views>Hardware Stack「[Memory] ウィンドウ」 Window>PIC Memory Views「[Message Center] ウィンドウ」 Window>Debugging>Output>Message Center「[Output] ウィンドウ」 Window>Output「[Project Properties] ウィンドウ」 File「[Projects] ウィンドウ」 Window「[Tools] > [Options] > [Embedded] ウィンドウ」

Tools>Options (Windows, Linux OS)mplab_ide>Preferences (Mac OS X)

「[Trace] ウィンドウ」 Window>Debugging「[Watches] ウィンドウ」 Window>Debugging「ウィザードウィンドウ」 File>New Project

File>New File* インストールしたツールによっては、ツール固有のウィンドウを表示できる場合があります。専用ウィンドウの詳細はツールのマニュアルを参照してください。


MPLAB X IDE のウィンドウとダイアログ

12.4 [Call Stack] ウィンドウ

[Call Stack] ウィンドウは、C 関数とその引数を、実行中のプログラムで呼び出された順番に一覧表示します。

コールスタックは 16 ビットおよび 32 ビットデバイスで使えます。このウィンドウは、デバッグの一時停止または停止時に更新されます。

図 12-1: [Call Stack] ウィンドウ

一時停止または停止時にこのウィンドウで使えるアイコンは以下の通りです。

表 12-1: [Call Stack] アイコン

アイコン説明

ウィンドウの内容を自動または手動で更新します。[Tools] > [Options] >[Embedded] > [Generic Settings] の [Disable auto refresh for call stack viewduring debug sessions] の値 ( チェックを外す = 偽 ( 既定値 )、チェックを入れる = 真 ) の影響を受けます。セクション 12.14.1「[Generic Settings] タブ」を参照してください。

偽 = 自動更新 ( 緑のアイコン ): ウィンドウの内容は、一時停止または停止時に自動更新されます。ウィンドウが閉じられている場合、またはフォーカスされていない場合、ウィンドウを選択しこのボタンをクリックすると更新が表示されます。再度実行および一時停止 / 停止する必要はありません。

真 = 手動更新 ( オレンジのアイコン ): ウィンドウの内容は、一時停止または停止しても自動では更新されません。一時停止 / 停止時にウィンドウの内容を更新するには、このボタンをクリックする必要があります。

関数のパラメータ変数の評価の無効化 / 有効化を選択します。

表示列を変更します。このウィンドウでは、コールスタックフレーム位置の表示 / 非表示を切り換える事ができます。



12.5 [Breakpoints] ウィンドウ

[Breakpoints] ウィンドウは、コード内のブレークポイントの設定と表示に使います。[Window] > [Debugging] > [Breakpoints] を選択してウィンドウを開きます。

[Breakpoints] ウィンドウの使い方の詳細はセクション 4.18「ブレークポイントによるプログラム実行の制御」を参照してください。

12.5.1 [New Breakpoint] ダイアログ

[Breakpoints] ウィンドウの [Create New Breakpoint] ボタンをクリックすると [NewBreakpoint] ダイアログが開きます。

図 12-2: [Create New Breakpoint] ボタン

ブレークポイントで使えるオプションは、選択したブレークポイントタイプとデバイスで決まります ( デバイスによって使えないオプションがあります )。

12.5.2 行ブレークポイント

コード行で指定するブレークポイントには、以下のオプションを利用できます。

表 12-2: [Breakpoint Type]: [Line] – [Settings]項目説明

Settings ファイル行の隣の [ ガーター ] をクリックして、新規の行ブレークポイントを作成します。または、エディタのコンテクストメニューから [Toggle LineBreakpoint] を選択します。



12.5.3 データブレークポイント

データメモリのブレークポイントには、以下のオプションが利用できます。

表 12-3: [Breakpoint Type]: [Data] – [Settings]項目説明

Project 開いているプロジェクトをドロップダウンリストから選択します。このプロジェクトのコードにブレークポイントが設定されます。

Symbols グローバルシンボルまたは SFR の名前を入力します。または、[Symbols]をクリックして参照します。[Breaks on] に従ってこのシンボルをアクセスすると、コード実行の一時停止がトリガされます。

Enable Range Address

チェックを入れるとレンジブレークポイントが設定されます。チェックを外すとシングルブレークポイントが設定されます。

AddressAddress (Start)

[Enable Range Address] の選択に応じて、この項目は [Address] と [Address(Start)] のどちらかになります。データメモリの 16 進アドレスを入力します。[Breaks on] に従ってこのアドレスをアクセスすると、コード実行の一時停止がトリガされます。

Address (End) [Enable Range Address] にチェックを入れると、この欄は有効になります。データメモリの 16 進アドレスを入力します。

Breaks on [Read], [Write], [Read or Write]: 上記で宣言したシンボルまたはアドレスに読み込み、書き込み、読み込みまたは書き込みのいずれかを実行した場合、ブレークコードが実行されます。[Read Specific Value], [Write Specific Value], [Read or Write SpecificValue]: 上記で宣言したシンボルまたはアドレスに、以下に示す特定の値の読み込み、書き込み、読み込みまたは書き込みのいずれかを実行した場合、ブレークコードが実行されます。Note: dsPIC DSC では、X および Y バスに対する読み出しおよび書き込みがあります。

Value [Breaks on] に [Read Specific Value], [Write Specific Value], [Read or WriteSpecific Value] のいずれかを選択する場合、ここに 16 進値を入力します。

Value Comparison

PIC16F1xxx デバイスの場合のみ。以下に示すように「Value」と比較します。= Value: 「Value」と等しい!= Value: 「Value」と等しくない> Value: 「Value」より大きい< Value: 「Value」より小さい

Data Value Mask

PIC16F1xxx デバイスの場合のみ。「Value」と比較する際にマスクを使います。0x00 ～ 0xhh のレンジの値を入力します。0x00: どのビットも比較しません。0xhh: 全てのビットを比較します。

表 12-4: [Breakpoint Type]: [Data] – [Pass Count]項目説明

Condition [Breaks on] で指定したブレークが発生する条件を設定します。Always Break: [Breaks on] 条件が成立すると常にブレークします。Break occurs Count instructions after Event: イベント ([Breaks on] 条件 ) が発生した後、実際のブレークの前に Count 命令を実行します。 Event must occur Count times: 実際のブレークの前に、イベント ([Breakson] 条件 ) が Count で指定した回数発生する必要があります。

Count* [Condition] で指定した条件に従って、イベント後の命令数とイベント数のどちらかを入力します。

* セクション「一部のデバイス (PIC16F1xxx MCU) では、拡張イベントブレークポイントが使えます。」も参照してください。



12.5.4 アドレスブレークポイント

プログラムメモリのブレークポイントには以下のオプションを利用できます。

表 12-5: [Breakpoint Type]: [Data]項目説明

Trigger Options PIC16F1xxx デバイスの場合のみ。トリガする条件を以下のどちらかから選択します。• Do not trigger out when breakpoint is reached• trigger out when breakpoint is reached

Interrupt Context

PIC16F1xxx デバイスの場合のみ。アドレス / データブレークポイント用の割り込みコンテクスト修飾子です。以下のいずれかを選択します。• Always break - ISR とメインコードの両方でブレークします。• Break in main line (non-interrupt) context only - メインコード内のみで

ブレークします。• Break in interrupt context only - ISR コード内でのみブレークします。

表 12-6: [Breakpoint Type]: [Address] – [Settings]項目説明

Project 開くプロジェクトをドロップダウンリストから選択します。このプロジェクトのコードにブレークポイントが含まれます。

Enable Range Address チェックを入れるとレンジブレークポイントが設定されます。チェックを外すとシングルブレークポイントが設定されます。

AddressAddress (Start)

[Enable Range Address] の選択に応じて、この項目は[Address] と [Address (Start)] のどちらかになります。プログラムメモリの 16 進アドレスを入力します。[Breaks on]に従ってこのアドレスをアクセスすると、コード実行の一時停止がトリガされます。

Address (End) [Enable Range Address] にチェックを入れると、この欄は有効になります。データメモリの 16 進アドレスを入力します。

Breaks on Program Memory Execution: 上記で指定したアドレスに達した場合、ブレークコードが実行されます。TBLRD Program Memory: 上記で指定したアドレスへのテーブル読み出しが発生した場合、ブレークコードが実行されます。TBLWT Program Memory: 上記で指定したアドレスへのテーブル書き込みが発生した場合、ブレークコードが実行されます。

表 12-7: [Breakpoint Type]: [Address] – [Pass Count]項目説明

Condition [Breaks on] で指定したブレークが発生する条件を設定します。Always Break: [Breaks on] 条件が成立すると常にブレークします。Break occurs Count instructions after Event: イベント([Breaks on]条件 )が発生した後、実際のブレークの前にCount命令を実行します。 Event must occur Count times: 実際のブレークの前に、イベント ([Breaks on] 条件 ) が Count で指定した回数発生する必要があります。

Count* [Condition] で指定した条件に従って、イベント後の命令数とイベントの数のどちらかを入力します。

* セクション「一部のデバイス (PIC16F1xxx MCU) では、拡張イベントブレークポイントが使えます。」も参照してください。



12.5.5 イベントブレークポイント

イベントのブレークポイントには以下のオプションを利用できます。

一部のデバイス (PIC16F1xxx MCU) では、拡張イベントブレークポイントが使えます。

表 12-8: [Breakpoint Type]: [Address]項目説明

Trigger Options PIC16F1xxx デバイスの場合のみ。トリガする条件を以下のどちらかから選択します。• Do not trigger out when breakpoint is reached• trigger out when breakpoint is reached

Interrupt Context PIC16F1xxx デバイスの場合のみ。アドレス / データブレークポイント用の割り込みコンテクスト修飾子です。以下のいずれかを選択します。• Always break - ISR とメインコードの両方でブレーク• Break in main line (non-interrupt) context only - メインコード内のみでブレークします。

• Break in interrupt context only - ISR コード内でのみブレークします。

表 12-9: [Breakpoint Type]: [Event]項目説明

Project 開いているプロジェクトをドロップダウンリストから選択します。このプロジェクトのコードにブレークポイントが設定されます。

Break on clock mode switch クロックモードが切り換わった時にブレークします。

Break on Reset instruction デバイスリセット命令が発生した時にブレークします。

Break on Sleep スリープに移行した時にブレークします。

Break on stack over/underflow スタックがオーバーフローまたはアンダーフローした時にブレークします。

Break on wake up デバイスがスリープから復帰した時にブレークします。

Break when watchdog timer has expired

ウォッチドッグタイマ時間が終了した時にブレークします。

Break on execution out of bounds

プログラムが通常のプログラムメモリ/空間を逸脱しようとした時にブレークします。

Break on MCLR Reset マスタクリアリセット (MCLR) でブレークします。

Break on trigger in signal トリガインパルスを検出した時にブレークします。

* 一時停止 ( ブレーク ) するコード実行を引き起こすイベントをリストから選択します。デバイスによっては、一部のイベントを利用できない場合があります。

操作説明

Break 指定した設定に従って実行をブレーク ( 停止 ) します。

Trigger out 指定した設定に従ってトリガアウトパルスを送出します。

Break and trigger out 指定した設定に従って実行をブレーク ( 停止 ) し、かつトリガアウトパルスを送出します。



12.5.6 パスカウント動作

パスカウントを使う事で、指定したカウントの後までブレークの実行を遅延させる事ができます。

Break occurs Count instructions after Event:Count は、ブレークポイントの後、停止までに実行する命令数です。

例えば、

• 0: 即座に実行を停止する

• 1: 追加の 1 命令後に実行を停止する

• 10: 追加の 10 命令後に実行を停止する

Event must occur Count times:Count は、停止までに発生するイベント回数です。例えば、

• 0: 即座に実行を停止する

• 1: イベントが 1 回発生したら、次回のイベント (2 回目のイベント発生 ) で実行を停止する

• 10: イベントが 10 回発生したら、次回のイベント (11 回目のイベント発生 ) で実行を停止する

12.6 [Customize Toolbars] ウィンドウ

[Customize Toolbars] ウィンドウを使うと MPLAB X IDE のツールバーをカスタマイズできます。このウィンドウは、[View] > [Toolbars] > [Customize] で開きます。

カスタマイズの手順はセクション 6.9「ツールバーのカスタマイズ」を参照してください。

12.7 [Dashboard] ウィンドウ

[Dashboard] ウィンドウはチェックサム、メモリ使用率、ブレークポイントリソース等の一般的なプロジェクト情報を表示します。詳細はセクション 5.18「ダッシュボードの表示」を参照してください。



12.8 [Hardware Stack] ウィンドウ

停止時にハードウェアスタックの内容を表示します。

[Hardware Stack]ウィンドウを開くには、[Window] > [PIC Memory Views] > [HardwareStack] の順に選択します。初のスタックレベルは「0」で表します。

図 12-3: [Hardware Stack] ウィンドウ

一時停止または停止時にこのウィンドウで使えるアイコンは以下の通りです。

表 12-10: ハードウェアスタックアイコン

アイコン説明

灰色表示のアイコン

無効の標準アイコン ([Find], [Find Next], [Find Previous]) です。このウィンドウにはスタック全体が表示されているため、[Find] は不要です。

ウィンドウの内容を自動または手動で更新します。 [Tools] > [Options] > [Embedded] > [Generic Settings] の [Disable autorefresh for call stack view during debug sessions] の値 (チェックを外す = 偽( 既定値 )、チェックを入れる = 真 ) の影響を受けます。セクション 12.14.1

「[Generic Settings] タブ」を参照してください。

偽 = 自動更新 ( 緑のアイコン ): ウィンドウの内容は、一時停止または停止時に自動更新されます。ウィンドウが閉じられている場合、またはフォーカスされていない場合、ウィンドウを選択しこのボタンをクリックすると更新が表示されます。再度実行および一時停止 / 停止する必要はありません。

真 = 手動更新 ( オレンジのアイコン ): ウィンドウの内容は、一時停止または停止しても自動では更新されません。一時停止 / 停止時にウィンドウの内容を更新するには、このボタンをクリックする必要があります。



12.9 [Memory] ウィンドウ

[Memory]ウィンドウ([Window] > [PIC Memory Views])は各種のデバイスメモリ(SFR、コンフィグレーションビット等 ) を表示します。このウィンドウは、[Memory] および [Format] ドロップダウンボックスを使ってカスタマイズできます。

詳細はセクション 4.22「デバイスメモリ ( コンフィグレーションビットを含む ) の表示 / 変更」を参照してください。

利用可能な [PIC Memory Views]: 8/16 ビットデバイス

•「[Program Memory] ウィンドウ」

•「[File Registers] ウィンドウ」

•「[SFRs] ウィンドウ」

•「[Configuration Bits] ウィンドウ」

•「[EE Data Memory] ウィンドウ」

•「その他の [Memory] ウィンドウ」

利用可能な [PIC Memory Views]: 32 ビットデバイス

•「[Execution Memory] ウィンドウ」

•「[Data Memory] ウィンドウ」

•「[Peripherals] ウィンドウ」

•「[Configuration Bits] ウィンドウ」

•「[CPU Registers] ウィンドウ」

•「[User ID Memory] ウィンドウ」

[Memory] ウィンドウのコンテクスト ( 右クリック ) メニュー : 以下のセクション( セクション 12.9.13「[Memory] ウィンドウのメニュー」) にコンテクストメニューの情報を記載します。

図 12-4: [Memory] ウィンドウの内容



12.9.1 [Program Memory] ウィンドウ

[Program Memory] ウィンドウは、現在選択しているプロセッサのプログラムメモリのレンジ内の位置を表示します。選択したデバイスが外部プログラムメモリをサポートしており有効な場合、その外部プログラムメモリも [Program Memory] ウィンドウに表示されます。

MPLAB Xのシミュレータでは、プログラムメモリの値が変化した場合またはプロセッサが停止した場合、[Program Memory] ウィンドウのデータが更新されます。

Microchip 社のハードウェアデバッグツール ( 例 : MPLAB REAL ICE インサーキットエミュレータ ) では、プログラムメモリの値が変化した場合、またはプロセッサが停止した場合、[Program Memory] ウィンドウのデータは更新されません。デバイスメモリの読み出しを実行する必要があります。

[Program Memory] ウィンドウ下部のドロップダウンボックスをクリックする事で、ウィンドウ内のオペコードの表示方法を変更できます。

•「[Code]」•「[Hex]」•「PSV Mixed (dsPIC DSC/PIC24 デバイスのみ )」•「PSV Data (dsPIC DSC/PIC24 デバイスのみ )」

12.9.1.1 [Code]

[Code] フォーマットは逆アセンブル HEX コードをシンボルで表示します。このウィンドウには以下の列が表示されます。

• デバッグ情報 – デバッグに便利な情報です。ポインタはプログラムカウンタの現在の位置を示します。

• Line – 参照行番号です。

• Address – オペコードの 16 進アドレスです。

• Opcode – 16進オペコードです。2バイトまたは3バイトのブロックで表示されます。ほとんどの PIC MCU では、これらのブロックはワードを意味します。 PIC18CXXX デバイスではブロックは 2 バイトに相当します。 dsPIC DSC デバイスではブロックは 3 バイトに相当します。

• Label( シンボリックのみ ) – シンボリックフォーマットのオペコードラベルです。

• DisAssy – オペコードニーモニックの逆アセンブルバージョンです。

12.9.1.2 [Hex]

このフォーマットはプログラムメモリ情報を HEX コードで表示します。このウィンドウには以下の列が表示されます。

• Address – 隣の列のオペコードの 16 進アドレスです。

• オペコードブロック – 16 進オペコードです。2 バイトまたは 3 バイトのブロックで表示されます。大部分の PIC MCU では、これらのブロックはワードを意味します。PIC18CXXXデバイスでは、ブロックは 2 バイトに相当します。dsPIC DSC デバイスでは、ブロックは 3 バイトに相当します。ハイライト表示のオペコードブロックはプログラムカウンタの現在の位置を表します。

• ASCII – 対応するオペコード行の ASCII 表示です。



12.9.1.3 PSV Mixed (dsPIC DSC/PIC24 デバイスのみ )

このフォーマットはプログラムメモリをオペコードとPSV領域 (CORCONレジスタ、PSV ビットセット ) で表示します。このウィンドウには以下の列が表示されます。

• デバッグ情報 – デバッグに便利な情報です。ポインタはプログラムカウンタの現在の位置を示します。

• Line – 参照行番号です。

• Address – オペコードの 16 進アドレスです。

• PSV Address – オペコードの 16 進データ空間アドレスです。

• Data – データとしてフォーマット化されたオペコードです。

• Opcode – 16 進オペコードです。3 バイトのブロックで表示されます。

• Label – シンボリックフォーマットのオペコードラベルです。


詳細は『dsPIC30F ファミリリファレンスマニュアル』(DS70046) を参照してください。

12.9.1.4 PSV Data (dsPIC DSC/PIC24 デバイスのみ )

このフォーマットはプログラムメモリをファイルレジスタで表示します ( プログラム空間がデータ空間 (CORCON レジスタ、PSV ビットセット ) 内に表示されている場合 )。このウィンドウには以下の列が表示されます。

• Address – データの 16 進プログラム空間アドレスです。

• PSV Address – データの 16 進データ空間アドレスです。

• データブロック – 16 進データです。3 バイトのブロックで表示されます。ハイライト表示のデータブロックはプログラムカウンタの現在の位置を表します。

• ASCII – 対応するデータ行の ASCII 表示です。

詳細は『dsPIC30F ファミリリファレンスマニュアル』(DS70046) を参照してください。



12.9.2 [File Registers] ウィンドウ

[File Registers] ウィンドウは、選択したデバイスの全ファイルレジスタを表示します。ファイルレジスタの値が変化した場合、またはプロセッサがデバッガに応答した場合、[File Registers] ウィンドウのデータが更新されます。

[File Registers] ウィンドウ下部のボタンをクリックする事で、ウィンドウ内のデータの表示方法を変更できます。

12.9.2.1 [Hex]

このフォーマットはファイルレジスタ情報を HEX データで表示します。このウィンドウには以下の列が表示されます。

• Address – 隣の列のデータの 16 進アドレスです。

• データブロック – 16 進データです。1 バイトまたは 2 バイトのブロックで表示されます。


12.9.2.2 [Symbol]

このフォーマットは、HEX、10 進、バイナリ形式の対応データで各ファイルレジスタをシンボル表示します。このウィンドウには以下の列が表示されます。

• Address – データの 16 進アドレスです。

• Symbol – データのシンボル名です。

• 基数情報 – Hex, Decimal, Binary, Char基数情報はこれらの 4 列に表示されます。HEX は 1 バイトまたは 2 バイトのブロックで表示されます。

12.9.2.3 [Dual Port] (dsPIC33FJ DSC/PIC24HJ MCU デバイスのみ )


• Address – データの 16 進アドレスです。

• DMA Address – シリコンの DMA アドレスからのオフセットです。

• データブロック – 16 進データです。1 バイトまたは 2 バイトのブロックで表示されます。


dsPIC33F DSC および PIC24H MCU デバイスの詳細は、弊社ウェブサイトのデバイスデータシートと『dsPIC33F/PIC24H ファミリリファレンスマニュアル』の各セクションでご確認ください。

12.9.2.4 [XY Data] (dsPIC DSC デバイスのみ )


• Address – データの 16 進 X アドレスです。

• Y Bus – データの 16 進 Y アドレスです ( サポートされている場合 )。• データブロック – 16 進データです。2 バイトのブロックで表示されます。


dsPIC DSC デバイスの詳細は『dsPIC30F ファミリリファレンスマニュアル』(DS70046) を参照してください。

Note: 特定のハードウェアツールでデバッグ速度を改善するには、このウィンドウを閉じます。代わりに[SFRs]または[Watches]ウィンドウを使います。




12.9.3 [SFRs] ウィンドウ

特殊機能レジスタ (SFR) ウィンドウは、選択したプロセッサの SFR の内容を表示します。このウィンドウには各 SFR 名と複数のフォーマットが表示されているため、通常のファイルレジスタウィンドウより SFR の表示に便利です。少数の SFR を表示する場合、[Watches] ウィンドウを推奨します。ハードウェアデバッグツール使用時に速度問題対策に役立つ事があります ( ウィンドウ更新レートが速いため )。ブレークが発生すると常に特殊機能レジスタの内容が更新されます。

可視レジスタ

データメモリレジスタが物理的にデバイス上に実装されていない場合、SFR の一覧に表示されない事があります。シミュレータ等の一部のツールを使うと、実際のデバイス上に存在しないプリスケーラ等のレジスタを表示できます。

シングルステップ実行

[Freeze Peripherals On Halt]を選択した場合、SFRのI/Oポートビットまたは[Watches]ウィンドウはシングルステップ実行では更新されません。ピンは変更されますが、新規の値を取得するための読み出し要求はフリーズによって阻止され、次のステップまたは実行コマンドまで更新されません。

•「[Individual]」•「[Peripheral]」

12.9.3.1 [Individual]

この表示画面では、SFR はアドレスで表示されます。

データは以下の列に表示されます。

• Address – SFR の 16 進アドレスです。

• Name – SFR のシンボル名です。

• 基数情報 – Hex, Decimal, Binary, Char基数情報はこれらの 4 列に表示されます。HEX は 1 バイトのブロックで表示されます。

12.9.3.2 [Peripheral]

この表示画面では、SFR は関連するデバイスの周辺モジュールに従ってグループ化されます。


• Address – SFR の 16 進アドレスです。

• Name – 周辺モジュール名または SFR のシンボル名です。

• 基数情報 – Hex, Decimal, Binary, Char基数情報はこれらの 4 列に表示されます。HEX は 1 バイトのブロックで表示されます。

[Select Peripheral] ボタンをクリックして選択した周辺モジュールのみの SFR を表示します。



12.9.4 [Configuration Bits] ウィンドウ

[Configuration Bits] ウィンドウの使い方の詳細はセクション 4.22.4「コンフィグレーションビットの設定」で説明します。


12.9.5 [EE Data Memory] ウィンドウ

[EE Data Memory] ウィンドウは、EEPROM データメモリを備えたマイクロコントローラ ( 例 : PIC16F1829) のEEPROM データを表示します。選択したデバイスのデータ /オペコード HEX 情報が表示されます。

MPLAB X のシミュレータでは、EEPROM レジスタの値が変化した場合またはプロセッサが停止した場合、[EE Data Memory] ウィンドウのデータが更新されます。

Microchip 社のハードウェアデバッグツール ( 例 : MPLAB REAL ICE インサーキットエミュレータ ) では、EEPROM レジスタの値が変化した場合、またはプロセッサが停止した場合、[EE Data Memory] ウィンドウのデータは更新されません。データを更新するには、デバイスメモリのデバッグ読み出し ( デバイス / ヘッダがこれをサポートしている場合 ) を実行する必要があります。または、デバッグセッションを終了した後、デバイスのデータを読み出す必要があります。

EEPROM データメモリの開始アドレスは、プログラマで指定する必要があります。下表に、一般的な開始アドレスを示します。ただし実際のアドレスはデバイスのプログラミング仕様で確認する必要があります。

この画面は以下の列にデータを表示します。


• データブロック – 16 進データです。メニューから選択できる 1 バイト、2 バイト、4 バイトのブロックで表示されます。


表 12-11: [Configuration Bits] ウィンドウの表示

欄の見出し

定義

Address コンフィグレーションワード / バイトのアドレスです。

Name コンフィグレーションレジスタの名前です。

Value コンフィグレーションワード / バイトの現在の値です。

Field* コード内で設定されたコンフィグレーションビットのマクロのフィールド部です。例えば、WDTEはマクロ _WDTE_OFFのフィールド部です。

Option* コード内で設定されたコンフィグレーションビットのマクロのオプション部です。例えば、OFFはマクロ _WDTE_OFFのオプション部です。

Category 対応するコンフィグレーションワード /バイトのコンフィグレーションビット名です。

Setting コンフィグレーションビットの現在の値です。設定を変更するには、ドロップダウンリストを使います。それに従ってコンフィグレーションワード / バイトの値が変更されます。

* デバイスによってはサポートしていません。

表 12-12: プログラマ – データ EEPROM の開始アドレス

デバイス一般的な開始アドレス

ミッドレンジ MCU 0x2100エンハンストミッドレンジ MCU 0x1E000PIC18F MCU 0xF00000PIC24 MCU, dsPIC DSC 0x7FFE00



12.9.6 その他の [Memory] ウィンドウ

この柔軟性に富んだ [Memory] ウィンドウでは、ウィンドウ下部の [Memory] ドロップダウンリストでその他のウィンドウを選択できます。

12.9.7 [Execution Memory] ウィンドウ

[Execution Memory] ウィンドウは、現在選択している PIC32MX デバイスのプログラムおよび / またはデータメモリのレンジ内の位置を表示します。

MPLAB X のシミュレータでは、実行メモリの値が変化した場合またはプロセッサが停止した場合、[Execution Memory] ウィンドウのデータが更新されます。

Microchip 社のハードウェアデバッグツール ( 例 : MPLAB REAL ICE インサーキットエミュレータ ) では、実行メモリの値が変化した場合、またはプロセッサが停止した場合、[Execution Memory] ウィンドウのデータは更新されません。デバイスメモリの読み出しを実行する必要があります。

ウィンドウ下部のドロップダウンリストで、ウィンドウ内のメモリの表示方法を選択できます。

•「[Code] 表示 – プログラムメモリ」

•「[Data] 表示 – データメモリ」

12.9.7.1 [Code] 表示 – プログラムメモリ


• Line – メモリアドレスに対応する参照行番号です。

• Address – オペコードの 16 進物理アドレスです。

• Opcode – 16 進オペコードです。4 バイトのブロックで表示されます。ハイライト表示のオペコードはプログラムカウンタの現在の位置を表します。



12.9.7.2 [Data] 表示 – データメモリ

このフォーマットはデータメモリ情報を HEX コードで表示します。このウィンドウには以下の列が表示されます。


• データブロック – 16 進データです。4 バイトのブロックで表示されます。


12.9.8 [Data Memory] ウィンドウ

[Data Memory] ウィンドウは、現在選択している PIC32MX デバイスのデータおよび /またはプログラムメモリのレンジ内の位置を表示します。

ウィンドウ下部のタブをクリックする事で、ウィンドウ内のメモリの表示方法を選択できます。

•「[Data] 表示 – データメモリ」

•「[Code] 表示 – プログラムメモリ」

12.9.8.1 [Data] 表示 – データメモリ

このフォーマットはデータメモリ情報を HEX コードで表示します。このウィンドウには以下の列が表示されます。


• データブロック – 16 進データです。4 バイトのブロックで表示されます。

• ASCII – データの対応行の ASCII 表示です。



12.9.8.2 [Code] 表示 – プログラムメモリ


• Line – メモリアドレスに対応する参照行番号です。

• Address – オペコードの 16 進物理アドレスです。

• Opcode – 16 進オペコードです。4 バイトのブロックで表示されます。ハイライト表示のオペコードはプログラムカウンタの現在の位置を表します。



12.9.9 [Peripherals] ウィンドウ

[Peripherals] ウィンドウは、デバイスの周辺モジュールに関連する SFR の内容を表示します。少数の SFR を表示するには、[Watches] ウィンドウを使う事を推奨します。ハードウェアデバッグツール使用時の速度の問題の対策に役立つ事があります ( ウィンドウ更新レートが速いため )。ブレークが発生すると常に SFR の内容が更新されます。

可視レジスタ

データメモリレジスタが物理的にデバイスに実装されていない場合、SFR の一覧に表示されない事があります。シミュレータ等の一部のツールを使うと、実際のデバイス上に存在しないプリスケーラ等のレジスタを表示できます。




• Address – SFR の 16 進物理アドレスです。

• Virtual – バスマトリクスで定義した SFR の 16 進仮想アドレスです。


• 基数情報 – Hex, Decimal, Binary, Char行の見出しバーを右クリックして画面に基数情報を追加できます。HEX は 4 バイトのブロックで表示されます。

12.9.10 [Configuration Bits] ウィンドウ

プロジェクトデバイスによって利用できるコンフィグレーションビットが異なります。各種オプションはデバイスのデータシートで確認してください。

このウィンドウの詳細は本書のセクション 12.9.4「[Configuration Bits] ウィンドウ」を参照してください。



12.9.11 [CPU Registers] ウィンドウ

[CPU Registers] ウィンドウは、デバイスの CPU に関連する SFR の内容を表示します。少数の CPU SFR を表示するには、[Watches] ウィンドウを使う事を推奨します。ハードウェアデバッグツール使用時に速度問題対策に役立つ事があります (ウィンドウ更新レートが速いため )。ブレークが発生すると常に CPU レジスタの内容が更新されます。

可視レジスタ

データメモリレジスタが物理的にデバイス上に実装されていない場合、SFR の一覧に表示されない事があります。シミュレータ等の一部のツールを使うと、実際のデバイス上に存在しないプリスケーラ等のレジスタを表示できます。




• Address – SFR の 16 進物理アドレスです。


• 基数情報 – Hex, Decimal, Binary, Char行の見出しバーを右クリックして画面に基数情報を追加できます。

• Virtual – バスマトリクスで定義した SFR の 16 進仮想アドレスです。

12.9.12 [User ID Memory] ウィンドウ

一部のデバイスは、ユーザがチェックサムまたはその他のコード識別 (ID) 番号を格納できるメモリ位置を持っています。これらの位置はプログラム / ベリファイ中に読み書き可能です。デバイスによっては、通常の実行中も TBLRD および TBLWT 命令を使ってこれらの位置をアクセスできます。


• Address – ユーザ ID の 16 進アドレスです。右クリックし、仮想アドレスと物理アドレスのどちらかを表示します。

• User ID – ユーザ ID メモリの内容 (HEX 形式 ) です。

この欄に入力する値はデバイスのプログラミング仕様を参照してください。ほとんどのデバイスでは、この値でデバイスの ID ワードの下位ニブルを設定し、上位ニブルは「0」に設定されます。上位ニブルは、テーブル書き込み等を使ってプログラム的にのみ書き込む事ができます。



12.9.13 [Memory] ウィンドウのメニュー

[Memory] ウィンドウで右クリックすると、下表の項目が表示されます。一部のデバイスでは使えない項目もあります。

[Window] タブを右クリックすると、その他のオプション (Close、Maximize/Minimizewindow、Dock/Undock window 等 ) を選択できます。

表 12-13: [Memory] ウィンドウのメニュー項目

項目説明

Virtual AddressPhysical Address

[Address] 列の下に表示するアドレスのタイプをチェックマークで選択します。

Hex Display Width 16 進数の表示幅を設定します( 選択肢はデバイスによって異なります )。32 ビットデバイスの例 :One byte( 例 : 00 01 02 ...0E 0F)Two bytes( 例 : 00 02 04 ...0C 0E)Four bytes( 例 : 00 04 08 0C)

Run to Cursor 現在のカーソル位置までプログラムを実行します。

Set PC at Cursor プログラムカウンタ (PC) を現在のカーソル位置に設定します。

Focus Cursor at PC カーソルを現在の PC アドレス位置へ移動し、このアドレスをウィンドウの中心に表示します。

Toggle Breakpoint 既存のブレークポイントの ON/OFF を切り換えます。

Symbolic Mode 逆アセンブル HEX コードをシンボルで表示します。

Verbose Labels 内部コンパイララベルを表示します。

Fill Memory メモリの [Start Address]～ [End Address]に [Data]内の値を書き込みます。[Fill Memory] ダイアログで、その他のオプションを指定します。

Go To [Go To] ダイアログで指定したアドレス / 関数に移動します。

Find [Find] ダイアログで指定したテキストを検索します。

Enable Multiline Rows [Configuration Bits] ウィンドウで複数の行を有効にします。

Output To File ウィンドウの表示内容をテキストファイルに書き出します。[Output to File Range] ダイアログで、出力するデータの範囲を指定します。

Import Table ファイルから [Memory]ウィンドウに表形式のデータをインポートします。[Import Table Range] ダイアログで、インポートするデータの範囲を指定します。

Export Table [Memory] ウィンドウからファイルへ表形式のデータをエクスポートします。[Export Table Range] ダイアログで、エクスポートするデータの範囲を指定します。1 列にエクスポートするかどうかも指定します。

Print このウィンドウの内容を印刷します。NOTE: メモリ容量の大きなデバイスの場合、印刷ページ数が非常に多くなる事があります。その場合、ウィンドウの内容をファイルに出力した後 ([Print] ダイアログの [General] タブの [Print to File] チェックボックス )、そのファイルから必要なページだけ選んで印刷する事を推奨します。

Adjust Table Columns 行を自動的に調節します。



12.10 [Message Center] ウィンドウ

[Message Center] ウィンドウは、全ての [Output] ウィンドウのメッセージを収集し、時系列で 1 つの画面に表示します。各種のフィルタを選択して関連するメッセージを表示できます。

図 12-5: [Message Center] ウィンドウ

表 12-14: [Message Center] ボタン

番号ボタン機能

1 Search 検索テキストボックスを切り換えます。検索ボックスが表示されている場合、テキストを入力するとその文字列を [Message Center] ウィンドウ内で検索します。

2 Filters 既定値では、[Output] ウィンドウに表示される全てのメッセージが[Message Center] ウィンドウに表示されます。このボタンをクリックすると、[Output] ウィンドウのタブ項目のリストを含むウィンドウが開きます。リストから項目を選択して、表示メッセージにフィルタをかけます。



12.11 [Output] ウィンドウ

[Task] ペインは、各種 NetBeans ウィンドウと MPLAB X IDE 専用ウィンドウを表示します。[Output] ウィンドウは、MPLAB X IDE 出力情報を表示します。情報はウィンドウ内のタブ上に表示されます。

[Output] ウィンドウで右クリックすると、下表の項目が表示されます。

表 12-15: [Output] ウィンドウのタブ項目

項目説明

Debugger Console [User program running] 等の主要なデバッグ動作を表示します。

Tool-specific ツールのファームウェアバージョン、デバイス ID、動作ステータスを表示します。

Build, Load ビルドとプログラム読み込みに関する情報とステータスを表示します。

Clean, Build, Load クリーン、ビルド、プログラミングに関する情報とステータスを表示します。

Peripheral Output シュミレータを使ったデバッグにおいて、UART 等の周辺モジュールの出力を表示します。

表 12-16: [Output] ウィンドウのメニュー項目

メニュー項目説明

Copy 選択しているテキストをクリップボードにコピーします。

Paste 現在選択しているテキストをクリップボードから [Output] ウィンドウに貼り付けます。

Find 現在選択しているテキスト、または入力したテキストを [Output] ウィンドウ内で検索します。正規表現、大文字 / 小文字の区別にも対応しています。

Find Next テキストを順方向に検索します。

Find Previous テキストを逆方向に検索します。

Filter テキストまたは正規表現によって出力をフィルタ処理します。

Wrap Text [Output] ウィンドウの行送りを有効にします。

Larger Font フォントサイズを大きくします。

Smaller Font フォントサイズを小さくします。

Choose Font フォントタイプ、スタイル、サイズを選択します。

Save As 選択したテキストをファイルに保存します。

Clear [Output] ウィンドウ内のテキストを全てクリアします。

Close [Output] ウィンドウを閉じます。



12.12 [Project Properties] ウィンドウ

このウィンドウは、プロジェクトのデバイス、ツール、ツール設定を表示または変更するために使います。詳細は以下を参照してください。

• セクション 4.4「プロジェクトプロパティの表示と変更」

• セクション 4.5「デバッガ / プログラマツールオプションをセットアップまたは変更する方法」

• セクション 4.6「言語ツールオプションを設定または変更する方法」

• セクション 5.4「読み込み可能なプロジェクト、ファイル、シンボル」

• セクション 4.12「ライブラリやオブジェクトファイルの追加と設定」

• セクション 4.14「ビルドプロパティの設定」

12.13 [Projects] ウィンドウ

[Projects] ウィンドウは NetBeans ウィンドウです。しかし、MPLAB X IDE プロジェクトに関連する論理 ( 仮想 ) フォルダを表示するために、カスタマイズしています。また、右クリックで開くコンテクストメニューには、MPLAB X IDE 専用の項目を追加しています。

•「[Projects] ウィンドウ – 論理フォルダ」

•「[Projects] ウィンドウ – [Project] メニュー」

•「[Projects] ウィンドウ – [File] メニュー」

•「[Projects] ウィンドウ – [Window] メニュー」

図 12-6: [Projects] ウィンドウのコンテクストメニュー



12.13.1 [Projects] ウィンドウ – 論理フォルダ

MPLAB X プロジェクト用に論理フォルダを追加しています。そのため、表示された全てのフォルダは以下のファイルタイプのいずれかに分類できます。

• Header Files – MPLAB X IDE はビルド時にこのカテゴリを使いません。このフォルダは、ヘッダファイルに対するプロジェクトの依存性を示し、また、これらのファイルに容易にアクセスするために設けられています。[Projects] ウィンドウでファイルをダブルクリックすると、エディタで開きます。

• Linker Files – リンカスクリプトをプロジェクトに追加する必要はありません。プロジェクトの言語ツールが、デバイスに適合する汎用リンカスクリプトを自動的に選択するためです。従って、リンカスクリプトをユーザが自分で作成しない限りこのフォルダは空になります。

ファイルは 1 つだけ格納します。複数のリンカスクリプトを格納した場合、初の1 つだけが有効となります。

• Source Files – ツールチェーンがファイルコマンドへの入力として受け入れるのは、これらのファイルのみです。

• Important Files – 他のどのカテゴリにも属さないファイルは、全てこのフォルダに格納します。あるいは、プロジェクトに関連するデータシート (PDF) を、[Projects] ウィンドウ内のこのフォルダに追加しておけば、ダブルクリックでデータシートを開く事ができます (PDF リーダーをインストールしておく必要があります )。

• Libraries – ツールチェーンは、このフォルダ内の全てのファイルとオブジェクトファイルを終リンクステップでインクルードします。詳細はセクション 4.12「ライブラリやオブジェクトファイルの追加と設定」を参照してください。

• Loadables – プロジェクト HEX ファイルと結合または置換するプロジェクトとファイルです。詳細はセクション 5.4「読み込み可能なプロジェクト、ファイル、シンボル」を参照してください。



12.13.2 [Projects] ウィンドウ – [Project] メニュー

[Projects] ウィンドウでプロジェクト名を右クリックすると、[Project] メニューが開きます。表 12-17 に、メニュー項目を示します。

表 12-17: [Project] コンテクストメニューの項目


New ファイルを新規作成します。 MPLAB® X IDE では、[embedded] ファイルタイプを選択できます。

Add Existing Item 既存のファイルをプロジェクトに追加します。ファイルへのパスは、[Auto] (MPLAB X IDE が選択 )、[Absolute]、[Relative] のいずれかに設定できます。さらに、そのファイルをプロジェクトフォルダにコピーできます。

Add Existing Items from Folders

指定したフォルダに含まれる全てのファイルを追加します。また、特定のフォルダを含めないようにパターンを指定する事もできます。[Default] をクリックすると既定値のパターンを参照できます。また、[Tools] > [Options] で [Miscellaneous] ボタンをクリックし、[Files] タブで [Files ignored by the IDE] も参照してください。

New Logical Folder 新規の論理フォルダを作成します。実際のフォルダの表示は、[Files] ウィンドウを参照してください。

Locate Headers C コードプロジェクトファイル内で呼び出されている全てのヘッダファイル (.h) を検索し、プロジェクトに追加できるようにチェックリストウィンドウに表示します。プロジェクトにヘッダを追加する理由は複数あります。• PC 上でヘッダファイルの保存場所を探す事なく、[Projects] ウィンドウの [Header Files] から開く事ができます。

• [Save Project As] でプロジェクトを作成した場合、ヘッダファイルはユーザが追加しない限りプロジェクトには含まれません。従って、ユーザ作成のヘッダファイルが必要な場合、このプロジェクトはビルドできません。

• [Package] で圧縮済みプロジェクトを作成した場合、ヘッダファイルはユーザが追加しない限りプロジェクトには含まれません。従って、ユーザ作成のヘッダファイルが必要な場合、これを解凍したプロジェクトはビルドできません。

この機能を使うと、Microchip 社の全てのツールチェーンのユーザ作成ヘッダファイルを検索できます。

Add Item to Important Files

既存のアイテムをプロジェクトに追加します。ファイルへのパスは、[Auto] (MPLAB X IDE が選択 )、[Absolute]、[Relative] のいずれかに設定できます。さらに、そのファイルをプロジェクトフォルダにコピーする事を選択できます。これは、シミュレータファイル、データシート (PDF)、その他のファイルを参考資料としてプロジェクトに追加するのに便利です。

Export Hex プロジェクトのビルド結果をHEXファイルとしてエクスポートします。MPLAB IDE v8ではメモリオブジェクトの抽出結果をエクスポートします。MPLAB X IDE ではビルドの結果を納めた HEX ファイルをエクスポートします。従って、このファイルは、コード内のコンフィグレーションと EEPROM に必要な全ての補助的メモリ設定を含む必要があります。

Build [Project Properties] ウィンドウで選択したオプションに従ってビルドします。Note: [Debug] または [Run] を実行すると、プロジェクトは自動的にビルドされます。

Clean and Build [Clean] を実行した後、[Project Properties] ウィンドウで選択したオプションに従ってビルドします。Note: [Debug] または [Run] を実行すると、プロジェクトは自動的にビルドされます。

Clean 以前のビルドで生成されたファイルを削除してプロジェクトを空にします。

Package 現在のプロジェクトを 1 つの ZIP ファイルにアーカイブします。詳細はセクション 6.6「MPLAB X IDE プロジェクトのパッケージ化」の「Locate Headers」を参照してください。



Set Configuration プロジェクトのコンフィグレーションを設定するために [ProjectProperties] ダイアログを開きます。

Run プロジェクトコードを実行します。詳細はセクション 4.16「コードの実行」を参照してください。

Debug プロジェクトコードをデバッグ環境で実行します。詳細はセクション 4.17「コードのデバッグ実行」を参照してください。

Step In デバッグ環境で実行中の一時停止したコードを順番に実行します。詳細はセクション 4.19「コードのステップ実行」を参照してください。

Make and Program Device

ターゲットデバイスをプログラミングした後、プログラムを実行せずにリセット状態に保持します。

Set as Main Project このプロジェクトをメインプロジェクトに設定します。これは複数のプロジェクトを使う場合に便利な機能です。セクション6.3「複数プロジェクトを使った作業」も参照してください。

Open Required Projects

選択したプロジェクトの実行に必要なその他の全てのプロジェクトを読み込みます。

Close 選択したプロジェクトを閉じます。Rename プロジェクト名を変更します。Move プロジェクトを別の場所に移動します。

プロジェクトと一緒に、プロジェクトフォルダ内のソースファイルも移動します。プロジェクトフォルダ外部のファイルは移動しません。しかしプロジェクトは、プロジェクトフォルダ外のファイルへの参照を維持します。これは設計仕様に基づいた動作です。

Copy プロジェクトのコピーを作成します。ソースファイルがプロジェクトフォルダ内にある場合、ソースファイルも新規の場所にコピーします。プロジェクトフォルダ外にあるファイルはコピーしません。しかしプロジェクトは、プロジェクトフォルダ外のファイルへの参照を維持します。これは設計仕様に基づいた動作です。

Delete プロジェクトファイルを削除します。プロジェクトファイルは削除しますが、プロジェクトフォルダ内のファイルは削除しません。[Also delete sources] を選択した場合のみ、全ソースファイルを削除します。

Code Assistance コード生成支援機能 (例 : コード折り畳み、コード補完 )を選択します。Find このプロジェクトのファイル内で特定のテキストを検索します。Share on Team Server

チームサーバでこのプロジェクトを共有します。詳細はセクション 5.21「コード開発とエラー追跡の連携」を参照してください。

Versioning バージョン管理システムを使ってプロジェクトのバージョンを管理します。詳細はセクション 5.20「ソースコードの管理」を参照してください。

Local History プロジェクトのローカル履歴を表示します。または、そのローカル履歴に戻します。詳細はセクション 5.20「ソースコードの管理」を参照してください。

Properties プロジェクトのプロパティを設定します。MPLAB X IDE の [Project Properties] ウィンドウは、組み込み開発専用にカスタマイズされています。セクション 12.12「[Project Properties]ウィンドウ」を参照してください。

表 12-17: [Project] コンテクストメニューの項目 ( 続き )メニュー項目説明



12.13.3 [Projects] ウィンドウ – [File] メニュー

[Projects] ウィンドウでファイル名を右クリックすると、[File] メニューが開きます。表 12-18 に、専用のメニュー項目を示します。

12.13.4 [Projects] ウィンドウ – [Window] メニュー

[Projects] ウィンドウの空いた場所で右クリックすると、[Window] メニューが表示されます。表 12-19 に、専用のメニュー項目を示します。

表 12-18: [File] コンテクストメニューの項目


Open このファイルをエディタウィンドウで開きます。

Cut ファイルをプロジェクトから削除し、クリップボードに移動します。

Copy ファイルをクリップボードにコピーします。

Paste クリップボードのファイルをプロジェクトに貼り付けます。

Compile File 現在のファイルのみをコンパイルします。

Remove from Project ファイルをプロジェクトから削除します。この操作では、ファイルは PC から削除されません。ファイルをプロジェクトとコンピュータから削除するには、<Delete> キーを使います。

Rename ファイル名を変更します。

Save as Template 現在のファイルをテンプレートファイルとして保存します。

Local History ファイルのローカル履歴を表示します。または、そのローカル履歴に戻します。詳細はセクション 5.20「ソースコードの管理」を参照してください。

Tools ファイルツールは以下を含みます。• Apply Diff Patch: Diff が作成した既存のパッチを適用します。• Diff to: 2 つのファイルの差分を表示します。• Add to Favorites: このファイルを [Favorites]ウィンドウに追加します。

Properties プロジェクトプロパティとは異なるファイルプロパティを設定します。[Exclude from build] にチェックを入れると、このファイルをプロジェクトのビルドから除外します。[Override build options] にチェックを入れると、ここで選択したビルドオプションをプロジェクトコンフィグレーション内のビルドオプションよりも優先させます。詳細はセクション 4.13「ファイルおよびフォルダプロパティの設定」を参照してください。

表 12-19: [File] コンテクストメニューの項目


New Project [New Project] ウィザードを起動します。詳細はセクション 4.2「新規プロジェクトの作成」を参照してください。

New File [New File] ウィザードを起動します。詳細はセクション 4.9「ファイルの新規作成」を参照してください。


Open Recent Project 近編集したプロジェクトの一覧の中から、既存のプロジェクトを開きます。

Open Project Group プロジェクトグループの一覧の中から、既存のプロジェクトグループを開きます。

Run Project メインプロジェクトを実行します。

Set Main Project 開かれているプロジェクトの一覧の中から、メインプロジェクトを設定します。



12.14 [Tools] > [Options] > [Embedded] ウィンドウ

このウィンドウは [Tools] > [Options](Mac OS X の場合、[mplab_ide] > [Preferences])で開きます。

[Options] ウィンドウは NetBeans ウィンドウです。ただし、[Embedded] ボタンを追加して MPLAB X IDE プロジェクト用にカスタマイズしています。このボタンをクリックすると、以下のタブとオプションを利用できます。

•「[Generic Settings] タブ」

•「[Project Options] タブ」

•「[Build Tools] タブ」

•「[Static Tools] タブ」

•「[Suppressible Messages] タブ」

•「[Diagnostics] タブ」

•「[Other] タブ」



12.14.1 [Generic Settings] タブ

ログファイル等のプロジェクト機能を設定します。

表 12-20: [Generic Settings] タブの項目

項目説明

Open source file and locate line in editor when debugger halts

この機能を使うと、ブレークポイントのように停止したコード行にジャンプし、コードを確認できます。無効にすると単に実行を停止します。

Clear tool output window on new session (debug, program, upload)

実行、デバッグ実行、アップロードを開始する際に、[Output] ウィンドウの内容をクリアします。

Halt build on first failure ビルド時に、障害が初に発生した時点でプロセスを停止します。どのエラーが発生したらプロセスを停止するかは、選択したプロジェクト言語ツールで設定できます。[Project Properties] ダイアログの [Categories] で言語ツールを選択します。[Option Categories]では、エラー、警告、メッセージの設定もできます。

Maintain active connection to hardware tool

これにチェックを入れると、実行時以外もハードウェアツールを常時接続したまま (MPLAB® IDE v8 の挙動 ) にします。この機能を有効にしたままするようにプロジェクトを切り換える場合 ( 例 : ブートローダアプリケーションの開発 )、ツールとデバイスの設定が同じである事を確認します。異なる場合、エラーメッセージが表示されます。

Read Device Memory to File: Export only memory used

[Read Device Memory to File] アイコン / 機能では、ファイルに使われているデバイスメモリのみを保存します。

Silent build ビルドの際に、[Output] ウィンドウにメッセージを表示しません。

Enable alternate watch list views during debug session

[Watches] ウィンドウに 3 つのウォッチビューダイアモンドを表示し、ウォッチビューを観察する変数に関連付けます。ウォッチビューダイアモンドをクリックすると、そのビューに関連付けられた変数だけが表示されます。いわばフィルタのような機能です。

Disable auto refresh for call stack view during debug sessions

有効にすると、一時停止または停止時に内容を自動で更新します。ウィンドウが閉じられている場合、またはフォーカスされていない場合、ウィンドウを選択しこのボタンをクリックすると更新が表示されます。再度実行および一時停止 / 停止する必要はありません。無効にすると、一時停止または停止時にウィンドウを手動で更新します。一時停止 / 停止時にウィンドウの内容を更新するには、このボタンをクリックする必要があります。

On mouse-over structure and array expressions, evaluate integral members only

チェックを入れると、コードの構造体または配列の式をマウスオーバーした際、必須メンバーのみを表示します。チェックを外すと、コードの構造体または配列の式をマウスオーバーした際、全てのメンバーを表示します。

Hold-off period before memory view synchronization: Give priority to debug events (step over, step in, continue)

デバイスが停止してからデバイスのデータがメモリウィンドウに同期するまでの間の遅延時間を指定します。長い遅延時間を設定すると、更新の前により多くのシングルステップ実行が発生します。この機能は、ファイルレジスタとデータメモリ等の一般的な [PIC Memory Views] のみに適用できます。

Reset @ リセット時の動作を選択します。Main: リセット時に main() で停止します。Reset Vector: リセット時にリセットベクタ位置で停止します。

Debug start-up デバッグ開始時の動作を選択します。Run: 即座に実行を開始します。Main: main() で停止します。Reset Vector: リセットベクタ位置で停止します。

Default Charset プロジェクトの既定値の文字セットを選択します。



12.14.2 [Project Options] タブ

プロジェクトに関連するオプションを設定します。

表 12-21: [Project Options] タブの項目

項目説明

Make Options プロジェクトをビルドする際に使うmakeオプションを入力します。これらのオプションは、ツールチェーンによって異なります。詳細は使用する言語ツールの文書を参照してください。

File Path Mode プロジェクト内のファイルのパス情報の保存方法を指定します。Auto: プロジェクトフォルダ内のファイルへのパスを相対パスとして保存し、プロジェクトフォルダ外のファイルへのパスを絶対パスとして保存します。Always Relative: 全てのパスを、プロジェクトフォルダに対する相対パスとして保存します。Always Absolute: 全てのパスを絶対パス ( フルパス ) として保存します。

Save All Modified Files Before Running Make

これを選択した場合、makeを実行する前に、IDE 内の全ての未保存ファイルを保存します。このチェックは入れたままにしておく事を推奨します。外した場合、変更したファイルをあらかじめ保存しておかないと、ファイルへの変更が make に反映されません。

Reuse Output Tabs from Finished Processes

選択すると、[Output] ウィンドウの同じタブに出力メッセージが表示されます。選択しない場合、新規プロセスごとに新規タブが開きます。

Show profiler indicators during run (new projects only)

これにチェックを入れると、新規作成したプロジェクトの実行時にプロファイラツール (CPU 使用率、メモリ使用率等 ) を実行します。表示されるツールは、[Tools] > [Profiler Tools] で選択した[Profile Configuration] によって決まります。

Use parallel makemake -j 2n)

これにチェックを入れると、makeによって複数のプロセスが同時に実行されます。-j( または --jobs) は並列実行を指定するオプション、2n はプロセス数、n はコンピュータで使用可能なプロセッサ数です。コンピュータが並列処理をサポートしていない場合、並列 make は無効化されます。また、[Make Options] で 2 より大きいプロセスを指定する事も可能です ( 例 : -j 10)。Note 1: MPLAB XC16 または MPLAB C30 の場合、並列 make を使うには手続きの抽象化を無効にする必要があります ([File] >[Project Properties]、コンパイラカテゴリ、[Optimizations] オプションカテゴリで、[Unlimited procedural abstraction] のチェックを外します )。Note 2: MPASMX は、ツールチェーンとして使う場合も MPLABC18 プロジェクトの一部として使う場合も並列 make では実行できません。並列 make 機能は、MPASMX ツールチェーンを使うプロジェクトまたは C18 ツールチェーンを使うプロジェクト(.asmファイルを含む ) では無視されます。

Force makefile regeneration when opening a project

チェックを外すと、プロジェクトが既に開いている場合 ( 例 : 別のコンピュータ上でプロジェクトを開いている場合 ) の makefile の再生成の要否を MPLAB IDE が決定します ( これが既定値です )。チェックを入れると、プロジェクトを開いた時に makefile の再生成を強制的に実行します。makefile を再生成する必要があるにもかかわらず再生成されない場合、この機能を使います。Note: 再生成には若干の時間を要します。



12.14.3 [Build Tools] タブ

Mac の場合、このタブ上の情報にアクセスする方法が異なります。メインメニューバーから [mplab_ide] > [Preferences] を選択してビルドツールにアクセスします。セクション 3.3.6「言語ツールのパスの指定」を参照してください。

インストールしていない言語ツールは [Toolchain] リストに表示されません。インストールしたはずの言語ツールがこのリストに表示されない場合、[Scan for compilers]をクリックします。それでも表示されない場合、[Add] をクリックして、そのツールをリストに追加します。

以下の言語ツールは MPLAB X IDE に付属しています。

• MPASM toolchain – MPASM アセンブラ、MPLINK リンカ、各種ユーティリティを含みます。

その他のツールは、Microchip社ウェブサイト (www.microchip.com)またはサードパーティから入手できます。

12.14.4 [Static Tools] タブ

使用するリモート接続を選択します。リモート USB ツールブリッジ、リモートEthernet ツール、汎用シリアルポートのために新規の接続を追加します。

表 12-22: [Build Tools] タブの項目

項目説明

Toolchain インストールされている言語ツールのリストを表示します。プロジェクトに使うツールを選択し、右側に表示されるパスが正しい事を確認します。Base directory: ツールのメインフォルダへのパスC compiler: C コンパイラへのパス ( 利用可能な場合 )Assembler: アセンブラへのパス ( 利用可能な場合 )Make command: MPLAB® X IDE が生成した make コマンドの名前

Add リストに新しい言語ツールを追加します。[Scan for Build Tools] を使う方法もあります。

Add Custom Compiler カスタマイズしたコンパイラを追加します。この例では、サポートしている Microchip 社製デバイスを指定する必要があります。

Remove リストから言語ツールを削除します。言語ツールそのものは PC から削除されません。

Default ツールをクリックして [Default] を選択すると、選択したデバイス用の既定値コンパイラ / アセンブラとなります。

Scan for Build Tools インストールされているコンパイラ / アセンブラをスキャンします。これは、システム全体ではなく、複数の既定値フォルダだけをスキャンします。それ以外の場所にインストールした場合、手動でコンパイラを追加する必要があります。



図 12-7: 新規の静的ツール

12.14.5 [Suppressible Messages] タブ

抑止するエラーおよび警告メッセージを選択します。表示されたフォルダをダブルクリックして、抑止可能な項目を表示させてチェックを入れます。

図 12-8: 抑止可能なメッセージの一覧



12.14.6 [Diagnostics] タブ

ログファイル等の診断機能を設定します。セクション 6.8「ログデータ」を参照してください。

12.14.7 [Other] タブ

C/C++ およびアセンブラソースファイルとヘッダファイル用に使えるファイル拡張子のリストを編集します。また、各ファイルタイプの既定値拡張子 ( 太字で表示 ) も設定します。

表 12-23: [Diagnostics] タブの項目

項目説明

Logging Level メッセージログのレベルを設定します。OFF: 記録しません。SEVERE: 重大な ( エラー ) メッセージのみ記録します。WARNING: 警告メッセージのみ記録します。INFO: 情報メッセージのみ記録します。CONFIG: コンフィグレーション情報のみ記録します。FINE: 一部のモジュール間通信を記録します。FINER: FINE よりも詳細にモジュール間通信を記録します。FINEST: 全てのモジュール間通信を記録します。

Log File ログファイルのパスと名前です。

USB Circular Log MPLAB REAL ICE インサーキットエミュレータ、MPLAB ICD 3、PICkit 3 でのみ利用できます。

Start New Logging Session/Pause Logging

ボタンをクリックすると、新規のログセッションが開始します。または、進行中のログセッションが一時停止します。

Circular USB log file location ログファイルを保存する場所 ( パス ) を指定します。

Circular USB log file max size in KBs

ログファイルのサイズを指定します。

表 12-24: [Other] タブの項目

ファイル既定値の拡張子

C/C++ ヘッダファイル H, SUNWCCh, h, hpp, hxx, tccC++ ファイル C, c++, cc, cpp, cxx, mmC ファイル c, i, mFortran ファイルなし

MPLAB X IDE は Fortran によるプログラミングをサポートしていません。

アセンブリファイル AS, ASM, S, as, asm, sアセンブリインクルード INC, inc



12.15 [Trace] ウィンドウ

トレースは、[Trace] ウィンドウでコード実行をステップごとに記録し、記録された結果を検討する機能です。現在トレース機能を利用できるツールは以下の通りです。

• シミュレータ

• MPLAB REAL ICE インサーキットエミュレータ

ウィンドウでトレース列を右クリックすると、コンテクストメニュー ( 表 12-25) が開きます。使うツールによって、表示されるメニュー項目は異なります。

表 12-26 に、トレースに関連するダイアログを示します。

表 12-25: [Trace] ウィンドウのコンテクストメニュー


Symbolic Mode [Instruction] 列の表示を、リテラルレジスタアドレス ( 例 : 0x5) とシンボリックレジスタマクロ ( 例 : PORTA) の間で切り換えます。

Go To Trigger: トリガ行 (0) に移動します。Top: トレース行の先頭に移動します。Bottom: トレース行の末尾に移動します。Trace Line: 指定したトレース行に移動します。[Go To] ダイアログが開きます。

Go To Source Line トレース行を選択してこのオプションを選択すると、ソースコード内の対応する行に移動します。

Display Time [Cycle] 列の表示を以下のように設定します。As Hex Cycle Count: サイクル数を 16 進数で表示します。As Decimal Cycle Count: サイクル数を 10 進数で表示します。In Seconds Elapsed: サイクル数を経過秒数で表示します。In Engineering Format: サイクル数を適切なエンジニアリングフォーマット (103 の累乗 ) で表示します。

Clear Trace File トレース表示内のデータをクリアします。

Find トレース表示内の項目を検索します。[Find] ダイアログが開きます。

Output To File トレースデータをファイルに保存します。[Define Range] ダイアログが開き、そこから [Save] ダイアログを開きます。

Print データを印刷します。[Print] ダイアログが開きます。

Adjust Table Columns

トレース表示の列幅をデータに合わせて自動調整します。

Reload View 一時停止時にトレース表示の元のデータビューを再読み込みします。

表 12-26: [Trace] ダイアログ

ダイアログ説明

Go To 移動するトレース行を指定します。

Find トレース表示で行番号やその他のデータを検索します。

Output to File Range ファイルに出力する行範囲を指定します。範囲指定後 [OK] をクリックして、[Save] ダイアログに進み、データをテキストファイルに保存します。

Save データをテキストファイルに保存します。

Print 印刷前にプリンタ、ページ設定、表示設定を指定します。



12.16 [Watches] ウィンドウ

[Watches] ウィンドウを使って、選択したシンボルの値の変化を観察できます。[Watches] ウィンドウを開くには、[Window] > [Debugging] > [Watches] を選択します。

12.16.1 [Watches] の動作

[Watches] ウィンドウの使い方は

• セクション 4.20「シンボル値の変化の観察」

• NetBeans ヘルプトピック ([C/C++/Fortran Development] > [Debugging C/C++/Fortran Applications with gdb] > [Viewing C/C++/Fortran Program Information] > [Creating a C/C++/Fortran Watch]) を参照してください。

12.16.2 [Watches] の表示

この表示には以下の機能があります。

•「アイコン」

•「列」

•「操作」

12.16.2.1 アイコン

アイコンは [Name] 行の名前のオブジェクトの左に表示されています。

12.16.2.2 列

列見出しを右クリックすると、ウィンドウに表示される列を変更できます。セクション12.16.4「[Change Visible Columns] ダイアログ」を参照してください。

12.16.2.3 操作

各種操作はウィンドウ左側のボタンで行います。

表 12-27: [Name] 行のアイコン

アイコン説明

ウォッチオブジェクト

プログラムメモリのウォッチオブジェクト

オブジェクトの静的フィールド

オブジェクトの非静的フィールド

表 12-28: [Watches] ウィンドウのアイコン

ボタン操作

トグルボタン :- メンバーフィールドの詳細名 ( 正規の名前 ) を表示します。- メンバーフィールドの要約名 ( 相対的な名前 ) を表示します。

リストファイルからウォッチをインポートします。右クリックしてインポート方法を選択します。

全てのウォッチをリストファイルにエクスポートします。

[Value] フィールドの既定値数値フォーマットを設定します。



12.16.3 [Watches] メニュー

[Watches] ウィンドウの ( 行ではなく ) 空いた場所で右クリックすると、基本的な機能を備えた [Watches] ウィンドウメニューが表示されます。

行を右クリックすると、その他の機能を備えた [Watches] ウィンドウメニューが表示されます。表示されるメニュー項目は、選択した行がシンボルかどうか、そして使うデバッグツールによって異なります。

表 12-29: [Watches] ウィンドウメニュー – ウィンドウ


New Watch ウォッチに新しいシンボルを追加します。

New Runtime Watch* MPLAB REAL ICE インサーキットエミュレータのみ選択したシンボルに新しいランタイムウォッチを追加します。

Export All Watches to List File

観察するシンボルに関する情報をファイル (.xwatch) にエクスポートします。

Delete All [Watches] ウィンドウから観察対象シンボルを全て削除します。

* コード内のシンボルを右クリックして、[New Watch] または [New Runtime Watch] に追加する事もできます。

表 12-30: [Watches] ウィンドウメニュー – 行メニュー項目説明

New Watch ウォッチに新しいシンボルを追加します。

New Runtime Watch MPLAB REAL ICE インサーキットエミュレータのみ選択したシンボルに新しいランタイムウォッチを追加します。

Run Time Update Interval MPLAB REAL ICE インサーキットエミュレータのみシンボル値の更新速度を指定します。 [No Delay] を選択すると、コンピュータが処理できる大速度で更新します。実行時データにエラーが発生する場合、遅延を追加して更新速度を緩めます。

Export Selected Watches to List File

観察するシンボルに関する情報をファイル (.xwatch) にエクスポートします。<Shift>+ クリック ( 連続した複数行を選択 ) または <Ctrl>+ クリック( 複数行を個別に選択 ) を使って複数の行を選択できます。

Export Data ウォッチデータを CSV ファイルにエクスポートします。または、文字列リテラルとしてエクスポートします。

Delete 選択したシンボル行をウォッチリストから削除します。行を選択して <Delete> キーを押しても削除できます。

Delete All [Watches] ウィンドウから観察対象シンボルを全て削除します。

Display Value Column as 選択した行のシンボルの値を、フォーマット一覧のうちの 1 つで表示します。

User Defined Size プログラムメモリのシンボルのサイズを一覧から指定します。



12.16.4 [Change Visible Columns] ダイアログ

[Watches] ウィンドウに表示される列は変更できます。列見出しを右クリックすると、[Change Visible Columns] ダイアログが開きます。

12.16.5 [Fractional Integer Properties] ダイアログ

このダイアログの目的は、dsPIC および PIC32 デバイスがサポートする全ての固定小数点演算モードを評価しやすくする事です。ポップアップメニュー項目 [DisplayValue Column as] > [Fractional Integer] からこのダイアログを表示してこの機能を選択します。その後、必要に応じて [Display Value Column as] > [Fractional Properties]を選択します。

表 12-31: [Change Visible Columns] の項目

ダイアログ項目チェックを入れた場合

Name 列の名前を表示します。チェックを外す事はできません。

Address 変数のメモリアドレスを表示します。

Binary バイナリ形式の値を表示します。

Char 文字形式の値を表示します。

Decimal 10 進形式の値を表示します。

Hexadecimal 16 進形式の値を表示します。

Type ウォッチ変数の型を表示します。

Value ウォッチ式の値を表示します (16 進 )。

表 12-32: [Fractional Properties] ダイアログの項目

ダイアログ項目説明

Variable 変数の名前です ( 参照用 )。N* 整数を表現するために利用可能な総ビット数です。

Qm 固定小数点データ形式の整数部です。「m」は整数を指定するのに使うビット数を表します。

Qn 固定小数点データ形式の小数部です。「n」は小数を指定するのに使うビット数を表します。

Signed* チェックを入れると、1 ビットを使って符号付き値を表します。

Slider スライダをクリックおよびドラッグして、固定小数点値の計算に適用する固定小数点の位置 (Qm 対 Qn) を選択します。

* 変数タイプが未知の場合、これらの項目は編集可能です。



図 12-9: [Fractional Properties] ダイアログ



12.17 ウィザードウィンドウ

MPLAB X IDE は各種の NetBeans ウィンドウに加えて、組み込み開発用に一部のウィンドウをカスタマイズするか、専用に作成しています。

• [New Project] ウィザード – セクション 4.2「新規プロジェクトの作成」参照

• [New File] ウィザード – セクション 4.9「ファイルの新規作成」参照

• [Import Image File] ウィザード – セクション 5.3.3「[Import Image File] ウィザード」参照


MPLAB® X IDE
ユーザガイド
第 13 章 NetBeans のウィンドウとダイアログ

13.1 はじめに

MPLAB X IDE では、NetBeans のウィンドウと MPLAB X IDE 専用のウィンドウを組み合わせて使います。各種ダイアログは、メニューから対応する項目を選択すると開きます。これらのダイアログも、ウィンドウと同様に NetBeans と MPLAB X IDE のダイアログ両方です。

ここでは、NetBeans のウィンドウとダイアログを解説し、併せて文書への参照情報も示します。MPLAB X IDE 専用のウィンドウとダイアログは第 12 章「MPLAB X IDEのウィンドウとダイアログ」を参照してください。

• NetBeans ウィンドウとウィンドウメニュー

• NetBeans ダイアログ

13.2 NetBeans ウィンドウとウィンドウメニュー

NetBeans ウィンドウの説明は、NetBeans ヘルプまたはウェブ上の文書に記載されています (「序章」参照 )。ウィンドウに関するヘルプを開くには、[Window] タブをクリックで選択してから <F1> キーを押します。必要なヘルプが見つからない場合、[Help] > [Help Contents] を選択し、ヘルプファイルの [Search] タブをクリックすると、そのウィンドウの情報を検索できます。あるいは、NetBeans ヘルプトピック[Managing IDE Windows] を参照してください。

大部分のウィンドウは、セクション 11.2.11「[Window] メニュー」に記載したメニューから開く事ができます。

ウィンドウはドッキング / ドッキング解除でき ([Window] タブを右クリック )、そのウィンドウ専用のポップアップメニュー ( またはコンテクストメニュー ) から [Fill]、[Goto]、[Edit Cells] 等の項目を選択できます。コンテクストメニューは、ウィンドウ内またはウィンドウ内のいずれかのアイテム上で右クリックすると開きます。これらのメニュー項目の大部分は、デスクトップメニューバーからも利用できます ( セクション 11.2「メニュー」参照 )。ウィンドウのプロパティを設定するには、[Tools] > [Options](Mac OS X の場合、[mplab_ide] > [Preferences]) を選択し、[Miscellaneous] ボタンをクリックし、[Appearance] タブを開きます。

13.3 NetBeans ダイアログ

NetBeans ダイアログの説明は、NetBeans ヘルプに記載されています。ダイアログ上の [Help] ボタンをクリックすると、そのダイアログに関するヘルプが開きます。このボタンがない場合、<F1> キーを押します。必要なヘルプが見つからない場合、[Help] >[Help Contents] を選択し、ヘルプファイルの [Search] タブをクリックすると、そのダイアログの情報を検索できます。

大部分のダイアログは、セクション 11.2「メニュー」に記載したメニューから開く事ができます。



NOTE:


MPLAB® X IDE
ユーザガイド
補遺 A コンフィグレーション設定のまとめ

A.1 はじめに

本章では、コード内でコンフィグレーションビットを設定する方法を、各種の言語ツールと関連デバイス向けに例を示しながら説明します。コンフィグレーションビット設定の詳細は言語ツールのマニュアルを参照してください。一部の言語ツールには、デバイスの全てのコンフィグレーション設定の一覧を記載したコンフィグレーション設定マニュアルが用意されています。それ以外の言語ツールに関しては、デバイスのマクロ用ヘッダファイルを参照してください。

コンフィグレーションビットを設定するもう 1 つの方法は、[Configuration Memory]ウィンドウを使ってビットを設定し、[Generate Source Code to Output] をクリックする事です。セクション 4.22.4「コンフィグレーションビットの設定」を参照してください。 8 ビットおよび 16 ビットデバイス向けの MPLAB Code Configurator (MCC) と 32 ビットデバイス向けの MPLAB Harmony は、コンフィグレーションビットとプロジェクトコードの生成に使えるツールです。これらのツールの詳細は Microchip 社のウェブサイトを参照してください。

• XC ツールチェーン

• MPASM ツールチェーン

• C18 ツールチェーン

• HI-TECH® PICC™ ツールチェーン

• HI-TECH® PICC-18™ ツールチェーン

• ASM30 ツールチェーン



A.2 XC ツールチェーン

コードの移植性を大限に高めるには、以下の各文書の「CCI (Common CompilerInterface)」の章、config macro のセクションを参照してください。

•『MPLAB XC8 C Compiler User’s Guide』(DS50002053) または対応するヘルプファイル

•『MPLAB XC16 C Compiler User’s Guide』(DS50002071) または対応するヘルプファイル

•『MPLAB XC32 C/C++ コンパイラユーザガイド』(DS50001686) または対応するヘルプファイル



A.3 MPASM ツールチェーン

デバイスコンフィグレーションビットの設定には、2 種類のアセンブラディレクティブ(__configと config) を使います。同一コード内で __configと configの両方を使う事はできません。

A.3.1 __config

ディレクティブ「__config」は PIC10/12/16 MCU 用に使います。PIC18 MCU(PIC18FXXJ を除く ) にも使えますが、「config」を推奨します。以下に構文を示します。

__config expr ; コンフィグレーションワードが 1つだけの場合

または

__config addr, expr ; コンフィグレーションワードが複数の場合

マクロはデバイスインクルードファイル (*.inc) で定義されます。Windows OS の場合、このファイルは以下の既定値フォルダに格納されます。

C:\Program Files\Microchip\MPLABX\mpasmxディレクティブの大文字と小文字は区別されないため、__CONFIG と __config のどちらでも使えます。マクロの大文字 / 小文字は、ヘッダファイル内の記述に合わせる必要があります。

例 – PIC10/12/16 MCU の場合

#include p16f877a.inc

;Set oscillator to HS, watchdog time off, low-voltage prog. off__CONFIG _HS_OSC & _WDT_OFF & _LVP_OFF例 – PIC18 MCU の場合

#include p18f452.inc

;Oscillator switch enabled, RC oscillator with OSC2 as I/O pin.__CONFIG _CONFIG1, _OSCS_OFF_1 & _RCIO_OSC_1

;Watch Dog Timer enable, Watch Dog Timer PostScaler count - 1:128__CONFIG _CONFIG3, _WDT_ON_3 & _WDTPS_128_3

A.3.2 config

ディレクティブ「config」は、PIC18 MCU (PIC18FXXJ を含む ) 用に使います。以下に構文を示します。

config setting=value [, setting=value]


C:\Program Files\Microchip\MPLABX\mpasmx

addr: コンフィグレーションワードのアドレスです。リテラルでも指定できますが、通常はマクロにより表現します。Note: マクロは、レジスタ番号順 ( 昇順 ) に列記する必要があります。

expr: 指定したコンフィグレーションビットに設定する値を表現する式です。リテラルでも指定できますが、通常はマクロまたは複数マクロの論理積 (AND) により表現します。

setting: コンフィグレーションビットを表現するマクロです。

value: 指定したコンフィグレーションビットに設定する値を表現するマクロです。カンマで区切る事により、一行で複数の設定を定義できます。1 つのコンフィグレーションバイトの設定を複数行に分けて定義する事もできます。


コンフィグレーション設定のまとめ

ディレクティブの大文字と小文字は区別されないため、__CONFIG と __config のどちらでも使えます。マクロの大文字 / 小文字は、ヘッダファイル内の記述に合わせる必要があります。

例 – PIC18 MCU の場合

#include p18f452.inc

;Oscillator switch enabled, RC oscillator with OSC2 as I/O pin.CONFIG OSCS=ON, OSC=LP

;Watch Dog Timer enable, Watch Dog Timer PostScaler count - 1:128CONFIG WDT=ON, WDTPS=128

A.4 C18 ツールチェーン

ディレクティブ「#pragma config」は、アプリケーションで使うデバイスに固有のコンフィグレーション設定 ( コンフィグレーションビット ) を指定します。

# pragma config setting-list

マクロはデバイスヘッダファイル (*.h) で定義されます。Windows OS の場合、このファイルは以下の既定値フォルダに格納されます。

C:\program files\microchip\mplabc18\vx.xx\.hpragma の大文字と小文字は区別されないため、#PRAGMA CONFIG と #pragmaconfigのどちらでも使えます。マクロの大文字 / 小文字は、ヘッダファイル内の記述に合わせる必要があります。

例

#include <p18cxxx.h>

/*Oscillator switch enabled, RC oscillator with OSC2 as I/O pin.*/#pragma config OSCS = ON, OSC = LP

/*Watch Dog Timer enable, Watch Dog Timer PostScaler count - 1:128*/#pragma config WDT = ON, WDTPS = 128

setting-list: 1 つまたはカンマで区切った複数の「setting-name = value-name」マクロペアです。



A.5 HI-TECH® PICC™ ツールチェーン

htc.hヘッダファイル内で定義されているマクロを使って、PIC10/12/16 MCUのデバイスコンフィグレーションワードを設定します :__CONFIG(x);


C:\Program Files\HI-TECH Software\PICC\vx.xx\includeversionは、コンパイラのバージョン番号です。

複数のコンフィグレーションワードアドレスを持つデバイスでは、__CONFIG() を呼び出すたびに次のコンフィグレーションワードを変更します。

マクロの大文字 / 小文字は、対応するヘッダファイル内の記述に合わせる必要があります。htc.c に対しては大文字の __CONFIG() を使います (__config() は使えません )。

PICC の例

#include <htc.h>

__CONFIG(WDTDIS & XT & UNPROTECT); // Program config. word 1__CONFIG(FCMEN); // Program config. word 2

A.6 HI-TECH® PICC-18™ ツールチェーン

htc.hヘッダファイルで定義されているマクロを使って、PIC18 MCU のデバイスコンフィグレーションワードを設定します :__CONFIG(n,x);上記式において


C:\Program Files\HI-TECH Software\PICC\vx.xx\includeversionは、コンパイラのバージョン番号です。

マクロの大文字 / 小文字は、対応するヘッダファイル内の記述に合わせる必要があります。htc.c に対しては大文字の __CONFIG() を使います (__config() は使えません )。

PICC-18 の例

#include <htc.h>

//Oscillator switch enabled, RC oscillator with OSC2 as I/O pin.__CONFIG(1, LP);

//Watch Dog Timer enable, Watch Dog Timer PostScaler count - 1:128__CONFIG(2, WDTEN & WDTPS128);

x: 指定したコンフィグレーションビットに設定する値を表現する式です。リテラルでも指定できますが、通常はマクロまたは複数マクロの論理積 (AND) により表現します。

n: コンフィグレーションレジスタ番号です。

x: 指定したコンフィグレーションビットに設定する値を表現する式です。リテラルでも指定できますが、通常はマクロまたは複数マクロの論理積 (AND) により表現します。



A.7 ASM30 ツールチェーン

デバイスインクルードファイルで定義されているマクロを使ってコンフィグレーションビットを設定します。

config __reg, value


C:\Program Files\Microchip\MPLAB ASM30 Suite\Support\device\incdeviceは、選択した 16 ビットデバイスの略称です (PIC24H、dsPIC33F)。マクロの大文字 / 小文字は、対応するヘッダファイル内の記述に合わせる必要があります。例えば、ヘッダファイルで小文字の config が使われている場合、大文字のCONFIGは使えません。

詳細は『MPLAB® Assembler, Linker and Utilities for PIC24 MCUs and dsPIC®DSCs User’s Guide』を参照してください。

例

.include "p30fxxxx.inc"

;Clock switching off, Fail-safe clock monitoring off, ; Use External Clockconfig __FOSC, CSW_FSCM_OFF & XT_PLL16

;Turn off Watchdog Timerconfig __FWDT, WDT_OFF


デバイスコンフィグレーションビットの設定には2種類のコンパイラマクロ(PIC24FMCU 用と dsPIC30F/dsPIC33F/PIC24H 用 ) を使います。

A.8.1 PIC24F のコンフィグレーション設定

デバイスヘッダファイルで定義されているマクロを使ってコンフィグレーションビットを設定します。

_confign(value);


C:\Program Files\Microchip\MPLAB C30\support\PIC24F\hマクロの大文字 / 小文字は、対応するヘッダファイル内の記述に合わせる必要があります。例えば、ヘッダファイルで大文字の _CONFIG1が使われている場合、小文字の_config1は使えません。

__reg: コンフィグレーションレジスタ名を表現するマクロです。

value: 指定したコンフィグレーションビットに設定する値を表現する式です。リテラルでも指定できますが、通常はマクロまたは複数マクロの論理積 (AND) により表現します。

n: コンフィグレーションレジスタ番号です。




例 – PIC24F MCU の場合

#include “p24Fxxxx.h”

//JTAG off, Code Protect off, Write Protect off, COE mode off, WDT off_CONFIG1( JTAGEN_OFF & GCP_OFF & GWRP_OFF & COE_OFF & FWDTEN_OFF )

//Clock switching/monitor off, Oscillator (RC15) on,// Oscillator in HS mode, Use primary oscillator (no PLL)_CONFIG2( FCKSM_CSDCMD & OSCIOFNC_ON & POSCMOD_HS & FNOSC_PRI )

A.8.2 dsPIC30F/33F/PIC24H のコンフィグレーション設定

デバイスヘッダファイルで定義されているマクロを使ってコンフィグレーションビットを設定します。

_reg(value);


C:\Program Files\Microchip\MPLAB C30\support\device\hdeviceは、選択した 16 ビットデバイスの略称です (PIC24H、dsPIC30F、dsPIC33F)。マクロの大文字 / 小文字は、対応するヘッダファイル内の記述に合わせる必要があります。例えば、ヘッダファイルで大文字の _FOSC が使われている場合、小文字の_foscは使えません。

詳細は『MPLAB® C Compiler for PIC24 MCUs and dsPIC® DSCs User’s Guide』を参照してください。

例 – dsPIC30F DSC#include “p30fxxxx.h”

//Clock switching and failsafe clock monitoring off,// Oscillator in HS mode_FOSC(CSW_FSCM_OFF & HS);

//Watchdog timer off_FWDT(WDT_OFF);

//Brown-out off, Master clear on_FBORPOR(PBOR_OFF & MCLR_EN);

例 – dsPIC33F/PIC24H#include “p33fxxxx.h”

// Use primary oscillator (no PLL)_FOSCSEL(FNOSC_PRI);

//Oscillator in HS mode_FOSC(POSCMD_HS);

//Watchdog timer off_FWDT(FWDTEN_OFF);

//JTAG off_FICD(JTAGEN_OFF);

_reg: コンフィグレーションレジスタ名を表現するマクロです。





ディレクティブ「#pragma config」は、アプリケーションで使うデバイスに固有のコンフィグレーション設定 ( コンフィグレーションビット ) を指定します :# pragma config setting-list 上記式において


C:\Program Files\Microchip\MPLAB C32\pic32mx\include\procpragma の大文字と小文字は区別されないため、#PRAGMA CONFIG と #pragmaconfigのどちらでも使えます。マクロの大文字 / 小文字は、ヘッダファイル内の記述に合わせる必要があります。

詳細は『MPLAB® C Compiler for PIC32 MCUs User’s Guide』を参照してください。

例

#include “p32xxxx.h”

//Enables the Watchdog Timer,// Sets the Watchdog Postscaler to 1:128#pragma config FWDTEN = ON, WDTPS = PS128

//Selects the HS Oscillator for the Primary Oscillator#pragma config POSCMOD = HS

setting-list: 1 つまたはカンマで区切った複数の「setting-name = value-name」マクロペアです。



NOTE:


MPLAB® X IDE
ユーザガイド
補遺 B IDE 外部での作業手順

B.1 はじめに

MPLAB X IDE は、組み込みシステム向けアプリケーションの書き込み、デバッグ、リリースを支援するように設計されています。しかし、IDE 外部でのコード開発が必要な場合があります。

本章の方法に従うと、MPLAB X IDE の外部でコードをビルドできます。このコードをデバッグする場合、MPLAB X IDE のプロジェクトにコードをインポートできます。詳細はセクション 5.3「プリビルドプロジェクト」とセクション 5.4「読み込み可能なプロジェクト、ファイル、シンボル」を参照してください。

または、デバッグ情報を使ってコードをコンパイルし、コマンドライン MicrochipDebugger (MDB) を使ってコードをデバッグする事もできます。MDB は MPLAB XIDE に付属しています。MDB の詳細は <MPLAB X IDE installation>/docsフォルダの『Microchip Debugger (MDB) ユーザガイド』(DS50002102) を参照してください。

• MPLAB X IDE 外部でのデバッグのためのコンパイル

• MPLAB X IDE の外部でのプロジェクトのビルド

• MPLAB X IDE 外部での Makefile の作成

• リビジョン管理システムの使い方



B.2 MPLAB X IDE 外部でのデバッグのためのコンパイル

MPLAB X IDE 外部でのデバッグ向けにコンパイルするには、コンパイラとリンカに正しいパラメータを渡し、ツールに必要な領域を確保する必要があります。これらのパラメータ値は、デバッグツールとコンパイラによって異なります。また、これらの領域を確保する方法が、コンパイラのバージョンで異なる場合があります。

MPLAB X IDE は、コンパイラ / アセンブラ / リンカに渡す引数を自動的に判断できます。デバッグのための領域を確保する方法を調べる善の方法は、同じデバイス、デバッグツール、コンパイラを使って IDE 内で小さなプロジェクトを作成する事です。その際、同じコンパイラの複数バージョンを IDE がサポートできる事に注意します。そのため、IDE でプロジェクトを作成する際、正しいコンパイラバージョンを選択するように注意します。

プロジェクト作成後、そのプロジェクトをデバッグ用にビルドします。デバッグ用のビルドステップを表示した [Output] ウィンドウのテキストを保存します。次に、プロジェクトを再ビルド ( デバッグ用ではありません ) し、量産用のビルドステップを表示した [Output] ウィンドウのテキストを保存します。コンパイラ / アセンブラ / リンカに渡された 2 組の命令を比較します。

図 B-1: ビルドアイコンメニュー

[Output] ウィンドウの相違点の例を以下に挙げます。

• __DEBUGマクロで呼び出されるコンパイラ / アセンブラ / リンカ

• __MPLAB_DEBUGマクロで呼び出されるコンパイラ / アセンブラ / リンカ

• __ICD2_RAMまたは -mreservesで呼び出されるリンカこれら 2 つは互いに排他的です。つまり、リンカは 2 つのどちらかで呼び出された場合、他方では呼び出されません。

• 使用デバッグツール名で呼び出されるコンパイラ / アセンブラ / リンカ

これは全てを網羅したリストではありません。


IDE 外部での作業手順

B.3 MPLAB X IDE の外部でのプロジェクトのビルド

MPLAB X IDE は、ビルドツールとして GNU Make を使います。MPLAB X IDE と一緒に GNU Make もインストールされます。プログラムの保存場所は以下の通りです。

• Windows 32 ビット OS - C:\Program Files\Microchip\MPLABX\vx.xx\gnuBins\GnuWin32\bin

• Windows 64 ビット OS - C:\Program Files (x86)\Microchip\MPLABX\vx.xx\gnuBins\GnuWin32\bin

• Linux 32/64 OS – /opt/microchip/mplabx/vx.xx/mplab_ide/bin • Mac OS X – /Applications/microchip/mplabx/vx.xx/mplab_ide.app/Contents/Resources/mplab_ide/bin

MPLAB X IDE は、make を含むフォルダを自動的に専用の PATH 変数に追加します。IDE 外でビルドする場合、このフォルダを PATH 環境変数に追加する必要があります。

既定値のコンフィグレーションでビルドする場合、MPLAB X IDE プロジェクトフォルダの Makefileを直接呼び出す事ができます。

プロジェクトに複数のコンフィグレーションがある場合、以下のコマンドを使います。

既定値のイメージ名は以下の通りです (MPLAB X IDE フォルダ基準 )。dist/$CONF_NAME/production/$PROJ_NAME.production.hexdist/$CONF_NAME/debug/$PROJ_NAME.debug.cof(または elf)

コマンド説明

$ make clean 中間オブジェクトと終イメージを全て削除します。

$ make 量産イメージ (HEX ファイル ) を作成します。

$ make TYPE_IMAGE=DEBUG_RUN デバッグイメージ (COF/ELFファイル )を作成します。

コマンド説明

$ make -f Makefile CONF=Configuration clean

Configuration というコンフィグレーションの中間オブジェクトと終イメージを全て削除します。

$ make -f Makefile CONF=Configuration

Configuration というコンフィグレーションの量産イメージ (HEX ファイル ) を作成します。

$ make -f Makefile CONF=Configuration TYPE_IMAGE=DEBUG_RUN

Configuration というコンフィグレーションのデバッグイメージ (COF/ELFファイル )を作成します。



B.4 MPLAB X IDE 外部での Makefile の作成

MPLAB X IDE は、プロジェクトをビルドするのに GNU Make を使います。本書では、IDE の外で MPLAB X IDE プロジェクト向けに Makefile を再生成する方法と、ファイルを再生成しないで Makefile の挙動をカスタマイズ ( プロセッサの変更、機能の追加等、Makefileの動作を変更)する方法を説明します。本書では、コマンドラインからMakefileの make を実行する方法を説明します。

B.4.1 Makefile の作成コンパイラの設定が変わった場合またはファイルが追加 / 削除された場合、MPLAB XIDE は必要に応じて Makefile を作成します。また、prjMakefilesGenerator ユーティリティを使う事で、IDE の外部で Makefile を作成する事もできます。このユーティリティはバッチファイル (Windows 向け ) またはシェルスクリプト (Linux および MacOS X 向け ) です。このユーティリティを使うと、IDE が使う情報と同じもの ( 各 MPLABX IDE プロジェクトの $PROJECT_DIR/nbproject/configurations.xmlファイルに保存されている ) を使って Makefile を再作成できます。初のセクションでは、IDE外部での Makefile の作成方法を説明します。残りのセクションでは、Makefile を再生成しないで、Makefile の挙動を変更し追加のカスタマイズを行う方法を説明します。後者のセクションは、IDE で作成した Makefile または prjMakefilesGeneratorで作成した Makefile( 両者は同じ筈 ) に適用します。

メインの Makefile ファイルは $PROJECT_DIR/Makefileと呼びます。これは、IDEがプロジェクトを作成した時に作成されます。これはユーザが変更できます。ターゲットの中には.build-preのようにユーザが実装できるものがあります。このファイルは再生成される事はありません。その他の Makefile は全て、IDE またはprjMakefilesGeneratorによって再生成されます。これらのフォーマットは以下の通りです。

$PROJECT_DIR/nbproject/Makefile*.mkこれらの nbproject/Makefile*ファイルは、リビジョン管理にコミットしない事を推奨します。その代わり、IDE または prjMakefilesGeneratorを使って必要に応じてこれらのファイルを再作成します。詳細はセクション 5.20「ソースコードの管理」を参照してください。

B.4.2 prjMakefilesGeneratorprjMakefilesGeneratorユーティリティは以下で入手できます。

• Windows の場合 :$inst_mplabx\mplab_ide\bin\prjMakefilesGenerator.bat

• Linux OS の場合 :$inst_mplabx/mplab_ide/bin/prjMakefilesGenerator.sh

• Mac OS X の場合 :$inst_mplabx/mplab_ide.app/Contents/Resources/mplab_ide/bin/ prjMakefilesGenerator.sh

Note: Makefile を IDE のプロジェクトの値と一致させるも安全な方法は、IDEで再生成する方法と、後述する prjMakefilesGeneratorユーティリティを使う方法のどちらかです。IDE は、プロジェクトが開かれた際プロジェクトのメインコンフィグレーション向けに Makefile を再生成します。しかし、Makefile の生成後、Makefile の挙動を変更するその他のカスタマイズ手順が役に立つ場合があります。本書では、これらの手順を説明します。



このユーティリティは nbproject/Makefile*ファイルを再生成します。引数を指定せずにこのユーティリティを実行した場合、以下のヘルプが表示されます。

$ ./prjMakefilesGenerator.sh No project has been specified.There should be at least one.Nothing to do.

Invalid arguments.Usage is: prjMakefilesGenerator [-help] [-v] [-mplabx-userdir=<path>] [project_path[@config_name]*]+

<project_path> - path to the MPLAB-X project in the file system [config_name] - (optional) name of a build configuration to generate the makefile for. If missing, the makefiles are generated for all the build configurations.

-help - displays this help screen. -v - verbose processing. -mplabx-userdir=<path> - the MPLAB-X user directory (useful if you run MPLAB-X with --userdir).

Example: prjMakefilesGenerator /home/usr/prj1@default@custom /home/usr/prj2 /home/usr/prj3@xc16The tool will generate the makefiles for: 1.The configurations named 'default' and 'custom' of the project named 'prj1' 2.All the configurations of the project named 'prj2' (all because none in particular is specified) 3.The configuration named 'xc16' of the project named 'prj3'

このユーティリティ実行するため、その中に Makefile を再生成する MPLAB X プロジェクトフォルダを、引数として渡します。再生成するコンフィグレーションを指定する事もできます。コンフィグレーションを渡さない場合 (@confName なし )、全てのコンフィグレーションに対して全ての Makefile が再作成されます。パラメータとして -mplabx-userdir=<path> を渡す事を推奨します。<path> の値は、IDE の [Help] > [About] ダイアログで「User directory:」の右の欄に表示されている値です。

図 B-2: [Help] > [About] ダイアログ

このダイアログを使うと、IDE と同じコンパイラ一覧に prjMakefilesGeneratorが確実にアクセスできます。



B.4.3 Makefile の説明

前述のようにメインの Makefile は $PROJEC_DIR/Makefile に格納されています。これは、IDE が呼び出す Makefile です。プロジェクトの各コンフィグレーションには、Makefile-local-$conf.mkとMakefile-$conf.mkが存在します ($confはコンフィグレーション名です )。メインの $PROJEC_DIR/Makefileファイルは、これらのコンフィグレーション固有のファイルで make を再度呼び出します。Makefile-local-$conf.mkは、Makefile が生成されたホストに関連するマクロ値を収めています。別のシステムで Makefile-$conf.mkを機能させる場合、このファイルを保存しない事も選択できます。その場合、通常はMakefile-local-$conf.mk内にある全ての値を指定して make を呼び出し、make を実行するホストと一致させる事ができます。この方法は後述します。

prjMakefilesGeneratorを使ってファイルを再作成すると、Makefile-local-$conf.mkがその時点で正しいものとなり、make を実行したマシン上で機能するようになります。

B.4.4 Make 環境 make 処理は、OS ネイティブのコマンドラインから実行する必要があります。これは、Windows では cmd.exeにあたり、Linux/Mac OS X では任意のシェルにあたります。実行する make は GNU Make です。make を実行した際に作成されるイメージには、以下の 2 タイプがあります。 1. 量産イメージ 2. デバッグイメージ既定値では、make 処理を実行すると量産イメージが作成されます。make 処理でデバッグイメージを作成するには、make のコマンドラインに以下を追加する必要があります。

TYPE_IMAGE=DEBUG_RUNデバッグイメージは、MPLAB X IDE がデバッグセッションを実行するのに必要なものを全て含んでいます。この情報はツールによって異なります。Makefile に書き込まれたビルド対象ツールの情報は、この時点では変更できません。この情報は、IDE で選択した値に基づいて各プロジェクトの各コンフィグレーション向けにMakefileを作成した際、Makefile 内にハードコードされています。

B.4.4.1 Windows の Make 環境

make とその他の GNU ツール ( 例 : rm) は、特定のバージョンを使う必要があります。

MPLAB X IDE をインストールする時に、以下のフォルダが作成されます。 $InstallDir\gnuBins\GnuWin32\bin上記の $InstallDirは以下のどちらかです。

• C:\Program Files\Microchip\MPLABX\vx.xx (32 ビットシステム )• C:\Program Files (x86)\Microchip\MPLABX\vx.xx (64 ビットシステム )このフォルダには gnuWin32ツールが収められています。make 処理を実行するにはこれらのツールを使う必要があります。Cygwin またはその他の GNU ポートは使えません。

make 処理を実行する前に、コマンドプロンプトから以下を入力して、上記パスを PCの %PATH%環境変数に設定しておく必要があります。

c:> set PATH=C:\Program Files\Microchip\MPLABX\vx.xx\gnuBins\GnuWin32\bin;%PATH%



B.4.4.2 Mac OS X の Make 環境

Mac コンピュータは、GNU Make 実行ファイルを除く全ての必要なツールをあらかじめ備えています。以下の 2 つの選択肢があります。

1. まず MPLAB X IDE をインストールする ( これにより以下のファイルが作成されます )。/Applications/microchip/mplabx/vx.xx/mplab_ide.app/Contents/Resources/mplab_ide/bin/make次に、make 処理を実行する前に、Make を含むフォルダを以下のようにユーザパスに追加する。

export PATH=/Applications/microchip/mplabx/vx.xx/mplab_ide.app/Contents/Resources/mplab_ide/bin:$PATH

2. X ツールをインストールする ( このツールで /usr/bin/makeに make をインストールします )。

B.4.4.3 Linux の Make 環境

以下の 2 つの選択肢があります。

1. MPLAB X IDE (v2.10 以降 ) をインストールする ( これにより以下のファイルが作成されます )。/opt/microchip/mplabx/vx.xx/mplab_ide/bin/make/opt/microchip/mplabx/vx.xx/mplab_ide/binをユーザパスに追加する。

2. 代表的な Linux ディストリビューションに含まれている GNU Make を使う。Makeが利用できる事を試すには、以下を実行する。 $ which make /usr/bin/make

Make がインストールされていない場合、使用中のシステムのパッケージマネージャを使ってインストールする。

Note: v2.10 より前のバージョンの MPLAB X IDE には、make は含まれていませんでした。従来は、ユーザが自分で make をインストールする必要がありました。v2.10以降、makeはMPLAB X IDEに付属しています。

Note: 64 ビット Linux ディストリビューションを実行中の場合、32 ビットライブラリをインストールしておく必要があります。Microchip 社のコンパイラは 32 ビットアプリケーションであるためです。



B.4.5 Makefile のインターフェイス

指定したコンフィグレーションのターゲットファイルを全て削除する方法

1. カレントフォルダを $PROJECT_DIRに移動する。

2. make -f nbproject/Makefile-debugOption.mk SUBPROJECTS= .clean-conf

これにより debugOption のコンフィグレーションのターゲットファイルに対してクリーンが実行されます。

全てのコンフィグレーションのターゲットファイルを全て削除する方法


2. make clobber

指定したコンフィグレーションの Makefile を実行する方法


2. 環境変数を、make 処理のオーバーライド値に設定する。

3. make -f nbproject/Makefile-$CONFIGURATION_NAME.mk SUBPROJECTS= .build-conf

($CONFIGURATION_NAMEは、実行するコンフィグレーション Makefile の名前です。)

既定値と呼ぶコンフィグレーションは以下の通りです。

make -f nbproject/Makefile-default.mk SUBPROJECTS= .build-confコンフィグレーションの出力は、.cofと .elfのどちらかのデバッグファイルです。量産イメージは .hexファイルです。

dist/$CONFIGURATION_NAME/production/$PROJECT_NAME.production.hexdist/$CONFIGURATION_NAME/debug/$PROJECT_NAME.debug.$COF_OR_ELF($COF_OR_ELF は、cof と elf のどちらかです。$PROJECT_NAME はプロジェクト名です。)

B.4.6 make 処理を制御する環境変数

make 処理を制御する変数を設定するには 4 つの方法があります。

• 環境変数を使い、「-e」オプションを使って Make を呼び出す。

$ export MC_CC=/opt/microchip/xc16/v1.21/bin/xc16-gcc $ make -e

• Make を呼び出す際にコマンドラインで変数を設定する。例 :$ make MC_CC=/opt/microchip/xc16/v1.21/bin/xc16-gcc

• 使用中のマシン向けにnbproject/Makefile-local-$conf.mkを作成する。環境変数の値をその中に含める。

• prjMakefilesGeneratorにマシン向けのnbproject/Makefile-local-$conf.mkファイルを作成させる。

オーバーライドされない変数は Makefile のマクロ値を取ります。Makefile には、これらのマクロの全ての既定値を格納する領域があります。そのため、必要に応じてオーバーライドしても、残りの領域は Makefile の既定値として保護されます。

Windows でパスを入力する場合、以下のように入力する必要があります。

"C:/Program\ Files/Microchip/xc16/bin/xc16-gcc.exe"フォルダの区切り文字に「/」を使い、スペース文字は「\」でエスケープします。

後に、コマンドラインから実行する場合、全体を引用符で囲みます。



B.4.6.1 ツールの名前 / 格納場所を制御する変数

以下の変数はオーバーライドできます。

# 例 (*nix):make MP_CC=/opt/microchip/mplabc30/v3.24/bin/pic30-gcc # 例 (Windows):make "C:/Program\ Files/Microchip/xc16/bin/xc16-gcc.exe"

B.4.6.2 プロセッサ選択を制御する変数

MP_PROCESSOR_OPTION は、プロセッサ名を設定するのに使う主要な変数です。コンパイラによって必要とするプロセッサ名が異なる事に注意する必要があります。PIC を追加するものもあれば、小文字の「f」を使うものもあります。MPLAB X IDEが生成する Makefile は正しい値を持っています。MP_PROCESSOR_OPTIONを使ってこれらの値をオーバーライドする場合、名前が正しい事を確認する必要があります。

MPLAB X IDE v2.00 までは、デバッガに割り当てられたメモリ領域の一覧を含むリンク行を使ってデバッグイメージを作成します。この一覧はデバイスによって異なります。例として、MPLAB XC16 プロジェクトのデバッグイメージを作成するためのリンク行を以下に示します。

?/opt/microchip/xc16/v1.21/bin/xc16-gcc" -o dist/default/debug/Explorer16dsPIC33F_1.X.debug.elf build/default/debug/main.o -mcpu=33FJ128GP710 -D__DEBUG -D__MPLAB_DEBUGGER_REAL_ICE=1 -omf=elf -mreserve=data@0x800:0x81F -mreserve=data@0x820:0x821 -mreserve=data@0x822:0x823 -mreserve=data@0x824:0x825 -mreserve=data@0x826:0x84F -Wl,,--defsym=__MPLAB_BUILD=1,--defsym=__MPLAB_DEBUG=1,--defsym=__DEBUG=1,--defsym=__MPLAB_DEBUGGER_REAL_ICE=1,,--script=p33FJ128GP710.gld,--check-sections,--data-init,--pack-data,--handles,--isr,--no-gc-sections,--fill-upper=0,--stackguard=16,--no-force-link,--smart-io,-Map="dist/default/debug/Explorer16dsPIC33F_1.X.debug.map"

上記に太字で示す保護領域はデバイスによって異なります。プロセッサごとのデバッグイメージを作成する場合、IDE 内でプロセッサを変更し、prjMakefilesRegeneratorを使って Makefile を作成する事を推奨します。

MP_CC C コンパイラ実行ファイル名へのフルパス

MP_BC Basic コンパイラ実行ファイル名へのフルパス

MP_AS アセンブラ実行ファイル名へのフルパス

MP_LD リンカ実行ファイル名へのフルパス

MP_AR アーカイバ実行ファイル名へのフルパス

MP_CC_DIR C コンパイラ実行ファイルへのフォルダ

MP_BC_DIR Basic コンパイラ実行ファイルへのフォルダ

MP_AS_DIR アセンブラ実行ファイルへのフォルダ

MP_LD_DIR リンカ実行ファイルへのフォルダ

MP_AR_DIR アーカイバ実行ファイルへのフォルダ

Note: MPLAB X IDE v2.00 以降、MPLAB XC コンパイラ、PIC18 MCU 用 MPLABC コンパイラ、MPASM アセンブラの新バージョン向けに生成したMakefile は、MP_PROCESSOR_OPTION の値を変更するだけでは別のプロセッサで使えません。これはデバッグイメージのためだけのものです。それでも、MP_PROCESSOR_OPTION の値を変更する事で各種デバイス向けの HEX ファイルを作成する事はできます。



下表に示すバージョンのツールは、-mreserve キーワードをサポートしています。またはその他の方法でデバッグ領域の一覧を引数として渡します。正しいデバッグ領域をリンカに渡すデバッグイメージを生成するには、prjMakefilesRegeneratorを実行する必要があります。MP_PROCESSOR_OPTIONを変更するだけでは不十分です。

B.4.6.3 特殊なリンクの要求を制御する変数

ツールによっては、MP_LINKER_FILE_OPTION マクロで実行できる特殊なリンカファイルの処理を必要とします。

XC16 および C30/ASM30 ツールチェーンは、プロジェクトがリンカスクリプトを含むかどうかによって製品名またはファイル名をこのオプションで指定する必要があります。

MPASM/C18 ツールチェーンは、デバッグ実行ファイルの格納場所をこのオプションで指定する必要があります。

これらの変数の詳細は、本書の関連するツールチェーンのセクションで説明します( セクション B.4.7「各言語ツールに固有の注意事項」参照 )。

B.4.6.4 コマンドラインを変更するための変数

以下の _PREと _POSTの変数は全く任意です。これらは、コマンドラインのカスタマイズを可能にするためだけのものです。これらを定義しなくても make は実行できます。

多くのコンパイラ (gcc ベースのコンパイラ等 ) は、専用のメインシェルプログラムを使ってリンカ / アセンブラを呼び出します。これらのコマンドラインは第 1 の部分(MP_EXTRA_XX_PREが置かれている部分 ) と第 2 の部分 (MP_EXTRA_XX_POSTが置かれている部分 ) から成り、通常第 2 の部分がリンカ / アセンブラに渡されます。これが、ツールの挙動を変更できるようにするためにツールごとに 2 つのマクロが必要な理由です。

gcc ベースのコンパイラのリンク行の例を以下に示します。

${MP_CC} -omf=elf ${MP_PROCESSOR_OPTION_LD} ${MP_EXTRA_LD_PRE} -o dist/$(CND_CONF}/${IMAGE_TYPE}/Explorer16PIC24DSC_1.${IMAGE_TYPE}.elf ${OBJECTFILES} -Wl,--defsym=__MPLAB_BUILD=1,--report-mem,-Tp24FJ128GA010.gld${MP_EXTRA_LD_POST} この場合、MP_EXTRA_LD_PRE はシェルに対して -Wl の前に発行され、MP_EXTRA_LD_POSTは後に発行されます。ユーザは、有効なオプションを渡す必要があります (言語ツールの文書を参照してください )。-Wlの前に含めるオプションには、区切り文字にスペースを使います。 MP_EXTRA_LD_PRE= -D_FOO -D_BAR また、-Wlの後に含めるオプションには、区切り文字にカンマを使います。 MP_EXTRA_LD_POST=--defsym=_FOO,--defsym=_BAR ツールチェーンがドライバシェル (gcc 等 ) の使用をサポートしていない場合、単に_PRE変数を使います。

ツールチェーンサポートする初のバージョン

このバージョン以降の全てのバージョンは -mreserve を発行します。

MPASMX 5.54C18 3.47XC8 1.00

XC16 1.21XC32 1.30

MP_EXTRA_CC_PRE MP_EXTRA_CC_POSTMP_EXTRA_BC_PRE MP_EXTRA_BC_POSTMP_EXTRA_AS_PRE MP_EXTRA_AS_POSTMP_EXTRA_AR_PRE MP_EXTRA_AR_POSTMP_EXTRA_LD_PRE MP_EXTRA_LD_POST



B.4.7 各言語ツールに固有の注意事項

各ツールチェーンに必要な変数以外に、以下を設定する必要があります。

• ツールの格納場所 ( 例 : MP_CC, MP_AS)• ツールをインストールしたフォルダ ( 例 : MP_CC_DIR, MP_AS_DIR)

B.4.7.1 MPASM

このツールチェーンに必要なマクロは以下の通りです。

• MP_PROCESSOR_OPTION • MP_LINKER_DEBUG_OPTION

定義がない場合 MP_LINKER_DEBUG_OPTIONは定義する必要があります(MP_LINKER_DEBUG_OPTION=)。このマクロはデバッグイメージをビルドする時にのみ使います。プロセッサが変わる場合、デバッグ実行ファイルの格納場所とデバッグ実行ファイルの使用データ量の変化に応じてこのマクロも変更する必要があります。この変数を設定しなくてもリンカは正常にビルドを実行します。しかし、コード / データをデバッグ実行ファイルの前に置くといった問題は、リンカには全く伝わりません。従って、正しい値に設定するのが善の方法です。正しい値を得るには、正しいデバイスを使って MPLAB X IDE プロジェクトを作成しデバッグ実行します。または、prjMakefilesGeneratorを使って Makefile を作成します。

このツールチェーンの選択可能なマクロは以下の通りです。

• MP_EXTRA_AS_PRE • MP_EXTRA_LD_PRE( スタンドアロンプロジェクト向け )• MP_EXTRA_AR_PRE( ライブラリプロジェクト向け )

B.4.7.2 C18


• MP_PROCESSOR_OPTION • MP_CPP • MP_PROCESSOR_OPTION_LD • MP_LINKER_DEBUG_OPTION

MP_LINKER_DEBUG_OPTIONの使い方の説明はセクション B.4.7.1「MPASM」を参照してください。

このリンカは mcc18 コンパイラとは異なる文字列を使うため、リンカ向けの別のプロセッサオプション (MP_PROCESSOR_OPTION_LD) が含まれています。このリンカは、

「全て小型英大文字」に適合します。


• MP_EXTRA_AS_PRE • MP_EXTRA_LD_PRE( スタンドアロンプロジェクト向け ) • MP_EXTRA_AR_PRE( ライブラリプロジェクト向け )• MP_EXTRA_CC_PRE



B.4.7.3 XC16, C30, C24, dsPIC

XC16ツールチェーンはC30ツールチェーンのアップグレードです。C24およびdsPICツールチェーンは C30 のサブセットです。

これらのコンパイラには、異なるツールチェーンが対応します。これらは全て同じオプションを使います。

これらのツールチェーンに必要なマクロは以下の通りです。

• MP_PROCESSOR_OPTION • MP_LINKER_FILE_OPTION

MP_LINKER_FILE_OPTIONは以下の 2 つの文字列のうちのどちらかです。

1. “,--script=myScript24FJ256GB106.gld” – プロジェクトがリンカスクリプトを含む場合、この文字列を使います ( この場合、myScript24FJ256GB106.gld)。

2. “,-Tp24FJ256GB106.gld ”– プロジェクトがリンカスクリプトを含まない場合、この文字列を使います。インストール内の既定値のリンカスクリプト名を使います( この場合、p24FJ256GB106.gld)。Linux では、.gldファイルの名前は大文字と小文字を区別します。

これらのツールチェーンの選択可能なマクロは以下の通りです。

• MP_EXTRA_CC_PRE • MP_EXTRA_AS_PRE • MP_EXTRA_AS_POST • MP_EXTRA_AR_PRE( ライブラリプロジェクト向け ) • MP_EXTRA_AR_POST( ライブラリプロジェクト向け ) • MP_EXTRA_LD_PRE( スタンドアロンプロジェクト向け ) • MP_EXTRA_LD_POST( スタンドアロンプロジェクト向け )

B.4.7.4 ASM30

ASM30 ツールチェーンは MPLAB X IDE の v1.30 以降には付属していません。代わりに XC16 アセンブラを使います。



MP_LINKER_FILE_OPTIONの使い方の説明はセクション B.4.7.3「XC16, C30, C24,dsPIC」を参照してください。


• MP_EXTRA_AS_PRE • MP_EXTRA_AR_PRE( ライブラリプロジェクト向け )• MP_EXTRA_LD_PRE( スタンドアロンプロジェクト向け )



B.4.7.5 XC32, C32

XC32 ツールチェーンは C32 ツールチェーンのアップグレードです。



MP_LINKER_FILE_OPTIONは以下の 2 つの文字列のうちのどちらかです。

1. “,--script=myScript32X.gld” – プロジェクトがリンカスクリプトを含む場合、この文字列を使います ( この場合、myScript32X.gld)。

2. “” – プロジェクトがリンカスクリプトを含まない場合、空の文字列を使います。


• MP_EXTRA_CC_PRE • MP_EXTRA_AS_PRE • MP_EXTRA_AS_POST • MP_EXTRA_AR_PRE( ライブラリプロジェクト向け )• MP_EXTRA_AR_POST( ライブラリプロジェクト向け )• MP_EXTRA_LD_PRE( スタンドアロンプロジェクト向け )• MP_EXTRA_LD_POST( スタンドアロンプロジェクト向け )

B.4.7.6 XC8 および HI-TECH コンパイラ (PICC, PICC18-STD, PIC18-PRO, dsPIC, PIC32)

XC8 ツールチェーンは、PICC および PICC18 ツールチェーンのアップグレードです。


• MP_PROCESSOR_OPTION

MP_PROCESSOR_OPTIONはこれらのコンパイラごとに異なります。MPLABXによる名前を使うと、以下の Java コードを使って「コンパイラ」名を得る事ができます。

public static String getProcessorNameForCompiler(String deviceName) { String res = deviceName; String lowerCaseDeviceName = deviceName.toLowerCase(); if (lowerCaseDeviceName.startsWith("pic")) res = deviceName.substring(3); else if (lowerCaseDeviceName.startsWith("rfpic")) res = deviceName.substring(5); else if (lowerCaseDeviceName.startsWith("dspic")) res = deviceName.substring(5); return res;}deviceNameは「MPLABX」の名前です。


• MP_EXTRA_CC_PRE • MP_EXTRA_AS_PRE • MP_EXTRA_LD_PRE( スタンドアロンプロジェクト向け )これらのツールチェーンはライブラリプロジェクトをサポートしません。

B.5 リビジョン管理システムの使い方

IDE の外部でファイルを変更する場合、これらのファイルをリビジョン管理システムに登録しようとする際に競合が発生する可能性があります。これらの問題を解決するにはセクション 5.20.2.3「リビジョン管理されたファイルの競合の解消」を参照してください。



NOTE:


MPLAB® X IDE
ユーザガイド
補遺 C 改訂履歴

リビジョン A (2011 年 11 月 )• 本書は初版です。

リビジョン B (2012 年 10 月 )• Windows および Linux オペレーティングシステムで JRE のインストールが自動化されました。Mac オペレーティングシステムにおける手順を記載しました。第 2 章

「使用前の準備」、2.2「JRE と MPLAB X IDE のインストール」で解説しました。

• 第 2 章、デバイスドライバの名称とパスに関する情報を修正しました。

• 第 3 章「チュートリアル」と第 4 章「基本作業」に、デバッグツールの横に表示される 2 つのマーク ( 信号灯 ) が表す意味の説明を追加しました。

• 第 3 章「チュートリアル」と第 4 章「基本作業」のアイコン定義を更新しました。

• 第4章「基本作業」、4.3「新規プロジェクトの作成」、4.3.6「Step 6: Select Compiler」に、言語ツールチェーンの略号の一覧表を追加した。

• 新しいMPLAB XC Cコンパイラを使ってプロジェクトを表示する複数のダイアログを更新しました。

• 第 4 章「基本作業」、4.12「ライブラリやオブジェクトファイルの追加とセットアップ」に、[Project Properties] ダイアログの [Libraries] カテゴリに関する情報を追加しました。

• 第 4 章「基本作業」、4.14「ビルドプロパティの設定」に、HEX ファイルの正規化に関する情報を追加しました。

• 第 4 章「基本作業」、4.20「シンボル値の変化の観察」に、[Watches] ウィンドウへのリテラル値追加の方法に関する情報を追加しました。

• 新の C++ サポート ( 現状では、MPLAB XC32++ コンパイラ ) について複数のセクションを更新しました。

• 第 5 章「追加作業」、5.5「読み込み可能なプロジェクトとファイル」に、読み込み可能プロジェクトに関するセクションを追加しました。

• 第 5 章「追加作業」、5.7「その他の組み込みプロジェクト」で、他のアプリケーションから組み込みプロジェクトをインポートする方法を解説しました。

• 第 5 章「追加作業」、5.8「サンプルプロジェクト」に、サンプルプロジェクトを使った作業に関する情報を追加しました。

• 第 5 章「追加作業」、5.9「他のタイプのファイルを使った作業」で、XML 等の他のタイプのファイルによる作業方法を説明しました。

• 第 6 章「高度な作業」、6.4「ログデータ」に、ログファイルの使い方に関する情報を追加しました。

• 第 6 章「高度な作業」、6.5「ツールバーのカスタマイズ」で、ツールバーへの機能追加方法を説明しました。

• MPLAB X IDE エディタの使い方、オプション、機能を解説する第 7 章「エディタ」を追加しました。

• 既定値のリンカスクリプトを変更または移動した場合に表示される可能性があるエラーメッセージに関する情報と、その回避策を説明しました。第 8 章「トラブルシュート」、8.4「MPLAB X IDE の問題」を参照してください。

•「主な相違点」と「機能上の相違点」を、第 9 章「MPLAB X IDE と MPLAB IDE v8の相違点」、9.2「主な相違点」に統合しました。NetBeans プラットフォームがオープンソースであるのに対し、MPLAB X IDE は独自製品である事を説明しました。



• 第 9 章「MPLAB X IDE と MPLAB IDE v8 の相違点」、9.4「メニューの相違点」を MPLABX IDE の新機能を反映するように更新しました。また、9.4「ツールのサポートに関する相違点」を新しいプラグインのサポートを反映するように更新しました。

• 第 10 章「デスクトップの詳細」、10.2「メニュー」を MPLAB X IDE の新機能を反映するように更新しました。

•「ウィンドウとダイアログ」を第 11 章「MPLAB X IDE のウィンドウとダイアログ」と第 12 章「NetBeans のウィンドウとダイアログ」に分割し、各種ウィンドウをより正確に記述しました。ウィンドウのメニューを更新しました。

• 第 13 章「プロジェクトファイルおよびフォルダ」、13.3「[Files] ウィンドウの表示」のプロジェクトファイルの構造を更新しました。Makefile ファイルに関する情報を追加しました。

• 第 14 章「コンフィグレーション設定のまとめ」、14.9「XC ツールチェーン」で、MPLAB XC C コンパイラのコンフィグレーションビットの解説に、CCI (CommonC Interface) への参照を追加しました。

リビジョン C (2014 年 3 月 )• 全体の変更 : 古いツールへの参照を削除しました。Windows 8 に関する情報を追加しました。新の GUI と一致するように画面とテキストを更新しました。

• 第 1 章「MPLAB X IDE とは」: 図の参照を更新しました。資料としてスタンドアロンツールのヘルプと Microchip Wiki に言及しました。

• 第 2 章「使用前の準備」: 2.3.2「Windows® XP/7/8 OS 用の USB ドライバのインストール」の内容を更新しました。2.5「言語ツールのインストール」にコンパイラのライセンスに関する情報を追加しました。2.7.1「複数のインスタンスを使うためのハードウェアツールの設定方法」を追加しました。

• 第 4 章「基本作業」: 4.1「はじめに」を削除しました。4.6.1「ツールチェーンの追加または変更」と 4.6.2「ツールチェーンパス」を追加しました。4.12「ファイルおよびフォルダプロパティの設定」に、ビルドからファイル / フォルダを除く方法を追加しました。4.13「ビルドプロパティの設定」の各セクションに、表 4-3 を拡張しました。4.15.2「実行に関する注意事項」を追加しました。4.16.2「デバッグ用マクロの生成」と 4.16.3「デバッグに関する注意事項」を追加しました。4.19「シンボル値の変化の観察」にシンボル情報を追加しました。4.21.2「デバイスメモリの変更」を更新しました。4.23.1「プロジェクトのプログラミングプロパティの設定」を追加しました。

• 第 5 章「追加作業」: 5.1「はじめに」を削除しました。5.4「読み込み可能なプロジェクトとファイル」を更新しました。新規のセクション (5.5「読み込み可能なプロジェクトとファイル – ブートローダ」) を追加しました。5.12「プロジェクトフォルダとエンコードの変更」と 5.13「ビルド時間の短縮」を追加しました。5.17「ダッシュボードの表示」の新規の表示オプションと一致するようにテキストを更新しました。5.19「ソースコードの管理」で、バージョン管理手順の使い方を修正し、リポジトリに保存する必要があるプロジェクトファイルを更新しました。5.20「コード開発とエラー追跡の連携」のオプションを更新しました。5.21「プラグインツールの追加」と 5.21.4「プラグインコードの格納場所」のセクションを並べ換えました。

• 第 6 章「高度な作業」: 6.1「MPLAB X IDE の高速化」と 6.5「ユーザ Makefile プロジェクトの作成」を追加しました。6.3「複数プロジェクトを使った作業」に、アクティブなプロジェクトを設定しない作業とプロジェクトのグループ化に関する情報を追加しました。6.4「複数コンフィグレーションを使った作業」から、デバッグコンフィグレーションが必要としていた文を削除しました。6.6「ログファイル」のログファイルの要件を更新しました。

• 第 7 章「エディタ」: 「注目すべきエディタ機能」を、7.2「エディタの使い方」の7.2.4 に移動しました。また 7.2.1「デスクトップの制御」、7.2.2「C コードのハイパーリンク」、7.2.3「ASM コードのハイパーリンク」を追加しました。表 7-6

「[Macros] タブ」のマクロの定義を拡張しました。7.4「コード折り畳み」を 7.4.1「コード折り畳みの使い方」(MPLAB C18 とアセンブリの折り畳みの問題を含む ) と7.4.2「コード折り畳みのカスタマイズ」に再構成しました。


• 第 8 章「プロジェクトファイルおよびフォルダ」: この章は第 13 章から移動しました。8.4「[Favorites] ウィンドウの表示」、8.5「[Classes] ウィンドウの表示」、8.6

「ユーザコンフィグレーションデータの表示」、8.9「プロジェクトの削除」を追加しました。「プロジェクトの移動」を 8.8「プロジェクトの移動、コピー、リネーム」に変更しました。「MPLAB X IDE の外部でのプロジェクトのビルド」を補遺 B「IDE外部での作業手順」に移動しました。

• 第 9 章「トラブルシュート」: 9.6「エラー」に情報を追加しました。

• 第 10 章「MPLAB X IDE と MPLAB IDE v8 の相違点」: 10.2「主な相違点」の第 3項「MPLAB X IDE では、複数のツールを選択できます。」と第 9 項「MPLAB X IDEでは、コード内に設定されたコンフィグレーションビットを使います。」を明確にしました。MPLAB X IDE のその他の選択肢の細部を修正しました。

• 第 11 章「デスクトップの詳細」: プラグインとコンパイラライセンスについて11.2.10「[Tools] メニュー」を更新しました。MPLAB X IDE のその他の選択肢の細部を修正しました。

• 第 12 章「MPLAB X IDE のウィンドウとダイアログ」: 12.2「MPLAB X IDE のウィンドウの管理」を追加しました。12.3「MPLAB X IDE のウィンドウと関連するメニューとダイアログ」で、新規ウィンドウを表に追加し、各種ウィンドウのサブセクションをそれぞれ専用のセクションに移動しました。12.4「[Breakpoints] ウィンドウ」と 12.6「[Licenses] ウィンドウ」を追加しました。12.8「[Memory] ウィンドウ」の各種メモリのウィンドウの説明を追加するために大幅に更新しました。12.11

「[Projects] ウィンドウ」のメニューを更新しました。12.12「[Tools] > [Options] >[Embedded] ウィンドウ」のオプションを更新し、12.12.5「[Diagnostics] タブ」を追加しました。12.14「[Watches] ウィンドウ」の内容を 3 つに分割しました。

• 補遺 A: 「コンフィグレーション設定」: 第 14 章から補遺に変更しました。[Configuration Memory] ウィンドウに関する情報を追加しました。

• 補遺 B: 「IDE 外部での作業手順」: 第 8 章「プロジェクトファイルおよびフォルダ」から B.1「MPLAB X IDE の外部でのプロジェクトのビルド」に移動しました。B.2「MPLAB X IDE 外部でのデバッグのためのコンパイル」を追加しました。

• 補遺 C: 「改訂履歴」: バージョン B から C への主な変更に対応してこの章を更新しました。

リビジョン D (2015 年 9 月 )• MPLAB X IDE v3.00 (NetBeans 8.1 プラットフォーム ) の画像を更新しました。

• [MPLAB X Store] のタブ、アイコン、ヘルプメニュー項目に関する情報を追加しました。

• [Help] > [Tool Help Contents] の個別のヘルプファイルに関する情報を追加しました。

• 第 2 章 : 2.6「[Start Page] からのアクセス情報」: 情報を更新しました。

• 第 2 章 : 2.9「IDE で複数のバージョンを使う方法」: バージョンの実行を明確にしました。

• 第 4 章 : 4.13「ビルドプロパティ」: 「プロジェクトコンフィグレーションタイプの変更」を追加しました。

• 第 4 章 : 4.2.2「Step 2: Select Device」: LF デバイスに関する情報を追加しました。

• 第 5 章 : 5.6「ライブラリプロジェクト」: 「プロジェクトコンフィグレーションタイプの変更」のセクションへのリンクを追加しました。

• 第 6 章 : 章の名前を「高度な作業とコンセプト」に変更しました。グループ化のセクションを追加しました。「サードパーティ製ハードウェアツール」と「コンフィグレーション」のセクションを追加しました。「ユーザ Makefile プロジェクトの作成」のセクションの内容を更新し、例を追加しました。

• 第 9 章 : 9.6「エラー」:「HEXMATE Conflict Report Address Error」と「プログラムエラー」を追加しました。

• 第 12 章 : 12.4「[Watches] ウィンドウ」: 「[Watches] の表示」と「[Watches] メニュー」のセクションの位置を入れ換えました。メニューのセクションに内容を追加しました。「[Fractional Integer Properties] ダイアログ」のセクションを追加しました。



• 第 12 章 : 12.7.5「[EE Data Memory] ウィンドウ」: デバッグ中またはデバッグセッション後の読み出しに関する文章を更新しました。開始アドレスの表を更新しました。

• 第 12 章 : 12.10「[Message Center] ウィンドウ」を追加しました。

• 補遺 B: 既存のセクションを並べ換え、「MPLAB X IDE 外部での Makefile の作成」のセクションを追加しました。


MPLAB® X IDE
ユーザガイド
サポート

はじめに

以下ではサポートについて説明します。

• 保証登録

• myMicrochip 変更通知サービス

• Microchip 社のウェブサイト

• Microchip フォーラム

• お客様サポート

• Microchip 社への問い合わせ

保証登録

ウェブサイト : http://www.microchipdirect.com開発ツールをご登録頂いたお客様には新製品情報をお届けします。ソフトウェアのマイナーリリースは弊社ウェブサイトで提供しています。


http://www.microchipdirect.com


myMicrochip 変更通知サービス

myMicrochip: http://www.microchip.com/pcn

Microchip 社のお客様向け変更通知サービスは、お客様に Microchip 社製品の新情報をお届けするサービスです。ご興味のある製品ファミリまたは開発ツールに関する変更、更新、リビジョン、エラッタ情報をいち早くメールにてお知らせします。

myMicrochip からサービスに登録し、変更通知の配信をご希望になる製品カテゴリをお選びください。よく寄せられる質問 (FAQ) と登録方法の詳細も、上記のリンク先ページからご覧になれます。

配信を希望する変更通知の製品カテゴリをお選びになる際に、「DevelopmentSystems」を選択すると、開発ツールのリストがご覧になれます。ツールの主なカテゴリは以下の通りです。

• コンパイラ - Microchip 社の C コンパイラ、アセンブラ、リンカ、その他の言語ツールの新情報を提供します。これには MPLAB XC コンパイラ全製品 (MPLAB XC8,MPLAB XC16, MPLAB XC32)、従来の MPLAB C コンパイラ、MPASM™ アセンブラ、MPLINK™ オブジェクトリンカ、MPLIB™ オブジェクトライブラリアンが含まれます。

• エミュレータ – Microchip社製インサーキットエミュレータの新情報を提供します。これには MPLAB REAL ICE™ インサーキットエミュレータが含まれます。

• インサーキットデバッガ - Microchip 社製インサーキットデバッガの新情報を提供します。これには PICkit™ 3、MPLAB ICD 3 インサーキットデバッガが含まれます。

• MPLAB® X IDE － Microchip 社の MPLAB X IDE( 開発システムツール向け統合開発環境 ) の新情報を提供します。これには MPLAB X IDE、MPLAB X IDE プロジェクト、MPLAB X エディタ、MPLAB X シミュレータと一般的な編集 / デバッグ機能が含まれます。

• プログラマ - Microchip 社製プログラマの新情報を提供します。これにはデバイス( 量産 ) プログラマ MPLAB REAL ICE インサーキットエミュレータ、MPLAB ICD3インサーキットデバッガ、MPLAB PM3、開発用プログラマPICkit 3が含まれます。

• スタータ / デモボード – これには MPLAB スタータキットボード、PICDEM デモボード、その他の各種評価用ボードが含まれます。

Microchip 社のウェブサイト

ウェブサイト : http://www.microchip.comMicrochip 社は自社が運営するウェブサイトを通してオンラインサポートを提供しています。このウェブサイトを通じて、お客様はファイルと情報を簡単に入手できます。一般的なインターネットブラウザから以下の内容がご覧になれます。

• 製品サポート - データシートとエラッタ、アプリケーションノートとサンプルプログラム、設計リソース、ユーザガイドとハードウェアサポート文書、新のソフトウェアと過去のソフトウェア

• 技術サポート - よく寄せられる質問 (FAQ)、技術サポートのご依頼、オンラインディスカッショングループ、Microchip 社のコンサルタントプログラムメンバーの一覧

• Microchip 社の事業 – プロダクトセレクタガイドとご注文案内、プレスリリース、セミナーとイベントの一覧、営業所の一覧


http://www.microchip.com/pcn


サポート

Microchip フォーラム

フォーラム : http://www.microchip.com/forumsMicrochip 社のウェブフォーラムからもオンラインサポートをご利用頂けます。現在、以下のフォーラムを開設しています。

• 開発ツール

• 8 ビット PIC MCU• 16 ビット PIC MCU• 32 ビット PIC MCU

お客様サポート

Microchip 社製品をお使いのお客様は、以下のチャンネルからサポートをご利用頂けます。

• 販売代理店

• 弊社営業所

• 技術サポート

技術サポートは以下のウェブページからもご利用になれます。

http://support.microchip.com

本書の内容に関して、誤りやご意見がございましたら、[email protected] までメールでお寄せください。

Microchip 社への問い合わせ

以下の番号より、Microchip 社まで電話またはファックスでお問い合わせください。

電話 : (480) 792-7200Fax: (480) 792-7277


http://www.microchip.com/forums

http://support.microchip.com

mailto:[email protected]


NOTE:


MPLAB® X IDE
ユーザガイド
用語集

数字

2 進数 (Binary)0 と 1 の数字を使う、2 を底とした記数法。一番右の桁が 1 の位、次の桁が 2 の位、その次の桁が 22 = 4 の位を表す。

8 進数 (Octal)0 ～ 7 の数字のみを使う、8 を底とした記数法。一番右の桁が 1 の位、次の桁が 8 の位、その次の桁が 82 = 64 の位を表す。

16 進数 (Hexadecimal)0 ～ 9 の数字と A ～ F( または a ～ f) のアルファベットを使った、16 を底とした記数法。16 進数の A ～ F は、10 進数の 10 ～ 15 を表す。一番右の桁が 1 の位、次の桁が 16の位、その次の桁が 162 = 256 の位を表す。

AAND 条件ブレークポイント (ANDed Breakpoint)プログラムの実行を停止するために設定するAND条件 (ブレークポイント1とブレークポイント 2 が同時に発生した場合のみプログラム実行を停止する )。AND 条件で実行が停止するのは、データメモリのブレークポイントとプログラムメモリのブレークポイントが同時に発生した場合のみ。

ANSIAmerican National Standards Institute( 米国規格協会 ) の略。米国における標準規格の策定と承認を行う団体。

ASCIIAmerican Standard Code for Information Interchange の略。7 桁の 2 進数で 1 つの文字を表現する文字セットエンコード方式。大文字、小文字、数字、記号、制御文字等を含む。

CC/C++C 言語は、簡潔な表現、現代的な制御フローとデータ構造、豊富に用意された演算子等を特長とする汎用プログラミング言語。C++ とは、C 言語のオブジェクト指向バージョン。

COFFCommon Object File Format の略。このフォーマットのオブジェクトファイルは、マシンコードの他、デバッグ等に関する情報を含む。

CPU「中央演算処理装置」参照。

DDWARFDebug With Arbitrary Record Formatの略。ELFファイルのデバッグ情報フォーマット。



EEEPROMElectrically Erasable Programmable Read Only Memory の略。電気的に消去可能なタイプの PROM。データの書き込みと消去をバイト単位で行う。EEPROM は電源をOFF にしても内容を保持する。

ELFExecutable and Linking Format の略。この形式のオブジェクトファイルはマシンコードを含む。デバッグその他の情報は DWARF で指定する。ELF/DWARF の方が COFF よりも適化したコードのデバッグに適している。

EPROMErasable Programmable Read Only Memory の略。再書き込みが行えるタイプの ROM で、消去は紫外線照射で行うものが主流。

FFNOPForced No Operation の略。Forced NOP サイクルは、2 サイクル命令の 2 サイクル目で発生する。PIC マイクロコントローラのアーキテクチャはパイプライン構造となっており、現在の命令を実行中に物理アドレス空間の次の命令をプリフェッチする。しかし、現在の命令でプログラムカウンタが変化した場合、プリフェッチした命令は明示的に無視され、Forced NOP サイクルが発生する。

GGPRGeneral Purpose Register( 汎用レジスタ ) の略。デバイスのデータメモリ (RAM) のうち、汎用目的に使える部分。

HHaltプログラム実行を停止する事。Halt を実行する事は、ブレークポイントで停止する事と同じ。

HEX コード /HEX ファイル (Hex Code/Hex File)HEX コードは、実行可能な命令を 16 進数形式のコードで保存したもの。HEX ファイルは、HEX コードを格納したファイル。

IICE/ICDインサーキットエミュレータ / インサーキットデバッガの略。ターゲットデバイスのデバッグとプログラミングを行うためのハードウェアツール。エミュレータは、デバッガよりも多くの機能 ( トレース等 ) を備える。

インサーキットエミュレーション / インサーキットデバッグとは、インサーキットエミュレータまたはデバッガを使った作業の事を指す。

-ICE/-ICD: インサーキットエミュレーション / デバッグ用の回路を内蔵したデバイス(MCU または DSC)。このデバイスは必ずヘッダ基板にマウントし、インサーキットエミュレータまたはデバッガによるデバッグ用に使う。

ICSPIn-Circuit Serial Programming の略。Microchip 社製の組み込みデバイスをシリアル通信を利用して小限のデバイスピンでプログラミングする方法。

IDEIntegrated Development Environment の略。MPLAB IDE/MPLAB X IDE の IDE と同じ意味。

IEEEInstitute of Electrical and Electronics Engineers の略。


用語集

LLVDSLow Voltage Differential Signaling の略。銅線を使って低ノイズ、低消費電力、低振幅でデータを高速伝送 (Gbps) する方法。標準の I/O シグナリングでは、データストレージは実際の電圧レベルに依存する。電圧レベルは信号線の長さに影響を受ける ( 信号線が長いと抵抗が増え電圧が下がる )。これに対し LVDS では、電圧レベルでなく差動入力の電位差が正か負かでのみデータの意味を区別する。従って、長い信号線でもクリアで安定したデータストリームを維持した伝送が可能。

出典 : http://www.webopedia.com/TERM/L/LVDS.htmlMmake ファイル (Makefile)プロジェクトの Make に関する指示をファイルにエクスポートしたもの。このファイルは、MPLAB IDE/MPLAB X IDE 以外の環境で makeコマンドを実行してプロジェクトをビルドする際に使う。

Make Projectアプリケーションを再ビルドするコマンド。前回の完全なコンパイル後に変更されたソースファイルのみを再コンパイルする。

MCUMicrocontroller Unit の略。マイクロコントローラの事。「µC」と表記する事もある。

MPASM™ アセンブラ (MPASM Assembler)PIC マイクロコントローラ、KeeLoq® デバイス、Microchip 社のメモリデバイスに対応した Microchip 社の再配置可能なマクロアセンブラ。

MPLAB ( 言語ツール名 ) for ( デバイス名 ) (MPLAB Language Tool for Device)特定のデバイスに対応した Microchip 社の C コンパイラ、アセンブラ、リンカ。言語ツールは、アプリケーションで使うデバイスに対応したものを選択する必要がある。例えば PIC18 MCU 用の C コードを作成する場合、「MPLAB C Compiler for PIC18MCU」を使う。

MPLAB ICDMPLAB IDE/MPLAB X IDE と組み合わせて使う Microchip 社のインサーキットデバッガ。ICE/ICD を参照。

MPLAB IDE/MPLAB X IDEMicrochip 社の統合開発環境。エディタ、プロジェクトマネージャ、シミュレータが付属する。

MPLAB PM3Microchip 社提供のデバイスプログラマ。PIC18 マイクロコントローラと dsPIC デジタルシグナルコントローラのプログラミングに対応。MPLAB IDE/MPLAB X IDE との併用も、単体で使う事も可能。PRO MATE II の後継製品。

MPLAB REAL ICE™ インサーキットエミュレータ

MPLAB IDE/MPLAB X IDE と組み合わせて使う Microchip 社の次世代インサーキットエミュレータ。ICE/ICD を参照。

MPLAB SIMMPLAB IDE/MPLAB X IDE と組み合わせて使う Microchip 社のシミュレータで、PICMCU と dsPIC DSC に対応する。

MPLIB™ オブジェクトライブラリアン (MPLIB Object Librarian)MPLAB IDE/MPLAB X IDEと組み合わせて使うMicrochip社のライブラリアン。MPLIBライブラリアンは、MPASMアセンブラ(mpasmまたはmpasmwin v2.0)またはMPLABC18 C コンパイラで作成した COFF オブジェクトモジュールに使うオブジェクトライブラリアン。


http://www.webopedia.com/TERM/L/LVDS.html


MPLINK™ オブジェクトリンカ (MPLINK Object Linker)Microchip社のMPASMアセンブラとC18 Cコンパイラに対応したオブジェクトリンカ。Microchip 社の MPLIB ライブラリアンとの併用も可能。MPLAB IDE/MPLAB X IDE に統合して使うように設計されているが、MPLAB IDE/MPLAB X IDE 以外の環境でも使える。

MRUMost Recently Usedの略。近使ったファイルとウィンドウの事。MPLAB IDE/MPLABX IDE のメインメニューで選択できる。

NNOPNo Operation の略。実行してもプログラムカウンタが進むだけで何も動作を行わない命令。

OOTPOne Time Programmable の略。パッケージに窓のない EPROM デバイス。EPROMを消去するには紫外線照射が必要なため、パッケージに窓のあるデバイスしか消去できない。

PPCパーソナルコンピュータまたはプログラムカウンタの略。

PIC MCUMicrochip 社の全てのマイクロコントローラファミリの総称。

PICkit 2/3Microchip 社の開発用デバイスプログラマで、Debug Express によるデバッグ機能を備える。サポートしているデバイスの種類は、各ツールの Readme ファイル参照。

PsectGCC のセクションに相当する OCG の用語。プログラムセクション (program section)の略語。リンカが 1 つのまとまりとして処理するコードまたはデータのブロック。

PWM 信号 (PWM Signal)パルス幅変調 (Pulse Width Modulation) 信号。一部の PIC MCU は周辺モジュールとして PWM を内蔵している。

RRAMRandom Access Memory の略。データメモリ。任意の順にメモリ内の情報にアクセスできる。

ROMRead Only Memory の略。プログラムメモリ。メモリの内容を変更できない。

Runエミュレータを Halt から解放するコマンド。エミュレータはアプリケーションコードを実行し、I/O に対してリアルタイムに変更、応答を行う。

SSQTP (Serialized Quick Turn Programming)デバイスプログラマでマイクロコントローラをプログラムする際に、各デバイスに異なるシリアル番号を書き込めるようにする機能。この番号はエントリコード、パスワード、ID 番号として使える。

SQTP「Serialized Quick Turn Programming」参照。


用語集

MPLAB Starter Kit for ( デバイス名 ) (MPLAB Starter Kit for Device)特定のデバイスでの作業を開始する上で必要となるものを全てセットにしたMicrochip 社のスタータキット。書き込み済みアプリケーションの動作を確認し、一部を変更してカスタムアプリケーションとしてデバッグとプログラムを行える。

Step OverStep Over を実行すると、サブルーチン内をステップ実行せずにコードをデバッグできる。Step Over では、CALL命令があると CALLの次の命令にブレークポイントが設定される。何らかの理由によりサブルーチンが無限ループになる等正しく戻らない場合、次のブレークポイントには到達しない。CALL命令の処理以外は、Step Overコマンドと Single Step コマンドは同じ。

Step Out現在ステップ実行中のサブルーチンから抜け出すためのコマンド。このコマンドを実行すると、サブルーチンの残りのコードを全て実行し、サブルーチンの戻りアドレスで実行が停止する。

UUSBUniversal Serial Bus の略。2 本のシリアル伝送線で PC と外部周辺機器の通信を行う外部周辺インターフェイス規格。USB 1.0/1.1 は大 12 Mbps のデータレートをサポートしている。USB 2.0( ハイスピード USB) は大 480 Mbps のデータレートをサポートしている。

VVolatileメモリ内の変数へのアクセス方法に影響を与えるコンパイラの適化を抑制する変数修飾子。

W[Watches] ウィンドウ (Watches Window)ウォッチ変数の一覧が表示され、ブレークポイントで毎回表示が更新されるウィンドウ。

あ

アーカイブ / ライブラリ (Archive/Library)アーカイブ / ライブラリは、再配置可能なオブジェクトモジュールの集まり。複数のソースファイルをオブジェクトファイルにアセンブルした後、アーカイバ / ライブラリアンを使ってこれらオブジェクトファイルを 1 つのアーカイブ / ライブラリファイルにまとめると生成される。アーカイブ / ライブラリをオブジェクトモジュールや他のアーカイブ / ライブラリとリンクすると、実行コードが生成される。

アクセスエントリポイント (Access Entry Point)リンク時に定義されていない可能性のある関数に、セグメントの境界を越えて制御を渡すための手段。ブートセグメントとセキュアアプリケーションセグメントを別々にリンクする方法を提供する。

アクセスメモリ (Access Memory)PIC18 のみ - PIC18 でバンクセレクトレジスタ (BSR) の設定にかかわらずアクセスできる特殊なレジスタ。

アセンブリ / アセンブラ (Assembly/Assembler)アセンブリとは、2 進数のマシンコードをシンボル表現で記述したプログラミング言語。アセンブラとは、アセンブリ言語のソースコードをマシンコードに変換する言語ツール。

アップロード (Upload)エミュレータやプログラマ等のツールからホスト PC へ、またはターゲットボードからエミュレータへデータを転送する事。



アドレス (Address)メモリ内の位置を一意に特定する値。

アプリケーション (Application)PIC® マイクロコントローラで制御されるソフトウェアとハードウェアを組み合わせたもの。

アルファベット文字 (Alphabetic Character)アルファベットの小文字と大文字の総称 (a,b, ･･･ ,z,A,B, ･･･ ,Z)。

い

イベント (Event)アドレス、データ、パスカウント、外部入力、サイクルタイプ ( フェッチ、R/W)、タイムスタンプ等、バスサイクルを記述したもの。トリガ、ブレークポイント、割り込みを記述するために使う。

入れ子の深さ (Nesting Depth)マクロに他のマクロを入れ込める階層の数。

インポート (Import)HEX ファイル等の外部ソースからMPLAB IDE/MPLAB X IDE にデータを取り込む事。

う

ウォッチドッグタイマ (WDT: Watchdog Timer)PIC マイクロコントローラに内蔵されたタイマの 1 つで、ユーザが設定した期間が経過するとプロセッサをリセットする。WDT の有効化 / 無効化、設定はコンフィグレーションビットで行う。

ウォッチ変数 (Watch Variable)デバッグセッション中に [Watches] ウィンドウで監視できる変数。

え

英数字 (Alphanumeric)アルファベット文字と 0 ～ 9 の 10 進数 (0,1, ･･･ ,9) の数字の総称。

永続データ (Persistent Data)クリアも初期化もされないデータ。デバイスをリセットしてもアプリケーションがデータを保持できるようにするために使う。

エクスポート (Export)MPLAB IDE/MPLAB X IDE から標準フォーマットでデータを外部に出力する事。

エミュレーション / エミュレータ (Emulation/Emulator)ICE/ICD を参照。

エピローグ (Epilogue)コンパイラで生成したコードのうち、スタック領域の割り当て解除、レジスタの復帰、ランタイムモデルで指定したその他のマシン固有の要件を実行するコード部分。関数のユーザコードの後、関数リターンの直前にエピローグを実行する。

エラー / エラーファイル (Error/Error File)プログラムの処理を継続できない問題が発生するとエラーとして報告される。可能な場合、エラーは問題が発生したソースファイル名と行番号を特定する。エラーファイルは、言語ツールから出力されたエラーメッセージと診断結果を格納する。

演算子 (Operator)定義可能な式を構成する際に使う「+」や「-」等の記号。各演算子に割り当てられた優先順位に基づいて式を評価する。

エンディアン (Endianness)マルチバイトオブジェクトにおけるバイトの並び順。


用語集

お

オブジェクトコード / オブジェクトファイル (Object Code/Object File)オブジェクトコードとは、アセンブラまたはコンパイラで生成されるマシンコードの事。オブジェクトファイルとは、マシンコードを格納したファイル。デバッグ情報を含む事もある。そのまま実行できるものと、他のオブジェクトファイル ( 例 : ライブラリ )とリンクしてから完全な実行プログラムを生成する再配置可能形式のものがある。

オブジェクトファイルディレクティブ (Object File Directive)オブジェクトファイル作成時にのみ使うディレクティブ。

オフチップメモリ (Off-Chip Memory)PIC18 で選択できるメモリオプション。ターゲットボードのメモリを使うか、または全てのプログラムメモリをエミュレータから供給する。[Options] > [DevelopmentMode] の順にクリックして [Memory] タブでオフチップメモリを選択する。

オペコード (Opcode)Operational Code の略。「ニーモニック」を参照。

か

外部 RAM (External RAM)デバイス外部にある、読み書き可能なメモリ。

外部シンボル (External Symbol)外部リンケージを持つ識別子のシンボル。参照の場合と定義の場合がある。

外部シンボル解決 (External Symbol Resolution)リンカが全ての入力モジュールの外部シンボル定義を 1 つにまとめ、全ての外部シンボル参照を解決しようとするプロセス。外部シンボル参照に対応する定義が存在しない場合、リンカエラーとなる。

外部入力ライン (External Input Line)外部信号に基づいてイベントを設定するための外部入力信号ロジックプローブライン(TRIGIN)。外部ラベル (External Label)外部リンケージを持つラベル。

外部リンケージ (External Linkage)関数または変数が、それを定義したモジュールの外部から参照できる場合、外部リンケージを持つという。

拡張マイクロコントローラモード (Extended Microcontroller Mode)拡張マイクロコントローラモードでは、内蔵プログラムメモリと外部メモリの両方が利用できる。プログラムメモリのアドレスが PIC18 の内部メモリ空間より大きい場合、自動的に外部メモリの実行に切り換わる。

拡張モード (Extended Mode) (PIC18 MCU)コンパイラの動作モードの 1 つ。拡張命令 (ADDFSR、ADDULNK、CALLW、MOVSF、MOVSS、PUSHL、SUBFSR、SUBULNK) とリテラルオフセットによるインデックスアドレス指定を利用できる。

環境 (Environment)MPLAB PM3 - デバイスのプログラミングに関する設定ファイルを保存したフォルダ。このフォルダを SD/MMC カードに転送できる。

緩和 (Relaxation)ある命令を、機能が同じでよりサイズの小さい命令に変換する事。コードサイズを抑えるために便利である。新の MPLAB XC16 には、CALL命令を RCALL命令に緩和する機能がある。この変換は、現在の命令から +/-32k 命令ワード以内にあるシンボルを呼び出す場合に行われる。



き

記憶域クラス (Storage Class)指定されたオブジェクトに対応する記憶場所の持続期間を決定する。

記憶域修飾子 (Storage Qualifier)宣言されるオブジェクトの特別な属性を示す ( 例 : const)。基数 (Radix)アドレスを指定する際の記数法 (16 進法、10 進法 ) の底。

く

クリーン (Clean)クリーンする事により、アクティブなプロジェクトのオブジェクトファイル、HEXファイル、デバッグファイル等、全ての中間ファイルが削除される。これらのファイルは、プロジェクトのビルド時に他のファイルから再構築される。

け

警告 (Warning)MPLAB IDE/MPLAB X IDE - デバイス、ソフトウェアファイル、装置に物理的な損傷を与える可能性のある状況で、ユーザに注意を促すために表示されるメッセージ。

16 ビットアセンブラ /コンパイラ - 問題となる可能性のある状態を警告として報告するが、処理は停止されない。MPLAB C30 の警告メッセージはソースファイル名と行番号を報告するが、エラーメッセージと区別するために「warning:」の文字列も付加する。

こ

高級言語 (High Level Language)プログラムを記述するための言語で、プロセッサから見てアセンブリよりも遠い位置関係にあるもの。

校正メモリ (Calibration Memory)PIC マイクロコントローラの内蔵 RC オシレータやその他の周辺モジュールの校正値を格納するための特殊機能レジスタ。

国際標準化機構 (International Organization for Standardization)コンピューティングや通信を始めとする、多くのテクノロジとビジネス関連の標準規格の策定を行っている団体。一般的に ISO と呼ぶ。

コマンドラインインターフェイス (Command Line Interface)プログラムとユーザのやり取りをテキストの入出力だけで行う方法。

コンパイラ (Compiler)高級言語で記述されたソースファイルをマシンコードに変換するプログラム。

コンパイルドスタック (Stack, Compiled)コンパイラが管理し割り当てるメモリの領域で、この領域内で変数に静的に空間を割り当てる。ターゲットデバイス上にソフトウェアスタックのメカニズムを効率的に実装できない場合、ソフトウェアスタックがコンパイルドスタックに置き換わる。このメカニズムでは、関数は再入可能ではなくなる。

コンパイルドスタック (Compiled Stack)コンパイラが管理するメモリの領域で、この領域内で変数に静的に空間を割り当てる。ターゲットデバイス上にソフトウェアスタックまたはハードウェアスタックのメカニズムを効率的に実装できない場合、コンパイルドスタックがソフトウェアスタックまたはハードウェアスタックに置き換わる。

コンフィグレーションビット (Configuration Bit)PIC MCU と dsPIC DSC の動作モードを設定するために書き込む専用ビット。コンフィグレーションビットは事前プログラミングされている場合とされていない場合がある。


用語集

さ

再帰 (Recursion)定義した関数またはマクロがそれ自身を呼び出す事。再帰マクロを作成する際は、再帰から抜けずに無限ループとなりやすいため注意が必要。

再帰呼び出し (Recursive Call)直接または間接的に自分自身を呼び出す関数。

再入可能 (Reentrant)1 つの関数を複数呼び出して同時に実行できる事。直接または間接再帰、あるいは割り込み処理中の実行によって起こる事がある。

再配置 (Relocation)リンカが絶対アドレスを再配置可能セクションに割り当てる事。再配置可能セクション内の全てのシンボルを新しいアドレスに更新する。

再配置可能 (Relocatable)アドレスがメモリの固定番地に割り当てられていないオブジェクト。

再配置可能セクション (Relocatable Section)16ビットアセンブラ - アドレスが固定されていない (絶対アドレスでない )セクション。再配置可能セクションには、再配置と呼ばれるプロセスでリンカがアドレスを割り当てる。

左辺値 (L-value)検査または変更が可能なオブジェクトを示す式。左辺値は代入演算子の左側で使う。

し

シーケンスブレークポイント (Sequenced Breakpoint)シーケンスで発生するブレークポイント。ブレークポイントのシーケンスはボトムアップ方式で実行される。つまり、シーケンスの後のブレークポイントが初に発生する。

シェル (Shell)MPASM アセンブラにおいて、マクロアセンブラへの入力を行うためのプロンプトインターフェイス。MPASM アセンブラには DOS 用シェルと Windows OS 用シェルの 2 種類がある。

式 (Expression)算術演算子または論理演算子で区切った定数または記号の組み合わせ。

識別子 (Identifier)関数または変数の名前。

システムウィンドウコントロール (System Window Control)ウィンドウと一部のダイアログの左上隅にあるコントロール。通常、このコントロールをクリックすると、[ 小化 ]、[ 大化 ]、[ 閉じる ] 等のメニュー項目がポップアップ表示される。

実行可能コード (Executable Code)読み込んで実行できる形式のソフトウェア。

シナリオ (Scenario)MPLAB SIM シミュレータでスティミュラス制御を具体的に設定したもの。

シミュレータ (Simulator)デバイスの動作をモデル化するソフトウェアプログラム。

修飾子 (Qualifier)パスカウンタで使ったり、複合トリガにおける次の動作前のイベントとして使ったりするアドレスまたはアドレスレンジ。



条件付きアセンブリ (Conditional Assembly)アセンブリ言語で、ある特定の式のアセンブル時の値に基づいて含まれたり除外されたりするコード。

条件付きコンパイル (Conditional Compilation)プログラムの一部を、プリプロセッサディレクティブで指定した特定の定数式が真の場合のみコンパイルする事。

初期化済みデータ (Initialized Data)初期値を指定して定義されたデータ。C では、

int myVar=5;として定義した変数は初期化済みデータセクションに格納する。

シングルステップ (Single Step)コードを 1 命令ずつ実行するコマンド。1 命令を実行するたびに、MPLAB IDE/MPLABX IDE がレジスタウィンドウ、ウォッチ変数、ステータスの表示を更新するため、命令実行を解析してデバッグできる。C コンパイラのソースコードもシングルステップ実行できるが、その場合 MPLAB IDE/MPLAB X IDE は 1 命令ずつ実行するのではなく、高級言語のCで記述されたコードの1行から生成される全てのアセンブリレベル命令をシングルステップで実行する。

シンボル (Symbol)プログラムを構成する各種の要素を記述する汎用のメカニズム。関数名、変数名、セクション名、ファイル名、struct/enum/union タグ名等がある。MPLAB IDE/MPLABX IDE では、主に変数名、関数名、アセンブリラベルをシンボルと呼ぶ。リンク実行後は、シンボルの値はメモリ内の値となる。

す

推奨しない機能 (Deprecated Feature)後方互換性確保のためにサポートしているだけで現在は使っておらず、いずれ廃止になる事が決まっている機能。

スキッド (Skid)ハードウェアブレークポイントを使ってプロセッサを停止する場合、ブレークポイント以降の命令を実行してプロセッサが停止する事がある。ブレークポイントの後に実行する命令の数をスキッドと呼ぶ。

スキュー (Skew)命令実行に対応する情報は、異なる複数のタイミングでプロセッサバスに表れる。例えば、実行されるオペコードは直前の命令の実行時にフェッチとしてバスに表れる。ソースデータのアドレスと値、およびデスティネーションデータのアドレスは、オペコードが実際に実行される時にバスに表れる。デスティネーションデータの値は次の命令の実行時にバスに表れる。トレースバッファは、1 インスタンスでバス上に存在する情報をキャプチャする。従って、トレースバッファの 1 エントリには 3 つの命令の実行情報が含まれる。1 つの命令実行で、ある情報から次の情報までにキャプチャされるサイクル数をスキューと呼ぶ。

スタティック RAM (SRAM) (Static RAM or SRAM)Static Random Access Memory の略。ターゲットボード上の読み書き可能なプログラムメモリ。リフレッシュ動作は不要。

スティミュラス (Stimulus)シミュレータへの入力、すなわち外部信号に対する応答をシミュレートするために生成するデータ。通常、テキストファイルにアクションのリストとしてこのデータを記述する。スティミュラスの種類には非同期、同期 ( ピン )、クロック動作、レジスタがある。

ステータスバー (Status Bar)MPLAB IDE/MPLAB X IDE ウィンドウの一番下にあるバーで、カーソル位置、開発モードとデバイス、アクティブなツールバー等に関する情報が表示される。


用語集

ステップイントゥ (Step Into)Single Step と同じコマンド。Step Over とは異なり、Step Into では CALL 命令が呼び出すサブルーチン内もステップ実行する。

ストップウォッチ (Stopwatch)実行サイクルを計測するためのカウンタ。

せ

制御ディレクティブ (Control Directive)アセンブリ言語コード内で使うディレクティブで、指定した式のアセンブル時の値に基づいてコードを含めるか除外するかを決定する。

セクション (Section)OCG の psect に相当する GCC の用語。リンカが 1 つのまとまりとして処理するコードまたはデータのブロック。

セクション属性 (Section Attribute)GCC のセクションの特徴を表す情報 ( 例 : accessセクション )。絶対シンボル (Symbol, Absolute)アセンブリの .equディレクティブによる定義等、即値を表す。

絶対セクション (Absolute Section)リンカで変更されない固定 ( 絶対 ) アドレスを持つ GCC コンパイラのセクション。

絶対変数 / 関数 (Absolute Variable/Function)OCG コンパイラの @ address 構文を使って絶対アドレスに配置される変数または関数。

そ

相互参照ファイル (Cross Reference File)シンボルテーブルとそのシンボルを参照するファイルリストを参照するファイル。シンボルが定義されている場合、リストの初のファイルがシンボル定義の位置となる。残りのファイルはシンボルへの参照を含む。

ソースコード (Source Code)人間が記述したコンピュータプログラム。プログラミング言語で記述されたソースコードは、マシンコードに変換して実行するか、またはインタプリタで実行される。

ソースファイル (Source File)ソースコードを記述した ASCII テキストファイル。

属性 (Attribute)GCC の C プログラムの変数または関数の特徴を表す情報で、マシン固有の特性を記述する目的で使う。

属性 ( セクション属性 ) (Attribute, Section)「executable」、「readonly」、「data」等、GCC のセクションの特徴を表す情報。アセンブラの .sectionディレクティブでフラグとして指定できる。

ソフトウェアスタック (Stack, Software)アプリケーションが戻りアドレス、関数パラメータ、ローカル変数を保存するのに使うメモリ。このメモリはプログラムでの命令の実行時に動的に割り当てられる。これによって、再入可能な関数の呼び出しが可能になる。

た

ターゲット (Target)ユーザハードウェアの事。

ターゲットアプリケーション (Target Application)ターゲットボードに読み込んだソフトウェア。



ターゲットプロセッサ (Target Processor)ターゲットアプリケーションの基板で使われているマイクロコントローラ。

ターゲットボード (Target Board)ターゲットアプリケーションを構成する回路とデバイス。

ダウンロード (Download)ホストから別のデバイス ( 例 : エミュレータ、プログラマ、ターゲットボード ) にデータを送信する事。

ち

致命的エラー (Fatal Error)コンパイルがただちに停止するようなエラー。エラーの発生後はメッセージも出力されない。

中央演算処理装置 (Central Processing Unit)デバイス内で、実行する正しい命令をフェッチし、デコードして実行する装置。必要に応じて、算術論理演算装置 (ALU) と組み合わせて命令実行を完了する。プログラムメモリのアドレスバス、データメモリのアドレスバス、スタックへのアクセスを制御する。

つ

ツールバー (Tool Bar)MPLAB IDE/MPLAB X IDE の機能を実行するためのボタン ( アイコン ) を縦または横に並べたもの。

て

ディレクティブ (Directive)言語ツールの動作を制御するためにソースコードに記述する命令文。

データ監視および制御インターフェイス (DMCI: Data Monitor and Control Interface)MPLAB X IDE 内のツール。このインターフェイスは、プロジェクト内のアプリケーション変数の動的な入力制御を提供する。4 つの動的に割り当て可能なグラフィックウィンドウを使って、アプリケーションが生成するデータをグラフィカルに表示できる。

データディレクティブ (Data Directive)アセンブラが行うプログラムメモリまたはデータメモリの割り当てを制御するディレクティブ。データ項目をシンボル ( 意味のある名前 ) で参照する手段として使う。

データメモリ (Data Memory)Microchip 社の MCU と DSC では、データメモリ (RAM) は汎用レジスタ (GPR) と特殊機能レジスタ (SFR) で構成される。EEPROM データメモリを内蔵したデバイスもある。

デジタルシグナルコントローラ (Digital Signal Controller)デジタル信号処理機能を搭載したマイクロコントローラ。Microchip 社の dsPIC DSCデバイス等。

デジタル信号処理 / デジタルシグナルプロセッサ (Digital Signal Processing/Digital Signal Processor)デジタル信号処理 (DSP) とは、デジタル信号をコンピュータで処理する事。通常は、アナログ信号 ( 音声または画像 ) をデジタル形式に変換 ( サンプリング ) して処理する事をいう。デジタルシグナルプロセッサとは、信号処理用に設計されたマイクロプロセッサの事。

デバイスプログラマ (Device Programmer)マイクロコントローラ等、電気的に書き込み可能な半導体デバイスをプログラミングするためのツール。


用語集

デバッグ情報 (Debugging Information)コンパイラとアセンブラでこのオプションを選択すると、アプリケーションコードのデバッグに使える各種レベルの情報を出力できる。デバッグオプションの選択の詳細はコンパイラまたはアセンブラのマニュアル参照。

デバッグ / デバッガ (Debug/Debugger)ICE/ICD を参照。

テンプレート (Template)後でファイルに挿入するために作成するテキスト行。MPLAB エディタでは、テンプレートはテンプレートファイルに保存する。

と

特殊機能レジスタ (SFR: Special Function Register)I/O プロセッサ機能、I/O ステータス、タイマ等の各種モードや周辺モジュールを制御するレジスタ専用に使うデータメモリ (RAM) 領域。

匿名構造体 (Anonymous Structure)16 ビット C コンパイラ – 無名の構造体。

PIC18 C コンパイラ - C 共用体のメンバーである無名の構造体。匿名構造体のメンバーは、その構造体を包含している共用体のメンバーと同じようにアクセスできる。例えば以下のサンプルコードでは、hiと loは共用体 casterに含まれる匿名構造体のメンバーである。

union castaway int intval; struct { char lo; //accessible as caster.lo char hi; //accessible as caster.hi };} caster;

トライグラフ (Trigraph)「??」で始まる3文字のシーケンス。ISO Cで定義されており、1つの文字に置換される。

トリガ出力 (Trigger Output)任意のアドレスまたはアドレス範囲で生成でき、トレースとブレークポイントの設定から独立したエミュレータ出力信号の事。トリガ出力の設定数に制限はない。

トレース (Trace)プログラム実行を記録するエミュレータまたはシミュレータの機能。エミュレータはプログラム実行のログをトレースバッファに記録し、これを MPLAB IDE/MPLAB XIDE のトレースウィンドウにアップロードする。

トレースマクロ (Trace Macro)エミュレータデータからのトレース情報を提供するマクロ。これはソフトウェアトレースのため、トレースを利用するにはマクロをコードに追加し、コードを再コンパイルまたは再アセンブルし、ターゲットデバイスにこのコードをプログラムする必要がある。

トレースメモリ (Trace Memory)エミュレータが内蔵するトレース用のメモリ。トレースバッファとも呼ばれる。

な

内部リンケージ (Internal Linkage)関数または変数が、それを定義したモジュールの外部から参照できない場合、内部リンケージを持つという。

生データ (Raw Data)あるセクションに関連付けられたコードまたはデータを 2 進数で表現したもの。



に

ニーモニック (Mnemonic)マシンコードと 1 対 1 で対応したテキスト命令。オペコードとも呼ぶ。

ね

ネイティブデータサイズ (Native Data Size)ネイティブトレースの場合、[Watches] ウィンドウで使う変数のサイズは選択したデバイスのデータメモリと同じサイズ (PIC18 の場合は同じバイトサイズ、16 ビットデバイスの場合は同じワードサイズ ) である必要がある。

の

ノード (Node)MPLAB IDE/MPLAB X IDE のプロジェクトを構成するコンポーネント

は

ハードウェアスタック (Stack, Hardware)PIC マイクロコントローラで関数を呼び出す時に戻りアドレスを格納する場所。

パスカウンタ (Pass Counter)イベント ( 特定のアドレスの命令を実行する等 ) が発生するたびに値をデクリメントするカウンタ。パスカウンタの値がゼロになると、イベントの条件を満たす。パスカウンタはブレークロジック、トレースロジック、複合トリガダイアログの任意のシーケンシャルイベントに割り当てられる。

パワーオンリセットエミュレーション (Power-on-Reset Emulation)データ RAM 領域にランダムな値を書き込んで、初回電源投入時の RAM の非初期化値をシミュレートするソフトウェア無作為化処理。

ひ

ヒープ (Heap)動的メモリ割り当てに使うメモリ空間。メモリブロックの割り当てと解放は実行時に任意の順序で行う。

非拡張モード (Non-Extended Mode) (PIC18 MCU)コンパイラの動作モードの 1 つ。拡張命令もリテラルオフセットによるインデックスアドレス指定も使わない。

非初期化データ (Uninitialized Data)初期値なしで定義されたデータ。C では、

int myVar; は、非初期化済みデータセクションに格納される変数を定義する。

非同期 (Asynchronously)複数のイベントが同時には発生しない事。一般に、プロセッサ実行中の任意の時点で発生する割り込みに言及する際に使う。

非同期スティミュラス (Asynchronous Stimulus) シミュレータデバイスへの外部入力をシミュレートするために生成されるデータ。

非リアルタイム (Non Real Time)ブレークポイントで停止中、またはシングルステップ実行中のプロセッサ、あるいはシミュレータモードで動作中の MPLAB IDE/MPLAB X IDE を指す。

ビルド (Build)全てのソースファイルのコンパイルとリンクを行ってアプリケーションを作成する事。

ふ

ファイルレジスタ (File Register)汎用レジスタ (GPR) と特殊機能レジスタ (SFR) から成る内蔵のデータメモリ。


用語集

ファントムバイト (Phantom Byte)dsPIC アーキテクチャで、24 ビット命令ワードを 32 ビット命令ワードとみなして扱う場合に使う未実装バイト。dsPIC の HEX ファイルに見られる。

フィックスアップ (Fixup)リンカによる再配置後にオブジェクトファイルのシンボル参照を絶対アドレスに置き換える処理。

フィルタ (Filter)トレースディスプレイまたはデータファイルにどのデータを含めるか /除外するかを選択するもの。

不揮発性ストレージ (Non-Volatile Storage)電源を OFF にしても内容が失われないストレージデバイス。

ブックマーク (Bookmark)ファイル内の特定の行に簡単な操作でアクセスできるようにする機能。

[Editor] ツールバーの [Toggle Bookmarks] を選択してブックマークを追加または削除する。このツールバーの他のアイコンをクリックすると、次または前のブックマークに移動する。

プラグイン (Plug-in)MPLAB IDE/MPLAB X IDE では、標準コンポーネントにプラグインモジュールを追加する事で、各種ソフトウェア / ハードウェアツールに対応する。一部のプラグインツールは、[Tools] メニューから利用できる。

プラグマ (Pragma)特定のコンパイラにとって意味を持つディレクティブ。一般に、実装で定義した情報をコンパイラに伝達するために使う。MPLAB C30 は属性を利用してこの情報を伝達する。

フラッシュ (Flash)データの書き込みと消去をバイト単位ではなくブロック単位で行えるタイプのEEPROM。

フリースタンディング (Free-Standing)複素数型を使っておらず、ライブラリ (ANSI C89 規格第 7 節 ) で規定する機能の使用が標準ヘッダ (<float.h>、<iso646.h>、<limits.h>、<stdarg.h>、<stdbool.h>、<stddef.h>、<stdint.h>) の内容にのみ限定されている厳密な規格合致プログラムを受理する処理系。

ブレークポイント (Breakpoint)ハードウェアブレークポイント : 実行するとファームウェアの実行が停止するイベント。

ソフトウェアブレークポイント : ファームウェアの実行が停止するアドレス。通常、特別な Break 命令で実行が停止される。

フレームポインタ (Frame Pointer)スタックベースの引数とスタックベースのローカル変数の境界となるスタック番地を指し示すポインタ。ここを基準にすると、現在の関数のローカル変数やその他の値に容易にアクセスできる。

プログラムカウンタ (Program Counter)現在実行中の命令のアドレスを格納した場所。

プログラムカウンタユニット (Program Counter Unit)16 ビットアセンブラ - プログラムメモリのレイアウトを概念的に表現したもの。プログラムカウンタは 1 命令ワードで 2 つインクリメントする。実行可能セクションでは、2 プログラムカウンタユニットは 3 バイトに相当する。読み出し専用セクションでは、2 プログラムカウンタユニットは 2 バイトに相当する。



プログラムメモリ (Program Memory)MPLAB IDE/MPLAB X IDE - デバイス内で命令を保存するメモリ空間。また、エミュレータまたはシミュレータにダウンロードしたターゲットアプリケーションのファームウェアを格納するメモリ空間もプログラムメモリと呼ぶ。

16 ビットアセンブラ / コンパイラ - デバイス内で命令を保存するメモリ空間。

プロジェクト (Project)アプリケーションのビルドに必要なファイル ( 例 : ソースコード、リンカスクリプトファイル ) 一式と、各種ビルドツールやビルドオプションとの関連付けをまとめたもの。

プロトタイプシステム (Prototype System)ユーザのターゲットアプリケーションまたはターゲットボードの事。

プロファイル (Profile)MPLAB SIM シミュレータにおいて、実行したスティミュラスをレジスタ別に一覧表示したもの。

プロローグ (Prologue)コンパイラで生成したコードのうち、スタック領域の割り当て、レジスタの退避、ランタイムモデルで指定したその他のマシン固有の要件を実行するコード部分。プロローグは、関数のユーザコードの前に実行する。

へ

ベクタ (Vector)リセットまたは割り込みが発生した時にアプリケーションのジャンプ先となるメモリ番地。

ほ

ホスト PC (PC Host)パーソナルコンピュータ。

ポッド (Pod)インサーキットエミュレータまたはデバッガの筐体。丸型の場合パック (Puck) と呼ぶ事もある。あるいはプローブ (Probe) とも呼ぶが、「論理プローブ」と混同せぬよう注意が必要。

ま

マイクロコントローラ (Microcontroller)CPU、RAM、プログラムメモリ、I/O ポート、タイマ等、多くの機能を統合したチップ。

マイクロコントローラモード (Microcontroller Mode)PIC18 マイクロコントローラで設定可能なプログラムメモリ構成の 1 つ。マイクロコントローラモードでは、内部実行のみを許可する。つまり、マイクロコントローラモードでは内蔵プログラムメモリしか使えない。

マイクロプロセッサモード (Microprocessor Mode)PIC18 マイクロコントローラで設定可能なプログラムメモリ構成の 1 つ。マイクロプロセッサモードでは、内蔵プログラムメモリは使わない。プログラムメモリ全体を外部にマッピングする。

マクロ (Macro)マクロ命令。一連の命令シーケンスを短い名前で表現した命令。

マクロディレクティブ (Macro Directive)マクロ定義の中で実行とデータ割り当てを制御するディレクティブ。

マシン語 (Machine Language)ある CPU が翻訳を必要とせず実行できる命令の集合。


用語集

マシンコード (Machine Code)コンピュータプログラムをプロセッサが実際に読み出して解釈できる形式で表現したもの。2 進数のマシンコードで記述されたプログラムは、マシン命令のシーケンス( 命令間にデータを挟む事もある ) から成る。ある特定のプロセッサで使える全ての命令の集合を「命令セット」という。

み

未割り当てセクション (Unassigned Section)リンカのコマンドファイルで特定のターゲットメモリブロックに割り当てられていないセクション。リンカは、未割り当てセクションを割り当てるターゲットメモリブロックを検出する必要がある。

め

命令 (Instruction)CPU に対して特定の演算を実行するように指示するビット列。演算の対象となるデータを含める事もできる。

命令セット (Instruction Set)特定のプロセッサが理解できるマシン語命令の集合。

メッセージ (Message)言語ツールの動作に問題が発生した事を知らせる文字列。メッセージが表示されても処理は停止しない。

メモリモデル (Memory Model)C コンパイラの場合、アプリケーションで利用可能なメモリを表現したもの。PIC18C コンパイラの場合、プログラムメモリを指し示すポインタのサイズに関する規定を記述したもの。

も

モジュール (Module)プリプロセッサディレクティブ実行後の前処理済みのソースファイル出力。翻訳単位とも呼ぶ。

ゆ

優先順位 (Precedence)式の評価順を定義した規則。

よ

読み出し専用メモリ (Read Only Memory)恒久的に保存されているデータへの高速アクセスが可能なメモリハードウェア。ただし、データの追加や変更は不可。

ら

ライブラリ / ライブラリアン (Library/Librarian)「アーカイブ / ライブラリ」を参照。

ランタイムウォッチ (Runtime Watch)アプリケーションの実行につれて変数の値がリアルタイムに変化する [Watch] ウィンドウ。ランタイムウォッチの設定方法は各ツールの関連文書参照。ランタイムウォッチをサポートしていないツールもある。

ランタイムモデル (Run-time Model)ターゲットアーキテクチャのリソースの使用を記述したもの。



り

リアルタイム (Real Time)インサーキットエミュレータまたはデバッガが Halt 状態から解放されると、プロセッサの実行はリアルタイムモードとなり、通常のチップと同じ挙動をする。リアルタイムモードでは、エミュレータのリアルタイムトレースバッファが有効になり、選択した全てのサイクルを常時キャプチャする。また、全てのブレークロジックが有効になる。インサーキットエミュレータまたはデバッガでは、有効なブレークポイントで停止するか、またはユーザが実行を停止するまでプロセッサはリアルタイムで動作する。

シミュレータでは、ホスト CPU でシミュレート可能な大速度でマイクロコントローラの命令を実行する事をリアルタイムと呼ぶ。

リスティング (Listing File)ソースファイルにある各 C ソースステートメント、アセンブリ命令、アセンブラディレクティブ、マクロに対して生成されたマシンコードを記述した ASCII テキストファイル。

リスティングディレクティブ (Listing Directive)アセンブラのリスティングファイルのフォーマットを制御するディレクティブ。タイトルや改ページ指示等、リスティングファイルに関する各種の設定を行う。

リトルエンディアン (Little Endian)マルチバイトデータで下位バイト (LSB) を下位アドレスに格納するデータ並び順方式。

量産プログラマ (Production Programmer)デバイスを高速にプログラミングできるようにリソースを強化したプログラマ。各種電圧レベルでのプログラミングに対応し、プログラミング仕様に完全に準拠している。量産環境では応用回路が組み立てラインにとどまる時間をなるべく短くする必要があるため、デバイスへの書き込み時間の短縮が特に重要である。

リンカ (Linker)オブジェクトファイルとライブラリを結合し、モジュール間の参照を解決して実行可能コードを生成する言語ツール。

リンカスクリプトファイル (Linker Script File)リンカのコマンドファイル。リンカのオプションを定義し、ターゲットプラットフォームで利用可能なメモリを記述する。

る

ループバックテストボード (Loop-Back Test Board)MPLAB REAL ICE インサーキットエミュレータの動作をテストするために用いる。

れ

レイテンシ (Latency)イベントが発生してからその応答までの時間の長さ。

ろ

ローカルラベル (Local Label)マクロ内で LOCAL ディレクティブを使って定義されたラベル。ローカルラベルは、マクロの同一インスタンス内でのみ有効。すなわち、LOCAL として宣言されたシンボルとラベルには、ENDM マクロ以降はアクセスできない。

ロジックプローブ (Logic Probe)Microchip 社製エミュレータには、大 14 のロジックプローブを接続できるものがある。ロジックプローブは、外部トレース入力、トリガ出力信号、+5 V、共通グランドを提供する。


用語集

わ

ワークブック (Workbook)MPLAB SIM シミュレータにおいて、SCL スティミュラスの生成に関する設定を保存したもの。

割り当てセクション (Assigned Section)リンカのコマンドファイルで特定のターゲットメモリブロックに割り当てられたGCC コンパイラのセクション。

割り込み (Interrpt)CPU に対する信号の一種。この信号が発生すると、現在動作中のアプリケーションの実行を一時停止し、制御を割り込みサービスルーチン (ISR) に渡してイベントを処理する。ISR の実行が完了すると、通常のアプリケーションの実行を再開する。

割り込みサービス要求 (IRQ: Interrupt Service Request)プロセッサの通常の命令実行を一時的に停止し、割り込みハンドラルーチンの実行開始を要求するイベント。プロセッサによっては複数の割り込み要求イベントを持ち、優先度の異なる割り込みを処理できるものもある。

割り込みサービスルーチン (ISR: Interrupt Service Routine)言語ツールの場合、割り込みを処理する関数。

MPLAB IDE/MPLAB X IDE の場合、割り込みが発生すると実行されるユーザ作成コード。通常、発生した割り込みの種類によってプログラムメモリ内の異なる位置のコードを実行する。

割り込みハンドラ (Interrupt Handler)割り込み発生時に専用のコードを実行するルーチン。

割り込みベクタ (Interrupt Vector)割り込みサービスルーチンまたは割り込みハンドラのアドレス。



NOTE:


MPLAB® X IDE
ユーザガイド
索引

記号__DEBUG ..............................................................157, 204//TODO .....................................................................91, 177

AAbout .............................................................................. 227AN851 ブートローダのサポート ............................... 214AN901 BLDC チューニングインターフェイスのサポート ..................................................................... 214

AN908 ACIM チューニングインターフェイスのサポート ..................................................................... 214

Apply Code Changes................................................... 169Apply Diff Patch ............................................................ 224ASM30 ツールチェーン .................................................78Attach Debugger........................................................... 169

BBack ................................................................................ 220Batch Build Project ....................................................... 222Bookmarks..................................................................... 225[Bookmark] ウィンドウ ............................................... 220Breakpoints.................................................................... 172Build for Debugging...................................................... 102Build for Debugging Main Project .............................. 170Build Main Project ........................................................ 170Build Project .................................................102, 170, 222

CC++ ファイルタイプ .................................................... 131C18 ツールチェーン .......................................................78C24 ツールチェーン .......................................................78C30 ツールチェーン .......................................................78C32 ツールチェーン .......................................................78Call Graph...................................................................... 172Call Stack....................................................................... 172Cannot find file – リンカエラー ................................. 195[Change Visible Columns] ダイアログ ..................... 268Classes........................................................................... 171Clean and Build............................................................. 102Clean and Build for Debugging .................................. 102Clean and Build Main Project ..................................... 170Clean and Build Project.......................................170, 222Clean Main Project ....................................................... 170[Clean Only] アイコン.................................................. 168Clean Project................................................................. 170Clear Document Bookmarks....................................... 169Clear tool output window on new session................ 260Close All Projects ......................................................... 217Close Project ................................................................. 217Code Folding ................................................................. 219Compile File................................................................... 170Complete Code ............................................................. 221

[Configuration Bits] ウィンドウ ..................................247[Configure] メニューの相違点.....................................211Continue.................................................................169, 223Copy .......................................................................169, 218[CPU Registers] ウィンドウ .......................................250CPU メモリ ....................................................................113Customize Zoom ...........................................................171Cut ..........................................................................169, 218CVS

Check CVS.............................................................171Commit....................................................................171Diff............................................................................171Revert Modifications .............................................171Show Annotations .................................................171Update.....................................................................171

C 拡張子............................................................................ 88C ファイルタイプ .........................................................131

D[Dashboard] ウィンドウ .....................................139, 172[Data Memory] ウィンドウ ..........................................248Debug File .............................................................169, 223Debug Main Project ......................................................169Debug Project ................................................................223[Debug Project] アイコン.............................................105Debug Test File ....................................................169, 223[Debugger] メニューの相違点 ....................................210[Debug] メニュー ..........................................................223Delete .....................................................................169, 218Diff....................................................................................224Disassembly Listing File ..............................................172[Disassembly] ウィンドウ ..................................137, 168Disconnect from Debug Tool .............................168, 224Discrete Debugger Operation .....................................223DMA Address.................................................................245DMCI のサポート ..........................................................213dsPIC Filter Design のサポート..................................213dsPIC30F SMPS 降圧型コンバータ..........................214dsPIC33F SMPS 昇降圧型コンバータ......................214dsPICworks のサポート ...............................................213dsPIC ツールチェーン ...................................................78DTDs and XML Schemas ............................................224Dual Port Display ..........................................................245Duplicate Down .............................................................221Duplicate Up...................................................................221

E[Edit] メニュー ...............................................................218[Edit] メニューの相違点 ...............................................207[EE Data Memory] ウィンドウ ...................................247EEPROM .......................................................................... 15EE データメモリ ...........................................................113



Enable alternate watch list views during debug session ....................................................................... 260

Erase Device Memory Main Project.......................... 170Ethernet ツール接続..................................................... 262[Exception Reporter] ウィンドウ ............................... 172[Execution Memory] ウィンドウ ................................ 248Exit .................................................................................. 217[Experimental Terminal] ウィンドウ ......................... 172Export Hex ..................................................................... 256Export Project................................................................ 217

F[Favorites] ウィンドウ ................................................. 172[File Registers] ウィンドウ ......................................... 245Files................................................................................. 170[Files] ウィンドウの表示 ............................................. 188[File] メニュー ............................................................... 217[File] メニューの相違点 ............................................... 206Fill Memory .................................................................... 251Find .........................................................................169, 218Find in Projects .....................................................169, 218Find Next........................................................................ 218Find Previous ................................................................ 218Find Selection................................................................ 218Find Usages .................................................................. 218[Find Usages] ウィンドウ ........................................... 172Finish Debugger Session ....................................169, 223Fix Code......................................................................... 221Focus Cursor at PC.....................................168, 223, 251Force Makefile regeneration when opening a

project ......................................................................... 261Format ............................................................................ 221Forward .......................................................................... 220[Fractional Properties] ダイアログ ............................ 268Full Screen..................................................................... 219

G[Generated Command Line] タブ .................................85Git .................................................................................... 224Go to Declaration.......................................................... 220Go to File........................................................................ 220Go to Line....................................................................... 220Go to Previous Window............................................... 220Go to Source ................................................................. 220Go to Super Implementation....................................... 220Go to Symbol................................................................. 220Go to Type ..................................................................... 220GPR ...................................................................................15Graphical Display Designer (GDD) のサポート ...... 213

HHalt build on first failure............................................... 260Help................................................................................. 170Help Contents................................................................ 227[Help] メニュー ............................................................. 227[Help] メニューの相違点 ............................................. 212HEXMATE...................................................................... 124

Conflict Report ...................................................... 201HEX ファイルの正規化 ....................................... 101読み込み可能プロジェクト ................................ 124

HEX ファイル、正規化 ............................................... 101HEX ファイルの正規化 ............................................... 101

[Hierarchy] ウィンドウ .................................................172History .............................................................................224HI-TECH DSPICC ツールチェーン..............................78HI-TECH PICC18 ツールチェーン...............................78HI-TECH PICC32 ツールチェーン...............................78HI-TECH PICC ツールチェーン ...................................78Hold In Reset .................................................................117Hold in Reset..................................................................170[Hold in Reset] アイコン ..............................................103[How Do I] テキストボックス......................................230

IICSP ..................................................................................25IDE Log ..................................................................171, 219Import ..............................................................................217Insert Code.....................................................................221Insert Next Matching Word..........................................221Insert Previous Matching Word...................................221

JJRE のインストール.......................................................31

KKeeLoq Plugin のサポート ..........................................213Keyboard Shortcuts, MPLAB X IDE...........................227

LLast Edit Location..........................................................220Launch Debugger Main Project ..................................168Licenses..........................................................................224Locate Headers .............................................................256Log File ...........................................................................264Logging Level.................................................................264

MMacro Expansion...........................................................172Macro Recording Start/Stop........................................218Maintain active connection to hardware tool ............260main 関数

リセット .................................................................260Make................................................................................168Make and Program Device.................................117, 257Make and Program Device Main Project ..................170[Make and Program Device] アイコン ......................103Make Callee Current.....................................................169Make Caller Current......................................................169Make Clean ....................................................................168Make Options.................................................................261Makefile...........................................................................131Makefile プロジェクト .................................................158make オプション...................................................... 88, 98MATLAB/Simulink のサポート ....................................214[Memory] ウィンドウ............................................. 69, 113[Memory] ウィンドウのメニュー ...............................251Mercurial .........................................................................224[Message Center] ウィンドウ.....................................252Microchip 社への問い合わせ .......................................301Move Code Element Down..........................................221Move Code Element Up...............................................221Move Down ....................................................................221Move Up..........................................................................221MPASM ツールチェーン................................................78


索引

MPLAB C18 C コンパイラと構造 ............................. 196MPLAB ICD 2 のサポート........................................... 213MPLAB ICD 3 のサポート........................................... 213MPLAB ICE 2000 のサポート .................................... 213MPLAB ICE 4000 のサポート .................................... 213MPLAB IDE v8 プロジェクト、インポート ............ 191MPLAB PM3 のサポート............................................. 213MPLAB REAL ICE インサーキットエミュレータのサポート ........................................ 213

MPLAB VDI のサポート .............................................. 213MPLAB X IDE と MPLAB IDE v8 の相違点 ............. 203MPLAB X IDE のインストール .....................................31MPLAB X IDE のインストールとセットアップ .........31MPLAB X Store............................................................. 227myMicrochip 変更通知サービス ................................. 300

N[Navigate] メニュー...................................................... 220[Navigator] ウィンドウ ................................................ 172New Breakpoint............................................................. 223New Data Breakpoint................................................... 168New File .................................................................170, 217New Project ...........................................................170, 217New Run Time Watch..........................................168, 223New Runtime Watch .................................................... 267New Watch .......................................... 168, 169, 223, 267Next Bookmark ............................................................. 169Next Error...............................................................171, 220

OOnline Docs and Support ............................................ 227Open File................................................................171, 217Open Project .........................................................170, 217Open Recent File.......................................................... 217Open Recent Project.................................................... 217Open Required Projects .............................................. 170[Option Description] タブ ...............................................85OutOfMemoryError....................................................... 152[Output] ウィンドウ ..................................................... 172

PPage Setup.................................................................... 217[Pallette] ウィンドウ .................................................... 172Paste.......................................................................169, 218Paste Formatted ........................................................... 218Paste from History........................................................ 218Pause......................................................................169, 223PC-Lint のサポート ...................................................... 213PC プロファイリング .................................................. 168PDF................................................................................. 212[Peripherals] ウィンドウ ............................................. 249PIC AppIO...................................................................... 168PICkit 1 のサポート...................................................... 213PICkit 2 のサポート...................................................... 213PICkit 3 のサポート...................................................... 213PICSTART Plus のサポート ....................................... 213Plugins............................................................................ 224Preserve Memory ......................................................... 116Previous Bookmark ...................................................... 169Previous Error .......................................................171, 220Print................................................................................. 217Print to HTML ................................................................ 217

prjMakefilesGenerator ..................................................284PRO MATE II のサポート ............................................213Program Device for Debugging ..................................117Program Device for Debugging Main Project...........168Program Device for Production ..................................117[Program Memory] ウィンドウ ...................................243Programmer to Go PICkit 3 .........................................117Programmer to Go PICkit 3 Main Project .................170[Programmer] メニューの相違点................................210Project Group.................................................................217Project Properties........................................ 171, 217, 257[Project Properties] ウィンドウ ..................................172Projects ...........................................................................170[Projects] ウィンドウの表示 .......................................187[Project] メニューの相違点 .........................................209

QQuick Search .................................................................169

RRead Device Memory...................................................117Read Device Memory Main Project ...........................170Read Device Memory to File..............................117, 170Read EE/Flash Data Memory to a File......................117Reading, Recommended ...............................................12Readme ............................................................................ 12Redo .......................................................................169, 218Refactor

Change Function Parameter...............................222Copy ........................................................................222Move........................................................................222Rename ..................................................................222Safely Delete..........................................................222

[Refactor Preview] ウィンドウ ...................................172[Refactor] メニュー .......................................................222[Remote Terminal] ウィンドウ ..........................171, 172Remove Trailing Spaces..............................................221Repeat Build/Run..........................................................222Replace...........................................................................218Replace in Projects..............................................169, 218Reset ...............................................................................223Reset Windows..............................................................226Reuse Output Tabs from Finished Processes .........261RTDM を使った DMCI ............................... 116, 124, 128RTOS Viewer のサポート............................................213Run Debugger/Programmer Self Test.......................224Run File..................................................................170, 222Run Main Project...........................................................170Run Project............................................................170, 222Run SQL .........................................................................171Run Time Update Interval............................................267Run to Cursor........................................................169, 223[Run] アイコン...............................................................168[Run] メニュー......................................................222, 224

SSave .......................................................................171, 217Save All ..................................................................171, 217Save All Modified Files Before Running Make.........261Save As...........................................................................217Scan for compilers ........................................................262Scan for external changes...........................................221



[Search] ウィンドウ ..................................................... 172Segmented Display Designer のサポート................ 214Select All ........................................................................ 218Select Identifier ............................................................. 218Select in Classes .......................................................... 220Select in Favorites........................................................ 220Select in Files ................................................................ 220Select in Projects.......................................................... 220Self Test ......................................................................... 224[Services] ウィンドウ .................................................. 172[Sessions] ウィンドウ ................................................. 172Set Configuration.......................................................... 257Set Main Project ........................................................... 222Set PC at Cursor...................................................168, 223[Set PC to Cursor] アイコン ....................................... 168Set Project Configuration ............................................ 222SFR ...........................................................................15, 113[SFRs] ウィンドウ........................................................ 246Shift Left ......................................................................... 221Shift Right....................................................................... 221Show

Breadcrumbs ......................................................... 219Documentation...................................................... 221Editor Toolbar........................................................ 219Indent Guide Lines ............................................... 219Method Parameters.............................................. 221Non-printable Characters.................................... 219Profiler Indicators during Run............................. 261

Silent build ..................................................................... 260[Simulator Analyzer] ウィンドウ................................ 172Simulator Stimulus ....................................................... 172SN( シリアル番号 )..........................................................76[Sources] ウィンドウ ................................................... 172[Source] メニュー ......................................................... 221SQL History ................................................................... 171SQL, Keep Prior Tabs.................................................. 171Stack

Make Callee Current ............................................ 223Make Caller Current ............................................. 223Pop Last Debugger Call ...................................... 223Pop To Current Stack Frame ............................. 223Pop Topmost Call ................................................. 223

Start Page .......................................................38, 170, 227Start Sampling IDE....................................................... 170Status Toolbar Action................................................... 168Step Instruction .....................................................168, 223Step Into .................................................................169, 223Step Out .................................................................169, 223Step Over ...............................................................169, 223Step Over Expression.................................................. 169Stop Build/Run .............................................................. 222Stopwatch ..............................................................172, 225Subversion..................................................................... 224Synchronize Editor with Views ................................... 219

T[Tasks] ウィンドウ ....................................................... 172[Team Chat] ウィンドウ.............................................. 172Team Project ................................................................. 172[Team] メニュー ........................................................... 224Templates ...................................................................... 224

[Terminal] ウィンドウ..........................................171, 172Test File .................................................................170, 222Test Project ...........................................................170, 222[Test Results] ウィンドウ ............................................172[Threads] ウィンドウ ...................................................172TODO ....................................................................... 91, 177Toggle

Bookmark ...............................................................220Comment ................................................................221Line Breakpoint......................................................223

Tool Help Contents .......................................................227Toolbars .................................................................219, 228[Tools] メニューの相違点 ............................................211[Trace] ウィンドウ ........................................................172

UUndo .......................................................................169, 218USB .................................................................................307

デバイスドライバのインストール .......................32USB ブリッジ接続 ........................................................262[User Comments] タブ ...................................................85[User ID Memory] ウィンドウ .....................................250Userdir.............................................................................191

Vウォッチシンボルの .....................................................267[Variables] ウィンドウ ................................. 68, 112, 172[View] メニュー..............................................................219[View] メニューの相違点 .............................................208

W[Watches] ウィンドウ................................... 68, 110, 172

10 進形式 ................................................................26816 進形式 ................................................................268HEX 形式 ................................................................268バイナリ形式 .........................................................268文字形式 .................................................................268

Web Browser.........................................................171, 219Windows OS での 8191 文字の制限 ..........................198Windows XP と読み込み可能プロジェクト /ファイル......................................................................196

[Window] メニュー ........................................................225[Window] メニューの相違点........................................211

XXC16 ツールチェーン ....................................................78XC32 ツールチェーン ....................................................78XC8 ツールチェーン.......................................................78XML

Check DTD.............................................................173Check File......................................................173, 222Validate File ..................................................173, 222XSL Transform.......................................................173

XML ファイルタイプ ....................................................131XY Data...........................................................................245

ZZoom In ...........................................................................171Zoom Out........................................................................171

あ

アイコン


索引

[Watches] ウィンドウ.......................................... 266赤の感嘆符 ..................................................................... 180赤の感嘆符ポイント..................................................... 180赤のコンパイラパス........................................................87アセンブラファイルタイプ ....................................... 131

い

異なるプラットフォームで使う場合の問題 ............ 193インターネットアドレス、Microchip 社 ................. 300

う

ウィンドウ内のデータ入力 ........................................ 233ウィンドウのフォーカス............................................. 233ウェブサイト、Microchip 社 ...................................... 300ウォッチアイコン......................................................... 266列を指定したフォーマットで表示 ............................ 267ウォッチデータをエクスポート ................................ 267ウォッチドッグタイマ (Watchdog Timer) .............. 308

え

エディタのコードのエラー ........................................ 180エディタの使い方..................................................... 62, 92エディタ用ツールバー............................................. 62, 92エラー ............................................................................. 198

お

応答ファイル................................................................. 198お客様サポート............................................................. 301

か

外部 Makefile................................................................. 158外部 make ファイル ........................................................72

き

既存ファイルのプロジェクトへの追加 .......................91逆アセンブルリスティングファイル ...................... 137行ブレークポイント..................................................... 106

け

言語ツールオプション....................................................85言語ツールのインストール ...........................................36言語ツールのパス..................................................... 57, 86

こ

コードの実行...........................................................65, 103コードのステップ実行...........................................67, 109コードのデバッグ実行...........................................65, 104コードのリファクタリング ........................................ 142コールグラフ................................................................. 138コールスタック............................................................. 137高速化

MPLAB X IDE........................................................ 151コンパイラオプション ..................................................56コンパイラサポートマーク ..........................................78コンパイラライセンス

有効化 ..................................................................... 224ローミング............................................................. 224

コンパイラライセンスの取得 / 返却 ........................ 224コンフィグレーションビット ...........................115, 273

[Memory] ウィンドウ ........................................... 113チュートリアル........................................................62使い方 ..................................................................... 115

コンフィグレーション、全て .................................... 174

コンフィグレーション、複数 .....................................155

さ

サードパーティ製ハードウェアツール....................167サポートされるソフトウェアブレークポイント....141

し

シェルスクリプト .........................................................131時間の短縮

ビルド .....................................................................136シミュレートする周辺モジュールをクリックする .............................................................140

周辺モジュール ...............................................................17周辺モジュールメモリ .................................................113シリアルポート接続 .....................................................262新規プロジェクトの作成 ........................................ 47, 72

す

スタックハードウェア ...........................................................14

ステータスバー .............................................................231ステータスフラグ .........................................................140ストップウォッチ .........................................................136

せ

全ウォッチの削除 .........................................................267全ウォッチのリストファイルへのエクスポート.....267選択したウォッチの削除 .............................................267選択したウォッチのリストファイルへのエクスポート .............................................................267

そ

ソース管理 .....................................................................142相対パス .........................................................................191即座に実行を開始する .................................................260その他の [Memory] ウィンドウ ..................................248

た

ターゲットへの接続 .......................................................36代替プロジェクト HEX ファイル...............................124タプル、ブレークポイント .........................................107

ち

チェックサム .........................................64, 102, 140, 173HEXMATE ..............................................................101ユーザ ID として ...................................................100

チェックサムを使ったユーザ ID ................................100

つ

ツールごとのヘルプ .....................................................227ツールサポートマーク ..................................................76ツールバーのカスタマイズ .........................................168ツールバーボタンの追加 .............................................168

て

データ EEPROM.............................................................15データ競合エラー .........................................................129データメモリ .................................................................113停止、ウィンドウの更新時 .........................................233デスクトップ ....................................................37, 40, 215

各部 .........................................................................215ペイン ....................................................53, 61, 63, 82

デバイス ID ....................................................................253



デバイスのプログラミング...................................70, 116デバッガ / プログラマオプション ...............................55デバッガが停止した場合、ソースファイルを開き、エディタ内の行を検索します。.............................. 260

デバッグコンフィグレーション ............................... 157デバッグビルドコンフィグレーション ...........204, 209デバッグ読み出し......................................................... 116

と

特殊文字 ......................................................................... 191

は

バージョン管理 ............................................................. 142ハードウェアツール

アクティブな接続................................................. 260ハードウェアツールオプション ..................................84ハードウェアツールの常時接続 .......................103, 104ハードウェアツールの選択 ..........................................76ハードウェアツールの電圧 ....................................... 140ハードウェアツールのファームウェアバージョン ................................................................. 140

ハードウェアブレークポイント使用中の数 ............................................................. 141利用可能数 ............................................................. 141

パス、相対または絶対....................................................88汎用シリアルポート..................................................... 262

ひ

非アクティブ接続......................................................... 140ビルドコンフィグレーション ...........................204, 209ビルドステータス......................................................... 253ビルドプロパティ

ファイル ................................................................. 258プロジェクト......................................................... 257

ビルドプロパティの設定................................................98ヒントは見えません。................................................... 194

ふ

ファームウェアバージョン ....................................... 253ファイルウィザード.......................................................89ファイルプロパティ.................................................... 258ファイルおよびフォルダプロパティ ..........................96ファイルパスのオプション......................................... 261ファイル名 ..................................................................... 191ファイルレジスタ......................................................... 113フォルダ名 ..................................................................... 191複合ブレークポイント................................................. 107複数コンフィグレーション......................................... 155複数プロジェクト......................................................... 153プラグイン ..................................................................... 146フラッシュメモリ......................................................... 113プリビルドプロジェクト ........................................... 123プリビルドおよびポストビルドマクロ ......................99ブレークポイント...................................................66, 106

AND......................................................................... 107ウィンドウ ............................................................. 107行 ............................................................................. 106シーケンス ............................................................. 107ダイアログ ............................................................. 106タイミング ............................................................. 108タプル ..................................................................... 107リソース .........................................................108, 139

プログラムカウンタ ......................................................14プログラムメモリ .........................................................113プログラムメモリとデータメモリ ...............................14プロジェクトウィザード .................................47, 72, 73プロジェクトファイルの Zip ................... 166, 217, 256プロジェクトファイルのアーカイブ ........................217プロジェクトファイルの新規作成 ..............................89プロジェクトファイルのパッケージ化 ...........166, 256プロジェクトプロパティ

既定値................................................................. 54, 83言語ツール ...............................................................85デバッガ / プログラマ ............................................55ハードウェアツール ..............................................84

プロジェクトの移動 .....................................................191プロジェクトのビルド .......................................... 64, 102プロジェクト、複数 .....................................................153プロジェクトへの新規ファイルの追加 .......................58プロファイリング .........................................................142

へ

並列 make.......................................................................261

ほ

本書について表記規則 ...................................................................11

本書の構成レイアウト ................................................................. 9

ま

マークHW および SW ツール ...........................................76コンパイラ ...............................................................78

め

メニュー..........................................................................216メニュー項目とボタンの灰色表示または非表示.....231メモリ

プログラムとデータ ...............................................14メモリスタータキットのサポート ............................213メモリゲージ .................................................................140メモリサイズ ( プログラムメモリのウォッチシンボルのユーザ定義サイズ .................267

も

モータ制御アプリケーション ................... 116, 124, 128

ゆ

ユーザ ID.........................................................................113

よ

抑止可能メッセージ .......................................................88読み込み可能ファイル .................................................124読み込み可能プロジェクト .........................................124読み出し専用ファイル、プロジェクトのビルド.....144

ら

ライブラリコンフィグレーションタイプ.................98ライブラリファイル ......................................................93ライブラリプロジェクト ............................................130ライブラリ等のファイルのプロジェクトへの追加................................................................................93


索引

り

リセット ......................................................................... 168リセット時に main で停止する.................................. 260リセット時にリセットベクタ位置で停止する ........ 260リセットベクタ

停止 ......................................................................... 260リセット................................................................. 260

リセットベクタ位置で停止する ................................ 260リビジョン管理............................................................. 142リファクタリング......................................................... 185リモート Ethernet ツール ........................................... 262リモート USB ツールブリッジ .................................. 262リリースビルドコンフィグレーション ...........204, 209リンクの順序....................................................................91

れ

レガシー MPLAB プロジェクトのインポート......... 120連携 ................................................................................. 145

ろ

ローカル履歴................................................................. 142ログファイルオプション ..............................................88ログファイル、MPLAB X IDE ................................... 167ログファイル、NetBeans プラットフォーム.......... 167

わ

ワークスペース (MPLAB v8)...................................... 206



北米本社2355 West Chandler Blvd.Chandler, AZ 85224-6199Tel: 480-792-7200 Fax: 480-792-7277技術サポート : http://www.microchip.com/supportURL: www.microchip.comアトランタDuluth, GA Tel: 678-957-9614 Fax: 678-957-1455オースティン、TXTel: 512-257-3370 ボストンWestborough, MATel: 774-760-0087 Fax: 774-760-0088シカゴItasca, ILTel: 630-285-0071 Fax: 630-285-0075クリーブランドIndependence, OHTel: 216-447-0464Fax: 216-447-0643ダラスAddison, TXTel: 972-818-7423 Fax: 972-818-2924デトロイトNovi, MI Tel: 248-848-4000ヒューストン、TXTel: 281-894-5983インディアナポリスNoblesville, INTel: 317-773-8323Fax: 317-773-5453ロサンゼルスMission Viejo, CATel: 949-462-9523 Fax: 949-462-9608ニューヨーク、NY Tel: 631-435-6000サンノゼ、CATel: 408-735-9110カナダ - トロント

Tel: 905-673-0699 Fax: 905-673-6509

アジア / 太平洋アジア太平洋支社Suites 3707-14, 37th FloorTower 6, The GatewayHarbour City, KowloonHong KongTel: 852-2943-5100Fax: 852-2401-3431オーストラリア - シドニー

Tel: 61-2-9868-6733Fax: 61-2-9868-6755中国 - 北京

Tel: 86-10-8569-7000Fax: 86-10-8528-2104中国 - 成都

Tel: 86-28-8665-5511Fax: 86-28-8665-7889中国 - 重慶

Tel: 86-23-8980-9588Fax: 86-23-8980-9500中国 - 東莞

Tel: 86-769-8702-9880中国 - 杭州

Tel: 86-571-8792-8115Fax: 86-571-8792-8116中国 - 香港 SARTel: 852-2943-5100 Fax: 852-2401-3431中国 - 南京

Tel: 86-25-8473-2460Fax: 86-25-8473-2470中国 - 青島

Tel: 86-532-8502-7355Fax: 86-532-8502-7205中国 - 上海

Tel: 86-21-5407-5533Fax: 86-21-5407-5066中国 - 瀋陽

Tel: 86-24-2334-2829Fax: 86-24-2334-2393中国 - 深圳Tel: 86-755-8864-2200 Fax: 86-755-8203-1760中国 - 武漢

Tel: 86-27-5980-5300Fax: 86-27-5980-5118中国 - 西安

Tel: 86-29-8833-7252Fax: 86-29-8833-7256

アジア / 太平洋中国 - 厦門

Tel: 86-592-2388138 Fax: 86-592-2388130中国 - 珠海

Tel: 86-756-3210040 Fax: 86-756-3210049インド - バンガロール

Tel: 91-80-3090-4444 Fax: 91-80-3090-4123インド - ニューデリー

Tel: 91-11-4160-8631Fax: 91-11-4160-8632インド - プネ

Tel: 91-20-3019-1500日本 - 大阪

Tel: 81-6-6152-7160Fax: 81-6-6152-9310日本 - 東京

Tel: 81-3-6880-3770 Fax: 81-3-6880-3771韓国 - 大邱

Tel: 82-53-744-4301Fax: 82-53-744-4302韓国 - ソウル

Tel: 82-2-554-7200Fax: 82-2-558-5932 または

82-2-558-5934マレーシア - クアラルンプール

Tel: 60-3-6201-9857Fax: 60-3-6201-9859マレーシア - ペナン

Tel: 60-4-227-8870Fax: 60-4-227-4068フィリピン - マニラ

Tel: 63-2-634-9065Fax: 63-2-634-9069シンガポールTel: 65-6334-8870Fax: 65-6334-8850台湾 - 新竹

Tel: 886-3-5778-366Fax: 886-3-5770-955台湾 - 高雄

Tel: 886-7-213-7830台湾 - 台北

Tel: 886-2-2508-8600 Fax: 886-2-2508-0102タイ - バンコク

Tel: 66-2-694-1351Fax: 66-2-694-1350

ヨーロッパオーストリア - ヴェルス

Tel: 43-7242-2244-39Fax: 43-7242-2244-393デンマーク - コペンハーゲン

Tel: 45-4450-2828 Fax: 45-4485-2829フランス - パリ

Tel: 33-1-69-53-63-20 Fax: 33-1-69-30-90-79ドイツ - デュッセルドルフ

Tel: 49-2129-3766400 ドイツ - カールスルーエ

Tel: 49-721-625370ドイツ - ミュンヘン

Tel: 49-89-627-144-0 Fax: 49-89-627-144-44イタリア - ミラノ Tel: 39-0331-742611 Fax: 39-0331-466781イタリア - ヴェニス

Tel: 39-049-7625286 オランダ - ドリューネン

Tel: 31-416-690399 Fax: 31-416-690340ポーランド - ワルシャワ

Tel: 48-22-3325737 スペイン - マドリッド

Tel: 34-91-708-08-90Fax: 34-91-708-08-91スウェーデン - ストックホルム

Tel: 46-8-5090-4654イギリス - ウォーキンガム

Tel: 44-118-921-5800Fax: 44-118-921-5820

各国の営業所とサービス

07/14/15

http://www.microchip.com/support
