cagebot control

trike robot

quick start guide

revision 1.3
Manual date: 17.12.2015. The latest version can be downloaded from our website:

www.cagebot.com

overview
1. loading "cagebot control" 3
2. connect with cagebot 3
3. starting "cagebot control"

4. configurator:
checking motors & sensors

5. remote control 10
6. the motion editor 12
6.1. general 12
6.2. writing a simple program
14
6.3. context-menu 15
6.4. save your program 16
7. updating "cagebot control"

17

8. mobile apps: "android & ios"

18

1. loading "cagebot control"

load the program via:
1. windows & mac os x

1.

usb flash drive (incl.)

2. download via:
www.cagebot.com
2. android & iOs
available for free in app-stores.

2. connect with cagebot

in order to communicate with your cagebot, it
needs to be connected with the device you want
to use. This works with wifi or usb connection.
the cagebot wifi-name is similar to:

cagebotX_XXXX

3. starting "cagebot control"

1. start software
click on the cagebot control program icon:

Cagebot Control

2. check connection status

the wifi icon in the upper right corner of the menu
needs to be green. this means that your cagebot is
correctly connected with your device.

connected
disconnected

4. configurator:
checking motors & sensors
This chapter will be explained using the example
of the trike but can be applied to other cagebots
accordingly.
1. click on cONfigurator-button
remote control
motion editor
code editor
configurator
wifi

2. click on terrain-button

terrain-robot settings

motor settings

sensor settings

firmware update

back

3. general settings

2.
3.

1.

1. "config..."

needs to be highlighted in
light blue. your cagebot is displayed
from top view.

2. sensor-address:

if a sensor is
connected, it needs an address.

3.

motor address: each motor needs

his own address. (e.g. 51 und 52)

4.

upload-button:
configuration

4.

activates

the

4. checking motor addresses

1. motor - left side (M1)
by clicking on the white arrow the
left wheel of your robot drives
forward. If it does something else,
you need to assign the correct
address (see Point 5.).
if the wheel does not turn at all,
check its wire connections first.

2. motor - right side (M2)

by clicking on the white arrow the
right wheel of your robot drives
forward. If it does something else,
you need to assign the correct
address (see Point 5.).
if the wheel does not turn at all,
check its wire connections first.

5. setting the motor address

for example: if the left wheel drives forwards instead
of the right wheel, you need to assign the correct address.
1.

step 1:
check If the motor addresses are either
interchanged or not working at all.

Step 2:
setting the correct motor address.

2.

step 3:
click on upload-button at lower left, to
transfer the new adress to the cagebot
controller.

step 4:
3.

address are now updated.

step 5:
check again if the addresses are correctly
set now.

info box
cagebot control operates with the real addresses of
the bus system.
the motor addresses start at no. 51 and the sensor
addresses start at 1.
the addresses can be assigned randomly, but do not use
the same address twice at the same time.

6. assignment of addresses in general

in the configurator, sensor and motor addresses
can be changed optionally. the double usage of an
address should be avoided. lets have a look at the
sensor as an example:

sensor

1a.
2.

motor

important:
"Connected" needs to be highlightes in blue.

Step 1 - "Check Sensor":

click "OK" (1a.) to view a Liste of all plugged
in sensors. the list is displayed on the left
side (1b.).

step 2 - "change sensor address":

1b.
3.

here (2.), you can change the address.

1. "from": choose the address you want to
change.
2. "to": set the new address.
3. click on "OK" to confirm the changes.

Step 3 - "Check sensor":

4.

here (3.), you can check if the addresses

have been changed. click "OK" and check the
sensor-adress-List (4.).

info box
the setting of motor addresses is the same.

7. testing the sensors

the sensor should be tested first to ensure that it is
working properly.

1. hold a hand directly in front of the sensor attached to the

cagebot robot.
2. if the sensor works correctly, the green sensor-symbol in
cagebot control will appear.
If the green sensor-symbol does not appear, check if the wire is
plugged in and if the address is correctly set up.

info box
for further information and how to handle certain
issues, please visit our website:

www.cagebot.com

5. remote control
the remote control enables you to control your
cagebot without any prior programming.
1. open main menu
2. click on remote control
-> control panel opens

1. windows & Mac os x

1. direction keys.
2. speed control:

with the current

setting your cagebot will drive
with 25% of its maximum speed.

1.

3.
2.

4.

3.

gamepad-buttons: executes preprogrammed functions.

4.
5.

submenu

5.

remote-button: needs to be
highlighted in light blue (active)

actions
forwards

left

backwards

right

10

stop

gamepad-buttons
Steering Commands

2. steering in windows & mac os x

1.

via buttons on screen

2. xbox 360-controller (needs to be plugged in before

starting cagebot control)
3.

via key pad: w-a-s-d & arrow keys; space for stop

11

6. the motion editor

the motion editor is where you can graphically
program your cagebot.

6.1. general
1. open main menu
2. click on motion editor

die oberflche ist in 3 bereiche

the surface is devided
unterteilt:

a b

into three areas:

a. linke
leiste: bar:
funktions-module,
command
functionber "weiter"
kommt
man zu
modules; via
"next" further
functions
are available
weiteren
funktionen

b
c

box-table:
area for
b. box-tabelle:
programmier-bereich
programming

