インストール - MPLAB X IDEのソースを表示

== 概要 ==
MPLAB X IDEとは、Microchip社が公式で提供しているPICおよびAVR用の統合開発環境(IDE)である。<br>
詳細を知りたい場合は、こちらの公式Webサイトを参照する。<br>
https://www.microchip.com/mplab/mplab-x-ide
<br><br>

== 依存関係のライブラリのインストール ==
以下の依存関係のライブラリをインストールする。<br>
 # SUSE
 sudo zypper install libX11-6-32bit libX11-xcb1-32bit libXau6-32bit libXext6-32bit libxcb1-32bit
<br><br>

== MPLAB X IDEのダウンロード ==
下記のURLから、MPLAB X IDEをダウンロードする。<br>
 https://www.microchip.com/mplab/mplab-x-ide
<br>
Linuxの場合は、ダウンロードしたファイルを解凍する。<br>
 tar zxvf MPLABX-vX.XX-<windowsまたはlinux>-installer.tar
<br><br>

== MPLAB X IDEのインストール ==
ダウンロードしたインストーラファイルに実行権限を付与ため、以下のコマンドを実行する。<br>
 chmod u+x MPLABX-<バージョン>-<windowsまたはlinux>-installer.run
<br>
インストーラファイルを実行する。<br>
Linuxの場合は以下のコマンドを実行する。Windowsの場合は実行ファイルをダブルクリックする。<br>
 sudo ./MPLABX-<バージョン>-<windowsまたはlinux>-installer.run
<br>
後は、インストーラの指示に従って進めていく。<br>
<br>
ここでは、MPLAB X IDEを/opt/microchip/MPLABXIDE-<バージョン>ディレクトリにインストールしている。<br>
<br>
インストール後、MPLAB IDEのデスクトップエントリファイルを編集する。<br>
 sudo vi /usr/share/applications/mplab.desktop
<br>
 # /usr/share/applications/mplab.desktopファイル
 
 # 編集前
 Exec=/usr/bin/mplab_ide
 
 # 編集後
 Exec=/usr/bin/mplab_ide --fontsize 18
<br>
4Kディスプレイを使用している場合、画面のフォントサイズを大きくする。<br>
# まず、MPLAB IDEを起動して、[Tools]メニューバー - [Options]を選択する。<br>
# [Options]画面が表示されるので、画面上部の[Appearance] - [Look and feel]タブ - [Preferred Look and feel]プルダウンから[GTK+]を選択する。<br>
# MPLAB IDEを再起動する。<br>
<br><br>

