EMF Badge - User contributions [en]

TiLDA MK4/Firmware Update

2018-08-30T17:12:47Z

Philcrump: Correct tilda-tools to tilda_tools.

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 / 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/tilda-tools

2018-08-30T17:12:27Z

Philcrump: Correct tilda-tools to tilda_tools.

''tilda_tools'' is a toolchain for working with the micropython environment on the badge.

== Dependencies ==

* Python 3
* pyserial

== Installation ==

* Clone the Mk4-Apps repo from https://github.com/emfcamp/Mk4-Apps/ (see [https://help.github.com/articles/cloning-a-repository/ Cloning a repository] for help). Alternatively you can download a ZIP file from the repository page.

* Open a terminal in the Mk4-Apps/ directory. ''tilda_tools'' is in the root of this directory.

== tilda-tools ==

<pre>tilda_tools <options></pre>

<pre>
Parameters
-----------------

-d --device : serial interface (default: auto)
-s --storage : path to flash storage

Usage
------------------------------------

Reboot badge
$ tilda_tools reset

Soft reboot badge and start specific app
$ tilda_tools reset --boot my_app

Update files on the badge to match the current local version, restarts afterwards
$ tilda_tools sync

Update files in folder(s) to match current local version
$ tilda_tools sync my_game shared
$ tilda_tools sync <pattern1> <pattern2> ...

Sync (as above), but execute my_app after reboot
$ tilda_tools sync --boot my_app [<other sync parameter>]

Sync (as above), but execute a single file afterwards without copying it to the badge
$ tilda_tools sync --run some_other_file.py

Sync a given app and execute it
$ tilda_tools app home_default

Executes a single file on the badge without copying anything (Using pyboard.py)
$ tilda_tools run my_app/main.py

Runs local validation (doesn't require a badge, but doesn't run unit tests)
$ tilda_tools validate

Runs local validation and badge-side tests
$ tilda_tools test

Update firmware on badge (warning, this will delete all settings etc. stored on the badge!)
$ tilda_tools firmware-update

Setup wifi.json to be copied to the badge on every sync
$ tilda_tools wifi
</pre>

TiLDA MK4/Firmware Update

2018-08-30T17:11:29Z

Philcrump: OSX Instructions should work for Linux too (tested ubuntu 18.04)

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 / 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/tilda-tools

2018-08-30T17:06:26Z

Philcrump: Remove python3.7 note.

''tilda-tools'' is a toolchain for working with the micropython environment on the badge.

== Dependencies ==

* Python 3
* pyserial

== Installation ==

* Clone the Mk4-Apps repo from https://github.com/emfcamp/Mk4-Apps/ (see [https://help.github.com/articles/cloning-a-repository/ Cloning a repository] for help). Alternatively you can download a ZIP file from the repository page.

* Open a terminal in the Mk4-Apps/ directory. ''tilda-tools'' is in the root of this directory.

== tilda-tools ==

<pre>tilda-tools <options></pre>

<pre>
Parameters
-----------------

-d --device : serial interface (default: auto)
-s --storage : path to flash storage

Usage
------------------------------------

Reboot badge
$ tilda_tools reset

Soft reboot badge and start specific app
$ tilda_tools reset --boot my_app

Update files on the badge to match the current local version, restarts afterwards
$ tilda_tools sync

Update files in folder(s) to match current local version
$ tilda_tools sync my_game shared
$ tilda_tools sync <pattern1> <pattern2> ...

Sync (as above), but execute my_app after reboot
$ tilda_tools sync --boot my_app [<other sync parameter>]

Sync (as above), but execute a single file afterwards without copying it to the badge
$ tilda_tools sync --run some_other_file.py

Sync a given app and execute it
$ tilda_tools app home_default

Executes a single file on the badge without copying anything (Using pyboard.py)
$ tilda_tools run my_app/main.py

Runs local validation (doesn't require a badge, but doesn't run unit tests)
$ tilda_tools validate

Runs local validation and badge-side tests
$ tilda_tools test

Update firmware on badge (warning, this will delete all settings etc. stored on the badge!)
$ tilda_tools firmware-update

Setup wifi.json to be copied to the badge on every sync
$ tilda_tools wifi
</pre>

