Controla tu Raspberry Pi a distancia con PiControl

PiControl de PiCockpit es una potente función que le permite controlar su Raspberry Pi de forma remota desde cualquier navegador web, simplemente haciendo clic en los botones.

Verá el estado y la salida del comando.

Se pueden añadir nuevos comandos simplemente editando un archivo JSON en tu Raspberry Pi.

En este artículo te mostraremos cómo hacerlo y te daremos algunas ideas de lo que puedes construir con PiControl.

¿Qué aspecto tiene?

Notarás que, por defecto, tres comandos están incluidos e inmediatamente disponibles para tu Raspberry Pi: apagar, reiniciar, actualizar cliente.

¿Qué puedo hacer con una Raspberry Pi y PiControl?

Aquí hay algunas cosas que puedes construir con él. Estas ideas requerirán algo de investigación, y posiblemente conocimientos de codificación y/o hardware por tu parte; en cualquier caso, PiCockpit's PiControl te ayudará con la parte de la interfaz web fácil de usar de tu proyecto y te ahorrará toneladas de tiempo haciendo que esto funcione a través de Internet 🙂 .

• tomar una instantánea con el módulo de cámara de la Raspberry Pi y enviarla por correo
• inicie su servidor de Raspberry Pi Minecraft, y deténgalo también
• Reproducir un vídeo con omxplayer (también puedes establecer un bucle infinito para el vídeo y detener el bucle de vídeo si quieres cambiar a otro vídeo)
• crear un control sencillo para una cámara de animación stop-motion, utilizando el módulo de cámara de Raspberry Pi
• despertar un ordenador local en la misma red que su Raspberry Pi con la función Wake on LAN
• reproducir un sonido (como una broma para Halloween, por ejemplo)
• abrir una puerta, por ejemplo, una puerta de garaje, emitiendo los comandos de control adecuados a través de Z-Wave, etc.
• inicie el servicio SSH en su Raspberry Pi, y apáguelo - un enfoque de "golpear para abrir" para mejorar la seguridad
• control de maquetas de trenes
• encender y apagar un relé (se necesitan dos botones, o se puede hacer con un botón "toggle")
• controlar el televisor (cambiar de canal, cambiar el volumen, ...) mediante un LED IR, por ejemplo, para simular la actividad mientras está de viaje
• Lanzar un cohete desde la interfaz web

Publicaremos instrucciones paso a paso para algunas de estas ideas de proyectos, para que tengas una guía fácil para empezar con PiControl y controlar remotamente tu Raspberry Pi.

¿Cómo puedo añadir botones adicionales de mando a distancia para la Raspberry Pi con PiControl?

Puedes definir fácilmente y de forma segura tus propios comandos, simplemente editando archivos JSON en tu Raspberry Pi. Esto se hace por razones de seguridad - podría haber escrito PiCockpit de una manera que le permitiera añadir comandos desde la interfaz web, pero si alguien supiera su contraseña de PiCockpit, podría crear cualquier comando que deseara. Por lo tanto, siga estas sencillas instrucciones para crear un nuevo archivo JSON en su Pi.

Nota: estas instrucciones se han mantenido deliberadamente de forma que los usuarios que no tienen experiencia con la línea de comandos puedan seguirlas. Si sabes usar la línea de comandos, puede que te resulte más fácil/rápido crear el archivo y editarlo con nano.

En primer lugar, tendrás que abrir el explorador de archivos en modo de superusuario (este paso mantiene tus archivos de configuración de PiCockpit PiControl a salvo de cualquier usuario o aplicación que quiera manipularlos). Haz clic en el menú Raspberry Pi OS, y aquí haz clic en el comando "Ejecutar ...":

Ejecute pcmanfm como root (sudo pcmanfm) escribiendo "sudo pcmanfm" (sin las comillas) en el cuadro de diálogo que se abre, y haciendo clic en Aceptar:

Se abre una nueva ventana que muestra el contenido del directorio /home/pi:

Nota: debería ver este icono, justo debajo del menú "Archivo". Indica que está usando pcmanfm como usuario root, y por lo tanto debe tener mucho cuidado (¡ya que el root puede editar / borrar / mover cualquier archivo! incluso archivos que son críticos para un funcionamiento normal del sistema).

