JoyIT-st7920 1.0.1__tar.gz

joyit_st7920-1.0.1/JoyIT_st7920.egg-info/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: JoyIT_st7920
+Version: 1.0.1
+Summary: Library to use the SBC-LCD128x64 with the Raspberry Pi
+Home-page: https://github.com/joy-it/JoyIT_st7920
+Author: Joy-IT
+Author-email: Joy-IT <service@joy-it.net>
+Project-URL: Homepage, https://github.com/joy-it/JoyIT_st7920
+Project-URL: Issues, https://github.com/joy-it/JoyIT_st7920/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gpiozero
+Requires-Dist: spidev
+Requires-Dist: Pillow
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# JoyIT_st7920
+Library to use the SBC-LCD128x64 with the Raspberry Pi
+
+## Installation
+You can install this library from PyPI.
+To install it for the current user on your Raspberry Pi, use the following command:
+```
+pip install JoyIT_st7920
+```
+
+## Example
+You need to clone this repository on your Raspberry Pi to be able to execute the example code.
+```
+git clone https://github.com/joy-it/JoyIT_st7920
+```
+Afterward, you need to move into the directory and activate the virtual environment with the following commands.
+```
+cd JoyIT_st7920
+python -m venv --system-site-packages env
+source env/bin/activate
+```
+Then you can execute the example with the following command.
+```
+cd examples
+python example.py
+```

joyit_st7920-1.0.1/JoyIT_st7920.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+JoyIT_st7920.egg-info/PKG-INFO
+JoyIT_st7920.egg-info/SOURCES.txt
+JoyIT_st7920.egg-info/dependency_links.txt
+JoyIT_st7920.egg-info/not-zip-safe
+JoyIT_st7920.egg-info/requires.txt
+JoyIT_st7920.egg-info/top_level.txt
+st7920/__init__.py
+st7920/st7920.py

joyit_st7920-1.0.1/JoyIT_st7920.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

joyit_st7920-1.0.1/JoyIT_st7920.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

joyit_st7920-1.0.1/JoyIT_st7920.egg-info/requires.txt

@@ -0,0 +1,3 @@
+gpiozero
+spidev
+Pillow

joyit_st7920-1.0.1/JoyIT_st7920.egg-info/top_level.txt

@@ -0,0 +1 @@
+st7920

joyit_st7920-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joy-IT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

joyit_st7920-1.0.1/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: JoyIT_st7920
+Version: 1.0.1
+Summary: Library to use the SBC-LCD128x64 with the Raspberry Pi
+Home-page: https://github.com/joy-it/JoyIT_st7920
+Author: Joy-IT
+Author-email: Joy-IT <service@joy-it.net>
+Project-URL: Homepage, https://github.com/joy-it/JoyIT_st7920
+Project-URL: Issues, https://github.com/joy-it/JoyIT_st7920/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gpiozero
+Requires-Dist: spidev
+Requires-Dist: Pillow
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# JoyIT_st7920
+Library to use the SBC-LCD128x64 with the Raspberry Pi
+
+## Installation
+You can install this library from PyPI.
+To install it for the current user on your Raspberry Pi, use the following command:
+```
+pip install JoyIT_st7920
+```
+
+## Example
+You need to clone this repository on your Raspberry Pi to be able to execute the example code.
+```
+git clone https://github.com/joy-it/JoyIT_st7920
+```
+Afterward, you need to move into the directory and activate the virtual environment with the following commands.
+```
+cd JoyIT_st7920
+python -m venv --system-site-packages env
+source env/bin/activate
+```
+Then you can execute the example with the following command.
+```
+cd examples
+python example.py
+```

joyit_st7920-1.0.1/README.md

@@ -0,0 +1,26 @@
+# JoyIT_st7920
+Library to use the SBC-LCD128x64 with the Raspberry Pi
+
+## Installation
+You can install this library from PyPI.
+To install it for the current user on your Raspberry Pi, use the following command:
+```
+pip install JoyIT_st7920
+```
+
+## Example
+You need to clone this repository on your Raspberry Pi to be able to execute the example code.
+```
+git clone https://github.com/joy-it/JoyIT_st7920
+```
+Afterward, you need to move into the directory and activate the virtual environment with the following commands.
+```
+cd JoyIT_st7920
+python -m venv --system-site-packages env
+source env/bin/activate
+```
+Then you can execute the example with the following command.
+```
+cd examples
+python example.py
+```

joyit_st7920-1.0.1/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "JoyIT_st7920"
+version = "1.0.1"
+dependencies = ['gpiozero', 'spidev', 'Pillow']
+authors = [
+  { name="Joy-IT", email="service@joy-it.net" },
+]
+description = "Library to use the SBC-LCD128x64 with the Raspberry Pi"
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/joy-it/JoyIT_st7920"
+Issues = "https://github.com/joy-it/JoyIT_st7920/issues"

joyit_st7920-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

joyit_st7920-1.0.1/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="JoyIT_st7920",
+    version="1.0.0",
+    description="Library to use the SBC-LCD128x64 with the Raspberry Pi",
+    author="Joy-IT",
+    author_email="service@joy-it.net",
+    packages=find_packages(),
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown',
+    url='https://github.com/joy-it/JoyIT_st7920',  
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+    ],
+    python_requires='>=3.7',
+    zip_safe=False,
+)

