Skip to main content
X

RAK18060 Quick Start Guide

Prerequisite​

What Do You Need?​

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

Hardware​

Software​

  • Download and install the Arduino IDE.
  • To add the RAKwireless Core boards on your Arduino board, install the RAKwireless Arduino BSP. Follow the steps in the GitHub repo.

Product Configuration​

Hardware Setup​

RAK18060 is a stereo amplifier module, part of the WisBlock Audio Series.

For more information about RAK18060, refer to the Datasheet.

RAK18060 module can be connected to the IO slot of the WisBlock Base to communicate with the WisBlock Core. Always secure the connection of the WisBlock module by using compatible screws.

Figure 4111: RAK18060 connection to WisBlock Base

Assembling and Disassembling of WisBlock Modules​

Assembling​

As shown in Figure 2, the location for the IO slot is properly marked by silkscreen. Follow carefully the procedure defined in WisBlock Base board assembly/disassembly instructions to attach a WisBlock module. Once attached, carefully fix the module with one or more pieces of M1.2 x 3 mm screws depending on the module.

Figure 4112: RAK18060 connection to WisBlock Base
Disassembling​

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

  1. First, remove the screws.
Figure 4113: 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 4114: 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 4115: 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. RAK18060 uses I2C communication lines, and it can cause possible conflict, especially on other WisBlock Modules connected to Slot A to F of the WisBlock Base.

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

warning
  • Batteries 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.
  • 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.
  • Make sure the battery wires match the polarity on the WisBlock Base board. Not all batteries have the same wiring.
  1. You need to connect the LoRa and BLE antennas to the RAK4631 module to avoid damage to this module during operation.
Figure 4116: LoRa and BLE antennas connection to RAK4631 module
  1. There are different power sources possible for the RAK18060. By default, the power source is the battery on the WisBlock Base board. You should see a solder blob on SB2 on the circuit board of RAK18060.
Figure 4117: Power Select Diagram for RAK18060
Figure 4118: Solder portion for SB2 of RAK18060
  1. Then you can now connect the speaker on either output of the RAK18060 module.
Figure 4119: Speaker output portions of RAK18060 module

Software Configuration and Example​

RAK18060 is a stereo amplifier module, part of the WisBlock Audio Series. The RAK18060 is designed based on the TAS2560 from TI. The TAS2560 features an ultra low-noise audio DAC and Class-D audio amplifier which incorporates speaker voltage and current sensing feedback for use with speaker protection algorithms. The RAK18060 can drive the speaker to play audio through the input I2S signals. With other WisBlock modules, it can achieve rich applications, such as recording and voice control functions.

Sample Code Test of the RAK18060 WisBlock Module​

  1. Install the RAKwireless Arduino BSP for WisBlock by using the package_rakwireless_index.json board installation package. The WisBlock Core should now be available on the Arduino IDE.

  2. Plug in your integrated module (RAK4631 + RAK18060) into your PC through the USB cable.

  3. Install the latest RAKwireless Audio Library using the Library Manager of Arduino IDE.

Figure 4120: RAKwireless Audio Library
  1. Then open your Arduino IDE and open the PlayBack48K sample code for RAK18060, as shown in Figures 11 to 13.
NOTE

The example codes of RAKwireless Audio Library are compatible with different WisBlock Core. You have to select the correct WisBlock Core based on what core you used in your application.

Figure 4121: Arduino IDE
Figure 4122: Selecting the PlayBack48K Sample Code
Figure 4123: PlayBack48K Sample Code
  1. Then select your WisBlock Core RAK4631, as shown in Figure 14.
Figure 4124: Selecting the RAK4631 WisBlock Core board
  1. Once done, select the corresponding port of your WisBlock Core RAK4631.
Figure 4125: Selecting the port of RAK4631
  1. Once done, it should look the same with Figure 16.
Figure 4126: Selected board and port of RAK4631
  1. Then tick the right arrow at the top leftmost part of the Arduino IDE to upload the sample code to your RAK4631 module.
Figure 4127: Uploading the PlayBack48K sample code to your RAK4631
  1. Once done uploading, it should look the same with Figure 18. At this moment, you will hear Train 52 from Amsterdam is now arriving from your speaker playing repetitively.
Figure 4128: Programmed RAK4631