No te preocupes, aquí sólo tocaremos los archivos que necesites 🙂 .

Abra el siguiente directorio en su Raspberry Pi:

/etc/picockpit-client/apps/com.picockpit/picontrol/modules

Consejo: también puedes copiar y pegar la ruta que te he dado arriba, y pulsar la tecla enter para navegar hasta el directorio.

Consejos útiles de Raspi Berry sobre Raspberry Pi

haga clic con el botón derecho del ratón en el área vacía junto a los archivos existentes y seleccione "Nuevo archivo...".

Llama al nuevo archivo ssh-server.json:

Ahora, tienes que hacer clic con el botón derecho del ratón en el nuevo archivo, para que aparezca el menú contextual. Elige "Geany":

Ahora puede ver el nuevo archivo que acabamos de crear. Sin embargo, por el momento, está vacío.

Vamos a crear dos nuevos comandos, uno para apagar el servicio del servidor SSH, y otro para iniciarlo. Introduce lo siguiente en el campo de texto que te muestra Geany:

{
  "name": "SSH commands",
  "icon": "mdi-ssh",
  "handle": "ssh",
  "description": "Control the SSH server",
  "commands": {
    "ssh-stop": {
      "name": "SSH Server off",
      "icon": "mdi-server-minus",
      "description": "Shuts the SSH service down",
      "confirm": true,
      "user": "root",
      "command": ["service", "ssh", "stop"]
    },
    "ssh-start": {
      "name": "SSH Server on",
      "icon": "mdi-server-plus",
      "description": "Starts the SSH service",
      "user": "root",
      "command": ["service", "ssh", "start"]
    }
  }
}

En este punto debemos guardar el archivo. Puede hacerlo desde el menú de archivo de Geany, por ejemplo, seleccionando Guardar. (O usar Ctrl + S):

En este punto nuestros nuevos comandos aún no han aparecido en el webinterface. En este punto, necesitarás reiniciar picockpit-client para esto. Haz clic en el comando "Ejecutar ..." en el menú Raspberry Pi OS, y escribe "sudo service picockpit-client restart" en la ventana antes de hacer clic en Aceptar:

Ahora eche un vistazo a su interfaz web PiControl:

Si ha escrito todo correctamente, los nuevos comandos aparecerán. Si ha cometido un error en su archivo JSON (por ejemplo, ha olvidado una llave), PiCockpit simplemente ignorará el archivo "roto".

Ahora puede probar los comandos. Si haces clic en el botón SSH SERVER OFF, se te preguntará si realmente quieres ejecutar el comando. Haz clic en ssh server off aquí también, para ejecutar realmente el comando (o haz clic en cancelar si no quieres después de todo).

Así, PiCockpit ejecutará ahora el comando, verás información sobre el progreso - y después de que haya terminado de ejecutarse, verás el siguiente indicador de éxito:

Si intentas conectarte a tu Pi ahora usando SSH, la conexión será rechazada:

Inicie de nuevo el servidor SSH haciendo clic en "SSH SERVER ON". Ahora la conexión será posible de nuevo.

¡Enhorabuena! Acabas de crear tu propio conjunto de comandos que puedes ejecutar desde la interfaz web.

Permanezca en la página mientras ejecuta los comandos - el estado se borrará si se aleja. Para determinar si el servidor SSH se está ejecutando, podría construir una prueba PiDoctor - PiControl es simplemente para ejecutar acciones remotas en su Pi.

Consejos útiles de Raspi Berry sobre Raspberry Pi (y PiCockpit)

Recuerda reiniciar el picockpit-client cuando añadas nuevos comandos, o actualices comandos. También puedes eliminar los comandos que no quieras tener, por ejemplo si quieres eliminar la capacidad de apagar tu Raspberry Pi de forma remota.

Explicación de la sintaxis del comando remoto

El archivo configura un nuevo módulo para PiControl. Tiene una sintaxis .JSON, por favor, asegúrese de que abre y termina con llaves de forma correcta, como se presenta en mi ejemplo.

