TiLDA MK4: Difference between revisions

From EMF Badge
Jump to navigation Jump to search
m (→‎Basic usage: Clarify reset button location.)
Line 9: Line 9:


=== Basic usage ===
=== Basic usage ===
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.  
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. '''This doesn't always work on the first try, you might have to use "reset" to try a few times'''


If at any point you want to restart your badge you can just press the reset button on the back below the display ribbon.  
If at any point you want to restart your badge you can just press the reset button on the back below the display ribbon.  

Revision as of 10:00, 1 September 2018

TiLDA Mk𝛿

Using your badge

If you just got your badge and it doesn't do anything, don't despair, quite a few of them need to be factory reset before showing the loading screen. Press and hold MENU while quickly pressing the reset button at the back. Keep the MENU button hold for another 2 seconds. Release it when both the red and green LED are lit. If you got it correct both LEDs should flash a few times.
If this doesn't work you can update the badge firmware. If this doesn't work, please come and join us in #tilda on Freenode IRC

Assembly

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.

Basic usage

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. This doesn't always work on the first try, you might have to use "reset" to try a few times

If at any point you want to restart your badge you can just press the reset button on the back below the display ribbon.

Changing your name

  1. Press 'Menu'
  2. Select the 'Settings" app
  3. "Change Name" and press 'A'
  4. Use the joystick and 'A' key to enter your name
  5. Press 'Menu' to save your name and reset the badge - your name should now be displayed!

Installing new apps

  1. Press 'Menu'
  2. Select 'Badge Store' app and press 'A'
  3. Select "Install"
  4. Select a category and then an app. Wait until you see the description and press "A" to save it.
  5. Press B a few times (or alternatively MENU) to restart your badge
  6. On the home screen you can now press MENU to find your newly installed app.

WiFi

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

Charging

The badge charges via a microUSB socket, and takes about 2-3 hours for a full charge. The red charge LED to the right of the display ribbon on the back will extinguish when charging is complete.

Nothing works! Help!

Don't worry, you can always "factory reset" your badge. Please follow these instructions: Resetting

If everything else absolutely fails, you can try following these instructions (advanced): TiLDA_MK4/Firmware_Update

Hacking your badge

Badge Hacking Workshop Documentation


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.

The badge itself runs code written in the computer language Python which is run by a bit of software called Micropython.

For more information about the functions available please have a look at the Badge API section of this page.

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!


Some ideas

Please share what you've done (or want to do) with others!

Badge API

Build-in

TiLDA Libraries

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.

for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk4-Apps/tree/master/lib

(feel free to add additional ideas, and create links new wiki pages to on-going projects, perhaps someone will want to contribute)

Hardware

Full hardware files are on GitHub [1]

Badge hardware

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.

Hardware files are available on GitHub [2].

Retrieved from "https://badge.emfcamp.org/w/index.php?title=TiLDA_MK4&oldid=365"