c. untere leiste:
bottom bar:
control area &
kontrollflche
& seitenansichten

page views

left bar
function-modules are easily being dragged and dropped from the
bar directly into the intended boxes.

forwards

left

backwards

right

stop

12

left bar
timer:

program-end:

waits the defined time in

the active box

ends the program

jumper:

trash bin:

jumps into a chosen

function-box

sensor:
waits until the sensor is
being activated
(further functions via the
context-menu by double
clicking on the symbol)

1. mark function boxes that

will be deleted
2. click on trash bin
-> function boxes will be
deleted

motor:
driving a chosen motor

bottom bar
menu:

upload-button:

for further functions

for uploading the program

to the cagebot-controller

"view":
allows to choose between two
different function-views

start-button:

"box 1":
status. displays active or chosen
box.

starts the program on

your cagebot. in order to
use your latest program
upload first.

"page" (a-f):

pause-button:

letters: displays active program.

enables the storage of several
programs with each 200 boxes.

pauses program

stop-button:
1. stops program
2. stops upload

back to main menu

13

6.2. writing a simple program

the example of this short program is meant as an
introduction into the programming principles of your
cagebot.

1.

2.

3.

4.

1. box 1 contains the sensor-function. here, the program

waits until sensor 1 is being activated. then the program
continues.
2. after sensor 1 in box 1 is being activated, box 2 will be
executed. box 2 comands the cagebot-controller to drive
forwards with 20% of its maximum speed.
3. after the execution of box 2, box 3 will be activated. here,
the program will wait in box 3 as defined in box 3. in this
example, the cagebot will drive forward for 20 seconds
with 20% of its maximum speed.
4. after box 3 box 4 will be executed. In this case, the cagebot
will stop and the program will end.

14

6.3. context-menu
here, you can change the settings of the functionboxes, in order to change function behavior. you have
the option to colour the boxes. the colouring can
help you to structure the program you are writing,
e.g. sub-programs can be highlighted and be found
faster and easier. additionally, colouring enables a
jump of the program to highlighted boxes via a jumpfunction, e.g. with the jumper- or sensor-function.
1. if the sensor is
activated, the program
will jump to the red
sub-program
2. the red program is
being executed
3. in the red box, the
green jumper (rabbit)
jumps to the green box
with the white jumper.
4. in the green box the
white jumper jumps to
box 2.
5. now, the rest of
the program will be
executed and stopps at
the end.

< example: sensorcontext-menu

15

6.4. save your program

with the "save" and "load" buttons you can store
your programs and files, and share them with other
cagebot users.
1. open motion editor
2. click on "menu"

storing:
1. click on "save"-icon
2. choose the target folder
and name the program.
3. click on "OK"

loading:
1. click on the "load"-icon
2. choose a file
3. click on "OK"

16

7. "cagebot control" update

we recommend to update the cagebot software
regularly.
1. open main menu
2. click on "menu"
3. click on "update"

1.

if you receive a notification

with a "firmware" update,
you also need to update your
cagebot controller in order
to ensure to have the latest
software:
1. click on configurator

2.

2. click on cagebot firmware

update

3.

3. a window opens. as soon

as you have plugged in the
usb-cable into the cagebotcontroller and connected
it with your device, click on
"upload"
4. done.

17

8. mobile apps: "android & ios"

all in all, the handling of cagebot control in
android and ios is very similar to windows and
mac os x.
1. loading "cagebot control":
available for free in app-stores.

2. connect with cagebot:

the cagebot wifi-name is similar to:

cagebotX_XXXX
3. Starting "cagebot control"
a. start software
click on the cagebot control program icon:

Cagebot Control

18

b. check connection status

the wifi icon in the upper right corner of the menu
needs to be green. this means that your cagebot is
correctly connected with your device.
connected
disconnected

4. remote control
the remote control enables you to control your
cagebot without any prior programming.

1. open main menu

2. click on remote control
-> control panel opens

19

a. steering
Steering in android and ios is similar to windows and
Mac os x.
1.

3.
2.

4.

1.
2.
3.

direction keys
speed control
gamepad-buttons

5.

4.

steering:
left - right

5.

accelerate / brake

actions
forwards

left

backwards

right

stop

gamepad-buttons
Steering Commands

20

5. the motion-editor
a. starting the motion editor

1. open main menu

2. click on motion editor

b. the surface of the motion editor

a

the three areas of the motion editor

a
b
c

command bar: commands

box-table: area for programming
bottom bar: control area & others

21

c. the handling
handling

command bar:
scrolling: touch field and shortly wipe up or down
to view all commands.
Choosing and placing a command: choose a
command, touch and hold it a second, and while
holding it, move it to the applicable box in the boxtable.

box-table:
scrolling: touch field and shortly wipe up or down,
to the right or left to view all boxes.
open the context-menu: double-click a command
in the box-table. (please note, that there are no
coloured markers available.)

bottom bar: control area & others

upload-button:
for uploading the program
to the cagebot-controller

trash bin:
1. mark function boxes that
will be deleted
2. click on trash bin
-> function boxes will be
deleted

back to main menu

22

start/stopbutton:
1. starts program
2. stops program

Copyright by CaGEBOT industries Gmbh

www.cagebot.com