Micrchip RN2483 LORAモジュール用のプラットフォーム非依存の埋め込みCライブラリ。
注:このレポは現在維持されておらず、ロラワン仕様のv1.0に対して書かれています。今のところ減価償却されていると考えてください。レムはあなたがしたいかどうかを知っています
これは、Microchip RN2483 LORAモジュールと相互作用するための組み込みCライブラリです。シンプルでモジュール式であることを目指しています(さまざまなプラットフォームへの移植を簡単にするのに十分です)。
このライブラリの主な機能の1つは、携帯性です。 I/Oを備えた埋め込みライブラリは、真にポータブルではないため、リポジトリの個別のブランチで特定のプラットフォームがサポートされています。このレポのマスターブランチは、コアプラットフォームに依存しないコードです。個々のブランチ( platform/mbitなど)は、プラットフォームで使用するためにこれを展開しようとしている場合に実際に使用したいものです。
このライブラリによって再Quuriedされた唯一のハードウェア固有の機能は、RN2483モジュールにR/Wを超える機能です。その結果、これはラッパー関数によって処理されます: readとwrite 。マスターブランチでは、これらは単に#Errorで満たされており、コンパイルで実装するように指示します。
特定のプラットフォームのサポートの追加の詳細については、6。Additplatformsを参照してください。
特定のプラットフォームサポートの例については、5つのサポートされているプラットフォームを参照してください。
doxygenドキュメントがあり、メインディレクトリでdoxygen doxycfgを実行するだけで、ドキュメント/フォルダーが生成されます。すべてのコメントはDoxygen互換性があり、できるだけ徹底的にしようとしましたが、使いやすさのために簡単な概要を説明します。
ライブラリは標準C(C99)で記述されており、RN2483モジュールの完全な機能を提供します。
有効なコマンドをモジュールに書き込むことができるcommand関数があります(有効なコマンドについては、コマンドリファレンスを参照)
rn2483.cfgファイル( makefileによってconfig.hに書き込まれる)で定義された設定を使用して、toa lorawanネットワークを正常に接続するために必要なすべてのロラワン固有の設定を初期化するinitMACコマンドがあります。
これとは別に、他の注目すべき関数は、ロラワンの握手を処理する[接続されたネットワークを介してデータを送信) join (ネットワークに参加)とtx (データを送信)です。
注:私は将来このライブラリを拡大し、それを整理しようとしています。
RN2483.CFGファイルを確認して、Lorawanの設定を構成し、MakeFileを実行してください
セットアップはプラットフォームに依存するため、特定のプラットフォームブランチのreadmeを参照してください。心配するピンをセットアップするためのinit機能や何もありません - それはすべてreadおよびwrite関数で行われています(ユーザーのために実装されています)。
マスターブランチでは、最初はprintfとgetc関数を持っていました(ユーザーにSTDINおよびSTDOUTストリームを再表示したり、マクロで機能を再定義させたりすることを目的としています)が、 BBC Micro:BITのCmakeビルドプロセスを経験した後、各プラットフォームでラッパーの作業を使用するだけで修正されることを決定しました。
セットアップとは別に、一般的な使用法は次のとおりです。
RN2483_Command()関数を介してRN2483の他の機能にアクセスできることを忘れないでください
Branch: Platform/Mbitのreadme.mdを参照してください。
できるだけプラットフォームを追加するために必要な変更をモジュール化しようとしました。これは主にRN2483.Cの読み取り/書き込みラッパー関数を通じて行われますが、BBC Micro:Bit Branchを見ると、場合によってはこれ以上変更する必要があることがわかります(詳細については、そのブランチのreadmeを参照してください)。
rn2483.cで変更する必要がある関数:
明らかに、それは決してこれほど単純ではないので、さらなる変更が必要ないくつかの障害に遭遇するかもしれません。たとえば、プラットフォーム/MBITブランチでは、マイクロビットのシリアルオブジェクトにポインターを渡す必要がありました。