TiLDA MK4/tilda-tools

2018-08-30T16:42:43Z

Philcrump: /* Dependencies */ Add missing step.

''tilda-tools'' is a toolchain for working with the micropython environment on the badge.

== Dependencies ==

* Python 3.7
* pyserial

==== Ubuntu 18.04 ====

Python3.6 is installed by default.

<pre>
sudo apt update
sudo apt install python3.7
curl https://bootstrap.pypa.io/get-pip.py | sudo python3.7
sudo pip3.7 install pyserial
</pre>

== Installation ==

* Clone the Mk4-Apps repo from https://github.com/emfcamp/Mk4-Apps/ (see [https://help.github.com/articles/cloning-a-repository/ Cloning a repository] for help). Alternatively you can download a ZIP file from the repository page.

* Open a terminal in the Mk4-Apps/ directory. ''tilda-tools'' is in the root of this directory.

== tilda-tools ==

<pre>tilda-tools <options></pre>

<pre>
Parameters
-----------------

-d --device : serial interface (default: auto)
-s --storage : path to flash storage

Usage
------------------------------------

Reboot badge
$ tilda_tools reset

Soft reboot badge and start specific app
$ tilda_tools reset --boot my_app

Update files on the badge to match the current local version, restarts afterwards
$ tilda_tools sync

Update files in folder(s) to match current local version
$ tilda_tools sync my_game shared
$ tilda_tools sync <pattern1> <pattern2> ...

Sync (as above), but execute my_app after reboot
$ tilda_tools sync --boot my_app [<other sync parameter>]

Sync (as above), but execute a single file afterwards without copying it to the badge
$ tilda_tools sync --run some_other_file.py

Sync a given app and execute it
$ tilda_tools app home_default

Executes a single file on the badge without copying anything (Using pyboard.py)
$ tilda_tools run my_app/main.py

Runs local validation (doesn't require a badge, but doesn't run unit tests)
$ tilda_tools validate

Runs local validation and badge-side tests
$ tilda_tools test

Update firmware on badge (warning, this will delete all settings etc. stored on the badge!)
$ tilda_tools firmware-update

Setup wifi.json to be copied to the badge on every sync
$ tilda_tools wifi
</pre>

TiLDA MK4/tilda-tools

2018-08-30T16:36:13Z

Philcrump: /* Dependencies */

''tilda-tools'' is a toolchain for working with the micropython environment on the badge.

== Dependencies ==

* Python 3.7
* pyserial

==== Ubuntu 18.04 ====

Python3.6 is installed by default.

<pre>
sudo apt update
sudo apt install python3.7
curl https://bootstrap.pypa.io/get-pip.py | sudo python3.7
</pre>

== Installation ==

* Clone the Mk4-Apps repo from https://github.com/emfcamp/Mk4-Apps/ (see [https://help.github.com/articles/cloning-a-repository/ Cloning a repository] for help). Alternatively you can download a ZIP file from the repository page.

* Open a terminal in the Mk4-Apps/ directory. ''tilda-tools'' is in the root of this directory.

== tilda-tools ==

<pre>tilda-tools <options></pre>

<pre>
Parameters
-----------------

-d --device : serial interface (default: auto)
-s --storage : path to flash storage

Usage
------------------------------------

Reboot badge
$ tilda_tools reset

Soft reboot badge and start specific app
$ tilda_tools reset --boot my_app

Update files on the badge to match the current local version, restarts afterwards
$ tilda_tools sync

Update files in folder(s) to match current local version
$ tilda_tools sync my_game shared
$ tilda_tools sync <pattern1> <pattern2> ...

Sync (as above), but execute my_app after reboot
$ tilda_tools sync --boot my_app [<other sync parameter>]

Sync (as above), but execute a single file afterwards without copying it to the badge
$ tilda_tools sync --run some_other_file.py

Sync a given app and execute it
$ tilda_tools app home_default

Executes a single file on the badge without copying anything (Using pyboard.py)
$ tilda_tools run my_app/main.py

Runs local validation (doesn't require a badge, but doesn't run unit tests)
$ tilda_tools validate

Runs local validation and badge-side tests
$ tilda_tools test

