Metadata-Version: 2.0
Name: tinyprog
Version: 1.0.24.dev13
Summary: Programmer for FPGA boards using the TinyFPGA USB Bootloader
(http: //tinyfpga.com).
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

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
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.
        
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 :: 3Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
