https://github.com/supakeen/hexline

Firmware and case for a segment display.
https://github.com/supakeen/hexline

Last synced: about 1 month ago
JSON representation

Firmware and case for a segment display.

• Host: GitHub
• URL: https://github.com/supakeen/hexline
• Owner: supakeen
• License: mit
• Created: 2024-12-22T20:34:41.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-25T11:48:29.000Z (about 1 month ago)
• Last Synced: 2024-12-25T12:27:31.828Z (about 1 month ago)
• Language: C
• Homepage:
• Size: 12.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# hexline

A marquee of 32 16-segment characters.

> [!NOTE]  

> This project is a remix of the [hexboard](https://github.com/brainsmoke/hexboard) project by [brainsmoke](https://github.com/brainsmoke). Take a look to see what the project was originally designed to do, it's awesome.

![](image.jpg)

# Usage

> [!WARNING]  

> This firmware works (on `main`) but is in flux. I still want to add various other features and such.

Build and flash the firmware onto a Pi Pico. Connect the UART from the PCB to pin 4 on your Pi Pico. Make sure to tie SWDIO from the PCB to ground. When you plug in the Pi Pico to USB a new `/dev/ttyACMx` will appear. You can connect to it with your favorite serial emulator at 115200 baud; for example `screen /dev/ttyACM0 115200`.

You can then type and letters will appear. `\r` clears the screen.

# Components

## PCB

You can find the PCB for this at the [original project](https://github.com/brainsmoke/hexboard) in the `pcb/` subdirectory. The PCB contains an STM32 microcontroller that translates data that it receives over UART to the correct driving protocols for each of the segments.

## Firmware

The `hexline-ascii` firmware provides a Serial-over-USB interface that consumes ascii text. The firmware takes care of rendering to the segments for you.

You can run the firmware on a [Raspberry Pi Pico](...) with GPIO 4 connected to the UART on the PCB. If you want to fiddle with the firmware you can open their containing directories with the [Pico SDK](https://github.com/raspberrypi/pico-sdk) somewhere in your environment.

## Housing

You can find STLs in the [./hardware/housing](./hardware/housing) directory. These can be printed at home. You have to print one of each with the except ion of `left.stl` and `right.stl` which both have to be printed twice.

The alignment pins fit loosely on purpose; you can wrap them with some paper to make them tight fitting. When fitting the midsection you need to pull it apart a bit to slide it over the bottom header on the PCB, be careful not to bend any pins.

The right endcap contains room for a USB-C breakout board which you can then solder onto your preferred USB connection internally.