# mriscvprog

**Repository Path**: simonxing/mriscvprog

## Basic Information

- **Project Name**: mriscvprog
- **Description**: A programmer for mriscv or mriscv_vivado using MPSSE SPI FTDI cable.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-01-06
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mriscvprog 

mriscv programer using LIBMPSSE SPI library.

DOCUMENTATION:
```
Usage: mRISCVprog [OPTION...] FILE
mRISCVprog -- a program using FTDI USB-MPSSE SPI function for programming a
mRISC-V

  -a, --addr=DATA            Read data from device at specified addr (For write
                             use also -d)
  -c, --act                  ONLY activate the device (Do not use with -n)
  -d, --data=DATA            Write this data to device at specified addr (addr
                             required)
  -f, --force                Force to program the device
  -n, --noact                DO NOT activate the device after programming (Do
                             not use with -c)
  -q, -s, --quiet, --silent  Don't produce any output
  -u, --data=START,SIZE      Dump memory from START to START+SIZE
  -v, --verbose              Produce verbose output
  -?, --help                 Give this help list
      --usage                Give a short usage message
```
BASIC USES:

- For programming use this command
./mRISCVprog /path/to/dat 

- For programming WITHOUT activating the core, use this command:
./mRISCVprog /path/to/dat -n

- For core use activation (ONLY):
./mRISCprog -c

- For reading in a specific address:
./mRISCprog -a [address]

- For writting in a specific address some data:
./mRISCprog -a [address] -d [data]

- For dumping data (experimental):
./mRISCprog -u START,END

NOTES:
- Every address and data must be indicated using hexadecimal values
- Do not use 0xXXXX values, only XXXX values
- Use -v for use verbose for knowing "what's happening".

HOW IT WORKS:

Common programming is issued to the microcontroller following the 
next three simple steps:
- RESET is set to 0 (deactivate core).
- The program is written in the RAM (any address from 0 to 3FF).
- RESET is set back to 1 (activate core).


WARNINGS:

- To unload of the ftdi serial drivers, execute the next commands:
rmmod ftdi_sio
rmmod usbserial
- mRISCVtest only displays a "is busy commands" message and returns state.