NAME

avr_hvsp.pl - an avrdude clone to talk HVSP to AVR chips

SYNOPSIS

avr_hvsp.pl [-e] [-n] [-D] [-U MEMORY:OP:FILE:FORMAT] ...

DESCRIPTION

This script implements a command that behaves somewhat like avrdude, using Device::Chip::AVR_HVSP to talk to an AVR chip in HVSP mode via a suitable circuit attached to a chip adapter. The module provides a detailed description of a suitable circuit.

OPTIONS

-A, --adapter ADAPTER

Name of the Device::Chip adapter subclass to use. Defaults to BusPirate.

-M, --mount PARAMS

A comma-separated list of additional options to pass to the mount method, e.g. for configuring GPIO pin mappings.

AVRDUDE-LIKE OPTIONS

The following options are designed to be compatible with avrdude

-b, --baud RATE

Overrides the default baud rate of 115200, in case for some reason the Bus Pirate has been reconfigured. Normally it should not be necessary to alter this.

-D, --no-autoerase

Skips the implied chip erase operation before writing the eeprom or flash memories.

-e, --erase

Perform a full chip erase before other operations. Normally this is not required because the memory writes that would require it (eeprom and flash) normally do this automatically.

-n, --no-write

Do not perform any writes to the chip; restrict operation only to read and verify.

-P, --port PORT

Device node where the Bus Pirate can be found. If not supplied, the value of the BUS_PIRATE environment variable will be used, or /dev/ttyUSB0 if that is not defined.

-U, --memop MEMORY:OP:FILE:FORMAT

Performs a memory transfer operation of the OP type (which may be r for read, w for write, or v for verify) with a chip memory. This is transferred to or from a file whose name and format are given.

The types of memory and file formats are listed below. As a special extension, the filename - may be given, to read from standard input, or write to standard output.

--backup-all FILE

Reads all of the chip memories that are writable (i.e. not the signature or calibration) and writes their entire contents to the given file, in an extension of the Intel Hex format, where each memory starts with a comment giving its name.

--restore-all FILE

Writes memories to the chip from the given file in a format written by backup-all.

MEMORIES

The following memories are recognised

  • signature (read-only)

  • calibration (read-only)

  • lock

  • lfuse, hfuse, efuse

  • flash

  • eeprom

FILE FORMATS

The following file formats are recognised

  • Intel Hex (type i)

  • Decimal (type d), Hexadecimal (type h), Octal (type o)

    Output-only; writes a string of text, containing comma-separated integers for each byte individually.

  • Immediate (type m)

    Input-only; interprets the filename directly as a comma- or space-separated list of integers in any of decimal, hexadecimal or octal form. Most useful for setting fuses or lock bits.

INCOMPATIBILITES

  • This program only works those ATtiny devices that support HVSP mode. It does not support ISP or HVPP.

  • Does not support other file formats - Motorola S-record, raw binary, ELF, or binary textual encoding.

  • Does not implement avrdude telnet mode, nor many of the other commandline options.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>