Comprobar la placa

Si la placa no responde, sigue estos pasos en orden, empezando por lo más sencillo. Casi siempre la causa es el cable, el controlador del ordenador o el programa que lleva la placa, no una avería.

Comprobaciones rápidas

• El cable: algunos cables USB-C solo sirven para cargar y no transmiten datos. Prueba con otro cable y con otro puerto USB del ordenador.
• El LED de encendido: al conectar la placa se enciende en verde el LED rotulado ON, en el centro, dentro del engranaje del logo de hardware libre. Si no se enciende, la placa no recibe corriente: revisa el cable y el puerto.

• El modo: si el conmutador está en modo MkMk, el joystick, el sensor de luz, el de temperatura, el micrófono y los pulsadores no funcionan. Se explica en Modo sensores / Modo MkMk.

EchidnaML no detecta la placa

1. ¿El ordenador ve la placa?

Con la placa conectada, mira si el sistema la reconoce como un puerto serie:

• Windows: en el Administrador de dispositivos, apartado Puertos (COM y LPT), debe aparecer un dispositivo USB-SERIAL CH340.
• GNU/Linux: en una terminal, ls /dev/ttyUSB* debe mostrar un puerto, normalmente /dev/ttyUSB0.
• macOS: en una terminal, ls /dev/cu.* debe mostrar un puerto con usbserial o wchusbserial en el nombre.

Si no aparece:

• Falta el controlador: la placa usa el chip CH340, cuyo controlador se llama CH341. Instálalo como se explica en Descarga › Controlador de la placa. En GNU/Linux no suele hacer falta.
• Si sigue sin aparecer, vuelve a las comprobaciones rápidas: otro cable y otro puerto.

2. ¿Tienes permiso para usar el puerto?

En GNU/Linux, tu usuario necesita permiso para usar el puerto serie. Si el puerto aparece pero EchidnaML no conecta, ejecuta en una terminal:

sudo usermod -a -G dialout tu_usuario

Después cierra la sesión y vuelve a entrar. En Windows y macOS el permiso ya está dado.

3. ¿Otro programa está usando la placa?

Solo un programa a la vez puede comunicarse con la placa. Cierra el Arduino IDE, otras ventanas de EchidnaML y la pestaña del test en el navegador si la tienes abierta.

4. ¿Conectaste la placa con EchidnaML ya abierto?

Lo mejor es conectar la placa antes de abrir EchidnaML. Si ya estaba abierto, guarda tu proyecto y vuelve a detectar la placa como se explica en Reconectar la placa: la detección reinicia el entorno y se pierde lo que no esté guardado.

5. ¿La placa tiene StandardFirmata?

EchidnaML se comunica con la placa gracias al programa StandardFirmata, que viene cargado de fábrica. Si alguien ha cargado otro programa con el Arduino IDE, EchidnaML ya no la reconoce.

Para comprobarlo, abre el test en el navegador y pulsa Conectar: si la placa responde, tiene StandardFirmata. Si no responde, instala StandardFirmata de nuevo.

Un componente no responde

Si EchidnaML conecta con la placa pero un sensor o un actuador no funciona:

1. Comprueba el modo: en modo MkMk varios sensores dejan de funcionar (ver las comprobaciones rápidas).
2. Pruébalo aislado con el test en el navegador: así sabrás si falla el componente o el programa.
3. Casos conocidos:
   • El joystick no llega a los valores extremos: a veces el capuchón está demasiado hundido y choca con la base. Sácalo un poco hacia arriba.
   • Un componente externo no funciona o la placa se reinicia: revisa el selector de alimentación de las entradas y salidas y el consumo de lo que hayas conectado.

Resumen

Si nada funciona

Escríbenos contando qué has probado, o abre una issue en GitHub como se explica en Cómo colaborar.

Herramientas de comprobación

Dos herramientas para probar la placa, de la más sencilla a la más técnica. La del Arduino IDE sustituye a StandardFirmata: al terminar, vuelve a instalarlo para usar la placa con EchidnaML.

• 

  Test de la placa en el navegador

  La forma más sencilla: prueba cada sensor y actuador desde Chrome o Chromium, sin instalar nada. Necesita StandardFirmata en la placa.

• 

  Test de fabricación (Arduino IDE)

  Prueba completa de todos los componentes, con un informe final, pensada para revisar placas a fondo. También sustituye a StandardFirmata.