EMF Badge - User contributions [en]

TiLDA MK4/Get Started

2018-09-01T17:02:36Z

Marekventur: Created page with "= Get started = Hacking your TiLDA Mk4 badge is easy. We've written it down step by step. If something goes wrong, the badge can be reset to its out-of-..."

= Get started =

Hacking your TiLDA Mk4 badge is easy. We've written it down step by step.

If something goes wrong, the badge can be [[TiLDA_MK4/reset|reset]] to its out-of-the-box state, so do not be concerned about breaking anything.

== 1. Connect to your computer ==
To get started you need to connect your badge to a computer. You can use any MicroUSB cable - the same type that charges most mobile phones nowadays. It doesn't matter whether the batter is plugged in or not, so don't worry about it.

== 2. Connect to your badge ==

=== Windows ===
* Please follow the instruction under the "Windows" section on this page: https://docs.micropython.org/en/latest/pyboard/pyboard/tutorial/repl.html
* Once you've installed the driver and Putty and you've connected to your badge, press Control+C to stop the main badge app, and then you should be greeted by a line saying "Micropython"

=== OSX ===
* Click the magnifying class in the top right of your screen and type <code>Terminal</code> followed by Enter. A white terminal window should appear.
* type <code>screen /dev/tty.usbmodem*</code> (The * is important, so don't let it out) and hit enter
* hit <code>control+c</code>, if an error is displayed
* You should now be greeted by a line saying "Micropython"

=== Linux ===
* Open a terminal and type <code>screen /dev/xyz</code> (todo: please add the correct path)
* You should now be greeted by a line saying "Micropython"

=== What to do if this step doesn't work? ===
* Press the reset button at the back of your badge and try again
* Have a look at https://docs.micropython.org/en/latest/pyboard/pyboard/tutorial/repl.html for more information

== 3. Your first line of Micropython ==

* In your terminal (next to the >>>) type <code>print(1 + 1)</code> followed by Enter
* You should see <code>2</code> printed on the screen. Congratulations, you've just written your first line of micropython code!
* You can now close the terminal window (or Putty, if you're on Windows). Note: some serial terminals will not close when the badge is removed or powered off. You should close the serial terminal before plugging the badge back in, otherwise the serial terminal may not reconnect.

== 4. Download some software you'll need ==

You will be downloading some stuff now. It's probably be best if you create some folder somewhere so you don't end up with files all over your Desktop.

Note you can copy files across from your computer to the badge, reset the badge and run the files though the menu, however these instructions make things a little easier.

=== Windows ===
* Python: Go to https://www.python.org/downloads/ and download python version 3.x. After the download is finished you can install it.
* Go to https://bootstrap.pypa.io/get-pip.py and save the file into your folder
* Hold shift, right click on the folder on, and click "open command window here"
* Now type <code>python get-pip.py</code>
* After the install was successful please type <code>pip install pyserial pyusb</code> followed by Enter.

=== OSX / Linux ===

* Python: Open a terminal and type <code>python --version</code>. If you get a version number you're good to go, otherwise go to https://www.python.org/downloads/ and download Python version 3.x. After the download is finished you can install it.
* Go to https://bootstrap.pypa.io/get-pip.py and save the file into your folder
* Use a terminal to go to the folder you created ([http://www.macworld.com/article/2042378/master-the-command-line-navigating-files-and-folders.html this is how you do it]) and type <code>python get-pip.py</code>
* Now type <code>python get-pip.py</code>
* After the install was successful please type <code>pip install pyserial pyusb</code> followed by Enter

=== Problems ===
* If you have problems install python, please use google, there are lots of good explanations out there
* For information about how to install <code>pip</code> have a look here: https://pip.pypa.io/en/stable/installing/

== 5. tilda_tools ==

You need to clone our Mk4-Apps repository: https://github.com/emfcamp/Mk4-Apps

You might find some tricks on how to do this here: https://badge.emfcamp.org/wiki/TiLDA_MK4/Badge_Store_Submissions#Submitting_your_badge_app_to_the_official_badge_store

There's a python script calle "tilda_tools" in the repository. You can use it to do all sorts of stuff that is a bit complicated to do with the USB mass storage.

To test it open "adhoc.py" and add the following line at the bottom:
<pre>
ugfx.text(5, 5, "Hello World!", ugfx.RED)
</pre>

and then run "./tilda_tools run adhoc.py" (or "python tilda_tools run adhoc.py" on Windows)

Todo: test this on windows - what's the best way of running python scripts there?

You should now see "Hello World!" on your screen.

== 5. Your first app ==
Let's create an app you can put on your badge.

* Open the folder you've downloaded from github - You will see other app folders like "badge_store" and "snake".
* Create a folder called "my_app". This is your new app.
* Open a text editor. On Windows you can search for <code>Notepad</code>, on OSX there's one called <code>textedit</code> and if you're on Linux you can probably find one by searching for "edit".
* Copy the following and save it as <code>test.py</code> in your folder:

<pre>
"""My first app"""

___name___ = "My app"
___license___ = "MIT"
___dependencies___ = ["ugfx_helper"]

import ugfx_helper, ugfx

ugfx_helper.init()
ugfx.clear()

ugfx.text(5, 5, "Hello World", ugfx.RED)
ugfx.fill_circle(100, 100, 30, ugfx.GREEN)
ugfx.fill_circle(200, 100, 30, ugfx.GREEN)
ugfx.area(80, 150, 140, 20, ugfx.GREEN)
ugfx.area(120, 170, 60, 20, ugfx.GREEN)

while Buttons.is_pressed(Buttons.BTN_Menu):
sleep.wfi() # This means sleep for a short while

ugfx.clear()
app.restart_to_default()
</pre>

Now you can run "./tilda_tools app my_app" - Wait a few seconds and you should see your app working on the screen.

It will now work even when the computer is disconnected. To load it you'll have to open it via the Launcher or use the settings app to make it your default app.

== 6. Publish your app to the app library ==

Now that you have your own smiley app, why not share it with others?

See https://badge.emfcamp.org/wiki/TiLDA_MK4/Badge_Store_Submissions for more information

TiLDA MK4

2018-09-01T16:42:30Z

Marekventur: /* Connecting over USB */

[[File:TiLDA_Mk4_Front_with_sponsors.png|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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 ====

# Press 'Menu'
# Select the 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|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.

=== Calling and SMS ===
Yes your TiLDA Badge is also a mobile phone. To connect to the EMF mobile network insert the Hologram SIM supplied, load the "phone" app, select "Select Operator", wait, wait some more, and a little longer, then select "EMF" or "23404". Select "Auto" to use a public mobile network again.

To find out your number on the EMF network select "Information" in the phone app. If "Operator" is not shown on the information screen then you have failed to connect to the network. If you are not given a number then wait a little longer and try again. You can read and send SMS messages with the "sms" app. You can also answer calls by pressing "Call" in any app, and end or reject a call using the "End" button at any time.

=== Connecting over USB ===
By default, the software is in a loop. If you want to interact over the REPL you need to exit this. The easiest way is to press Ctrl-C.

It's hard to press Ctrl-C in minicom, so on Linux this is easier to do with screen:
<pre>
screen /dev/tty.usbmodemTiLDA2
</pre>

To exit screen, press Ctrl-A, then k, then y.

The basic process is this:

# Connect device to computer with usb
# Fire up minicom or screen
# Press reset button on device
# Hit Ctrl+C quickly and with vigour to get to the REPL before the UI comes up

=== Nothing works! Help! ===

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

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA_MK4/tilda-tools|tilda-tools]]''' - the one-stop interface for all your badge needs
* '''[[TiLDA MK4/Get Started|Step-by-step]]''' - to make it as easy as possible to get going
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* '''[[TiLDA MK4/Badge Store Submissions|Badge Store Submissions]]''' - Share your creations with others
* '''[[TiLDA MK4/Code Structure|Code Structure]]''' - How the python code is structured

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK4/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK4/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments [http://www.ti.com/product/MSP432E401Y MSP432E4 SimpleLink Microcontroller] (ARM Cortex-M4F @ 120MHz)
* Texas Instruments [http://www.ti.com/product/CC3120 CC3120 SimpleLink Wi-Fi® Network Processor]
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* [https://simcom.ee/modules/gsm-gprs/sim800c/ SIM800 Quad-band GSM/GPRS module] with Bluetooth support
* [https://cdn.hackaday.io/files/11178478239552/ER-TFT024-3_Datasheet.pdf 240x320 RGB screen]
* 2 [https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf WS2812B RGB LEDs] (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments [http://www.ti.com/lit/ds/symlink/hdc2080.pdf HDC2080 Low Power Humidity and Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/tmp102.pdf TMP102 Digital Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/opt3001.pdf OPT3001 Digital Ambient Light Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/drv5055.pdf DRV5055 High Accuracy Bipolar Hall Effect Sensor]
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A [https://en.wikipedia.org/wiki/T9_(predictive_text) T9] number keypad and a joystick
* 2 [http://wiki.seeedstudio.com/Grove_System/ Seed Studio Grove headers] (one UART, one I²C)
* [https://learn.sparkfun.com/tutorials/sewing-with-conductive-thread Conductive thread] points and 0.1" header for power/UART/I2C/GPIO
* [https://hackaday.io/project/52950-defcon-26-shitty-add-ons Defcon 26 Shitty Add-Ons connector]

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

[[File:Sensor_graphic_-_with_fixed_transparency-01.png|left|500px|TiLDA Mk𝛿 Back]]
[[File:Sensor_graphic_-_with_fixed_transparency-02.png|left|500px|TiLDA Mk𝛿 Back]]

TiLDA MK4/Firmware Update

2018-09-01T13:27:52Z

Marekventur:

TiLDA Mk4 is being actively developed. This doesn't just include changes on the python code (which can be updated via the Badge Store), but also for the firmware. Think of it as updating your operating system. Like an operating system update it's a bit more involved than just updating applications.

Warning: You might potentially lose all your apps and settings.

What you need:
* A computer with USB and a cable to your badge
* A checkout of Mk4-Apps. See [[TiLDA_MK4/Badge_Store_Submissions| here]] for how to do that
* You need to have http://dfu-util.sourceforge.net/ installed

You should also look up how to use [[TiLDA_MK4/tilda-tools|tilda-tools]].

This is how to do it:
* Put your Badge into DFU mode. To do so press the centre of the joystick and quickly press reset while doing so. Release the joystick afterwards.
* Run the firmware update:
** OSX / Linux: Open a terminal, go to your Mk4-Apps folder and run "./tilda_tools firmware-update".
** Windows: Todo
* Follow the onscreen information
* Don't forget to press the reset buttons once the firmware update was successful.

TiLDA MK4

2018-09-01T13:20:18Z

Marekventur:

[[File:TiLDA_Mk4_Front_with_sponsors.png|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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 ====

# Press 'Menu'
# Select the 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|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.

=== Calling and SMS ===
Yes your TiLDA Badge is also a mobile phone. To connect to the EMF mobile network insert the Hologram SIM supplied, load the "phone" app, select "Select Operator", wait, wait some more, and a little longer, then select "EMF" or "23404". Select "Auto" to use a public mobile network again.

To find out your number on the EMF network select "Information" in the phone app. If "Operator" is not shown on the information screen then you have failed to connect to the network. You can read and send SMS messages with the "sms" app. You can also answer calls by pressing "Call" in any app, and end or reject a call using the "End" button at any time.

=== Connecting over USB ===
By default, the software is in a loop. If you want to interact over the REPL you need to exit this. The easiest way is to press Ctrl-C.

It's hard to press Ctrl-C in minicom, so on Linux this is easier to do with screen:
<pre>
screen /dev/ttyACM0 115200
</pre>

To exit screen, press Ctrl-A, then k, then y.

=== Nothing works! Help! ===

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

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA_MK4/tilda-tools|tilda-tools]]''' - the one-stop interface for all your badge needs
* '''[[TiLDA MK4/Get Started|Step-by-step]]''' - to make it as easy as possible to get going
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* '''[[TiLDA MK4/Badge Store Submissions|Badge Store Submissions]]''' - Share your creations with others
* '''[[TiLDA MK4/Code Structure|Code Structure]]''' - How the python code is structured

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK4/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK4/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments [http://www.ti.com/product/MSP432E401Y MSP432E4 SimpleLink Microcontroller] (ARM Cortex-M4F @ 120MHz)
* Texas Instruments [http://www.ti.com/product/CC3120 CC3120 SimpleLink Wi-Fi® Network Processor]
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* [https://simcom.ee/modules/gsm-gprs/sim800c/ SIM800 Quad-band GSM/GPRS module] with Bluetooth support
* [https://cdn.hackaday.io/files/11178478239552/ER-TFT024-3_Datasheet.pdf 240x320 RGB screen]
* 2 [https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf WS2812B RGB LEDs] (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments [http://www.ti.com/lit/ds/symlink/hdc2080.pdf HDC2080 Low Power Humidity and Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/tmp102.pdf TMP102 Digital Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/opt3001.pdf OPT3001 Digital Ambient Light Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/drv5055.pdf DRV5055 High Accuracy Bipolar Hall Effect Sensor]
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A [https://en.wikipedia.org/wiki/T9_(predictive_text) T9] number keypad and a joystick
* 2 [http://wiki.seeedstudio.com/Grove_System/ Seed Studio Grove headers] (one UART, one I²C)
* [https://learn.sparkfun.com/tutorials/sewing-with-conductive-thread Conductive thread] points and 0.1" header for power/UART/I2C/GPIO
* [https://hackaday.io/project/52950-defcon-26-shitty-add-ons Defcon 26 Shitty Add-Ons connector]

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

[[File:Sensor_graphic_-_with_fixed_transparency-01.png|left|500px|TiLDA Mk𝛿 Back]]
[[File:Sensor_graphic_-_with_fixed_transparency-02.png|left|500px|TiLDA Mk𝛿 Back]]

TiLDA MK4

2018-09-01T13:19:28Z

Marekventur:

[[File:TiLDA_Mk4_Front_with_sponsors.png|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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 ====

# Press 'Menu'
# Select the 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|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.

=== Calling and SMS ===
Yes your TiLDA Badge is also a mobile phone. To connect to the EMF mobile network insert the Hologram SIM supplied, load the "phone" app, select "Select Operator", wait, wait some more, and a little longer, then select "EMF" or "23404". Select "Auto" to use a public mobile network again.

To find out your number on the EMF network select "Information" in the phone app. If "Operator" is not shown on the information screen then you have failed to connect to the network. You can read and send SMS messages with the "sms" app. You can also answer calls by pressing "Call" in any app, and end or reject a call using the "End" button at any time.

=== Connecting over USB ===
By default, the software is in a loop. If you want to interact over the REPL you need to exit this. The easiest way is to press Ctrl-C.

It's hard to press Ctrl-C in minicom, so on Linux this is easier to do with screen:
<pre>
screen /dev/ttyACM0 115200
</pre>

To exit screen, press Ctrl-A, then k, then y.

=== Nothing works! Help! ===

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

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA_MK4/tilda-tools|tilda-tools]]''' - the one-stop interface for all your badge needs
* '''[[TiLDA MK4/Get Started|Step-by-step]]''' - to make it as easy as possible to get going
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* '''[[TiLDA MK4/Badge Store Submissions|Badge Store Submissions]]''' - Share your creations with others
* '''[[TiLDA MK4/Code Structure|Code Structure]]''' - How the python code is structured

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK4/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK4/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments [http://www.ti.com/product/MSP432E401Y MSP432E4 SimpleLink Microcontroller] (ARM Cortex-M4F @ 120MHz)
* Texas Instruments [http://www.ti.com/product/CC3120 CC3120 SimpleLink Wi-Fi® Network Processor]
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* [https://simcom.ee/modules/gsm-gprs/sim800c/ SIM800 Quad-band GSM/GPRS module] with Bluetooth support
* [https://cdn.hackaday.io/files/11178478239552/ER-TFT024-3_Datasheet.pdf 240x320 RGB screen]
* 2 [https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf WS2812B RGB LEDs] (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments [http://www.ti.com/lit/ds/symlink/hdc2080.pdf HDC2080 Low Power Humidity and Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/tmp102.pdf TMP102 Digital Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/opt3001.pdf OPT3001 Digital Ambient Light Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/drv5055.pdf DRV5055 High Accuracy Bipolar Hall Effect Sensor]
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A [https://en.wikipedia.org/wiki/T9_(predictive_text) T9] number keypad and a joystick
* 2 [http://wiki.seeedstudio.com/Grove_System/ Seed Studio Grove headers] (one UART, one I²C)
* [https://learn.sparkfun.com/tutorials/sewing-with-conductive-thread Conductive thread] points and 0.1" header for power/UART/I2C/GPIO
* [https://hackaday.io/project/52950-defcon-26-shitty-add-ons Defcon 26 Shitty Add-Ons connector]

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

[[File:Sensor_graphic_-_with_fixed_transparency-01.png|left|500px|TiLDA Mk𝛿 Back]]

TiLDA MK4/Run Code

2018-09-01T12:05:26Z

Marekventur: /* Use Mk4-Apps tilda_tools */

== Through the REPL ==
* Todo: Please write how to do that on different operating systems
* todo: how to use a REPL
== Use the "mass storage" app ==
* easy to do
* make sure to safely eject every time
* has a tendency to corrupt the filesystem - link to reset instructions
* hard to debug errors
* todo: add more information
== Use Mk4-Apps tilda_tools ==
* Probably most convenient, but a bit more involved:
* You can use "./tilda_tools run <file.py>" to run code without copying anything, but if you want to make sure you have all your libraries updated use "./tilda_tools app my_app" instead.
* https://badge.emfcamp.org/wiki/TiLDA_MK4/tilda-tools

TiLDA MK4/Run Code

2018-09-01T11:52:05Z

Marekventur: Created page with " == Through the REPL == * Todo: Please write how to do that on different operating systems * todo: how to use a REPL == Use the "mass storage" app == * easy to do * make sure..."

== Through the REPL ==
* Todo: Please write how to do that on different operating systems
* todo: how to use a REPL
== Use the "mass storage" app ==
* easy to do
* make sure to safely eject every time
* has a tendency to corrupt the filesystem - link to reset instructions
* hard to debug errors
* todo: add more information
== Use Mk4-Apps tilda_tools ==
* Probably most convenient, but a bit more involved:
* https://badge.emfcamp.org/wiki/TiLDA_MK4/tilda-tools

TiLDA MK4

2018-09-01T10:00:51Z

Marekventur: /* Basic usage */

[[File:TiLDA_Mk4_Front_with_sponsors.png|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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 ====

# Press 'Menu'
# Select the 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|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: [[TiLDA_MK4/reset|Resetting]]

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA_MK4/tilda-tools|tilda-tools]]''' - the one-stop interface for all your badge needs
* '''[[TiLDA MK4/Get Started|Step-by-step]]''' - to make it as easy as possible to get going
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* '''[[TiLDA MK4/Badge Store Submissions|Badge Store Submissions]]''' - Share your creations with others
* '''[[TiLDA MK4/Code Structure|Code Structure]]''' - How the python code is structured

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK4/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK4/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments [http://www.ti.com/product/MSP432E401Y MSP432E4 SimpleLink Microcontroller] (ARM Cortex-M4F @ 120MHz)
* Texas Instruments [http://www.ti.com/product/CC3120 CC3120 SimpleLink Wi-Fi® Network Processor]
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* [https://simcom.ee/modules/gsm-gprs/sim800c/ SIM800 Quad-band GSM/GPRS module] with Bluetooth support
* [https://cdn.hackaday.io/files/11178478239552/ER-TFT024-3_Datasheet.pdf 240x320 RGB screen]
* 2 [https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf WS2812B RGB LEDs] (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments [http://www.ti.com/lit/ds/symlink/hdc2080.pdf HDC2080 Low Power Humidity and Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/tmp102.pdf TMP102 Digital Temperature Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/opt3001.pdf OPT3001 Digital Ambient Light Sensor]
* Texas Instruments [http://www.ti.com/lit/ds/symlink/drv5055.pdf DRV5055 High Accuracy Bipolar Hall Effect Sensor]
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A [https://en.wikipedia.org/wiki/T9_(predictive_text) T9] number keypad and a joystick
* 2 [http://wiki.seeedstudio.com/Grove_System/ Seed Studio Grove headers] (one UART, one I²C)
* [https://learn.sparkfun.com/tutorials/sewing-with-conductive-thread Conductive thread] points and 0.1" header for power/UART/I2C/GPIO
* [https://hackaday.io/project/52950-defcon-26-shitty-add-ons Defcon 26 Shitty Add-Ons connector]

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

File:TiLDA Mk4 Front with sponsors.png

2018-08-30T11:51:06Z

Marekventur: Marekventur uploaded a new version of File:TiLDA Mk4 Front with sponsors.png

TiLDA MK4/Badge Store Submissions

2018-08-29T17:48:53Z

Marekventur: /* Packaging up your badge app for submission to the store */

Todo: Please elaborate on these steps

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

== Packaging up your badge app for submission to the store ==

Every app becomes a new folder in the root of the Mk4-App GitHub repository. So if you create a "snake" app, you need to put your program files in a folder called "snake" with at least a "main.py" in it.

App names need to be unique (the folder structure enforces that). App folders can contain multiple files (python and non python), but at a minimum "main.py" with the correct headers is required.

Plesae verify that your apps folder structure is correct by running "./tilda_tools validate" (this works without a badge) before submitting it to the badge app store as the validations is also run by Travis to check pull requests.

=== Headers ===

main.py headers:

<pre>
___name___ = "<your_app_name>"
___license___ = "MIT"
___dependencies___ = ["wifi", "http", "ugfx_helper", "sleep"]
___categories___ = ["<see below>"]
___bootstrapped___ = True # Whether or not apps get downloaded on first install. Defaults to "False", mostly likely you won't have to use this at all.
</pre>

Please use one of these categories:
* System
* Homescreens
* Games
* Sound
* EMF
* Villages
* Phone
* LEDs
* Sensors
* Demo
* Other

== Submitting your badge app to the official badge store ==

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address (link to set up user and email)
* Fork the emfcamp/Mk4-Apps repo (link)
* Clone '''your''' GitHub repo to your computer (link) (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo (link)
* Create a Pull Request (link)

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo (link)

TiLDA MK4/Badge Store Submissions

2018-08-29T10:46:01Z

Marekventur: /* Rules for apps in the official badge store */

Todo: Please elaborate on these steps

* Create github account
* clone repo (maybe mention https://desktop.github.com/ ?)
* create an app
* send PR

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

TiLDA MK4

2018-08-29T10:35:10Z

Marekventur: /* Hacking your badge */

[[File:TiLDA_Mk4_Front_with_sponsors.png|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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.

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 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|WiFi]]

=== Charging ===
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 [todo: is this still correct?]

=== Nothing works! Help! ===

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

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA_MK4/tilda-tools|tilda-tools]]''' - the one-stop interface for all your badge needs
* '''[[TiLDA MK4/Get Started|Step-by-step]]''' - to make it as easy as possible to get going
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* '''[[TiLDA MK4/App Store Submissions|App Store Submissions]]''' - Share your creations with others
* '''[[TiLDA MK4/Code Structure|Code Structure]]''' - How the python code is structured

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK3/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK3/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments MSP432E4 SimpleLink Microcontroller (ARM Cortex-M4F @ 120MHz)
* Texas Instruments CC3120 SimpleLink Wi-Fi® Network Processor
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* SIM800 Quad-band GSM/GPRS module with Bluetooth support
* 240x320 RGB screen
* 2 WS2812B RGB LEDs (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments HDC2080 Low Power Humidity and Temperature Sensor
* Texas Instruments TMP102 Digital Temperature Sensor
* Texas Instruments OPT3001 Digital Ambient Light Sensor
* Texas Instruments DRV5055 High Accuracy Bipolar Hall Effect Sensor
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A T9 number keypad and a joystick
* 2 Seed Studio Grove headers (one UART, one I²C)
* Conductive thread points and 0.1" header for power/UART/I2C/GPIO
* Defcon 26 Shitty Add-Ons connector
(todo: please add links from http://blog.emfcamp.org/post/177423823788/tilda-mk4-the-emf-2018-badge)

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

TiLDA MK4

2018-08-29T10:31:32Z

Marekventur: /* Hacking your badge */

[[File:TiLDA_Mk4_Front_with_sponsors.png|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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.

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 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|WiFi]]

=== Charging ===
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 [todo: is this still correct?]

=== Nothing works! Help! ===

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

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK4/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* [[TiLDA MK4/App Store Submissions|App Store Submissions]]
* [[TiLDA_MK4/tilda-tools|tilda-tools]] - the one-stop interface for all your badge needs

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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 MK4/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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK3/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK3/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments MSP432E4 SimpleLink Microcontroller (ARM Cortex-M4F @ 120MHz)
* Texas Instruments CC3120 SimpleLink Wi-Fi® Network Processor
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* SIM800 Quad-band GSM/GPRS module with Bluetooth support
* 240x320 RGB screen
* 2 WS2812B RGB LEDs (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments HDC2080 Low Power Humidity and Temperature Sensor
* Texas Instruments TMP102 Digital Temperature Sensor
* Texas Instruments OPT3001 Digital Ambient Light Sensor
* Texas Instruments DRV5055 High Accuracy Bipolar Hall Effect Sensor
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A T9 number keypad and a joystick
* 2 Seed Studio Grove headers (one UART, one I²C)
* Conductive thread points and 0.1" header for power/UART/I2C/GPIO
* Defcon 26 Shitty Add-Ons connector
(todo: please add links from http://blog.emfcamp.org/post/177423823788/tilda-mk4-the-emf-2018-badge)

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

TiLDA MK4/tilda-tools

2018-08-29T10:30:06Z

Marekventur: Created page with "=tilda-tools= * Todo: How to clone/download the Mk4 repo (link to general github page?) * Todo: List functionality from https://github.com/emfcamp/Mk4-Apps/blob/master/.devel..."

=tilda-tools=

* Todo: How to clone/download the Mk4 repo (link to general github page?)
* Todo: List functionality from https://github.com/emfcamp/Mk4-Apps/blob/master/.development/tilda_tools.py

TiLDA MK4/Firmware Update

2018-08-29T10:28:48Z

Marekventur: Created page with "TiLDA Mk4 is being actively developed. This doesn't just include changes on the python code (which can be updated via the Badge Store), but also for the firmware. Think of it..."

TiLDA Mk4 is being actively developed. This doesn't just include changes on the python code (which can be updated via the Badge Store), but also for the firmware. Think of it as updating your operating system. Like an operating system update it's a bit more involved than just updating applications.

Warning: You might potentially lose all your apps and settings.

What you need:
* A computer with USB and a cable to your badge
* A checkout of Mk4-Apps. See [[TiLDA_MK4/Badge_Store_Submissions| here]] for how to do that
* You need to have http://dfu-util.sourceforge.net/ installed

You should also look up how to use [[TiLDA_MK4/tilda-tools|tilda-tools]].

This is how to do it:
* Put your Badge into DFU mode. To do so press the joystick to the right (towards the screen) and quickly press reset while doing so. Release the joystick afterwards.
* Run the firmware update:
** OSX: Open a terminal, go to your Mk4-Apps folder and run "./tilda-tools firmware-update".
** Windows: Todo
** Linux: Todo
* Follow the onscreen information
* Don't forget to press the reset buttons once the firmware update was successful.

TiLDA MK4/Badge Store Submissions

2018-08-29T10:17:12Z

Marekventur:

TiLDA MK4/Badge Store Submissions

2018-08-29T10:16:39Z

Marekventur:

Todo: Please elaborate on these steps

* Create github account
* clone repo (maybe mention https://desktop.github.com/ ?)
* create an app
* send PR

== Rules for apps in the official badge store ==

* Has to be "Rated G: General Audiences – all ages admitted"
* Not be of malicious nature
* Complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)

TiLDA MK4/Badge Store Submissions

2018-08-29T10:16:17Z

Marekventur:

Todo: Please elaborate on these steps

* Create github account
* clone repo (maybe mention https://desktop.github.com/ ?)
* create an app
* send PR

# Ground rules for apps in the official badge store:

* Has to be "Rated G: General Audiences – all ages admitted"
* Not be of malicious nature
* Complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)

TiLDA MK4/Badge Store Submissions

2018-08-29T10:12:56Z

Marekventur: Created page with "Todo: * Create github account * clone repo (maybe mention https://desktop.github.com/ ?) * create an app * send PR # Ground rules for apps in the official badge store *..."

Todo:

* Create github account
* clone repo (maybe mention https://desktop.github.com/ ?)
* create an app
* send PR

# Ground rules for apps in the official badge store

* Has to be
* Has to be "Rated G: General Audiences – all ages admitted"
* Complies with EMF's [https://www.emfcamp.org/code-of-conduct COC]

TiLDA MK4/reset

2018-08-29T10:07:43Z

Marekventur: Created page with "Should your badge stop working there are these ways to fix it. Please make sure you have a backup of whatever you've been working on, you might lose all the data stored on you..."

Should your badge stop working there are these ways to fix it. Please make sure you have a backup of whatever you've been working on, you might lose all the data stored on your badge.

Todo: Is there an easier way?

== Factory reset the badge==
Press and hold 'MENU' and then press the reset button on the back. Keep the MENU button held down, then release it when both the green and red LED are on. Both LEDs should flash for a few times. Wait a few seconds until the blinking has stopped and press reset again.

After that you should finally get a screen saying "Downloading TiLDA software". It should take less than a minute until the badge functionalities are restored, but you will have to re-install your apps.

P.S. The micropython documentation on factory resetting is [http://docs.micropython.org/en/latest/pyboard/pyboard/tutorial/reset.html here]. On the TiLDA MK3 the USR button is the MENU button, and the orange LED is actually red.

TiLDA MK4/ugfx

2018-08-29T09:16:41Z

Marekventur: Created page with "The badge makes use of [http://ugfx.io uGFX] for providing drawing functions on the LCD. Most of this functionality is available through the micropython interface, and you may..."

The badge makes use of [http://ugfx.io uGFX] for providing drawing functions on the LCD. Most of this functionality is available through the micropython interface, and you may wish to browse the [https://wiki.ugfx.io/index.php/Main_Page uGFX documentation] for more details.

To discover exactly which ugfx calls are available in micropython, see https://github.com/emfcamp/micropython/blob/tilda-master/stmhal/modugfx.c

== Basic usage ==

uGFX is comprised of 'widgets,' such as buttons and labels, and 'containers' which are used to group widgets.

To create a button on the screen, use <code>ugfx.Button(x,y,width,height,text)</code>, and a button will be drawn on the screen.

As well as widgets, there are 'primitives' such as drawing circles and lines, which can be drawn anywhere on the screen or in a container.
For example <code>ugfx.circle(50,50,20,ugfx.RED)</code> will draw a circle.

== Detailed documentation ==

Note. all co-ordinates are from the top left (battery symbol) corner. All widgets are created from the "ugfx" package, eg: ugfx.Contailer().

=== Colour format ===

Internally, ugfx uses 565 format (5 bits for red and blue, 6 for green). Preset colours are available, for example '''ugfx.RED''', '''ugfx.ORANGE''', etc. To convert from 24 bit RGB format, use '''ugfx.html_color(0xRRGGBB)''' to return the 16 bit 565 format.

=== Styles and Fonts ===
Use <code>ugfx.set_default_font(...)</code> to change the font. The font options are:
* ''ugfx.FONT_SMALL''
* ''ugfx.FONT_MEDIUM''
* ''ugfx.FONT_MEDIUM_BOLD''
* ''ugfx.FONT_TITLE''
* ''ugfx.FONT_NAME''.
Note that widgets use the font which was default when they were created, while the ''container.text()'' primitive uses the font that was default when the container was created

=== Containers ===

.Container(x, y, width, height {,style}) # the style is optional

Containers can be used to group widgets together. They can also perform primitive drawing functions. When drawing widgets or primitives, the coordinates are relative to the top left corner of the container.

Containers can be shown or hidden, and all the widgets will be redrawn. Containers can also be placed on top of other widgets. When the top container is hidden, the widgets below will be redrawn.

Upon creation a style can be passed to a container, which will then be used by default by widgets created as part of that container. If no style is specified at creation, the current default style will be used.

The following example shows how to create a container, add an object and show it.
<pre>
c = ugfx.Container(100,100,200,100)
b = ugfx.Button(10, 10, 40, 30, "OK", c)
c.show() # the container will not be shown until this point
</pre>

=== Primitives ===
All primitives can be drawn anywhere on the screen with, for example <code>ugfx.circle(..)</code>, or anywhere within a container, with <code>c=ugfx.Container(30,30,100,100); c.circle(..)</code>

==== Clear ====

<code>.clear(colour = ugfx.WHITE)</code>

clears the screen to the specified colour. Warning, this is slow!

==== Lines ====
<code>.line(<x1>, <y1>, <x2>, <y2>, <colour>)</code>

<code>.thickline(<x1>, <y1>, <x2>, <y2>, <colour>, <width>, <round>)</code>

Draws a line from ''x1,y1'' to ''x2,y2'' using ''colour''. Thickline will draw a line or arbitrary width, with the option of rounded corners

eg. ''ugfx.thickline(0,0,100,170,ugfx.YELLOW,7,0)''

==== Circle ====
<code>.circle(x, y, diameter, colour)</code>

<code>.fill_circle(x, y, diameter, colour)</code>

Draws a circle at ''x,y'' of <diameter> using ''colour'', either with a 1 pixel border or filling the area.

eg. ''ugfx.circle(180,150,40,ugfx.RED)''

==== Arc ====
<code>.arc(x, y, r, angle1, angle2, colour)</code>

<code>.fill_arc(x, y, r, angle1, angle2, colour)</code>

Similar to the circle functions, however two angle parameters specify between which two angles drawing occurs

==== Ellipse ====
<code>.ellipse(x, y, a, b, colour)</code>

<code>.fill_ellipse(x, y, a, b, colour)</code>

Draws an ellipse at ''x,y'' of ''a'' width and ''b'' height using ''colour'', either with a 1 pixel border or filling the area.

==== Rectangles ====
<code> .box(1, y, a, b, colour) </code>

<code> .area(x, y, a, b, colour)</code>

Draws a rectangle or filled rectangle at ''x,y'' of ''a'' width and ''b'' height using ''colour''.

==== Polygon ====
<code> .polygon(x, y, array, colour) </code>

<code> .fill_polygon(x, y, array, colour) </code>

Draws or fills a polygon starting at ''x,y'' using ''colour''. ''Array'' is an array of coordinates that specifies the corners.

eg. ''ugfx.polygon(0,0, [ [0,20],[20,20],[20,0]], ugfx.RED)''

==== Text ====
<code>.text(x, y, text, colour) </code>

Draws a text string ''text'' at ''x,y'' in ''colour''.
Note that a ugfx.text(..) call will take the default font, while container.text(..) will take the containers font.

eg. ''ugfx.text(40,40,"My name is...",ugfx.BLUE)''

==== Other ====
<code>.width()</code>

<code>.height()</code>

Gets the height or width of the screen ''ugfx.width()'' or container object ''c.width()''

=== Widgets ===

Widgets can be drawn anywhere on the screen, or within a container. The widgets take the optional parameter ''parent='' to set the parent container. Widgets can have their style set on creation, otherwise will inherit

Widgets also accept input from the buttons. For example, the 'A' button can be 'attached' to an on-screen button, such that pressing the button on the badge causes the on-screen button to be redrawn in a depressed state.

==== Common Widget methods ====

<code>.text([text])</code>

Gets or sets the text displayed by the widget.

<code>.visible([show])</code>

Gets or sets the visibility of the badge. ''b.visible(0)'' will hide, and ''b.visible(1)'' will show.

<code>.attach_input(button, function)</code>

Attaches a physical button to a widget, so that the user can cause the widget to redraw, for example to scroll or become depressed.

The input ''button'' specifies which button, with the options ugfx.BTN_A, ugfx.BTN_B, ugfx.BTN_MENU, ugfx.JOY_UP, ugfx.JOY_DOWN, ugfx.JOY_LEFT, ugfx.JOY_RIGHT.

The input ''function'' specifies what the button actually does. For example, the list has three different functions: scroll up, scroll down, and select. Note that some widgets by default attach the joystick to the relevant functions.

<code>.detach_input(function)</code>

Detaches an input. See above for more details.

<code>.destroy()</code>

Frees up all the resources assoicated with the object. While the micropython garbage collector will clear any old objects, the graphics library also has its own memory area, which can become full if objects are not destroyed after they are needed.

<code>.set_focus()</code>

Gives focus to the widget instance. Normally this will draw a box around the widget, the colour is specified by the style.

==== Button ====

<code> b=ugfx.Button(x, y, w, h, text, *, parent=None, trigger=None, shape=ugfx.Button.RECT, style=None) </code> (note: parameters after '*' are optional)

Draws a button at ''x,y'' having width ''a'' and height ''b''. The option 'trigger' specifics which physical switch (if any) causes the display to be redrawn. The shape options are ''ugfx.Button.RECT'', ''ugfx.Button.ROUNDED'', ''ugfx.Button.ELLIPSE'', ''ugfx.Button.ARROW_UP'', ''ugfx.Button.ARROW_DOWN'', ''ugfx.Button.ARROW_LEFT', ''ugfx.Button.ARROW_RIGHT''.

==== Textbox ====
<code> ugfx.Textbox(x, y, w, h, *, text=None, parent=None, maxlen=255})</code>

Draws a text edit-box which can take input from the on-screen keyboard. Will automatically accept key-presses from the keyboard, which will edit the text. The textbox needs to have focus using .set_focus() for it to receive the key-presses.

==== Checkbox ====

<code>.Checkbox((x, y, w, h, text=None, parent=None, trigger=None, style=None)</code>

<code>.checked()</code>

Get or set the checked state

==== Label ====

<code> ugfx.Label(x, y, w, h, text, *, parent=None, style=None, justification=None)</code>

A label displays text. Unlike the primitive text, this Label supports different justifications, wordwrap and changing text. The different justification options are ''ugfx.Label.LEFT'', ''ugfx.Label.RIGHT'', ''ugfx.Label.CENTER'', ''ugfx.Label.LEFTTOP'', ''ugfx.Label.RIGHTTOP'' and ''ugfx.Label.CENTERTOP''.

==== List ====

<code>ugfx.List(x, y, w, h, *, parent=None, up=ugfx.JOY_UP, down=ugfx.JOY_DOWN, style=None)</code>

<code>.enable_draw()</code>

<code>.disable_draw()</code>

<code>.add_item(text)</code>

<code>.assign_image(index, image)</code>

<code>.remove_item(index)</code>

<code>.selected_text()</code>

<code>.selected_index()</code>

<code>.count()</code>

==== Graph ====

<code>ugfx.Graph(x, y, w, h, origin_x, origin_y)</code>

<code>.show()</code>

<code>.hide()</code>

<code>.set_arrows(ugfx.Graph.ARROWS_X_POS | ugfx.Graph.ARROWS_Y_POS)</code>

Set which axes have arrows and in which direction. In this example arrows are set for the x and y positive directions, with the following options available: ARROWS_X_POS, ARROWS_Y_POS, ARROWS_X_NEG, ARROWS_Y_NEG

<code>.plot( point(s)_x, point(s)_y, {new_series} )</code>

Plot either an array, or a point. Optional second parameter specifies whether to start a new series or join onto previous.

<code>.appearance( thing_to_change, shape, size, colour, {spacing} )</code>

Changes the style of either points, lines, axis or grids. Each parameter is used as follows:

'thing_to_change' - select what aspect to change, the options are {STYLE_POINT, STYLE_LINE, STYLE_XAXIS, STYLE_YAXIS, STYLE_XGRID, STYLE_YGRID}

'shape' - selects the shape of the thing to change, where the options depend on what you are changing.
The options for points is: {POINT_NONE, POINT_DOT, POINT_SQUARE, POINT_CIRCLE}
The options for line/axis/grid are: {LINE_NONE, LINE_SOLID, LINE_DOT, LINE_DASH}

'size' - number of pixels wide of the thing to change

'colour' - use UGFX.Red, UGFX.Orange,... or UGFX.html_color(0xRRGGBB) to ensure the right format

'spacing' - only valid for grid

See the [https://github.com/emfcamp/Mk3-Firmware/blob/master/apps/logger/main.py BARMS logger app] for an example

==== ImageBox ====

<code>.ImageBox(x, y, w, h, filename, *, cache=0, parent=None, style=None)</code>

==== Keyboard ====

<code>.Keyboard(x, y, w, h, parent=None)</code>

=== Styles ===
<pre>
s=ugfx.Style() # create a style based on the current default style

s.set_enabled([text_colour, edge_colour, fill_colour, progress_colour]) # sets the style for when something is enabled
s.set_pressed([text_colour, edge_colour, fill_colour, progress_colour]) # sets the style for when something is pressed
s.set_disabled([text_colour, edge_colour, fill_colour, progress_colour]) # sets the style for when something is disabled

s.set_focus(colour) # sets the colour used for focus
s.set_background(colour) # sets the background colour for the style

ugfx.set_default_style(s) # use this style from now on

b=ugfx.Button(0,0,40,30,"OK", style=s) # use the style for this button

</pre>

== Tips and tricks ==

=== Tearing ===

When writing large areas of the screen, a 'tearing' [https://en.wikipedia.org/wiki/Screen_tearing] effect may be observed.

The screen module is comprised of a large memory, with one memory location to store the RGB data for each pixel. The LCD driver continuously updates the LCD pixels, by reading the memory in a sequential, line-by-line manner, and updating the LCD with the data from the memory. This 'read line-pointer' moves from the top to the bottom of the screen (when viewed in portrait), at about 70Hz (the refresh rate of the screen)

This large memory as part of the screen means it can be driven by a microcontroller which may have a considerably smaller memory. The microcontroller therefore only needs to update the memory when it whats the content to change.

Consider the scenario where the microcontroller wants to set the screen from one colour to another. The microcontroller needs to update the entire memory (320x240x2 = 153kB) with the new colour. At the same time the 'read line-pointer' is reading the same memory to update the LCD. In this case, tearing occurs if the 'read line-pointer' reads the top half of the memory containing the new colour, but then catches up with microcontroller writing to the memory, then the 'read line-pointer' starts reading the old colour in the bottom half of the memory.

To avoid tearing the 'read line-pointer' should not cross the region the microcontroller is updating. Since the microcontroller writes to the screen slightly slower than the LCD reads it, providing the microntroller starts writes to the top of the memory just after the LCD starts reading from the top, the read and write pointers will not overlap, and tearing will not occur. To sync the microcontroller with the LCD 'read line-pointer,' there is a vsync/tear output (connected to pin named 'TEAR') which is pulled high when the 'read line-pointer' reaches a given line (default is line 0). This can be turned on and off with '''ugfx.enable_tear()''' and '''ugfx.disable_tear()'''. To change the line at which the tear output is generated, use '''ugfx.set_tear_line(0..319)'''.

Example code:

ugfx.enable_tear()
tear = pyb.Pin("TEAR", pyb.Pin.IN)

def vsync():
while tear.value() == 0:
pass
while tear.value():
pass

=== Reducing power consumption ===
Use the following to dim the backlight, which uses about 80mA at full brightness
<pre>
ugfx.backlight(b) # sets the backlight. Range is 0-100
b = ugfx.backlight() # reads the current backlight
</pre>

== Top-Level calls ==

<code>.power_mode(<mode>)</code>

''mode'' can be any of: ugfx.POWER_ON, ugfx.POWER_OFF, ugfx.POWER_DEEP_SLEEP, ugfx.POWER_SLEEP

<code>.orientation(deg)</code>

Rotate the display by number of degrees, eg 180 for upside-down.

Calling with no args returns the current value

<code>.display_image(x, y, '/path/to/image', orientation)</code>
<code>.display_image(x, y, img_obj, orientation)</code>

Display an image from a file of a supported type, or a previously opened image object, on screen at the x,y co-ordinates. Optionally change its orientation.

<code>.write_command(0x35,0)</code>

Low-level command to write to a data register directly.

<code>.poll()</code>

Yield to ensure the screen is redrawn when waiting on user input

<code>.ball_demo()</code>

Ball Demo!

<code>.get_pixel(x, y)</code>

Returns the colour of the pixel at x,y

<code>.Image(filename, cacheme)</code>

Creates and returns (or loads from cache) a ugfx image object from the image in the filename.

TiLDA MK3/modtilda

2018-08-29T09:15:57Z

Marekventur: Created page with "todo: spec this out <pre> >>> import tilda >>> dir(tilda) ['__class__', '__name__', 'Buttons', 'LED', 'Sensors', 'main', 'storage_disable_usb', 'storage_enable_usb'] >>> dir(..."

todo: spec this out

<pre>
>>> import tilda
>>> dir(tilda)
['__class__', '__name__', 'Buttons', 'LED', 'Sensors', 'main', 'storage_disable_usb', 'storage_enable_usb']
>>> dir(tilda.Buttons)
['__class__', '__name__', 'BTN_0', 'BTN_1', 'BTN_2', 'BTN_3', 'BTN_4', 'BTN_5', 'BTN_6', 'BTN_7', 'BTN_8', 'BTN_9', 'BTN_A', 'BTN_B', 'BTN_Call', 'BTN_End', 'BTN_Hash', 'BTN_Menu', 'BTN_Star', 'JOY_Center', 'JOY_Down', 'JOY_Left', 'JOY_Right', 'JOY_Up', 'disable_all_interrupt', 'disable_interrupt', 'disable_menu_reset', 'enable_interrupt', 'enable_menu_reset', 'get_all_states', 'has_interrupt', 'is_pressed', 'is_triggered']
>>> dir(tilda.LED)
['__class__', '__name__', 'GREEN', 'RED', 'off', 'on', 'toggle']
>>> dir(tilda.Sensors)
['__class__', '__name__', 'BAT_ADAPTER_24', 'BAT_DONE_CHARGING', 'BAT_FAST_CHARGING', 'BAT_NOT_CHARGING', 'BAT_NO_INPUT', 'BAT_OTG', 'BAT_PRE_CHARGING', 'BAT_USB_HOST', '_raw_bq', 'get_charge_status', 'get_hdc_humidity', 'get_hdc_temperature', 'get_lux', 'get_tmp_temperature', 'get_vbus_connected', 'sample_rate']
</pre>

TiLDA MK4

2018-08-29T09:11:51Z

Marekventur:

[[File:TiLDA_Mk4_Front_with_sponsors.png|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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.

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 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|WiFi]]

=== Charging ===
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 [todo: is this still correct?]

=== Nothing works! Help! ===

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

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK4/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* [[TiLDA MK4/App Store Submissions|App Store Submissions]]

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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 MK4/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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK3/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK3/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments MSP432E4 SimpleLink Microcontroller (ARM Cortex-M4F @ 120MHz)
* Texas Instruments CC3120 SimpleLink Wi-Fi® Network Processor
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* SIM800 Quad-band GSM/GPRS module with Bluetooth support
* 240x320 RGB screen
* 2 WS2812B RGB LEDs (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments HDC2080 Low Power Humidity and Temperature Sensor
* Texas Instruments TMP102 Digital Temperature Sensor
* Texas Instruments OPT3001 Digital Ambient Light Sensor
* Texas Instruments DRV5055 High Accuracy Bipolar Hall Effect Sensor
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A T9 number keypad and a joystick
* 2 Seed Studio Grove headers (one UART, one I²C)
* Conductive thread points and 0.1" header for power/UART/I2C/GPIO
* Defcon 26 Shitty Add-Ons connector
(todo: please add links from http://blog.emfcamp.org/post/177423823788/tilda-mk4-the-emf-2018-badge)

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

File:TiLDA Mk4 Front with sponsors.png

2018-08-29T09:11:14Z

Marekventur:

TiLDA MK4

2018-08-29T09:06:23Z

Marekventur: copy from mk3

[[File:TiLDA_MK4_front.jpg|right|500px|TiLDA Mk𝛿]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK4/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> 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.<br>If this doesn't work you can [[TiLDA_MK4/Firmware_Update|update the badge firmware]]. If this doesn't work, please come and join us in #tilda on [https://freenode.net/ Freenode IRC]</div>

=== 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.

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 'Settings" app
# "Change Name" 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 'Badge Store' app and press 'A'
# Select "Install"
# 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 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: [[TiLDA MK4/wifi|WiFi]]

=== Charging ===
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 [todo: is this still correct?]

=== Nothing works! Help! ===

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

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

== Hacking your badge ==

'''[[TiLDA_MK4/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK4/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK4/Run Code|3 Ways to run code on your TiLDA]]'''
* [[TiLDA MK4/App Store Submissions|App Store Submissions]]

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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 MK4/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: [[TiLDA MK4/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/Mk4-Apps
* https://github.com/emfcamp/Mk4-Backend (powers the badge store)
* https://github.com/emfcamp/micropython

=== Some ideas ===

[[TiLDA MK4/Ideas|Please share what you've done (or want to do) with others!]]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK4/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK4/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK4/rtc|RTC]] (real time clock)
* [[TiLDA MK4/sensors|Sensors]]
* [[TiLDA MK3/sim800|SIM800]] (GSM/Phone/Bluetooth)
* [[TiLDA MK3/modtilda|import tilda]] (our custom micropython module)
* [[TiLDA MK4/spi|SPI]] SPI
* please add

=== 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 <code>lib</code> 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 [https://github.com/emfcamp/Mk4-Hardware]

== Badge hardware ==

TiLDA comes with a long list of very useful hardware. Some might be obvious, but some are a bit hidden.
* Texas Instruments MSP432E4 SimpleLink Microcontroller (ARM Cortex-M4F @ 120MHz)
* Texas Instruments CC3120 SimpleLink Wi-Fi® Network Processor
* 256KB internal RAM / 8MB external SDRAM
* 1MB internal flash (firmware) / 1MB external flash (filesystem)
* SIM800 Quad-band GSM/GPRS module with Bluetooth support
* 240x320 RGB screen
* 2 WS2812B RGB LEDs (aka Neopixels) with a 3-pin header to connect your own (And this year they’re the right way up!)
* Texas Instruments HDC2080 Low Power Humidity and Temperature Sensor
* Texas Instruments TMP102 Digital Temperature Sensor
* Texas Instruments OPT3001 Digital Ambient Light Sensor
* Texas Instruments DRV5055 High Accuracy Bipolar Hall Effect Sensor
* Speaker and Microphone
* 2000mAh Battery
* Onboard Ethernet (requires breakout)
* A T9 number keypad and a joystick
* 2 Seed Studio Grove headers (one UART, one I²C)
* Conductive thread points and 0.1" header for power/UART/I2C/GPIO
* Defcon 26 Shitty Add-Ons connector
(todo: please add links from http://blog.emfcamp.org/post/177423823788/tilda-mk4-the-emf-2018-badge)

Hardware files are available on GitHub [https://github.com/emfcamp/Mk4-Hardware].

TiLDA MK3

2016-08-07T11:19:43Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.<br>If this doesn't work you can [https://update.badge.emfcamp.org/ update the badge firmware]. If this doesn't work, please come and see us at the badge tent</div>

<div style="background-color: #DDFFFF; border: 1px solid #808000; padding: 5px;">If you're having problems downloading some apps from the App Library <b>please update your badge via the App Library update option</b>. After a restart it should work much smoother.</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''
* [[TiLDA MK3/App Store Submissions|App Store Submissions]]

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3/App Store Submissions

2016-08-07T09:49:02Z

Marekventur: /* How to submit */

== How to submit ==
Zip your folder up, sign up to http://api.badge.emfcamp.org/, create a new app and publish it

== Common Problems ==
Please check these things before publishing your app:
* Your app will end up in "app/username~appname", so please make sure all you paths are using that. Example: <code>open("app/myname~myapp/some.json")</code>
* Please make sure the meta data at the top of the file is ok
* Please make sure to use <code>ugfx.init()</code> and <code>buttons.init()</code>, it makes it easier for me to review

Besides those, there are currently problems with apps that have too many files (lots of images for example) or use too much memory (big arrays). If it's possible in any way, please try to keep both down. We're working on reducing memory usage.

TiLDA MK3/App Store Submissions

2016-08-07T09:48:54Z

Marekventur: Created page with "== How to submit == Zip your folder up, sign up to http://api.badge.emfcamp.org/, create a new app and publish it == Common Problems == Please check these things before publ..."

TiLDA MK3

2016-08-07T09:44:14Z

Marekventur: /* Hacking your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.<br>If this doesn't work you can [https://update.badge.emfcamp.org/ update the badge firmware] and try a factory reset afterwards. If this doesn't work, please come and see us at the badge tent</div>

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;">The TiLDA <b>app library doesn't want to download some apps at the moment due to memory issues, but you can download them manually</b> from http://api.badge.emfcamp.org/apps - Unzip them, put them in a folder named "lowercase-username~lowercase-appname" and copy that folder into the "apps" folder on the badge. Make sure to "safely eject" the usb drive before resetting your badge. We're trying to resolve the issue as soon as possible.<br><br>If you want to <b>help us debug</b> the issue, please join #tilda on freenode (IRC). Github issue is here: https://github.com/emfcamp/Mk3-Firmware/issues/71</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''
* [[TiLDA MK3/App Store Submissions|App Store Submissions]]

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3

2016-08-06T19:29:08Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.<br>If this doesn't work you can [https://update.badge.emfcamp.org/ update the badge firmware] and try a factory reset afterwards. If this doesn't work, please come and see us at the badge tent</div>

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;">The TiLDA <b>app library doesn't want to download some apps at the moment due to memory issues, but you can download them manually</b> from http://api.badge.emfcamp.org/apps - Unzip them, put them in a folder named "lowercase-username~lowercase-appname" and copy that folder into the "apps" folder on the badge. Make sure to "safely eject" the usb drive before resetting your badge. We're trying to resolve the issue as soon as possible.<br><br>If you want to <b>help us debug</b> the issue, please join #tilda on freenode (IRC). Github issue is here: https://github.com/emfcamp/Mk3-Firmware/issues/71</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

Main Page

2016-08-06T15:35:10Z

Marekventur: /* EMF2016 - TiLDA Mkπ */

The aim of the EMF badge is to give people interesting hardware they've probably not experimented with before while being simple enough that anyone can play with it.

==EMF2016 - TiLDA Mkπ==
[[File:TiLDA_MK3_front.jpg|right|thumb|TiLDA Mkπ|link=TiLDA_MK3]]

'''<span style="color:red">You want to go here</span> ----> [[TiLDA_MK3]] main page.'''

See this years badge announcement on our blog<br/>

http://blog.emfcamp.org/post/144514906298/tilda-mkπ-the-hackable-conference-badge-that

Update, we have sponsors, the badge is saved!

http://blog.emfcamp.org/post/145667126793/the-emf-tilda-badge-is-saved

==EMF2014 - TiLDA MKe==
[[File:Tumblr_inline_n9znh3W5tC1rpuop0.jpg|right|thumb|TiLDA MKe]]

The [[TiLDA MKe|TiLDA MKe project]] is code named "ElectroMagnetic Boogaloo"

The MKe is an entirely new design, based on the Arduino Due. It brings an LCD display, Accelerometer and Gyro, along with a long-range wireless transceiver. The original specification was to give people live schedule updates and camp notifications, but the hardware was capable of much more.

Please Note: There are a couple of minor hardware and some firmware issues with the MKe 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 :)
<div style="clear: both"></div>

==EMW2013 - SiNE==
[[File:800px-SiNE_Front_Angle.JPG|thumb|300px]]
[[SiNE|SiNE: Investigating the Neighbourhood of EMW]]

Each attendee of Electromagnetic Wave received a SiNE badge, allowing them to take part in a treasure hunt based around the boat. By solving the clues, attendees were directed to an object or location either on or near the Stubnitz. The clue letter was also the first letter of the answer - large matching letters fitted with IR code transmitters were stored at each location. Holding your badge in front of the letter lit the corresponding light on a badge, allowing the user to collect them all!

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

==EMF2012 - TiLDA MK1==
[[File:Emf2012_badge_pcb.png|thumb|300px]]<br/>
[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>

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

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

TiLDA MK3

2016-08-06T14:53:05Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.<br>If this doesn't work you can [https://update.badge.emfcamp.org/ update the badge firmware] and try a factory reset afterwards. If this doesn't work, please come and see us at the badge tent</div>

<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). Github issue is here: https://github.com/emfcamp/Mk3-Firmware/issues/71</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3/memory problems

2016-08-06T14:50:14Z

Marekventur: Created page with "=Call for Help: Memory Issues= Please help the badge team: https://github.com/emfcamp/Mk3-Firmware/issues/71"

=Call for Help: Memory Issues=

Please help the badge team: https://github.com/emfcamp/Mk3-Firmware/issues/71

TiLDA MK3

2016-08-06T14:42:57Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.<br>If this doesn't work you can [https://update.badge.emfcamp.org/ update the badge firmware] and try a factory reset afterwards. If this doesn't work, please come and see us at the badge tent</div>

<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) or look [[TiLDA_MK3/memory_problems|here]]</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3

2016-08-06T13:33:24Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.<br>If this doesn't work you can [https://update.badge.emfcamp.org/ update the badge firmware] and try a factory reset afterwards. If this doesn't work, please come and see us at the badge tent</div>

<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!</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3

2016-08-06T11:17:50Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.</div>

<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!</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3

2016-08-06T11:14:04Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.</div>

<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!</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|Resetting]]

== Hacking your badge ==

'''[[TiLDA_MK3/Introduction_to_badge_hacking|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3/Run Code

2016-08-06T09:26:43Z

Marekventur:

This video is meant for the micropython board, but most of it works similar on the TiLDA: https://micropython.org/

= Option 1: REPL =
REPL stands for "[https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop Read–eval–print loop]" and allows you to run python code, line by line. This is a great way to see effects of certain hardware commands instantly and to test basic python features.

This allows you to run code, line by line, on the badge and to see the effects instantly. Follow https://micropython.org/doc/tut-repl or follow step 1-4 on the [[TiLDA_MK3/Get_Started|Get Started]] guide.

<strong>Note:</strong> This will only work if you have an empty <code>main.py</code> on your badge to stop the home screen from taking over instantly. If an app or script is already running you will not get a REPL that you can use to program, but simple debug output instead. Remember to remove it afterwards if you want to use the home screen again.

= Option 2: Copying files =
You can also copy your code to <code>main.py</code> on your badge, safely eject and then reset the badge via the button. To debug it you can use the serial console (see option 1) which will show you all text printed via <code>print()</code> and errors.

<strong>Note:</strong> It's very important to always correctly "eject" the usb storage before pressing the reset button, otherwise your filesystem is going to corrupt and you might have to [[TiLDA_MK3/reset|factory reset]] your badge

Remember to remove your main.py afterwards if you want to use the home screen again.

= Option 3: pyboard.py =
You can also use micropythons's <code>pyboard.py</code> script to automatically run a full local file of code without having to worry about copying it line-by-line or ejecting your device.

You can find a quick introduction on how to set it up [https://badge.emfcamp.org/wiki/TiLDA_MK3/Get_Started#5._Run_a_whole_file_of_code here].

This option is very useful as a build script with your editor, it allows you to quickly test whether your app is working.

<strong>Note:</strong> While this option works even if you run the home screen, it works slightly better if you have an empty <code>main.py</code> on your badge.

=== Sublime Text 2 build script ===
OSX:
<pre>
{
"shell_cmd": "/path/to/your/pyboard.py --device /dev/tty.usbmodem* $file"
}
</pre>

TiLDA MK3

2016-08-06T08:25:06Z

Marekventur: /* Using your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]

== Using your badge ==

<div style="background-color: #FFFFDD; border: 1px solid #808000; padding: 5px;"><strong>If you just got your badge and it doesn't do anything</strong>, don't despair, quite a few of them need to be [[TiLDA_MK3/reset|factory reset]] before showing the loading screen. Press and hold <code>MENU</code> while quickly pressing the reset button at the back. Keep the <code>MENU</code> button hold for another 2 seconds while the green light on the front is blinking. Release it <i>while</i> the green light is on.</div>

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3/Run Code

2016-08-06T08:17:46Z

Marekventur:

= Option 1: REPL =
REPL stands for "[https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop Read–eval–print loop]" and allows you to run python code, line by line. This is a great way to see effects of certain hardware commands instantly and to test basic python features.

This allows you to run code, line by line, on the badge and to see the effects instantly. Follow https://micropython.org/doc/tut-repl or follow step 1-4 on the [[TiLDA_MK3/Get_Started|Get Started]] guide.

<strong>Note:</strong> This will only work if you have an empty <code>main.py</code> on your badge to stop the home screen from taking over instantly. If an app or script is already running you will not get a REPL that you can use to program, but simple debug output instead. Remember to remove it afterwards if you want to use the home screen again.

= Option 2: Copying files =
You can also copy your code to <code>main.py</code> on your badge, safely eject and then reset the badge via the button. To debug it you can use the serial console (see option 1) which will show you all text printed via <code>print()</code> and errors.

<strong>Note:</strong> It's very important to always correctly "eject" the usb storage before pressing the reset button, otherwise your filesystem is going to corrupt and you might have to [[TiLDA_MK3/reset|factory reset]] your badge

Remember to remove your main.py afterwards if you want to use the home screen again.

= Option 3: pyboard.py =
You can also use micropythons's <code>pyboard.py</code> script to automatically run a full local file of code without having to worry about copying it line-by-line or ejecting your device.

You can find a quick introduction on how to set it up [https://badge.emfcamp.org/wiki/TiLDA_MK3/Get_Started#5._Run_a_whole_file_of_code here].

This option is very useful as a build script with your editor, it allows you to quickly test whether your app is working.

<strong>Note:</strong> While this option works even if you run the home screen, it works slightly better if you have an empty <code>main.py</code> on your badge.

=== Sublime Text 2 build script ===
OSX:
<pre>
{
"shell_cmd": "/path/to/your/pyboard.py --device /dev/tty.usbmodem* $file"
}
</pre>

TiLDA MK3/Run Code

2016-08-06T08:17:05Z

Marekventur:

= Option 1: REPL =
REPL stands for "[https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop Read–eval–print loop]" and allows you to run python code, line by line. This is a great way to see effects of certain hardware commands instantly and to test basic python features.

This allows you to run code, line by line, on the badge and to see the effects instantly. Follow https://micropython.org/doc/tut-repl or follow step 1-4 on the [[TiLDA_MK3/Get_Started|Get Started]] guide.

<strong>Note:</strong> This will only work if you have an empty <code>main.py</code> on your badge to stop the home screen from taking over instantly. If an app or script is already running you will not get a REPL that you can use to program, but simple debug output instead. Remember to remove it afterwards if you want to use the home screen again.

= Option 2: Copying files =
You can also copy your code to <code>main.py</code> on your badge, safely eject and then reset the badge via the button. To debug it you can use the serial console (see option 1) which will show you all text printed via <code>print()</code> and errors.

<strong>Note:</strong> It's very important to always correctly "eject" the usb storage before pressing the reset button, otherwise your filesystem is going to corrupt and you might have to [[TiLDA_MK3/reset|factory reset]] your badge

Remember to remove your main.py afterwards if you want to use the home screen again.

= Option 3: pyboard.py =
You can also use micropythons's <code>pyboard.py</code> script to automatically run a full local file of code without having to worry about copying it line-by-line or ejecting your device.

You can find a quick introduction on how to set it up [https://badge.emfcamp.org/wiki/TiLDA_MK3/Get_Started#5._Run_a_whole_file_of_code here].

This option is very useful as a build script with your editor, it allows you to quickly test whether your app is working.

<strong>Note:</strong> While this option works even if you run the home screen, it works slightly better if you have an empty <code>main.py</code> on your badge.

== Sublime Text 2 build script ==
OSX:
<pre>
{
"shell_cmd": "/path/to/your/pyboard.py --device /dev/tty.usbmodem* $file"
}
</pre>

TiLDA MK3/Run Code

2016-08-06T08:07:36Z

Marekventur: /* Option 2: Copying files */

TiLDA MK3/Run Code

2016-08-06T08:00:46Z

Marekventur: Created page with "= Option 1: REPL = REPL stands for "[https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop Read–eval–print loop]" and allows you to run python code, line by l..."

TiLDA MK3/reset

2016-08-06T07:49:45Z

Marekventur:

Should things stop working there are multiple ways to get your badge working again. Please make sure you have a backup of whatever you've been working on, you might lose all the data stored on you badge:
* Try deleting the file you have been working on, "safely eject" the badge and then press the reset button.
* Delete all other files apart from <code>boot.py</code>, <code>wifi.json</code> and <code>bootstrap.py</code>, "safely eject" the badge and then press the reset button.
* Factory reset the filesytem. Press and hold 'MENU' while quickly pressing the reset button at the back. Keep the MENU button hold for another 2 seconds while the green light on the front is blinking. Release it while the green light is on. (See [https://micropython.org/doc/tut-reset here] for more information. The USR button equals the MENU button, the orange light doesn't exist)

All these steps should finally get you to a screen saying "Downloading TiLDA software". It should take less than a minute until the bare badge functionalities are restored.

'''Note''': If you're not at the camp site you might now have to open the USB storage and edit the details in the wifi.json. Don't forget to "safely eject" and to press the reset button if you do so.

TiLDA MK3

2016-08-06T07:49:06Z

Marekventur: /* WiFi */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]
== Using your badge ==

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

<strong>A word of warning</strong>: 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 <span style="color:red">don't send anything private or important to or from the badge via wifi</span>.

=== Charging ===
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: [[TiLDA_MK3/reset|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3

2016-08-06T07:47:06Z

Marekventur:

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]
== Using your badge ==

=== 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.

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.

=== 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: [[TiLDA MK3/wifi|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 (we're working on it!), so please '''<span style="color:red">don't send anything private or important to or from the badge via wifi</span>'''.

=== Charging ===
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: [[TiLDA_MK3/reset|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3/wifi

2016-08-06T07:42:15Z

Marekventur: /* wifi.json */

= wifi.json =
A simple json document in the root directory of the badge:
<pre>
{"ssid":"your-wifi-name","pw":"your-wifi-password"}
</pre>

If you're connecting to an open wifi you can leave out the "pw" :
<pre>
{"ssid":"your-unsecured-wifi-name"}
</pre>

Most badge apps that use the wifi chip will expect a wifi.json file to exist. Please make sure it's valid json and that both name and password are in the correct case.

Please make sure to "eject" the usb storage properly before restarting the badge.

TiLDA MK3

2016-08-06T07:41:00Z

Marekventur: /* Basic usage */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]
== Using your badge ==

=== 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.

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

ToDo: Explain Home Screen

==== 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.

=== 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: [[TiLDA MK3/wifi|WiFi]]

=== Charging ===
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: [[TiLDA_MK3/reset|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3

2016-08-06T07:37:30Z

Marekventur: /* Hacking your badge */

[[File:TiLDA_MK3_front.jpg|right|500px|TiLDA Mkπ]]
== Using your badge ==

=== 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.

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

ToDo: Explain Home Screen

ToDo: Explain App Library

==== 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!

=== 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: [[TiLDA MK3/wifi|WiFi]]

=== Charging ===
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: [[TiLDA_MK3/reset|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.

* '''[[TiLDA MK3/Get Started|Step-by-step: How to get started]]'''
* '''[[TiLDA MK3/Run Code|3 Ways to run code on your TiLDA]]'''

The badge itself runs code written in the computer language [https://en.wikipedia.org/wiki/Python_(programming_language) Python] which is run by a bit of software called [https://micropython.org/ Micropython].

For more information about the functions available please have a look at the [[#Badge API|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: [[TiLDA MK3/build|How to build the firmware from scratch]]

All code used is hosted on Github. Contributions and PR are very welcome!
* https://github.com/emfcamp/micropython
* https://github.com/emfcamp/Mk3-Firmware
* https://github.com/emfcamp/Mk3-Server

=== Some ideas ===

[[TiLDA MK3/Ideas|Please share what you've done (or want to do) with others!]]

[https://github.com/emfcamp/Mk3-Hardware/blob/master/case-final.dxf Laser cut case files]

== Badge API ==

=== Build-in ===
* [http://docs.micropython.org/en/latest/pyboard/ documentation] - General Micropython libarary
* [[TiLDA MK3/ugfx|uGFX]] - The TiLDA LCD colour screen
* [[TiLDA MK3/documentation/cc3100|CC3100]] - The wifi chip
* [[TiLDA MK3/rtc|RTC]] (real time clock)
* [[TiLDA MK3/adc|ADC]] (analogue reading)
* [[TiLDA MK3/timer|Timer]]
* Microcontroller peripherals [https://micropython.org/doc/module/pyb/] (Timers, PWM, serial etc)

=== 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 <code>lib</code> folder onto your badge.

TBD, for now please have a look at the libraries themselves: https://github.com/emfcamp/Mk3-Firmware/tree/master/lib

* [[TiLDA MK3/lib/buttons|buttons]]
* database
* dialogs
* filesystem
* http_client
* imu
* wifi
* 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)

== Badge hardware ==
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)
* Accelerometer
* Compass
* Buzzer
* Battery
* <s>WS2812B aka "Neo Pixel"</s> Sadly defunct - come to the badge tent to have it fixed :(
* MicroSD slot

[[File:pinout-1.png | 500px]] [[File:pinout2-1.png | 500px]]

TiLDA MK3/Get Started

2016-08-05T21:15:49Z

Marekventur:

= Get started =

Hacking your TiLDA badge is easy. We've written it down step by step.

If something goes wrong, the badge can be [[TiLDA_MK3/reset|reset]] to its out-of-the-box state, so do not be concerned about breaking anything.

== 1. Connect to your computer ==
To get started you need to connect your badge to a computer. You can use any MicroUSB cable - the same type that charges most mobile phones nowadays. It doesn't matter whether the batter is plugged in or not, so don't worry about it.

== 2. Check your badge is found by your computer ==
Upon connecting the badge to a computer, it should appear as a "mass storage device" just like a USB key or an external hard disk.

'''Important:''' Just like any other USB storage device, if you changed or copied anything on the Badge, please make sure to "eject" or "safely remove" before unplugging your badge or pressing the reset button. Otherwise you might lose all your work :(

Windows will require a driver file for the serial port, which is stored on the badge's mass storage. [https://micropython.org/resources/Micro-Python-Windows-setup.pdf More information]

== 3. Connect to your badge ==

=== Windows ===
* Please follow the instruction under the "Windows" section on this page: https://micropython.org/doc/tut-repl
* Once you've installed the driver and Putty and you've connected to your badge, press Control+C to stop the main badge app, and then you should be greeted by a line saying "Micropython"

=== OSX ===
* Click the magnifying class in the top right of your screen and type <code>Terminal</code> followed by Enter. A white terminal window should appear.
* type <code>/dev/tty.usbmodem*</code> (The * is important, so don't let it out) and hit enter
* You should now be greeted by a line saying "Micropython"

=== Linux ===
* Open a terminal and type <code>screen /dev/ttyACM0</code>
* You should now be greeted by a line saying "Micropython"

=== What to do if this step doesn't work? ===
* Press the reset button at the back of your badge and try again
* Have a look at https://micropython.org/doc/tut-repl for more information

== 4. Your first line of Micropython ==
* In your terminal (next to the >>>) type <code>print(1 + 1)</code> followed by Enter
* You should see <code>2</code> printed on the screen. Congratulations, you've just written your first line of micropython code!
* You can now close the terminal window (or Putty, if you're on Windows). Note: some serial terminals will not close when the badge is removed or powered off. You should close the serial terminal before plugging the badge back in, otherwise the serial terminal may not reconnect.

== 5. Download some software you'll need ==

You will be downloading some stuff now. It's probably be best if you create some folder somewhere so you don't end up with files all over your Desktop.

Note you can copy files across from your computer to the badge, reset the badge and run the files though the menu, however these instructions make things a little easier.

=== Windows ===
* Python: Go to https://www.python.org/downloads/ and download python version 3.x. After the download is finished you can install it.
* Go to https://bootstrap.pypa.io/get-pip.py and save the file into your folder
* Hold shift, right click on the folder on, and click "open command window here"
* Now type <code>python get-pip.py</code>
* After the install was successful please type <code>pip install pyserial pyusb</code> followed by Enter.
* If you do not wish to install python, and would rather copy files across, the command line utility RoboCopy is recommended. For example: <code>Robocopy.exe ./my_app/ d:/apps/my_app</code>

=== OSX / Linux ===

* Python: Open a terminal and type <code>python --version</code>. If you get a version number you're good to go, otherwise go to https://www.python.org/downloads/ and download Python version 3.x. After the download is finished you can install it.
* Go to https://bootstrap.pypa.io/get-pip.py and save the file into your folder
* Use a terminal to go to the folder you created ([http://www.macworld.com/article/2042378/master-the-command-line-navigating-files-and-folders.html this is how you do it]) and type <code>python get-pip.py</code>
* Now type <code>python get-pip.py</code>
* After the install was successful please type <code>pip install pyserial pyusb</code> followed by Enter

=== Problems ===
* If you have problems install python, please use google, there are lots of good explanations out there
* For information about how to install <code>pip</code> have a look here: https://pip.pypa.io/en/stable/installing/

== 6. (Optional) Update your badge's micropython ==
'You can skip this step', but since TiLDA is still a work in progress, it's best to update regularly. So why not do it now? It's easy, just follow the instructions on https://update.badge.emfcamp.org.

== 5. Run a whole file of code ==
While you can do most things via the terminal like you just did, it's a bit easier to work on a file that you can edit. So let's do that.
* Go to https://raw.githubusercontent.com/emfcamp/micropython/tilda-master/tools/pyboard.py and use your browser to save it as "pyboard.py" into your newly created folder
* Open a text editor. On Windows you can search for <code>Notepad</code>, on OSX there's one called <code>textedit</code> and if you're on Linux you can probably find one by searching for "edit".
* Copy the following and save it as <code>test.py</code> in your folder:
<source lang="python">
print(1 + 2)
</source>
* Open a terminal, navigate to the right folder (see step 5 for more info)
** Windows: ToDo
** OSX: type <code>python pyboard.py test.py --device=/dev/tty.usbmodem*</code>
** Linux: type <code>python pyboard.py test.py --device=/dev/ttyACM*</code>
* You should now see the your terminal showing <code>3</code>. Your getting good at this!

'''Hint''': If you don't want the home app to start every time you can create an empty <code>main.py</code> file in the USB folder. This will stop the boot from loading the home screen and allow you do run code on your badge undisturbed. But remember to "safely eject" the badge after writing the file and to remove it again when you want the normal behaviour back

== 7. Blink ==
So far all we've seen is the badge doing some maths and sending the result back via usb. Let's start with one of the simplest hardware device on the badge, a LED (which means "Light emitting diode") -- We want to make it blink.

Create a file called <code>blink.py</code> and copy this bit of code into it:

<source lang="python">
import pyb
led = pyb.LED(1)
led.on()
pyb.delay(500)
led.off()
pyb.delay(500)
led.on()
pyb.delay(500)
led.off()
pyb.delay(500)
led.on()
</source>

Save it and use a terminal to execute it (See Step 5 - but make sure to replace the filename in the command). Have a look at your badge, you should see the tiny LED labeled "A" (It's right between the B button and the screen) flash twice before and then staying on.

Now, let's see what the code actually does.

<source lang="python">
import pyb
</source>
This line tells your badge to import the "pyb" library. It allows you to do various hardware related things with your badge (the full list is [http://docs.micropython.org/en/latest/pyboard/library/pyb.html here]). This is something very important in python, you always need to import libraries before you can use them.

<source lang="python">
led = pyb.LED(1)
</source>
This line uses the pyb module we've just imported and creates a LED object. The "<code>1</code>" means we're using the first LED on the badge. Change it to "<code>2</code>", save it and run pyboard.py again - Now the LED B should flash in green.

The <code>led</code> bit before the <code>=</code> means that we're not only creating an LED object, but we're also storing it for later use.

<source lang="python">
led.on()
</source>
Here we're using the reference to the LED object we've just created and calling the <code>.on()</code> function on it. Most python objects have multiple functions you can use. In this case you can look the them up here: http://docs.micropython.org/en/latest/pyboard/library/pyb.LED.html?highlight=led

<source lang="python">
pyb.delay(500)
</source>
This line uses the <code>pyb.delay()</code> function to pause the execution of our program for a while. The <code>500</code> is a number in milliseconds and the code is stopping for half a second. We need this delay to give your eyes some time to see that the LED has turned on. Try playing with different numbers or leaving the line out altogether to get a feeling for it.

== 8. Blink forever ==
Since our original <code>blink.py</code> script is only blinking twice it might be easy to miss. Let's fix this by blinking a bit longer:

<source lang="python">
import pyb
led = pyb.LED(1)
while True:
led.toggle()
pyb.delay(500)
</source>

Be careful to make sure you're copying the spaces in front of the last two lines as well, they're very important in Python! If you want to type them you have to use the <code>Tab</code> key on your keyboard - It's normally on the left of your keyboard, two keys above the <code>Shift</code> key.

Save this code and run it via <code>pyboard.py</code> again. You should now see the red LED blinking forever. So what's happening here?

<source lang="python">
while True:
led.toggle()
pyb.delay(500)
</source>
This is called a "while loop" in Python. It means that a certain bit of code (the one indented by the Tab at the beginning of the line) will be repeated over and over again until a certain condition is not fulfilled anymore. In this case the condition is <code>True</code> which is the Python-way of saying "this is always correct". Therefore the loop will repeat forever.

<code>led.toggle()</code> is similar to <code>led.on()</code> and <code>led.off()</code>, but instead of always turning the LED on or off it switches between the states. Very useful in our case!

This kind of "infinite loop" is quite useful for a lot of badge code, but often you also want to have some way of leaving the loop. Try this instead:
<source lang="python">
import pyb
import buttons
buttons.init()
led = pyb.LED(1)
while not buttons.is_pressed("BTN_MENU"):
led.toggle()
pyb.delay(500)
</source>

There are a few new things here: First we have imported a new library called <code>buttons</code>. This library helps you with all the buttons on the badge. If you want to use buttons in your script you also have to call <code>buttons.init()</code>, so that's what we're doing in line 3.

We have also changed the <code>while</code> loop with a new statement <code>not buttons.is_pressed("BTN_MENU")</code>. Like I said above, <code>while</code> loops will go on forever while its condition is fulfilled. We have now changed the condition to be "while the MENU button is not pressed".

Try running the code. You will again get the same blinking LED, but this time you should be able to stop it by pressing the MENU button.

== 8. Hello Screen ==

Ok, now let's try to write something on the screen. TiLDA comes with a colour screen and we can use a library called UGFX to draw on it.

Create a <code>main.py</code> file and put this in there:
<source lang="python">
import ugfx
import buttons
import pyb

ugfx.init()
buttons.init()
ugfx.clear(ugfx.YELLOW)

ugfx.text(5, 5, "Hello World", ugfx.RED)
ugfx.fill_circle(100, 100, 30, ugfx.GREEN)
ugfx.fill_circle(200, 100, 30, ugfx.GREEN)
ugfx.area(80, 150, 140, 20, ugfx.GREEN)
ugfx.area(120, 170, 60, 20, ugfx.GREEN)
</source>

If you run this file you should see a the screen turn yellow with some text and a (very simple) smiley.

If you use the screen you have to make sure you're using <code>ugfx.init()</code>, otherwise nothing will work. <code>ugfx.clear()</code> is used to clear the screen (in this case with a special colour) and the next 5 lines are drawing some text and a few basic shapes.

<code>ugfx.text(x, y, text, color)</code> Prints some text at position (x, y) in a given colour. x and y are coordinates on the screen. x=0 and y=0 means the top-left of the screen and x=320 y=240 is the bottom right corner. Try changing the two numbers and see how the text moves around on the screen.

<code>ugfx.fill_circle(x, y, radius, color)</code> draws a circle on the screen.

<code>ugfx.area(x, y, width, height, color)</code> draws a rectangle on the screen.

There are more basic drawing operations. You can find a list of them here: [[TiLDA MK3/ugfx|uGFX]]

== 10. Your own app ==

Having to have your badge connected to your computer all the time is a bit boring. Let's make it an app, so you can carry it around!

Update your <code>main.py</code> to look like this:

<source lang="python">
### Author: Your Name
### Description: Smiley!
### Category: Tutorial
### License: MIT
### Appname : Smiley

import ugfx
import buttons
import pyb

ugfx.init()
buttons.init()
ugfx.clear(ugfx.YELLOW)

ugfx.text(5, 5, "Hello World", ugfx.RED)
ugfx.fill_circle(100, 100, 30, ugfx.GREEN)
ugfx.fill_circle(200, 100, 30, ugfx.GREEN)
ugfx.area(80, 150, 140, 20, ugfx.GREEN)
ugfx.area(120, 170, 60, 20, ugfx.GREEN)

while not buttons.is_pressed("BTN_MENU"):
pyb.wfi()
</source>

The bit at the top is a comment, it's not actually part of the code and python ignores it. It does however help us categorise the app. Make sure you update your name :)

Plug your badge in and open the USB drive. Go into the "apps" folder and create a new folder called "hello_screen". Copy your newly updated <code>main.py</code> into there and safely eject the device. If you now press the reset button at the back of your badge it will restart normally. Wait until your name appears and press the MENU button. Go all the way to the bottom right and select "View all". Now you have to press "right" until you find the "Smiley" app. Select it and press A - You should now see your smiley.

== 11. Publish your app to the app library ==

Now that you have your own smiley app, why not share it with others?

Find your main.py and create an archive of it. Most operating systems have something build in for that purpose. In OSX you can right click and select "Compress main.py", under Windows you can select "???" (someone please fill this) and under Linux you can use "" (again, someone please fill this). You should now have a new file called <code>main.zip</code> or similar.

Go to http://api.badge.emfcamp.org/ and sign up with your email address and a password. In the top right there's a field called "Create New App" - Put "Smiley" into the field next to it and then click "Create". On the next screen click the "Choose File" button and select your <code>main.zip</code>. Now press "Upload" - and you're done!

You now have to wait until we have reviewed your app to make sure it's not doing something weird and then we'll hit the "publish" button and everyone on the camp site will be able to download your newly created app to their badge. If we're not quick enough, feel free to come to the badge tent and we'll hurry the review up ;)

= Alternative ways to work with TiLDA =

All of the python code which runs on the badge can be modified on the mass storage device, and new apps can be added this way too. Be careful when using text editors to modify files on the device, if the mass storage is not 'safely removed' before removal, corruption of the file being edited can occur.

When writing your own code, it is advised edit code on your computer, then copy it across to the badge, wait for the red 'writing' LED to go out, reset it, and run.
This way you don't need to worry about safely removing the badge each time.

To interactively run code on the badge, a python REPL can be accessed via the virtual serial port. Once you have found the serial port, use your favourite serial terminal to connect to the badge. Since the badge will be running the main software, press Ctrl+c to stop it, and the badge will display '>>>' to indicate it is ready to receive commands.

The badge runs micropython, and as a result does not contain everything you may expect from full python. See the micropython docs in the lniks below for more information.
The badge has additional APIs, in particular for the LCD, Wifi and IMU, which are also listed below.