Edit on GitHub

ROBOTIS MINI APP

This app is used to control and operate ROBOTIS MINI

App Install

Introduction & Installation

ROBOTIS-MINI uses a smart device to operate various motions.

System Requirements

Open the Play Store or App Store on the smart device. (Play Store is for Android Market App)
Search for ROBOTIS MINI or ROBOTIS and select MINI, then click to install. An authorization request message may appear.

Bluetooth Connection

When the controller is turned on and the LED of the Bluetooth (BT-210) blinks, the robot and Bluetooth are successfully connected.

Connecting the robot with the app using Bluetooth

Execute the ROBOTIS-MINI app.

CAUTION : If the smart device is configured as a Client, it will skip to the operation screen directly instead of the registering screen.
Please refer to the App Setting section for Server/Client settings.

Check the Bluetooth (BT-210) connection

Enter Bluetooth PIN number

Assembly Check using the App

Select Setting option, then use Actuator Test feature to check the assembly. Once your smart device and ROBOTIS MINI are connected, the image of ROBOTIS MINI on the right will appear.

Tap on each ID while Bluetooth is connected. If there is no problems in the assembly, the Dynamixel LED will blink in red, green, then blue.

If you tap on an ID but the wrong Dynamixel LED lights up in the actual robot, there is an assembly problem. In this case, change the ID, or reassemble the joint by switching with the correct Dynamixel.

App Usage

NOTE : The ROBOTIS-MINI app uses smart device’s functions such as the button, gesture (sensor), voice recognition, and messenger to play motions.

Stop Motion, Initial Position, and Stand Up are 3 basic buttons on the Run tab.

Below are the functions of each button.

NOTE : When the robot is playing a motion, all other motions except the Stop Motion will be ignored.

Control with Buttons

In order to Add/Edit/Delete/Arrange buttons, use the Edit tab.

Control with Gestures

The Gesture tab uses the acceleration sensor of the smart device to command the robot to do certain motions. For example, if the user draws an O or X when holding the smart device, the robot will either walk or sit down based on the assigned motion. This works when the smart device is held straight up 90 degrees to the ground.

Operate with Voice Recognition

NOTE : ROBOTIS-MINI uses Google’s voice recognition.

Touch the microphone icon in the center of screen then speak(input) the command. To use this function, you must have an internet connected smart device.

Touch the ‘Edit’ button to add, edit, or delete any voice command.

CAUTION : To delete a command added during the training, delete the voice command first and then re-register.

Voice Recognition Test To check whether the registered voice command is recognized properly, use the MIC icon under the ‘Edit’ tab to test the word. This does not operate the robot.

Operate with Messenger

Your robot can be controlled using the various Messengers in your smart device. [Does not work on all Messengers.] To receive commands via Messenger, you must have internet access to your smart device.

Messenger, uses the notification bar of your smart device to check whether the command corresponds to the message then runs the command if it is the same. Messenger uses the registered voice commands.

CAUTION : Your Accessibility Setting for the ROBOTIS-MINI App must be enabled(Please refer to the ROBOTIS-MINI App Accessibility Setting). If your exact message is not displayed in the notification bar, you may not have access to your robot via Messenger.

Operate with Remocon

App Setting

The ‘Setting’ is located on the top right corner of your device and below are the explanations for the menus.

Server/Client Setting

This setting is for controlling one ROBOTIS-MINI with many smart devices. One smart device will be set as Server to connect directly with the ROBOTIS-MINI, and the other smart devices will be set as Client to send commands to the Server. The Server will receive the commands sent from the Clients, then send the commands to ROBOTIS-MINI to make it perform a motion.

By using the server/client setting, the user can hold one smart device in each hand to control the ROBOTIS-MINI. The left hand device may perform gestures for left motions, and the right hand device may perform gestures for right motions.

This function cannot be used under mobile network connection (3G/4G/LTE). The smart devices that are set under server and client setting must be connected in the same network.