== XCコンパイラのインストール ==
MPLAB X IDEで使用するコンパイラを、[https://www.microchip.com/MPLABxc Microchipの公式Webサイト]にアクセスしてダウンロードする。<br>
使用するマイコンに合わせて、XC8、XC16、XC32をダウンロードする。<br>
* XC8
*: 8ビットのAVRマイコンとPICマイコン
* XC16
*: 16ビットのPICマイコンとdsPICマイコン
* XC32
*: 32ビットのAVRマイコンとPCマイコン
<br>
ダウンロードしたファイルに実行権限を付与してインストールする。<br>
(ここでは、XC8コンパイラをダウンロードしたものとして進める)<br>
 chmod u+x xc8-<バージョン名>-full-install-linux-installer.run
 sudo ./xc8-<バージョン名>-full-install-linux-installer.run
<br>
ここでは、XC8コンパイラを/opt/microchip/xc8ディレクトリにインストールしている。<br>
<br>
MPLAB X IDEを起動して、[Tool] - [Option] - [Embedded]アイコン - [Build Tools]タブを選択する。<br>
[Scan for Build Tools]ボタンを実行する、または、[Add]ボタンを入力して[Base Directory]項目にXC8のインストールディレクトリを入力する。<br>
[Toolchain:]項目にXCコンパイラが表示されているか確認する。<br>
<br>
また、XCコンパイラにフォーカスを当てた状態で[Default]ボタンを押下すると、標準コンパイラに設定できる。<br>
<br><br>

== AVR GCCツールチェインのインストール ==
==== Microchip社のAVR GCCツールチェーン ====
XCコンパイラ以外にも使用できるコンパイラが存在する。<br>
ここでは、Atmel Studioにも使用されているAVR GCCツールチェインのインストール方法を記載する。<br>
<br>
まず、[https://www.microchip.com/mplab/avr-support/avr-and-arm-toolchains-c-compilers Microchipの公式Webサイト]にアクセスして、AVR GCCツールチェインをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf avr8-gnu-toolchain-<バージョン>-<OS名>.any.x86_64.tar.gz
 mv avr8-gnu-toolchain-linux_x86_64 AVR-GNU-Toolchain  # 必要であれば、任意の名前に変更する
<br>
解凍したディレクトリを、MPLAB X IDEのインストールディレクトリに配置する。<br>
 sudo mv -r AVR-GNU-Toolchain <MPLAB X IDEのインストールディレクトリ>
<br>
次に、MPLAB X IDEを起動して、[Tool] - [Option] - [Embedded]アイコン - [Build Tools]タブを選択する。<br>
[Scan for Build Tools]ボタンを押下、または、[Add]ボタンを押下して[Base Directory]項目にAVR GCCツールチェインを配置したディレクトリを選択する。<br>
例えば、AVR GCCツールチェーンのディレクトリを/opt/microchipディレクトリに配置した場合は、<u>/opt/microchip/AVR-GNU-Toolchain/bin</u>ディレクトリを選択する。<br>
<br>
[Toolchain:]項目にAVR GCCツールチェインが表示されているかどうかを確認する。<br>
<br>
<u>※注意</u><br>
<u>Windowsを使用している場合、このツールチェーンはAtmel Studioに含まれている。</u><br>
<bt>
==== サードパーティ製のAVR GCCツールチェーン ====
有志が開発しているAVR GCCツールチェーンを使用することもできる。<br>
<br>
次に、以下に示すWebサイトにアクセスして、AVR GCCツールチェーンをダウンロードする。<br>
最新版 : https://blog.zakkemble.net/avr-gcc-builds<br>
過去のリリース : https://github.com/ZakKemble/avr-gcc-build/releases<br>
<br>
ダウンロードしたAVR GCCツールチェーンを解凍する。<br>
 tar xf avr-gcc-<バージョン名>-x64-<OS名>.tar.bz2
 mv avr-gcc-<バージョン>-x64-linux AVR-GNU-<バージョン>-Toolchain  # 必要であれば、任意の名前に変更する
<br>
解凍したディレクトリを、MPLAB X IDEのインストールディレクトリに配置する。<br>
 sudo mv AVR-GNU-<バージョン>-Toolchain <MPLAB X IDEのインストールディレクトリ>
<br>
次に、MPLAB X IDEを起動して、[Tool] - [Option] - [Embedded]アイコン - [Build Tools]タブを選択する。<br>
[Scan for Build Tools]ボタンを押下、または、[Add]ボタンを押下して[Base Directory]項目にAVR GCCツールチェインを配置したディレクトリを選択する。<br>
例えば、AVR GCCツールチェーンのディレクトリを/opt/microchipディレクトリに配置した場合は、<u>/opt/microchip/AVR-GNU-Toolchain/bin</u>ディレクトリを選択する。<br>
<br>
[Toolchain:]項目にAVR GCCツールチェインが表示されているかどうかを確認する。<br>
<br><br>

== MPLAB X IDEのアンインストール ==
MPLAB X IDEのインストールディレクトリ直下に以下の2つのファイルが存在する。<br>
* Uninstall_MPLAB_X_IDE_v5.40.desktop
* Uninstall_MPLAB_X_IDE_v5.40
<br>
これらのファイルの内、いずれかのファイルをスーパーユーザ権限で実行する。<br>
 sudo ./Uninstall_MPLAB_X_IDE_v5.40.desktop
 または
 sudo ./Uninstall_MPLAB_X_IDE_v5.40
<br><br>

== XCコンパイラのアンインストール ==
まず、MPLAB X IDEを起動して、[Tool] - [Option] - [Embedded]アイコン - [Build Tools]タブを選択する。<br>
[Options]画面左にある[Toolchain:]項目から、アンインストールするXCコンパイラにフォーカスを当てて、[Remove]ボタンを押下する。<br>
MPLAB X IDEを終了する。<br>
<br>
次に、XCコンパイラのインストールディレクトリ直下に移動して、以下のいずれかのファイルをスーパーユーザ権限で実行する。<br>
 sudo ./Uninstall MPLAB XC8 C Compiler.desktop
 または
 sudo ./Uninstall-xc8-v2.20
<br><br>

== ファームウェアの書き込み ==
ここでは、書き込みデバイスとしてAtmel-ICEを使用している。<br>
<br>
# [File]メニューバー - [Project Properties]を選択する。<br>または、メイン画面左上の[Projects]ウインドウにあるプロジェクトを右クリックして、[Properties]を選択する。<br>または、下図の赤枠のプルダウンから[Customize...]を選択する。
#: [[ファイル:MPLAB Install 1.png|フレームなし|中央]]
# [Project Properties]画面が表示されるので、画面左の[Categories:]ウインドウから[Conf: Release] - [Atmel-ICE]を選択する。
# 画面右にある[Option Categories:]プルダウン - [Communication]を選択して、以下の項目を変更する。
#: [Interface]項目を[ISP]に設定する。
#: [Speed (MHz)]項目を[0.125]に設定する。
# [Apply]ボタンを押下後、[OK]ボタンを押下する。
# [Make and Program Device]アイコンを押下して、ファームウェアをマイコンに書き込む。
<br><br>

== ファームウェアのデバッグ ==
ここでは、書き込みデバイスとしてAtmel-ICEを使用している。<br>
<br>
# [File]メニューバー - [Project Properties]を選択する。<br>または、メイン画面左上の[Projects]ウインドウにあるプロジェクトを右クリックして、[Properties]を選択する。<br>または、下図の赤枠のプルダウンから[Customize...]を選択する。
#: [[ファイル:MPLAB Install 1.png|フレームなし|中央]]
# [Project Properties]画面が表示されるので、画面左の[Categories:]ウインドウから[Conf: Debug] - [Atmel-ICE]を選択する。
# 画面右にある[Option Categories:]プルダウン - [Debug Option]を選択して、以下の項目を変更する。<br>[Use Software Breakpoints]チェックボックスにチェックを入力する。
# 画面右にある[Option Categories:]プルダウン - [Communication]を選択して、以下の項目を変更する。<br>[Interface]項目を[debugWire]に設定する。
# [Apply]ボタンを押下後、[OK]ボタンを押下する。
# [Debug Main Project]アイコンを選択して、ファームウェアのデバッグを行う。
:: この時、下図のメッセージボックスが表示される場合は、10秒以内にマイコンに供給している電源を切り、再度電源を入れて、[OK]ボタンを押下する。
:: [[ファイル:MPLAB Install 2.png|フレームなし|中央]]
:: <br>
:: また、デバッグを開始する際、下図のメッセージが表示される時がある。
:: これは、現在、AVRマイコンがISPモードであるため、debugWIREを使用することができないからである。
:: メッセージボックスの[Yes]ボタンを押下すると、Atmel-ICEのISPモードを使用してdebugWIREモードに切り替えることができる。
:: [[ファイル:MPLAB Install 3.png|フレームなし|中央]]
<br>
<u>※注意</u><br>
<u>[Communication]プルダウン項目の[Speed(MHz)]の値は"0.000"となっており、非活性となっているため、変更することができない。</u><br>
<u>この問題について、Microchip社曰く、バグであるとのことである。</u><br>
<br>
<u>そのため、デバッグ開始時に以下のようなエラーが発生する。</u><br>
 Unexpected status code when executing setBaud, expected 0 but got -51 (SPI_STATUS_BAUD_INVALID)
<br>
<u>このバグを回避するには、以下の2つの方法がある。</u><br>
* 回避策 1
*: MPLAB X IDEプロジェクトのnbprojectディレクトリ直下にある<code>configurations.xml</code>ファイルを、以下のように、手動で有効な速度に編集する。
*: 以下のエレメントは、<AtmelIceTool>要素内に存在する。
*: [Speed(MHz)]の値は、<code>0.125</code>[MHz]または<code>動作させるマイコンのクロック速度の1/4</code>等を入力する。
*: <code><property key="communication.speed" value="0.125"/></code>
*: <br>
* 回避策 2
*: MPLAB X IDEプロジェクトを、v5.35で作成して、v5.40以降でプロジェクトを開いて使用する。
<br><br>

== ヒューズビットの変更 ==
ヒューズビットの変更にはハードウェアプログラマ (例: AVRISP mkIIやAtmel ICE等) が必要である。<br>
ヒューズビットの設定は慎重に行い、必要な変更のみを適用する。<br>
<br>
# ATmegaマイコンとAtmel ICEを接続する。
# PCとAtmel ICEを接続する。
# MPLAB X IDEを起動して、ATmegaマイコンを使用するプロジェクトを開く。
# MPLAB X IDEのメイン画面上部にあるツールバーから、[Read Device Memory]アイコンを選択する。<br>これにより、ATmegaマイコンのデバイス情報が読み込まれる。
# MPLAB X IDEのメインメニューから、[Production] - [Set Configuration Bits]を選択する。
# MPLAB X IDEのメイン画面下部に[Configuration Bits]ウィンドウが表示される。<br>このウインドウで、ATmegaマイコンのヒューズビットを設定することができる。
# 変更したいヒューズビットの設定を選択して、変更する。
#* 例: オシレータ (水晶発振器) の設定を変更する場合は、[SUT_CKSEL]の値を変更する。
#: <br>
# ヒューズビットの設定を変更した後、[Generate Source Code to Output]ボタンを押下する。<br>これにより、設定したヒューズビットの値がプロジェクトのソースコードに反映される。
# プロジェクトをビルドしてATmegaマイコンに書き込むことにより、書き込み時にヒューズビットの設定が適用される。
<br>
<u>※注意</u><br>
<u>ヒューズビットの設定を誤ると、マイコンが動作しなくなる可能性がある。</u><br>
<u>そのため、ヒューズビットの変更前にデータシートを確認して、各ビットの機能を理解しておくことが重要である。</u><br>
<br>
<u>一部のヒューズビット (特に、<code>SPIEN</code>) を誤って変更すると、ISP経由でのプログラミングができなくなる可能性があるため注意が必要である。</u><br>
<br><br>


__FORCETOC__
[[カテゴリ:AVR]][[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Windows10]]