1.1. Getting Started

1.1.1. Prerequisites

Need a running version of Ubuntu 14.04 LTS or above. Ubuntu in a virtual machine such as VirtualBox or VMPlayer will work as well.

Note

The it is possible to get SJSU-Dev-Linux to work completely on Windows and Mac OSX if you have all of the necessary PATH dependencies installed, but that is not covered here. You will need to manually install all of the necessary components in the installer script.

1.1.2. Installation

Step 1

Clone the repository

git clone --recursive https://github.com/kammce/SJSU-DEV-Linux.git
Step 2

Change directory into SJSU-Dev-Linux

cd SJSU-DEV-Linux
Step 3

Run setup script.

./setup

Warning

Do not run this script using SUDO. The script will ask you for sudo permissions once it runs.

Note

This will install gtkterm, mono-complete, and gcc-arm-embedded packages

1.1.3. Building and Loading Hello World Application

Step 1

From the root of the repository

cd firmware/default
Step 2

Run build script. A HEX file bin/HelloWorld/HelloWorld.hex and subsequent folders should have been created after this script finishes.

./build HelloWorld

Note

use the --help argument to get additional information on how to use the build script.

Step 3

To load the hex file into your SJOne file you will use the hyperload.py file. Run the following:

./hyperload.py /dev/ttyUSB0 bin/HelloWorld/HelloWorld.hex

The first argument is the path to the serial device. The second argument is the hexfile to load into the SJOne board.

Step 4

To view serial output, run GTKTerm by using the following command:

gtkterm -p /dev/ttyUSB0 -s 38400
How to use GTKTerm
  1. Set CR LF Auto to true by going to the Main Menu > Configuration > CR LF Auto and click on it.
  2. Press F8 (Clears RTS signal), then press F7 (Clears DTR signal) to start SJOne.
  3. You should see the board counting up on the 7-Segment display and in binary on the LEDs.
Step 5
Done!!

1.1.4. Building and Loading FreeRTOS Project

Instructions are the same as HelloWorld, but you need to change the run the build script’s last argument to FreeRTOS rather than HelloWorld.