RAK19012 WisBlock USB LiPo Solar Power Slot Module Quick Start Guide
Prerequisite
What Do You Need?
Before going through each and every step on using the RAK19012 WisBlock USB LiPo Solar Power Slot Module, make sure to prepare the necessary items listed below:
Hardware
- RAK19012 WisBlock USB LiPo Solar Power Slot Module
- Your choice of WisBlock Base board with Power Slot
- Your choice of WisBlock Core
- Li-Ion/LiPo battery (optional)
- Solar charger (optional)
Software
Arduino
- Download and install the Arduino IDE.
- To add the RAKwireless Core boards to your Arduino Boards Manager, install the RAKwireless Arduino BSP.
Product Configuration
Hardware Setup
RAK19012 should be attached to the power slot connector of WisBlock Base board with power slot. It is a power board that provides the same features and interfaces that standard WisBlock Base boards provide - USB C connector, battery and solar panel connector, LED indicators, and reset button.
RAK19012 only supports WisBlock Base boards with Power Slot. It is not compatible with all WisBlock Base boards.
For more information about RAK19012, refer to the Datasheet.
RAK19012 Connection to WisBlock Base board with Power Slot
The voltage of the battery must not exceed 4.3 V.
Assembling and Disassembling of WisBlock Modules
Assembling Procedure
RAK19012 module can be mounted on the power slot of the WisBlock Base board, as shown in Figure 2. Also, always secure the connection of the WisBlock module by using compatible screws.
Disassembling Procedure
The procedure in disassembling any type of WisBlock module is the same.
- First, remove the screws.
- Once the screws are removed, check the silkscreen of the module to find the correct location where force can be applied.
- Apply force to the module at the position of the connector, as shown in Figure 5, to detach the module from the baseboard.
If you will connect other modules to the remaining WisBlock Base slots, check on the WisBlock Pin Mapper tool for possible conflicts.
Battery and Solar Panel Connector
Rechargeable Battery
RAK19012 can be powered by a rechargeable Li-Ion/LiPo battery via the dedicated connectors, as shown in Figure 6. The matching connector for the rechargeable battery wires is a JST PHR-2 2 mm pitch female. A cable assembly for the rechargeable battery connector is also available for purchase in RAK store.
- Battery can cause harm if not handled properly.
- Only 3.7-4.2 V Rechargeable LiPo batteries are supported. It is highly recommended not to use other types of batteries with the system unless you know what you are doing.
- Make sure the battery wires, both rechargeable and non-rechargeable, match the polarity on the RAK19012 board. Not all batteries have the same wiring.
Solar Panel Connection
The battery can be recharged, as well, via a small Solar Panel, as shown in Figure 6. The matching connector for the solar panel wires is an JST ZHR-2 1.5 mm pitch female. A cable assembly for the solar panel connector is also available for purchase in RAK store.
- Only 5 V solar panels are supported. Do not use 12 V solar panels. It will destroy the charging unit and eventually other electronic parts.
- The GND pin of the solar panel connector is located on edge of the board. Make sure the solar panel wires match the polarity on the RAK19012 board.
Software Setup
There is no software required to use RAK19012. But to control the two user LEDs and monitor the battery voltage, they must be attached to a WisBlock Base and WisBlock Core.
WisBlock Examples Repository
To quickly build your IoT device with less hassle, example codes for WisBlock Core are provided. You can access the codes on the WisBlock Example code repository. The example codes on folder common
are compatible with RAK4631, RAK11200, and RAK11310 WisBlock Cores.
The two user LEDs of RAK19012 can be accessed using macrodefinitions LED_GREEN
/ PIN_LED1
for the green LED and LED_BLUE
/ PIN_LED2
for the blue LED. For the battery voltage reading, WB_A0
is used.