Merge branch 'pr/3'
diegoalrv
commit
371da77fb0
|
|
@ -0,0 +1,77 @@
|
|||
# Guía de configuración para Modulo LED
|
||||
|
||||
## Materiales Necesarios
|
||||
|
||||
- Raspberry Pi, versión 3 o superior.
|
||||
- Hat de conexión HUB75
|
||||
- Paneles LED P4 con I/O HUB75
|
||||
- Fuente de alimentación con salida 5V/3A
|
||||
- Cables de Alimentación 4-pin 5V/3A
|
||||
- Cables de datos con conexión HUB75
|
||||
|
||||
## Configuración inicial
|
||||
|
||||
### Conexionado
|
||||
|
||||
Para las conexiones de datos, se utilizan cables hembra HUB75 de 16-pines, estos se conectan en un extremo al HAT HUB75 para Raspberry PI. En caso de tener un HAT con multiples conexiones de HUB75, siempre utilizar la salida TOP para la primera fila del conjunto de paneles, y usar el resto de las salidas para las filas inferiores. El extremo opuesto del cable de datos debe conectarse en el "input" del panel, estos modulos tienen etiquetada su entrada y salida en la parte posterior. Ver las imagenes mostradas como referencia visual.
|
||||
|
||||
Para la conexión electrica, cada uno de los paneles LED tiene una entrada de cuatro pines para cables de alimentación. Es necesario tener una fuente de poder con salida de 5V y un minimo de 3A, para cumplir con los criterios de alimentación en los modulos LED.
|
||||
|
||||
  
