TheArchive/mayhem-firmware
1
0
Fork 0
mirror of https://github.com/portapack-mayhem/mayhem-firmware.git synced 2024-11-23 18:15:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

Work in progress

NotPike 2022-01-02 15:37:55 -05:00
parent ee1d266209
commit 2751881bb7
1 changed files with 89 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

90
TouchTunes.md

@ -1 +1,89 @@
*NotPike is still working on this*
# About
TouchTunes Jukebox’s (Gen2 and above) use a wireless remote that transmits NEC encoded messages using ASK/OOK at 433.92MHz. These remotes are used for basic Jukebox functions such as On/Off, Skip Song, Volume, Etc. The wireless messages are addressed using PINs 000-255 to prevent mutable units from interfering with each other.
**Most of the time the remote’s PIN is left as default 000**
This application emulates TouchTunes wireless remotes (Gen2 and newer) and has the ability to brute force addresses.
# How To Use
* **Start the application:** Go to Transmit→TouchTune.
* **Transmit a command:** Simply press the button on the touch screen or highlight/select the button with the physical controls.
* **Change the PIN:** Highlight the 3 digits in the top left hand corner and use the jog wheel to change the value. (Default is 000)
* **Brute force a command:** Select the “Scan” option (green check mark) then transmit. This option will transmit the command 256 times starting with PIN 000 to 255. (PIN will change to 255 after all commands are transmitted)
# TouchTunes Message Structure
Below is all the technical data regarding the wireless message structure.
### Basic Info
* **Frequency:** 433.92MHz
* **Modulation:** ASK/OOK
* **Protocol:** NEC
* **Symbol Rate:** 1766
* **Symbol Period:** 566us
### NEC Format
* Short(0): 10 (OOK: ON OFF)
* Long (1): 1000 (OOK: ON OFF OFF OFF)
* Structure: {SYNC} {PREAMBLE} {PIN} {COMMAND} {TAIL}
* Sync (Literal Symbols): 0xFFFF00
* Preamble (Decoded NEC): 0x5D
* PIN 000-255 (Decoded NEC): 0x00-0xFF (LSB)
* Tail (Literal Symbols): 0x8
### Commands
**Note:** Commands are doubled with the 2nd half being reversed. For example, Pause 0x32 will translate to 0x3223 before being encoded to the literal symbols. \xA8\x8A\x8A\xA2\xA8\x80.
* 0x32: Pause
* 0x78: On/Off
* 0x70: P1
* 0x60, // P2 Edit Queue ||
|| 0xCA, // P3 Skip ||
|| 0x20, // F1 Restart ||
|| 0xF2, // Up ||
|| 0xA0, // F2 Key ||
|| 0x84, // Left ||
|| 0x44, // OK ||
|| 0xC4, // Right ||
|| 0x30, // F3 Mic A Mute ||
|| 0x80, // Down ||
|| 0xB0, // F4 Mic B Mute ||
|| 0xF0, // 1 ||
|| 0x08, // 2 ||
|| 0x88, // 3 ||
|| 0x48, // 4 ||
|| 0xC8, // 5 ||
|| 0x28, // 6 ||
|| 0xA8, // 7 ||
|| 0x68, // 8 ||
|| 0xE8, // 9 ||
|| 0x18, // * Music_Karaoke ||
|| 0x98, // 0 ||
|| 0x58, // # Lock_Queue ||
|| 0xD0, // Zone 1 Vol+ ||
|| 0x90, // Zone 2 Vol+ ||
|| 0xC0, // Zone 3 Vol+ ||
|| 0x50, // Zone 1 Vol- ||
|| 0x10, // Zone 2 Vol- ||
|| 0x40, // Zone 3 Vol- ||
|| ||
|| ==Example== ||
|| * Command: Pin 000 - On/Off ||
|| * Literal Symbols HEX: ffff00 a2888a2 aaaa 8888aa2aa2220 ||
|| * Literal Symbols BIN: 11111111111111110000 10 1000 10 1000 1000 1000 ||
|| 10 1000 10 10 10 10 10 10 10 10 10 1000 1000 ||
|| 1000 1000 10 10 10 1000 10 10 10 10 1000 1000 ||
|| 1000 100000 ||
|| ||
|| * Decoded Symbols: SYNC S L S L L L S L ||
|| S S S S S S S S S L L L L ||
|| S S S L S S S S L L L TAIL ||