https://github.com/defective4/rpi-display-controller

A simple segment LED display controller for Raspberry Pi
https://github.com/defective4/rpi-display-controller

display gpio led raspberry rpi segment

Last synced: 15 days ago
JSON representation

A simple segment LED display controller for Raspberry Pi

• Host: GitHub
• URL: https://github.com/defective4/rpi-display-controller
• Owner: Defective4
• License: mit
• Created: 2024-08-25T21:42:08.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2025-03-18T22:14:36.000Z (about 1 year ago)
• Last Synced: 2026-02-27T08:13:52.430Z (4 months ago)
• Topics: display, gpio, led, raspberry, rpi, segment
• Language: Java
• Homepage:
• Size: 771 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Raspberry Pi LED Display Controller

[![No Maintenance Intended](http://unmaintained.tech/badge.svg)](http://unmaintained.tech/)  

Control one LED segment display with your Raspberry Pi using any integrated circuits.  

- [Installation](#installation)

- [Usage](#usage)

- [Supported characters](#supported-characters)

# Why?

It's one of my RPi practise projects. It has very limited use, and it's better to use an integrated circuit where possible.

# How does it work?

The project's premise is simple - it allows you to display alphanumeric characters on a single segment display.  

It uses one GPIO pin per segment, requiring total of 7 free pins (command/dot are **not** supported).  

The code contains a registry of supported characters, each assigned a set of pins required to display the character.  

# Installation

## Maven

Add the following to `dependencies` section in your `pom.xml`.  

Replace `{latest version}` with the latest version shown below.

```xml

    io.github.defective4.rpi

	rpi-display-controller

	{latest version}

```

*Latest Maven version*  

![Maven Central Version](https://img.shields.io/maven-central/v/io.github.defective4.rpi/rpi-display-controller)

# Usage

Example code can be found [here](src/main/java/DisplayMain.java).  

## Mapping GPIO pins to `DisplayController`'s constructor

```java

new DisplayController(context, /** 7 GPIO pin addresses, each connected to a display segment **/);

```   

![led](img/led.png)

## Board example

![board](img/board.jpg)  

*An example board.*  

*Each segment is powered by a NPN transistor, each with its base connected to the corresponding GPIO pin.*  

*The display on the photo is an old Russian LED display with a common anode.*

# Supported characters

An always up-to-date list of supported chars can be found in [DisplayCharacter.java](src/main/java/io/github/defective4/rpi/DisplayCharacter.java).  

Supported characters include:

- All numbers from 0 to 9 inclusive

- Letters A, C, c, E, F, H, h, J, L, o, P, U, u