joyit_st7920-1.0.1/st7920/__init__.py

@@ -0,0 +1,3 @@
+from .st7920 import *
+
+name = "st7920"

joyit_st7920-1.0.1/st7920/st7920.py

@@ -0,0 +1,181 @@
+import spidev
+import time
+from PIL import Image
+from gpiozero import OutputDevice
+
+class ST7920:
+  def __init__(self, spi_bus=0, spi_device=0, reset_pin = 22):
+    """
+    Initilize ST7920 with SPI
+    """
+    self.spi = spidev.SpiDev()
+    self.spi.open(spi_bus, spi_device)
+    self.spi.max_speed_hz = 500000
+    self.spi.mode = 0
+
+    self.reset_pin = OutputDevice(reset_pin)    
+    self.init_display()
+    self.clear()
+
+  def _send_command(self, cmd):
+    """
+    Send command to display
+    """
+    data = [0xF8, cmd & 0xF0, (cmd << 4) & 0xF0]
+    self.spi.writebytes(data)
+    time.sleep(0.001)
+
+  def _send_data(self, data):
+    """
+    Send data to display
+    """
+    packet = [0xFA, data & 0xF0, (data << 4) & 0xF0]
+    self.spi.writebytes(packet)
+    time.sleep(0.001)
+
+  def init_display(self):
+    """
+    Establish communication with display 
+    """
+    time.sleep(0.05)
+    self._send_command(0x30)
+    self._send_command(0x30)
+    self._send_command(0x0C)
+    self._send_command(0x01)
+    time.sleep(0.01)
+        
+  def clear_graphics(self):
+    """
+    Clear image on display
+    """
+    self._send_command(0x30)  
+    self._send_command(0x34)
+    self._send_command(0x36)
+    for y in range(64):
+      if y < 32:
+        self._send_command(0x80 | y)
+        self._send_command(0x80)
+      else:
+        self._send_command(0x80 | (y - 32))
+        self._send_command(0x88)
+      for _ in range(16):
+        self._send_data(0x00)
+        
+  def clear(self):
+    """
+    Clear display
+    """
+    self._send_command(0x01)
+    time.sleep(0.01)
+    self.reset_pin.off()
+    time.sleep(0.1)
+    self.reset_pin.on()
+    time.sleep(0.1)
+    self.clear_graphics()
+    self._send_command(0x30)
+    self._send_command(0x0C)
+
+  def close(self):
+    """
+    Close connection
+    """
+    self.spi.close()
+
+  def write_text(self, text):
+    """
+    Write text on display
+    """
+    for char in text:
+      self._send_data(ord(char))
+
+  def home(self):
+    """
+    Set cursor to (0,0)
+    """
+    self._send_command(0x02)
+    time.sleep(0.01)
+
+  def display_on(self, cursor=False, blink=False):
+    """
+    Activate display with visible cursor (False/True) and or blinking cursor (False/True)
+    """
+    cmd = 0x0C
+    if cursor:
+      cmd |= 0x02
+    if blink:
+      cmd |= 0x01
+    self._send_command(cmd)
+
+  def display_off(self):
+    """
+    Turn display off
+    """
+    self._send_command(0x08)
+
+  def set_cursor(self, row: int, col: int):
+    """
+    Set cursor to position (row, col)
+    """
+    if row == 0:
+      address = 0x80 + col
+    elif row == 1:
+      address = 0x90 + col
+    else:
+      raise ValueError("Zeile muss 0 oder 1 sein.")
+    self._send_command(address)
+
+  def write_at(self, row: int, col: int, text: str):
+    """
+    Method to write text at position (row, col)
+    """
+    self.set_cursor(row, col)
+    self.write_text(text)
+
+  def shift_display_left(self):
+    """
+    Shift display to the left
+    """
+    self._send_command(0x18)
+
+  def shift_display_right(self):
+    """
+    Shift display to the right
+    """
+    self._send_command(0x1C)
+
+  def entry_mode(self, increment=True, shift=False):
+    """
+    Setup entry mode
+    """
+    cmd = 0x04
+    if increment:
+      cmd |= 0x02
+    if shift:
+      cmd |= 0x01
+    self._send_command(cmd)
+
+  def draw_image(self, image: Image.Image):
+    """
+    draw image on display
+    """
+    self._send_command(0x30)
+    self._send_command(0x34)
+    self._send_command(0x36)
+    if image.size != (128, 64):
+      raise ValueError("Image has to be 128x64 Pixel")
+    image = image.convert("1")    
+    pixels = image.load()
+    for y in range(64):
+      if y < 32:
+        self._send_command(0x80 | y)
+        self._send_command(0x80)
+      else:
+        self._send_command(0x80 | (y - 32))
+        self._send_command(0x88)
+      for x in range(0, 128, 8):
+        byte = 0
+        for bit in range(8):
+          if pixels[x + bit, y] == 0:
+            byte |= (1 << (7 - bit))
+        self._send_data(byte)
+