====== TailControl Move Reference ======


Move list for the Tail Company TailControl firmware. TailControl is the unified firmware platform (version 5.//x//.//x// and higher) for the MiTail, MiTail Mini, FlutterWings, and EarGear 2.

All commands are case-sensitive. Trailing whitespace (e.g., `NULL`, `CR`, etc.) are ignored. The space between a command keyword and the parameters is mandatory.

Move commands return ''<movename> BEGIN'' upon start, and '' <movename> END'' upon completion. If the move is set to return home after completion (all firmware moves are), then it will be immediately followed by a ''TAILHM BEGIN'' and a ''TAILHM END'' as well.

A command will return ''LOWBATT'' and reject the command if the battery is less than 10%. ''ERR'' will be returned if the command can't be parsed or otherwise executed.

A new command that is received before the currently executing command is finished will immediately end the current command and start the new one.

<WRAP round todo 90%>
**IMPORTANT NOTICE:** TailControl and the TailControl Protocol is still under development. Some commands and features described here relate to a future release and are subject to change at this time.
</WRAP>

===== EarGear 2 =====

| **TAILHM** | **H**o**M**e position |
| **TAILS1** | Mapped to tilt forward; both ears turn inwards slowly, pause, home |
| **TAILS2** | Slow left ear, pause, home |
| **TAILS3** | Slow right ear, pause, home |
| **TAILFA** | Mapped to left tilt and listen bang left |
| **TAILSH** | Mapped to right tilt and listen bang right |
| **TAILHA** | Mapped to tilt backwards; both ears turn outwards quickly, pause, home |
| **TAILER** | Hewo! Right twist, pause, left twist |
| **TAILEP** | Double right ear twist, home |
| **TAILT1** | Flick left ear |
| **TAILT2** | Flick right ear |
| **TAILET** | Double left ear twist, home |
| **TAILU1** | **U**ser defined **1** |
| **TAILU2** | **U**ser defined **2** |
| **TAILU3** | **U**ser defined **3** |
| **TAILU4** | **U**ser defined **4** |

===== FlutterWings =====

| **TAILHM** | **H**o**M**e position |
| **TAILS1** | **S**low wag **1** |
| **TAILS2** | **S**low wag **2** |
| **TAILS3** | **S**low wag **3** |
| **TAILFA** | **FA**st wag |
| **TAILSH** | **SH**ort wag |
| **TAILHA** | **HA**ppy wag |
| **TAILER** | **ER**ect |
| **TAILEP** | **E**rect **P**ulse |
| **TAILT1** | **T**remble **1** |
| **TAILT2** | **T**remble **2** |
| **TAILET** | **E**rect **T**rem |
| **TAILU1** | **U**ser defined **1** |
| **TAILU2** | **U**ser defined **2** |
| **TAILU3** | **U**ser defined **3** |
| **TAILU4** | **U**ser defined **4** |

===== Glow Tip LED Patterns =====

| **LEDOFF** | **LED**s **OFF** |
| **LEDREC** | **REC**tangle wave pattern (blink 1 second on, 1 second off) |
| **LEDTRI** | **TRI**angle wave pattern (fade in 1 second, fade out 1 second) |
| **LEDSAW** | **SAW**tooth wave pattern (fade in 2 seconds, off) |
| **LEDSOS** | Morse **SOS** pattern |
| **LEDBEA** | **BEA**con (100ms on every 2 seconds) |
| **LEDFLA** | **FLA**me |
| **LEDSTR** | **STR**obe |
| **LEDUS1** | **US**er defined **1** |
| **LEDUS2** | **US**er defined **2** |
| **LEDUS3** | **US**er defined **3** |
| **LEDUS4** | **US**er defined **4** |

===== MiTail =====

| **TAILHM** | **H**o**M**e position |
| **TAILS1** | **S**low wag **1** |
| **TAILS2** | **S**low wag **2** |
| **TAILS3** | **S**low wag **3** |
| **TAILFA** | **FA**st wag |
| **TAILSH** | **SH**ort wag |
| **TAILHA** | **HA**ppy wag |
| **TAILER** | **ER**ect |
| **TAILEP** | **E**rect **P**ulse |
| **TAILT1** | **T**remble **1** |
| **TAILT2** | **T**remble **2** |
| **TAILET** | **E**rect **T**rem |
| **TAILU1** | **U**ser defined **1** |
| **TAILU2** | **U**ser defined **2** |
| **TAILU3** | **U**ser defined **3** |
| **TAILU4** | **U**ser defined **4** |

===== MiTail Mini =====

| **TAILHM** | **H**o**M**e position |
| **TAILS1** | **S**low wag **1** |
| **TAILS2** | **S**low wag **2** |
| **TAILS3** | **S**low wag **3** |
| **TAILFA** | **FA**st wag |
| **TAILSH** | No move |
| **TAILHA** | No move |
| **TAILER** | No move |
| **TAILEP** | No move |
| **TAILT1** | No move |
| **TAILT2** | No move |
| **TAILET** | No move |
| **TAILU1** | **U**ser defined **1** |
| **TAILU2** | **U**ser defined **2** |
| **TAILU3** | **U**ser defined **3** |
| **TAILU4** | **U**ser defined **4** |

===== RGB LED Commands =====

| **RGBOFF** | **RGB** LEDs **OFF**, returns ''OK'' |
| **RGBRBO** | **RGB** **R**ain**B**ow pattern, returns ''OK'' |
| **RGBRB2** | **RGB** **R**ain**B**ow pattern with random sparkly glitter, returns ''OK'' |
| **RGBCON** | **RGB** **CON**fetti; random-colored speckles that blink in and fade smoothly, returns ''OK'' |
| **RGBSIN** | **RGB** **SIN**e; a colored dot sweeping back and forth, with fading trails, returns ''OK'' |
| **RGBJUG** | **RGB** **JUG**gle; eight colored dots, weaving in and out of sync with each other, returns ''OK'' |
| **RGBBPM** | **RGB** **BPM**; colored stripes pulsing at a defined Beats-Per-Minute, returns ''OK'' |
| **RGBDMO** | **RGB** **DE**m**O**; cycle through all the preceding patterns, changing every 10 seconds, returns ''OK'' |
| **RGBTST** | **RGB** **TE**s**T**; color cycle the first and last pixel of the RGB string (endpoints test), returns ''OK'' |


== Copyright 2023-2025 © The Mechanical Tail Company Limited contact@thetailcompany.com. All Rights Reserved. ==