Field-upgrade bitwizard boards - Revision history

Rew: /* Linux */

2016-12-30T14:13:22Z

Linux

Rew at 13:49, 30 December 2016

2016-12-30T13:49:49Z

Rew at 10:09, 26 May 2015

2015-05-26T10:09:06Z

Rew at 10:08, 26 May 2015

2015-05-26T10:08:39Z

Rew at 10:08, 26 May 2015

2015-05-26T10:08:09Z

Rew at 08:01, 1 May 2014

2014-05-01T08:01:05Z

Rew at 15:38, 30 April 2014

2014-04-30T15:38:47Z

Rew at 06:50, 19 August 2013

2013-08-19T06:50:50Z

Rew at 09:16, 12 June 2013

2013-06-12T09:16:22Z

Rew at 10:53, 31 May 2013

2013-05-31T10:53:11Z

@@ Line 62: / Line 62: @@
 === Linux ===
+Installing dfu-util: On modern Linux systems, you can simply do: apt-get install dfu-util , or the equivalent if your system does not use apt.
-On Linux you can now do:
+Then you can do:
  dfu-util -a 0 -D ch.dfu
-to upgrade the firmware in the device.
+to upgrade the firmware in the device. (substitute the name of the binary you have if it is different).
 === Windows ===

@@ Line 1: / Line 1: @@
+= Different bitwizard boards =
+BitWizard now has STM32 based boards and AVR based boards. Errors in software are possible and sometimes the devices can be extended in functionality with a simple software upgrade.  We therefore like to build our boards with the option of a software upgrade builtin.
+Look in the right section for your board.
+= AVR based boards. =
 If you have a raspberry pi, and there is a reason to upgrade your bitwizard board and you have a raspberry pi, then this can be done....
@@ Line 33: / Line 42: @@
 The avrdude GPIO programmer will 'grab' the programming pins from the SPI module if  you have it loaded. The SPI module will take them back if you remove it from the kernel and re-insert it, or if you use gpio_setfunc . (Use the first method until I have time to document how to do it with gpio_setfunc).
+= STM32 based boards =
+Some STM32 based boards do not have USB. In that case  use the no-usb version of the upgrade procedure, otherwise skip to the with usb section.
+== no usb ==
+No boards with this configuration are in-the-wild yet. BitWizard internal: Look in the internal wiki documentation. :-)
+== with usb ==
+Our STM32 based boards with USB have a button labeled BOOT or BSEL. Press this button, keep it pressed and power up the board. Count to three and then release the button. Powering up the board is usually plugging in the USB cable. It might be easier to connect the cable to the board beforehand and power up the board by plugging the other end of the cable into a computer or USB HUB. If you have a hub with switches, that's an option too: you can throw the switch on the hub to power up our board.
+Now the board should be in DFU (Device Firmware Update) mode. On Linux lsusb should show an ST microelectronics device in DFU mode. Someone with Windows may report how to navigate to a screen that shows the USB device and how to confirm DFU mode.
+You should have gotten a firmware binary with .dfu extension from us.
+=== Linux ===
+On Linux you can now do:
+ dfu-util -a 0 -D ch.dfu
+to upgrade the firmware in the device.
+=== Windows ===
+On windows ...
+* download driver?
+* download dfuse http://www.st.com/en/development-tools/stsw-stm32080.html
+* follow instructions?

@@ Line 18: / Line 18: @@
  avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:r:ee.hex:i
- avrdude -P gpio -b 1200 -u -c gpio -p atmega328  -U lfuse:w:0xe2:m hfuse:w:0xdf:m
+ avrdude -P gpio -u -c gpio -p atmega328 -b 1200 -U lfuse:w:0xe2:m hfuse:w:0xdf:m
  avrdude -P gpio -u -c gpio -p atmega328  -U flash:w:i2cmega_rpi_ui.hex
  avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:w:ee.hex

@@ Line 18: / Line 18: @@
  avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:r:ee.hex:i
- avrdude -P gpio -u -c gpio -p atmega328  -U lfuse:w:0xe2:m hfuse:w:0xdf:m
+ avrdude -P gpio -b 1200 -u -c gpio -p atmega328  -U lfuse:w:0xe2:m hfuse:w:0xdf:m
  avrdude -P gpio -u -c gpio -p atmega328  -U flash:w:i2cmega_rpi_ui.hex
  avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:w:ee.hex

@@ Line 18: / Line 18: @@
  avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:r:ee.hex:i
+ avrdude -P gpio -u -c gpio -p atmega328  -U lfuse:w:0xe2:m hfuse:w:0xdf:m
  avrdude -P gpio -u -c gpio -p atmega328  -U flash:w:i2cmega_rpi_ui.hex
  avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:w:ee.hex

