← back to Autocrawler Contents

Autocrawler - Command Reference

The following listing is of text commands used by clients (javascript, mobile, and telnet clients) to communicate with the Autocrawler server application. They can be grouped into the following categories:

Camera and Lights
MALG board
Server Application
Operating System

You can enter any command directly thru the web-browser remote interface:

MENU > advanced> telnet text command

OR, press ‘C’ at any time to get the same telnet text command prompt.


move left | right | forward | backward | stop
Wheel motors, continuous movement

nudge left | right | forward | backward
Move for amount of milliseconds (specified by ‘nudgedelay’ setting)

speed slow | med | fast OR {INT}
Set drive motor speed, either pre-set slow/medium/fast speeds, or set PWM directly with [0-255]

clicksteer {INT} {INT}
Camera tilt and drive motor movement macro to re-position center of screen by x,y pixels

motionenabletoggle (no arguments)
Enable/disable wheel motors

forward {DOUBLE}
Drives the robot forward by the specified distance, in meters, then stops. Determined by the onemeterdelay setting, or if odometry is running by the odomlinearmpms state variable if set

backward {DOUBLE}
Drives the robot backward by the specified distance, in meters, then stops. Determined by the onemeterdelay setting, or if odometry is running, by the odomlinearmpms state variable if set

left {INT}
Rotates the robot left by the specified angle, in degrees, then stops. Determined by the fullrotationdelay setting, or if odometry is running, by the odomturndpms state variable if set

rotate {INT}
Rotates the robot right by the specified angle, in degrees — left is positive, right is negative. If odometry is running and the odomturndpms state variable is set, will progressively turn incrementally for high accuracy. Otherwise uses fullrotationdelay setting

lefttimed {INT}
Rotates the robot left, stopping after the specified amount of milliseconds. Timing is done by the MALG microcontroller, good for very small movements

righttimed {INT}
Rotates the robot right, stopping after the specified amount of milliseconds. Timing is done by the MALG microcontroller, good for very small movements

forwardtimed {INT}
Moves the robot forward, stopping after the specified amount of milliseconds. Timing is done by the MALG microcontroller, good for precise movements

odometrystart (no arguments)
Enables gyro and encoder recording, resets counters to 0

odometryreport (no arguments)
Sends request for linear and rotational distance moved. Result is written to distanceangle state variable, counters are reset to 0

odometrystop (no arguments)
Sends request for linear and rotational distance moved, then disables gyro and encoder recording. Result is written to distanceangle state variable

calibraterotation (optional) left | (optional) right
Runs macro to auto-calibrate gyrocomp setting using camera and dock target. Direction is left unless specified.
Robot should be approximately 1m in front of dock.

arcmove {DOUBLE} {INT}
Turn while travelling, for example:

arcmove 1.2 30

will move forward 1.2 meters while turning counter-clockwise 30 degrees. Use a negative angle value to turn clockwise. Turn radius accuracy can be calibrated with arcmovecomp setting


cameracommand stop | up | down | horiz | downabit | upabit | reverse
Camera/Lights assembly tilt servo movement

camtilt {INT}
Camera/Lights assembly tilt servo, move to specific angle [0-180]

spotlight {INT}
Set main spotlight intensity, percentage [0-100]

floodlight {INT}
Set rear flood light (docking light) intensity, percentage [0-100]

strobeflash on | off (optional) {INT} (optional) {INT}
Turns strobe flash on or off with required ‘on|off’ parameter, and optionally followed by duration (milliseconds), intensity (percentage). Examples:

strobeflash off <= turns strobeflash off
strobeflash on 500 30 <= turns strobeflash on for 500 ms at 30% intensity


malgreset (no arguments)
Resets the MALG PCB

getdrivingsettings (no arguments)
Returns drive motor calibration settings (in bulk string form – intended for web browser interface)

drivingsettingsupdate {STRING}
Set drive motor calibration settings (in bulk string form – intended for web browser interface)

malgcommand {STRING}
Send byte sequence commands directly to the MALG PCB, in the form of:

{CHAR} single ASCII character, followed by one or more [0-255] separated by spaces

See the latest MALG firmware for the complete list of available commands, listed at the top in comments.


publish camera | camandmic | mic | stop
Robot video/audio control

streamsettingsset low | med | high | full | custom
Set robot camera resolution and quality

streamsettingscustom {STRING}
Set values for ‘custom’ stream: resolutionX_resolutionY_fps_quality

framegrabtofile (optional) {STRING}
Saves a frame from the current camera stream to a JPG file with time/date stamp as filename. Saved to the folder: 'autocrawler/webabpps/autocrawler/framegrabs'
Outputs URL to telnet stream and message window
Optional {STRING} sets frameGrabHTTP developer parameter


driverexit (no arguments)
Disconnect/end driver RTMP connection with robot

disconnectotherconnections (no arguments)
Close all user RTMP connections other than current driver

who (no arguments)
Returns information on current driver connected via RTMP (eg., flash/web/mobile clients), and number of users connected via telnet

loginrecords (no arguments)
Returns list of RTMP driver (eg., flash/web/mobile clients) login history for current server session

chat {STRING}
Send text chat to all other connected users

messageclients {STRING}
Send text to all other connected users. Similar to ‘chat,’ but without preceding user info


dock (no arguments)
Start manual dock routine (creep backward until dock connects)

autodock go | cancel
Start/quit auto-docking routine. Camera must be running

