EMF Badge - User contributions [en]

TiLDA MK3/Firmware Update

2017-08-13T09:44:26Z

Russ: /* Before you start */

== Update your Tilda Mk3==

This guide will help you to update your Tilda Mk3 badge. Be careful, following these instructions will delete all files and setting on your badge, so make sure you have copies of everything!

If you're having trouble following these instructions or updating your badge, [mailto:badge@emfcamp.org please get in touch] and we'll do our best to help.

== Before you start==

You need to put your badge into DFU mode. This activates a USB bootloader stored in ROM on the STM32 processor.

'''To enter DFU mode:''' Switch on the badge. Press the center joystick button while at the same time quickly pushing the reset button on the back of the badge.

In some cases this seems to require a few attempts. You can also try unplugging the battery, and holding down the center button while plugging in USB.

==OSX==

'''Prerequisites needed for Mac OS X'''

1. XCode (from App Store)

2. Python & pip
* Homebrew method
*: 1. [http://docs.python-guide.org/en/latest/starting/install/osx/ Install Homebrew and Pip]
*: 2. <code>brew install libusb</code>
*: 3. <code>pip install libusb1 pyusb</code>
* MacPorts method
*: 1. [http://johnlaudun.org/20150512-installing-and-setting-pip-with-macports/ Install MacPorts and Pip]
*: 2. <code>sudo port install usbutils py-pip</code>
*:: usbutils provides e.g. lsusb, useful for knowing if the badge is connected in DFU mode
*: 3. <code>sudo pip install libusb1 pyusb</code>

3. Check that you're connected in DFU mode:
: <code>lsusb</code>
: Should output something like:
: <code>Bus 020 Device 002: ID 0483:df11 STMicroelectronics STM Device in DFU Mode</code>

4. <code>wget https://update.badge.emfcamp.org/update.py</code>

5. <code>sudo python update.py</code>

6. To get a shell: <code>screen /dev/tty.usbmodem*</code>

'''Troubleshooting'''

If you get the error <code>Error: No backend available</code> then python cannot find the USB library. Please Repeat steps 2 and 3 above, see https://github.com/walac/pyusb/issues/120 for more details.

== Linux ==

Install prerequisites if required:

<code>sudo apt install python-usb</code>

Open a terminal and execute this line:

<code>curl --silent --show-error --retry 5 https://update.badge.emfcamp.org/update.py | python</code>

If you get an error saying <code>ImportError: No module named core</code> then the python-usb package in your distribution is too old. On Debian, you should be able to fix it using pip instead:

<code>sudo apt install python-pip</code>

<code>sudo pip install --upgrade pyusb</code>

== Windows ==

'''<span style="color:red">WARNING</span>: There have been reports of badges being bricked when flashed from windows. They can be recovered using the OSX/Linux update procedure. We are looking for alternative ways of updating using Windows.'''

On a Windows PC, you will need to download the STMicroelectronics DfuSe USB device firmware updater software http://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-programmers/stsw-stm32080.html and use the 'Upgrade or Verify Action' part of the GUI to update the firmware instead.

* Install the STMMicroelectronics utility from the link above.
* Download the firmware.dfu file from https://update.badge.emfcamp.org/firmware.dfu and save it.
* With the badge plugged into the computer, hold the centre joystick button and press reset. The badge should now boot into the bootloader, and be detected as a 'STM Device in DFU Mode'.
* Start up DfuSeDemo.exe, and click the 'Choose' button - select the firmware.dfu file and then hit 'Upgrade'
* Your firmware will now be updated.

== Other Operating systems==

To update your badge please download the following script and run it via python: [https://update.badge.emfcamp.org/update.py update.py]

If you know how to flash the badge yourself you can also download the DFU binary directly: [https://update.badge.emfcamp.org/firmware.dfu firmware.dfu]

== Build your own version==

If you want to build your own version of the firmware have a look [https://badge.emfcamp.org/wiki/TiLDA_MK3/build here]

Badge Competition 2016

2016-10-02T15:45:26Z

Russ: Created page with "We're running a competition for the best use of the TiLDA Mk3 badge from EMF 2016. We'll award a prize in two categories: software and hardware. The prize in both categories..."

We're running a competition for the best use of the TiLDA Mk3 badge from EMF 2016. We'll award a prize in two categories: software and hardware.

The prize in both categories will be '''two tickets to EMF 2018''' (plus the 2017 one-day event if it happens), with the runners up getting another TiLDA Mk3 badge.

==Entering==

All apps submitted to the app library will be considered for the competition. If your entry can't be uploaded to the library, drop us an email at badge@emfcamp.org.

Entries will close on December 31st, 2016.

TiLDA MKe

2015-05-01T15:22:39Z

Russ: Created page with "Front Front [http://en.wikipedia.org/wiki/E_(mathematical_constant) Why MKe?] =EMF 2014 Badge=..."

[[File:IMG_0474.jpg|500px|right|thumb|Front]]
[[File:Badge_Front.png|right|thumb|Front]]

[http://en.wikipedia.org/wiki/E_(mathematical_constant) Why MKe?]

=EMF 2014 Badge=
The main aim of the 2014 badge is to give camp attendees an interesting bit of hardware to play with during the camp and experiment with afterwards. We designed an Arduino compatible platform to allow easy reuse and access, and have published all code and design files.

==Battery Warning==
A very last minute battery (and connector) change on the badge due to a supplier problem meant two issues arose with the badge during EMF:

* '''Always make sure to plug your battery in the right way round!''' The new battery connector allows you to connect it backwards. We did our best to mitigate this, but connecting it incorrectly will destroy the power management controller and prevent the badge from charging or running from the battery. It will still function perfectly using USB power. "Red" and "Black" are written next to the connector - please make sure to plug it in correctly.

* '''Be careful not to short the battery connector wires!''' The new battery connector slightly exposes the wires when the battery is plugged in. If a metal object shorts the two wires, it can result in extreme battery damage. If we'd known this was such an issue before the event we would have applied protective material to it - we suggest covering the exposed connector in tape, sugru, blu-tack, or some other insulating material. Alternatively, simply unplug the battery when your badge is not in use!

==My badge is broken!==
Due to the aforementioned supplier issues it is possible that you may have received a faulty badge, or it may have been damaged by connecting the battery backwards. If you badge will not turn on when it has been plugged in with a MicroUSB cable (and the power switch on the back is set to "USB"), or something else seems wrong with it, please email [mailto:badge@emfcamp.org badge@emfcamp.org] and we'll try to fix or replace your badge.

==Basic post-event features==
We made sure that the badge has a few features to play with once the event is over. More will be added over time as attendees submit changes to us.

[[File:Badge_Back.png|right|thumb|Back]]
* Torch mode - Press the light button next to the screen. It will only light up fully if it's hung upside down to avoid blinding
* Snake
* Tetris

But of course the point of the badge is to modify it and use it for other interesting things! The following sections describe how to update the firmware on the badge, how to use it as a simple arduino, and how to write your own code for the main badge firmware.

==Getting help==
The EMF 2014 badge is a complex piece of hardware and software, however remember that you can just treat it as an Arduino if you find it all too daunting.

If you get stuck and need advice, there's an [http://webchat.freenode.net/?channels=tilda active IRC chatroom] you can join to ask for advice, or if you're really stuck you can email us on [mailto:badge@emfcamp.org badge@emfcamp.org].

=How to update the badge software & program the badge=
The badge software has been substantially updated since EMF, fixing bugs and removing features that will no longer work now you're away from our radio network. You should update your badge before starting to play with it any further. If you've never used an Arduino before this might be tricky - ask an Arduino-literate friend to help you, or drop by your nearest [http://hackspace.org.uk hackspace] and ask for advice.

The badge is Arudino Due compatible, so [http://arduino.cc/en/Guide/ArduinoDue some of their instructions may help you if you have problems].

==Set up your environment==
* Plug your badge into your computer via a MicroUSB cable. Make sure the power switch on the back is set to "USB".
* Download the newest version of the Arduino IDE from http://arduino.cc/en/main/software
* Download the TiLDA firmware code from https://github.com/emfcamp/Mk2-Firmware
* Start the Arduino IDE.
* Now you have to change the sketchbook-folder to be the folder you just cloned or downloaded. To do this use File -> Preferences -> “Set Sketchbook location”. On MacOS, this is Arduino -> Preferences.
* Restart the Arduino IDE.
* Open sketch “EMF2014”.
* Set Tools -> Board to MKe v0.333 (RTOS Core).
* Set Tools -> Port to correct port for the Arduino
** On MacOS this is will start /dev/tty.usbmodem with 4 digits, and change for each port
** On Linux this is usually /dev/ttyACM0 but may be a higher number if you have other USB Serial devices
* Hit the upload button
* Wait
* Your badge should now be running the latest TiLDA firmware!

==Programming the badge as an Arduino==
The badge is completely Arduino Due compatible, simply set the board type to "MKe v0.333(Arduino Core)" upload normal Arduino code and the badge will function. However if you want to use any of the more complex hardware on the badge (such as the screen and radio) we recommend programming it using our FreeRTOS framework documented below.

Below is a version of the standard blink sketch that will flash the RX and TX LEDs

<code>
void setup() {
pinMode(PIN_LED_TX, OUTPUT);
pinMode(PIN_LED_RX, OUTPUT);
}

void loop() {
digitalWrite(PIN_LED_TX, HIGH);
digitalWrite(PIN_LED_RX, LOW);
delay(1000);
digitalWrite(PIN_LED_TX, LOW);
digitalWrite(PIN_LED_RX, HIGH);
delay(1000);
}
</code>

If you do program the badge with simple Arduino code but wish to switch back to our official firmware, simply change the sketch to "EMF2014" (and if needed set the board type back to "MKe v0.333 (RTOS Core)") and upload again.

To make the badge Arduino shield compatible, follow [https://wiki.emfcamp.org/wiki/TiLDA_MKe#Making_the_badge_Arduino_shield_compatible these instructions].

===Gotchas===
* Most Arduino code out there use Serial not SerialUSB. On MKe Serial is wired to the SRF radio. When using example code do a find and replace for Serial/SerialUSB this will redirect the Serial traffic of the USB port
* If you want to send data over the Radio you need to wake it and enable it first, set SRF_SLEEP to LOW using the following two lines of code <code>pinMode(SRF_SLEEP, OUTPUT); digitalWrite(SRF_SLEEP, LOW);</code>

==Programming the badge in FreeRTOS==
===Your first “Hello world” app===
There’s a “HelloWorldApp.cpp” file in which you can play around. In order for it to show up on the Homescreen you have to uncomment line 51 in AppManager.cpp and flash the changed code to the badge. Great app pull requests are appreciated!

If you are still using the Arduino IDE at this point, note that it will not let you edit the .cpp and .h files that are needed to create Apps for the badge. To force the IDE to re-compile/re-read any files you've edited using an external editor, make sure to go to the File -> Preferences dialog box, and check the "Use external editor" checkbox.

===Why are things so different from standard Arduino code?===
We’re using a library called FreeRTOS that allows us to multitask - something that’s normally not possible with standard Arduino code. This allows us to run multiple tasks at the same time. FreeRTOS uses preemptive scheduling to switch between the task. Due to this we have to be very careful about how we do some things. For example we can’t just define interrupts for buttons in every task (imagine the mess!) or write to the serial port directly (your task might stop in the middle of the message).

We’ve also spent quite a lot of time to make the built-in components as easy to use as possible without having every task to write lots of boilerplate code. If you feel like using the build-in components on the badge, chances are we already wrote a wrapper for them that is already used by one of the other tasks.

Have a look at the “Documentation” section in this document for a full list of API functions. You will avoid a lot of headaches if you stick to those.

=== Code structure ===
* FreeRTOS has the concept of “Tasks” which work like threads. We’ve wrappered them in a class called “Task” (for background stuff) and “Apps” (for foreground, one-at-a-time things)
* Everything needs to be in the main EMF2014 folder. Subfolders are not allowed. This is an Arduino IDE restriction :(

==Debugging and Gotchas==
* The USB serial is set up to 115200 baud. There are lots of terminals that can connect to them. See below for how to enable the debug logging.
* If you can’t revive a badge, or only get the two red programming LEDs when you plug it, in, do a full erase (see below)
* Avoid busy waiting, use FreeRTOS queues and Tilda::delay() instead
* Don’t use low level functions like interrupts or serial ports directly unless you really, really know how FreeRTOS will handle them. For general logging you can use Tilda::log()
* If sending code to the badge using the Arduino IDE "Upload" button fails, even though the /dev/ttyACM0 (linux com port) is there, just retry, twice if neccessary.

==Full erase==
This is the failsafe process if your badge won't show up over USB.

# Unplug the badge
# Connect the Erase pins on the back together (two holes down the left hand side next to the battery and under the blue wireless module). You can use a jumper, jump wire, or the leg of a resistor for this.
# Turn the badge back on with the switch or plug it back in
# Press the Reset button on the front (bottom centre) and release
# Wait 15 seconds
# Unplug the badge or turn it off

When you plug the badge back into a computer it will come back up in programming mode, with a different serial port to the usual one. Open the EMF 2014 sketch in the Arduino IDE, select the Tilda v0.333 (RTOS) programmer, and find the new serial port. The IDE console should show something like this:

Sketch uses 118,748 bytes (22%) of program storage space. Maximum is 524,288 bytes.
Erase flash
Write 127668 bytes to flash

[ ] 0% (0/499 pages)
[ ] 2% (10/499 pages)
[= ] 4% (20/499 pages)
[= ] 6% (30/499 pages)
...
[============================= ] 98% (490/499 pages)
[==============================] 100% (499/499 pages)
Verify 127668 bytes of flash

[ ] 0% (0/499 pages)
[ ] 2% (10/499 pages)
[= ] 4% (20/499 pages)
[= ] 6% (30/499 pages)
...
[============================= ] 98% (490/499 pages)
[==============================] 100% (499/499 pages)
Verify successful
Set boot flash true
CPU reset.

==Your own wireless badge network==
[[DIY TiLDA Badge Network]] has instructions on how to setup your own private badge network using a RaspberryPi and two Ciseco radios.

==Contribute==
Send us a pull request via [https://github.com/emfcamp/Mk2-Firmware GitHub] - We’ll do our best to review and merge the good ones during EMF so others can use them.

=Using the badge hardware=
The badge has a plethora of hardware built in for you to play with, everything from accelerometers and gyroscopes to hidden ethernet headers! Breaking it all down is too much detail for this document, however we'll call out some things we built in that you might want to play with.

Remember the badge is Arduino Due compatible, and we broke out nearly all the features of the ARM chip so you can access them. [http://arduino.cc/en/Main/ArduinoBoardDue Anything the Due can do], the TiLDA can do!

==Making the badge Arduino shield compatible==
[[File:Sheild_Headers.JPG|500px|right|thumb|Sheild Headers]]
To make the badge Arduino shield compatible you'll need to solder simple strips of header pins onto the back of the badge.
You need the following headers
{| class="wikitable"
|-
! Qty !! Type !! Use !! Rapid part
|-
| 1 || 2x03 Male || SPI ||
|-
| 2 || 1x08 Female || Power, Analog pins ||
|-
| 2 || 1x10 Female || Digital pins ||
|-
| 1 || 2x08 Male || Ethernet ||
|}
The picture to the right shows the placement.

==Interesting things to play with==
Most of the interesting things are on the back of the badge. They're clearly marked in white. [https://wiki.emfcamp.org/w/images/b/bd/Badge_Back.png This diagram of the back] should allow you to locate them. Some of the following require extra parts to be added to your badge.

* Full Arduino R3 shield compatible pins (Requires soldering the headers on the back of the badge)
* Pins either side of the lanyard holes for conductive thread (D19, D18, GND, 3V3)
* Infrared transmitter on the front (Pin shortcut IR_TX_PWM)
* Infrared receiver on the front (Pin shortcut IR_RX, Part Vishay TSOP75238TT available from digikey and Farnell )
* Piezo buzzer (Pin shortcut PIEZO or PIEZO_PWM)
* On-board ethernet (not available on the Due) - requires breakout module (eBay: Elechouse Taijiuino Ethernet PHY DM9161 Module)
* [http://www.invensense.com/mems/gyro/mpu6050.html MPU-6050] 3-axis Accelerometer and 3-axis gyro (IMUTask.cpp and the MPU6050 library)
* 128x64 pixel backlit LCD display (JHD12864, see [https://github.com/emfcamp/Mk2-Documentation/tree/master/LCD%20JHD12864 here for docs])
* [http://shop.ciseco.co.uk/srf-wireless-rf-radio-surface-mount/ Ciseco SRF Radio]
* [http://shop.ciseco.co.uk/powerpod-ncp1402-5v0/ PowerPOD NCP1402] interface, used to generate 5V from 3V3 battery supply power (needed for some shields)
* MicroSD adapter breakout (Molex 1050270001 available from digikey)
* Compass (magnetometer) breakout (HMC HMC5883L-TR available from digikey and Farnell)
* Reprogramming headers for the 868Mhz [http://www.ti.com/product/cc1110f32 CC1110 radio module]
* 1 megabit flash module (Part S25FL216K0PMFI011)
* SPI breakout
* 2x RGB LEDs on the front
* FTDI header (shared with SRF Radio)
* JTAG header (Part M50-3500542 available form Farnell

==Included hardware==

The following hardware has been included on the badge.

* [http://www.atmel.com/products/microcontrollers/arm/sam3x.aspx Atmel ATSAM3X8E]
** This is the same chip as the [http://arduino.cc/en/Main/ArduinoBoardDue Arduino Due] and gives us the base platform for the badge
** 32bit ARM Cortex M3 * 84MHz
** 512KBytes Flash RAM
** 96KBytes of SRAM
* A 128x64 pixel monochrome LCD display
* [http://shop.ciseco.co.uk/srf-wireless-rf-radio-surface-mount/ Ciseco SRF Radio]
** 868Mhz RF Transceiver
** Simple UART interface
** Low power sleep mode
* [http://www.invensense.com/mems/gyro/mpu6050.html MPU-6050] 3-axis Accelerometer and 3-axis gyro
** I2C interface
** Tri-Axis angular rate sensor (gyro) with a sensitivity up to 131 LSBs/dps and a full-scale range of ±250, ±500, ±1000, and ±2000dps
** Tri-Axis accelerometer with a programmable full scale range of ±2g, ±4g, ±8g and ±16g
** Digital Motion Processing™ (DMP™) engine offloads complex MotionFusion, sensor timing synchronisation and gesture detection
* PMIC & LiPo
* Joystick, 4 way with click
* Buttons
* RGB LEDs
* IR Transmitter
* Arduino Headers
* Pads for wearable tech

=Useful Hacks!=
==3d printable & laser-cuttable badge case==
Draft 3d print-able and laser-able case files [http://www.thingiverse.com/thing:436815 here]
==Convert images to TiLDA bitmap format==
* A Python script (via [https://twitter.com/trotmaster99 @trotmaster99]) that converts a monochrome bitmap image into a format suitable for the Tilda can be found [http://pastebin.com/8XeazQjT here].
* A similar script in Perl to create TiLDA MKe fullscreen bitmaps from XBM: -
<div style ="height:200px;overflow-x:hidden;overflow-y:auto;border: 4px solid orange;">
'''xbm2mke.pl by [[User:Msemtd]]'''
<nowiki>
#!perl -w
use strict;
# Little script to convert a regular XBM to TiLDA MKe bitmap
# only tested with fullscreen bitmaps!
# Hot file handle magic...
select((select(STDERR), $| = 1)[0]);
select((select(STDOUT), $| = 1)[0]);
sub t(@);
sub d($);
sub chug($);
my $f = shift;
#~ $f = 'blankish.xbm' if not $f;
if(not defined $f or not $f =~ /^(.*)\.xbm$/i){
die "Usage: gimme an XBM file dude!\n";
}
my $name = $1;
t "Reading file '$f'...";
my $data = chug($f);
t "OK";
my @lines = split /^/, $data;
@lines = grep{chomp; s/^\s+//; s/\s+$//; length;} @lines;
#~ t d \@lines;
my($width, $height) = (0,0);
my @head = @lines[0..5];
foreach(@head){
if(/_width\s+(\d+)/){$width = $1;}
if(/_height\s+(\d+)/){$height = $1;}
}
t "width x height = $width x $height";
my @k;
foreach(@lines){ push @k, split /,/; }
@k = grep { s/^.*(0x[0-9A-Fa-f]{1,2}).*$/$1/o; /(0x[0-9A-Fa-f]{1,2})/o } @k;
#~ t d \@k;
my $bc = scalar(@k);
t "Pulled out $bc hex bytes";
if($bc != $width * $height / 8) {
die "byte count $bc does not match that expected for w x h";
}
t "OK - reorder bytes for MKe bitmap";
my $wb = int($width/8) + (($width & 0x07) ? 1: 0);
t "width in whole bytes for $width pixels = $wb";
my @mke;
for(my $col = 0; $col < $wb; $col++){
for(my $row = $height - 1; $row >= 0; $row--){
my $idx = ($row * $wb) + $col;
my $val = $k[$idx];
#~ t "Column $col + Row $row = idx $idx = $val";
push @mke, $val;
}
}
my $out = "static const uint8_t ".uc($name)."_BM[] = {\n"
." $width, // width\n"
." $height , // height\n";
#~ $out .= join(", ", @mke);
while(scalar @mke){
$out .= join(", ", splice(@mke, 0, 16)).",\n";
}
$out .= "};\n";
# meh, just print it out
t $out;

sub t(@) {
foreach (@_) {
print STDOUT "$_\n";
}
}
sub d($) {
require Data::Dumper;
my $s = $_[0];
my $d = Data::Dumper::Dumper($s);
$d =~ s/^\$VAR1 =\s*//;
$d =~ s/;$//;
chomp $d;
return $d;
}
sub chug($) {
my $filename = shift;
local *F;
open F, "< $filename" or die "Couldn't open `$filename': $!";
local $/ = undef;
return <F>;
} # F automatically closed

</nowiki>
</div>

<span id=github></span>

= Source =

All the source code and designs are on openly available on Github:

* [https://github.com/emfcamp/Mk2-Hardware Hardware] - the full board design
* [https://github.com/emfcamp/Mk2-Documentation Documentation] - a dump of relevant parts datasheets
* [https://github.com/emfcamp/Mk2-Firmware Firmware] - source code for the badge software
* [https://github.com/emfcamp/Mk2-Software Software] - server-side software for the network

If you want to help, point your IRC client to #tilda on Freenode.

= Firmware Documentation =
== Debugging ==
===Enabling the USB serial debug log messages===
To enable the debug logging you must uncomment the following line in [https://github.com/emfcamp/Mk2-Firmware/blob/master/hardware/emfcamp/sam/libraries/debug/debug.h#L42 hardware/emfcamp/sam/libraries/debug/debug.h]

// Enable debug task and output
// #define DEBUG 1

===Tilda::log(String text)===

This logs “text” to the serial console. To read it connect to it via the Arduino IDE Serial Monitor. Don’t use “SerialUSB.println” or similar -- it’s not thread-safe and you might end up with utter nonsense.

===Debugging using the JTAG interface===
The JTAG interface on the board provides powerful debugging facilities like breakpoints, backtraces, dumping memory, inspecting variables, checking task states, catching exeptions etc. To make this to work requires additional hardware and software, see [[TiLDA Debugging using JTAG]].

== Buttons ==
The badge has 8 buttons: Up, Down, Left, Right, Center (on the joystick), A, B and Light. You can use arduino-style “digitalRead(BUTTON_RIGHT)” to read the current status of any button, but you can’t define your own interrupt (because we already did that). This doesn’t mean you can’t wait for a certain button to be pressed, it just means you have to approach it slightly differently:

Example: A simple app displaying the button code
void ButtonApp::task() {
ButtonSubscription allButtons = Tilda::createButtonSubscription(LIGHT | A | B | UP | DOWN | LEFT | RIGHT | CENTER);

while(true) {
Button button = allButtons.waitForPress(1000);
if (button == A) {
debug::log(“You pressed button A”);
} else if (button == LEFT) {
debug::log(“You pressed LEFT”);
} else if (button == NONE) {
debug::log(“No button has been pressed in 1000ms”);
}
}
}

===ButtonSubscription Tilda::createButtonSubscription(<buttons>)===

Registers a subscriptions for a defined set of buttons and returns a ButtonSubscription. Multiple Buttons can be combined via “|” (see example above). One button can not be subscribed by more than 10 subscriptions (which shouldn’t really happen, but keep it in mind).

Don’t use this function in a constructor, it requires FreeRTOS to be running. Using it inside the task() function is the only safe place for it.

===Button ButtonSubscription::waitForPress(TimeInTicks timeout)===

This is normally called in a loop. It causes the task to block until one of the buttons has been pressed. If the timeout occurs before any button has been pressed “NONE” will be returned.

===ButtonSubscription::waitForPress()===

The same as above, but without the timeout.

===ButtonSubscription::clear()===

This should be called after an App has been suspended, just before it’s going to be resumed. It causes the Queue to be cleared which could otherwise lead to buttons being reported that have been pressed while other apps were in the foreground. Have a look at the FlashLightApp for an example.

==LEDs==
===Tilda::setLedColor(Led led, Color color);===
===Tilde::setLedColor(Color color);===

Sets the color of all or one led. Color is an object that takes red, green and blue as a value between 0 and 255 each. If no led is defined both leds will be set to the same color.

Example: A simple color-changing task
void ColorfulTask::task() {
while(true) {
Tilda::setLedColor(LED1, {255, 0, 0}); // Red
Tilda::setLedColor(LED2, {0, 255, 0}); // Green
Tilda::delay(300);
Tilda::setLedColor(LED1, {0, 255, 0}); // Green
Tilda::setLedColor(LED2, {0, 0, 255}); // Blue
Tilda::delay(300);
Tilda::setLedColor(LED1, {0, 0, 255}); // Blue
Tilda::setLedColor(LED2, {255, 0, 0}); // Red
Tilda::delay(300);
}
}

==Display==

The Display Library is based on GLCDv3 (http://playground.arduino.cc/Code/GLCDks0108), docs (http://code.google.com/p/glcd-arduino/source/browse/trunk/glcd/doc/GLCD_Documentation.pdf) but adapted to support our screen. The Init routine is called in the setup, and the LCDTask takes care of ensuring the screen is updated every 40ms if required (Unlike the original GLCD library, screen updates are decoupled from the graphics routines.)

Also available is M2tklib (https://code.google.com/p/m2tklib/) which is a nice toolkit library. Further details on using this will come later, but expect the main loop to be handled for you, and just passing the menu structure you require for your app.

Right now, you can call the GLCD functions directly with GLCD.DrawBitmap() for example. This is going to change to be accessed through the GUITask class in the near future, to ensure only one task at a time writes to the screen. Expect this to be simply GUITask in place of GLCD, along with a registering a redraw call back to GUITask. The bitmap format, by the way, is rather unconventional but there are a couple of utility scripts to convert popular formats down in the hacking section below - you can grab the SponsorsApp.h as an example and swap out the bitmap array with one of your choosing.

Extra features that are included, GLCD.SetRotation() will handle rotation of the screen for you, and GLCD.CurrentWidth() and GLCD.CurrentHeight will give you the correct Width and Height for the current orientation. GLCD.Width and GLCD.Height constants are not available, and the GLCD predefined Text areas will not be rotated for you, if you require this define your own text areas.

Note that one function was not ported to the badge version of GLCD, "Printf", you'll have to cope without it.

== Sound ==
There's a fully working Piezo on board!

== IMU ==
=== Tilda::getOrientation ===
returns " ORIENTATION_HELD", "ORIENTATION_RIGHT" (joystick to the right of the screen), "ORIENTATION_HUNG" or "ORIENTATION_LEFT"

== Flash Storage ==
We have 2mb of flash storage, but we're not using it in the main firmware - Please get this working!
== Data: Schedule ==
===Tilda::getDataStore().getSchedule(day, location) ===
== Date: Weather Forecast ==
===Tilda::getDataStore().getWeatherForecast()===
== Radio ==
There's no way of sending messages in the current version of the firmware, sorry :(

== Time ==

=== Tilda::delay(uint16_t delayInMs) ===

Works like Arduino’s delay(), but is FreeRTOS-safe. It’s safe to use this function before FreeRTOS has started.

=== tilda::getClock() ===

Returns an instance of https://github.com/MarkusLange/Arduino-Due-RTC-Library/blob/master/rtc_clock.h

==Settings==
===uint16_t tilda::getBadgeId()===

==Battery==
===float TiLDA::getBatteryVoltage()===
Returns the current voltage as a float

===uint8_t TiLDA::getBatteryPercent()===
Returns the current voltage as a percentage

===uint8_t TiLDA::getChargeState()===
Returns the charge state

0 Charging
1 Not Charging

[[Category: Badges]]

SiNE

2015-05-01T15:22:13Z

Russ: Created page with "300px ==About SiNE== SiNE: Investigating the Neighbourhood of EMW<br /> Each attendee of Electromagnetic Wave receives a SiNE badge which h..."

[[File:SiNE_Front_Angle.JPG|thumb|300px]]
==About SiNE==
SiNE: Investigating the Neighbourhood of EMW<br />
Each attendee of Electromagnetic Wave receives a SiNE badge which has two purposes; firstly it allows you to take part in a treasure hunt based around the boat. By solving the clues you will be directed to an object or location either on or near the Stubnitz. The clue letter is also the first letter of the answer - when you arrive at the correct location you will find a large matching letter. Hold your badge in front of the letter, and the corresponding light on your badge will illuminate. The first person to solve all the clues and bring their fully illuminated badge to the ticket desk wins two tickets to Electromagnetic Field 2014. Anyone else solving the puzzle will be allowed to choose from a selection of prizes for as long as they last!

The second purpose of the badge is as a locator beacon - as people walk around the boat they will create a trail of the places they visit and the talks they attend. We hope to use this information to better schedule our future events. The data will be made available publicly after the event, and we'll provide a way of finding their badge identifier for those who want to get their own trail.

===Scavenger hunt===
As you locate the beacons hidden around EMWave more of your LED's will light up. To save power the LED do not stay on all the time and the beacons you have seen are flash in groups every few seconds.<br />
The beacons you have seen is store in the EEPROM and so the data is preserved even if you remove the power
====Clue List====
Now EMWave has past here is the clue list: (Will add answers soon --[[User:Dpslwk|Dpslwk]] ([[User talk:Dpslwk|talk]]) 14:21, 6 May 2013 (UTC))
*A: I can't believe it's not butter!
*B: Bond would be comfortable here and he has a licence.
*C: One of your EMW badge designers.
*D: One of your EMW badge designers.
*E: Powered by Orange.
*F: ____ and aft.
*G: False patch of nature.
*H: All _____ on deck!
*I: Initial illumination, informing incomers.
*J: Java's main export.
*K: A nautical speed, mooring the Stubnitz.
*L: Budding safecrackers.
*M: An essential orienteering tool.
*N: A German Venus? Not exactly Botticelli!
*O: Fun times in the Emergency Room!
*P: A most unusual Landrover.
*Q: Encoded in a massive square.
*R: A lifesaver in Germany.
*S: Quite possibly the most unusual holiday home.
*T: One of your EMW badge designers.

===Locator ID===
[[File:SiNE_Front_Buttons.jpeg|thumb|300px]]
Each badge is programmed with a unique ID, that is transmitted about 5 times a second. There will be Raspberry Pi's doted around the ship, collecting data.<br />
EMF will not know your badge ID, as there are handed out at random. <br />
A badge's ID is shown on the LED using binary encoding.
This is done at power up, or by pressing and holding the "ID" button<br />

If you '''do not''' wish to have your badge trasnmitting an ID you can clear it by holding the "Erase" button for about 5 seconds.

The badge ID is 9 bit's long, these are displayed across the A-I LED's, a lit LED is 1 and unlit is 0, LSB first.<br />
Example if LED's A D E and H are lit then we have 010011001 in binary or 0x099 in HEX or 153 in decimal.

Unfortunately due to a lack of time the Raspberry Pi's were never setup, as so no data was collected.

<div style="clear: both"></div>

==Sponsors==
[[File:SiNE_Back_Angle.JPG|thumb|300px]]
SiNE was only possible thanks to our sponsors:
* [http://www.twilio.com Twilio] A Cloud communications company sponsored the parts need to make badges.
* [http://ciseco.co.uk Ciseco] A Nottingham based electronics company that make low power wireless radios, donated the time to build the badges on there SMT assemble line.
<div style="clear: both"></div>

===DevBoards===
[[File:DevBoards.JPG|thumb|300px]]
Before designing the final SiNE badge we built three development boards, not bothered about the looks, they were built to test the hardware and wiring between the parts. <br />
Once it was confirmed that the parts worked together they were passed onto the software developer to start work on the code need for the scavenger hunt and location tracking. <br />
Using these development boards meant the software was ready to go around the same time as the final badges were produced.

<div style="clear: both"></div>
==Badge Hacking==
[[File:SiNE_Schematic.png|thumb|300px]]
We actively encourage users to hack there badge better and hope the information provided below will help

===Flashing and Fuses===
We use avrdude and an ISP programer to flash the ATTiny44A
Example command lines can be found in the Makefile in the SiNE-Firmware github

avrdude part flag (-p) is t44

Fuses:
* Low: 0xC2
* High 0xD7
* Extended: 0xFF

===Components===
The following parts were used: (data-sheet links to come)
* ATTiny44A - MCU running all the code
* 74HCT164AD - Shift register connecting the matrix of LED's
* LED's - 20 0805 LED's for each of the hidden locations
* IR Receiver - listening for the unique ID of each of the hidden beacons
* IR Sender - sending out the badges ID for Location tracking
* 2032 Coin Cell - Power for the day and possible more
* ISP header - Used for programming of the ATTiny44A

===Resources===
* [https://github.com/EMF-TiLDA/SiNE-PCB PCB]
* [https://github.com/EMF-TiLDA/SiNE-Firmware Firmware]

[[Category:Badges]]

Main Page

2015-05-01T15:21:42Z

Russ:

We like to try and provide a great badge for each of our events, find out more below.<br/>
The aim for the every badge we produce is always to give people hardware they’ve probably not played with before while being simple enough that anyone can play with it during and after the event.<br/>

[[File:Emf2012_badge_pcb.png|thumb|300px]]<br/>
==EMF2012==
[http://wiki-archive.emfcamp.org/2012/articles/b/a/d/Badge.html TiLDA]<br/>
The first EMF camp badge, base around the Arduino Leonard, with on board IR, NRF24 Radio and RGB LED's.<br/>
[http://blog.emfcamp.org/post/28558155390/revealing-tilda-our-camp-badge Revealing TiLDA, our camp badge!]

<div style="clear: both"></div>

[[File:SiNE_Front_Angle.JPG|thumb|300px]]
==EMW2013==
[[SiNE]]<br/>
SiNE: Investigating the Neighbourhood of EMW<br/>
Each attendee of Electromagnetic Wave receives a SiNE badge which has two purposes; firstly it allows you to take part in a treasure hunt based around the boat. By solving the clues you will be directed to an object or location either on or near the Stubnitz. The clue letter is also the first letter of the answer - when you arrive at the correct location you will find a large matching letter. Hold your badge in front of the letter, and the corresponding light on your badge will illuminate.<br/>
<div style="clear: both"></div>

==EMF2014==
[[File:Badge_Front.png|right|thumb|Front]]
[[TiLDA MKe]]<br/>
The TiLDA MKe project, Code name "ElectroMagnetic Boogaloo"<br/>
The MKe brings an LCD display and Arduino Due compatibility. To give people live schedule updates and camp notifications.<br/>
[http://blog.emfcamp.org/post/94157161753/announcing-tilda-mke-the-incredible-emf-2014-camp Announcing TiLDA MKe, the incredible EMF 2014 camp badge]
<div style="clear: both"></div>

Please Note: There are a couple of minor hardware and some firmware issues that might be effecting your badge. If you've let the magic smoke out of your charge controller or have tried to re-flash and ended up with nothing but a couple of dimly glowing lights then DO NOT DESPAIR -It's recoverable and fixes, documentation and lots of firmware are still being produced :)

==[[Team:Badge|Badge Team]]==

The baged team is being headed by
*[[User:Dpslwk|'RepRap' Matt]] from Nottinghack
*[[User:thinkl33t|Bob]] from HACMan