57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
# Epifah
|
|
|
|
Reimplementação independente do protocolo usado pela app legada **Aha Radio**, para voltar a usar
|
|
o ecrã e os controlos do MediaNav Evolution de um Renault Clio IV com apps de media atuais.
|
|
|
|
> Projeto pessoal, em fase inicial (reverse engineering). **Ainda não há nada utilizável.**
|
|
> Não afiliado à Harman nem à Renault.
|
|
|
|
## Porquê
|
|
|
|
A Aha Radio (Harman) está praticamente morta, mas a head unit continua a falar o seu protocolo.
|
|
O objetivo é perceber esse protocolo, escrever uma app Android que o fale e usá-lo para mostrar e
|
|
controlar conteúdo atual no ecrã do carro, coisas que o streaming Bluetooth genérico não permite.
|
|
E, claro, pelo desafio.
|
|
|
|
## Estado
|
|
|
|
Fase 0: preparação e pesquisa. O plano completo, os riscos e as fases estão em
|
|
[`docs/PROJECT.md`](docs/PROJECT.md).
|
|
|
|
## Estrutura
|
|
|
|
```
|
|
docs/ plano, descobertas, especificação do protocolo, capturas sanitizadas
|
|
tools/ scripts de análise
|
|
prototype/ prova de conceito
|
|
app/ app Android
|
|
AGENTS.md contexto do projeto para LLMs e novos colaboradores
|
|
```
|
|
|
|
## Uso de IA
|
|
|
|
Este projeto é desenvolvido com ajuda de IA, e prefiro ser claro quanto a isso.
|
|
|
|
- **Ferramenta:** [Claude](https://claude.ai) (Anthropic), em conversa, para pesquisa, planeamento,
|
|
escrita de documentação, escolha do nome e, mais à frente, apoio na análise e no código.
|
|
- **Responsabilidade:** as decisões e o que é publicado são meus. A IA não substitui a validação:
|
|
qualquer afirmação sobre o protocolo tem de ter evidência (capturas, hooks, código analisado)
|
|
e não é aceite só porque um modelo a disse.
|
|
- **Limitações:** os modelos podem errar ou inventar detalhes. Por isso as hipóteses estão marcadas
|
|
como tal na documentação e o [`AGENTS.md`](AGENTS.md) instrui os agentes a não inventar
|
|
informação de protocolo.
|
|
- **Transparência:** commits com contributo relevante de IA podem incluir o trailer
|
|
`Co-authored-by`. Código e documentação gerados ou assistidos por IA são revistos antes de entrar.
|
|
|
|
## Legal
|
|
|
|
- Análise feita sobre equipamento próprio, para fins de interoperabilidade.
|
|
- Este repositório não contém nem distribui código, APKs ou serviços da Harman. A implementação e
|
|
a documentação são originais.
|
|
- Todas as marcas pertencem aos respetivos titulares e são usadas apenas para descrever compatibilidade.
|
|
|
|
## Contribuir
|
|
|
|
Ainda é cedo. Se tiveres um MediaNav Evolution ou documentação do protocolo Aha de outros
|
|
fabricantes, abre um issue.
|