Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/bus710/matrix2

A toy project to drive Sense Hat's matrix by using Go, Flutter/Web, and Docker
https://github.com/bus710/matrix2

Last synced: about 2 months ago
JSON representation

A toy project to drive Sense Hat's matrix by using Go, Flutter/Web, and Docker

Lists

README 

        
# matrix2 



 Awesome Flutter  

 Awesome Flutter  






A toy project to drive Sense Hat's LED matrix by using Go and Flutter 







### RPI4 warning



RPI4 and matrix hat have some issues during boot. To avoid:

- For Raspbian OS, add **hdmi_force_hotplug=1** to /boot/config.txt

- For Ubuntu, add **hdmi_force_hotplug=1** to /boot/firmware/config.txt




 



## 1. Description



This project consists of 2 parts:

- A simple mobile front-end based on Flutter/Web that can modify the matrix data for 64 LEDs on Sense Hat.

- A Golang based web server with WebSocket that accepts the configuration from the front-end and controls the LEDs via I2C.



## 2. Prerequisites



First of all, the user should be familiar with Raspberry Pi and its terminal interface.  

  

Hardware-wise, **RPI 3B+** is recommendable because it works regardless of the OS (either Raspbian or Ubuntu 18.04 32/64 bit). However, **RPI 3A+** only works when it has Raspbian 32 bit.  

  

### 2.1. I2C interface activation



Enable i2c communication by using raspi-config.



```

sudo raspi-config

```



### 2.2. Docker installation



Get Docker's prerequisites as follow.



```

sudo apt-get install \

     apt-transport-https \

     ca-certificates \

     curl \

     gnupg2 \

     software-properties-common \

     git

```



Docker itself can be installed and activated by these commands.



```

curl -sSL https://get.docker.com | sh



sudo systemctl enable docker

sudo systemctl start docker

```



### 2.3. User permission for Docker



To give the permission of the **docker** command to a user, the current username should be added to the docker group in the file.



```

sudo vi /etc/group

```



Don't forget rebooting to apply the change.



```

sudo reboot

```



## 3. How to run



Now, everything is ready to run.

Please follow the below commands and access to **localhost:3000** from a web browser.



```

git clone https://github.com/bus710/matrix2



cd matrix2/src/docker # or docker_for_arm64v8 for Ubuntu ARM64 on RPI



docker build -t matrix2 .



docker run -p 3000:3000 --device /dev/i2c-1 -it --rm --name matrix2i matrix2

```



From the browser, the frontend can be shown on the screen like this.    

(Access to the RPI's IP and port 3000 - 192.0.0.10:3000 for example).  

  




The components have features like this:

- Each box represents each LED on Sense Hat (each box can be pressed to be chosen).

- The sliders can change the color of boxes selected.

- All and None buttons can be used to pick all or none of the boxes.

- The red button can be used to send the configuration to the backend. 



## 4. Clean up



Things should work properly but before closing, the images and containers should be cleaned up with these commands:

```

docker container prune

docker image prune

```



If all the docker objects should be cleaned, below commands would be helpful (but be careful!)



```

docker rm -f $(docker ps -qa)

docker rmi $(docker images -q)

```



## 5. Conclusion



With this simple project, the LEDs on Sense Hat can be easily controlled by the front-end and there is no such procedure to install any comlex development tools. However, anyone interests to use Flutter, Golang, or the I2C of RPI may check the source code in the repository to add more feature. 



----

**Disclaimer**  

  

```

This is just a toy project that cannot be used for safety/commercial products.   

The developer doesn't take any kind of (phsical, mental, and financial) responsibility. 

```