HSC2011/Software/Firmware: Unterschied zwischen den Versionen

aus Metalab Wiki, dem offenen Zentrum für meta-disziplinäre Magier und technisch-kreative Enthusiasten.
Zur Navigation springenZur Suche springen
K (fixed link to vm)
(added section on eeprom, moved todos to roadmap)
 
Zeile 6: Zeile 6:
 
It is written in C (technically, C++, although hardly any C++ is used). It uses the [http://www.nongnu.org/avr-libc/ avr-libc], [http://jeelabs.net/projects/cafe/repository/show/RF12 JeeLabs' RF12 library] and [http://www.pjrc.com/teensy/td_libs_OneWire.html Paul Stoffregen's OneWire library]. A fourth "external" dependency is [http://www.clifford.at/embedvm/ EmbedVM], which is documented as [[HSC2011/Software/EmbedVM|our virtual machine]] as it was developed for this project.
 
It is written in C (technically, C++, although hardly any C++ is used). It uses the [http://www.nongnu.org/avr-libc/ avr-libc], [http://jeelabs.net/projects/cafe/repository/show/RF12 JeeLabs' RF12 library] and [http://www.pjrc.com/teensy/td_libs_OneWire.html Paul Stoffregen's OneWire library]. A fourth "external" dependency is [http://www.clifford.at/embedvm/ EmbedVM], which is documented as [[HSC2011/Software/EmbedVM|our virtual machine]] as it was developed for this project.
  
== Compiling ==
+
== Compiling and flashing ==
  
 
'''Note''': You can skip this step, and instead use the file <tt>firmware/firmware.hex</tt> from the [[HSC2011/Download instructions|project repository]].
 
'''Note''': You can skip this step, and instead use the file <tt>firmware/firmware.hex</tt> from the [[HSC2011/Download instructions|project repository]].
Zeile 29: Zeile 29:
 
(if you flash on an arduino uno, replace "duemilanove328" with "uno"; you might need to adapt the device name as well). The installation routine will be different if you use another way of flashing than flashing an ATMega sitting inside an Arduino; consult your flasher's operating instructions in that case.
 
(if you flash on an arduino uno, replace "duemilanove328" with "uno"; you might need to adapt the device name as well). The installation routine will be different if you use another way of flashing than flashing an ATMega sitting inside an Arduino; consult your flasher's operating instructions in that case.
  
== TODO documentation ==
+
When using ATMegas that don't originate from Arduinos, we nevertheless recommend [http://arduino.cc/en/Tutorial/ArduinoISP|to flash the Arduino firmware] there, including their fuse settings.
  
* eeprom (mac addresses)
+
== Communication settings ==
* fuse settings
 
  
== TODO ==
+
The MAC address of the device and its configured base station are stored in the first 2x8 byte of the EEPROM memory. They can be configured from [[HSC2011/Software/Ygor|from Ygor]] or using the [[HSC2011/Communication/Serial protocol|M01-M05 commands]] on the serial console.
 
 
Open issues are, in descending priority:
 
 
 
* separate timeout arrays for login and event
 
* redirect messages for controlling the base station itself
 
* fine-tuning timing for re-sends and responses (may only need validation)
 
* melody api
 
* reading battery status using new firmware
 
* reading RSSI state
 
* multicasts
 
* <del>removing arduino specific stuff to reduce resource usage</del> (not a priority unless resources become a real problem)
 
  
  
 
[[Kategorie:HSC2011]]
 
[[Kategorie:HSC2011]]
 
[[Kategorie:English]]
 
[[Kategorie:English]]

Aktuelle Version vom 4. Mai 2011, 01:26 Uhr

< HSC2011


The firmware is the part of the software flashed to the ATMega328 on the EduBuzzers. It capable of both serving as a buzzer and being a base station.

It is written in C (technically, C++, although hardly any C++ is used). It uses the avr-libc, JeeLabs' RF12 library and Paul Stoffregen's OneWire library. A fourth "external" dependency is EmbedVM, which is documented as our virtual machine as it was developed for this project.

Compiling and flashing

Note: You can skip this step, and instead use the file firmware/firmware.hex from the project repository.

In order to compile the firmware, you'll need

You don't need to explicitly install the other libraries, as they are chcked into our repository.

Once you installed the required programs, build the firmware from

$ ./build.sh

and install it using

$ arduino-cc -P /dev/ttyUSB0  -B duemilanove328 firmware.cc hardware.cc RF12.cpp OneWire.cpp embedvm.c firmware_vm.cc firmware_evt.cc firmware_ser.cc firmware_net.cc

(if you flash on an arduino uno, replace "duemilanove328" with "uno"; you might need to adapt the device name as well). The installation routine will be different if you use another way of flashing than flashing an ATMega sitting inside an Arduino; consult your flasher's operating instructions in that case.

When using ATMegas that don't originate from Arduinos, we nevertheless recommend flash the Arduino firmware there, including their fuse settings.

Communication settings

The MAC address of the device and its configured base station are stored in the first 2x8 byte of the EEPROM memory. They can be configured from from Ygor or using the M01-M05 commands on the serial console.