Initial commit: telemetría MQTT/AWS IoT para nano ESP32, Pico W y Pi Zero W

Tres implementaciones equivalentes (MicroPython/Python) que leen sensores
de un vehículo eléctrico (batería, corriente, temperatura, RPM) y publican
por MQTT sobre mTLS a AWS IoT Core.

Author: megebe

.gitignore

@@ -0,0 +1,22 @@
+# Configuración local con credenciales (WiFi, endpoint MQTT) - nunca se sube
+config.py
+
+# Claves privadas y certificados de dispositivo (mTLS AWS IoT)
+# Las Root CA públicas (AmazonRootCA1.pem, root-CA.crt, amazon_ca.der.crt) SÍ se versionan.
+*.private.key
+*-private.pem.key
+*-public.pem.key
+*-certificate.pem.crt
+private.der.key
+certificate.der.crt
+Raspberry.cert.pem
+Raspberry.private.key
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+venv/
+
+# Sistema
+.DS_Store

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miguel Garcia Barreiro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,46 @@
+# Telemetría IoT para vehículo eléctrico
+
+Sistema de telemetría en tiempo real para un vehículo eléctrico (batería, corriente, temperatura del motor, RPM de motor y rueda, acelerador y freno), con tres implementaciones equivalentes sobre distinto hardware. Cada nodo lee los sensores analógicos/digitales del vehículo y publica un mensaje JSON por MQTT sobre TLS mutuo (mTLS) a **AWS IoT Core**.
+
+Proyecto desarrollado como parte de un Trabajo Fin de Máster (TFM).
+
+## Arquitectura
+
+```
+Sensores del vehículo → [nodo embebido] → MQTT sobre mTLS (TLS 1.2, cert. X.509) → AWS IoT Core
+```
+
+Cada nodo se autentica con su propio certificado de dispositivo (mTLS), no con usuario/contraseña. Los tres nodos implementan la misma lógica de lectura de sensores y publicación, adaptada a las capacidades de cada plataforma:
+
+| Carpeta | Placa | Lenguaje | Notas |
+|---|---|---|---|
+| `nanoesp32/` | Arduino Nano ESP32 | MicroPython | ADC interno de la placa |
+| `pipico-code/` | Raspberry Pi Pico W | MicroPython | ADC externo (ADC Pi); dos variantes: `main.py` y `main_python.py` (mismo hardware, publican en topics MQTT distintos) |
+| `pi_zerowh_code/` | Raspberry Pi Zero W | Python 3 | ADC externo (ADC Pi), usa el SDK oficial de AWS IoT |
+
+## Configuración (obligatoria antes de ejecutar)
+
+Ningún secreto (contraseña WiFi, certificados, claves privadas) está en el repositorio. Antes de usar cualquiera de los nodos:
+
+1. **Credenciales de conexión** — en `nanoesp32/` y `pipico-code/`, copia `config.example.py` como `config.py` y rellena tu SSID/contraseña de WiFi y el endpoint de AWS IoT (Consola AWS IoT → *Configuración*). En `pi_zerowh_code/`, copia igualmente `config.example.py` como `config.py`.
+2. **Certificados del dispositivo** — crea una "Thing" (dispositivo) por nodo en AWS IoT Core, genera su certificado X.509 y su clave privada, adjúntale una policy (ver [`pi_zerowh_code/iot-policy.example.json`](pi_zerowh_code/iot-policy.example.json) como plantilla), y coloca los ficheros donde indica el `README.md` de cada subcarpeta de certificados (`cert_n/`, `cert_rpipico/`, `certs_n/`, `pi_zerowh_code/`).
+
+Ninguno de estos ficheros (`config.py`, certificados, claves privadas) se sube a git — están excluidos vía `.gitignore`.
+
+## Ejecución
+
+- **nanoesp32 / pipico-code (MicroPython):** copia todos los ficheros de la carpeta (incluido tu `config.py` y tus certificados) a la placa, por ejemplo con [`mpremote`](https://docs.micropython.org/en/latest/reference/mpremote.html) o [`rshell`](https://github.com/dhylands/rshell). Al arrancar, `boot.py` conecta el WiFi y `main.py` publica telemetría por MQTT cada segundo.
+- **pi_zerowh_code (Python 3):**
+  ```bash
+  pip install -r requirements.txt
+  python3 main.py
+  ```
+  `start.sh` es un script auxiliar (basado en el ejemplo oficial de AWS) para probar la conectividad pub/sub contra AWS IoT antes de lanzar `main.py`; requiere la variable de entorno `AWS_IOT_ENDPOINT`.
+
+## Firmware
+
+Para flashear MicroPython en la Raspberry Pi Pico W, descarga el `.uf2` oficial desde [micropython.org/download](https://micropython.org/download/RPI_PICO_W/).
+
+## Licencia
+
+MIT — ver [LICENSE](LICENSE).

nanoesp32/boot.py

@@ -0,0 +1,21 @@
+# boot.py -- run on boot-up
+import network
+import machine
+import config
+
+
+def connect_wifi(ssid, password):
+    wlan = network.WLAN(network.STA_IF)
+    wlan.active(True)
+    wlan.connect(ssid, password)
+    while not wlan.isconnected():
+        machine.idle()
+
+
+def main():
+    connect_wifi(config.WIFI_SSID, config.WIFI_PASSWORD)
+    print("WIfi conectado.")
+
+
+if __name__ == "__main__":
+    main()

nanoesp32/cert_n/README.md

@@ -0,0 +1,8 @@
+# Certificados (formato DER)
+
+Coloca aquí, tras generarlos en AWS IoT Core para este dispositivo, los siguientes ficheros (ignorados por git):
+
+- `certificate.der.crt` — certificado del dispositivo (DER)
+- `private.der.key` — clave privada del dispositivo (DER)
+
+`mazon_ca.der.crt` (Amazon Root CA en DER) ya está incluido: es un certificado público, no un secreto.

nanoesp32/cert_n/mazon_ca.der.crt

@@ -0,0 +1,20 @@
+-----BEGIN CERTIFICATE-----
+MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF
+ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
+b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL
+MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
+b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj
+ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM
+9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw
+IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6
+VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L
+93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm
+jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA
+A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI
+U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs
+N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv
+o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU
+5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy
+rqXRfboQnoZsG4q5WTP468SQvvG5
+-----END CERTIFICATE-----

nanoesp32/cert_rpipico/AmazonRootCA1.pem

@@ -0,0 +1,9 @@
+# Certificados (formato PEM)
+
+Coloca aquí, tras generarlos en AWS IoT Core para este dispositivo, los siguientes ficheros (ignorados por git):
+
+- `PiPico-certificate.pem.crt` — certificado del dispositivo
+- `PiPico-private.pem.key` — clave privada del dispositivo
+- `PiPico-public.pem.key` — clave pública del dispositivo
+
+`AmazonRootCA1.pem` ya está incluido: es un certificado público, no un secreto.

nanoesp32/cert_rpipico/README.md

@@ -0,0 +1,8 @@
+# Copia este fichero como "config.py" y rellena tus propios valores.
+# config.py NO se sube a git (ver .gitignore).
+
+WIFI_SSID = "TU_SSID"
+WIFI_PASSWORD = "TU_PASSWORD"
+
+# Endpoint de AWS IoT Core (Ajustes > Configuración en la consola de AWS IoT)
+MQTT_ENDPOINT = "tu-endpoint-ats.iot.tu-region.amazonaws.com"