SJSU-Dev2

Cross platform firmware framework written by students, alumni, and faculty of San Jose State University. Designed for the original purpose of helping students develop firmware for the SJTwo board.

Operating System Supported

Built for Ubuntu (18.04 or above), Mac OSX (High Sierra or above), and Windows 10 WSL.

Quick Start

Setting up the environment

If you are using Windows, follow these steps to install WSL and make sure to install the Ubuntu as the linux distro. Once you have installed WSL, all instructions below for Linux should work for Windows.

To download and setup the environment, simply copy and paste this into a terminal:

git clone https://github.com/kammce/SJSU-Dev2.git
cd SJSU-Dev2
./setup

If you find that git is not installed on your machine follow these steps to install GIT.

Building a Project

The starter hello_world project can be found in the projects/ folder along with the the demos/ folder which is full of examples you can run on your board. To build hello_world :

cd project/hello_world
make application

Programming a board

From within a project, run make flash.

If make flash is not available for your platform, then you can try make jtag-flash DEBUG_DEVICE=<jlink|stlink|etc> PLATFORM=<insert platform here> if you have a JTAG or SWD debugger.

Full Documentation and Installation Guide

Full Documentation
Library APIs

Using a Prebuilt Virtual Machine

One of the easiest ways to get started with SJSU-Dev2 is to use a VM with all of the software installed.

Steps to install virtual box and the virtual machine are listed below:

Download and install Virtualbox and then the "VirtualBox Oracle VM VirtualBox Extension Pack" on your computer from this link: https://www.virtualbox.org/wiki/Downloads
Download the prebuilt virtual machine: Ubuntu SJSU-Dev.ova
Open "Ubuntu SJSU-Dev.ova" and import into VirtualBox.

Using the Virtual Machine

Open the "Ubuntu SJSU-Dev" Virtual Machine on the left hand side.
Login by entering the password "osboxes.org"
To program your board, you will need to connect it to your host machine and bring it into the virtual machine by using the top menu: Devices > USB > CP2102n...
At this point you can run commands like make application and make flash from within the SJSU-Dev2 folder which is located /home/osboxes/SJSU-Dev2

Viewing Serial Output

The preferred method for communicating with a serial device is via Google Chrome, using the online serial terminal tool, Telemetry. You can also open this up on your browser using the make telemetry command in a project directory.

Supported Processors

Processor/OS	InterruptController	SystemTimer	CycleCounter
RISCV 32I	☒	☒	☒
Arm Cortex M4F	☑	☑	☑
Arm Cortex M3	☑	☑	☑
Embedded Linux	-	-	-

Supported Platforms

☑ = Supported
◯ = Partially supported
☒ = Not supported but available
- = Not available on microcontroller

Processor/OS	MCU/SOC	SystemController	Gpio	Uart	Adc	Pwm	I2c	Spi	Dac	Timer	Can	Flash	Watchdog
Arm Cortex M4F	lpc40xx	☑	☑	☑	☑	☑	☑	☑	☑	☑	◯	☒	☑
Arm Cortex M3	lpc17xx	☑	☑	☑	☑	☑	☑	☑	☑	☑	◯	☒	☑
Arm Cortex M3	stm32f10x	☑	☑	☑	☒	☒	☒	☒	☒	☒	☒	☒	☒
Arm Cortex M4F	stm32f4xx	◯	☑	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒
RISCV 32IMAC	gd32v10x	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒
RISCV 32IMAC	gd32v10x	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒
Linux	any	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒	☒

Manutronics/SJSU-Dev2-WorkingCopy