RAK WisBlock RAK13005 User manual

Documentation Center
RAK13005 Quick Start Guide
Prerequisite
What Do You Need?
Before going through each and every step on using the RAK13005 WisBlock module, make sure to prepare the
necessary items listed below:
Hardware
RAK13005 WisBlock LIN Module - Controller/Master Mode
RAK13005 WisBlock LIN Module - Peripheral/Slave Mode
Your choice of WisBlock Base
Your choice of WisBlock Core
USB Cable
Li-Ion/LiPo battery (optional)
Solar charger (optional)
External power source ( 5.5 V to 27 V )
Software
Arduino
Download and install Arduino IDE .
To add the RAKwireless Core boards on your Arduino Boards Manager, install the RAKwireless Arduino BSP
.
Product Configuration
Block Diagram
Hardware Setup
RAK13005 is a WisBlock LIN Module that extends the WisBlock system to be used on communication protocol
called Local Interconnect Network (LIN). This communication is initiated by the automotive industry for the
communication of in-vehicle devices on cars. Today, LIN is also used in other applications that require a robust
communication line. For more information about the RAK13005, refer to the Datasheet.
Pin Definition

Documentation Center
Figure 1: RAK13005 Pin Definition
LIN Peripheral and Controller Mode Hardware
Configuration
RAK13005 supports both Controller(master) and Peripheral(slave) modes. The two modes uses the same
RAK13005 circuit design and configuration is simply determined by an SMD resistor. The resistor location is
shown in Figure 2.
Figure 2: RAK13005 LIN Mode Configuration
Assembling and Disassembling of WisBlock Modules
Assembling
The RAK13005 module can be mounted on the IO slot of the WisBlock Base board, as shown in Figure 3. Also,
always secure the connection of the WisBlock module by using the compatible screws.
Figure 3: RAK13005 mounting connection to WisBlock Base module
RAK13005 Connector Crimping Mechanism

Documentation Center
The RAK13005 features a fast-crimping terminal connector to simplify and ensure the wiring process on the fields.
The fast-crimping terminal can support cable with a width between 20 AWG to 24 AWG. The usual stripping length
is around 6 to 7 mm.
As shown in Figure 4, during the crimping process, you should first press down and maintain the spring head of
the crimping terminal firmly, then insert the stripped cable head into the corresponding connector’s hole. Once
inserted correctly, release the spring head, and the crimping process is completed.
Figure 4: RAK13005 Module Connector
Disassembling
The procedure in disassembling any type of WisBlock modules is the same.
1. First, remove the screws.
Figure 5: Removing screws from the WisBlock module
2. Once the screws are removed, check the silkscreen of the module to find the correct location where force can
be applied.
Figure 6: Detaching silkscreen on the WisBlock module
3. Apply force to the module at the position of the connector, as shown in Figure 7, to detach the module from the
baseboard.

Documentation Center
Figure 7: Applying even forces on the proper location of a WisBlock module
📝 NOTE
If you will connect other modules to the remaining WisBlock Base slots, check on the WisBlock Pin
Mapper tool for possible conflicts.
Now, you can connect the battery (optional) and USB cable to start programming your WisBlock Core.
⚠ 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 a
fire.
Make sure the battery wires match the polarity on the RAK WisBlock Base Board. Not all batteries have
the same wiring.
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.
Software Configuration and Example
In this example, you will be using two RAK13005 Modules to demonstrate LIN functionality.
These are the quick links that go directly to the software guide for the specific WisBlock Core module you use:
RAK13005 in RAK4631 WisBlock Core Guide
RAK13005 in RAK11200 WisBlock Core Guide
RAK13005 in RAK11310 WisBlock Core Guide
RAK13005 in RAK4631 WisBlock Core Guide
Arduino Setup

Documentation Center
Figure 8 is an illustration on how to use two RAK13005 LIN modules for communication applications. One
RAK13005 is configured as Controller and the other RAK13005 is configured as Peripheral. The SMD resistors
that set the mode are highlighted in a yellow box.
Figure 8: Two RAK13005 Interconnection for Controller and Peripheral mode
1. Select the RAK4631 WisBlock Core.
Install the RAKwireless Arduino BSP to find the RAK4631 in the Arduino Boards Manager.
Figure 9: Selecting RAK4631 as WisBlock Core
2. Next, install the RAKwireless TLE7259 library using the Arduino Library manager.
Select Sketch followed by Include Library then Manage Libraries .

Documentation Center
Figure 10: Open Arduino Library Manager
Search for RAKwireless TLE7259 on the Library Manager text box.
Select the latest version of the library then click Install button.
Figure 11: Look for RAKwireless TLE7259 LIN Bus Library
After successful installation, close the Arduino Library window.

Documentation Center
Figure 12: RAKwireless TLE7259 LIN Bus Library Successfully Installed
3. Upload the RAK13005_linbus_master Controller sketch.
Connect the first WisBlock with the RAK13005 module in Controller mode and select the
RAK13005_linbus_master .
Figure 13: Open the code for the RAK13005 Controller
Select the port where RAK4631 WisBlock Core is connected.

Documentation Center
Figure 14: Select the Serial Port of RAK4631 for the RAK13005 LIN module in controller mode.
Now, upload the RAK13005_linbus_master code to the WisBlock Core.
Figure 15: Uploading RAK13005_linbus_master code

