SCuM-V Bringup & Development

Development toolkit for the Single-Chip Micro Mote V (SCμM-V) system-on-chip (SoC).

This repository contains FPGA controllers, host software, firmware, and documentation used in bringup.

Quick Start

Hardware Setup →

Complete guide for setting up your SCuM-V development environment with FPGA boards and level shifters. Includes equipment checklist, PCB connections, and power supply configuration.

FPGA Programming →

Program the Arty A7 FPGA with SerialTL controller and analog scan chain interfaces. Covers Vivado project setup, bitstream generation, and simulation.

Firmware Development →

Develop and flash RISC-V firmware for the SCuM-V chip using our BSP and examples. Includes toolchain setup and debugging tools.

Bootloading Guide →

Use Python host tools to communicate with SCuM-V via SerialTL and analog scan chain. Programming and debugging the chip.

Technical Documentation

Core Systems

System Overview - Architecture and block diagrams
Digital Core - RISC-V processor and memory system
Digital Baseband - Wireless communication modem

Analog Subsystems

Power System - DC-DC converters and voltage regulation
Clock Generation - Oscillators and timing systems
2.4 GHz Radio - Wireless transceiver front-end
94 GHz Radar - High-frequency radar system
Precision ADC - Sensor interface and data acquisition

Development Resources

API Reference - SerialTL commands and register maps

- - src/
  - sim/
  - scripts/
  - create_project.tcl
- client.py
- - Makefile
- tl_host.py
- tl_host_sim.py
- sensor_adc.py

Getting Help

Issues: Report bugs and request features on GitHub
Documentation: Browse the navigation menu for detailed guides
Legacy Docs: SCuM-V23 Archive for previous generation

This project is developed as part of UC Berkeley’s EE194/EE290C Special Topics in Circuit Design course.

How to contribute to the docs

Install Node.js and npm

npm comes with Node.js.

Windows: Download the LTS installer from the official Node.js download page. After installing, check with node -v and npm -v.

macOS: Install via Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node

Verify with node -v and npm -v.

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install nodejs npm

Verify with node -v and npm -v.

More options and details: npm docs – Downloading and installing Node.js and npm.

Make changes

Fork the repo on GitHub: ucb-ee290c/scum-v-bringup

Clone your fork:

git clone https://github.com/<your-username>/scum-v-bringup.git
cd scum-v-bringup

Create a branch:
```
git checkout -b docs/your-change
```

Edit files under docs/, preview locally (below), commit and push:

git add .
git commit -m "docs: describe your change"
git push origin docs/your-change

Open a Pull Request to ucb-ee290c/scum-v-bringup with a clear description.

Build and view documentation locally

cd docs
npm install
npm run dev    # Development server at http://localhost:3000
npm run build  # Production build

Hardware Setup