LilyGo-LoRa-Series/README_CN.MD

🌟LilyGo LoRa Series🌟

English | 中文

快速开始:

1. 将 lib 目录中所有文件夹复制到~/Arduino/libraries目录内,Windons用户放在 "我的文档/Arduino/libraries"
2. 打开对应的示例
3. T-Beam用户可以选择TTGO T-Beam,lora32(T3)用户可以选择ESP32 Dev Module,T-Motion 用户选择 Nucleo_l073RZ,T3-S3-V1.0和T-BeamS3-Core用户选择ESP32S3 Dev Module
4. 在端口中选择板子的端口
5. 请在每个草图的 utilities.h 文件的上方根据你的板子型号取消注释,否则编译将报错误
6. 上传

⚠ 注意事项 ⚠

1. T3S3 V1.1(V1.2 不存在这个问题) SX1280的输出功率设置不能大于2~5dbm，否则可能导致FEM芯片损坏。设置3dbm就已经有20dmb的输出功率

Product 📷

Product	Product Link	Schematic	Corresponding example macro definition
T-Beam SX1278/76	AliExpress	TBeamV0.7 / TBeamV1.0 / TBeamV1.1 / TBeamV1.2	LILYGO_TBeam_V0_7 / LILYGO_TBeam_V1_X
T-Beam SX1262	AliExpress	TBeamV0.7 / TBeamV1.0 / TBeamV1.1 / TBeamV1.2	LILYGO_TBeam_V0_7 / LILYGO_TBeam_V1_X
LoRa32 V1.0 SX1276	AliExpress	❌	LILYGO_T3_V1_0
LoRa32 V1.0 SX1278	AliExpress	❌	LILYGO_T3_V1_0
LoRa32 V1.3 SX1276	AliExpress	LoRa32 V1.3	LILYGO_T3_V1_3
LoRa32 V2.0	AliExpress	LoRa32 V2.0	LILYGO_T3_V2_0
LoRa32 V2.1 & 1.6	AliExpress/Amazon	LoRa32 V2.1_1.6	LILYGO_T3_V1_6
T-Motion S76G	AliExpress	T-Motion	LILYGO_T_MOTION_S76G
LoRa32 V1.8 2.4G	lilygo.cc	LoRa32 V1.8 2.4G	LILYGO_T3_V1_8
LoRa T3 S3 V1.0	lilygo.cc	LoRa T3 S3 V1.0	LILYGO_T3_S3_V1_0
LoRa T3 S3 V1.1	lilygo.cc	LoRa T3 S3 V1.1	LILYGO_T3_S3_V1_0 (Same as 1.0)
T-Beam S3 Supreme/T-BeamS3 Core	lilygo.cc	T-Beam S3 Supreme & T-Beam S3 Core	LILYGO_TBeamS3_SUPREME_V3_0

示例描述

