Bittle X Simulator
Your first hour with the Bittle X simulator
No install required. No robot needed. This guide walks you through making the robot stand, move, recover from a fall, and understand how simple commands become robot behavior.
Quick start: make Bittle X move
-
1
Open the simulator
Wait until the loading message disappears and the robot scene is visible. Click mode to switch between control mode and coding mode.
-
2
Put the robot in a known pose
Click STAND. If the robot is tilted, twisted, or lying down, click RECOVER first, then STAND.
-
3
Try keyboard movement
W A S D — forward, turn left, backward, turn right. Tap one key at a time first.
-
4
Reset when things get messy
Click Reset if the scene or robot pose becomes confusing. Resetting is completely normal while learning.
-
5
Send a simple command
Type a command in the input box and click Send. Start with the built-in movement buttons before using manual input.
What am I looking at?
The robot
Bittle X is a quadruped — four legs, each with motorized joints. A walking pattern is called a gait. Standing, walking, and turning all move many joints in coordination.
The simulator
A safe practice space. Test movement ideas without worrying about battery, floor friction, or the robot falling off a table.
What do the controls do?
| Control | Use it when | Beginner tip |
|---|---|---|
| New Project | You want a clean coding workspace | Use before starting a new lesson or experiment |
| New File | You need another file inside the current project | Most beginners can ignore this until projects grow larger |
| Files | You need to switch between saved project files | Name files by behavior: walk-test, turn-practice |
| Compile | You want the simulator to check and prepare your code | If it fails, read the first error message slowly |
| Reset | You want to restart the simulation state | Fastest way to recover from a confusing experiment |
| W A S D | You want direct movement control | Use short taps before holding a key down |
| RECOVER | The robot has fallen or is in an unstable pose | Recover first, then stand before trying to walk |
| STAND | You want the robot ready for movement | Best starting pose for most tests |
| Send | You want to send a manual command | Use after you understand what a command is expected to do |
Robotics basics in plain language
Pose
The current body and leg position — standing, lying down, etc.
Joint
Where a robot leg bends. Motors rotate joints to create motion.
Balance
Keeping the body supported while legs move. Fast commands can break it.
Gait
A repeated walking pattern — can be slow, stable, fast, or playful.
Command
A short instruction: stand, walk, turn.
Compile
Checks code and prepares it so the computer can run it.
Coding basics for robot learners
-
1
Start with one action
Make the robot stand. Don't combine walking, turning, and custom commands yet.
-
2
Observe the result
Did it do what you expected? Did it start from the pose you expected?
-
3
Change only one thing
If you change many settings at once, you won't know which change helped or hurt.
-
4
Use clear names
Save projects as first-stand, forward-test, or recover-practice.
Suggested first lessons
Stand and recover
Click STAND, then RECOVER, then STAND again. Learn the difference between a pose and a recovery action.
Move in short bursts
Tap W three times. Reset. Tap D three times. Compare forward movement and turning.
Build a tiny routine
Click New Project. Edit the loop in main.ino with a different motion sequence. Compile and run it.
Debug and send commands
When something fails, note the starting pose, the command used, and what happened. Then try commands like:
- ksit
- m0 -30 0 30
- kbalance
- kwkF
- ktrL