Getting Started With the ArxRobot App and Control Panel
Table of Contents
- 0.1 Getting Started With the ArxRobot App and Control Panel
- 0.2 Connecting To Your Robot With the ArxRobot App
- 1 Register for an Arxterra Account
- 2 Community Mode: Connecting Through the Control Panel
- 3 Troubleshooting
Arxterra Operating Modes
Download the Axterra App
While we are in the Beta testing period, to get access to the iOS application, email firstname.lastname@example.org
- In the email state:
- Phone model
- IOS Version
- For IOS you must provide your phone’s UDID
You will a receive a direct download link to the most current IOS version of the ArxRobot Application after email communication. Then simply connect your IOS phone to a computer with iTunes installed then move the ipa file to your device.
- Click on the download arrow near the upper right corner of the Google Drive page, and download the app file to your computer.
- Open iTunes on your computer while your device is connected.
- With iTunes versions prior to 12.7:
- Drag the app file icon into the iTunes window to add it to your apps library.
- Select your device in iTunes and click the “Sync” button.
- With iTunes version 12.7 or newer:
- Make sure your device is showing in the iTunes sidebar (under devices).
- Drag the app file icon onto it (see example image below).
Figure 3.8 Drag the App icon onto your connected device in iTunes
Connecting To Your Robot With the ArxRobot App
Step 1: Ensure the ArxRobot_Basic sketch is uploaded to your robot (see Getting Started – Initial Arduino IDE Setup)
Step 2: Turn on the 3DoT and load up the app
Step 3: If it hasn’t already popped up automatically, open up the bluetooth menu by tapping the menu icon, and then the Bluetooth icon.
Step 4: What you see here will vary. In my case, there are a lot of devices the app can’t connect to. Under “Compatability”, choose “Show All Detected”, and scroll down to find the name of your 3DoT Bluetooth Module.
Step 5: Tap “Test Now” to attempt to connect to the 3DoT.
Please be patient while the app finishes scanning all Bluetooth devices and connects to the 3DoT. You may need to tap “Test Now” again if it fails at first. The less unrelated BLE devices are near you the faster this process will be.
Step 6: Once you successfully connect to the 3DoT, the Bluetooth menu should automatically close and you are ready to control your robot!
Tip: If one of the directions of your motors is reversed, you can easily fix this through the app! Just turn on developer mode:
Tap the gear icon, and choose “Robot Capabilities Configuration”, then scroll down to reverse one of the motor polarities.
Register for an Arxterra Account
First set up an account here on arxterra.com using the register tab under “My Account”.
Figure 3.2: Select “Register” from “My Account” tab.
The username provided on the registration page will be required by the Arxterra application and control panel. Fill in the fields shown in Figure 3.3.
Figure 3.3: Generation of username and inputting contact information.
Community Mode: Connecting Through the Control Panel
Step 1: Tap the Mode select button in the ArxRobot App and select “Community”.
Step 2: In the menu, tap the settings gear icon, and select “Community Login Settings”.
Set the Robot name to whatever you like and set the Pilot name to match your Arxterra username exactly.
Step 3: Tap the “Go Online” Button
Step 4: Open up the ArxRobot Control Panel on your computer and enter your login info in the top right
Step 5: Find your robot pin on the map and click the green person to beam in!
Use the controls to move your robot. See the advanced guides for info on how to add your own additional controls and telemetry.
Common Issues Getting Started
The ArxRobot App won’t load/hangs at startup:
This means the app is struggling to obtain the permissions required to run. Navigate to your phone’s app permission settings and give the ArxRobot app all the permissions you can.
I’m having trouble connecting to the 3DoT
Usually, you just need to wait a bit longer to allow the app to retry connecting to the 3DoT. If you have waited long enough and it still doesn’t work, turn off the 3DoT, close the ArxRobot app completely, turn your phone’s bluetooth off and repeat the connecting process. Other devices may be interfering at first, but eventually you should always be able to connect.
I’m connected but the controls don’t do anything/my robot’s motors stopped
First, make sure your battery is fully charged and you have not drained it below a safe level (~3.3V). Draining the battery too low will permanently damage it and will likely cause it to not be able to supply enough power for the motors.
Next, let’s make sure the motors you are using are compatible and working by uploading a simple sketch that runs them. Copy and paste the follow sketch to the arduino IDE, upload it and run it.
Show Example for 3DoT 9.05 and older
#define PWMA 6
#define AIN2 4
#define AIN1 12
#define PWMB 10
#define BIN1 9
#define BIN2 5
#define STBY 8
Show Example for 3DoT v9.1+
#define STBY 4
#define AIN1 6
#define AIN2 9
#define BIN1 10
#define BIN2 5
Turn your 3DoT on to find out if the motors will run.
Next, make sure you have the ArxRobot_Basic sketch uploaded to your board. If you you are using your own code, upload the ArxRobot_Basic sketch to find whether the issue is your code or the robot.
If your motors run fine and you have the correct code uploaded but the motors won’t run with the app, you likely need to set the right current limit for your motors. To do this, simply add the line:
ArxRobot.setCurrentLimit(N); // set current limit to …
to the setup portion of your code, changing N to a number between 1-128 to set the current limit. Usually a value around 60 is correct. You can experiment with different values or see Programming the 3DoT Current Limiter for more info.