Start Usage
Step 1: Create a Bonic.ai Account
To begin using your BonicBot A2, you must create a Bonic.ai account that will later be linked with your robot.If you are registering on behalf of a company or institution, please contact our designated contact person. They will create your account.
Go to Bonic.ai → https://bonic.ai/login
Click Sign Up and register using:
- Email and Password, or
- Google Sign-In
After creating your account, send an email to:
Request them to link your BonicBot A2 to your Bonic.ai profile.
Step 2: Verify Your Robot in the Bonic.ai Dashboard
Once the admin links your bot:
- Log in to Bonic.ai
- Open the Dashboard
- Navigate to My Robots
Your assigned BonicBot A2 will be visible here.

Tap View Details on the corresponding bot to see its full profile.
Add Robot Instructions
Inside the robot profile, open the Instructions tab.
This is where you can add and update instructions that define robot behaviour, movement logic, responses, and interaction styles.
Step 3: Install the BonicBot Mobile App
After your Bonic.ai account is active and your robot is linked:
- Go to the Google Play Store (Coming soon on Apple App Store)
- Download and install:
BonicBot – Robot Controller - Log in using the same email ID used on Bonic.ai.
Once logged in, you will see the Robot Selection page.
Then you will be directed to the Home Page, where all robot control features are available.
Step 4: Turning the Robot On and Off
4.1 Turning On the Robot
Follow these steps to power on your BonicBot A2:
-
Activate the Emergency Switch
Rotate the emergency switch at the bottom of the robot in a clockwise direction until the red button is pulled out (standard emergency switch activation mechanism). -
Power On the Robot
Press and hold the push button on the upper side of the back portion of the robot until the ring light turns on.
Info: You will see the display turn on and hear a voice from the speaker confirming that the robot is powered on.
4.2 Turning Off the Robot
Follow these steps to safely power down your BonicBot A2:
-
Initiate Shutdown
Press and hold the push button until the ring light starts blinking. -
Deactivate Power
Press the emergency switch to kill the power.
⚠️ Important: Do not directly kill the power by pressing the emergency switch unless it is an actual emergency situation. Always follow the proper shutdown sequence to avoid potential damage to the robot’s systems.
Step 5: Connect the Bot to the App
Follow these steps to connect your phone with BonicBot A2:
- Ensure the robot is powered on
- Enable Bluetooth on your smartphone
- In the app, open the Bluetooth section
- Pair your device with the robot
Step 6: Calibrate Your Robot
Calibration ensures that all arm and head servo positions are aligned correctly.
6.1 Power On and Connect
- Turn on your BonicBot A2
- Open the BonicBot Mobile App
6.2 Open Calibration Settings
- Go to Settings
- Select Calibrate Servos
- Tap Begin Calibration
6.3 Release All Servos
- Tap Release so all joints move freely
- Manually adjust all joints to neutral posture
- Keep arms straight and head centered
6.4 Final Calibration
- Tap Set Middle to set the reset position of the servo motors
- Tap Complete Calibration to complete the setup process.
Then the robot will save this as neutral posture.

