/chavrprog

AVR programmer based on Chinese ch341a

Primary LanguageCGNU General Public License v3.0GPL-3.0

chavrprog

AVR programmer using Chinese ch341a chip

There is a lot of strange things from China, and ch341a is one of the them. Cheap USB-Serial, USB-SPI, USB-I2C, USB-Parralel, etc makes it seems to be the real thing. However, lack of documentation make that device almost useless, except for couple of open-source projects. This project adds support for AVR microcotrollers programming using CH341a chip.

Project is based on ch341prog by Setarcos (https://github.com/setarcos/ch341prog), and technically is a brief implementation of ATMEL serial programming protocol using low-level functions from ch341prog project. Also, to parse Intel HEX source files from libcintelhex (https://github.com/martin-helmich/libcintelhex) are used.

Building

I've tried to iclude all necessary dependencies into the package, so it's necessary just run make. The only lib you should have installed in your system is libusb-1.0

Also to run chavrprog without root privileges you can create file 99-ch341.rules file into your rules.d directory (usually /etc/udev/rules.d) with following content: SUBSYSTEM=="usb", ATTR{idVendor}=="1a86", ATTR{idProduct}=="5512", GROUP="plugdev"

Usage

Connect ch341 programmer by scheme: AVR ch341a
MISO-----MISO
MOSI-----MOSI
SCK------SCK
Reset----CS
GND------GND

Or the same using popular chineese programmer, connect to socket for spi flash:
socket AVR
1-------Reset
2-------MISO
4-------GND
5-------MOSI
6-------SCK

alt text

Commads

-d DEVICE - specifies AVR chip
-r ADDR - read flash memory from start to ADDR in bytes, or
-r f FILE read whole flash memory to specified file
-w HEX - write flash memory from intel HEX file
-e - erase device
-c HEX - read and compare HEX with flash memory (strictly)
-a HEX - automatically erase, write and check data in chip, or
-a s HEX - same with strict verification instead of fast default
use if you're flashing complex HEX, like Arduino bootloader or if default fails
-p r - read content of on-chip EEPROM, print in terminal, or
-p r FILE - read EEPROM to FILE
-p w HEX - write eeprom from intel hex file -f - read fuse bits
-l BYTE - write low fuse, must be in hex format, e.g. 0x2A -H BYTE - write high fuse, must be in hex format, e.g. 0x2A
-x BYTE - write extended fuse, must be in hex format, e.g. 0x2A -L read lock bits -t TIME - overwrite default writing timeout (4500 us), useful for slower chips. 12000 was reported to work with AtTiny85

There is 2 verification functions implemented - fast and strict. By default with -a command fast one is used. This is good for writing homogenous HEX files - like most of programms, and works much faster because verifies only written part. Another one verifies whole memory, what makes it applicable for complex HEX with gaps, but works slower due to whole chip reading.

The most typical command set looks like:
chavrprog -d mega328p -a ./firmware.hex

Disklaimer

Project is under development and may contain mistakes.

To add another MCU's it's necessary to add it discription (name, pagesize, number of pages, eeprom size) to file config.c Most popular AVRs (which is used in Arduino) are already added. Theoretically, current version should work with any Atmega chip, if Atmel commad set is same for all chips, but was tested only with on Atmega32u4. Devices with more then 64K memory not supported now. Initial implementation for Attiny is done, most popular devices added to config. Hopefully, it should work for any attiny, nevertheless tested inly with attiny13.

ToDo

  • Add support for devices with more than 64K memory
  • Add parser and make config separate file rather than compile-time structures
  • Better Windows support?

Any contributions are welcomed.

Windows version

chavrprog.exe is pre-compiled binary for cygwin64. To use it you should have cygwin installed with libusb-1.0 and libusb-win32 driver for ch341a installed through Zadig (http://zadig.akeo.ie/).

chavrprogTiny85.zip is a zip file containing prebuilt binary with necessary libraries, i.e. no cygwin is needed. This is modified version, provided by Hilmar Strauch, tested on AtTiny85, but supposed to work with other Tiny as well. According to the reports, in this version

chavrprogTiny85.exe -dtiny85 -a file.hex does not work, please use chavrprogTiny85.exe -dtiny85 -e followed by chavrprogTiny85.exe -dtiny85 -w file.hex

License

This is free software: you can redistribute it and/or modify it under the terms of the latest GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.