background image

Documentation Center

RAK4631 Quick Start Guide

This guide introduces the RAK4631 WisBlock Core LPWAN Module and how to use it. RAK4631 consists of an
nRF52840 MCU and an SX1262 LoRa® chip making it ideal for various IoT projects.

Prerequisite

What Do You Need?

Before going through each and every step on using RAK4631 WisBlock Core, make sure to prepare the necessary
items listed below:

Hardware

RAK4631 WisBlock Core LPWAN Module

Your choice of 

WisBlock Base

Your choice of 

WisBlock Modules

USB Cable

Li-Ion/LiPo battery (optional)
Solar charger (optional)

RAK4631 is also included in various WisBlock kits in the RAKwireless store:

WisBlock Starter Kit  

- This includes a RAK4631 with RAK5005-O WisBlock Base board. This kit is ideal to get

started immediately with WisBlock.

WisBlock Kit  

- This is like the Starter Kit but with various WisBlock modules already included on the kit like

sensors, IO, and other interfaces.

WisBlock Connected Box  

- This is like the WisBlock Kit but cheaper because some modules and peripherals

are not included. Excluded parts are RAKBox-B5, RAK1921, RAKDAP1, electric screwdriver (manual is
included), and battery holder.

Helium Developer Kit  

- This is the WisBlock Kit for the Helium brand.

Software

You can choose Arduino IDE or Platform IO in coding the RAK4631 WisBlock Core.

Programming RAK4631 via Arduino IDE:

Download and install the 

Arduino IDE  

.

 WARNING

If you are using Windows 10.
Do NOT install the Arduino IDE from the Microsoft App Store. Instead, install the original Arduino IDE from
the Arduino official website. The Arduino app from the Microsoft App Store has problems using third-party
Board Support Packages.

To add the WisBlock Core boards on your Arduino board, you need to install the RAKwireless Arduino BSP. You
can follow this complete guide on 

adding the BSP in Arduino IDE  

. You can also have a look at the

RAKwireless Arduino BSP 

GitHub repository  

.

Summary of Contents for 4631

Page 1: ...dules already included on the kit like sensors IO and other interfaces WisBlock Connected Box This is like the WisBlock Kit but cheaper because some modules and peripherals are not included Excluded p...

Page 2: ...he RAK4631 will not work without a WisBlock Base board The WisBlock Base provides a USB connection for programming the RAK4631 It also provides a power source and various interfaces to RAK4631 so that...

Page 3: ...lot and the exposed header pins UART2 is accessible only on the WisBlock IO slot The I2C_1 header pins are as well shared to the WisBlock Base Slots A to D The second I2C_2 is available only on the Wi...

Page 4: ...sBlock Base board RAK5005 O Follow carefully the procedure defined in WisBlock module assembly disassembly instructions in order to secure the connection safely Once attached carefully fix the module...

Page 5: ...ion 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 base...

Page 6: ...abel on its sticker where to connect the antennas as shown in Figure 10 Figure 10 RAK4631 Antenna Label NOTE Detailed information about the RAK4631 BLE and LoRa antenna can be found on the antenna dat...

Page 7: ...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 o...

Page 8: ...quickly build your IoT device with less friction example codes for RAK4631 to be used on all WisBlock Modules are provided You can access the codes on the WisBlock Example code repository The example...

Page 9: ...e just examples All WisBlock Modules have their own quick start guide that you can use as a reference to get started on specific modules RAK1901 Quick Start Guide RAK1902 Quick Start Guide RAK1903 Qui...

Page 10: ...this to a region that is applicable to you like LORAMAC_REGION_US915 LORAMAC_REGION_AU915 etc 2 Setup the activation method Default is OTAA To configure the device to ABP you need to make this boolean...

Page 11: ...it ilat variable is formatted to a 4 byte size array DeviceClass_t g_CurrentClass CLASS_A uint8_t nodeDeviceEUI 8 0x88 0x88 0x88 0x88 0x88 0x88 0x33 0x33 uint8_t nodeAppEUI 8 0xB8 0x27 0xEB 0xFF 0xFE...

Page 12: ...the data must be in the main loop The same with the transmission function the receiving event handler should be short as well All processing of the received data should be in the main loop Uploading t...

Page 13: ...an open source community project that uses LoRa technology to make a long range mesh communicator You need to download the latest Meshtastic firmware and upload it to your RAK4631 to make it compatib...

Page 14: ...ick the reset button on the WisBlock Base There will be a new drive named RAK4631 that will be shown on your folder explorer Inside this drive there will be a text file named INFO_UF2 TXT as shown in...

Page 15: ...pository Once you downloaded these files you need to put them in the same directory folder on your computer For simplicity this guide will assume the files are in C drive Figure 20 Adafruit nrfutil an...

Page 16: ...o the PC via USB Now use the dmesg command to display system information and check if the USB device has been recognized by Linux If the RAK4631 USB device is recognized a listing for the device simil...

Page 17: ...hod download adafruit nrfutil macos and make it executable Usually the adafruit nrfutil macos file will go to the downloads folder The next step after downloading the file is to open the terminal and...

Page 18: ...er Update via Bluetooth Updating the firmware via BLE is also possible The complete guide is on the RAK4631 Bootloader repository using BLE Bootloader Update via Jlink Updating the firmware via Jlink...

Reviews: