| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| en:dev:tailcontrol-breaking-changes [2024/06/28 14:29] – darkgrue | en:dev:tailcontrol-breaking-changes [2025/02/05 03:16] (current) – darkgrue |
|---|
| ====== TailCoNTROL Breaking Changes ====== | ====== TailControl Breaking Changes ====== |
| |
| This is a list of breaking changes in the TailCoNTROL Protocol from previous firmware versions. | This is a list of breaking changes in the TailControl Protocol from previous firmware versions. |
| |
| **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, especially EarGear 2 features. | **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, especially EarGear 2 features. |
| |
| * Most command responses changed to ''OK'' and ''ERR''. Move state responses still exist (e.g., <movename> ''BEGIN'' upon start, and <movename> ''END'' upon completion). | * Most command responses changed to ''OK'' and ''ERR''. Move state responses still exist (e.g., <movename> ''BEGIN'' upon start, and <movename> ''END'' upon completion). |
| * BLE MTU and Generic Access Profile (GAP) LE Suggested Data Length changed to 512. | * BLE MTU and Generic Access Profile (GAP) LE Suggested Data Length changed to 512. |
| * EarGear 2 support is currently intended to require a forced update of the application and the firmware so that both can support the significant changes to the EarGear 2: | * EarGear 2 support is currently intended to require a forced update of the application and the firmware so that both can support the significant changes to the EarGear 2: |
| * EarGear 2 moves are now internal to the firmware, and called with the same move commands as other products (e.g., ''TAILFA''). | * EarGear 2 moves are now internal to the firmware, and __called with the same move commands as other products__ (e.g., ''TAILFA''). |
| * ''DSSP'' and ''USERMOVE'' will operate identically across all products, including the EarGear 2. | * ''DSSP'' and ''USERMOVE'' will operate identically across all products, including the EarGear 2. |
| * [[en:dev:tailcontrol-command-protocol#listen_mode|Listen Mode]] and [[en:dev:tailcontrol-command-protocol#tilt_mode|Tilt Mode]] for EarGear 2 runs onboard the firmware, but still emits triggers back to the application. | * [[en:dev:tailcontrol-command-protocol#listen_mode|Listen Mode]] and [[en:dev:tailcontrol-command-protocol#tilt_mode|Tilt Mode]] for EarGear 2 runs onboard the firmware, but still emits triggers back to the application. |
| * ''CONFWR'' command replaced with ''WRITECONF''. | * ''CONFWR'' command replaced with ''WRITECONF''. |
| * ''VERA'' command for iOS will be removed (no longer needed if applications supports larger MTU). | * ''VERA'' command for iOS will be removed (no longer needed if applications supports larger MTU). |
| * TailCoNTROL will use a new Service and Characteristics UUIDs going forward, to distinguish it from previous firmwares (and to further enforce the "forklift upgrade" required). | * TailControl will use a new Service and Characteristics UUIDs going forward, to distinguish it from previous firmwares (and to further enforce the "forklift upgrade" required). |
| * TAILCONTROL_SRV_UUID "19F8ADE2-D0C6-4C0A-912A-30601D9B3060" | * TAILCONTROL_SRV_UUID "19F8ADE2-D0C6-4C0A-912A-30601D9B3060" |
| * SYS_CHRC_RX_UUID "5E4D86AC-EF2F-466F-A857-8776D45FFBC2" | * SYS_CHRC_RX_UUID "5E4D86AC-EF2F-466F-A857-8776D45FFBC2" |
