====== Firmware ======
Es gibt immer wieder neue Funktionen und Updates für die Funkempfänger/-sender /CUL, CUNx, SCC,...) von Busware.
Diese werden in der Firmware bereitgestellt.

===== Vorbereitungen =====
Die verschiedenen Funkempfänger/-sender werden mit verschiedenen Programmen geflasht.
Hiermit werden die Programme für den SCC und CUNx geflasht.
<code bash>apt-get install avrdude dfu-programmer </code>

===== Flashen =====
Zunächst sollte man fhem anhalten.
<code bash>service fhem stop</code>
Damit ein Funkempfänger/-sender geflasht werden kann, muss dieser zunächst in den Bootloadermodus gebracht werden (siehe weiter unten).

Danach kann geflasht werden:
  * **DFU-PROGRAMMER** \\ <code bash>sudo dfu-programmer at90usbxxx erase
sudo dfu-programmer at90usbxxx flash --debug 1 filename.hex</code>
  * **make** Programm der originalen Firmware von Busware \\ <code bash>make program</code>
  * **avrdude** am Beispiel des "flash.sh" Programmes der alternativen Firmware \\ <code bash>sudo flash.sh <DATEINAME>.hex</code>

==== CUN ====
Quelle: [[http://busware.de/tiki-index.php?page=DFU+Bootloader]]
<code>DFU Bootloader


Many of our USB devices (CUL, CUN, CUR, FUL) are shipped with an DFU compliant bootloader. This will enable you to update modules firmware easily.

Loading Firmware in Linux


1. Install dfu-programmer, which is part of the install procedure in SettingUpUbuntuLinux
2. Open a terminal and change directory to the location of your .hex file.
3. Unplug our module from USB for at least 10 seconds
4. Locate the micro switch (HWB button) usually on the back of the PCB, keep it pressed while re-inserting the module into your USB socket.
5. Release the micro switch
6. Run the following two commands:

sudo dfu-programmer at90usbxxx erase
sudo dfu-programmer at90usbxxx flash --debug 1 filename.hex

7. Unplug-Wait-Plug? the USB cable again to resume normal operation.

* The above commands need to be run as root unless you have user access to USB enabled. at90usbxxx has to be replaced with the actual processor in the device.</code>

==== SCC ====
Quelle: [[http://busware.de/tiki-index.php?page=SCC_Installation]]
<code>updating firmware

The makefile inside Device/SCC directory is prepared to flash new firmware by running:
make program

Make sure you press the mirco switch at the desired SCC module while starting the command.</code>


===== Alternative Firmware =====
Es gibt von der Fhem Gemeinde alternative Firmware für die Busware Geräte.
Diese hat mehr Funktionen als die Originale.

Der Quellcode ist zu finden unter [[https://github.com/heliflieger/a-culfw]].
Fertige Hex Firmwaredateien gibt es unter [[https://www.mediafire.com/folder/tf16radvztfd9/a-culfw]].