co2monitor 0.2.1

See the current co2 emissions per kWh of electricity in the Netherlands

Table of Contents

1. CO2 monitor
2. Install
   1. Development
3. Pins
   1. Screen

CO2 monitor

This project is more or less like co2monitor.nl, except that we show the current CO2 emisions per kWh of electricity on a small EPD screen, connected to some GPIO pins of a Raspberry Pi.

See Pins for an overview of what pins need to be connected to the screen.

Install

1. Attach your EPD screen to the pins as described in the table in Screen.
2. Install the python executable: uv sync, or pip install -e .
3. Copy .env.example to .env and populate with the correct api key. You can find an api key on https://ned.nl/nl/user
4. Run the executable (found in the virtualenv/bin directory).

Development

See the Makefile for handy dev commands. I use uv to manage my dependencies, but it does not really matter all that much.

You can execute python monitor (or uv run python monitor) to quickly run the project.

Pins

https://pinout.xyz/

Screen

Product

Name	Function	Color	Pin number	GPIO
VCC	Power	Grey	1	-
GND	Ground	Brown	6	-
DIN	SPI MOSI	Blue	19	10 (SPI0 MOSI)
CLK	SPI Clock	Yellow	23	11 (SPI0 SCLK)
CS	SPI chip selection	Orange	24	8 (SPI0 CE0)
DC	Data/Command selection	Green	22	25
RST	Reset	White	11	17
BUSY	Busy status output	Purple	18	24