|
||||
|
||||
|
||||
A continuación, se presenta un diagrama de conexiones, tanto para los datos como para la alimentación. Notar que la referencia (0,0) corresponde a la orientación superior izquierda de las gráficas que se deseen desplegar en el módulo, también se señala la orientación de las entradas y salidas de cada panel en la configuración.
|
||||
|
||||
|
||||
|
||||
### Configuración de Raspberry Pi
|
||||
|
||||
Luego de haber descargado los datos almancenados en este reposotorio. En el directorio ModuloLED, encontrará un script llamado `MenuPantalla.sh`, en este menú se puede hacer dos acciones en concreto:
|
||||
|
||||
- Configurar parámetros de la implementación, modificando variables del codigo base.
|
||||
- Desplegar una imagen a partir de un archivo imagen jpg o png almacenada en el sistema.
|
||||
|
||||
#### Configuración de Parámetros
|
||||
|
||||
Entre las opciones de configuración en el codigo base para el funcionamiento del panel se muestran en la siguiente tabla:
|
||||
|
||||
| Parámetro | Variable código base | Rango de valores |
|
||||
| ------------ | ------------ | ------------ |
|
||||
| N° de filas de pixeles en un panel. | `options.rows` | PANEL |
|
||||
| N° de columnas de pixeles en un panel. | `options.col` | PANEL |
|
||||
| N° de filas de paneles montados | `options.parallel` | 1 - 3 |
|
||||
| N° de columnas de paneles montados | `options.chain_length` | 1 - 3 |
|
||||
| Brillo | `options.brightness` | 0 - 100 |
|
||||
| Mapeo GPIO para HAT | `options.hardware_mapping` | `regular`, ver otras opciones [aquí](https://github.com/hzeller/rpi-rgb-led-matrix/blob/master/wiring.md#alternative-hardware-mappings) |
|
||||
| Multiplexación | `options.multiplexing` | 1 (por defecto) - 17|
|
||||
| Retardo GPIO | `options.gpio_slowdown` | 1 - 5 |
|
||||
|
||||
**PANEL: Dado por el fabricante del panel comprado.**
|
||||
|
||||
## Despliegue de imagenes
|
||||
|
||||
Al seleccionar esta opción, se mostrarán todos los archivos de imagen guardados en el sistema de la Raspberry Pi. Se recomienda utilizar imagenes con la mimsa relacion de aspecto que la resolución de la pantalla montada para el despliegue. De lo contrario, la pantalla tendrá espacios en negro.
|
||||
|
||||
### Variables del Sistema Operativo
|
||||
|
||||
Se propone un Sub-sistema que se encargue de manera dedicada al renderizado en la Matriz LED en forma continua. Para eso se implementa un *demonio* de Linux que esta continuamente dibujando en el display.
|
||||
|
||||
Para ello se reserva el procesador 3, entregandoselele la `CPUAffinity=3` al proceso, de manera de garantizar el recurso computacional. Adicionalmente se modifica el Sistema Operativo para que quite el procesador del itineradoe usando `isocpus=3` en la variable de inicio `/boot/cmdline.txt`.
|
||||
|
||||
Además se monta un directorio de `/srv/ledram` que tiene un tamaño de 32MB para disponer una *memoria de video* en RAM que permita a otros procesos actualizar el contenido que se despliega en el display. Para ello se modifica el `/etc/fstab` para que se cree el recurso automaticamente al iniciarse la Raspberry.
|
||||
|
||||
#### Sub-sistema de renderizado
|
||||
|
||||
Se define el directorio `/srv` donde se aloja el sub-sistema de renderizado. Esta compuesto del script `/srv/subsystem/led-driver.py` que es iniciado en forma automática por `systemd`.
|
||||
|
||||
El script ve la hora de modificación del archivo `/srv/ledram/current.png` para determinar si debe o no actualizar la imagen que se está desplegando actualmente en el display cada 100 ms.
|
||||
|
||||
De esta manera, cualquier usuario o proceso (`chmod 666`) puede escribir ese archivo. Siendo este sub sistema el encargado de leer el contenido de la imagen y renderizarlo en el display led en forma permanente.
|
||||
|
||||
#### Instalación como servicio
|
||||
|
||||
Todos estos pasos están automatizados en el script `install-service.sh` que debe ser ejecutado como `root`.
|
||||
|
||||
#### TODO
|
||||
|
||||
Falta que el script detecte cuando se le solicita salir, para que elimine el archivo `/srv/ledram/current.png`, de tal manera de poder `systemctl stop led-driver.service` y `systemctl start led-driver.service` sin depender que la imagen se elimine en forma automatica al ser un directorio volatil
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 26 KiB |
|
|
@ -0,0 +1,44 @@
|
|||
#!/bin/bash
|
||||
|
||||
if [ "$EUID" -ne 0 ]; then
|
||||
echo "Este script requiere permisos de root."
|
||||
exit
|
||||
fi
|
||||
|
||||
# set pwd to current directory
|
||||
cd "$(dirname "$0")"
|
||||
|
||||
#limpia el contenido del directorio de trabajo
|
||||
rm -rf /srv/ledram/*
|
||||
rm -rf /srv/*
|
||||
|
||||
# Configura un directorio `/srv/ledram` como buffer de video
|
||||
sed -i -e '/srv/d' /etc/fstab
|
||||
sed -i -e '$a/tmpfs /srv/ledram tmpfs rw,nosuid,nodev,size=32m 0 0' /etc/fstab
|
||||
|
||||
# Crea directorio donde se almacena el buffer de video
|
||||
mkdir /srv/ledram
|
||||
|
||||
# Desocupa el tercer procesador para ser usado exclusivamente por el sub-proceso de renderizado
|
||||
sed -i -e 's/ isocpus=3//g' /boot/cmdline.txt
|
||||
sed -i -e 's/$/ isocpus=3/' /boot/cmdline.txt
|
||||
|
||||
#copia la biblioteca al directorio de trabajo
|
||||
cp -R rgbmatrix /srv/rgbmatrix
|
||||
|
||||
#copia el sub-sistema de renderizado
|
||||
mkdir /srv/subsystem
|
||||
cp -rf init.png /srv
|
||||
cp -rf led-driver.py /srv/subsystem
|
||||
|
||||
#Crea el servicio
|
||||
cp -rf led-driver.service /etc/systemd/system/led-driver.service
|
||||
|
||||
# Recarga e inicia automaticamente al prender.
|
||||
systemctl daemon-reload
|
||||
systemctl unmask led-driver.service
|
||||
systemctl enable led-driver.service
|
||||
|
||||
# Mensajes de salida
|
||||
echo "Debe reiniciar la Raspberry para que el servicio pueda iniciarse"
|
||||
echo "Luego para actualizar, solo debe modificar el el archivo '/srv/ledram/current.png' para actualizar la pantalla"
|
||||
|
|
@ -0,0 +1,52 @@
|
|||
#!/usr/bin/env python
|
||||
import time
|
||||
import sys
|
||||
import os
|
||||
import shutil
|
||||
|
||||
from rgbmatrix import RGBMatrix, RGBMatrixOptions
|
||||
from PIL import Image
|
||||
|
||||
# Configuration for the matrix
|
||||
options = RGBMatrixOptions()
|
||||
options.rows = 40
|
||||
options.cols = 80
|
||||
options.chain_length = 2
|
||||
options.parallel = 1
|
||||
options.gpio_slowdown = 4
|
||||
#options.row_address_type = 0
|
||||
|
||||
options.hardware_mapping = 'regular' # If you have an Adafruit HAT: 'adafruit-hat'
|
||||
options.multiplexing = 1
|
||||
options.brightness = 100
|
||||
#options.pwm_lsb_nanoseconds = 300
|
||||
#options.pwm_bits = 11
|
||||
|
||||
matrix = RGBMatrix(options = options)
|
||||
|
||||
#Bufer que se copia en la pantalla led
|
||||
img_path='/srv/ledram/current.png'
|
||||
#imagen por defecto a mostrar al inicializarla
|
||||
init_file='/srv/init.png'
|
||||
|
||||
# Revisa si el bufer existe, si no existe lo crea
|
||||
# y si existe sale ya que hay otro proceso que lo
|
||||
if not os.path.isfile(img_path):
|
||||
shutil.copy(init_file, img_path)
|
||||
os.chmod(img_path, 0o666)
|
||||
else:
|
||||
print("El archivo de buffer ya existe!")
|
||||
exit(1)
|
||||
|
||||
#guarda el tiempo de modificación
|
||||
tstam = os.stat(img_path).st_mtime
|
||||
matrix.SetImage(Image.open(img_path).convert('RGB'))
|
||||
|
||||
while True:
|
||||
time.sleep(0.1)
|
||||
ntstam = os.stat(img_path).st_mtime
|
||||
#si el bufer fue modificado, lo carga en la pantalla led
|
||||
if ntstam > tstam:
|
||||
image=Image.open(img_path)
|
||||
matrix.SetImage(image.convert('RGB'))
|
||||
tstam = ntstam
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
[Unit]
|
||||
Description=LED Rendering Service
|
||||
After=local-fs.target
|
||||
|
||||
[Service]
|
||||
User=root
|
||||
CPUAffinity=3
|
||||
Nice=-20
|
||||
WorkingDirectory=/srv
|
||||
ExecStart=/usr/bin/python3 /srv/subsystem/led-driver.py
|
||||
Restart=always
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
Loading…
Reference in New Issue