Cómo instalar la librería Sinric Pro (SinricPro.h) en Arduino IDE y PlatformIO
La librería Sinric Pro (también llamada SDK de Sinric Pro) conecta tu ESP32, ESP8266 o Raspberry Pi Pico W (RP2040) a Sinric Pro. Esta página muestra cómo instalarla y cómo corregir los errores de instalación más comunes.
La librería es de código abierto: github.com/sinricpro/esp8266-esp32-sdk
Instalación en Arduino IDE
- Abre el Gestor de bibliotecas: Herramientas > Administrar bibliotecas.
- Busca SinricPro y haz clic en Instalar.
- Cuando Arduino IDE pregunte si quieres instalar las dependencias, elige Instalar todo. Si no lo pregunta, instálalas de la misma manera:
- ArduinoJson de Benoit Blanchon (versión 7.0.3 o posterior)
- WebSockets de Markus Sattler (versión 2.4.0 o posterior)
- Abre un ejemplo: Archivo > Ejemplos > SinricPro.
La librería necesita que también esté instalado el paquete de placas (Arduino core) de tu placa: esp32, esp8266 o Raspberry Pi Pico/RP2040.
Instalación en PlatformIO (VS Code)
Añade sinricpro/SinricPro a lib_deps en tu platformio.ini. PlatformIO descarga la librería y sus dependencias en la siguiente compilación.
[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps = sinricpro/SinricPro
[env:nodemcuv2]
platform = espressif8266
board = nodemcuv2
framework = arduino
lib_deps = sinricpro/SinricPro
Hay un platformio.ini completo disponible aquí.
Descarga e instalación manual
- Descarga la última versión como archivo ZIP desde GitHub releases.
- En Arduino IDE elige Programa > Incluir biblioteca > Añadir biblioteca .ZIP y selecciona el archivo.
- Instala ArduinoJson y WebSockets desde el Gestor de bibliotecas.
Usa la librería en tu sketch
#include <SinricPro.h>
#include <SinricProSwitch.h>
SinricPro.h es el archivo de cabecera principal. Cada tipo de dispositivo tiene su propia cabecera, por ejemplo SinricProSwitch.h, SinricProLight.h o SinricProTemperaturesensor.h. Consulta los ejemplos de cada tipo de dispositivo y la documentación completa del SDK.
Para ver un primer sketch completo, consulta Cómo controlar un ESP32 o ESP8266 con Alexa y Google Home.
Solución de problemas
fatal error: SinricPro.h: No such file or directory
La librería no está instalada en el IDE con el que estás compilando. Instala SinricPro desde el Gestor de bibliotecas (Arduino IDE) o añade sinricpro/SinricPro a lib_deps (PlatformIO).
fatal error: ArduinoJson.h: No such file or directory o WebSocketsClient.h: No such file or directory
Falta una dependencia. Instala ArduinoJson (7.0.3 o posterior) y WebSockets de Markus Sattler (2.4.0 o posterior).
Errores de compilación después de actualizar
Actualiza ArduinoJson, WebSockets y el paquete de placas (Arduino core) a sus últimas versiones. La librería requiere Arduino core 3.x.
Si tienes problemas de conexión después de subir el sketch, consulta la página de Solución de problemas.
Otros SDK
La librería de Arduino anterior es compatible con ESP32, ESP8266 y RP2040. Para otras placas y lenguajes:
- SDK para Raspberry Pi Pico
- SDK para ESP-IDF
- Arduino UNO R4 WiFi, Nano 33 IoT, MKR WIFI 1010, Seeedstudio Wio Terminal
- SDK para MicroPython
- SDK para Python
- SDK para NodeJS
Este documento es de código abierto. ¿Ves un error? Por favor, crea un issue