RAK19003 WisBlock Mini Base Board User Guide
- June 12, 2024
- RAK
Table of Contents
- RAK19003 Quick Start Guide
- Prerequisite
- Product Configuration
- Hardware Setup
- Detaching a WisConnector
- Assembling a WisBlock Module
- Disassembling a WisBlock Module
- Battery Connection
- Solar Panel Connection
- Software Setup
- WisBlock Examples Repository
- References
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
RAK19003 WisBlock Mini Base Board
RAK19003 Quick Start Guide
This guide introduces the RAK19003 WisBlock Base Board and how to use it.
Prerequisite
What Do You Need?
Before going through each and every step on using the RAK19003 WisBlock Mini
Base Board, make sure to prepare the necessary items listed below:
Hardware
-
Your choice of WisBlock Core
-
Your choice of WisBlock Modules .
It is highly recommended to also check the dedicated Quick Start Guide that you can follow on various
WisBlock Modules. Each Quick Start Guide of these modules contains the detailed steps on how to open the
example codes and upload them to the WisBlock Core. -
Type-C USB cable for programming and debugging
Software
Based on the choice of the WisBlock Core, select a Development Environment:
Programming via Arduino IDE
- RAKwireless BSP support for Arduino
In Arduino IDE, once you installed the BSP, the examples for WisBlock Core will be automatically included on the list of examples.
Programming via PlatformIO IDE:
Product Configuration
Overview
To give you a better understanding of how the WisBlock Base works, the block
diagram and power supply diagram of RAK19003 are provided in this section.
Block Diagram
The block diagram is shown in Figure 1 that shows the internal architecture
and external interfaces of the RAK19003 board.
The MCU in the WisBlock Core module offers the I2C, UART, and SPI data buses
to the sensor modules. Through these buses, the MCU can control and retrieve
data from the sensors.
Some types of MCU have fewer IO pins. In such cases, not all the pins of the
data bus are connected. For example, only I2C and UART are connected.
Some MCU IO pins have an alternate function. In this case, you have the option
to modify the IO via software or rework the hardware to redefine the function
of IO. Refer to the datasheet of WisBlock Core to get all the details.
Power Supply Diagram of RAK19003
The RAK19003 is designed to be powered by a battery and provides the charger
circuitry for lithium batteries.
The charger circuitry can be connected to a wall outlet charger through the
Type-C USB connector, or the specific connector for a solar panel.
A high-efficiency step-down converter with a low quiescent current is used for
generating 3.3 V. This 3.3 V power supply drives the consumption of the
WisBlock Core module and the sensor modules. The max current supported by the
3.3 V LDO is 750 mA.
3V3_S is another 3.3 V power supply, it can be controlled by the MCU in order
to disconnect the power sensors during idle periods to save power. 3V3_S is
controlled by an IO2 pin on the WisBlock Core board.
- Set IO2=1, 3V3_S is on.
- Set IO2=0, 3V3_S is off.
Hardware Setup
RAK19003 WisBlock Base Board Installation Guide
RAK19003 WisBlock Base Board is the main board that allows you to attach MCU,
sensors, and IO modules through the standardized expansion connectors. These
connectors provide a data bus interconnection between the modules attached to
the RAK19003 Base Board.
This guide shows the details related to the installation of modules into the
RAK19003 board. The following section discusses the general concepts to
manipulate the WisConnector in any WisBlock Module. The installation and
removal details of each type of WisBlock module: Core and Sensor are
explained.
Attaching a WisConnector
The WisConnector is the interface between the RAK19003 module and the WisBlock
Core, Sensor, and IO modules. Before connecting these modules, read the
following instructions:
NOTE:
This guide uses two arrows. Refer to Figure 3 for its representation.
-
Align the connectors. Keep the header parallel and place it lightly in the corresponding lap joint of the socket.
-
Fit the connector. Tilt one end of the connector (header) less than 20 degrees, while do not apply force during this process, gently place the other end in parallel.
-
After the above alignment steps, the header and socket are matched but still not buckled.
-
Apply forces evenly by pressing in parallel, then there will be a sound confirming the completion of the buckling.
-
In the process of buckling and applying force, avoid the application of uneven force on both sides.
-
When the buckling process is completed, check that the header and socket are kept in parallel.
-
If after buckling, the header and socket are not in a parallel state (not fully assembled in one place), then press the even force on both sides of the long side to complete the correct buckling.
-
When the aforementioned steps are not completed yet, do not apply force to buckle. Otherwise, there will be a risk to damage the connector. When the connector cannot be smoothly buckled down, repeat the alignment step.
Detaching a WisConnector
-
To disconnect the header from the socket, pull out in parallel with even forces
-
Avoid pulling out the header asymmetrically in the long-side direction.
-
The short-side of the connector can be pulled out asymmetrically, but apply the force vertically and avoid rotating the header.
-
Avoid applying forces in a single corner.
Assembling a WisBlock Module
WisBlock Core
A WisBlock Core module is designed to be installed on the CPU slot of the
RAK19003 Base Board. As shown in Figure 15, the location is properly marked by
silkscreen. Follow carefully the procedure defined in attaching a WisConnector
section in order to attach a Core module.
Once attached, fix the module with one or more pieces of M1.2 x 3 mm screws
depending on the WisBlock Core.
WisBlock Sensor
A WisBlock Sensor module is designed to be installed on the Sensor slot of the
RAK19003 Base Board. There are two (2) available sensor slots in the RAK19003
Base Board. As shown in Figure 16, the location of the slots is properly
marked by silkscreen. Follow carefully the procedure of the section, attaching
a WisConnector, to attach a WisBlock Sensor module. Once attached, fix the
module with an M1.2 x 3 mm screw.
Disassembling a WisBlock Module
-
The procedure to disassemble any type of WisBlock modules is the same. As shown in Figure 17, first, remove the screws.
-
Once the screws are removed, on the PCB of a WisBlock module, there is a silkscreen that shows the correct location where force can be applied. By applying even force under the marked area, the module can be detached from the Base Board. See Figure 18 and Figure 19.
Figure 19: Applying even forces on the proper location of a WisBlock module to detach the module from the Base Board
Battery Connection
RAK19003 can be powered via the USB cable or Li-Ion/LiPo battery via the
dedicated connectors, as shown in Figure 20. The matching connector for the
battery wires is a JST PHR-2 2 mm pitch female .
The battery can be recharged as well via a small Solar Panel, as shown in Figure 21. The matching connector for the solar panel wires is an JST ZHR-2 1.5 mm pitch female . The GND pin of Battery Connector is located on edge of the board.
WARNING
- 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.
- If a non-rechargeable battery is used, it has to be unplugged first before connecting the USB cable to the USB port of the board to configure the device. Not doing so might damage the battery or cause fire.
- Make sure the battery wires match the polarity on the RAK19003 board. Not all batteries have the same wiring.
Solar Panel Connection
WARNING
- 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 are matching the polarity on the RAK19003 board.
The full specification of Solar Panel Connection can be found on the datasheet of the WisBlock Base.
Software Setup
The WisBlock Core is designed to be interfaced with other WisBlock Modules like sensors, displays, and other interfaces. To make useful devices, you need to upload a source code to the WisBlock Core. Before you continue, you should have either an Arduino BSP or PlatformIO already setup.
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.
References
- RAK19003 WisBlock Mini Base Board Datasheet | RAKwireless Documentation Center
- RAK19003 WisBlock Mini Base Board Datasheet | RAKwireless Documentation Center
- GitHub - RAKWireless/RAKwireless-Arduino-BSP-Index: RAKwireless BSP Support for the Arduino Board Manager
- WisBlock/PlatformIO/README.md at master · RAKWireless/WisBlock · GitHub
- WisBlock/examples at master · RAKWireless/WisBlock · GitHub
- Battery Connector Cable/5 pcs Battery Wires
- Solar Panel Connector Cable/5 pcs solar wires
- WisBlock Core: LoRaWAN Module for LoRa, Wi-Fi, BLE and/or Bluetooth.
- Design IoT Sensor, LoRa Sensor, NB-IoT Sensor, LTE-M sensor - Build IoT Sensor – RAKwireless Store
- J.S.T. Mfg. Co., Ltd.
- J.S.T. Mfg. Co., Ltd.
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>