This is an old revision of the document!
Dev Fiesta
Resources for developers and hackers! Also don't forget about resources like the Service Notes for MiTail in the Guides, Patterns, and Safety Info section!
Command Protocols
Using a Terminal
Using OTA
If you need to test an experimental firmware or update outside the official CRUMPET app, there is a facility to update over BLE.
Note: flashing test firmware or the incorrect firmware for your product can make it impossible to recover without a hardware flash, which may require return for service. You should only perform this operation at your own risk, and only if you are comfortable with all the steps and components used to perform it. You also need to have a recovery plan and be prepared to hardware flash if something goes wrong.
Hardware Flash
Hardware flash can be performed with a 3.3 V USB to TTL interface that provides RXD, TXD, RTS (Ready to Send), and DTR (Data Terminal Ready) signals (i.e., a 6-pin connector with the appropriate signals). Numerous inexpensive USB to TTL cables and interfaces are not capable of doing this, check carefully before investing in a tool to perform this.
The Tigard Protocol Tool works very nicely, though it is massively overkill in that it has many more capabilities than are required.
The interface pinout on the board is below. Pins are numbered counting from Pin 1, closest to the servo connector, on the component side of the controller board.
Note: USB to TTL interfaces are available with 5 V, 3.3 V, or selectable voltage. The ESP32 must be used with 3.3 V interfaces only! Ensure that your cable or device is configured for 3.3 V before connecting it to the controller board, or your ESP32 may be permanently damaged.
Chat With the Tail Co Development Team Community
MiTail, EarGear 2, FlutterWings, and MiTail Mini all have updatable firmware! For details, come and talk to us on our Telegram Tail Co Dev Chat!