Getting started on controlling LocoKit

Using the LocoKit Software

A) Connecting to LocoKit using WiFi

After LocoKit powers up, which takes about a minute, it connects to a predefined Wi-Fi network. You should connect your computer to the same network.

B) Connecting to LocoKit using a USB cable

Connecting using a USB cable is a backup option as it does not allow access to the web interface, but only a shell similar to connecting to LocoKit using SSH described below. You may need a USB driver for your operating systems - drivers can be found here for Windows, Linux, and Max OS X: Please install this first. Secondly, you need a terminal program to communication with LocoKit over the USB cable (for Mac OS X and Linux minicom is useful). Once you have a communication program installed, figure out to which terminal device LocoKit connected. This is discovered by typing "ls /dev/tty*" at a commend prompt and look for something along the lines of tty.usbserial-XXXXXXXX, ttyUSB00x or ttys000x where x is a small number (typically, 0 or 1) and is X is a letter or a numer. Once you have discovered this start your communication program (minicom -s) and set parameters to connect to the terminal to which locokit is connected and use the following parameters: 115200 8N1 and no hardware or software flow control. You should now get a login prompt to type username and password. If not just press return. The username is "root" and there is no password (press enter). You can now skip to the "Example source files, editing, and running" section. Another option is to use the terminal to setup the WiFi network of the module to give you access. If you want to make changes to the network configuration the file to look for is /etc/network/interfaces.


Opening the LocoKit Web Interface

After succesfully completing the steps above your computer and LocoKit are on the same network and you can now start to interact with LocoKit.

The first step should be to open the LocoKit web interface. Open your favorit web brower and enter the IP address of your LocoKit robot into the address line and press return (e.g. This should immediately open up the LocoKit web interface.

Connecting to LocoKit using SSH

When LocoKit and your computer are on the same network you can use ssh to login to Linux running on Locokit. From a command shell you type "ssh". When asked for password just press return - no password. You are now given a standard Linux command prompt.

Example source files, editing, and running

It is important to notice, that all compilers and editors you may require to program and compile software for the LocoKit are installed on the system. You will therefore not need any compilers, editors on your computer to start working. Only a SSh client is required. So just go ahead and log in to the system via SSH as described above.

Once you are logged into LocoKit, you can navigate to the /examples/source ("cd /examples/source") directory to see some code examples of how to program LocoKit in C. Several editors are installed e.g. mec readSensors.c (exit: ESC-z). The examples can be compiled by using Make ("make all"). The executables are put in /examples/bin where you can find and execute them (./readSensors).

Read more about programming LocoKit in the API section