Skip to main content

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.


Project details


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)

Uploaded Source

Built Distributions

tinyprog-1.0.24.dev17-py3.6.egg (25.4 kB view details)

Uploaded Source

tinyprog-1.0.24.dev17-py2.py3-none-any.whl (13.9 kB view details)

Uploaded Python 2 Python 3

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

Hashes for tinyprog-1.0.24.dev17.tar.gz
Algorithm Hash digest
SHA256 12cb74c2e117df684007d79bc93d958f43dc1e6e7300351be7b4a78346ca86b1
MD5 c1e75ed63f80f950638f31c91995267a
BLAKE2b-256 f5d1f2bb141aa268bed71c3ca425560c1011899d1f5dd16fdd5e823db7e9bad0

See more details on using hashes here.

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

Hashes for tinyprog-1.0.24.dev17-py3.6.egg
Algorithm Hash digest
SHA256 042814fd98dad9945522e5d4c1d3646e54884a473e007121372101a7f23507d7
MD5 6f62c898f27fdd4135bffd609df8029d
BLAKE2b-256 a44d0db4879c5c676e2b2d5e457845bb93ccbd307427ada2349a63ec814683ee

See more details on using hashes here.

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

Hashes for tinyprog-1.0.24.dev17-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 1eeb1b87192fcf0c99690a9e477b65e99390f053100e6edc24ac05c9e55f3251
MD5 ebf786a6763bbeed296a51fb530df1bb
BLAKE2b-256 f294f9edbe733fa984683ae9afabd5d5f32a3eda989d027fff313b972a7ea1d6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page