LoRa 無線。パケットを送受信する Semtech SX1262 ドライバーで、デューティサイクル制限を組み込んでいます。

リポジトリ: github.com/dekiengine/deki-lora · 最新リリース: 0.19.0 · エンジン 0.19.0 以降が必要

DekiEditor --packages-add deki-lora <project> か、パッケージマネージャーからインストールします。エンジン自身のコンポーネントと C++ API は Deki のドキュメントにあります。

エディターでは LoRa (SX1262) と表示されます。

コンポーネント

コンポーネント	カテゴリ	説明
SX1262LoRaComponent	無線	SPI 接続の Semtech SX1262 LoRa 無線を設定します。

コンポーネントリファレンス

SX1262LoRaComponent

SPI 接続の Semtech SX1262 LoRa 無線を設定します。

インスペクターでの名前: SX1262 LoRa · カテゴリ: 無線 · 型: DekiLora::SX1262LoRaComponent

プロパティ	型	デフォルト	制約	説明
spiHost	int32	1	1 から 2	SPI コントローラーです。1 が SPI2、2 が SPI3 です。ディスプレイとピンを共有する場合はディスプレイと同じものを使います。
sckPin	int32	40	-1 から 48
mosiPin	int32	41	-1 から 48
misoPin	int32	38	-1 から 48
csPin	int32	9	0 から 48	無線モジュールのチップセレクト (NSS)
busyPin	int32	13	0 から 48	無線モジュールの BUSY ピン
resetPin	int32	17	0 から 48	無線モジュールの NRESET ピン
dio1Pin	int32	45	-1 から 48	無線モジュールの DIO1 ピンで、割り込み線です (-1: 未配線)。これがあると、毎フレームではなく、無線モジュールに伝えることがあるときだけ SPI で問い合わせます。
spiHz	int32	8000000	100000 から 1.6e+07	SPI のクロックです。SX1262 は 16 MHz まで使えます。
tcxoVoltage	float	1.8	0 から 3.3	DIO3 から無線モジュールの TCXO に与える電圧 (V) です。ボードが普通の水晶振動子を使う場合は 0 です。LilyGO のボード: 1.8
dio2AsRfSwitch	bool	true		多くの SX1262 モジュールと同じく、DIO2 でアンテナの送信と受信を切り替えます
frequencyHz	int32	868100000	1.5e+08 から 9.6e+08	搬送波の周波数 (Hz) です。地域で許可されている周波数にしてください。ヨーロッパでは 868100000、南北アメリカでは 915000000 です。
spreadingFactor	int32	7	7 から 12	7 が最速です。1 段上げるごとに送信時間 (エアタイム) が 2 倍になり、届く距離が伸びます
bandwidthKHz	int32	125	7 から 500	帯域幅 (kHz): 125、250、500 のどれかです (62.5 以下は 62、41、31、20、15、10、7 と書きます)
codingRate	int32	5	5 から 8	符号化率 4/5 から 4/8 を 5 から 8 で指定します。大きいほど誤りに強く、遅くなります
txPowerDbm	int32	14	-9 から 22	送信出力 (dBm) です。ヨーロッパの 868.0-868.6 MHz では 14 までです。
syncWord	int32	18	0 から 255	同期ワードです。同じ同期ワードの無線どうしだけが受信できます。0x12 (18) はプライベート、0x34 (52) は LoRaWAN です。
dutyCyclePercent	float	1	0.1 から 100	無線が送信してよい時間の上限 (パーセント) です。パケットを送った後、これを満たすまで待ちます。ヨーロッパの 868.0-868.6 MHz では 1 です。100 で制限をなくします (法律で許される場合)。

変更履歴

変更履歴は英語です。

0.19.0 Changed

minEngine 0.19.0: built against engine 0.19.0, whose component metadata records the package each class is in. A build of this package from before does not load and is rebuilt.

Added

Japanese, Simplified Chinese and Korean: editor/lang/ja.json, zh.json and ko.json translate the names, tooltips and enum values this package's components show in the Inspector.

0.18.2 Added

The package: a Semtech SX1262 LoRa driver (SX1262LoRaComponent for the boot scene, DekiLoRa::GetCurrent() for game code). Sends and receives packets with RSSI and SNR, listens whenever it is not sending, and enforces a duty cycle (1% by default, Europe's 868 MHz rule). Joins an SPI bus the display already uses, as on the LilyGO T-Deck. ESP-IDF only.
dio1Pin (45, the T-Deck's): with the radio's interrupt line wired, the radio is asked over SPI only when DIO1 is raised, rather than every frame on a bus the display is sending frames on.

それ以前のリリース: CHANGELOG.md

パッケージのリフレクションデータから生成しています (エンジン 0.19.0)。プロパティ名はシーンファイルで使われるキーです。名前を変えても別名が残ります (互換性)。