circuitpython-sevenseg 1.0.0__py3-none-any.whl

circuitpython_sevenseg/__init__.py

@@ -0,0 +1,8 @@
+# SPDX-FileCopyrightText: 2026 Kritish Mohapatra
+# SPDX-License-Identifier: MIT
+
+from .sevenseg import SevenSeg, _DIGITS
+
+__version__ = "1.0.0"
+__author__ = "Kritish Mohapatra"
+__license__ = "MIT"

circuitpython_sevenseg/sevenseg.py

@@ -0,0 +1,117 @@
+# SPDX-FileCopyrightText: 2026 Kritish Mohapatra
+# SPDX-License-Identifier: MIT
+
+"""CircuitPython library for controlling single-digit 7-segment displays."""
+
+import digitalio
+_DIGITS = {
+    0:   (1, 1, 1, 1, 1, 1, 0),
+    1:   (0, 1, 1, 0, 0, 0, 0),
+    2:   (1, 1, 0, 1, 1, 0, 1),
+    3:   (1, 1, 1, 1, 0, 0, 1),
+    4:   (0, 1, 1, 0, 0, 1, 1),
+    5:   (1, 0, 1, 1, 0, 1, 1),
+    6:   (1, 0, 1, 1, 1, 1, 1),
+    7:   (1, 1, 1, 0, 0, 0, 0),
+    8:   (1, 1, 1, 1, 1, 1, 1),
+    9:   (1, 1, 1, 1, 0, 1, 1),
+    'A': (1, 1, 1, 0, 1, 1, 1),
+    'B': (0, 0, 1, 1, 1, 1, 1),
+    'C': (1, 0, 0, 1, 1, 1, 0),
+    'D': (0, 1, 1, 1, 1, 0, 1),
+    'E': (1, 0, 0, 1, 1, 1, 1),
+    'F': (1, 0, 0, 0, 1, 1, 1),
+    'G': (1, 0, 1, 1, 1, 1, 1),
+    'H': (0, 1, 1, 0, 1, 1, 1),
+    'I': (0, 0, 0, 0, 1, 1, 0),
+    'J': (0, 1, 1, 1, 1, 0, 0),
+    'L': (0, 0, 0, 1, 1, 1, 0),
+    'N': (1, 1, 1, 0, 1, 1, 0),
+    'O': (1, 1, 1, 1, 1, 1, 0),
+    'P': (1, 1, 0, 0, 1, 1, 1),
+    'Q': (1, 1, 1, 0, 0, 1, 1),
+    'R': (1, 0, 0, 0, 1, 1, 0),
+    'S': (1, 0, 1, 1, 0, 1, 1),
+    'T': (0, 0, 0, 1, 1, 1, 1),
+    'U': (0, 1, 1, 1, 1, 1, 0),
+    'Y': (0, 1, 1, 1, 0, 1, 1),
+    'Z': (1, 1, 0, 1, 1, 0, 1),
+    'a': (1, 1, 1, 1, 1, 0, 1),
+    'b': (0, 0, 1, 1, 1, 1, 1),
+    'c': (0, 0, 0, 1, 1, 0, 1),
+    'd': (0, 1, 1, 1, 1, 0, 1),
+    'e': (1, 1, 0, 1, 1, 1, 1),
+    'f': (1, 0, 0, 0, 1, 1, 1),
+    'g': (1, 1, 1, 1, 0, 1, 1),
+    'h': (0, 0, 1, 0, 1, 1, 1),
+    'i': (0, 0, 1, 0, 0, 0, 0),
+    'j': (0, 1, 1, 1, 0, 0, 0),
+    'l': (0, 0, 0, 1, 1, 1, 0),
+    'n': (0, 0, 1, 0, 1, 0, 1),
+    'o': (0, 0, 1, 1, 1, 0, 1),
+    'p': (1, 1, 0, 0, 1, 1, 1),
+    'q': (1, 1, 1, 0, 0, 1, 1),
+    'r': (0, 0, 0, 0, 1, 0, 1),
+    's': (1, 0, 1, 1, 0, 1, 1),
+    't': (0, 0, 0, 1, 1, 1, 1),
+    'u': (0, 0, 1, 1, 1, 0, 0),
+    'y': (0, 1, 1, 1, 0, 1, 1),
+    # ── Symbols ──────────────────────────────
+    '-': (0, 0, 0, 0, 0, 0, 1),
+    '_': (0, 0, 0, 1, 0, 0, 0),
+    '.': (0, 0, 0, 0, 0, 0, 0),  # dp only — use dp=True
+    '!': (0, 1, 1, 0, 0, 0, 0),  # like 1, dp=True for !
+    '?': (1, 1, 0, 0, 1, 0, 1),
+    "'": (0, 0, 0, 0, 0, 1, 0),
+    '"': (0, 1, 0, 0, 0, 1, 0),
+    '[': (1, 0, 0, 1, 1, 1, 0),
+    ']': (1, 1, 1, 1, 0, 0, 0),
+    '=': (0, 0, 0, 1, 0, 0, 1),
+    '+': (0, 0, 1, 0, 1, 0, 1),
+    '^': (1, 1, 0, 0, 0, 1, 0),
+    ' ': (0, 0, 0, 0, 0, 0, 0),
+}
+class SevenSeg:
+    def __init__(self, pins, common_anode=False):
+        if len(pins)!=8:
+            raise ValueError("Exactly 8 pins required: [a, b, c, d, e, f, g, dp]")
+        self.common_anode=common_anode
+        self._pins=[]
+        for pin in pins:
+            p = digitalio.DigitalInOut(pin)
+            p.direction = digitalio.Direction.OUTPUT
+            p.value = False
+            self._pins.append(p)
+        self.clear()
+    def _write(self, segments, dp=False):
+        for i, val in enumerate(segments):
+            if self.common_anode:
+                self._pins[i].value=not bool(val)
+            else:
+                self._pins[i].value=bool(val)
+        if self.common_anode:
+            self._pins[7].value=not bool(dp)
+        else:
+            self._pins[7].value=bool(dp)
+    def show(self, char, dp=False):
+        if isinstance(char, str) and len(char)==1 and char.isdigit():
+            char=int(char)
+        if char not in _DIGITS:
+            raise  ValueError(f"Unsupported character: {char!r}")
+        segments=_DIGITS[char]
+        self._write(segments, dp)
+    def clear(self):
+        off=1 if self.common_anode else 0
+        for p in self._pins:
+            p.value=bool(off)
+    def dot(self, on=True):
+        if self.common_anode:
+            self._pins[7].value=not bool(on)
+        else:
+            self._pins[7].value=bool(on)
+    def deinit(self):
+        self.clear()
+        for pin in self._pins:
+            pin.deinit()
+
+                                                                                                                                                   

