Difference between revisions of "TiLDA MK3"
|Line 6:||Line 6:|
<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;">There are currently <strong>some issues with the app library</strong> on the badge being unable to download new apps. You can instead go to http://api.badge.emfcamp.org/apps and download a zip for the app you want. To get it onto your badge you need to create a new folder on your badge in the "apps/" folder. Make sure to safely eject the usb storage before resetting!<br><br>If you want to <b>help us debug</b> the issue, please join #tilda on freenode (IRC)
<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;">There are currently <strong>some issues with the app library</strong> on the badge being unable to download new apps. You can instead go to http://api.badge.emfcamp.org/apps and download a zip for the app you want. To get it onto your badge you need to create a new folder on your badge in the "apps/" folder. Make sure to safely eject the usb storage before resetting!<br><br>If you want to <b>help us debug</b> the issue, please join #tilda on freenode (IRC)/</div>
=== Assembly ===
=== Assembly ===
Revision as of 14:53, 6 August 2016
Using your badge
With your badge you will receive a booklet explaining how it's done. If you have any problems, please come to the Badge Operation Center and we will help you.
After you have assembled your badge you can just use the tiny switch at the bottom of the screen to turn your badge on. Alternatively you can use any USB power source. If you turn your badge on for the first time (or if for some reason it has reset itself) you will get some on-screen information while we try to download the newest set of software.
If at any point you want to restart your badge you can just press the reset button at the back.
Changing your name
- Press 'Menu'
- Select the 'Change Name' app and press 'A'
- Use the joystick and 'A' key to enter your name
- Press 'Menu' to save your name and reset the badge - your name should now be displayed!
Installing new apps
- Press 'Menu'
- Select the 'App Library' app and press 'A'
- Select "Browse App Store"
- Select a category and then an app. Wait until you see the description and press "A" to save it.
- Press B a few times (or alternatively MENU) to restart your badge
- On the home screen you can now press MENU and select "View all" to find your newly installed app. If you want to pin it to the quick launcher screen select your app and press MENU. If you just want to start it press A instead.
Your TiLDA Badge has built-in wifi support. It should all just work if you're at the campsite, but if you're on your own network you might have to tell the badge about it. For more information please have a look here: WiFi
A word of warning: During EMF the badge will use "emf-insecure". This is, as the name implies, not the most secure way of transmitting data. On top of that there are some problems with HTTPS and SSL, so we're not using it for with the default apps (we're working on it!). Please don't send anything private or important to or from the badge via wifi.
The badge charges via a microUSB socket, and takes about 2-3 hours for a full charge. The red charge LED next to the USB connector will extinguish when charging is complete
Nothing works! Help!
Don't worry, you can always "factory reset" your badge. Please follow these instructions: Resetting
Hacking your badge
One of the main goals of TiLDA is to make hacking it as easy as possible. All you need to do so is a computer with USB and your badge.
For more information about the functions available please have a look at the Badge API section of this page.
If you're already familiar with all this you can jump right into the topic of Apps. Apps can be shared via the EMF App Library or by copying files of and on via USB. If you want to know more about how this works go to TiLDA MK3/apps
In case you're more interested in what makes the hardware tick and your confident with C++ and microprocessors then you can work directly with the micropython code that runs TiLDA: How to build the firmware from scratch
All code used is hosted on Github. Contributions and PR are very welcome!
- documentation - General Micropython libarary
- uGFX - The TiLDA LCD colour screen
- CC3100 - The wifi chip
- RTC (real time clock)
- ADC (analogue reading)
- Microcontroller peripherals  (Timers, PWM, serial etc)
On top of the build-in modules above we have also created a bunch of helpful libraries written in python. If you go through the bootstrap process or use the App Library you should always have a full set of those on your badge. If for some reason this isn't the case you can download our repository from https://github.com/emfcamp/Mk3-Firmware and copy the
lib folder onto your badge.
TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib
- NTP Example: https://gist.github.com/drrk/4a17c4394f93d0f9123560af056f6f30
(feel free to add additional ideas, and create links new wiki pages to on-going projects, perhaps someone will want to contribute)
TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
- Colour LCD screen 320x240
- Joystick and A/B/Menu Buttons
- Wifi (cc3100)
WS2812B aka "Neo Pixel"Sadly defunct - come to the badge tent to have it fixed :(
- MicroSD slot