LilyGo-LoRa-Series/docs/en/t_beam/t_beam_hw.md

🌟LilyGo T-Beam🌟

Overview

• This page introduces the hardware parameters related to LilyGo T-Beam

Notes on use

1. Please be sure to connect the antenna before transmitting, otherwise it is easy to damage the RF module

Product

Product	SOC	Flash	PSRAM
T-Beam Meshtastic	ESP32-D0WDQ6-V3	4MB(Quad-SPI)	8MB(Quad-SPI)
T-Beam SoftRF	ESP32-D0WDQ6-V3	4MB(Quad-SPI)	8MB(Quad-SPI)

PlatformIO Quick Start

1. Install the CH9102 USB bridge driver for the first time.
   • Windows
   • Mac OS
2. Install Visual Studio Code and Python
3. Search for the PlatformIO plugin in the Visual Studio Code extension and install it.
4. After the installation is complete, you need to restart Visual Studio Code
5. After restarting Visual Studio Code, select File in the upper left corner of Visual Studio Code -> Open Folder -> select the LilyGo-LoRa-Series directory
6. Wait for the installation of third-party dependent libraries to complete
7. Click on the platformio.ini file, and in the platformio column
8. Select the board name you want to use in default_envs and uncomment it.
9. Uncomment one of the lines src_dir = xxxx to make sure only one line works , Please note the example comments, indicating what works and what does not.
10. Click the (✔) symbol in the lower left corner to compile
11. Connect the board to the computer USB-C , Micro-USB is used for module firmware upgrade
12. Click (→) to upload firmware
13. Click (plug symbol) to monitor serial output
14. If it cannot be written, or the USB device keeps flashing, please check the FAQ below

Arduino IDE quick start

1. Install the CH9102 USB bridge driver for the first time.

   • Windows
   • Mac OS

2. Install Arduino IDE

3. Install Arduino ESP32

4. Copy all folders in the lib directory to the Sketchbook location directory. How to find the location of your own libraries, please see here

   • Windows: C:\Users\{username}\Documents\Arduino
   • macOS: /Users/{username}/Documents/Arduino
   • Linux: /home/{username}/Arduino

5. Open the corresponding example

   • Open the downloaded LilyGo-LoRa-Series
   • Open examples
   • Select the sample file and open the file ending with ino

6. On Arduino Select the corresponding board in the IDE tool project and click on the corresponding option in the list below to select

   Name	Value
   Board	ESP32 Dev Module
   Port	Your port
   CPU Frequency	240MHZ(WiFi/BT)
   Core Debug Level	None
   Erase All Flash Before Sketch Upload	Disable
   Events Run On	Core1
   Flash Frequency	80MHZ
   Flash Mode	QIO
   Flash Size	4MB(32Mb)
   JTAG Adapter	Disabled
   Arduino Runs On	Core1
   Partition Scheme	Huge APP (3MB No OTA/1MB SPIFFS)
   PSRAM	Enable
   Upload Speed	921600
   Programmer	Esptool

7. Please uncomment the utilities.h file of each sketch according to your board model ,e.g T_BEAM_SX1262,T_BEAM_SX1276,T_BEAM_SX1278, otherwise the compilation will report an error.

8. Upload sketch

📍 Pins Map

Name	GPIO NUM	Free
SDA	21	❌
SCL	22	❌
OLED(SSD1306) SDA	Share with I2C bus	❌
OLED(SSD1306) SCL	Share with I2C bus	❌
GNSS(Ublox M6/M8) TX	12	❌
GNSS(Ublox M6/M8) RX	34	❌
LoRa(SX1276/SX1278) SCK	5	❌
LoRa(SX1276/SX1278) MISO	19	❌
LoRa(SX1276/SX1278) MOSI	27	❌
LoRa(SX1276/SX1278) RESET	23	❌
LoRa(SX1276/SX1278) DIO1	33	❌
LoRa(SX1276/SX1278) DIO2	32	❌
LoRa(SX1276/SX1278) CS	18	❌
Button1	38	❌
PMU (AXP2101) IRQ	35	❌
PMU (AXP2101) SDA	Share with I2C bus	❌
PMU (AXP2101) SCL	Share with I2C bus	❌

🧑🏼‍🔧 I2C Devices Address

Devices	7-Bit Address	Share Bus
OLED Display (SSD1306)	0x3C	✅️
Power Manager (AXP2101)	0x34	❌

⚡ Electrical parameters

Features	Details
🔗USB-C Input Voltage	3.9V-6V
⚡Charge Current	0-1024mA (Programmable)
🔋Battery Voltage	3.7V

⚡ PowerManage Channel

Channel	Peripherals
DC1	ESP32
DC2	Unused
DC3	Unused
DC4	Unused
DC5	Unused
LDO1(VRTC)	Unused
ALDO1	Unused
ALDO2	Radio
ALDO3	GPS
ALDO4	Unused
BLDO1	Unused
BLDO2	Unused
DLDO1	Unused
CPUSLDO	Unused
VBACKUP	GNSS Backup

Button Description

Channel	Peripherals
PWR	PMU button, customizable function
IO38	Customizable function
RST	Reset button

• The PWR button is connected to the PMU
  1. In shutdown mode, press the PWR button to turn on the power supply
  2. In power-on mode, press the PWR button for 6 seconds (default time) to turn off the power supply

LED Description

• CHG LED

  1. If not controlled by the program, the default is always on when charging and off when fully charged
  2. This LED can be controlled by the program

• PPS LED,

  1. The red LED near the GPS module cannot be turned off
  2. This LED cannot be turned off and is connected to the GPS PPS Pin. This LED flashes to indicate that the PPS pulse has arrived.

RF parameters

Features	Details
RF Module	SX1278/SX1276
Frequency range	868/915MHz
Transfer rate(LoRa)	0.018 K ～ 62.5 Kbps
Transfer rate(FSK)	0.6 K ～ 300 Kbps
Modulation	FSK, GFSK, MSK, GMSK, LoRa,OOK

WiFi-IPEX

• The following figure shows how to switch the onboard WIFI antenna to IPEX

Resource

• Schematic
• AXP2101 datasheet

• SX1262 datasheet
• SX1278 datasheet
• SX1276 datasheet
• SX1262 datasheet
• GSP NEO-6/NEO-8 datasheet

Application

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