Programmer for FPGA boards using the TinyFPGA USB Bootloader (http://tinyfpga.com).
Project description
# Programmer
## GUI
The GUI has been moved to the [TinyFPGA Programmer Application repo][gui-repo].
However, the `tinyprog` tool can be used on its own with a command-line
interface:
[gui-repo]: https://github.com/tinyfpga/TinyFPGA-Programmer-Application
## CLI
```
> tinyprog --help
usage: tinyprog [-h] [-l] [-p PROGRAM] [-u PROGRAM_USERDATA] [-b] [-c COM]
[-i ID] [-d DEVICE] [-a ADDR] [-m]
optional arguments:
-h, --help show this help message and exit
-l, --list list connected and active FPGA boards
-p PROGRAM, --program PROGRAM
program FPGA board with the given bitstream
-u PROGRAM_USERDATA, --program-userdata PROGRAM_USERDATA
program FPGA board with the given user data
-b, --boot command the FPGA board to exit the bootloader and load
the user configuration
-c COM, --com COM serial port name
-i ID, --id ID FPGA board ID
-d DEVICE, --device DEVICE
device id (vendor:product); default is (1d50:6130)
-a ADDR, --addr ADDR force the address to write the bitstream to
-m, --meta dump out the metadata for all connected boards in JSON
```
You can list valid ports with the `--list` option:
```
> tinyprog -l
TinyProg CLI
------------
Using device id 1d50:6130
Only one board with active bootloader, using it.
Boards with active bootloaders:
COM14: TinyFPGA BX 1.0.0
UUID: e518a627-5626-4f92-91f5-07ed26503bb9
FPGA: ice40lp8k-cm81
```
You can use the `--com` option to specify a specific port. If you don't specify a port, it will use the first one in the list:
```
tinyprog --com COM14 --program "..\boards\TinyFPGA_BX\fw.bin"
TinyProg CLI
------------
Using device id 1d50:6130
Only one board with active bootloader, using it.
Programming COM14 with ..\boards\TinyFPGA_BX\fw.bin
Programming at addr 028000
Waking up SPI flash
298940 bytes to program
Erasing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 223kB/s]
Writing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 235kB/s]
Reading: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:00<00:00, 490kB/s]
Success!
```
You can use the `--id` option to specify a device by ID. You can use just the first few characters of the ID:
```
tinyprog --id e5 --program "..\boards\TinyFPGA_BX\fw.bin"
TinyProg CLI
------------
Using device id 1d50:6130
Only one board with active bootloader, using it.
Programming COM14 with ..\boards\TinyFPGA_BX\fw.bin
Programming at addr 028000
Waking up SPI flash
298940 bytes to program
Erasing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 223kB/s]
Writing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 235kB/s]
Reading: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:00<00:00, 490kB/s]
Success!
```
## Testing
Tests have been removed for now pending refactoring of test methodology.
## GUI
The GUI has been moved to the [TinyFPGA Programmer Application repo][gui-repo].
However, the `tinyprog` tool can be used on its own with a command-line
interface:
[gui-repo]: https://github.com/tinyfpga/TinyFPGA-Programmer-Application
## CLI
```
> tinyprog --help
usage: tinyprog [-h] [-l] [-p PROGRAM] [-u PROGRAM_USERDATA] [-b] [-c COM]
[-i ID] [-d DEVICE] [-a ADDR] [-m]
optional arguments:
-h, --help show this help message and exit
-l, --list list connected and active FPGA boards
-p PROGRAM, --program PROGRAM
program FPGA board with the given bitstream
-u PROGRAM_USERDATA, --program-userdata PROGRAM_USERDATA
program FPGA board with the given user data
-b, --boot command the FPGA board to exit the bootloader and load
the user configuration
-c COM, --com COM serial port name
-i ID, --id ID FPGA board ID
-d DEVICE, --device DEVICE
device id (vendor:product); default is (1d50:6130)
-a ADDR, --addr ADDR force the address to write the bitstream to
-m, --meta dump out the metadata for all connected boards in JSON
```
You can list valid ports with the `--list` option:
```
> tinyprog -l
TinyProg CLI
------------
Using device id 1d50:6130
Only one board with active bootloader, using it.
Boards with active bootloaders:
COM14: TinyFPGA BX 1.0.0
UUID: e518a627-5626-4f92-91f5-07ed26503bb9
FPGA: ice40lp8k-cm81
```
You can use the `--com` option to specify a specific port. If you don't specify a port, it will use the first one in the list:
```
tinyprog --com COM14 --program "..\boards\TinyFPGA_BX\fw.bin"
TinyProg CLI
------------
Using device id 1d50:6130
Only one board with active bootloader, using it.
Programming COM14 with ..\boards\TinyFPGA_BX\fw.bin
Programming at addr 028000
Waking up SPI flash
298940 bytes to program
Erasing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 223kB/s]
Writing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 235kB/s]
Reading: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:00<00:00, 490kB/s]
Success!
```
You can use the `--id` option to specify a device by ID. You can use just the first few characters of the ID:
```
tinyprog --id e5 --program "..\boards\TinyFPGA_BX\fw.bin"
TinyProg CLI
------------
Using device id 1d50:6130
Only one board with active bootloader, using it.
Programming COM14 with ..\boards\TinyFPGA_BX\fw.bin
Programming at addr 028000
Waking up SPI flash
298940 bytes to program
Erasing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 223kB/s]
Writing: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:01<00:00, 235kB/s]
Reading: 100%|¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦¦| 299k/299k [00:00<00:00, 490kB/s]
Success!
```
## Testing
Tests have been removed for now pending refactoring of test methodology.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tinyprog-1.0.24.dev17.tar.gz
(26.9 kB
view details)
Built Distributions
tinyprog-1.0.24.dev17-py3.6.egg
(25.4 kB
view details)
File details
Details for the file tinyprog-1.0.24.dev17.tar.gz
.
File metadata
- Download URL: tinyprog-1.0.24.dev17.tar.gz
- Upload date:
- Size: 26.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12cb74c2e117df684007d79bc93d958f43dc1e6e7300351be7b4a78346ca86b1 |
|
MD5 | c1e75ed63f80f950638f31c91995267a |
|
BLAKE2b-256 | f5d1f2bb141aa268bed71c3ca425560c1011899d1f5dd16fdd5e823db7e9bad0 |
File details
Details for the file tinyprog-1.0.24.dev17-py3.6.egg
.
File metadata
- Download URL: tinyprog-1.0.24.dev17-py3.6.egg
- Upload date:
- Size: 25.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 042814fd98dad9945522e5d4c1d3646e54884a473e007121372101a7f23507d7 |
|
MD5 | 6f62c898f27fdd4135bffd609df8029d |
|
BLAKE2b-256 | a44d0db4879c5c676e2b2d5e457845bb93ccbd307427ada2349a63ec814683ee |
File details
Details for the file tinyprog-1.0.24.dev17-py2.py3-none-any.whl
.
File metadata
- Download URL: tinyprog-1.0.24.dev17-py2.py3-none-any.whl
- Upload date:
- Size: 13.9 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1eeb1b87192fcf0c99690a9e477b65e99390f053100e6edc24ac05c9e55f3251 |
|
MD5 | ebf786a6763bbeed296a51fb530df1bb |
|
BLAKE2b-256 | f294f9edbe733fa984683ae9afabd5d5f32a3eda989d027fff313b972a7ea1d6 |