Figure: Calibrated BonicBot A2
Step 7: Test Your Robot
After calibration, verify robot movement and functionality through Manual Mode or AI Mode.
7.1 Manual Mode Testing
Manual Mode allows you to validate motion control of wheels, arms, and head.
7.1.1 Wheel Movement
- Forward
- Backward
- Left Turn
- Right Turn
- Stop
Increase acceleration gradually for smoother movement.
7.1.2 Arm Movement
- Shoulder Pitch
- Elbow Movement
7.1.3 Head Movement
- Head Pan (left ↔ right)
Note: You can adjust Speed and Acceleration for each movement. Increase values gradually for smoother performance.
7.1.4 Eye Display
The eye display supports six emotion and animation modes, which can be selected to visually express the robot’s state and interactions.
7.1.5 AI Voice & Function Setup
Open Settings and go to AI Voice. Select your preferred voice, then navigate to AI Functions and enable the following options:
- Move in a Direction
- Get Visual Data
- Do Action
- Stop Action
- List Actions
7.2 AI Mode Testing
Use AI Mode to test interactive behaviour and voice response.
To begin:
Open AI Mode → Tap Start Voice Chat
Speak to the robot and verify audio output and response.
Example Questions
- “Hello BonicBot”
- “Hey BonicBot”
- “What is photosynthesis?”
- “Can you wave your hand?”
- “Tell me a joke”
Step 8: Configuring Raspberry Pi
8.1 Introduction
This section provides step-by-step instructions for configuring the Raspberry Pi for ROS Mode operation with BonicBot A2. It covers enabling ROS Mode, network configuration, and connection verification.
8.2 Enabling ROS Mode
8.2.1 Access ROS Mode
- Open the application and go to the Home Screen.
- Tap ROS Mode.
8.2.2 Enable RPI Monitoring
- Locate the toggle switch labeled RPI Monitoring.
⚠️ Note: Establishing a secure Bluetooth connection may take a few moments. This delay is normal as the app synchronizes with the robot’s hardware. Please wait until the indicator shows “Connected” before proceeding.
Once the BLE connection is active, the application performs a status check to determine whether the robot is connected to a local network.
8.2.3 Enter Wi-Fi Details
- Enter the Wi-Fi name (SSID).
- Enter the Wi-Fi password.
- Tap Send.
After a successful connection, the Raspberry Pi responds with its local IP address, which is displayed in the connection section.
Step 9: ROS-Based Operation
9.1 Connect to Robot
- Tap Connect to Robot.
- Tap Open Settings to proceed.
The Prerequisites section displays:
- RPI Connected: Indicates whether the Raspberry Pi is connected.
- Wi-Fi Connected: Displays the connected Wi-Fi network.
- IP Address: Shows the current IP address.
9.2 Launching ROS
- Tap Launch ROS.
- Tap OK to confirm.
Note: Wait at least 30 seconds before connecting to the robot. You can tap SHOW TERMINAL to view the logs and monitor the launch process.
- Tap Connect to Robot.
9.3 ROS Interface Overview
The ROS interface consists of two main pages:
- Movement Control
- Servo Control
9.4 Movement Control Page
When the ROS interface opens, the Movement Control page is displayed by default.
9.4.1 Movement Controls
Use the on-screen controls to move the robot.
9.4.2 Speed Values
Adjust the following parameters:
- Linear Speed: Forward and backward movement speed
- Angular Speed: Rotational movement speed
9.4.3 Servo Page
Switch to the Servo page to control individual servo motors.
Available servos:
- Left Shoulder
- Right Shoulder
- Left Elbow
- Right Elbow
- Left Gripper
- Right Gripper
- Neck
Servo control features:
- Individual servo position adjustment
- Real-time position feedback
- Precise control for movements and gestures
9.4.4 Camera View
- Tap Start Camera This will reveal the camera toggle option on the screen.
Note: Wait at least 30 seconds for the camera to initialize.
![]()
- Expand the camera toggle.
Tap to expand the toggle. As soon as the view expands, the application will connect to the robot’s camera, and the real-time video feed will appear on your screen..
9.4.5 Map View
The Map View section appears below the speed controls.
9.5 Creating and Using Maps
9.5.1 Start Mapping
- Tap Map View.
- Tap Start Map to begin creating a map of your environment
Note: Wait up to 30 seconds for the map to initialize.
- Move the robot using the joystick or the BonicBot Controller App.
- Scan the Area: Drive the robot around the entire area you wish to map. Continue driving until the map on your screen looks complete and all boundaries/obstacles are clearly visible.
- Save the Map: Once the scan is complete, tap the Save Map button. This securely stores the current map data.
- Stop Mapping: After saving, tap Stop Map to finalize the mapping process.
⚠️ Note: We strongly recommend following this exact sequence (Save -> Stop) whenever you use the Auto-Navigation feature. This ensures the map data is “locked in” and stable, preventing errors that can occur if the robot tries to navigate while still updating the map.
- Switch to Navigation: Simply tap Start Nav to begin navigating within the map you just created.
Note: The actual navigation instructions continue below in the next section.
9.6 Autonomous Navigation
9.6.1 Prerequisite
Ensure the mapping process is completed before starting autonomous navigation.
9.6.2 Initialize Navigation
- Tap Start Nav.
Note: Wait up to one minute for the cost map to load.
Info: The mapped area turns blue, indicating the Cost Map, which defines safe navigation zones. Wait until the map turns blue before setting a navigation goal.
Scenario A: Navigation on a Live Map (Use this mode if you skipped “Stop Map” to continue updating the environment)
Scenario B: Navigation on a Saved Map (Use this mode for stable navigation on a finalized map)
9.6.3 Set a Target
- Select Destination: Tap on the map or drag the target marker to your desired location within the blue zone.
- Initiate Movement: Release the marker to confirm the position. The robot will automatically calculate the route and begin moving.
Note: The process is the same for both Live and Saved maps.
9.6.4 Monitor Progress
A green line represents the planned navigation path, and the robot icon moves along this path in real time.
9.6.5 Arrival and Completion
When the robot reaches the destination, a Goal Reached message is displayed. Tap Stop Nav to end navigation.
9.7 Adding Named Locations
- Navigate the robot to the desired location.
- Enter a name for the location.
- Tap Add Location.
Info After saving, the robot moves toward the location when the location name is spoken in AI Mode.
