CITRIC Quick Start Guide

Powering the Cameraboard

Switch the power switch towards the left to enable power from USB. Switch the power switch towards the right to enable power from the AC adaptor or battery pack. The AC adaptor should output 5V DC. The battery pack may be soldered on by attaching VCC and GND to the proper terminals as shown in the picture above.

Focusing the Lens

Optimal focus is usually achieved by tightening the lens completely, then loosening it by 1 1/4 turns. However every lens is different and this is just a general guideline.

Once the power switch has been properly set, the board is turned on by pressing the power button. The board is turned off by switching the power switch to the other position.

Installing the Cameraboard Driver

Installation of the driver is only necessary in Windows.

  1. Connect the cameraboard with a USB cable and turn it on
  2. Windows will open the "Found New Hardware Wizard" window
  3. Select "Install the software automatically"
  4. The wizard should correctly install the "CP2101 USB Composite Device"
  5. Windows will open another "Found New Hardware Wizard" window
  6. Select "Install the software automatically"
  7. The wizard should correctly install the "CP2101 USB to UART Bridge Controller"

Connecting to the Cameraboard

We can connect to the cameraboard using a terminal emulator program, such as Hyperterminal (Windows) and Minicom (Linux). The modem settings should be set as follows:

baud rate115200
data bits8
paritynone
stop bits1
flow controlnone

Once the cameraboard is connected and powered on, it can be accessed through a COM# port in Windows (the COM port number # can be determined by looking at Control Panel->System->Hardware->Device Manager->Ports), and through /dev/ttyUSB# in Linux (where # is a number assigned to the board, usually 0 if there are no other boards or motes connected).

Using the Cameraboard

The provided root filesystem boots to a bash prompt and starts in the /tmp directory, which is the only writable directory in the filesystem. All user applications must be uploaded here, and all user generated files must be written here. The most common and useful commands in this environment are:

Configuring Motes

Telosb motes running TinyOS are used in the CITRIC platform. There are 2 TinyOS applications provided, citric_base and citric_mote, found in the tos/apps/citric directory. The basestation running the citric_base app must be configured with a mote id of 0. The motes running citric_mote must be configured with a mote id from 1-254.

The FTSP time sync mote is located in tos/apps/citric/citric_mote_ftsp. The motes will automatically sync their times initially upon bootup, indicated with a flashing green LED. The time sync process must be stopped before it can be used with CITRIC. This can be done by pressing the user button on the basestation. Once the time sync process has been stopped, the blue LED of each mote should be on, at which point the mote is ready to function as normal.

Attaching a Mote

The camera board has a 10-pin header which connects directly to the 10-pin header the mote when attached from above. However, the two I2C pins must not be connected - their locations can be seen in the figures above. Once connected, the mote will draw power from the camera board, so the mote should not be connected to any power source (USB or battery).

Running a Demo Application

  1. Once the cameraboard has been powered on, send the demo executable (ie. demo_bgsub) using the Zmodem protocol
  2. Once the transfer is complete, type ch to change the file permissions (HyperTerminal only)
  3. Type ./demo_bgsub to run the application. Or type ./demo_bgsub -- for a list of program flags

See the demo application page for more details.

Running the Server

The server is a Visual Studio app, located in the server/BIN/C-Server2 directory. Pleas read the readme in server/HSN for more documentation about the server.