EMF Badge - User contributions [en]

TiLDA MK4/Get Started

2018-09-09T16:25:41Z

Davea: /* 5. Your first app */

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

___title___ = "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/Badge Store Submissions

2018-09-09T16:24:50Z

Davea: /* Headers */

== 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>
___title___ = "<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 [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Fork the emfcamp/Mk4-Apps repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Clone '''your''' GitHub repo to your computer [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Add your app to your local repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Create a Pull Request [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]

* Over time, your GitHub repo 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 [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#updating-your-github-and-local-git-repo]

If you prefer a GUI interface, you could consider https://desktop.github.com/

TiLDA MK4/Code Structure

2018-09-09T16:24:35Z

Davea:

=== Headers ===

main.py headers:
<pre>
""" <your description>
"""
___title___ = "<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

=== Exiting main.py ===

Ensure your apps calls app.restart_to_default() when finished

<pre>
from app import restart_to_default # import at the beginning of your code

restart_to_default() # call on exit of main.py
</pre>

Main Page

2018-09-07T18:46:08Z

Davea: /* EMF2018 - 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.

==EMF2018 - TiLDA Mkδ==
[[File:TiLDA_Mk4_Front_with_sponsors.png|right|thumb|TiLDA Mk𝛿|link=TiLDA_MK4]]

'''<span style="color:red">You want to go here</span> ----> [[TiLDA_MK4|TiLDA Mkδ main page]].'''

2018 badge announcement on our blog<br/>

http://blog.emfcamp.org/post/177423823788/tilda-mk4-the-emf-2018-badge
<div style="clear: both"></div>

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

[[TiLDA_MK3]] main page.

2016 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
<div style="clear: both"></div>
==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

Main Page

2018-09-07T18:45:32Z

Davea: /* EMF2018 - 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.

==EMF2018 - TiLDA Mkδ==
[[File:TiLDA_Mk4_Front_with_sponsors.png|right|thumb|TiLDA Mk𝛿|link=TiLDA_MK4]]

'''<span style="color:red">You want to go here</span> ----> [[TiLDA_MK4|TiLDA Mkδ main page]].'''

2018 badge announcement on our blog<br/>

http://blog.emfcamp.org/post/177423823788/tilda-mk4-the-emf-2018-badge

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

[[TiLDA_MK3]] main page.

2016 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
<div style="clear: both"></div>
==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/modtilda

2018-08-29T11:04:10Z

Davea: Redirected page to TiLDA MK4/modtilda

#REDIRECT [[TiLDA_MK4/modtilda]]

TiLDA MK4

2018-08-29T11:02:33Z

Davea: /* Build-in */

[[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/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 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/modtilda

2018-08-29T11:02:29Z

Davea: 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-29T10:59:44Z

Davea: /* 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/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 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].