Getting Started with the Artemis Development Kit

Contributors: santaimpersonator, Liquid Soulder, Member #1571936

Arduino Examples

Blink

With full Arduino support, users will be able to implement the built-in examples of the Arduino IDE on the Artemis DK. To begin, let's start with the most basic example: Blink.

1. From the drop down file menu, pull up the Blink sketch:

2. Since users will need the compiled binary code in order to program the Artemis DK, save this example somewhere that is easily accessible; the desktop is a good option. (*Remember to use Save As, so that you retain the original example within the Arduino IDE.)

3. Next, you will want to select the Artemis Dev Kit board from the tools drop down menu: Tools > Board: > Artemis Dev Kit

4. Finally, you will need to acquire the compiled binary code using the sketch drop down menu: Sketch > Export compiled Binary (Ctrl + Alt + S)

5. Now, the compiled binary will be located in the same location that the example was saved, from the previous step.

6. All that is left is to drag and drop (or copy) the compiled binary file into the mass storage device for the Artemis DK. The interface chip will take care of the rest.

7. The storage drive will automatically eject once the programming is complete. To verify that the board is working and that the programming was successful, users should see the STAT LED blinking in a ~1 sec. interval.

Hello World

In this example, users will create their own sketch, compile and export the binary file, program the Artemis DK, and view the serial communication in a terminal emulator. (*Most of the steps below are illustrated the procedure of the previous example.)

1. Open a new sketch in the Arduino IDE from the drop down file menu: File > New.

2. Copy the example code below into the sketch:

   language:c
   // the setup routine runs once when you press reset:
   void setup() {
     // initialize serial communication at 9600 bits per second:
     Serial.begin(9600);
   }
   
   // the loop routine runs over and over again forever:
   void loop() {
     // print out "Hello World"
     Serial.println("Hello World");
     delay(500);
   }
   

3. Save the sketch (File > Save As...) using the file drop down menu.

4. Select the then, export the compiled binary code (Sketch > Export compiled Binary) using the sketch drop down menu.
5. Drag and drop (or copy) the binary .bin file into the ARTEMIS mass storage drive. The storage drive will automatically eject once the programming is complete.
6. To verify that the board is working and that the programming was successful, open a terminal emulator, such as TeraTerm or the Serial Monitor in the Arduino IDE. Connect to the serial port for the Artemis DK; don't forget to set the baud rate to 9600 bps.

Bluetooth: LED

As in the prior examples, these steps will follow a similar procedure.

1. From the drop down file menu, open the LED sketch: File > Examples > ArduinoBLE > Peripheral > LED.
2. Save the sketch (File > Save As...) using the file drop down menu.
3. Select the then, export the compiled binary code (Sketch > Export compiled Binary) using the sketch drop down menu.
4. Drag and drop (or copy) the binary .bin file into the ARTEMIS mass storage drive. The storage drive will automatically eject once the programming is complete.
5. To verify that the board is working and that the programming was successful, open a terminal emulator, such as TeraTerm or the Serial Monitor in the Arduino IDE. Connect to the serial port for the Artemis DK; don't forget to set the baud rate to 9600 bps.
6. Click the reset button to begin the program. Users should see a BLE LED Peripheral message in the terminal emulator.
7. Follow the steps and video below to control the STAT LED on the Artemis DK.
   1. Unlock the phone and enable the Bluetooth.
   2. Open the NRF app.
   3. Click on the Scan button on the upper right corner.
   4. In the results, locate the device labeled LED. Click on the CONNECT button to the right of the device name.
      • In the terminal emulator, users should see a Connected to central: message followed by the mac address of the phone.
   5. Once connected, locate the Unknown Service. It will have the following service UUID: 19B10000-E8F2-537E-4F6C-D104768A1214.
   6. Click on the service. Then, locate and click on the upload button (up arrow).
   7. A dialog box will open. We want to write a value, so locate the New Value text field, under the Write value drop-down menu option. Based on the control inputs to the LED, an LED on or LED off message will appear in the terminal emulator.
      • Enter 01 to turn the LED on. Then click the SEND button.
      • Enter 00 to turn the LED off. Then click the SEND button.

Utilizing the example with the NRF phone app.

Serial output of the LED Bluetooth example. (Click to enlarge)

More Advanced Examples and Features

For more advanced examples and features of the Artemis DK with the Arduino IDE, check out the Arduino IDE software development tutorial. We also just released a blog post on streaming data over Bluetooth to a computer.

Additionally, since the Arduino core for the Artemis module is built upon the Mbed™ OS, the API can also be utilized within the Arduino IDE. For more information, check out the Mbed™ software development tutorial.