USER documentation? In a FILE? That you can read before you install it? Inconceivable!It does mention "pymcuprog --help", if you dig a bit...
pymcuprog --help
usage: pymcuprog [-h] [-d DEVICE] [-p PACKPATH] [-t TOOL] [-s SERIALNUMBER]
[-m MEMORY] [-o OFFSET] [-b BYTES] [-l LITERAL [LITERAL ...]]
[-f FILENAME] [-c CLK] [-u UART] [-i INTERFACE]
[-v {debug,info,warning,error,critical}] [-V] [-R] [--verify]
[-x]
[-H {tool-toggle-power,user-toggle-power,simple-unsafe-pulse}]
[-U] [-C]
{ping,erase,read,write,verify,getvoltage,getsupplyvoltage,reboot-debugger,setsupplyvoltage,getusbvoltage,reset}
Generic programmer of selected AVR, PIC and SAM devices
Basic actions:
- ping: reads the device ID or signature
- read: read NVM
- write: write NVM
- erase: erase NVM
positional arguments:
{ping,erase,read,write,verify,getvoltage,getsupplyvoltage,reboot-debugger,setsupplyvoltage,getusbvoltage,reset}
action to perform
optional arguments:
-h, --help show this help message and exit
-d DEVICE, --device DEVICE
device to program
-p PACKPATH, --packpath PACKPATH
path to pack
-t TOOL, --tool TOOL tool to connect to
-s SERIALNUMBER, --serialnumber SERIALNUMBER
USB serial number of the unit to use
-m MEMORY, --memory MEMORY
memory area to access: all, 'calibration_row',
'config_words', 'eeprom', 'flash', 'fuses', 'icd',
'internal_sram', 'lockbits', 'signatures', 'user_id',
'user_row'
-o OFFSET, --offset OFFSET
memory byte offset to access
-b BYTES, --bytes BYTES
number of bytes to access
-l LITERAL [LITERAL ...], --literal LITERAL [LITERAL ...]
literal values to write
-f FILENAME, --filename FILENAME
file to write / read. Note that when reading to hex
file only eeprom, flash, fuses, config_words, user_row
memories will be written to the hex file
-c CLK, --clk CLK clock frequency in Hz (bps) for programming interface.
(eg: '-c 32768' or '-c 115k' or '-c 1M')
-u UART, --uart UART UART to use for UPDI
-i INTERFACE, --interface INTERFACE
Interface to use
-v {debug,info,warning,error,critical}, --verbose {debug,info,warning,error,critical}
Logging verbosity level
-V, --version Print pymcuprog version number and exit
-R, --release-info Print pymcuprog release details and exit
--verify verify after write from file
-x, --timing add timing output
-H {tool-toggle-power,user-toggle-power,simple-unsafe-pulse}, --high-voltage {tool-toggle-power,user-toggle-power,simple-unsafe-pulse}
UPDI high-voltage activation mode
-U, --user-row-locked-device
Writes the User Row on a locked device (UPDI devices
only)
-C, --chip-erase-locked-device
Execute a Chip Erase on a locked device (UPDI devices
only)
Usage examples:
Ping a device on-board a kit:
- pymcuprog.py ping
Ping a device using Atmel-ICE
- pymcuprog.py -t atmelice -d atmega4809 -i updi ping
Read the some bytes of flash:
- pymcuprog.py read -m flash -o 0x80 -b 64
Erase an UPDI device:
- pymcuprog.py erase
Erase a locked UPDI device:
- pymcuprog.py erase --chip-erase-locked-device
Set target supply voltage on a kit:
- pymcuprog.py setsupplyvoltage -l 3.3