EMF Badge - User contributions [en]

TiLDA MK4/tilda-tools

2018-09-02T14:02:36Z

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://badge.emfcamp.org/wiki/TiLDA_MK4/Get_Started here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, create/update a tilda_tools.bat windows batch file, containing the following:
<pre>
@echo off
python %CD%/.development\tilda_tools.py %*
</pre>
This batch file massively simplifies previous versions, but some things may still not work, depending upon whether you can get the driver to work.

<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-09-02T11:30:42Z

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://badge.emfcamp.org/wiki/TiLDA_MK4/Get_Started here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Unfortunately, while this works, it messes up file paths in various options. A better alternative is to create/update a tilda_tools.bat windows batch file, containing the following:
<pre>
@echo off
python %CD%/.development\tilda_tools.py %*
</pre>
This batch file massively simplifies previous versions, but some things may still not work
<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-09-01T17:52:57Z

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://badge.emfcamp.org/wiki/TiLDA_MK4/Get_Started here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Alternatively, you can create a tilda_tools.bat windows batch file to do the same, containing the following:
<pre>
@echo off
CD ./.development
IF %1.==. GOTO No1
python tilda_tools.py %*
GOTO End1

:No1
python tilda_tools.py --help
:End1
CD ..
</pre>
This batch file copes with not putting in a parameter by defaulting to --help if you don't put in an argument. Previously, not putting a parameter in would result in a python path error message.
NOTE: Not all options are working; this may be my Python install :-(
<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-09-01T17:37:37Z

DoctorMikeReddy: /* Installation */

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://badge.emfcamp.org/wiki/TiLDA_MK4/Get_Started here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Alternatively, you can create a tilda_tools.bat windows batch file to do the same, containing the following:
<pre>
@echo off
CD ./.development
IF %1.==. GOTO No1
python tilda_tools.py %*
GOTO End1

:No1
python tilda_tools.py --help
:End1
CD ..
</pre>
This batch file copes with not putting in a parameter by defaulting to --help if you don't put in an argument. Previously, not putting a parameter in would result in a python path error message
<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-09-01T15:03:11Z

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://stackoverflow.com/questions/27596776/installing-and-using-pyserial-in-python-3-4-windows-8-1 here] and download [https://pypi.org/project/pyserial/ here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Alternatively, you can create a tilda_tools.bat windows batch file to do the same, containing the following:
<pre>
@echo off
CD ./.development
IF %1.==. GOTO No1
python tilda_tools.py %*
GOTO End1

:No1
python tilda_tools.py --help
:End1
CD ..
</pre>
This batch file copes with not putting in a parameter by defaulting to --help if you don't put in an argument. Previously, not putting a parameter in would result in a python path error message
<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-09-01T14:52:32Z

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://stackoverflow.com/questions/27596776/installing-and-using-pyserial-in-python-3-4-windows-8-1 here] and download [https://pypi.org/project/pyserial/ here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Alternatively, you can create a tilda_tools.bat windows batch file to do the same, containing the following:
<pre>
@echo_off
CD ./.development
IF %1.==. GOTO No1
IF %2.==. GOTO No2
IF %3.==. GOTO No3
python tilda_tools.py %1 %2 %3
@GOTO End1

:No1
python tilda_tools.py --help
@GOTO End1
:No2
python tilda_tools.py %1
@GOTO End1
:No3
python tilda_tools.py %1 %2
:End1
@CD ..
</pre>
This batch file copes with up to three parameters, but not more.If you need more command line options passing, you will need to add to the existing template to allow additional parameters.
<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-09-01T14:49:55Z

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://stackoverflow.com/questions/27596776/installing-and-using-pyserial-in-python-3-4-windows-8-1 here] and download [https://pypi.org/project/pyserial/ here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Alternatively, you can create a tilda_tools.bat windows batch file to do the same, containing the following:
<pre>
@echo_off
CD ./.development
IF %1.==. GOTO No1
IF %2.==. GOTO No2
IF %3.==. GOTO No3
python tilda_tools.py %1 %2 %3
@GOTO End1

:No1
python tilda_tools.py --help
@GOTO End1
:No2
python tilda_tools.py %1
@GOTO End1
:No3
python tilda_tools.py %1 %2
:End1
@CD ..
</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-09-01T14:49:36Z

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://stackoverflow.com/questions/27596776/installing-and-using-pyserial-in-python-3-4-windows-8-1 here] and download [https://pypi.org/project/pyserial/ here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Alternatively, you can create a tiolda_tools.bat windows batch file to do the same, containing the following:
<pre>
@echo_off
CD ./.development
IF %1.==. GOTO No1
IF %2.==. GOTO No2
IF %3.==. GOTO No3
python tilda_tools.py %1 %2 %3
@GOTO End1

:No1
python tilda_tools.py --help
@GOTO End1
:No2
python tilda_tools.py %1
@GOTO End1
:No3
python tilda_tools.py %1 %2
:End1
@CD ..
</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-09-01T14:46:26Z

DoctorMikeReddy: /* Installation */

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

* Windows Users - you will need to install Pyserial to get some commands working - Instructions [https://stackoverflow.com/questions/27596776/installing-and-using-pyserial-in-python-3-4-windows-8-1 here] and download [https://pypi.org/project/pyserial/ here]

== tilda-tools ==

<pre>tilda_tools <options></pre>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Working on a windows batch file to do the same, but currently getting path errors

<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-09-01T13:13:10Z

DoctorMikeReddy: /* 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>

Windows users, cd into the .development folder then run:
<nowiki>> python tilda_tools.py <options></nowiki>
NOTE: Working on a windows batch file to do the same, but currently getting path errors

<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-09-01T13:06:44Z

DoctorMikeReddy: /* Installation */

TiLDA MK4/tilda-tools

2018-09-01T12:25:57Z

DoctorMikeReddy: /* Installation */

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

* Windows users - install Python 3.7 (if you haven't already), choose the option to add it to PATH if you wish to, and create a file tilda_tools.bat in the root folder of Mk4-Apps then put the following code in it to execute ''tilda_tools''

<nowiki>@echo_off
python .development/tilda_tools.py
</nowiki>
OR if you have not added your python install to PATH

<nowiki>@echo_off
"Path where your Python exe is stored\python.exe" .development/tilda_tools.py
</nowiki>
where
"Path where your Python exe is stored\python.exe"
is something like:
"C:\Program Files (x86)\Python36-32\python.exe"

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