Metadata-Version: 2.0
Name: tinyprog
Version: 1.0.24.dev17
Summary: Programmer for FPGA boards using the TinyFPGA USB Bootloader (http://tinyfpga.com).
Home-page: https://github.com/tinyfpga/TinyFPGA-Bootloader/
Author: Luke Valenty
Author-email: luke@tinyfpga.com
License: GPLv3+
Project-URL: Documentation, https://packaging.python.org/tutorials/distributing-packages/
Project-URL: Source, https://github.com/tinyfpga/TinyFPGA-Bootloader/tree/master/programmer
Project-URL: Tracker, https://github.com/tinyfpga/TinyFPGA-Bootloader/issues
Keywords: fpga,tinyfpga,programmer,lattice,ice40
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: pyserial (<4,>=3)
Requires-Dist: jsonmerge (<2,>=1.4.0)
Requires-Dist: intelhex (<3,>=2.2.1)
Requires-Dist: tqdm (<5,>=4.19.5)
Requires-Dist: six
Requires-Dist: packaging
Requires-Dist: pyusb

# 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.


