Getting Started

Hybrid Radio Project

The Hybrid-Radio has its own getting started page here

Adding the WeMos SAMD21 (Zero/M0 Compatible) Board Manager URL

This step is only required if you are using the WeMOS M0 Compatible Board

To use the WeMos Zero Board, DabShield provide a Board Manager for this.  The URL of the Board Manager is added by selecting File menu, then Preferences. The URL "https://raw.githubusercontent.com/dabshield/WeMos/master/package_wemos_index.json" should be added into the Additional Boards Manager URLs, Click on OK.

Adding the Board Manager to the IDE

WeMos M0

To use the Arduino M0 with the IDE you need to install the Board Manger.  This is a one time procedure that is done by opening the Arduino IDE and then selecting Tool menu, then Board: and then Boards Manager.

In the Boards Manager, scroll down until you see "WeMos M0 Board by DAB Shield", Click within this area and then select Install.

Arduino UNO R4

To use the Arduino UNO R4 with the IDE you need to install the Board Manger.  This is a one time procedure that is done by opening the Arduino IDE and then selecting Tool menu, then Board: and then Boards Manager.

In the Boards Manager, scroll down until you see "Arduino UNO R4 Boards by Arduino", Click within this area and then select Install.

After a while the Installation is complete, select Close.

Installing Drivers

Connect the board to your computer with a USB cable.  Windows should initiate its automatic driver installation process.  When th process is complete, you should find in Device Manager (Window Key + 'X', then device manager) a port listing "Arduino Zero (COMx)". (Note the "M0" close uses the "Zero" USB driver - this is correct).

Selecting the board and Port

You need to select your board "WeMos M0 (Native USB Port)" /  "Arduino UNO R4 Minima" from the Tool > Board menu:

and the Com port from the Tool > Port menu: ("Arduino Zero (Native USB Port)/"Arduino UNO R4 Minima" - (note for the WeMos M0 "Arduino Zero"  is correct it uses the "Zero" USB driver)

The IDE is now installed and set up for your Board.

Adding the DABShield Library

The DABShield Library is Arduino code that is supplied that does the low level communications to the DAB Radio chipset and provides you with a simpler more user friendly set of function calls.  The Library can be installed from Tools>Include Library>Manage Libraries... and search for DABShield.   Click on Install.

In a similar way, other Librarys can be added (such as the 1602LCD library used from the LCD DAB Radio Project).

Adding a DAB example sketch

Example Sketches (code) can be selected for the File>Examples>DABShield menu.

DAB Shield v3.0

The example  code runs on both the  v2.0 and v3.0  Shields,  To use the v3.0 shields, the DABSHIELDV3 must be defined in the Sketch.  This is commented out by default, remove the two '//' before at the top of the example code:

#define DABSHIELDV3

Compiling a Sketch

Compiling is the process that converts the human readable code into the Arduino processor executable program.  To do this select Sketch>Verify/Compile or click on the 'Tick' icon which say Verify when you hover over it.  If everything is set up correctly after a little while you will get a message saying "Done compiling".

Uploading to your Board

With the USB cable and power disconnected, Assemble the DABShield and another other shields together for your project.  Carefull to align the pins to the connectors.  Connect the Board to your PC with a USB Cable.

To upload your program to your board select Sketch>Upload or click on the forward arrow icon that says Upload whne you hover over it.  After a littel while you will get a message saying "Done uploading" and your program will start running on the Arduino board.

Setting up the Serial Monitor

The Arudino boards use the USB port as a Virtual Serial Port and can transmit and recieve data over this port.  The Command Line Radio example project uses this for the Control of the DABShield.  The Serial Monitor can be opened by Tools>Serial Monitor.  The first time this is used Carriage return needs to be slected from the bottom drop down box - this adds the Carriage Return character to the end of each sent command.

DAB Shield v3.0 Speaker Options

The DABShiled v3.0 has an audio processor with speaker output.  There are two configurations for speaker output: Single Ended and Differential.  Differential gives 1W power into 8ohm speakers.