kladd

kladd/LCD-1602-I2C/.gitignore

@@ -0,0 +1,104 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/

kladd/LCD-1602-I2C/LCD.py

@@ -0,0 +1,95 @@
+import smbus
+import time
+
+class LCD:
+    def __init__(self, pi_rev = 2, i2c_addr = 0x3F, backlight = True):
+
+        # device constants
+        self.I2C_ADDR  = i2c_addr
+        self.LCD_WIDTH = 16   # Max. characters per line
+
+        self.LCD_CHR = 1 # Mode - Sending data
+        self.LCD_CMD = 0 # Mode - Sending command
+
+        self.LCD_LINE_1 = 0x80 # LCD RAM addr for line one
+        self.LCD_LINE_2 = 0xC0 # LCD RAM addr for line two
+        self.LCD_LINE_3 = 0x94 # LCD RAM addr for line three
+        self.LCD_LINE_4 = 0xD4 # LCD RAM addr for line four
+
+        if backlight:
+            # on
+            self.LCD_BACKLIGHT  = 0x08
+        else:
+            # off
+            self.LCD_BACKLIGHT = 0x00
+
+        self.ENABLE = 0b00000100 # Enable bit
+
+        # Timing constants
+        self.E_PULSE = 0.0005
+        self.E_DELAY = 0.0005
+
+        # Open I2C interface
+        if pi_rev == 2:
+            # Rev 2 Pi uses 1
+            self.bus = smbus.SMBus(1)
+        elif pi_rev == 1:
+            # Rev 1 Pi uses 0
+            self.bus = smbus.SMBus(0)
+        else:
+            raise ValueError('pi_rev param must be 1 or 2')
+
+        # Initialise display
+        self.lcd_byte(0x33, self.LCD_CMD) # 110011 Initialise
+        self.lcd_byte(0x32, self.LCD_CMD) # 110010 Initialise
+        self.lcd_byte(0x06, self.LCD_CMD) # 000110 Cursor move direction
+        self.lcd_byte(0x0C, self.LCD_CMD) # 001100 Display On,Cursor Off, Blink Off
+        self.lcd_byte(0x28, self.LCD_CMD) # 101000 Data length, number of lines, font size
+        self.lcd_byte(0x01, self.LCD_CMD) # 000001 Clear display
+
+    def lcd_byte(self, bits, mode):
+        # Send byte to data pins
+        # bits = data
+        # mode = 1 for data, 0 for command
+
+        bits_high = mode | (bits & 0xF0) | self.LCD_BACKLIGHT
+        bits_low = mode | ((bits<<4) & 0xF0) | self.LCD_BACKLIGHT
+
+        # High bits
+        self.bus.write_byte(self.I2C_ADDR, bits_high)
+        self.toggle_enable(bits_high)
+
+        # Low bits
+        self.bus.write_byte(self.I2C_ADDR, bits_low)
+        self.toggle_enable(bits_low)
+
+    def toggle_enable(self, bits):
+        time.sleep(self.E_DELAY)
+        self.bus.write_byte(self.I2C_ADDR, (bits | self.ENABLE))
+        time.sleep(self.E_PULSE)
+        self.bus.write_byte(self.I2C_ADDR,(bits & ~self.ENABLE))
+        time.sleep(self.E_DELAY)
+
+    def message(self, string, line = 1):
+        # display message string on indicated LCD line
+        if line == 1:
+            lcd_line = self.LCD_LINE_1
+        elif line == 2:
+            lcd_line = self.LCD_LINE_2
+        elif line == 3:
+            lcd_line = self.LCD_LINE_3
+        elif line == 4:
+            lcd_line = self.LCD_LINE_4
+        else:
+            raise ValueError('line number out of range')
+
+        string = string.ljust(self.LCD_WIDTH," ")
+
+        self.lcd_byte(lcd_line, self.LCD_CMD)
+
+        for i in range(self.LCD_WIDTH):
+            self.lcd_byte(ord(string[i]), self.LCD_CHR)
+
+    def clear(self):
+        # clear LCD display
+        self.lcd_byte(0x01, self.LCD_CMD)

kladd/LCD-1602-I2C/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Sterling Beason
+
+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.

kladd/LCD-1602-I2C/README.md

@@ -0,0 +1,31 @@
+# LCD-1602-I2C
+A simple Python library for displaying text on the LCD 1602 w/ I2C. Implemented on the **Raspberry Pi** 3 B.
+
+## Simple Example
+```python
+import time
+from LCD import LCD
+
+lcd = LCD() # params available for rPi revision, I2C Address, and backlight on/off
+            # lcd = LCD(2, 0x3F, True)
+
+lcd.message("Hello World!", 1) # display 'Hello World!' on line 1 of LCD
+
+time.sleep(5) # wait 5 seconds
+
+lcd.clear() # clear LCD display
+```
+
+## Install/Setup
+```
+sudo apt-get install i2c-tools
+sudo apt-get install python-smbus
+```
+
+#### Enable I2C
+`sudo raspi-config`
+Advanced Options > I2C > Enable
+
+#### Determine I2C Address
+`i2cdetect -y 0`
+default is 0x3F