├─ArduinoLoRa       # Only support SX1276/SX1278 radio module
│  ├─LoRaReceiver
│  └─LoRaSender
├── Display         # Only supports TBeam TFT Shield
│   ├── Free_Font_Demo
│   ├── GxEPD_U8G2_Fonts_Demo
│   ├── TBeam_TFT_Shield
│   ├── TFT_Char_times
│   └── UTFT_demo
├─GPS                           # T-Beam GPS demo examples
│  ├─TinyGPS_Example
│  ├─TinyGPS_FullExample
│  ├─TinyGPS_KitchenSink
│  ├─UBlox_BasicNMEARead        # Only support Ublox GNSS Module 
│  ├─UBlox_Recovery             # Only support Ublox GNSS Module 
│  ├─UBlox_OutputRate           # Only support Ublox GNSS Module 
│  └─UBlox_NMEAParsing          # Only support Ublox GNSS Module 
├─OLED                          # OLED demo examples
│  ├─SH1106FontUsage
│  ├─SH1106GraphicsTest
│  ├─SH1106IconMenu
│  ├─SH1106PrintUTF8
│  ├─SSD1306SimpleDemo
│  └─SSD1306UiDemo
├─RadioLibExamples              # RadioLib examples,Support SX1276/78/62/80
│  ├─SX1262
│  │  ├─SX1262_C6_Receive_interrupt
│  │  ├─SX1262_C6_Transmit_Interrupt
│  │  ├─SX1262_Receive_Interrupt
│  │  └─SX1262_Transmit_Interrupt
│  ├─SX1268
│  │  ├─SX1268_Receive_Interrupt
│  │  └─SX1268_Transmit_Interrupt
│  ├─SX1276
│  │  ├─SX1276_Receive_Interrupt
│  │  └─SX1276_Transmit_Interrupt
│  ├─SX1278
│  │  ├─SX1278_Receive
│  │  ├─SX1278_Receive_Interrupt
│  │  ├─SX1278_Transmit
│  │  └─SX1278_Transmit_Interrupt
│  ├─SX1280
│  │  ├─Ranging
│  │  │  ├─Ranging_Master
│  │  │  └─Ranging_Slave
│  │  ├─SX128x_Receive_Interrupt
│  │  └─SX128x_Transmit_Interrupt
│  └─TBeamAllFunction   # T-Beam all function example,Only tbeamv1.x is supported temporarily
├── Sensor            # Sensor examples , just support t-beams3-supreme
│   ├── BME280_AdvancedsettingsExample
│   ├── BME280_TestExample
│   ├── BME280_UnifiedExample
│   ├── PCF8563_AlarmByUnits
│   ├── PCF8563_SimpleTime
│   ├── PCF8563_TimeLib
│   ├── PCF8563_TimeSynchronization
│   ├── QMC6310_CalibrateExample
│   ├── QMC6310_CompassExample
│   ├── QMC6310_GetDataExample
│   ├── QMC6310_GetPolarExample
│   ├── QMI8658_BlockExample
│   ├── QMI8658_GetDataExample
│   ├── QMI8658_InterruptBlockExample
│   ├── QMI8658_InterruptExample
│   ├── QMI8658_LockingMechanismExample
│   ├── QMI8658_MadgwickAHRS
│   ├── QMI8658_PedometerExample
│   ├── QMI8658_ReadFromFifoExample
│   └── QMI8658_WakeOnMotion
├─SleepTest
└─LoRaWAN                           # OTAA method Join TTN example
    └─OTTA

LoRa 型号分辨

分辨LoRa的型号只需要查看板子上的贴纸, 433MHz则是SX1278， 868MHz则是SX1276， 如果标签写的是SX1262则是SX1262

常见问题

1. GPS没有数据输出，参考GPS恢复出厂

引脚映射

• See utilities.h

应用

• T-Beam SoftRF
• T-Beam Paxcounter
• T-Beam Meshtastic

TTN

接入TTN(The Things Network)使用请参考 LilyGo_LoRa_Series_Quick_Start

数据手册

• AXP192
• AXP2101
• SX1262
• SX1278
• SX1276
• SX1280
• GSP NEO-6/NEO-8
• GSP MAX-M10
• PCF8563
• QMI8658
• QMC6310
• BME280

注意事项

1. LoRa设置输出功率后需要设置最低电流。设置sx1262如下 :

    // digitalWrite(LoRa_Busy, LOW);
    // set output power to 10 dBm (accepted range is -17 - 22 dBm)
    if (radio.setOutputPower(22) == RADIOLIB_ERR_INVALID_OUTPUT_POWER) {
        Serial.println(F("Selected output power is invalid for this module!"));
        while (true);
    }


    // set over current protection limit to 80 mA (accepted range is 45 - 240 mA)
    // NOTE: set value to 0 to disable overcurrent protection
    if (radio.setCurrentLimit(80) == RADIOLIB_ERR_INVALID_CURRENT_LIMIT) {
        Serial.println(F("Selected current limit is invalid for this module!"));
        while (true);
    }

注意:

1. 在使用SX1280 PA模块时，建议软件控制1280芯片输出2~5dbm，这样整个模组会输出20dbm的功率； 当1280芯片输出高于2dbm时，整个模组输出功率也只有20dbm； 当1280芯片输出高于5dbm时，整个模组输出功率也只有20dbm，但5dbm给到FEM，会损坏FEM芯片（FEM允许最大输入是5dbm） 如果1280芯片输出低于2dbm，整个模组输出功率20dbm以内。

FAQ

• GPS备用电源来自于18650电池，如果移除18650电池将无法获得GPS热启动，如果需要使用GPS热启动，请连接18650电池