ex17 change address working

Author: Pete Lewis

examples/ex16_qwiic_serlcd_set_splash.py

@@ -2,7 +2,7 @@
 #-----------------------------------------------------------------------------
 # ex16_qwiic_serlcd_set_splash.py
 #
-# This sketch demonstrates how to create your own custom splash screen.
+# This example demonstrates how to create your own custom splash screen.
 #
 # This is done by first writing the text you want as your splash to the display,
 # then 'saving' it as a splash screen.

examples/ex17_qwiic_serlcd_change_i2c_address.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python
+#-----------------------------------------------------------------------------
+# ex17_qwiic_serlcd_change_i2c_address.py
+#
+# This example demonstrates how to change the i2c address on your LCD.
+# Note, once you change the address, then you will need to intatiate your class
+# using your new address.
+#
+# Once you have changed the address, you can try using the optional instantiation
+# line of code that is currently commented out.
+#
+# There is a set range of available addresses from 0x07 to 0x78, so make sure your 
+# chosen address falls within this range. 
+# 
+# The next thing to note is that when you change the address you'll
+# need to call an instance of the QwiicSerlcd class that includes your new
+# address, like so: "myLCD = qwiic_serlcd.QwiicSerlcd(address=YOUR_NEW_ADDRESS_HERE)"
+# so that the new address is fed to all the available functions. 
+# 
+# Finally if for some reason you've forgotten your new address. No big deal, run a 
+# hardware reset on your screen to get it back to the default address (0x72).
+# To cause a hardware reset, simply tie the RX pin LOW, and they cycle power 
+# (while continuing to hold RX low). Then release RX, and cycle power again.
+#
+#------------------------------------------------------------------------
+#
+# Written by SparkFun Electronics, August 2020
+#
+# Ported from Arduino Library code with many contributions from
+# Gaston Williams - August 29, 2018
+#
+# Some code/comments/ideas ported from the Qwiic Quad Relay Arduino Library
+# Written by Elias Santistevan, July 2019
+# 
+# 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 17
+#
+
+from __future__ import print_function
+import qwiic_serlcd
+import time
+import sys
+
+old_address = 0x72 # default
+new_address = 0x71 # must be within 0x07 to 0x78, DEFAULT: 0x72
+
+def runExample():
+
+	print("\nSparkFun Qwiic SerLCD   Example 17\n")
+	print("\nType CTRL+C to end.\n")
+	myLCD = qwiic_serlcd.QwiicSerlcd(address=old_address)
+
+	print("Attemping to connect to %s..." % hex(myLCD.address))
+
+	if myLCD.connected == False:
+		print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
+			file=sys.stderr)
+		return
+	else:
+		print("Connected!")
+		myLCD.setBacklight(255, 255, 255) # 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
+
+		myLCD.clearScreen()
+
+		myLCD.setAddress(new_address) # note this updates class member myLCD.address to the new_address
+		
+		if myLCD.connected == True:
+			print("Address changed to %s successfully!" % hex(myLCD.address))
+			myLCD.clearScreen()
+			myLCD.print("My new add: %s" % hex(myLCD.address))
+		else:
+			print("Address change failed :(")
+	while True:
+		time.sleep(1) # do nothing
+
+if __name__ == '__main__':
+	try:
+		runExample()
+	except (KeyboardInterrupt, SystemExit) as exErr:
+		print("\nEnding Example 17")
+		sys.exit(0)
+
+

qwiic_serlcd.py

@@ -863,4 +863,5 @@ def setAddress(self, new_addr):
         # send the complete bytes (address, settings command , address command , new_addr byte)
         result = self._i2c.writeBlock(self.address, SETTING_COMMAND, block)
         time.sleep(0.05)
-        return result
+        self.address = new_addr # update our own address, so we can stil talk to the display
+        return result