Update firmware on badge (warning, this will delete all settings etc. stored on the badge!)
$ tilda_tools firmware-update

Setup wifi.json to be copied to the badge on every sync
$ tilda_tools wifi
</pre>

TiLDA MK4/tilda-tools

2018-08-30T16:33:59Z

Philcrump: /* Dependencies */

''tilda-tools'' is a toolchain for working with the micropython environment on the badge.

== Dependencies ==

* Python 3.7
* pyserial

== Installation ==

* Clone the Mk4-Apps repo from https://github.com/emfcamp/Mk4-Apps/ (see [https://help.github.com/articles/cloning-a-repository/ Cloning a repository] for help). Alternatively you can download a ZIP file from the repository page.

* Open a terminal in the Mk4-Apps/ directory. ''tilda-tools'' is in the root of this directory.

== tilda-tools ==

<pre>tilda-tools <options></pre>

<pre>
Parameters
-----------------

-d --device : serial interface (default: auto)
-s --storage : path to flash storage

Usage
------------------------------------

Reboot badge
$ tilda_tools reset

Soft reboot badge and start specific app
$ tilda_tools reset --boot my_app

Update files on the badge to match the current local version, restarts afterwards
$ tilda_tools sync

Update files in folder(s) to match current local version
$ tilda_tools sync my_game shared
$ tilda_tools sync <pattern1> <pattern2> ...

Sync (as above), but execute my_app after reboot
$ tilda_tools sync --boot my_app [<other sync parameter>]

Sync (as above), but execute a single file afterwards without copying it to the badge
$ tilda_tools sync --run some_other_file.py

Sync a given app and execute it
$ tilda_tools app home_default

Executes a single file on the badge without copying anything (Using pyboard.py)
$ tilda_tools run my_app/main.py

Runs local validation (doesn't require a badge, but doesn't run unit tests)
$ tilda_tools validate

Runs local validation and badge-side tests
$ tilda_tools test

Update firmware on badge (warning, this will delete all settings etc. stored on the badge!)
$ tilda_tools firmware-update

Setup wifi.json to be copied to the badge on every sync
$ tilda_tools wifi
</pre>

TiLDA MK4/tilda-tools

2018-08-30T16:29:56Z

Philcrump: Add partial dependencies.

''tilda-tools'' is a toolchain for working with the micropython environment on the badge.

== Dependencies ==

* Python 3.7
* ??

== Installation ==

* Clone the Mk4-Apps repo from https://github.com/emfcamp/Mk4-Apps/ (see [https://help.github.com/articles/cloning-a-repository/ Cloning a repository] for help). Alternatively you can download a ZIP file from the repository page.

* Open a terminal in the Mk4-Apps/ directory. ''tilda-tools'' is in the root of this directory.

== tilda-tools ==

<pre>tilda-tools <options></pre>

<pre>
Parameters
-----------------

-d --device : serial interface (default: auto)
-s --storage : path to flash storage

Usage
------------------------------------

Reboot badge
$ tilda_tools reset

Soft reboot badge and start specific app
$ tilda_tools reset --boot my_app

Update files on the badge to match the current local version, restarts afterwards
$ tilda_tools sync

Update files in folder(s) to match current local version
$ tilda_tools sync my_game shared
$ tilda_tools sync <pattern1> <pattern2> ...

Sync (as above), but execute my_app after reboot
$ tilda_tools sync --boot my_app [<other sync parameter>]

Sync (as above), but execute a single file afterwards without copying it to the badge
$ tilda_tools sync --run some_other_file.py

Sync a given app and execute it
$ tilda_tools app home_default

Executes a single file on the badge without copying anything (Using pyboard.py)
$ tilda_tools run my_app/main.py

Runs local validation (doesn't require a badge, but doesn't run unit tests)
$ tilda_tools validate

Runs local validation and badge-side tests
$ tilda_tools test

Update firmware on badge (warning, this will delete all settings etc. stored on the badge!)
$ tilda_tools firmware-update

Setup wifi.json to be copied to the badge on every sync
$ tilda_tools wifi
</pre>

TiLDA MK4/tilda-tools

2018-08-30T16:22:32Z

Philcrump: Add installation & usage instructions from git repo.

