DEKI/ENGINE 문서
deki-lora 0.19.0
Deki 패키지 레퍼런스
deki-lora

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이 가장 빠릅니다. 한 단계 올릴 때마다 전송 시간(에어타임)이 두 배가 되고 도달 거리가 늘어납니다
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). 속성 이름은 씬 파일에서 쓰는 키입니다. 이름을 바꿔도 별칭이 유지됩니다(호환성).