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!

The initial release of the new unified firmware, TailCoNTROL is out! MiTail, MiTail Mini, and FlutterWings products can be updated by the CRUMPET app.

• The current version of TailCoNTROL is v5.0.8
• TailCoNTROL Release Notes
• TailCoNTROL Command Protocol
• TailCoNTROL Breaking Changes (for app developers)

• DIGITAiL Command Protocol
• v1 Ear Command Protocol
• v2 Ear Command Protocol

• Using A Bluetooth Serial Console on Your Android Device to Send Console Commands to Your DIGITAiL
  
• Using A Bluetooth Serial Console on Your Android Device to Send Console Commands to Your MiTail
  

If you need to test an experimental firmware or update outside the official CRUMPET app, there is a facility to update over BLE.

• BLE_OTA_Python script
• API Reference: Over The Air Updates (OTA)

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

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!