Skip to content

Software: Overview

Jump to bottom Edit New page
justinjessada edited this page Oct 1, 2013 · 17 revisions

The system software is made up of two main components: the web browser GUI or client, which is used to control and interact with the experiment, and the server-side software, which directly runs the experiment and its attached webserver. A software system diagram is shown below:

Software systems

[Terminology] (https://github.com/szmoore/MCTX3420/wiki/Software:-Terminology)

Web GUI (Client)

The web GUI runs in a browser on the client PC and performs three main tasks:

  • Remote interface
    • Allows the user to control the experiment hardware remotely
  • Data processing
    • Allows the user to access and download experimental data and perform some simple processing
  • Security
    • Ensures that only authorised users can access the hardware

Any existing web browser can be used as a client - you can just manually type in the appropriate URL to control the system. You are also not restricted to using a certain browser, as any software that understands the HTTP protocol could be used. The GUI has been written in Javascript and HTML and provides a human-friendly interface to the server API functions which are used to interact with the system.

For more information on how to use the Web GUI, see here:

For more information on the actual GUI code, see here:

Server

The server runs on the BeagleBone and performs four main tasks:

  • Hardware control
    • Reading input pins to get data from sensors and actuators
    • Writing output pins to control actuators
  • Camera control
    • Taking images from the two cameras and performing the appropriate processing
  • Data collection/transfer
    • Recording sensor data, storing it, and transferring it to the server
    • Getting actuator data, storing it, and implementing it in the system
  • Server control
    • Running a webserver to act as an remote interface between the user and the system

An existing HTTP server called http://wiki.nginx.org/Main runs on the system. Nginx has all the features of a standard HTTP server; it can provide web browsers with HTML files and JavaScript. Our server runs as a FastCGI process. Nginx has been configured to pass all requests to a URL starting in "/api" to our server through FastCGI, and the server sends the appropriate response to Nginx, which then relays it back to the client.

For more information on directly using the server API, see here:

For more information on the actual server code, see here:

Add a custom footer
Add a custom sidebar
Clone this wiki locally