1) They can be connected to the same router, or 2) One device may have its Wi-Fi hotspot function turned on, with the other devices connected to this hotspot

Motion Sound Setting

Users can add a sound file to be played when a certain motion number is performed. With this function, users can play a music on the smart device while performing dance motions.

Select ‘Add sound’ to input the specific motion number and register the sound file to be played. Registered sound files can be played, edited, or deleted from the sound list.

Motion File Setting

‘Motion page number’ is the numbers that are given to the motions in the motion group. Users can save time on checking each motion page number by registering the motion files in the ‘Motion file setting’.

Once a motion file is registered, the ‘list’ button will be shown on the ‘add command’ window. Select the ‘list’ button to show the list of motion pages in the motion file. Select one of the motion pages shown, then its motion name and motion page number will be automatically inputted on the screen.

The default value is set to the basic motion file provided with the ROBOTIS-MINI.

Once a motion file is registered, the ‘list’ button will be shown on the ‘add command’ window. Select the ‘list’ button to show the list of motion pages in the motion file. Select one of the motion pages shown, then its motion name and motion page number will be automatically inputted on the screen.

Accessibility Setting

Accessibility Setting is required to use the ‘Messenger’ function of the ROBOTIS-MINI App. The App must be able to access the message received through the messenger to verify that it is a correct command registered in the command list.

Once this function is activated, the ROBOTIS-MINI App can access the received messages that show up on the smart device’s notification bar.

So, if this function is deactivated, the ROBOTIS-MINI App won’t be able to access and read the commands sent via messenger, so the robot will not be able to carry out the command.

Unlike the Server/Client setting, this function uses the messenger as a media of sending the command, so the smart device (not connected to the ROBOTIS-MINI) sending the message to the main smart device (connected to the ROBOTIS-MINI) doesn’t have to be connected in the same network.

The user must activate the ‘ROBOTIS-MINI’ on the accessibility setting list to activate this function.

Gesture Margin of Error Setting

This setting is used to adjust the gesture recognition rate when using the Gesture function. Setting the margin of error tolerance range low will require more precise gesture movement. Setting the range high will improve gesture recognition but will be more sensitive to other similar movements.

Please refer to ‘Operating ROBOTIS-MINI’ for more information on the Gesture function.

Actuator Test

Touch ‘Setting” then “Actuator Test’ to check your assembly. Once your smart device and ROBOTIS-MINI are connected, the image of ROBOTIS-MINI on the far right will appear. Tap on each of the ID, and if the Bluetooth is connected and there is no problems in the actuators, the joint’s LED will blink in red, green, then blue.

If you tap an ID but the wrong joint lights up on the actual robot, there is an assembly problem. In this case, change the ID, or reassemble the joint into the correct position.

Motion Offset

Offset refers to the difference of standard value. Even when assembling the same type of robots, minor deviations exist between each of their respective motors, resulting in the final posture to be slightly different between them. Adjusting the motion offset value will compensate the deviated amount to perform motions more accurately.

If a joint’s position is not as shown on the image and is crooked, use the torque ON/OFF function of the joint to adjust the joint into its correct initial position.

CAUTION : Please hold up the ROBOTIS-MINI to accurately check the position of the joints.Checking the position with the ROBOTIS-MINI on the ground may cause its legs or waist joints to alter.

Touch an ID to turn the respective joint’s torque OFF, and you will be able to physically move the joint. The image shown on the screen shows how the correct standard position of the joint should be.

Refer to the image to move the joint to its correct position, and select ‘Okay’ to turn the torque back ON. The app will read the adjusted value of the position to calculate and show the offset value on the screen.

If it is difficult to position the joint into an accurate position, touch (hold) the ID number long to go into a precise setting mode from the smart device. This way, users will be able to precisely adjust the joint position using the slide bar displayed on the screen.

Applying the changed offset to the ROBOTIS-MINI requires downloading. Touch the download button on the top right to download the value to the ROBOTIS-MINI controller.

Initialize

This functions returns the settings for the Button/Gesture/Voice to it’s default setting.