View source for Lora RA-08H Development Board

== Description==
Lora RA-08H Development Board is a development board based on the combination of Raspberry Pi RP2040 main control chip and RA-08H, onboard TFT 1.8-inch SPI display, passive buzzer, RS485 communication module, customizable buttons, programmable indicator lights, multiple Crowtail and general IO interfaces, rich external interface resources, can be used with Crowtail series modules or modules with other interfaces. The onboard Lorawan module is connected to the Lorawan platform to realize remote module control, which can be applied to maker education, smart home, industrial control, etc.<BR>

'''Model: [https://www.elecrow.com/lorawan-ra-08h-development-board-integrated-rp2040-with-1-8-lcd-for-long-range-communication-868mhz-915mhz.html CRT01259B]'''<BR>
[[File:Lora ra 08h module 3-wiki-main.jpg|500px]]

:::[[Image:Get_one_now.png|300px|link=https://www.elecrow.com/lorawan-ra-08h-development-board-integrated-rp2040-with-1-8-lcd-for-long-range-communication-868mhz-915mhz.html?wiki|alt=Alt text|Title text]]

== Feature  ==

*Integrate RP2040 and RA-08H (Lorawan module)<BR>
*Main control Raspberry Pi chip RP2040, built-in 264KB SRAM, onboard 4MB Flash<BR>
*Dual Core Arm Cortex-M0+ @ 133MHz<BR>
*RA-08H module adopts embedded memory, 128KB Flash, 16KB SRAM<BR>
*RA-08H module supports frequency band: 803MHZ-930MHZ<BR>
*RA-08H module supports external antenna, SMA interface or IPEX first generation interface<BR>
*Compatible with Arduino/Micropython<BR>
*Onboard 1.8-inch SPI-TFT-LCD, resolution: 128*160 driver chip: ST7735S (4-wire SPI)<BR>
*1 passive buzzer<BR>
*4 user-defined buttons<BR>
*6 programmable LEDs<BR>
*1 RS485 communication interface<BR>
*8 5V Crowtail interfaces (2 analog interfaces, 2 digital interfaces, 2 UART interfaces, 2 IIC interfaces)<BR>
*12 5V universal pin header IO interfaces<BR>
*14 3.3V universal pin header IO interfaces<BR>
*1 3.3V/5V switchable SPI interface<BR>
*1 3.3V/5V switchable UART interface<BR>
*3 3.3V/5V switchable IIC interfaces<BR>

==Technical Specification==
*Working input voltage: USB 5V-1A<BR>
*Operating temperature range: -10°C ~ 65°C<BR>
*Dimensions: 102mm(L)x76.5mm(W)<BR>


==Interface Function==
[[File:Lora RA-08H 0 2.png]]
*Onboard Ports and Functions<BR>
{| cellspacing="0" cellpadding="5" border="1"
|-
| align="center" width="150" | '''Name''' 
| align="center" width="600" | '''Interface/Function Definition''' 

|- style="font-size: 90%"
| align="center" | DATA
| align="left" | RA-08H data sending and receiving indicator light, when RA-08H communicates with the outside world (need to be set by the user).
|- style="font-size: 90%"
| align="center" | PWR
| align="left" | Power Indicator
|- style="font-size: 90%"
| align="center" | RST
| align="left" | Reset button, press this button to reset the system.
|- style="font-size: 90%"
| align="center" | (RP2040)BOOT
| align="left" | Download button, hold down the Boot button and press the RESET button to enter boot firmware download mode. Users can download firmware through the USB interface.
|- style="font-size: 90%"
| align="center" | USB-C
| align="left" | USB-C interface, it is used for the power supply of the development board and the communication interface between PC and RP2040.
|- style="font-size: 90%"
| align="center" | RS485
| align="left" | RS485 interface, used to communicate with external RS485 module.
|- style="font-size: 90%"
| align="center" | 485RX<-RX->RX1
| align="left" | 3P pin header interface RS485 chip and RP2040 communication pin switching interface, when using the RS485 module, it is necessary to short the RX and 485RX with a jumper cap, when not using the RS485 module, the default is to short the RX and RX1.
|- style="font-size: 90%"
| align="center" | 485TX<-TX->TX1
| align="left" | 3P pin header interface RS485 chip and RP2040 communication pin switching interface, when using the RS485 module, it needs to short-circuit its TX and 485TX with a jumper cap, and when using the RS485 module, the default is to short-circuit the TX and TX1.
|- style="font-size: 90%"
| align="center" | 3V3<-VCC->5V
| align="left" | 3P pin header interface, used for switching the working voltage of these three interfaces: 6P-SPI interface, 3*4P-IIC interface and 4P-UART interface.
|- style="font-size: 90%"
| align="center" | SPI
| align="left" | 6P-SPI pin header interface, which can be used for external SPI interface communication modules and devices, and the power supply voltage is 3.3V/5V switchable.
|- style="font-size: 90%"
| align="center" | I2C
| align="left" | 3*4P-IIC pin header interface, can be used for external I2C interface communication modules and devices, power supply voltage 3.3V/5V switchable.
|- style="font-size: 90%"
| align="center" | UART
| align="left" | 4P-UART pin header interface, can be used for external UART serial communication modules and devices, power supply voltage 3.3V/5V switchable.
|- style="font-size: 90%"
| align="center" | GND-5V-SIG
| align="left" | 3*12PIN, 5V general-purpose IO header interface, which can be used for external 5V sensor modules or devices.
|- style="font-size: 90%"
| align="center" | GND-3V3-SIG
| align="left" | 3*14PIN, 3.3V general-purpose IO header interface, which can be used for external 3.3V sensor modules or devices.
|- style="font-size: 90%"
| align="center" | Crowtail-A0
| align="left" | External Crowtail-5V-HY-4P-2.0 port. Sensors or modules that can be used to interface with 5V Crowtail analog signals.
|- style="font-size: 90%"
| align="center" | Crowtail-A1
| align="left" | External Crowtail-5V-HY-4P-2.0 port. Sensors or modules that can be used to interface with 5V Crowtail analog signals.
|- style="font-size: 90%"
| align="center" | Crowtail-D0
| align="left" | External Crowtail-5V-HY-4P-2.0 port. Sensors or modules that can be used to interface with 5V Crowtail digital signals.
|- style="font-size: 90%"
| align="center" | Crowtail-D1
| align="left" | External Crowtail-5V-HY-4P-2.0 port. Sensors or modules that can be used to interface with 5V Crowtail digital signals.
|- style="font-size: 90%"
| align="center" | Crowtail-UART
| align="left" | External Crowtail-5V-HY-4P-2.0 port. Sensors or modules that can be used to connect to 5V Crowtail UART serial communication.
|- style="font-size: 90%"
| align="center" | Crowtail-I2C
| align="left" | External Crowtail-5V-HY-4P-2.0 port. Sensors or modules that can be used to connect to 5V Crowtail I2C interface communication.
|- style="font-size: 90%"
| align="center" | (RA-08H)BOOT
| align="left" | Long press the download button before power-on.  Connect the external USB-to-serial port module.  Connect the cables to the external USB-to-serial port module according to (GND~GND, RA-3V~3.3V, RA-RX~TX, RA-TX~RX) and update the firmware of the RA-08H module through the TremoProgrammer_v0.8 software.
|- style="font-size: 90%"
| align="center" | LCD
| align="left" | 1.8 inch SPI display
|}


*GPIO Pin Corresponding Port<BR>
{| cellspacing="0" cellpadding="5" border="1"
|-
| align="center" width="150" | '''RP2040''' 
| align="center" width="600" | '''Lora RA-08H Development Board''' 

|- style="font-size: 90%"
| align="center" | GPIO0
| align="center" | Crowtail-UART0-TX0
|- style="font-size: 90%"
| align="center" | GPIO1
| align="center" | Crowtail-UART0-RX0
|- style="font-size: 90%"
| align="center" | GPIO2
| align="center" | GPIO2
|- style="font-size: 90%"
| align="center" | GPIO3
| align="center" | GPIO3
|- style="font-size: 90%"
| align="center" | GPIO4
| align="center" | RA-08H-LPRXD
|- style="font-size: 90%"
| align="center" | GPIO5
| align="center" | RA-08H-TXD
|- style="font-size: 90%"
| align="center" | GPIO6
| align="center" | GPIO6
|- style="font-size: 90%"
| align="center" | GPIO7
| align="center" | GPIO7
|- style="font-size: 90%"
| align="center" | GPIO8
| align="center" | GPIO8/UART1-TX1/Crowtail-UART1-TX1/485TX
|- style="font-size: 90%"
| align="center" | GPIO9
| align="center" | GPIO9/UART1-RX1Crowtail-UART1-RX1/485RX
|- style="font-size: 90%"
| align="center" | GPIO10
| align="center" | GPIO10/SPI1-SCK
|- style="font-size: 90%"
| align="center" | GPIO11
| align="center" | GPIO11/SPI1-MOSI
|- style="font-size: 90%"
| align="center" | GPIO12
| align="center" | GPIO12/SPI1-MISO
|- style="font-size: 90%"
| align="center" | GPIO13
| align="center" | GPIO13/SPI1-CS
|- style="font-size: 90%"
| align="center" | GPIO14
| align="center" | GPIO14/ Crowtail-D0
|- style="font-size: 90%"
| align="center" | GPIO15
| align="center" | GPIO15/ Crowtail-D1
|- style="font-size: 90%"
| align="center" | GPIO16
| align="center" | LCD-DC
|- style="font-size: 90%"
| align="center" | GPIO17
| align="center" | LCD-CS
|- style="font-size: 90%"
| align="center" | GPIO18
| align="center" | LCD-SCK
|- style="font-size: 90%"
| align="center" | GPIO19
| align="center" | LCD-DIN
|- style="font-size: 90%"
| align="center" | GPIO20
| align="center" | I2C0-SDA0/Crowtail-I2C-SDA/PCA9555-SDA
|- style="font-size: 90%"
| align="center" | GPIO21
| align="center" | I2C0-SCL0/Crowtail-I2C-SCL/ PCA9555-SCL
|- style="font-size: 90%"
| align="center" | GPIO22
| align="center" | LCD-RST
|- style="font-size: 90%"
| align="center" | GPIO23
| align="center" | LCD-BLK
|- style="font-size: 90%"
| align="center" | GPIO24
| align="center" | 485-EN
|- style="font-size: 90%"
| align="center" | GPIO25
| align="center" | DATA
|- style="font-size: 90%"
| align="center" | GPIO26
| align="center" | A0/ Crowtail-A0
|- style="font-size: 90%"
| align="center" | GPIO27
| align="center" | A1/ Crowtail-A1
|- style="font-size: 90%"
| align="center" | GPIO28
| align="center" | BUZZER
|- style="font-size: 90%"
| align="center" | GPIO29
| align="center" | ADC-KEY
|}

==Usage==
===1. Development Environment Construction===
1.1 Directly visit the Arduino official website and download the Arduino development tools supported by the device. The link is as follows: <i>'''https://www.arduino.cc/en/software'''</i>.<BR>
[[File:Lora RA-08H_1_1.png]]

1.2 Click the downloaded Arduino development tool to install the software. After the software installation is complete, open it directly, as shown in the figure below:<BR>
[[File:Lora RA-08H_2_1_2_1.png|490px]]

1.3 Click <i>"File" -> "Preferences"</i> on the menu bar to pop up the preference setting interface.<BR>
[[File:Lora RA-08H_2_1_3_1.png|490px]]

1.4 Click the icon on the far right of the Additional Boards Manager URLs column, enter <i>'''https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json'''</i> in the pop-up window, and add RP2040 Arduino IDE development board URLs.<BR>
[[File:Lora RA-08H_1_4.png]]

1.5 Click <i>"Tools" -> "Board:..." -> "Boards Manager..."</i> in the menu bar to enter the Boards Manager interface.<BR>
[[File:Lora RA-08H_2_1_5_1.png|490px]]

1.6 Enter "RP2040" in the search box, select "Raspberry Pi Pico/RP2040" and install the development environment.<BR>
It should be noted here that when selecting the development environment version, do not choose the latest one. It is recommended to choose version 2.6.0.<BR>
[[File:Lora RA-08H_1_6.png]]

1.7 After the environment is successfully installed, if you find "Rasperry Pi RP2040 Boards" in the Arduino IDE development board management, it means that the environment is successfully built.<BR>
[[File:Lora RA-08H_1_7.png]]

===2. Software Settings===
2.1 For the first use, you need to set up and select the correct development board. Click <i>"Tools" -> "Board:..." -> "Rasperry Pi RP2040 Boards" -> "Rasperry Pi Pico"</i> in the menu bar, as shown in the figure below:<BR>
[[File:Lora RA-08H_2_1.png]]

2.2 Connect the Lora RA-08H Development Board to the computer via a TYPE-C USB cable. When the development board is connected to the computer for the first time, a "RPI-RP2" USB virtual U disk will appear.<BR>
[[File:Lora RA-08H_2_2.png]]

2.3 Here you need to burn a sample code in the opened Arduino IDE to convert the "RPI-RP2" USB virtual U disk into a "COM port". The sample code path is shown in the figure below:<BR>
[[File:Lora RA-08H_2_3_1.png]]

The code after opening is as follows:<BR>
[[File:Lora RA-08H_2_2_3_1.png|490px]]

2.4 Click the download icon at the bottom of the menu bar to burn the code to the Lora RA-08H Development Board. After the code is burned successfully, COMXX (Raspberry Pi Pico) will be displayed in <i>"Tools" -> "Port"</i>. Now you can program Lora RA-08H Development Board with Arduino IDE!<BR>

===3. Sample Program===
'''Example 1 - Driving the Onboard Passive Buzzer Let the buzzer go off!'''<BR>
3.1.1 The position of the onboard buzzer on the development board.<BR>
[[File:Lora RA-08H_3_1_1.png]]

3.1.2 Open the <i>"Buzzer.ino"</i> sample program in the Arduino IDE, and then click the upload program icon to upload the program to the development board.<BR>
[[File:Lora RA-08H_3_1_2_4.png|500px]]

3.1.3 After the program is uploaded successfully, the buzzer will sound automatically!<BR>

'''Example 2 - Let the onboard 1.8-inch LCD display red, green and blue respectively'''<BR>
3.2.1 Copy the <i>"Adafruit-GFX-Library"</i> library file and <i>"Adafruit-ST7735-Library-master"</i> library file to the libraries folder of the Arduino IDE.<BR>
<i><small>( Original path:  '''"...\Lora_RA-08H_Development_Board\Library\..."'''; Copy path:  '''"...\Arduino\libraries\..." )'''</small></i><BR>
[[File:Lora RA-08H_3_2_1.png]]

3.2.2 Open the <i>"LCD.ino"</i> sample program in the Arduino IDE, and then click the upload program icon to upload the program to the development board.<BR>
[[File:Lora RA-08H_3_2_2_3.png|500px]]

3.2.3 After the upload is successful, the LCD screen will display blue, green and red backlight in turn.<BR>
[[File:Lora RA-08H_3_2_3.png|500px]]

'''Example 3 - Light up 6 programmable LEDs on board through I2C control'''<BR>
3.3.1 Copy the <i>"PCA9557"</i> library file to the libraries folder of the Arduino IDE.<BR>
[[File:Lora RA-08H_3_3_1.png]]

3.3.2 Open the <i>"PCA9557_test.ino"</i> sample program in the Arduino IDE, and then click the upload program icon to upload the program to the development board.<BR>
[[File:Lora RA-08H_3_3_2_2.png|500px]]

3.3.3 The effect after the program is uploaded successfully.<BR>
[[File:Lora RA-08H_3_3_3.png]]

'''Example 4 - Read the 4 ADC-KEYs on the board through the ADC, and print the corresponding key value in the COM port'''<BR>
3.4.1 Open the <i>"AD_Key.ino"</i> sample program in the Arduino IDE, and then click the upload program icon to upload the program to the development board.<BR>
[[File:Lora RA-08H_3_4_1_1.png|500px]]

3.4.2 After the program is uploaded successfully, open the Serial Monitor. After pressing the keys one by one, observe whether the serial port prints the corresponding key value.<BR>
[[File:Lora RA-08H_3_4_2.png]]<br>
[[File:Lora RA-08H_3_4_3.png]]

'''Example 5 - Light up 6 programmable LEDs on board through I2C control'''<BR>
3.5.1 As shown in the figure below, connect the Crowtail OLED module and the Crowtail Potentiometer module to the Crowtail I2C interface of the Lora RA-08H Development Board.<BR>
[[File:Lora RA-08H_3_5_1.png]]

3.5.2 Find the Pins arduino.h file under the <i>"... \Users \Administrator \AppData \Local \Arduino15\packages\rp2040\hardware\rp2040\2.0.0\variants\rpipico\..."</i> path.<BR>
Opening the file, and modify the default definition <i>"define PIN_WIRE0_SDA (4u)"</i> and <i>"define PIN_WIRE0_SDA (5u)"</i> to <i>"define PIN_WIRE0_SDA (20u)"</i> and <i>"define PIN_WIRE0_SDA (21)"</i>.<BR>
[[File:Lora RA-08H_3_5_2.png]]

3.5.3 Install u8g2 library in Arduino IDE. Click <i>"Sketch" -> "Include Library" -> "Manage Libraries"</i>, then enter "u8g2" in the pop-up interface, find "u8g2" and click "Install" to complete the installation of the u8g2 library.<BR>
[[File:Lora RA-08H_3_5_3.png|500px]]

3.5.4 Open the <i>"Crowtail_OLED.ino"</i> sample program in the Arduino IDE, and then click the upload program icon to upload the program to the development board.<BR>
[[File:Lora RA-08H_3_5_4_2.png|500px]]

3.5.5 After power on, the value on the sliding potentiometer will be displayed on the OLED screen.<BR>
[[File:Lora RA-08H_3_5_5.png]]

'''Example 6 - Communication between RP2040 and RA-08H'''<BR>
3.6.1 Open the <i>"RA_08H.ino"</i> sample program in the Arduino IDE, and then click the upload program icon to upload the program to the development board.<BR>
[[File:Lora RA-08H_3_6_1_1.png|500px]]

3.6.2 After the program is successfully uploaded, open the serial monitor and send the AT command "AT+CGSN?" to RA_08H.<BR>
[[File:Lora RA-08H_3_6_2.png|500px]]

3.6.3 After sending the command, if the monitor can display the returned "+CGSN=85521C0A02243201 OK" (the value returned by different RA-08H firmware is different), it proves that you can send AT commands through the Arduino IDE to control and set the RA_08H module.<BR>
[[File:Lora RA-08H_3_6_3.png|500px]]

== Resource==

*[http://www.elecrow.com/wiki/index.php?title=File:Lora_RA-08H_Development_Board_Sample_Code.zip Lora_RA-08H_Development_Board_Sample_Code]
*[http://www.elecrow.com/wiki/index.php?title=File:Lora_RA-08H_development_board_Eagle.zip  Lora RA-08H Development Board_Eagle]