Skip to main content
X

RAK15000 WisBlock EEPROM Module Quick Start Guide

Prerequisite​

What Do You Need?​

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

Hardware​

Software​

Product Configuration​

Hardware Setup​

WisBlock can integrate this module which makes it easy for you to save a lot of data, making it readily available to applications that need to access it frequently. The RAK15000 EEPROM Memory module has 1,000,000 write cycles, so it can be used to store constantly changing data.

For more information about RAK15000, please refer to the Datasheet.

The RAK15000 module can be connected to any slot of WisBlock Base to communicate with the WisBlock Core. It will work on SLOT A, B, C, or D. Also, always secure the connection of the WisBlock module by using compatible screws.

Figure 3585: RAK15000 connection to WisBlock Base

Assembling and Disassembling of WisBlock Modules​

Assembling​

As shown in Figure 2, the location for Slot A, B, C, and D are properly marked by silkscreen. Follow carefully the procedure defined in RAK5005-O module assembly/disassembly instructions to attach a WisBlock module. Once attached, carefully fix the module with one or more M1.2 x 3 mm screws, depending on the module.

Figure 3586: Sensor connection to WisBlock Base
Disassembling​

The procedure in disassembling any type of WisBlock modules is the same.

  1. First, remove the screws.
Figure 3587: Removing screws from the WisBlock module
  1. Once the screws are removed, check the silkscreen of the module to find the correct location where force can be applied.
Figure 3588: Detaching silkscreen on the WisBlock module
  1. Apply force to the module at the position of the connector, as shown in Figure 5, to detach the module from the baseboard.
Figure 3589: 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. RAK15000 uses I2C communication lines, and it can cause possible conflict especially on some IO modules. For instance, if you are planning to use it in conjunction with the EPD module, which uses all IO pins, you would have to forego the 3-key keypad (uses IO 3, 5 and 6) and put the EEPROM module on slot D (has IO 5 & 6).

After all this setup, you can now connect the battery (optional) and USB cable to start programming your WisBlock Core.

Software Configuration and Example​

The RAK15000 EEPROM has an I2C-Compatible (Two-Wire) Serial Interface. Furthermore, the EEPROM is organized in so-called pages. One page holds 256-byte and there are 1024 pages. Having insight into how the memory cells are organized is important for write and erase operations.

These are the quick links that go directly to the software guide for the specific WisBlock Core module you use:

RAK15000 in RAK4631 WisBlock Core Guide​

Install the RAKwireless Arduino BSP.

  1. Now, select the RAK4631 WisBlock Core, as shown in Figure 6.
Figure 3590: Selecting RAK4631 as the WisBlock Core
  1. Open the RAK15000 sample code.

You can open the example code for RAK4631 WisBlock Core, as shown in Figure 7.

Figure 3591: Opening the RAK15000 example code for the RAK4631 WisBlock Core
  1. Install Adafruit FRAM_I2C Library.

Once the example code is opened, install the latest version of Adafruit FRAM_I2C library by clicking the link highlighted in yellow, as shown in Figure 8.

Figure 3592: Opening Adafruit EEPROM library

To finish the library installation, click on the Install button highlighted in yellow, as shown in Figure 9.

Figure 3593: Installing the Adafruit EEPROM library
  1. After successful installation of the library, you can now select the right serial port and upload the code, as shown in Figure 10 and Figure 11.
Figure 3594: Selecting the correct Serial Port
Figure 3595: Uploading the RAK15000 example code

The sketch writes a value to a random address. Then it checks the read value and compares it with the written value.

After successful upload, a random number will be written and read to a random address five times.

Figure 3596: RAK15000 example code logs
NOTE

If you experience any error in compiling the example sketch, check the updated code for the RAK4630 WisBlock Core Module that can be found on the RAK4630 WisBlock Example Code Repository.

RAK15000 in RAK11200 WisBlock Core Guide​

Install the RAKwireless Arduino BSP.

  1. Now, select the RAK11200 WisBlock Core, as shown in Figure 13.
Figure 3597: Selecting RAK11200 as the WisBlock Core
  1. Open the RAK15000 sample code.

You can open the example code for RAK11200 WisBlock Core, as shown in Figure 14.

Figure 3598: Opening the RAK15000 example code for the RAK4631 WisBlock Core
  1. Install Adafruit FRAM_I2C Library.

Once the example code is open, install the latest version of Adafruit FRAM_I2C library by clicking the link highlighted in yellow, as shown in Figure 15.

Figure 3599: Opening the Adafruit EEPROM library

To finish the library installation, click on the Install button highlighted in yellow, as shown in Figure 16.

Figure 3600: Installing the Adafruit EEPROM library
  1. After successful installation of the library, you can now select the right serial port and upload the code, as shown in Figure 17 and Figure 19.
Figure 3601: Selecting the correct Serial Port

Before uploading your sketch, short circuit BOOT0 and GND pin, and press the reset button. Then click the Upload button as shown below.

Figure 3602: Force ESP32 Download mode
Figure 3603: Uploading the RAK15000 example code

The sketch writes a value to a random address. Then it checks the read value and compares it with the written value.

After successful upload, a random number will be written and read to a random address five times.

Figure 3604: RAK15000 example code logs
NOTE

If you experience any error in compiling the example sketch, check the updated code for the RAK11200 WisBlock Core Module that can be found on the RAK11200 WisBlock Example Code Repository.

RAK15000 in RAK11310 WisBlock Core Guide​

Install the RAKwireless Arduino BSP.

  1. Now, select the RAK11310 WisBlock Core, as shown in Figure 21.
Figure 3605: Selecting RAK11310 as the WisBlock Core
  1. Open the RAK15000 sample code.

You can open the example code for RAK11200 WisBlock Core, as shown in Figure 22.

Figure 3606: Opening the RAK15000 example code for the RAK4631 WisBlock Core
  1. Install Adafruit FRAM_I2C Library.

Once the example code is open, install the latest version of Adafruit FRAM_I2C library by clicking the link highlighted in yellow, as shown in Figure 23.

Figure 3607: Opening the Adafruit EEPROM library

To finish the library installation, click on the Install button highlighted in yellow, as shown in Figure 24.

Figure 3608: Installing the Adafruit EEPROM library
  1. After successful installation of the library, you can now select the right serial port and upload the code, as shown in Figure 25 and Figure 26.
Figure 3609: Selecting the correct Serial Port
Figure 3610: Uploading the RAK15000 example code

The sketch writes a value to a random address. Then it checks the read value and compares it with the written value.

After successful upload, a random number will be written and read to a random address five times.

Figure 3611: RAK15000 example code logs
NOTE

If you experience any error in compiling the example sketch, check the updated code for the RAK11300 WisBlock Core Module that can be found on the RAK11300 WisBlock Example Code Repository.