ex10 working

Author: Pete Lewis

examples/ex10_qwiic_serlcd_turn_off_display.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python
+#-----------------------------------------------------------------------------
+# ex10_qwiic_serlcd_turn_off_display.py
+#
+# This example prints "Hello World!" to the LCD and uses the
+# display() and noDisplay() functions to turn on and off
+# the display.
+#
+#------------------------------------------------------------------------
+#
+# Written by SparkFun Electronics, August 2020
+#
+# Ported from Arduino Library code with many contributions from
+# Gaston Williams - August 29, 2018
+# 
+# This python library supports the SparkFun Electroncis qwiic 
+# qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
+# board computers. 
+#
+# More information on qwiic is at https://www.sparkfun.com/qwiic
+#
+# Do you like this library? Help support SparkFun. Buy a board!
+#
+#==================================================================================
+# Copyright (c) 2020 SparkFun Electronics
+#
+# 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.
+#==================================================================================
+# Example 10
+#
+
+from __future__ import print_function
+import qwiic_serlcd
+import time
+import sys
+
+def runExample():
+
+	print("\nSparkFun Qwiic SerLCD   Example 10\n")
+	myLCD = qwiic_serlcd.QwiicSerlcd()
+
+	if myLCD.connected == False:
+		print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
+			file=sys.stderr)
+		return
+
+	myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
+	myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
+	myLCD.begin() # call this for default settings (no
+	myLCD.leftToRight()
+	myLCD.noCursor()
+	time.sleep(1) # give a sec for system messages to complete
+
+	# Print a message to the LCD.
+	myLCD.print("Hello World!")
+
+	while True:
+		myLCD.display() #turn on display
+		time.sleep(1)
+
+		myLCD.noDisplay() # turn off display
+		time.sleep(1)
+
+if __name__ == '__main__':
+	try:
+		runExample()
+	except (KeyboardInterrupt, SystemExit) as exErr:
+		print("\nEnding Example 10")
+		sys.exit(0)
+
+

qwiic_serlcd.py

@@ -651,3 +651,33 @@ def writeChar(self, location):
         result = self.command(35 + location)
         time.sleep(0.05)
         return result
+
+    # ----------------------------------
+    # display()
+    #
+    # Turn the display on quickly.
+    def display(self):
+        """
+            Turn the display on quickly.
+
+            :return: Returns true if the I2C write was successful, otherwise False.
+            :rtype: bool
+
+        """
+        self._displayControl |= LCD_DISPLAYON
+        return self.specialCommand(LCD_DISPLAYCONTROL | self._displayControl)
+
+    # ----------------------------------
+    # noDisplay()
+    #
+    # Turn the display off quickly.
+    def noDisplay(self):
+        """
+            Turn the display off quickly.
+
+            :return: Returns true if the I2C write was successful, otherwise False.
+            :rtype: bool
+
+        """
+        self._displayControl &= ~LCD_DISPLAYON
+        return self.specialCommand(LCD_DISPLAYCONTROL | self._displayControl)