Arduino IDE 3DoT Tutorial

Arduino, first and foremost, is an open‐source computer hardware and software company. The Arduino Community refers to the project and user community that designs and utilizes microcontroller‐based development boards. The 3DoT board is based on the Arduino family of ATmega32U4 boards.

Figure 1.1. 3DoT Boards

The most common programming approach is to use the Arduino IDE, which utilizes the C++ programming language. This gives users access to an enormous Arduino Library that is constantly growing thanks to the open‐source community.

Shown in Figure 1.2 is Arduino IDE once the application has been opened. It defaults into a blank sketch where programming can begin immediately. First, you will need to add the 3DoT board to the Arduino IDE.

Figure 1.2. Arduino IDE Default Window

Adding the 3DoT Board

Follow these step-by-step instructions along with associated pictures to add the 3DoT board to the Arduino IDE.

  1. Navigate to File / Preferences
  2. Paste the following link into Additional Board Manager URLs:  https://arxterra.com/downloads/package_3DoT_index.json
  3. Close the preferences window and navigate to Tools / Board: / Boards Manager…
  4. Type “3DoT” in the search bar. The board Should show up.
  5. Click inside of the box that contains the text “3DoT by Arxterra” and the “Install” button should appear. Click Install.

From now on you can select the 3DoT board just like any other Arduino board.

Figure 1.3. Step 1: Navigate to File / Preferences

Figure 1.4. Step 2: Add link to “Additional Board Manager URLs:”

Figure 1.5. Step 3: Navigate to the Boards Manager

Figure 1.6. Step 4: Search for 3DoT

Figure 1.7. Step 5: Install the 3DoT Board

Uploading Arduino Sketches to your 3DoT Board

OFF-PRG-RUN Switch

The Arxterra 3DoT board has two switchable modes of operation: Program and Run. Use the program PRG mode to upload your sketches and the RUN mode to run your program.

Figure 1.8. OFF-PRG-RUN Switch


Figure 1.9 Switch in PRG position

Note that in order to switch from RUN -> PRG you must first turn off the 3DoT and then switch back to PRG. (RUN -> OFF -> PRG)

Select the 3DoT Board

Connect the Arduino board to the PC via a micro USB cable. Select the Tools pulldown menu and go to Board. This list is populated with the currently available Arduino Boards able to be programmed using Arduino IDE, select “Arxterra 3DoT”

.

Figure 2.0. Select Arxterra 3DoT Board

Select the Port

If Arduino IDE was downloaded before plugging in a 3DoT board, when plugging in the board, the USB drivers should have installed automatically. The most recent version of Arduino IDE should automatically recognize connected boards and label them with the respective COM port they are using.  Select the Tools pulldown menu and then Port. Here, it should list all open COM ports and, if an Arduino board is recognized, will list its name. Select the “Arxterra 3DoT” connected to the PC. If the setup was successful, the Arxterra 3DoT and COM port should appear in the lower right‐hand corner of the Arduino window. These steps are shown below in Figure 2.1.

Figure 2.1. COM Port Setup

Testing 3Dot With Arduino – 3DoT Blink

One common procedure to test whether the board being used is properly set up is by uploading the sample sketch “Blink”. This sketch is included in all Arduino IDE releases and can be accessed by

File > Examples > 01.Basics > Blink

shown in Figure 2.2.

Figure 2.2. Access “Blink” sketch.

Like the Arduino UNO, the 3DoT surface‐mounted LED is wired to digital pin 13 and is located between the USB port and the switch. Press the “Upload” button in the upper‐left corner to upload “Blink” to the board. This sketch will blink the LED at a specified interval and is an easy way to confirm if the board was set up properly and code uploaded successfully.

Quick Guide Summary

  1. Connect 3DoT Board to PC via a microUSB cable
  2. Select connected board in Arduino IDE ( Tools > Boards > Arxterra 3DoT )
  3. Select proper COM port ( Tools > Port > COMx (Arxterra 3DoT) )
  4. Open “Blink” sketch ( File > Examples > Basics > 01.Blink )
  5. Click “Upload” button to upload the program to connected board
  6. Confirm board is working properly by observing blinking LED

Installing the ArxRobot Library

The 3DoT extension to the Arduino library adds a powerful set of functions allowing you to seamlessly control your robot.  These functions include support for the ArxRobot Android and iPhone App plus access to the Arxterra telerobotic community. In addition, the library allows you to easily customize your robot by adding new commands and telemetry channels. To install the ArxRobot library first download the library from this link below.

Then, in the Arduino IDE window, click on Sketch > Include Library  > Add .ZIP Library as shown in Figure 1.7.

Figure 2.1. Add .ZIP Library to Arduino IDE.

Navigate to the downloaded zip folder, select the folder, and click “Open” shown in Figure 1.8. Save the folder in your Arduino IDE library  or your Arduino project folder.

Figure 2.2. Select ZIP Library and add to your Arduino project folder.

Getting Started with the ArxRobot Library

Making a Bluetooth Controlled Robot

With the ArxRobot Library installed, you can navigate to File -> Examples -> ArxRobot Library to find three example sketches:

  • ArxRobot_Basic
  • ArxRobot_Servo
  • ArxRobot_Telecomm

ArxRobot Library examples

The ArxRobot_Basic example is a barebones sketch that handles all the background robot operations, including Bluetooth commands. This means that uploading the Basic example code will make your robot ready to connect to Bluetooth and go!

Figure 2.3. ArxRobot_Basic Script.

The Servo example shows you how to set a custom current limit and how to attach a servo.

The Telecomm example guides you through adding custom commands and telemetry and overriding the default commands.

Connecting To the App and Control Panel/Troubleshooting

See the next section!

Using the Arduino Serial Monitor/Plotter

The 3DoT board communicates with the PC using two serial (COM) ports. Which port is active depends on the switch position (program or run). In the previous section you selected the COM port used to upload your program (i.e., switch in program mode). To run the serial monitor or plotter, you need to identify and select the COM port that is active in run mode.

Now that you are ready to test your code switch from programming mode to run mode.

Figure 2.3. Switch in RUN position

Now go to tools again and switch the com port to the new one that appears.

Figure 2.4 Select Serial Port

Now you can open serial monitor from tools menu or select the magnifying glass in the top-right hand corner.

Figure 2.5. Serial Monitor Window