| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| en:dev:tailcontrol-breaking-changes [2024/05/31 19:38] – darkgrue | en:dev:tailcontrol-breaking-changes [2024/06/28 14:35] (current) – darkgrue |
|---|
| * 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). |
| * OTA responses now ''BEGIN OTA'', ''OTA ERR'', and ''OTA SUCCESS''. | * OTA responses now ''BEGIN OTA'', ''OTA ERR'', and ''OTA SUCCESS''. |
| * BLE MTU 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''). [''DSSP'' and ''USERMOVE'' will operate identically across all products, including 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''). |
| | * ''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. |
| * Speculative: 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). | * ''HWVER'' Returns ''EG2 x.x'' for EarGear 2 controller hardware, instead of ''HWVER B''. |
| | * ''CONFRD'' command removed, replaced by ''READCONF'' and ''READNVS''. |
| | * ''CONFWR'' command replaced with ''WRITECONF''. |
| | * ''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_SRV_UUID "19F8ADE2-D0C6-4C0A-912A-30601D9B3060" |
| | * SYS_CHRC_RX_UUID "5E4D86AC-EF2F-466F-A857-8776D45FFBC2" |
| | * SYS_CHRC_TX_UUID "567A99D6-A442-4AC0-B676-4993BF95F805" |
| | * BATT_VOLTAGE_UUID "E818BDA3-88A7-43C0-8509-6E0BBB6F55D9" |
| | * ''HWVER'' will return the hardware identifier strings prefixed by ''HWVER'' (e.g., ''HWVER EG 4.0''). |
| | * Design note: application is responsible for generating a random (strong) 6-digit passkey, setting that using the ''SETPUSSKEY'' command, and displaying that key to the user in order to proceed with the binding process. |
