Documenta a engenharia reversa de uma camada de fábrica de uma TV Android TCL: protocolo IR de 56 kHz, daemon tclfactoryos, driver IR do kernel e evidências de que o root por software é inalcançável.

🌐 Idiomas: Inglês (este arquivo) · 🇹🇷 Türkçe
Oito dias, uma TCL 65T61C, um Arduino Uno e centenas de portas fechadas. Este repositório não é um "guia de root" — é um relatório de encerramento: a camada de fábrica/serviço da TV foi mapeada de ponta a ponta, o root por software foi demonstrado — com evidências — como inalcançável neste firmware, e tudo foi documentado para que o próximo pesquisador não precise percorrer o cemitério novamente.
A história curta: dentro da TV roda um daemon de root chamado tclfactoryos, e dentro
dele roda um processador de comandos com uma chamada system() por trás. Três canais levam
até lá: IR, UART e p2p. Fizemos engenharia reversa completa do protocolo IR (56 kHz!),
desmontamos o driver do kernel e provamos que os bytes marcadores fixos da sequência de
teclas de fábrica simplesmente não existem na própria tabela de teclas da TV — nenhuma
sequência válida pode jamais ser transmitida. A UART é física; a thread p2p só é gerada
a partir de uma sequência IR válida. A superfície de software: esgotada. Este repositório
é a jornada completa.
Uma nota sobre idiomas: este README está em inglês, e toda a documentação também: os sete documentos de fase ficam em
docs/en/(originais em turco emdocs/). Os comentários de código seguem o inglês onde é relevante.
| Modelo | TCL 65T61C (65", Android TV 12) |
| Plataforma | Realtek RTD2875P / rtd6748 |
| Firmware | V8-R75PT01-LF1V618 (build STT2.230203.001 release-keys) |
| Kernel | 5.4.284+ · patch de segurança 2025-12-05 |
| Controle remoto | RC833A dual-mode (Bluetooth HID + IR) |

A montagem real que conversou com a TV: Arduino Uno + driver 2N2222A + LED IR de 940 nm — fotografada durante as sessões. Este circuito aumentava e diminuía o volume da TV, tecla por tecla, e conduziu toda sondagem de fábrica em docs/04.
A pesquisa foi feita em um dispositivo de propriedade do autor, estritamente dentro da própria rede doméstica dele. A TV nunca foi aberta; nenhuma escrita persistente, nenhuma adulteração de key/MID/SN; o dispositivo foi retornado ao estado de fábrica no momento em que o trabalho terminou.
ADDR(4)|CMD(8)|~ADDR(4)|~CMD(8) de 24 bits MSB-first, bit = marca de 500 µs
data/TCL-kumanda-kodlari.md.w19 de 32 bits; a tabela de teclas corresponde
a esses valores (VOL+ = 0x0b0f4f00, verificado byte a byte). As teclas de fábrica surgem como
eventos de entrada especiais type-0x19 — e o byte de argumento vem da tabela de teclas,
não do quadro.0x01 e 0x0C; esses valores devem vir da família de dígitos da tabela
({b2,a3,f7,ac,81,58,92,ef}); eles não existem lá. Nenhuma sequência válida pode ser
construída. Além disso, a flag de modo de relatório que controla a emissão de type-0x19
fica atrás de sysfs restrito a root.Todas as afirmações foram verificadas em logs/getevent/desmontagem; trechos de exemplo:
data/kanit-ornekleri.md · log bruto de medição de IR:
data/tus_kaydi_ham.log · a própria tabela de teclas do kernel:
data/ir_table.bin (+ parser: tools/arduino/ir_tablo_parse.py).
docs/ the seven phase documents — Turkish originals
docs/en/ the same seven documents, fully in English
tools/arduino/fabrika/ the universal IR blaster (fabrika.ino + firing script)
tools/arduino/{kumanda,tus_kaydet,ogren_gonder,ses_ac_oto}/ the IR tool-chain sketches
tools/arduino/rcu_hesap.py RCU 13-byte + CRC16-CCITT-FALSE generator (note: legacy word format — docs/04)
tools/factorysock.py client for the 27856 factory socket
tools/p2pclient.py ts-protocol client skeleton
data/ key table + kernel ir_table.bin + raw log + evidence excerpts
assets/ cover GIF + real-rig photo + receiver/TV wiring guide (PDF)