# Motion Controlled Matrix Bed Clock
## Overview
## A multi-function display by your bedside!
The 64x64 LED Matrix is a great platform to display anything you care about. Like the time and what day it is. :) With the motion and light sensor, the display can be made to dim or blank out so it will not disturb you while sleeping. A simple wave motion in the dark room is enough to re-enable the display for a short period.
The 3D printed harness [file](https://www.thingiverse.com/thing:3140714/files "STL files") is available with this project, so you can adapt it to suit your bed or desk space needs. In the current form, two printed parts are glued together with regular table pin connectors. You will also need four M3x5mm flat head screws in order to connect the matrix display to the printed frame.
The code is written in Python and has lots of potential for easy improvements. The current implementation gives you the ability to connect to an [MQTT](https://learn.adafruit.com/mqtt-adafruit-io-and-you) broker for subscribing and publishing events in a canonical [IOT](https://learn.adafruit.com/welcome-to-adafruit-io "Adafruit IO") setup. But you need not to worry about that if a clock is all you care about. Underneath the Python code, this project uses the display driver written by [Henner Zeller](https://github.com/hzeller/rpi-rgb-led-matrix "Controlling RGB LED display with Raspberry Pi GPIO"), which makes the display fast and stable when used together with the Adafruit parts.
## Prerequisite Guides
I suggest walking through the following guides to get a better understanding of the electronics.
- [Adafruit APDS9960 breakout Digital Proximity, Ambient Light](https://learn.adafruit.com/adafruit-apds9960-breakout/overview)
- [RGB Matrix Bonnet for Raspberry Pi](https://learn.adafruit.com/adafruit-rgb-matrix-bonnet-for-raspberry-pi)
## Parts
### Raspberry Pi Zero WH (Zero W with Headers)
[Raspberry Pi Zero WH (Zero W with Headers)](https://www.adafruit.com/product/3708)
If you didn't think that the Raspberry Pi Zero W could possibly get any better, then boy do we have a pleasant surprise for you! The new **Raspberry Pi Zero WH ** offers all the benefits of the Pi Zero W, but with one big difference – a **pre-soldered GPIO...**
Out of Stock
[Buy Now](https://www.adafruit.com/product/3708)
[Related Guides to the Product](https://learn.adafruit.com/products/3708/guides)
### Adafruit RGB Matrix Bonnet for Raspberry Pi
[Adafruit RGB Matrix Bonnet for Raspberry Pi](https://www.adafruit.com/product/3211)
You can now create a dazzling display with your Raspberry Pi with the Adafruit RGB Matrix Bonnet. These boards plug into your Pi and make it super easy to control RGB matrices such as those we stock in the shop and create a colorful scrolling...
Out of Stock
[Buy Now](https://www.adafruit.com/product/3211)
[Related Guides to the Product](https://learn.adafruit.com/products/3211/guides)
### 64x64 RGB LED Matrix - 2.5mm Pitch
[64x64 RGB LED Matrix - 2.5mm Pitch](https://www.adafruit.com/product/3649)
Winter time can be rough in the city. The sky is gray. The weather is unpredictable. So slough off those seasonal blues with some Times Square razzle dazzle from this sweet, ultra-high-density **64x64 RGB LED Matrix**. These panels are typically used to make video...
In Stock
[Buy Now](https://www.adafruit.com/product/3649)
[Related Guides to the Product](https://learn.adafruit.com/products/3649/guides)
### Adafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor
[Adafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor](https://www.adafruit.com/product/3595)
This breakout is chock full o' sensors! Add basic gesture sensing, RGB color sensing, proximity sensing, or ambient light sensing to your project with the **Adafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor**. When connected to your microcontroller (running our...
In Stock
[Buy Now](https://www.adafruit.com/product/3595)
[Related Guides to the Product](https://learn.adafruit.com/products/3595/guides)
### 5V 10A switching power supply
[5V 10A switching power supply](https://www.adafruit.com/product/658)
This is a beefy switching supply, for when you need a lot of power! It can supply 5V DC up to 10 Amps, running from 110V or 220V power (the plug it comes with is for US/Canada/Japan but you can use any plug adapter for your country, or just replace the cable with a standard computer/appliance...
In Stock
[Buy Now](https://www.adafruit.com/product/658)
[Related Guides to the Product](https://learn.adafruit.com/products/658/guides)
### SD/MicroSD Memory Card (8 GB SDHC)
[SD/MicroSD Memory Card (8 GB SDHC)](https://www.adafruit.com/product/1294)
Add mega-storage in a jiffy using this 8 GB class 4 micro-SD card. It comes with a SD adapter so you can use it with any of our shields or adapters. Preformatted to FAT so it works out of the box with our projects. Tested and works great with our
Out of Stock
[Buy Now](https://www.adafruit.com/product/1294)
[Related Guides to the Product](https://learn.adafruit.com/products/1294/guides)
### USB to TTL Serial Cable - Debug / Console Cable for Raspberry Pi
[USB to TTL Serial Cable - Debug / Console Cable for Raspberry Pi](https://www.adafruit.com/product/954)
The cable is easiest way ever to connect to your microcontroller/Raspberry Pi/WiFi router serial console port. Inside the big USB plug is a USB\<-\>Serial conversion chip and at the end of the 36" cable are four wire - red power, black ground, white RX into USB port, and green TX out...
In Stock
[Buy Now](https://www.adafruit.com/product/954)
[Related Guides to the Product](https://learn.adafruit.com/products/954/guides)
# Motion Controlled Matrix Bed Clock
## Circuit Diagram
Take a moment to review the components in the circuit diagram. This illustration is meant for referencing wired connections - the length of wire, position and size of components are not exact.
Note that in order to drive the 64x64 dot matrix display, you must connect **GPIO pins 4 and 18**.
**RGB Matrix Bonnet** connects to the **Raspberry Pi Zero**.
The 2.1mm Male DC adapter and will need to be 150mm long.
While it is okay to use a single power supply to feed both RPI and matrix display, it is important that the throughput is powerful enough.
[5v 10A switching power supply](https://www.adafruit.com/product/658 "5V 10A Switching Power Supply") is plenty for this project.
Featured
### 5V 10A switching power supply
[5V 10A switching power supply](https://www.adafruit.com/product/658)
This is a beefy switching supply, for when you need a lot of power! It can supply 5V DC up to 10 Amps, running from 110V or 220V power (the plug it comes with is for US/Canada/Japan but you can use any plug adapter for your country, or just replace the cable with a standard computer/appliance...
In Stock
[Buy Now](https://www.adafruit.com/product/658)
[Related Guides to the Product](https://learn.adafruit.com/products/658/guides)
# Motion Controlled Matrix Bed Clock
## 3D Printing
The [OnShape online tool](https://cad.onshape.com/documents/28baa48f25d4dc6e6211634d/v/d9f02a67fde16e56652c7566/e/8044c64ece9d04910adc8c90 "Bedclock 2 parts") was used in order to design the structure used for the bedclock. It exports [STL files](https://www.thingiverse.com/thing:3140714/files "Bedclock STL files") that you can use for 3D printing.
**Note:** A huge thanks for making this part of the project possible goes to [Brian Bailey](https://github.com/bunedoggle "CAD Guru"), my friendly CAD guru.
By printing this project in multiple parts, there is no need for printing support fillers. Since the parts have nice cavities for the table pins, you will have no problems aligning and binding them together.
There is a third and smaller part for covering the RPI on the back side of the frame. You can see and print that from [thingiverse.com](https://www.thingiverse.com/thing:3140714 "STLs for bedclock").
We used regular PLA (Polylactic Acid) filament, which is widely common.
Once printed, have these parts connected using table pins as shown here.
More details will be provided on the assembly section, but here is a picture showing how the 3 main parts go together:
- Top bezel
- Front bezel
- Matrix display
# Motion Controlled Matrix Bed Clock
## Coding
First, make sure you've loaded the latest Raspbian Lite operating system on your Raspberry Pi. You can find the [OS image download here](http://www.raspberrypi.org/downloads/), instructions for [burning to an SD card image here](http://www.raspberrypi.org/documentation/installation/installing-images/README.md), and a [convenient guide here](../../../../adafruit-raspberry-pi-lesson-1-preparing-and-sd-card-for-your-raspberry-pi/overview) that explains how to load an operating system.
Next, have your Raspberry Pi connected to the Internet, either with a wired connection to its ethernet port, or by setting up wireless access to a WiFi network. Check out the [guide on network setup](../../../../adafruits-raspberry-pi-lesson-3-network-setup/overview) for more details on using wireless and WiFi networks with the Pi.
Once your Raspberry Pi is powered up and connected to a network you can follow the steps below to install the bedclock software.
If you're familiar with connecting to the [Raspberry Pi over SSH](../../../../adafruits-raspberry-pi-lesson-6-using-ssh/overview) you can use an SSH terminal application to connect. If you aren't familiar with SSH, you can use the [Adafruit Pi Finder tool](https://github.com/adafruit/Adafruit-Pi-Finder) to find your Raspberry Pi and open a terminal to run the installation. In either way, you should be able to be logged into the RPI as user pi.
[Bedclock Code](https://github.com/flavio-fernandes/bedclock/tree/adafruit#bedclock)
Warning:
## Customization Options
As part of the Raspbian installation, visit the various options available and see if any of them needs tweaking. Setting the timezone is a good candidate. :)
## Enable I2C via raspi-config
In order to read the gesture sensor, I2C must be enabled via the **raspi-config** interface. Follow the guide below for a step by step guide. If your familiar with this, use **sudo raspi-config** and enable I2C through the “Interfacing Options.”
```auto
sudo raspi-config
```
- **Localization Options -\> change timezone**
- **Interfacing Options -\> enable ssh**
- **Interfacing Options -\> enable I2C**
[Raspberry Pi – Enable I2C Guide](https://learn.adafruit.com/adafruits-raspberry-pi-lesson-4-gpio-setup/configuring-i2c)
```auto
sudo apt-get install -y git i2c-tools \
python3-dev python3-pillow python3-setuptools cython3
# Ensure i2c device is present
ls /dev/i2c* && echo ok || echo bad error cannot see i2c
```
## Install Matrix Driver
OK, now you are ready to install the driver for the LED matrix. We have a script that downloads the code and any prerequisite software. It works with the current **Raspbian “Stretch” operating system** (either the Lite or Desktop version). Walk through the options it presents and select the ones that pertain to your setup. If you get stuck, we have a more details in the [Bonnet Matrix guide](../../../../adafruit-rgb-matrix-bonnet-for-raspberry-pi?view=all#driving-matrices).
```auto
curl https://raw.githubusercontent.com/adafruit/Raspberry-Pi-Installer-Scripts/master/rgb-matrix.sh >rgb-matrix.sh
sudo bash rgb-matrix.sh
```
The script will **confirm your selections** and offer **one more chance to cancel** without changes.
There’s a lot of software to update, download and install, so it may take up to **15 minutes** or so to complete. Afterward, you’ll be asked whether you want to **reboot** the system.
## Testing the Matrix Code
After the reboot, it's time to try the display! Run the following command and make sure it is working properly. By the way, it is okay to do this after the whole assembly; just come back here once the display is properly powered and connected.
```auto
cd ~/rpi-rgb-led-matrix/examples-api-use
ROTATE=180
TIMEOUT='10s'
PARAMS='--led-rows=64 --led-cols=64 --led-brightness=88'
PARAMS+=' --led-gpio-mapping=adafruit-hat'
for X in 0 {3..11} ; do \
sudo timeout ${TIMEOUT} \
./demo ${PARAMS} --led-pixel-mapper="Rotate:${ROTATE}" -D${X}
sleep 0.3
done
```
Press Control+C to stop the program and get back to the command line.
## Create a .pth file so Python always includes a path to rgbmatrix
The python bindings for rgbmatrix are needed, so the bedclock software can control the matrix display.
```auto
SITE_DIR="$(sudo python3 -c 'import site; print(site.getsitepackages()[0])')"
[ -n "$SITE_DIR" ] && \
echo "/home/pi/rpi-rgb-led-matrix/bindings/python" | \
sudo tee "${SITE_DIR}/rgbmatrix.pth" >/dev/null
sudo python3 -c 'import rgbmatrix; print("ok:", rgbmatrix)' || echo FAILED
```
## Install Git, Pip and Clone
Let's get the **git** command so we can clone the bedclock software repository. We will also need some Python packages, which we can easily obtain by using the **pip** command
```auto
sudo apt-get install -y python3-pip git
BRANCH=adafruit
cd && \
git clone -b ${BRANCH} \
https://github.com/flavio-fernandes/bedclock.git bedclock.git
cd ~/bedclock.git && sudo -H pip3 install --break-system-packages --upgrade -r ./requirements.txt
```
## Automatic Startup
We will use [systemd](https://www.raspberrypi.org/documentation/linux/usage/systemd.md) to start the program automatically. This is just a copy command away from the cloned repo.
```auto
# add bedclock service to systemd
sudo cp -v ~/bedclock.git/bedclock/bin/bedclock.service \
/lib/systemd/system/
sudo systemctl enable bedclock.service
# start the application
sudo systemctl start bedclock.service
```
You can monitor what is happening with the app by looking at the log or _systemd status_:
```auto
sudo systemctl status bedclock.service
sudo journalctl -u bedclock.service --follow
```
## Customize tweaks
There are lots of knobs that can be tweaked to make the clock behave as you want. Most of these settings are located in the file called **[const.py](https://github.com/flavio-fernandes/bedclock/blob/adafruit/bedclock/const.py)**. After making the changes, make sure to restart the application by typing the following command
```auto
sudo systemctl restart bedclock.service
```
If you want to start it manually, use **[start\_bedclock.sh](https://github.com/flavio-fernandes/bedclock/blob/adafruit/bedclock/bin/start_bedclock.sh)**
```auto
sudo systemctl stop bedclock.service
~/bedclock.git/bedclock/bin/start_bedclock.sh
```
Just like the time you ran the matrix demo, press the Control-C keys to stop the program and get back to the command line.
## MQTT
If you have an [MQTT](https://learn.adafruit.com/adafruit-io/mqtt-api) broker that your bedclock can talk to, you can enable it via the `mqtt_enabled` setting in the **[const.py](https://github.com/flavio-fernandes/bedclock/blob/adafruit/bedclock/const.py)** file.
That file will be located under the following directory:
> # Edit file and modify the following parmameters:
> # mqtt\_broker\_ip =
> # mqtt\_enabled = True
> /bin/nano ~/bedclock.git/bedclock/const.py
#### Receiving events published by the bedclock application
```auto
# Install mqtt client to poke bedclock via mqtt broker
$ sudo apt-get install -y mosquitto-clients
$ mosquitto_sub -v -h ${MQTT_BROKER} -t "/bedclock/motion" -t "/bedclock/light"
/bedclock/motion on
/bedclock/motion off
/bedclock/light 365
```
#### Configuring the clock to stay awake in the dark
If you don't want the clock to go blank when the room is dark, you can change its default behavior in **[const.py](https://github.com/flavio-fernandes/bedclock/blob/adafruit/bedclock/const.py)** by setting `scr_stayOnInDarkRoomDefault = True`. Or via MQTT, as shown below:
```auto
$ mosquitto_pub -h ${MQTT_BROKER} -t /bedclock/stay -r -m "on"
$ mosquitto_pub -h ${MQTT_BROKER} -t /bedclock/stay -r -m "off"
# to clear topic from broker and use const.scr_stayOnInDarkRoomDefault
$ mosquitto_pub -h ${MQTT_BROKER} -t /bedclock/stay -r -n
```
## Remove/disable unnecessary services
RPI Zero W handles the display just fine but it does not hurt to help it out by disabling unused things that compete for cycles. These were the ones I did on my setup, based on [Henner](https://github.com/hzeller/rpi-rgb-led-matrix/tree/814b79b5696d32dd1140304b41a1ec0068bb271a#use-minimal-raspbian-distribution "Disabling non-needed services")'s advice:
```auto
sudo systemctl disable avahi-daemon && \
sudo systemctl stop avahi-daemon && \
sudo apt-get remove -y bluez bluez-firmware pi-bluetooth triggerhappy && \
echo ok
```
## Safely Shutdown setup
Abruptly cutting power to the Pi can cause the files in the SD card to become corrupt. So, we suggest safely shutting down the Pi. There is [a dedicated guide](https://learn.adafruit.com/read-only-raspberry-pi) for enabling **Read-Only** mode, which will allow you to quickly turn off the Pi without risking corrupting the SD card.
[Read-Only Pi Guide](https://learn.adafruit.com/read-only-raspberry-pi)
# Motion Controlled Matrix Bed Clock
## Assembly
## Prep Bonnet
First, we'll need to add a jumper to connect two pins and then bridge two pads to enable the RGB Matrix Bonnet to work with the 64x64 LED Matrix.
## Jumper
We'll start by measuring a wire 30mm long. Tin and solder pin 4 to pin 18. Carefully bend the wire and move it away from the headers on the Bonnet.
## Bridge Pad
Next, we need to turn the Matrix Bonnet over and locate the three solder pads. Tin the middle pad " **E**" and the " **8**" pad. Now heat up one of the pads and drag solder over to the next pad to bridge the two connections.
## Attach LED Matrix to Frame
Once 3D frame is printed and glued, use flat screws to connect the display. It is important to keep these flat, to it sits seamlessly over the headboard surface.
The ribbon cable goes next and in order to make the surface flat, I went ahead and removed the back side of the plastic shield that attaches the end cable to the display.
Carefully solder 5V and GND to display, so it is... you get the idea... FLAT!
## Glue on!
With glue gun hot and ready, I bonded the RPI and ribbon cable to the back side of the frame. There are plenty of holes in the back plane, so you can attach the RPI to the frame.
The cover provided as the 3rd STL file will fit nicely over the RPI, so this part is not exposed.
## Solder APDS9960
The Proximity, Light, RGB, and Gesture Sensor is soldered to the Bonnet. Measure four wires long enough to connect **5v** , **GND** , **SDA** , and **SLC ** on the **Bonnet** and **APDS9960**.
## Hang overboard
And that is it, folks! For more pictures on this assembly, take a look at [this link](https://www.flickr.com/gp/38447095@N00/705C56 "Bedclock Flickr Pics").
You might consider a stand instead for nightstand use.
Check out [this video](https://www.youtube.com/watch?v=kgT8Nts2mAI "Bedclock Demo") to see the bedclock in action
https://www.youtube.com/watch?v=kgT8Nts2mAI
## Guide Products
### Raspberry Pi Zero WH (Zero W with Headers)
[Raspberry Pi Zero WH (Zero W with Headers)](https://www.adafruit.com/product/3708)
If you didn't think that the Raspberry Pi Zero W could possibly get any better, then boy do we have a pleasant surprise for you! The new **Raspberry Pi Zero WH ** offers all the benefits of the Pi Zero W, but with one big difference – a **pre-soldered GPIO...**
Out of Stock
[Buy Now](https://www.adafruit.com/product/3708)
[Related Guides to the Product](https://learn.adafruit.com/products/3708/guides)
### Adafruit RGB Matrix Bonnet for Raspberry Pi
[Adafruit RGB Matrix Bonnet for Raspberry Pi](https://www.adafruit.com/product/3211)
You can now create a dazzling display with your Raspberry Pi with the Adafruit RGB Matrix Bonnet. These boards plug into your Pi and make it super easy to control RGB matrices such as those we stock in the shop and create a colorful scrolling...
Out of Stock
[Buy Now](https://www.adafruit.com/product/3211)
[Related Guides to the Product](https://learn.adafruit.com/products/3211/guides)
### 64x64 RGB LED Matrix - 2.5mm Pitch
[64x64 RGB LED Matrix - 2.5mm Pitch](https://www.adafruit.com/product/3649)
Winter time can be rough in the city. The sky is gray. The weather is unpredictable. So slough off those seasonal blues with some Times Square razzle dazzle from this sweet, ultra-high-density **64x64 RGB LED Matrix**. These panels are typically used to make video...
In Stock
[Buy Now](https://www.adafruit.com/product/3649)
[Related Guides to the Product](https://learn.adafruit.com/products/3649/guides)
### Adafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor
[Adafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor](https://www.adafruit.com/product/3595)
This breakout is chock full o' sensors! Add basic gesture sensing, RGB color sensing, proximity sensing, or ambient light sensing to your project with the **Adafruit APDS9960 Proximity, Light, RGB, and Gesture Sensor**. When connected to your microcontroller (running our...
In Stock
[Buy Now](https://www.adafruit.com/product/3595)
[Related Guides to the Product](https://learn.adafruit.com/products/3595/guides)
### 5V 10A switching power supply
[5V 10A switching power supply](https://www.adafruit.com/product/658)
This is a beefy switching supply, for when you need a lot of power! It can supply 5V DC up to 10 Amps, running from 110V or 220V power (the plug it comes with is for US/Canada/Japan but you can use any plug adapter for your country, or just replace the cable with a standard computer/appliance...
In Stock
[Buy Now](https://www.adafruit.com/product/658)
[Related Guides to the Product](https://learn.adafruit.com/products/658/guides)
### SD/MicroSD Memory Card (8 GB SDHC)
[SD/MicroSD Memory Card (8 GB SDHC)](https://www.adafruit.com/product/1294)
Add mega-storage in a jiffy using this 8 GB class 4 micro-SD card. It comes with a SD adapter so you can use it with any of our shields or adapters. Preformatted to FAT so it works out of the box with our projects. Tested and works great with our
Out of Stock
[Buy Now](https://www.adafruit.com/product/1294)
[Related Guides to the Product](https://learn.adafruit.com/products/1294/guides)
### USB to TTL Serial Cable - Debug / Console Cable for Raspberry Pi
[USB to TTL Serial Cable - Debug / Console Cable for Raspberry Pi](https://www.adafruit.com/product/954)
The cable is easiest way ever to connect to your microcontroller/Raspberry Pi/WiFi router serial console port. Inside the big USB plug is a USB\<-\>Serial conversion chip and at the end of the 36" cable are four wire - red power, black ground, white RX into USB port, and green TX out...
In Stock
[Buy Now](https://www.adafruit.com/product/954)
[Related Guides to the Product](https://learn.adafruit.com/products/954/guides)
## Related Guides
- [Turning your Raspberry Pi Zero into a USB Gadget](https://learn.adafruit.com/turning-your-raspberry-pi-zero-into-a-usb-gadget.md)
- [Adafruit Metro ESP32-S3](https://learn.adafruit.com/adafruit-metro-esp32-s3.md)
- [All About Raspberry Pi HQ Camera Lenses](https://learn.adafruit.com/raspberry-pi-hq-camera-lenses.md)
- [RP2040 RunCPM Emulator with USB Keyboard & HDMI screen](https://learn.adafruit.com/rp2040-runcpm-emulator-with-usb-keyboard-hdmi-screen.md)
- [Adafruit MicroSD SPI or SDIO Card Breakout Board](https://learn.adafruit.com/adafruit-microsd-spi-sdio.md)
- [CircuitPython Libraries on Linux and the NVIDIA Jetson Nano](https://learn.adafruit.com/circuitpython-libraries-on-linux-and-the-nvidia-jetson-nano.md)
- [Adafruit BrainCraft HAT - Easy Machine Learning for Raspberry Pi](https://learn.adafruit.com/adafruit-braincraft-hat-easy-machine-learning-for-raspberry-pi.md)
- [Dotstar LED and Glass Pebble Floor](https://learn.adafruit.com/neopixel-and-glass-pebble-floor.md)
- [Adafruit PiCowbell Camera Breakout](https://learn.adafruit.com/adafruit-picowbell-camera-breakout.md)
- [Adafruit Metro M7 with microSD](https://learn.adafruit.com/adafruit-metro-m7-microsd.md)
- [Daily Cheer Automaton](https://learn.adafruit.com/daily-cheer-automaton.md)
- [Raspberry Pi LED Matrix Sand Toy](https://learn.adafruit.com/matrix-led-sand.md)
- [MIDI Controlled Robot Lyre with CircuitPython](https://learn.adafruit.com/midi-controlled-robot-lyre-with-circuitpython.md)
- [Use Docker to Compile Linux for ESP32-S3](https://learn.adafruit.com/docker-esp32-s3-linux.md)
- [Video Playing 2.1" Round Ornament TFT](https://learn.adafruit.com/2-1-round-ornament-tft.md)