Mais comentários para tornar o arquivo a raiz da documentação.

Author: lhsacchi

CristalLiq-serial/CristalLiq-serial.ino

@@ -17,6 +17,34 @@
 * Outras aplicações podem definir outros modelos de mensagens nos quadros do protocolo.
 */
 
+/**
+ * @mainpage Módulo Arduino - CristalLiq
+ *
+ * @section intro_sec Introdução
+ * Este projeto implementa a comunicação entre o display de cristal líquido
+ * e o Arduino via porta serial, utilizando a classe `Frame` para estruturar
+ * mensagens.
+ *
+ * @section features_sec Funcionalidades
+ * - Exibição de mensagens em display LCD 4 linhas.
+ * - Emissão de sinais sonoros via buzzer.
+ * - Recepção de comandos da TV-Box através de protocolo serial.
+ *
+ * @section arch_sec Arquitetura
+ * O sistema é dividido em:
+ * - `CristalLiq-serial.ino`: ponto de entrada e lógica principal.
+ * - `frame.h/.cpp`: implementação da classe Frame.
+ * - `SerialProtocol`: abstração do protocolo de comunicação.
+ *
+ * @section usage_sec Uso
+ * 1. Carregue o código no Arduino Nano.
+ * 2. Conecte o display LCD e o buzzer conforme o diagrama de hardware.
+ * 3. Estabeleça a comunicação serial via USB com a TV-Box.
+ *
+ * @section img_sec Diagrama
+ * ![Arquitetura do Módulo](img/arquitetura.png)
+ */
+
 #include <Wire.h>              // Biblioteca utilizada para fazer a comunicação com o I2C
 #include <LiquidCrystal_I2C.h> // Biblioteca utilizada para fazer a comunicação com o display 20x4 
 #include "frame.h"