NFApp2

Imported from ymd65536/NFApp2 (AGENTS.md). Install upstream with npx skills add ymd65536/NFApp2. Copyright stays with the author.

M5StackをnanoFrameworkで使う方法

このドキュメントでは、M5StackデバイスをnanoFrameworkで使用するための手順とガイドを提供します。

ユーザーとの会話には日本語で回答してください。

nanoFramework プログラミングガイド

• 名前空間
• 標準出力

名前空間

M5StackをnanoFrameworkで使用するには、以下の名前空間をインポートしてください。

using nanoFramework.M5Stack;

標準出力

Console.WriteLineメソッドを使用して標準出力ができます。

Console.WriteLine("Hello, nanoFramework!");

M5Stackのスクリーンを使用する場合はInitializeScreenメソッドを呼び出してから、Console.Clearメソッドで画面をクリアします。以下の例はM5Stack Fireの場合です。

Fire.InitializeScreen();
Console.Clear();

名前空間のusing Systemを使うと、Consoleクラスが競合する可能性があります。

出力されるエラーの例

error CS0104: 'Console' is an ambiguou
s reference between 'nanoFramework.M5Stack.Console' and 'System.Console'

エラーが発生した場合は、次の選択肢のいずれかを使用して解決してください。

PCのコンソールに出力する場合は、using Console = System.Console;のようにエイリアスを設定してください。

using Console = System.Console;

M5Stackの画面に出力する場合は、using Console = nanoFramework.M5Stack.Console;のようにエイリアスを設定してください。

using Console = nanoFramework.M5Stack.Console;

Math

System.Math名前空間を使用する場合は、以下のようにインポートしてください。

using Math = System.Math;

M5StackをnanoFrameworkで使うための指示

• 前提
• デバイス情報を確認する
• ターゲットを確認する
• ブートローダの書き込み
• デプロイ
• パッケージのリストア

前提

• 必ず名前空間をインポートしてください - using nanoFramework.M5Stack; をProgram.csの先頭に記載する必要があります。これがないとビルドエラーが発生します
• 最初にデバイス情報を確認してください
  • ESP32_PSRAM_REV3あるいはESP32_REV3というターゲット名が表示された場合はM5Core2として認識してください
• macOSでプログラムをデプロイしてもうまくいかない可能性があります
• デプロイにはM5Stackで動作する.binファイルを使用してください。.exeファイルはM5Stackで動作しません

デバイス情報を確認する

--serialportは、接続されているM5Stackデバイスのシリアルポートの番号を指定します。

実機で確認した例（ESP32_PSRAM_REV3でM5Core2扱い）：

nanoff --serialport COM6 --identifyfirmware

nanoff --serialport [シリアルポートの番号] --identifyfirmware

シリアルポート番号がわからない場合は、以下のコマンドで接続されているシリアルデバイスの一覧を表示できます。

nanoff --listports

ターゲットを認識する

nanoff利用できるターゲットの一覧を表示するには、以下のコマンドを実行して確認してください。

nanoff --listtargets

ブートローダの書き込み

M5Stackデバイスに対応したブートローダを書き込むには、以下のコマンドを使用します。 書き込みの際は、デバイスが接続されているシリアルポートを指定する必要があります。

デバイス情報を確認するセクションで確認したターゲット名を--targetオプションに指定してください。

ターゲット名の一覧はターゲットを認識するセクションを参照してください。

[serialport]にはnanoff --listportsで確認したシリアルポートを指定してください。

--fwversionはわからない場合は省略可能です。

nanoff --update --target M5Core2 --fwversion 1.16.0.568 --serialport [serialport] --baud 115200 --masserase

ビルド

必須要件

ビルドを実行する前に、以下の確認をしてください：

• Program.csに名前空間をインポート - ファイルの先頭に using nanoFramework.M5Stack; を記載
• VS Code拡張のパスを確認 - ~/.vscode/extensions ディレクトリから nanoframework.vscode-nanoframework-* フォルダを確認し、バージョン番号を把握してください

Windowsでのビルド

dotnet msbuild コマンドを使用しないで、Visual StudioのMSBuildを直接呼び出してビルドを行います。

NanoFrameworkProjectSystemPathは実際のextensionのパスに合わせて変更してください。 パス内のバックスラッシュ \ とスラッシュ / の混在に注意してください。

以下のコマンド例です（実際のバージョンとユーザーパスに合わせて調整してください）。GenerateDeploymentImage=true を付与すると bin\Debug\NFApp2.bin が生成されます。

$path = & "${env:ProgramFiles(x86)}\microsoft visual studio\installer\vswhere.exe" -products * -latest -prerelease -requires Microsoft.Component.MSBuild -find MSBuild\**\Bin\amd64\MSBuild.exe | select-object -first 1; & $path "c:\Users\Yamada\Desktop\NFApp2\NFApp2\NFApp2.nfproj" -t:Rebuild -p:platform="Any CPU" /p:NanoFrameworkProjectSystemPath="C:\Users\Yamada\.vscode\extensions\nanoframework.vscode-nanoframework-1.0.185\dist\utils\nanoFramework\v1.0\" /p:GenerateDeploymentImage=true /p:Configuration=Debug -verbosity:minimal

従来のsln指定例（.exeのみ生成する場合。デプロイ用.binは出ません）:

$path = & "${env:ProgramFiles(x86)}\microsoft visual studio\installer\vswhere.exe" -products * -latest -prerelease -requires Microsoft.Component.MSBuild -find MSBuild\**\Bin\amd64\MSBuild.exe | select-object -first 1; nuget restore "c:\Users\[ユーザー名]\Desktop\NFApp2\NFApp2\NFApp2.sln"; & $path "c:\Users\[ユーザー名]\Desktop\NFApp2\NFApp2\NFApp2.sln" -p:platform="Any CPU" /p:NanoFrameworkProjectSystemPath="c:\Users\[ユーザー名]\.vscode\extensions\nanoframework.vscode-nanoframework-1.0.185\dist\utils\nanoFramework\v1.0\" -p:NFMDP_PE_Verbose=false -p:NFMDP_PE_VerboseMinimize=false -verbosity:minimal /p:OutDir="c:\Users\[ユーザー名]\Desktop\NFApp2\NFApp2\bin\Debug"

注意：

• [ユーザー名] を実際のユーザー名に置き換えてください
• VS Code拡張のバージョン番号 1.0.185 が異なる場合は、実際の番号に置き換えてください
• このコマンドは bin\Debug\ ディレクトリに NFApp2.exe を生成します

ビルド成功の確認

ビルドが成功すると、以下のファイルが生成されます：

• bin\Debug\NFApp2.exe - 中間生成ファイル（M5Stackへのデプロイには使用できません）
• bin\Debug\NFApp2.pdbx - デバッグシンボルファイル
• bin\Debug\ 配下の多数のDLLファイル - 依存ライブラリ

注意： M5Stackへのデプロイには、VS Code拡張が生成する.binファイルが必要です。.exeファイルはM5Stackで動作しません

ビルドが失敗したら、作業を中断してください。

デプロイ

M5Stackのデプロイには、nanoffコマンドを使用します。VS Code拡張が生成した .bin ファイルをM5Stack デバイスにデプロイします。

シリアルポート番号（COM番号）の確認

デプロイ前に、接続されているM5Stackデバイスのシリアルポート番号を確認してください。

nanoff --listports

デバイス情報を確認するセクションで確認したターゲット名を確認し、以下のコマンド例を参考にしてください。

Windowsでのデプロイ

M5Stackへのデプロイには、VS Code拡張が生成する .bin ファイルを使用してください。.exeファイルではM5Stackで動作しません。

実際の成功例（M5Core2相当デバイス、COM6、ターゲット未指定で--nanodevice --deployを併用）：

nanoff --nanodevice --deploy --serialport COM6 --image "c:\Users\Yamada\Desktop\NFApp2\NFApp2\bin\Debug\NFApp2.bin"

--nanodevice と --target の併用はエラーになるため、nanodevice指定に統一してください。

nanoff --nanodevice --deploy --serialport COM6 --image "c:\Users\[ユーザー名]\Desktop\NFApp2\NFApp2\bin\Debug\NFApp2.bin"

置き換えるもの：

• COM6 - 確認したシリアルポート番号に置き換えてください
• [ユーザー名] - 実際のユーザー名に置き換えてください
• M5Core2 - 必要に応じてターゲット名を変更してください

デプロイ成功の確認

デプロイが成功すると、以下のメッセージが表示されます：

Wrote ... bytes ... at ... in ... s
Hash of data verified.
Hard resetting via RTS pin...
OK

M5Stackのスクリーンに設定されたアプリケーション出力が表示されます

端末のリセット

[serialport]にはnanoff --listportsで確認したシリアルポートを指定してください。

nanoff --serialport [serialport] --reset

デバイスの詳細情報を確認する

nanoff --serialport [serialport] --devicedetails

macOSの場合

macOSでM5Stackにデプロイする際に問題が発生する場合があります。

ビルド

以下のコマンドはmacOSでの例です。

msbuild NFApp2.sln -p:platform="Any CPU" /p:NanoFrameworkProjectSystemPath=/Users/ymd65536/.vscode/extensions/nanoframework.vscode-nanoframework-1.0.185/dist/utils/nanoFramework/v1.0/ -p:NFMDP_PE_Verbose=false -p:NFMDP_PE_VerboseMinimize=false /p:OutDir=OutputDir /p:Configuration=Debug /p:GenerateDeploymentImage=true /v:m

デプロイ

macOSでM5Stackにデプロイする例（--targetはCore2を例にしています）:

nanoff --target M5Core2 --deploy --serialport /dev/cu.usbserial-5A490990381 --image /Users/ymd65536/Desktop/NFApp2/bin/Debug/NFApp2.bin

.binファイルを使用してください。.exeファイルはM5Stackで動作しません。

パッケージのリストア

nuget restore "c:\Users\Yamada\Desktop\NFApp2\NFApp2\NFApp2.sln"

トラブルシューティング

CS0103: 名前が現在のコンテキストに存在しません

エラーメッセージ：

error CS0103: The name 'Fire' does not exist in the current context
error CS0103: The name 'Console' does not exist in the current context

原因： Program.csに必要な名前空間がインポートされていません。

解決方法： Program.csの先頭に以下の行を追加してください。

using nanoFramework.M5Stack;

デプロイファイルが見つからない

エラーメッセージ：

Error E2002: Error executing operation with nano device. 
(Couldn't find the deployment file at the specified path.)

原因： 指定されたパスに .exe または .bin ファイルが存在しません。

解決方法：

1. ビルドが正常に完了していることを確認してください（bin\Debug\NFApp2.exe が存在するか確認）
2. デプロイコマンドのパスが正しいことを確認してください
3. パスにスペースが含まれている場合は、ダブルクォーテーションで囲んでください

System.Drawing名前空間が競合する場合

nanoFramework.Graphics 名前空間とSystem.Drawing名前空間が競合する場合があります。 解決方法： nanoFramework.Graphicsをインストールされているパッケージから削除してください。NFApp2.nfprojを修正し、nugetで再インストールしてください。

nanoFramework系のパッケージが競合する場合

複数のnanoFramework系パッケージが競合する場合があります。 この場合はSystemのパッケージを利用するようにし、nanoFrameworkのパッケージを削除するようにしてください。