''tilda-tools'' is a toolchain for working with the micropython environment on the badge.

== Installation ==

* Clone the Mk4-Apps repo from https://github.com/emfcamp/Mk4-Apps/ (see [https://help.github.com/articles/cloning-a-repository/ Cloning a repository] for help). Alternatively you can download a ZIP file from the repository page.

* Open a terminal in the Mk4-Apps/ directory. ''tilda-tools'' is in the root of this directory.

== tilda-tools ==

<pre>tilda-tools <options></pre>

<pre>
Parameters
-----------------

-d --device : serial interface (default: auto)
-s --storage : path to flash storage

Usage
------------------------------------

Reboot badge
$ tilda_tools reset

Soft reboot badge and start specific app
$ tilda_tools reset --boot my_app

Update files on the badge to match the current local version, restarts afterwards
$ tilda_tools sync

Update files in folder(s) to match current local version
$ tilda_tools sync my_game shared
$ tilda_tools sync <pattern1> <pattern2> ...

Sync (as above), but execute my_app after reboot
$ tilda_tools sync --boot my_app [<other sync parameter>]

Sync (as above), but execute a single file afterwards without copying it to the badge
$ tilda_tools sync --run some_other_file.py

Sync a given app and execute it
$ tilda_tools app home_default

Executes a single file on the badge without copying anything (Using pyboard.py)
$ tilda_tools run my_app/main.py

Runs local validation (doesn't require a badge, but doesn't run unit tests)
$ tilda_tools validate

Runs local validation and badge-side tests
$ tilda_tools test

Update firmware on badge (warning, this will delete all settings etc. stored on the badge!)
$ tilda_tools firmware-update

Setup wifi.json to be copied to the badge on every sync
$ tilda_tools wifi
</pre>

TiLDA MK4

2018-08-30T16:02:38Z

Philcrump: /* Basic usage */ Clarify reset button location.

[[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 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].

TiLDA MK4/reset

2018-08-30T16:00:23Z

Philcrump: Clarify reset process.

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 briefly 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 at the same time. 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

2018-08-30T15:55:58Z

Philcrump: /* Badge hardware */ Added parts links from blog post.

[[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 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].

TiLDA MK4

2018-08-30T15:49:17Z

Philcrump: Fix charging led position description.

[[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 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 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-03T22:55:46Z

Philcrump: /* Changing your name */

== Using your badge ==

=== Assembly ===
ToDo: How to attach screen and battery

=== 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 'View All' and press 'A'
# Use 'right' on the joystick to reach the 'All' category
# 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]]'''

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.

* buttons
* database
* dialogs
* filesystem
* http_client
* imu
* wifi

(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-03T22:55:13Z

Philcrump: /* Basic usage */

== Using your badge ==

=== Assembly ===
ToDo: How to attach screen and battery

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

1. Press 'Menu'
2. Select 'View All' and press 'A'
3. Use 'right' on the joystick to reach the 'All' category
4. Select the 'Change Name' app and press 'A'
5. Use the joystick and 'A' key to enter your name
6. 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]]'''

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.

* buttons
* database
* dialogs
* filesystem
* http_client
* imu
* wifi

(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-03T22:50:54Z

Philcrump: Clarify root directory of the badge.

= wifi.json =
A simple json document in the root directory of the badge containing at least those properties:
<pre>
{"ssid":"your-wifi-name","pw":"your-wifi-password"}
</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/ugfx

2016-07-24T11:33:18Z

Philcrump: /* Widgets */

The badge makes use of 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 uGFX documentation for more details

== Simple examples ==

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

(*true at line of writing, it now might have been sped up)

=== Reducing power consumption ===

== Detailed documentation ==

Note. all co-ordinates are from the top left (battery symbol) corner.

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

==== ugfx.circle(<x>,<y>,<diameter>,<colour>) ====

Draws a circle at <x>,<y> of <diameter> with a 1 pixel border of <colour>.

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

=== Widgets ===

==== ugfx.text(<x>,<y>,<text>,<colour>) ====

Draws a text string <text> at <x>,<y> in <colour>.

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

=== Styles ===

TiLDA MK3/ugfx

2016-07-24T11:31:01Z

Philcrump: /* Detailed documentation */