redock (optional) noforward
Used by system if dock connection is weak, or unexpected un-dock.
Moves forward, turns on camera and floodlight, reverses tilt, checks for dock in view and engages autodock routine. If not in view, rotates until found. If not found, or otherwise unable to dock, posts alert to RSS and sends email. Use noforward parameter to skip initial forward move

battstats (no arguments)
Returns contents of state variable batteryinfo. Extended power information including individual cell voltages, system volts, current draw.

powerreset (no arguments)
Resets Xaxxon Power PCB

powershutdown (optional) {INT}
This will cause the OS to shut down gracefully, then the Xaxxon Power PCB will kill power to the system within 30-60 seconds. Requires unit to be in un-docked state.
Adding the optional parameter will cause the system to power back up again after the specified number in seconds

powercommand {STRING}
Use to send firmware commands to Xaxxon Power PCB


uptime (no arguments)
Returns time in milliseconds since the server application started

restart (no arguments)
Restarts the server application

quitserver (no arguments)
Quits the server application

showlog (no arguments)
Returns partial output of oculusPrime/logs/jvm.stdout

writesetting {STRING} {STRING}
Uses format: key value
Write setting to configuration file autocrawler_settings.txt

readsetting {STRING}
Uses format: key
Reads and returns setting from configuration file oculus_settings.txt

settings (no arguments)
Dump bulk list of all settings to message window and telnet stream

log {STRING}
Write text to log file (can be used by scripts)


systemcall {STRING}
Execute OS system command, with ‘oculusPrime/’ as the current working directory

setsystemvolume {INT}
Set robot operating system audio volume 0-100

reboot (no arguments)
Reboot the operating system

systemshutdown (no arguments)
Shut down the operating system (halt)

memory (no arguments)
Returns percent used, total memory, and free memory in use by the Java Virtual Machine. NOTE: JVM memory is not to be confused with system memory totals.

cpu (no arguments)
Writes current CPU utilization percentage to cpu state variable

waitforcpu (no arguments)
Sets state variable waitingforcpu to 'true', until CPU usage is below threshold (typically 60%, with a timeout of 20 seconds), whereupon state waitingforcpu will be set to 'false"

networkconnect {STRING}
Connects to wifi network with ssid {STRING}. Headless Wifi Manager app must be running

gotowaypoint {STRING}
Starts up navigation system (if not running) and sets waypoint {STRING} as the new navigation goal

startnav no arguments
Starts up the navigation system. State variable navsystemstatus is set to 'starting' while initializing, and 'running' when ready

startmapping no arguments
Starts up the navigation system in make-map mode. State variable navsystemstatus is set to 'starting' while initializing, and 'mapping' when ready

stopnav no arguments
Quits the navigation (and mapping) system. State variable navsystemstatus is set to 'stopping' while shutting down, and then 'stopped'

gotodock no arguments
Sets the 'dock' waypoint as the new navigation goal. Upon reaching it, navigation is shut down and auto-dock is initiated

runroute {STRING}
Sets route with the name {STRING} as the active route

cancelroute no arguments
Cancels any active route

savemap no arguments
Saves map currently generated by mapping system to file, overwriting any existing map after saving to backup

roslaunch {STRING}
Loads the ROS environment and launches the autocrawler_ros {STRING}.launch file by executing the ‘autocrawler/’ system command

savewaypoints {STRING}
Primarily used by javascript to write {STRING} to the rosmapwaypoints state variable, and also to the 'autocrawler/conf/waypoints.txt' file

saveroute {STRING}
Primarily used by javascript to write XML data {STRING} to the 'autocrawler/conf/navigationroutes.xml' file


getlightlevel (no arguments)
Returns average pixel greyscale value (0-255) of frame from current stream

motiondetect (no arguments)
Enables motion detection mode, with sensitivity set by the motionthreshold setting. Camera must be running. Detections write to the streamactivity state variable

motiondetectcancel (no arguments)
Cancels motion detection mode

objectdetect {STRING}
Enables object detection mode. Currently supports 'human' as object type {STRING}
Camera must be running. Triggers write to streamactivity state variable

objectdetectcancel (no arguments)
Cancels object detection mode

sounddetect true | false
Call with 'true' to start sound detection, for use when setting useflash is set to FALSE. Call again with 'false' to cancel


speech {STRING}
Voice synthesizer

email {STRING}
Uses format: email-address [subject] body
Send email to email-address, with subject [subject] and body text body

email [Test email] This is an email test
Uses mail server settings specified in autocrawler_settings.txt configuration file values for ‘email_smtp_server, email_smtp_port,’ (and ‘email_username, email_password’ if required)
Tip: To use Gmail to send mail: set the server to ‘,’ port to 587, and use Gmail username and password

state (optional) {STRING} (optional) {STRING}
Uses format: key, or key value, or delete key
If called with no arguments: returns list of all non-null STATE variables
If called with one argument: returns value for single key
If called with two arguments: sets key to value
If called with arguments ‘delete key’: sets key value to null

quit (no arguments)
Disconnect current telnet session (telnet connection only)

rssadd {STRING}
Uses format: [title] description
Adds an item to Oculus Prime RSS feed XML file: autocrawler/webapps/autocrawler/rss.xml (creating it if not already present). Feed is publicly view-able via web url:

CART 0 items | US$
    Check Order Status
Follow →
instagram twitter facebook youtube
@XaxxonTech Twitter
© 2022 Xaxxon
Products Documentation Downloads Source Code
Warranty & Returns About Us Contact/Support News
instagram twitter facebook youtube