@@ Line 17: / Line 17: @@
 Then to program the board, you will  have to do something like:
- avrdude -P gpio -u -c gpio -p atmega328  -U flash:r:ee.hex:i
+ avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:r:ee.hex:i
  avrdude -P gpio -u -c gpio -p atmega328  -U flash:w:i2cmega_rpi_ui.hex
- avrdude -P gpio -u -c gpio -p atmega328  -U flash:w:ee.hex
+ avrdude -P gpio -u -c gpio -p atmega328  -U eeprom:w:ee.hex
 of course substituting the name hexfile that we sent you.

@@ Line 11: / Line 11: @@
 On your target board there is a pattern of 6 pads that form the programming connector. However 5 of the six pins are shared with the SPI connector. So using the SPI connector is more convenient. We'll take care of the sixth next.
-Near the SPI connectors, on most boards you'll find a solder jumper. At the moment the center pad is connected to one of the other pads with a tiny track. Your SPI connector becomes a programming connector if you short the center pad with the pad without the tiny track. I use a 7cm piece of 220V cord that has been stripped for 1cm as a brush against the two pads that I want to connect. Any other trick that connects the two pads will work. People who are upgrading an I2C version have the option of simply using a blob of solder to make the connection. Leaving the little track is not a problem.
+Near the SPI connectors, on most boards you'll find a solder jumper. At the moment the center pad is connected to one of the other pads with a tiny track. Your SPI connector becomes a programming connector if you short the center pad with the pad without the tiny track. I use a 7cm piece of 220V cord that has been stripped for 1cm as a brush against the two pads that I want to connect. Any other trick that connects the two pads will work. People who are upgrading an I2C version have the option of simply using a blob of solder to make the connection. Leaving the little track is not a problem. (we cut the little track during development to make one of the SPI connectors a programming connector leaving the other SPI connector as the SPI connector....)
 On the rpi_ui the procedure to make the SPI0 port a programming port is slightly different: Put a jumper on the jumper block in the 1-2 position (horizontal, near the SPI connector). Most of you won't have a jumper block installed. Any temporary connection between the two pins is acceptable, provided you can keep it stable for the few seconds it will take to program the board.

@@ Line 17: / Line 17: @@
 Then to program the board, you will  have to do something like:
- avrdude -P gpio -c gpio -p atmega328  -U flash:w:i2cmega_rpi_ui.hex
+ avrdude -P gpio -u -c gpio -p atmega328  -U flash:r:ee.hex:i
+ avrdude -P gpio -u -c gpio -p atmega328  -U flash:w:i2cmega_rpi_ui.hex
+ avrdude -P gpio -u -c gpio -p atmega328  -U flash:w:ee.hex
 of course substituting the name hexfile that we sent you.
-for the devices with atmega328 parts, you will need to have the definition of that part in your /etc/avrdude.conf. You can get an upgraded version from http://www.bitwizard.nl/software/avrdude.conf
+For the devices with atmega328 parts, you will need to have the definition of that part in your /etc/avrdude.conf. You can get an upgraded version from http://www.bitwizard.nl/software/avrdude.conf
+Install it in /etc . The commands above first try to read the eeprom, then flash the part, then rewrite the eeprom. This should now conserve your serial number in the eeprom. Not that it's terribly important.
-Install it in /etc .
+Most our expansion boards have an attiny44 chip as their brains. Use "attiny44" instead of "atmega328" in your commandline above. rpi_ui, xxx_motor and xxx_7seg have atmega328 processors.
-After flashing you will have reset the eeprom. It is cleared with the main flash. Thus any values saved in the eeprom like the serial number, contrast settings and startup texts will have been wiped. We hope to upgrade the procedure soon to be able to restore them.
 == note ==

@@ Line 22: / Line 22: @@
-for the devices with atmega328 parts, you will need to add the definition of the mega328 to your /etc/avrdude.conf file:
+for the devices with atmega328 parts, you will need to have the definition of that part in your /etc/avrdude.conf. You can get an upgraded version from http://www.bitwizard.nl/software/avrdude.conf
+Install it in /etc .
- part parent "m328p"
-     id                  = "m328";
-     desc                = "ATmega328";
-     signature           = 0x1e 0x95 0x14;
- ;
-just below the definition of the ATmega328p . ... XXX ad lineno, xxx add link to complete file... XXX add link to fixed ".deb" file.
 After flashing you will have reset the eeprom. It is cleared with the main flash. Thus any values saved in the eeprom like the serial number, contrast settings and startup texts will have been wiped. We hope to upgrade the procedure soon to be able to restore them.