Hay una cabecera, que configura el propio módulo, y los comandos (en la parte de "comandos"). Comparten algunas entradas comunes:

nombre

Las entradas de "nombre" son nombres legibles que se muestran en la interfaz web

icono

Las entradas de "icono" son opcionales para decorar sus botones y módulo. Son nombres de iconos de Material Design, por ejemplo "mdi-ssh".

Puede consultar un lista completa de iconos de Material Design aquí. Basta con copiar el nombre del icono (incluyendo el mdi- del principio).

Consejos útiles de Raspi Berry sobre Raspberry Pi (y PiCockpit)

descripción

Las entradas de "descripción" son opcionales y le permiten añadir un poco más de información para el comando o módulo.

manija

La entrada "handle" es explícita para el módulo, y tiene que ser única entre los módulos. En el caso de los comandos, el "handle" es implícito. "ssh-stop" y "ssh-start" son los dos manejadores que he utilizado para los comandos en mi ejemplo.

Puedes elegir cualquier cosa como asa, siempre que no incluya los caracteres "/", "+", "$", "*". Te recomiendo que te ciñas a los caracteres ASCII básicos en minúsculas, y que utilices el "-". El asa es requerido.

Su archivo puede, por cierto, tener un nombre de archivo diferente al del handle - le animo a utilizar al menos nombres relacionados para el nombre del archivo y el handle, para que pueda identificar fácilmente el archivo .JSON del módulo en su disco duro.

Consejos útiles de Raspi Berry sobre Raspberry Pi (y PiCockpit)

Los comandos van en la sección "comandos", y tienen posibilidades de configuración adicionales:

confirmar

Si "confirmar" está presente y es verdadero, la interfaz web de PiControl mostrará un diálogo de confirmación antes de ejecutar el comando. Esto es útil para asegurarse de que los comandos "peligrosos" no se ejecuten por un toque o clic accidental.

usuario

Si "usuario" está presente, el comando se ejecutará como este usuario en particular (como raíz en nuestro ejemplo, para asegurarnos de que tenemos suficientes privilegios).

PiControl ejecutará los comandos como usuario "pi" por defecto. También puede establecerlo para otros usuarios con menos privilegios que "pi“.

Si intentas ejecutar comandos GPIO, o reproducir videos usando omxplayer, puede que tengas que dar a tu nuevo usuario capacidades adicionales. El usuario pi tiene estos privilegios necesarios por defecto. Normalmente estos privilegios se establecen añadiendo el usuario a un grupo especial.

Consejos útiles de Raspi Berry sobre Raspberry Pi (y PiCockpit)

comando

Este es el comando real que debe ejecutar en su Raspberry Pi. Tenga en cuenta que debe reemplazar los espacios en el comando en comparación con como lo ejecutaría en la línea de comandos. Por ejemplo,

servicio ssh start

debería escribirse como:

["servicio", "ssh", "inicio"]

PiControl también soporta el encadenamiento de una secuencia de comandos (por ejemplo, la secuencia habitual de apt-get update, apt-get upgrade). Consulte core.json para ver un ejemplo de cómo se hace.

Consejos útiles de Raspi Berry sobre Raspberry Pi (y PiCockpit)

Conclusión: PiControl para sus necesidades de control remoto de Raspberry Pi

Usando PiCockpit y PiControl, es realmente fácil añadir cualquier comando remoto que desee ejecutar en su Raspi, y ser capaz de controlar su Pi desde una interfaz web. Para que esto funcione la Raspberry Pi sólo necesita una conexión a Internet - no es necesario estar en la misma red.

Qué te gustaría construir usando PiCockpit y PiControl? Comenta abajo, e intentaré ayudarte con tu proyecto 🙂 .

Un gran poder conlleva una gran responsabilidad - ten cuidado a quién das acceso a tu interfaz PiCockpit, mantén a salvo tu contraseña y claves API. También asegúrese de "proteger" los comandos peligrosos, como se discutió anteriormente, para que no se ejecuten al hacer clic accidentalmente en ellos.

Consejos útiles de Raspi Berry sobre Raspberry Pi (y PiCockpit)