Difference between revisions of "TiLDA MK4/tilda-tools"

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