circuitpython_sevenseg-1.0.0.dist-info/METADATA

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: circuitpython-sevenseg
+Version: 1.0.0
+Summary: A lightweight CircuitPython library for controlling single-digit 7-segment displays
+Author-email: Kritish Mohapatra <kritishmohapatra06norisk@gmail.com>
+Project-URL: Homepage, https://github.com/kritishmohapatra/circuitpython-sevenseg
+Keywords: circuitpython,seven-segment,7-segment,display,iot,embedded,pico,esp32
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Hardware
+Requires-Python: >=3.0
+Description-Content-Type: text/markdown
+
+# circuitpython-sevenseg
+
+A lightweight CircuitPython library for controlling single digit 7 segment displays (common cathode or common anode).
+
+Supports **digits, uppercase & lowercase letters, and symbols**  works on Raspberry Pi Pico, Adafruit Feather, Seeed XIAO ESP32-S3, and any CircuitPython-supported board.
+
+> CircuitPython port of [micropython-sevenseg](https://github.com/kritishmohapatra/micropython-sevenseg)
+
+---
+
+## Installation
+
+Copy the `circuitpython_sevenseg/` folder to the `lib/` directory on your `CIRCUITPY` drive:
+
+```
+CIRCUITPY/
+└── lib/
+    └── circuitpython_sevenseg/
+        ├── __init__.py
+        └── sevenseg.py
+```
+
+---
+
+## Pin Diagram
+
+```
+ ---a---
+|       |
+f       b
+|       |
+ ---g---
+|       |
+e       c
+|       |
+ ---d---   ● dp
+
+Pin order: [a, b, c, d, e, f, g, dp]
+```
+
+---
+
+## Quick Start
+
+```python
+import board
+import time
+from circuitpython_sevenseg import SevenSeg
+
+seg = SevenSeg(
+    pins=[board.GP2, board.GP3, board.GP4, board.GP5,
+          board.GP6, board.GP7, board.GP8, board.GP9],
+    common_anode=False
+)
+
+# Show a digit
+seg.show(5)
+
+# Show a letter
+seg.show('A')
+
+# Show with decimal point
+seg.show(3, dp=True)
+
+# Turn on decimal point only
+seg.dot(True)
+
+# Clear display
+seg.clear()
+
+# Release pins
+seg.deinit()
+```
+
+---
+
+## API Reference
+
+### `SevenSeg(pins, common_anode=False)`
+
+Initializes the display.
+
+| Parameter | Type | Description |
+|---|---|---|
+| `pins` | list | 8 pin objects in order `[a, b, c, d, e, f, g, dp]` |
+| `common_anode` | bool | `True` for common anode, `False` for common cathode (default) |
+
+---
+
+### `show(char, dp=False)`
+
+Displays a character on the 7-segment display.
+
+| Parameter | Type | Description |
+|---|---|---|
+| `char` | int or str | Digit `0–9` or supported character (see table below) |
+| `dp` | bool | Also turn on decimal point (default `False`) |
+
+Raises `ValueError` if character is not supported.
+
+---
+
+### `clear()`
+
+Turns off all segments including the decimal point.
+
+---
+
+### `dot(on=True)`
+
+Toggles the decimal point without affecting other segments.
+
+| Parameter | Type | Description |
+|---|---|---|
+| `on` | bool | `True` = on, `False` = off (default `True`) |
+
+---
+
+### `deinit()`
+
+Releases all GPIO pins. Call when done to free resources.
+
+---
+
+## Supported Characters
+
+### Digits
+`0 1 2 3 4 5 6 7 8 9`
+
+### Uppercase Letters
+`A B C D E F G H I J L N O P Q R S T U Y Z`
+
+> K, M, V, W, X not supported — physically impossible on 7-segment display.
+
+### Lowercase Letters
+`a b c d e f g h i j l n o p q r s t u y`
+
+### Symbols
+`- _ . ! ? ' " [ ] = + ^ (space)`
+
+---
+
+## Wiring Example — Raspberry Pi Pico / Pico 2W
+
+| Segment | Pico Pin |
+|---------|----------|
+| a | GP2 |
+| b | GP3 |
+| c | GP4 |
+| d | GP5 |
+| e | GP6 |
+| f | GP7 |
+| g | GP8 |
+| dp | GP9 |
+
+---
+
+## Examples
+
+| File | Description |
+|------|-------------|
+| `sevenseg_simpletest.py` | Basic 0–9 counter |
+| `sevenseg_all_chars.py` | All supported characters |
+
+
+---
+
+## License
+
+MIT License © 2026 Kritish Mohapatra
+
+---
+
+## Author
+
+**Kritish Mohapatra**
+- GitHub: [@kritishmohapatra](https://github.com/kritishmohapatra)
+- MicroPython version: [micropython-sevenseg](https://github.com/kritishmohapatra/micropython-sevenseg)

circuitpython_sevenseg-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+circuitpython_sevenseg/__init__.py,sha256=7twH2fxqbt8p9JYrYzzT9Dk9fqs64jVf7uuqOjUjyhU,203
+circuitpython_sevenseg/sevenseg.py,sha256=7rYvwCQ3wn3FrcSdVSxeomm80JsyHQJcTUn4QGTlYWc,4143
+circuitpython_sevenseg-1.0.0.dist-info/METADATA,sha256=o46Fm_y__ZJDzvPRCZomzrtxadCjU71HwYzHSKHwDyk,4126
+circuitpython_sevenseg-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+circuitpython_sevenseg-1.0.0.dist-info/top_level.txt,sha256=YdPpWOGpYlyzu3SF2b03nG_1OvAqQyWl9puCcRASfEI,23
+circuitpython_sevenseg-1.0.0.dist-info/RECORD,,

circuitpython_sevenseg-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

circuitpython_sevenseg-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+circuitpython_sevenseg