ex11 working

Author: Pete Lewis

examples/ex11_qwiic_serlcd_text_direction.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python
+#-----------------------------------------------------------------------------
+# ex11_qwiic_serlcd_text_direction.py
+#
+# This example demonstrates how to use leftToRight() and rightToLeft()
+# to change the where the next character will be printed.
+#
+#------------------------------------------------------------------------
+#
+# 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 11
+#
+
+from __future__ import print_function
+import qwiic_serlcd
+import time
+import sys
+
+def runExample():
+
+	print("\nSparkFun Qwiic SerLCD   Example 11\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.cursor()
+	time.sleep(1) # give a sec for system messages to complete
+
+	thisChar = 'a'
+
+	while True:
+		
+		if thisChar == 'j': # reverse directions at 'm'
+			myLCD.rightToLeft() # go right for the next letter
+		
+		if thisChar == 'q': # reverse again at 's'
+			myLCD.leftToRight() # go left for the next letter
+			time.sleep(1)
+		
+		if thisChar > 'z': # reset at 'z'
+			myLCD.home() # go to (0,0)
+			myLCD.clearScreen() # clear screen
+			thisChar = 'a' # start again at 0
+		
+		myLCD.print(thisChar) # print the character
+		time.sleep(0.5) # wait a second
+		thisChar = chr(ord(thisChar) + 1) # increment the letter
+
+if __name__ == '__main__':
+	try:
+		runExample()
+	except (KeyboardInterrupt, SystemExit) as exErr:
+		print("\nEnding Example 11")
+		sys.exit(0)
+
+

qwiic_serlcd.py

@@ -261,6 +261,26 @@ def clearScreen(self):
         time.sleep(0.01)
         return result
 
+    # ----------------------------------
+    # home()
+    #
+    # Send the home command to the display.  This returns the cursor
+    # to return to the beginning of the display, without clearing
+    # the display.
+    def home(self):
+        """
+            Send the home command to the display.  This returns the cursor
+            to return to the beginning of the display, without clearing
+            the display.
+
+            :return: Returns true if the I2C write was successful, otherwise False.
+            :rtype: bool
+
+        """
+        result = self.specialCommand(LCD_RETURNHOME)
+        time.sleep(0.01)
+        return result
+
     # ----------------------------------
     # setCursor()
     #
@@ -680,4 +700,4 @@ def noDisplay(self):
 
         """
         self._displayControl &= ~LCD_DISPLAYON
-        return self.specialCommand(LCD_DISPLAYCONTROL | self._displayControl)
+        return self.specialCommand(LCD_DISPLAYCONTROL | self._displayControl)