Getting Started

Hybrid Radio Project

The Hybrid-Radio has its own getting started page here

This page provides informatin on how to get started with your Arduino DABShield Project.

Installing the Arduino Integrated Development Environment (IDE)

The Arduino IDE is the software where you write your code and upload it to the arduino baord.

This Getting Started assumes that you will use the Windows Desktop Ariduion IDE.

The IDE software can be downloaded from https://www.arduino.cc/en/Main/Software

This page also contains a getting started link which shows you how to install the software.

There is also a good introduction to Using the IDE.

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

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

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.

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)" from the Tool > Board menu:

and the Com port from the Tool > Port menu: (Note the Port will say "Arduino Zero (Native USB Port)" - this is correct as the "M0" Clone 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.

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.