Difference between revisions of "Serprog"

From flashrom
Jump to: navigation, search
(Settings)
(Frser-duino: fix typo)
 
(54 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:serprog}}
 
{{DISPLAYTITLE:serprog}}
This page is a first draft only and serves to collect information about the serprog protocol and the programmers implementing it.
+
This page collects information about the serprog protocol and the programmers implementing it.
  
 
= Protocol =
 
= Protocol =
  
See [http://flashrom.org/trac/flashrom/browser/trunk/Documentation/serprog-protocol.txt serprog-protocol.txt] in the source tree. It is designed to be compact and allow efficient storage in limited memory of programmer devices.
+
See [http://code.coreboot.org/p/flashrom/source/tree/HEAD/trunk/Documentation/serprog-protocol.txt serprog-protocol.txt] in the source tree. It is designed to be compact and allow efficient storage in limited memory of programmer devices.
 
 
There is a draft for an extension of the serprog protocol to SPI. FIXME: Link there.
 
 
 
Note that beside the really mandatory serprog commands, if you also implement the O_SPIOP command correctly, it should be enough for flashrom from svn to work correctly.
 
  
 
= Hardware =
 
= Hardware =
Line 16: Line 12:
 
[[File:Avr rs232 programmer.jpg|thumb|right|Prototype RS232 AVR parallel flash programmer]]
 
[[File:Avr rs232 programmer.jpg|thumb|right|Prototype RS232 AVR parallel flash programmer]]
  
The [http://www.randomprojects.org/wiki/Prototype_RS232_AVR_parallel_flash_programmer Prototype RS232 AVR parallel flash programmer] Urja Rannikko was the first implementation of the serprog protocol.
+
The [http://www.randomprojects.org/wiki/Prototype_RS232_AVR_parallel_flash_programmer Prototype RS232 AVR parallel flash programmer] of Urja Rannikko was the first implementation of the serprog protocol.
  
FIXME: AVR source code is somewhere in the coreboot mailing list archives...
+
The source code can be found [http://github.com/urjaman/frser-atmega88 here].
  
 
== AVR flasher by eightdot ==
 
== AVR flasher by eightdot ==
Line 24: Line 20:
 
FIXME: Link?
 
FIXME: Link?
  
== Arduino Mega flasher by fritz ==
+
== InSystemFlasher by Juhana Helovuo ==
 +
This was the first one that talks to SPI devices via serial over USB. Details can be found in the [http://www.coreboot.org/InSystemFlasher coreboot wiki] and in this [http://www.coreboot.org/pipermail/coreboot/2011-February/063349.html coreboot mailing list thread].
  
[http://www.flashrom.org/pipermail/flashrom/2010-May/003250.html]
+
== atmegaXXu2-flasher by Stefan Tauner ==
[http://www.coldelectrons.com/blog/?page_id=165]
+
Like the InSystemFlasher this one uses LUFA on an AVR microcontroller to tunnel the serial data over USB.
[http://www.coldelectrons.com/blog/wp-content/uploads/2010/05/flashprg.txt]
+
[[File:atmegaXXu2-flasher.jpg|thumb|right|atmegaXXu2-flasher with Pomona SOIC hook attached]]
FIXME: More info?
+
 
 +
== Various Arduino based flashers ==
  
== Arduino flasher by GNUtoo ==
+
=== Frser-duino ===
This flasher require the following hardware parts:
+
This project contains [https://github.com/urjaman/frser-duino/ source code] to install on Arduino devices.
* An arduino uno or an arduino Duemilanove(way faster) and its usb cable
 
* some wires(optionally some connectors to solder on(for easier plugin and more reliability)
 
* <s>a 10k resistor</s>
 
* A flash chip with the following characteristics:
 
** supported by flashrom
 
** SPI
 
** 3.3v or 5v(the arduino has a 3.3v and a 5v output, only 3.3v was tested...)
 
  
=== Pictures ===
+
That person also have various ports [https://github.com/urjaman?tab=repositories on github] for several microcontroller boards, such as:
<gallery caption="Pictures " widths="250px" heights="250px" perrow="4">
+
* [https://github.com/urjaman/frser-teensyflash frser-teensyflash]: A port for the teensy microcontroller board
File:Serprog_0001.jpeg
 
File:Serprog_0002.jpeg
 
File:Serprog_0003.jpeg
 
File:Serprog_0004.jpeg
 
File:Serprog_0005.jpeg
 
File:Serprog_0006.jpeg
 
File:Serduino_laptop.jpeg| Because of the long cables flashrom had to retry once before reflashing the BIOS but at the end it worked. So don't use cables that are that long...
 
File:W1qtO.jpg| Setup by Sebastian Parborg (DarkDefender)
 
File:Arduino_topview_noresistor.jpeg| It now seem to also work without resistor...
 
</gallery>
 
  
=== Building ===
+
There also vaious other interesting projects such as:
 +
* [https://github.com/urjaman/fast-usbserial fast-usbserial]: A software to make arduino with 8u2 or 16u2 flashing faster and more reliable]
 +
* [[Serprog/Arduino_flasher#Alternative:_Shield_with_SPI_and_LPC.2FFWH_for_5V_Arduinos|An Arduino shield for flashing]]
  
Left pins of the BIOS chip:
+
=== Using a 5v Arduino at 3.3V ===
--------------------------------------------------------
+
Information on it can be found in the [[Arduino_flasher_3.3v]] page
[pin1 of the bios chip] /CS<->10k resistor<->VCC
 
 
[pin1 of the bios chip] /CS<->Arduino pin10(SS, PORTB2)
 
[pin2 of the bios chip] DO<->Arduino pin12(MISO, PORTB4)
 
[pin3 of the bios chip] /WP<->VCC
 
[pin4 of the bios chip] GND<->GND on the power pins
 
 
Right pins of the BIOS chip:
 
--------------------------------------------------------
 
[pin8 of the bios chip] VCC<->+3.3V on the power pins of the Arduino
 
[pin7 of the bios chip] /HOLD<->VCC
 
[pin6 of the bios chip] CLK<->Arduino pin13(SCK, PORTB5)
 
[pin5 of the bios chip] DIO<->Arduino pin11(MOSI, PORTB3)
 
 
The Bios chip used is a W25X80.
 
The Arduino is an arduino uno.
 
  
=== Software ===
+
=== 5V arduino with level shifter ===
==== Settings ====
+
For detailed instructions on how to use different Arduino models to access SPI flash chips see [[Serprog/Arduino flasher]].
{| class="wikitable"  border="1"
+
[[File:Serprog_0001.jpeg|thumb|right|Arduino Uno connected using a breadboard]]
!git branch
 
!Compatible Arduino version
 
!flashrom arguments
 
!Comments
 
|-
 
| master
 
| Arduino uno
 
| -p serprog:dev=/dev/ttyACM0:2000000
 
| reliability issues(flashrom blocks waiting for data from the arduino indefinitely) with the code that is in the 8u2/16u2 beeing investigated...
 
|-
 
| ftdi
 
| Arduino Duemilanove
 
| -p serprog:dev=/dev/ttyUSB0:2000000
 
| Works flawlessly
 
|-
 
|}
 
  
==== Performances ====
+
=== Arduino Mega flasher by fritz ===
# time flashrom -p serprog:dev=/dev/ttyACM0:2000000 -r coreboot.rom
 
flashrom v0.9.5.2-r1541 on Linux 2.6.38-14-generic (x86_64)
 
flashrom is free software, get the source code at http://www.flashrom.org
 
 
Calibrating delay loop... OK.
 
serprog: Programmer name is "serprog-duino"
 
Found Winbond flash chip "W25X80" (1024 kB, SPI) on serprog.
 
Reading flash... done.
 
 
real 0m16.602s
 
user 0m0.930s
 
sys 0m0.000s
 
  
# time flashrom -p serprog:dev=/dev/ttyACM0:2000000 -w build/coreboot.rom
+
[http://www.flashrom.org/pipermail/flashrom/2010-May/003016.html]
flashrom v0.9.5.2-r1541 on Linux 2.6.38-14-generic (x86_64)
+
[http://www.coldelectrons.com/blog/?p=115]
flashrom is free software, get the source code at http://www.flashrom.org
+
[http://www.coldelectrons.com/blog/wp-content/uploads/2010/05/flashprg.txt]
 
Calibrating delay loop... OK.
 
serprog: Programmer name is "serprog-duino"
 
Found Winbond flash chip "W25X80" (1024 kB, SPI) on serprog.
 
Reading old flash chip contents... done.
 
Erasing and writing flash chip... Erase/write done.
 
Verifying flash... VERIFIED.         
 
 
real 0m39.548s
 
user 0m2.650s
 
sys 0m0.000s
 
  
==== Required software ====
+
Some information is lacking on this flasher, such as the software used in it. Feel free to add information on it if you find some.
To make it work you need:
 
* flashrom from svn
 
* [https://gitorious.org/gnutoo-personal-arduino-projects/serprog-duino serprog-duino which runs on the arduino]
 
* The avr toolchain(avr-gcc, avr-libc,make etc...)
 
==== Building the software ====
 
$ svn co svn://flashrom.org/flashrom/trunk flashrom
 
$ cd flashrom && make
 
$ cd ../
 
$ git clone git://gitorious.org/gnutoo-personal-arduino-projects/serprog-duino.git
 
$ cd serprog-duino && make && make upload
 
  
==== Running flashrom ====
+
== Teensy 3.1 SPI + LPC/FWH Flasher ==
./flashrom -p serprog:dev=/dev/ttyACM0:2000000
+
[[Teensy 3.1 SPI + LPC/FWH Flasher|A Teensy 3.1 based small flasher by Urja Rannikko.]]
  
=== Advantages and disadvantages ===
 
* <s>The speed isn't that great(about 3 minutes for reading+writing+verifying a 1M chip)</s>
 
* The speed is now much better thanks to a patch by Sebastian Parborg.
 
* it is made of very commonly available parts(if you can find an arduino uno, you will be able to build it).
 
  
== InSystemFlasher by Juhana Helovuo ==
+
== serprog-stm32vcp by Chi Zhang ==
This is one uses a modified serprog version to talk to SPI devices via serial over USB. Details can be found in the [http://www.coreboot.org/InSystemFlasher coreboot wiki] and in this [http://www.coreboot.org/pipermail/coreboot/2011-February/063349.html coreboot mailing list thread].
 
  
== atmegaXXu2-flasher by Stefan Tauner ==
+
The most powerful serprog-based programmer is built upon an ARM Cortex-M3 (STM32F103) featuring up to 36 MHz SPI clock.
Like the InSystemFlasher this one uses LUFA on an AVR microcontroller to tunnel the serial data over USB. To be updated when flashrom's serprog module has the needed changes merged to do SPI communication.
+
See [http://github.com/dword1511/serprog-stm32vcp#serprog-stm32vcp his github page] for further details, source code etc.
[[File:atmegaXXu2-flasher.jpg|200px|thumb|right|atmegaXXu2-flasher with Pomona SOIC hook attached]]
+
[[File:Serprog-stm32vcp.jpg|thumb|right|serprog-stm32vcp]]

Latest revision as of 15:22, 27 February 2018

This page collects information about the serprog protocol and the programmers implementing it.

Protocol

See serprog-protocol.txt in the source tree. It is designed to be compact and allow efficient storage in limited memory of programmer devices.

Hardware

AVR flasher by Urja Rannikko

Prototype RS232 AVR parallel flash programmer

The Prototype RS232 AVR parallel flash programmer of Urja Rannikko was the first implementation of the serprog protocol.

The source code can be found here.

AVR flasher by eightdot

FIXME: Link?

InSystemFlasher by Juhana Helovuo

This was the first one that talks to SPI devices via serial over USB. Details can be found in the coreboot wiki and in this coreboot mailing list thread.

atmegaXXu2-flasher by Stefan Tauner

Like the InSystemFlasher this one uses LUFA on an AVR microcontroller to tunnel the serial data over USB.

atmegaXXu2-flasher with Pomona SOIC hook attached

Various Arduino based flashers

Frser-duino

This project contains source code to install on Arduino devices.

That person also have various ports on github for several microcontroller boards, such as:

There also vaious other interesting projects such as:

Using a 5v Arduino at 3.3V

Information on it can be found in the Arduino_flasher_3.3v page

5V arduino with level shifter

For detailed instructions on how to use different Arduino models to access SPI flash chips see Serprog/Arduino flasher.

Arduino Uno connected using a breadboard

Arduino Mega flasher by fritz

[1] [2] [3]

Some information is lacking on this flasher, such as the software used in it. Feel free to add information on it if you find some.

Teensy 3.1 SPI + LPC/FWH Flasher

A Teensy 3.1 based small flasher by Urja Rannikko.


serprog-stm32vcp by Chi Zhang

The most powerful serprog-based programmer is built upon an ARM Cortex-M3 (STM32F103) featuring up to 36 MHz SPI clock. See his github page for further details, source code etc.

serprog-stm32vcp