序文
このドキュメントは、2011年に dereksnell によって書かれた AN4379 Freescale USB Mass Storage Device Bootloader の補足および改訂版です。オリジナル・バージョンは、Flexis JM/ColdFire MCF522XX/Kinetis K60のCWでプログラムされていました。2年間更新されていません。
2013年に、私はFSL MKL25ZをUSBホスト/ OTGアプリケーション用の好ましいプラットフォームとして選択しました、なぜならそれは競合他社の通常のデバイスモジュールの代わりにオンチップOTGモジュールを持っているからです。いくつかのUSBホストアプリケーションを開発できます。IARは、ARM向けに32KBの限定版を提供できるため、KL2Xおよびその他のMCU開発用の商用コンパイラに選ばれています。AN4379を FRDM-KL25Zで動作させるには、コンパイラ(CWからIAR EWへ)とハードウェアプラットフォーム(K60からKL25へ)の移植作業が必要です。
再利用されたソース
FSL USBスタックがv4.0.3 / v4.1.1とDerekのベースの間で多くの点で改善されていることがわかったため、元のリリースをあきらめました。USB スタックの MSD アプリケーションは、ベースラインとして再利用されます。また、AN2295シリアルブートローダーのフラッシュとシリアルポートドライバー、およびデバッグ用のいくつかのヘルパー関数をマージします。
printf( ) は、全速力の実行中に情報を明らかにすることができるため、デバッガよりも役立つ場合があります。ただし、多くのリソースを占有するため、あまり多くの文字を印刷しないでください。どこにでもメッセージを印刷せず、必要な場合にのみ使用し、最終リリースでそれらを削除します。
ブートローダ プロジェクトとソース
動作するブートローダー プロジェクトには、次のファイルとパスが含まれている必要があります。
X:\Freescale USBスタックv4.0.3\Source\Device\app\msd_bootloader
X:\Freescale USBスタックv4.0.3\Source\Device\app\common
X:\Freescale USBスタックv4.0.3\Source\Device\source\driver\kinetis
X:\Freescale USBスタックv4.0.3\Source\Device\source\class\usb_msc*.*
X:\Freescale USBスタックv4.0.3\Source\Device\source\common
私はDevice \ sourceフォルダ内のコードに触れておらず、USBスタックの一部です。それらを別のフォルダに解凍して、既存のUSBスタックツリーにマージできます。
共通フォルダ内の一部のコードを変更したので注意してください。それらを比較ツールでマージするのはあなた次第です。また、MSD ブートローダと MSD ユーザアプリケーションは、 main() に違いがあります。
添付されたプロジェクト msd_bootloader_v10beta_20131029.zip をIAR EWで開き、リビルドしてデバッガにダウンロードします。
その後、ユーザーのUSBポートをPCに接続すると、OSはMSCデバイスの接続を促し、 後でBOOTLOADER ドライバーが表示されます。ドラッグアンドドロップ、コピーアンドペースト、またはコマンドプロンプトに入力して、ユーザーアプリケーションのSレコードファイルを BOOTLOADER ドライバーにコピーできます。
アプリケーション コードが MSD ブートローダ用に設計されている場合、リセット後に実行されます。MSD ブートローダ用に設計されているものについては、次の章を確認してください。
まず最初に
ブートローダーには、ユーザーアプリケーションへの条件付きジャンプが必要です。条件は、プッシュボタンまたはタイムアウトカウンタである可能性があります。そのため、GPIOとタイマーを最初のステップとして初期化する必要があります。Cortex-Mの性質上、場合によってはMCGも初期化する必要があります。ただし、MCG初期化ルーチンを複数回呼び出すと、システムがハングする可能性があることがわかりました。詳細ロジックは、これまでのところ復元されていません。しかし、MCG pll_init（ にはあまり触れずに、初期 GPIO と LPTMR のみを使用することをお勧めします。
デフォルトの操作
ブートローダーは、リセット後に PTA2 が接地されているかどうかを確認します。アースに接続されていると、とにかくブートローダーにドロップします。それ以外の場合は、SP/PCのチェックのために0x8000~0x8004をチェックします。有効なユーザーアプリケーションがある場合は、ユーザーアプリケーションに制御を移します。そうでない場合、ブートローダーは BOOTLOADER という MSD ドライバーを列挙します。ドライバの中にはREADY.TXTというファイルがあります。
カスタムブートローダー
ブートローダーは直接使用することも、カスタマイズすることもできます。そのため、私はまだ改訂されたブートローダーをオープンソースとして保持しています。ドライバーのラベルの名前を変更したり、ダウンロードして実行したり、Intel Hexなどのファームウェア形式を追加したり、別のISPプッシュボタンを使用したり、ドライバーのサイズを変更したり、デバッグ目的でCDCを追加したり、カスタムドライバーのインストール用にドライバーinfファイルを追加したり、ファイルシステムを介した双方向通信を追加したり、機能を追加したりできます。
ただし、FAT16を理解し、お客様ご自身で修正を行う必要があります。あなたは自分自身を助けなければなりません。
デモユーザーアプリケーションプロジェクト
FRDM_KL25ZDemo_freedom.srec の別の添付ファイルは、Kinetis L ファミリ リリースのデモ プロジェクトとその S19 ファイルで、変更された ICF リンク ファイルにリンクされています。
ユーザーアプリケーションの開始アドレスはデバイスに大きく依存し、基本的には32ビットフラッシュ保護レジスタに関連しています。
MKL25Z128VLK4には128KBのフラッシュメモリがあるため、最小保護フラッシュブロックは128K / 32 = 4KBです。既存の MSD ブートローダのリリースは 22KB(0x597F)です。したがって、0x6000アプリケーションの開始アドレスにすることができます。将来のリリースで統合される可能性のある機能とデータストレージを考慮すると、アプリケーションの開始アドレスとして0x8000することをお勧めします。
汎用 ICF ファイル
AN2295(シリアル) / AN4370(DFU) / AN4379(MSCデバイス)ブートローダでの開発中に、より多くのリンカファイルを用意しました。唯一の違いは、開始アドレス、別名再配置されたベクトルアドレスが0x4000 / 0x8000 / 0xA000の範囲であることです。添付ファイル は、その名前から説明しています
ICFファイルに必要な変更は、AN2295 / AN4370 / AN4379ドキュメントで簡単に見つけることができます。
開発を容易にするために、3つのバージョンのICFファイルをリンカスクリプトフォルダに入れることができます。
不要なフラッシュ保護バイト
S-Recordファイルを調べると、フラッシュ保護バイトがユーザーアプリケーションでまだ予約されていることがわかりました。さらに、0x80C0 と 0x83FF の間の領域は、0xFF バイトの空白バイトとして保持されます。0x8410から0x841Fまでのフラッシュ保護バイトは、0x410~0x41F以外の再配置されたフラッシュアドレスでは役に立たないため、不要です。定義を削除し、ユーザーコードとEEPROMエミュレーション用の一部のフラッシュメモリを解放できます。
これらのバイトを解放するためには、ソースファイルと icf ファイルを誰が保持しているかを検索する必要があります。このトピックについては、ここでは説明しません。
デバッグスキル
FRDM-KL25Zを使用して、ブートローダとユーザーアプリケーションの両方をデバッグできます。すごい！
通常のアプリケーションであるため、デバッグブートローダは簡単です。再配置されたユーザーアプリケーションをデバッグする方法は?ファームウェアはブートローダーでダウンロードできます。ブートローダーがユーザーアプリケーションに制御を移した後、逆アセンブルウィンドウでデバッグする必要があります。
または、ユーザーファームウェアをデバッガの通常のアプリケーションとしてダウンロードすることもできます。デバッガは、ユーザーアプリケーションのmain( )で停止します。main.ブレークポイントを追加するだけで、リセットを押します。デバッガーは、メインへの実行を停止するかどうかを通知します。「停止」をクリックすると、ユーザーのPCが指すアドレスに転送されます。
これらのスキルを使用して、ブートローダー pll_init()がユーザーアプリケーションのpll_init()にいくつかの副作用があることがわかりました。デバッガは、ブートローダと再配置されたユーザファームウェアの両方のデバッグに非常に役立ちます。IARのデバッガと比較すると、Eclipseのデバッグウィンドウは混乱しています。リセットボタンは一切ありません。そのため、私は通常、IARを開発に使用し、後でGCCに移植します。
その他の機能
FSLブートローダーは基本的なフレームワークのみを提供します。ユーザーは、将来の開発でより多くの機能が必要になります。利用可能になったら以下の機能をご用意しております。
ライセンスファイル
SNRとインストール、アクティベーション、認証、およびユーザーAPIが含まれます。このライセンスプログラムにより、ファームウェア開発者はIPR投資を収益化できます。
ユーザーファイル
オンチップフラッシュメモリでエミュレートされたファイルをサポートし、ドライバー、html、その他のファイルを含みます。ユーザーは関連するドライバーに簡単にアクセスできるため、便利な機能です。また、これらのファイルは読み取り専用でウイルスに強いことができます。このファイルは、アクセス制御やその他のセキュリティアプリケーションのキーとしても使用できます。
ROM API
ブートローダーはユーザーアプリケーションの一部として使用できるため、認証、シリアル通信、その他のアルゴリズムなど、いくつかの重要なROM APIを統合できます。実装、専用のコードセクションの定義、およびコンパイラによる最適化を回避するためのKEEPディレクティブの使用は簡単です。
制限
このリリース中に一部のコードを変更しました。bootloader_task.cのように.FlashConfig は、32KB または 24KB を保護するように更新する必要があります。現在の数値0xFFFFFFFE、1つのブロック(別名4KB)のみを保護します。また、デバイスに大きく依存します。(間違っていたら訂正してください)
だから、まだバグがたくさんあるのかもしれません。あなたのコメントを残してください。
私はSレコードファイルでのみテストしましたが、CWバイナリファイルと生のバイナリファイルで自由にテストできます。Sレコードファイルでさえ、ファイル内のメモリギャップがあるそれらのファイルをテストしていません。たぶん、ダウンロードする前に0xFFでギャップを埋める必要があります。
こんにちはデビッド:
あなたのコメントを明確にするために:
さらに、NXPがチケット制のサポートデスクを閉鎖したため、ヘルプを引き出すためのコミュニティフォーラムのみになりました。
私はあなたがこのアイデアをどのように得たのか興味があります。FreescaleとNXPの合併以来、私たちは異なるサポートシステムを使用しているため、サポートリクエストの提出プロセスは変更されましたが、閉じられていませんでした
。手順については、次のリンクを参照してください。
さらに、このコミュニティはテクニカル サポート チームによって監視されています。
特にここでのあなたの質問についてですが、私はちょうどあなたの他の投稿でIARプロジェクトを共有しました。
TWR-K60プロジェクト用のUSB大容量記憶装置ブートローダAN4379をIAR EWBに移植
敬具
ホルヘ・ゴンザレス
マーク様へ
あなたの助けの申し出を拡大するために時間を割いていただきありがとうございます。私は今、uTaskerプロジェクトとあなたの努力についてはるかに明確に理解しており、フォーラムの他の人々の助けになると確信しています。この場をお借りして、私の誤解と私が引き起こした可能性のある摩擦についてお詫びしてもよろしいでしょうか?
私はあなたがuTaskerサイトに関するいくつかの建設的なフィードバックを提供することを気にしないことを願っています、これを間違った方法で取らないでください、しかしuTaskerプロジェクトのホームページの私の経験は、それが多くの情報を含んでおり、新参者のために何が提供されているかについて不明瞭になる可能性があるということでした。 ソースコードを見つける のが難しい と感じたので、サイトの検索機能や 「このサイトの使い方」ガイド も役立つでしょう。
私は今、あなたのサイトを探索するのにいくらかの時間を費やし、あなたが前の投稿で言っていることは真実であり、スタンドアロンのUSB MSDブートローダーのコストを50%削減することは実際にはコストパフォーマンスが高く、商業的 に理にかなっていると結論付けました。
よろしくお願いします。
Dave
こんにちはデイブ
私は、専門家が問題を解決するのを助けようとしていると言いたいのですが、それは専門的なニーズがある場合です。それ以外では、コミュニティにも深く関わっており、Kinetisの一般的な質問などについて他のコミュニティメンバーを支援するために、年間数百時間を費やしています。
あなたの目的がコミュニティのために発展することであるならば、元の投稿者が応答しない場合に備えて、私はIARの問題も助けることができるかもしれません - 私はそれをあなたのためにチェックする前に、迅速な応答があるかどうかを確認するために数日待ちます。
実際のプロジェクト/製品のソリューションの要件に関して、これは、異なるプラットフォーム(コンパイラおよび/またはKinetisターゲット)に移植するよりも実際の作業にとって魅力的な提案である場合に利用可能であるという事実を指摘しました。
これを正確に行うには、次のようにします。
引用: 「IARのEWBを使用して、小さなフットプリントのUSB MSDブートローダをカスタムK24ボードにターゲットにする必要があります。あなたが提供した解決策は大きすぎて、私には£の費用がかかり、CWベースのプロジェクトです。
1.Win 8.1/MAC OSX互換のuTasker K24 USB-MSDローダーは、IAR EWSでビルドした場合のサイズが13.1kです(互換性が無効になっている場合はわずかに小さくなります)。これは、この例よりも 40% 小さく見えるため、数値が正確ではない可能性があると思います。
2.サポートを望まない、または必要ない場合は、リンクでプロジェクトがオープンソースとして利用できます(通常、商用ユーザーはプロジェクトのコストを削減するために何かを貢献することが望まれます。また、公開ソースには最新の開発がすべて含まれているとは限らないため)。
3.直接商用サポートライセンス契約の場合、242.50ドルの費用がかかり、これには3か月の電子メールおよび電話サポートとカスタムボードのセットアップの支援が含まれます。それでも高すぎる場合は、オプション2が利用できるため、優先順位とニーズに応じて、すべての人に適した解決策があるはずです。非営利の作業の場合、フォーラム(このフォーラムまたはuTasker自身のフォーラム)での使用やサポートにも料金はかかりません。
4. USB-MSDローダーには、 IAR EWB、Keil、CW、KDS、Green Hills、Rowley Crossworks、Atollic、Coo Cox、Visual Studioシミュレーションのテスト済みプロジェクトが含まれており、スタンドアロン GCC.It はCWに基づいていませんが、必要に応じてCWで使用できます。IAR EWSのサポートは、すぐに使えるものであることは間違いありません。
したがって、私の結論は、これがあなたに適していないという兆候は見当たらないということですあなたの要件が商業プロジェクト/製品のための最も低コストのソリューションであり、リンク内のIARプロジェクトはまだあなたが例の問題を解決するための参照として役立つかもしれません。その後、主な目標が例のポートを戻すことである場合、例の移植に取り組むことができますコミュニティ。
よろしくお願いします。
Mark
追伸摩擦を避けるために、純粋にKinetisの技術的な性質のものでない限り、あなたの投稿に対してこれ以上の提案をすることはありません。
マークさん、コメントありがとうございます。私が間違っていない限り、私はビジネスのために売り込むためにこれらのフォーラムをトロールするのはあなたの仕事だと取りますか?私はあなたがすでにその申し出をしたので、あなたから解決策を買うことができることを知っています。しかし、私はあなたの解決策を見てきましたが、それは私たちのニーズを満たしていません。
IARのEWBを使用して、小さなフットプリントのUSB MSDブートローダをカスタムK24ボードにターゲットにする必要があります。あなたが提供した解決策は大きすぎて、私に£の費用がかかり、CWベースのプロジェクトです。
さらに、NXPがチケット制のサポートデスクを閉鎖したため、ヘルプを引き出すためのコミュニティフォーラムのみになりました。このコミュニティベースのフォーラムの精神で、私たちは知識を「無料で」共有することを期待しています また、USB MSD Bootloaderは、最初にDerek Snellによって無料で提供され、その後他の人によって変更された包括的なアプリノートが含まれています(Kaiに特別な感謝を捧げます)。 つまり、他のツールチェーン、開発ボード、MCUに無料で移植されているので、このフォーラムを使用してソリューションを販売する正当な理由について疑問に思っていますか?
現在、私の知る限り、Derek Snellsブートローダーの移植版(K24 / IAR)を無料で使用できるものはありません。私にとっての締めくくりの出発点は、Kai Liuの努力でした。このようなポートを提供すれば、私にとって有益であり、コミュニティにとっても有益であると思いましたが、Kaiや他の人が助けてくれるかもしれないと思ったビルドの問題に遭遇しました。
私の学生の課題に関しては;0)。私はこの仕事をしてきた20年間で多くのアプリケーションを移植してきましたが、時には苦労する代わりに尋ねる価値があることもあります。
最後に、何か建設的なことを付け加えるなら、あなたから聞いてうれしいです
ありがとうデイブ
Hi
ポーティング課題の解決方法を学ぶ必要がある学生向けの課題がない限り、TWR-K60N512およびTWR-K60D100M用の完全に動作するUSB-MSDローダIARプロジェクトをダウンロードできます。
http://www.utasker.com/forum/index.php?topic=1721.0
よろしくお願いします。
Mark
Hi
コンパイラエラーを手伝ってもらえますか。IAR EWBですか? ブートローダープロジェクトFRDM-KL25ZをTWR-K60に戻そうとしていますが、K60のプロジェクトを出発点として使用すると、次の警告とエラーが表示されます。
1. Kinetisモデルの定義がありません。デフォルト 'K60_100MHz' に設定されます。
2。不正なターゲットが選択されています (現在サポートされているターゲットは KINETIS_K & KINETIS_L です)
どちらもkinetis_params.hを参照していました
これがどこに設定されているのかわかりません。 プロセッサタイプを設定しました
options->compiler->preprocessor を TWR_K60N512
ご協力いただきありがとうございます
とても素敵な仕事、共有していただきありがとうございます。
私が実際に意味したのは、openSDA回路を使用してターゲットをフラッシュできるようにuTasker Sdaがある場合でしたが、そのためにUSBDMとJlinkのオープンSDAを見つけました。
ありがとう
シュバム
シュバム
*.sda ファイルは、OpenSDA チップ (K20) でブートローダーをプログラミングするための P&E のものです。
アプリケーションをボードにロードする場合は、*.bin または *srec ファイルが必要です。
よろしくお願いします。
Mark
ハローマーク
それに従います。uTasker openSDAアプリについて疑問があります。どこにも見つかりませんでした。uTaskerv1.4.sdaのダウンロード方法を教えてください。
Hi
すべてのコードを移植できますが、K22DX256VLF5とKL25は異なるプロセッサファミリであることに注意してください - Cortex M4があり、KLは低電力のCortex-M0+です - それらは異なるフラッシュプログラミングインターフェイス、クロッキング、割り込み、DMAを持ち、さまざまな周辺機器は異なる処理を必要とします。
また、これはIARのプロジェクトであり、KDS/CWのプロジェクトではありません。
あなたの課題が移植作業を経験することである場合、オリジナルのK60はKL25よりもあなたにとって近いです。
よろしくお願いします。
Mark
MK22DX256VLF5 を使用したカスタムボードでも同じことができますか 。元の AN4379 にはどのような変更を加える必要がありますか?
Hello Derek,
AN4379をMK22DX256VLF5用に移植しようとしていますが、方法を教えてください。
これは古い投稿ですが、最近、AN4368に基づくブートローダーでWindows 8.1の問題に遭遇しました。Windows 8.1は、挿入時にインデックスファイルをリムーバブルドライブに書き込むことがわかりました。ブートローダは、そのファイルのフラッシュを試み始めます。
これを回避するには、グループ ポリシーに移動して有効にします。コンピュータの構成\ 管理用テンプレート\ Windows コンポーネント \ 検索 \ リムーバブル ドライブ上の場所をライブラリに追加できないようにします。再起動します。
disk.cを変更しましたWindows 8.1 で回避策を講じる必要がないように、書き込まれるファイルが S19 ファイルであることを確認するためのファイルMSD_Event_Callback
ボイドMSD_Event_Callback
(
uint_8 controller_ID、
uint_8 event_type、
void* val
)
{
/*体*/
PTR_LBA_APP_STRUCT lba_data_ptr;
uint_32私;
uint_8_ptr prevent_removal_ptr、load_eject_start_ptr;
PTR_DEVICE_LBA_INFO_STRUCT device_lba_info_ptr;
Windows 8.1 用に追加
静的なint flash_file = 0;
静的uint32_t data_sector = 0;
...
ケースUSB_MSC_DEVICE_WRITE_REQUEST:
....
#if (定義MCU_MK60N512VMD100)
file_size = *(uint_32*)( lba_data_ptr->buff_ptr + i + 28);
#else
file_size = BYTESWAP32(*(uint_32*)( lba_data_ptr->buff_ptr + i + 28));
#endif
ファイル名の拡張子がS19であることを確認します
char *ext = lba_data_ptr->buff_ptr + i + 8;
if((ext[0] == 's' || ext[0] == 'S') && (ext[1] == '1') && (ext[2] == '9') )
{
flash_file = 1;
ファイルのデータ セクターを取得する - クラスター 2 から始まるため、2 を減算し、クラスターごとに 32 セクターと開始セクターを減算します
data_sector = (*(uint_16*)( lba_data_ptr->buff_ptr + i + 26) - 2) * 32 + FATDataSec0;
}
new_file = FALSE;
} /* EndIf */
有効な S19 でないファイルを無視する
if(flash_file != 0)
{
if((lba_data_ptr->offset>>9)== data_sector)
{
erase_flash();
ファイルタイプ = 不明;
printf("\n\t画像ファイルを開く");
} /* EndIf */
if((lba_data_ptr->offset>>9)>= data_sector)
{
// SetOutput(BSP_LED3, TRUE);
/* 配列を解析してフラッシュメモリにフラッシュする */
if (FLASH_IMAGE_SUCCESS == エラー)
{
エラー = FlashApplication(lba_data_ptr->buff_ptr,lba_data_ptr->size);
}
// SetOutput(BSP_LED3, FALSE);
} /* EndIf */
/* ファイルの残りの部分 */
if(((lba_data_ptr->offset>>9) - data_sector) == ((file_size -1)/512))
{
boot_complete=TRUE; 転送ファイルが完了しました
if(BootloaderStatus == BootloaderReady)
{
BootloaderStatus = BootloaderSuccess;
}
/* 印刷の点滅状態 */
if(ブートローダーステータス!= ブートローダー成功)
{
printf("\nFlash イメージ ファイルに失敗しました!");
} else
{
printf("\nFlash イメージ ファイルが完了しました!");
printf("\nリセットボタンを押してアプリケーションモードに入ります。");
} /* EndIf */
} /* EndIf */
} // EndIf チェック有効flash_file
あなたが共有してくれてありがとう、それは私のKL26Z128でうまく機能します。
ワンダフル改!!Windows XPとWIN7で問題なく動作します。昨日、WINDOWS8を搭載したPCでテストしましたが、ダウンロード中にエラーが発生します。その結果、古い内部アプリケーションファームウェアが損傷します。この問題を見たことがありますか?
必要に迫られて、Connectivity & IoT チームは、このプロジェクトに基づいて KW24D512 と K64F 用の MSD ブートローダーを構築しました。
次のドキュメントを参照してください。
FRDM-K64F(IAR)用USB MSDデバイスブートローダリビジョン
彼らが他の誰かにも役立つことを願っています。
よろしくお願いします。FSLから別のMSDブートローダーを見つけます。K20 USBデバイスMSDブートローダー。
興味深いことに、コンテンツはFSLの従業員によって中国語でリリースされています。
お疲れ様でした、カイ。これを共有していただきありがとうございます。