TiLDA MK4/tilda-tools: Difference between revisions

From EMF Badge
Jump to navigation Jump to search
Line 18: Line 18:
<pre>tilda_tools <options></pre>
<pre>tilda_tools <options></pre>


Windows users, cd into the .development folder then run:
Windows users, create/update a tilda_tools.bat windows batch file, containing the following:
<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>
<pre>
@echo off
@echo off
python %CD%/.development\tilda_tools.py %*
python %CD%/.development\tilda_tools.py %*
</pre>
</pre>
This batch file massively simplifies previous versions, but some things may still not work
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>
<pre>
Parameters
Parameters

Revision as of 14:02, 2 September 2018

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

Dependencies

  • Python 3
  • pyserial

Installation

  • 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 here

tilda-tools

tilda_tools <options>

Windows users, create/update a tilda_tools.bat windows batch file, containing the following:

@echo off
python %CD%/.development\tilda_tools.py %*

This batch file massively simplifies previous versions, but some things may still not work, depending upon whether you can get the driver to work.

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