Documentation Center
Figure 16: Successful code Upload
After the successful code upload, you can now open the Serial Monitor and see the Serial output.
Figure 17: Serial Output of the RAK13005 Controller Mode
4. Upload the RAK13005_linbus_slaver Peripheral sketch.
Connect the second WisBlock with the RAK13005 in Peripheral mode, then select RAK13005_linbus_slaver .

Documentation Center
Figure 18: Open the code for the RAK13005 Peripheral
Select the port, which is the additional port from the previous port for the controller. You should see two ports in
your Arduino IDE.
Figure 19: Select the Serial Port of RAK4631 for the RAK13005 LIN module in peripheral mode.
After ensuring the port matching the RAK13005 LIN Peripheral, you can now upload the
RAK13005_linbus_slaver code.

Documentation Center
Figure 20: Uploading the RAK13005_linbus_slaver code
📝 NOTE
If you experience any error in compiling an example sketch, check the updated code for the RAK13005
WisBlock Core Module that can be found on the RAK13005 WisBlock Example Code Repository .
5. Check Serial Monitor output.
Check the Serial Monitor on the RAK13005 Peripheral device receiving the data coming from the RAK13005
Controller device. You must have the external power supply connected to have successful transmissions.
Figure 21: Serial Output of the RAK13005 Peripheral Mode
RAK13005 in RAK11200 WisBlock Core Guide
Arduino Setup

Documentation Center
Figure 22 is an illustration on how to use two RAK13005 LIN modules for communication application. One
RAK13005 is configured as Controller and the other RAK13005 is configured as Peripheral. The SMD resistors
that set the mode are highlighted in a yellow box.
Figure 22: Two RAK13005 Interconnection for Controller and Peripheral mode
1. Select the RAK11200 WisBlock Core.
Install RAKwireless Arduino BSP to find the RAK11300 in the Arduino Boards Manager.
Figure 23: Selecting RAK11200 as WisBlock Core
2. Next, install the RAKwireless TLE7259 library using the Arduino Library manager.
Select Sketch followed by Include Library then Manage Libraries .

Documentation Center
Figure 24: Open Arduino Library Manager
Search for RAKwireless TLE7259 on Library Manager text box.
Select the latest version then click Install button.
Figure 25: Look for RAKwireless TLE7259 LIN Bus Library
After successful installation, close the Arduino Library window.

Documentation Center
Figure 26: RAKwireless TLE7259 LIN Bus Library Successfully Installed
3. Upload the RAK13005_linbus_master Controller sketch.
Open the RAK13005_linbus_master Controller sketch.
Connect the first WisBlock with the RAK13005 module in Controller mode and select the
RAK13005_linbus_master .
Figure 27: Open the code for the RAK13005 Controller
Select the port where RAK11200 WisBlock Core is connected.

Documentation Center
Figure 28: Select the Serial Port of RAK11200 for the RAK13005 LIN module in controller mode.
Now, upload the RAK13005_linbus_master code to the WisBlock Core.
Figure 29: Uploading RAK13005_linbus_master code

Documentation Center
Figure 30: Successful code Upload
After the successful code upload, you can now open the Serial Monitor and check the Serial output.
Figure 31: Serial Output of the RAK13005 Controller Mode
4. Upload the RAK13005_linbus_slaver Peripheral sketch.
Connect the second WisBlock with the RAK13005 in Peripheral mode then select RAK13005_linbus_slaver .

Documentation Center
Figure 32: Open the code for the RAK13005 Peripheral
Select the port, which is the additional port from the previous port for the controller. You should see two ports in
your Arduino IDE.
Figure 33: Select the Serial Port of RAK11200 for the RAK13005 LIN module in Peripheral mode.
📝 NOTE:
RAK11200 requires the BOOT0 pin to be configured properly before uploading. If not done properly,
uploading the source code to RAK11200 will fail. Check the full details on the RAK11200 Quick Start
Guide.
After ensuring the port matching the RAK13005 LIN Peripheral, you can now upload the
RAK13005_linbus_slaver code.

Documentation Center
Figure 34: Uploading the RAK13005_linbus_slaver code
📝 NOTE
If you experience any error in compiling an example sketch, check the updated code for the RAK13005
WisBlock Core Module that can be found on the RAK13005 WisBlock Example Code Repository .
5. Check Serial Monitor output.
Check the Serial Monitor on the RAK13005 Peripheral device receiving the data coming from the RAK13005
Controller device. You must have the external power supply connected to have successful transmissions.
Figure 35: Serial Output of the RAK13005 Peripheral Mode
RAK13005 in RAK11310 WisBlock Core Guide
Arduino Setup

Documentation Center
Figure 36 is an illustration on how to use two RAK13005 LIN modules for communication application. One
RAK13005 is configured as Controller and the other RAK13005 is configured as Peripheral. The SMD resistors
that set the mode are highlighted in a yellow box.
Figure 36: Two RAK13005 Interconnection for Controller and Peripheral mode
1. Select the RAK11300 WisBlock Core.
Install the RAKwireless Arduino BSP to find the RAK11300 in the Arduino Boards Manager.
Figure 37: Selecting RAK11300 as WisBlock Core
2. Next, install the RAKwireless TLE7259 library using Arduino Library manager.
Select Sketch followed by Include Library then Manage Libraries .

Documentation Center
Figure 38: Open Arduino Library Manager
Search for RAKwireless TLE7259 on Library Manager text box.
Select the latest version of the library then click Install button.
Figure 39: Look for RAKwireless TLE7259 LIN Bus Library
After successful installation, close the Arduino Library window.