90 |
91 |
92 |
121 |
122 |
123 |
--------------------------------------------------------------------------------
/docs/images/gh-banner-py-qwiic-serlcd.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sparkfun/qwiic_serlcd_py/5aa62c6e41cd775464abbc5bd87b635e9d05f4ed/docs/images/gh-banner-py-qwiic-serlcd.png
--------------------------------------------------------------------------------
/docs/images/sfe_flame.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sparkfun/qwiic_serlcd_py/5aa62c6e41cd775464abbc5bd87b635e9d05f4ed/docs/images/sfe_flame.png
--------------------------------------------------------------------------------
/docs/requirements.txt:
--------------------------------------------------------------------------------
1 | m2r
2 | sparkfun-qwiic-i2c
3 |
--------------------------------------------------------------------------------
/examples/README.md:
--------------------------------------------------------------------------------
1 | # Sparkfun SerLCD Examples Reference
2 | Below is a brief summary of each of the example programs included in this repository. To report a bug in any of these examples or to request a new feature or example [file an issue in our GitHub issues.](https://github.com/sparkfun/qwiic_serlcd_py/issues)
3 |
4 | ## Example 1: Hello World
5 | This example demonstrates basic bringup of the LCD to print "Hello World!".
6 |
7 | It showcases the following methods:
8 |
9 | - [setBacklight()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a81afb76ad0cc0b03b2def16c29ceaf06)
10 | - [setContrast()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a2dea2487f84df67519f61ff3004c7d12)
11 | - [clearScreen()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a35e73e1105f1db0be89372a5f4500714)
12 | - [print()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a30a4a9383c96b81763c6a32fa8b3f8dc)
13 | - [setCursor()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#ab62f2dd063749b4418373f3320f2a38a)
14 |
15 |
16 | ## Example 2: Backlight
17 | This example shows how to change the color of the backlight by cycling through backlight colors and printing the name of the current backlight color to the display.
18 |
19 | The key method showcased by this example is [setBacklight()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a81afb76ad0cc0b03b2def16c29ceaf06)
20 |
21 | ## Example 3: Set Cursor Position
22 | This example shows how to set the cursor to a specific column and row to print a character. It cycles through the lowercase letters of the alphabet (a-z) and prints each to a random row and column of the display.
23 |
24 | The key method showcased by this example is [setCursor()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#ab62f2dd063749b4418373f3320f2a38a)
25 |
26 | ## Example 4: Move Cursor
27 | This example shows how to manually move the cursor left or right. It cycles between moving the cursor left three spaces and then moving it right three spaces.
28 |
29 | The key methods showcased by this example are [moveCursorLeft()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#ac6dda0410878a153b193b05d4eeb62ee) and [moveCursorRight()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a7d8891c7fb78d2e684c7cdf38556b813)
30 |
31 | ## Example 5: Enable Cursor
32 | This example shows how to turn the cursor on and off. It prints "Hello World!" to the LCD and then cycles between turning the cursor on for a second and off for a second.
33 |
34 | The key methods showcased by this example are [cursor()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#ab11b11f6eaca0dd22e7c14b816e10bed) and [noCursor()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#abafa73de35582185e9db2c74f91df116)
35 |
36 | ## Example 6: Blink Cursor
37 | This example shows how to turn blinking of the cursor on and off. It prints "Hello World!" to the LCD and then cycles between turning the blinking on for 5 seconds and off for 5 seconds.
38 |
39 | The key methods showcased by this example are [blink()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a4c92d4fa2a89bbda03bcca43d82cd95a) and [noBlink()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#aae22aaee6f6d748c2921fc7b3008014b)
40 |
41 | ## Example 7: Scroll
42 | This example demonstrates the scrolling controls on the SerLCD. It prints "Hello World!" to the LCD and then cycles between scrolling it offscreen to the left, then offscreen to the right before finally centering it again.
43 |
44 | The key methods showcased by this example are [scrollDisplayLeft()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a5770a90358b2bad368e67aa23f8d0148) and [scrollDisplayRight()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#abcb7784572d86a1ca3beec4b73481a6f)
45 |
46 | ## Example 8: Autoscroll Text
47 | This example demonstrates the autoscroll feature on the SerLCD. It cycles between printing the characters 0 to 9 and turning on and off autoscroll.
48 |
49 | The key methods showcased by this example are:
50 |
51 | - [leftToRight()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a3a1c4c6cf831084a78f09fb535fb69fc)
52 | - [autoScroll()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a1ed67c384ab25e363e8129bc4d5c37e8)
53 | - [noAutoScroll()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#abbbd2c0c047d37f88209b6dd27a34359)
54 |
55 |
56 | ## Example 9: Custom Character
57 | This example demonstrates how to print custom characters to the LCD. It demonstrates printing a heart and a smiley face and then a little man waving his arms up and down.
58 |
59 | The key methods showcased by this example are [createChar()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#af75050abc733dd3ada34e79bd9a3b21b) and [writeChar()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a1b7e9f17fd0f061eef860416ce846783)
60 |
61 | ## Example 10: Turn off Display
62 | This example prints "Hello World!" to the LCD and turns on and off
63 | the display for a second each.
64 |
65 | The key methods showcased by this example are [display()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#acef2bfe9d6a0b2629150f0d18bf6849d) and [noDisplay()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#ae5db2e051be1530b742aacef0b4ccd3f)
66 |
67 | ## Example 11: Text Direction
68 | This example demonstrates how to change where the next character will be printed. It walks through the alphabet and cycles between printing characters from right to left then left to right.
69 |
70 | The key methods showcased by this example are [rightToLeft()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#add5f1d9c4796f5f73d8944eb1e825575), [leftToRight()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a3a1c4c6cf831084a78f09fb535fb69fc) and [home()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a26bb593af77460f92a2dc1791096c294).
71 |
72 | ## Example 12: Console Input to Display
73 | This example demonstrates printing arbitrary strings to the LCD. It takes user input from the Python repl until the user presses "enter" and then prints it to the LCD.
74 |
75 | The key method showcased by this example is [print()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a30a4a9383c96b81763c6a32fa8b3f8dc)
76 |
77 |
78 | ## Example 13: Fast Backlight
79 | This example shows how to set the backlight fast. It is advantageous because using this method doesn't show any system messages and sends the values in one concatenated block of data (a single command for all 3 values). It alternates between turning the backlight red for a second an then orange for a second.
80 |
81 | The key method showcased by this example is [setFastBacklight()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#afbc44537d3f324299f6a94433e338ef1)
82 |
83 | ## Example 14: Show Firmware Version
84 | This example shows how to get the devices firmware version. It repeatedly sends the command to display the firmware version.
85 |
86 | The key method showcased by this example is [command()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#aed9378ca8da9030c62fe29ac96513cf4)
87 |
88 | ## Example 15: Message Enable
89 | This example demonstrates how to turn off the system messages displayed when
90 | the user changes a setting. For instance 'Contrast: 5' or 'Backlight: 100%' is
91 | no longer displayed. It first sets the backlight and contrast while system messages are enabled, and then disables them and repeatedly changes the backlight color to demonstrate that the system messages are no longer printed.
92 |
93 | The key method showcased by this example is [disableSystemMessages()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a748362f1dfd4a4af65a19e1c07c6fbca)
94 |
95 | ## Example 16: Set Splash
96 | This example demonstrates how to create your own custom splash screen.
97 |
98 | This is done by first writing the text you want as your splash to the display,
99 | then 'saving' it as a splash screen.
100 |
101 | You can also disable or enable the displaying of the splash screen.
102 |
103 | Note - The disableSplash() and enableSplash() commands
104 | are only supported on SerLCD v1.2 and above. But you can still use the
105 | toggle splash command (Ctrl+i) to enable/disable the splash.
106 |
107 | The example sets the custom splash screen to "Tea-O-Matic".
108 |
109 | The key methods showcased by this example are [saveSplash()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#ae80dc2c1c37bd22f8aba75336ea9cedb) and [enableSplash()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a4783eaf3f021b51e0c8b877d64742063)
110 |
111 | ## Example 17: Change I2C Address
112 | This example demonstrates how to change the I2C address on your LCD.
113 |
114 | The key method showcased by this example is [setAddress()](https://docs.sparkfun.com/qwiic_serlcd_py/classqwiic__serlcd_1_1_qwiic_serlcd.html#a4783eaf3f021b51e0c8b877d64742063)
--------------------------------------------------------------------------------
/examples/ex10_qwiic_serlcd_turn_off_display.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex10_qwiic_serlcd_turn_off_display.py
4 | #
5 | # This example prints "Hello World!" to the LCD and uses the
6 | # display() and noDisplay() functions to turn on and off
7 | # the display.
8 | #
9 | #------------------------------------------------------------------------
10 | #
11 | # Written by SparkFun Electronics, August 2020
12 | #
13 | # Ported from Arduino Library code with many contributions from
14 | # Gaston Williams - August 29, 2018
15 | #
16 | # This python library supports the SparkFun Electroncis qwiic
17 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
18 | # board computers.
19 | #
20 | # More information on qwiic is at https://www.sparkfun.com/qwiic
21 | #
22 | # Do you like this library? Help support SparkFun. Buy a board!
23 | #
24 | #==================================================================================
25 | # Copyright (c) 2020 SparkFun Electronics
26 | #
27 | # Permission is hereby granted, free of charge, to any person obtaining a copy
28 | # of this software and associated documentation files (the "Software"), to deal
29 | # in the Software without restriction, including without limitation the rights
30 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
31 | # copies of the Software, and to permit persons to whom the Software is
32 | # furnished to do so, subject to the following conditions:
33 | #
34 | # The above copyright notice and this permission notice shall be included in all
35 | # copies or substantial portions of the Software.
36 | #
37 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
38 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
39 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
40 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
41 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
42 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
43 | # SOFTWARE.
44 | #==================================================================================
45 | # Example 10
46 | #
47 |
48 | import qwiic_serlcd
49 | import time
50 | import sys
51 |
52 | def runExample():
53 |
54 | print("\nSparkFun Qwiic SerLCD Example 10\n")
55 | myLCD = qwiic_serlcd.QwiicSerlcd()
56 |
57 | if myLCD.connected == False:
58 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
59 | file=sys.stderr)
60 | return
61 |
62 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
63 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
64 | myLCD.begin() # call this for default settings (no
65 | myLCD.leftToRight()
66 | myLCD.noCursor()
67 | time.sleep(1) # give a sec for system messages to complete
68 |
69 | # Print a message to the LCD.
70 | myLCD.print("Hello World!")
71 |
72 | while True:
73 | myLCD.display() #turn on display
74 | time.sleep(1)
75 |
76 | myLCD.noDisplay() # turn off display
77 | time.sleep(1)
78 |
79 | if __name__ == '__main__':
80 | try:
81 | runExample()
82 | except (KeyboardInterrupt, SystemExit) as exErr:
83 | print("\nEnding Example 10")
84 | sys.exit(0)
85 |
86 |
87 |
--------------------------------------------------------------------------------
/examples/ex11_qwiic_serlcd_text_direction.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex11_qwiic_serlcd_text_direction.py
4 | #
5 | # This example demonstrates how to use leftToRight() and rightToLeft()
6 | # to change the where the next character will be printed.
7 | #
8 | #------------------------------------------------------------------------
9 | #
10 | # Written by SparkFun Electronics, August 2020
11 | #
12 | # Ported from Arduino Library code with many contributions from
13 | # Gaston Williams - August 29, 2018
14 | #
15 | # This python library supports the SparkFun Electroncis qwiic
16 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
17 | # board computers.
18 | #
19 | # More information on qwiic is at https://www.sparkfun.com/qwiic
20 | #
21 | # Do you like this library? Help support SparkFun. Buy a board!
22 | #
23 | #==================================================================================
24 | # Copyright (c) 2020 SparkFun Electronics
25 | #
26 | # Permission is hereby granted, free of charge, to any person obtaining a copy
27 | # of this software and associated documentation files (the "Software"), to deal
28 | # in the Software without restriction, including without limitation the rights
29 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
30 | # copies of the Software, and to permit persons to whom the Software is
31 | # furnished to do so, subject to the following conditions:
32 | #
33 | # The above copyright notice and this permission notice shall be included in all
34 | # copies or substantial portions of the Software.
35 | #
36 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
37 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
38 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
39 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
40 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
41 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
42 | # SOFTWARE.
43 | #==================================================================================
44 | # Example 11
45 | #
46 |
47 | import qwiic_serlcd
48 | import time
49 | import sys
50 |
51 | def runExample():
52 |
53 | print("\nSparkFun Qwiic SerLCD Example 11\n")
54 | myLCD = qwiic_serlcd.QwiicSerlcd()
55 |
56 | if myLCD.connected == False:
57 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
58 | file=sys.stderr)
59 | return
60 |
61 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
62 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
63 | myLCD.begin() # call this for default settings (no
64 | myLCD.leftToRight()
65 | myLCD.cursor()
66 | time.sleep(1) # give a sec for system messages to complete
67 |
68 | thisChar = 'a'
69 |
70 | while True:
71 |
72 | if thisChar == 'j': # reverse directions at 'm'
73 | myLCD.rightToLeft() # go right for the next letter
74 |
75 | if thisChar == 'q': # reverse again at 's'
76 | myLCD.leftToRight() # go left for the next letter
77 | time.sleep(1)
78 |
79 | if thisChar > 'z': # reset at 'z'
80 | myLCD.home() # go to (0,0)
81 | myLCD.clearScreen() # clear screen
82 | thisChar = 'a' # start again at 0
83 |
84 | myLCD.print(thisChar) # print the character
85 | time.sleep(0.5) # wait a second
86 | thisChar = chr(ord(thisChar) + 1) # increment the letter
87 |
88 | if __name__ == '__main__':
89 | try:
90 | runExample()
91 | except (KeyboardInterrupt, SystemExit) as exErr:
92 | print("\nEnding Example 11")
93 | sys.exit(0)
94 |
95 |
96 |
--------------------------------------------------------------------------------
/examples/ex12_qwiic_serlcd_console_input_to_display.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex12_qwiic_serlcd_console_input_to_display.py
4 | #
5 | # This example demonstrates how to take text input from the python console
6 | # and send it to the LCD.
7 | #
8 | #------------------------------------------------------------------------
9 | #
10 | # Written by SparkFun Electronics, August 2020
11 | #
12 | # Ported from Arduino Library code with many contributions from
13 | # Gaston Williams - August 29, 2018
14 | #
15 | # This python library supports the SparkFun Electroncis qwiic
16 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
17 | # board computers.
18 | #
19 | # More information on qwiic is at https://www.sparkfun.com/qwiic
20 | #
21 | # Do you like this library? Help support SparkFun. Buy a board!
22 | #
23 | #==================================================================================
24 | # Copyright (c) 2020 SparkFun Electronics
25 | #
26 | # Permission is hereby granted, free of charge, to any person obtaining a copy
27 | # of this software and associated documentation files (the "Software"), to deal
28 | # in the Software without restriction, including without limitation the rights
29 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
30 | # copies of the Software, and to permit persons to whom the Software is
31 | # furnished to do so, subject to the following conditions:
32 | #
33 | # The above copyright notice and this permission notice shall be included in all
34 | # copies or substantial portions of the Software.
35 | #
36 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
37 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
38 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
39 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
40 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
41 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
42 | # SOFTWARE.
43 | #==================================================================================
44 | # Example 12
45 | #
46 |
47 | import qwiic_serlcd
48 | import time
49 | import sys
50 |
51 | def runExample():
52 |
53 | print("\nSparkFun Qwiic SerLCD Example 12\n")
54 | print("\nType CTRL+C to end.\n")
55 | myLCD = qwiic_serlcd.QwiicSerlcd()
56 |
57 | if myLCD.connected == False:
58 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
59 | file=sys.stderr)
60 | return
61 |
62 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
63 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
64 | myLCD.begin() # call this for default settings
65 | myLCD.leftToRight()
66 | myLCD.noCursor()
67 | time.sleep(1) # give a sec for system messages to complete
68 |
69 | while True:
70 |
71 | # promt the user to input some text
72 | user_input = input("Please type something to display on the LCD: ")
73 |
74 | myLCD.clearScreen() # clear the screen
75 |
76 | myLCD.print(user_input) # print what the user just typed in
77 |
78 | time.sleep(0.5) # wait a second
79 |
80 | if __name__ == '__main__':
81 | try:
82 | runExample()
83 | except (KeyboardInterrupt, SystemExit) as exErr:
84 | print("\nEnding Example 12")
85 | sys.exit(0)
86 |
87 |
88 |
--------------------------------------------------------------------------------
/examples/ex13_qwiic_serlcd_fast_backlight.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex13_qwiic_serlcd_fast_backlight.py
4 | #
5 | # This example shows how to use the fastBacklight() method.
6 | # It is nice because it doesn't show system messages, and sends the values
7 | # in one concatinated block of data (a single command for all 3 values).
8 | #
9 | #------------------------------------------------------------------------
10 | #
11 | # Written by SparkFun Electronics, August 2020
12 | #
13 | # Ported from Arduino Library code with many contributions from
14 | # Gaston Williams - August 29, 2018
15 | #
16 | # This python library supports the SparkFun Electroncis qwiic
17 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
18 | # board computers.
19 | #
20 | # More information on qwiic is at https://www.sparkfun.com/qwiic
21 | #
22 | # Do you like this library? Help support SparkFun. Buy a board!
23 | #
24 | #==================================================================================
25 | # Copyright (c) 2020 SparkFun Electronics
26 | #
27 | # Permission is hereby granted, free of charge, to any person obtaining a copy
28 | # of this software and associated documentation files (the "Software"), to deal
29 | # in the Software without restriction, including without limitation the rights
30 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
31 | # copies of the Software, and to permit persons to whom the Software is
32 | # furnished to do so, subject to the following conditions:
33 | #
34 | # The above copyright notice and this permission notice shall be included in all
35 | # copies or substantial portions of the Software.
36 | #
37 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
38 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
39 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
40 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
41 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
42 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
43 | # SOFTWARE.
44 | #==================================================================================
45 | # Example 13
46 | #
47 |
48 | import qwiic_serlcd
49 | import time
50 | import sys
51 |
52 | def runExample():
53 |
54 | print("\nSparkFun Qwiic SerLCD Example 13\n")
55 | print("\nType CTRL+C to end.\n")
56 | myLCD = qwiic_serlcd.QwiicSerlcd()
57 |
58 | if myLCD.connected == False:
59 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
60 | file=sys.stderr)
61 | return
62 |
63 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
64 | myLCD.begin() # call this for default settings (no
65 | myLCD.leftToRight()
66 | myLCD.noCursor()
67 | time.sleep(1) # give a sec for system messages to complete
68 |
69 | while True:
70 | myLCD.setFastBacklight(255, 0, 0) # bright red
71 | myLCD.clearScreen()
72 | myLCD.print("Red")
73 | time.sleep(1)
74 |
75 | myLCD.setFastBacklight(0xFF, 0x8C, 0x00) # orange
76 | myLCD.clearScreen()
77 | myLCD.print("Orange")
78 | time.sleep(1)
79 |
80 | if __name__ == '__main__':
81 | try:
82 | runExample()
83 | except (KeyboardInterrupt, SystemExit) as exErr:
84 | print("\nEnding Example 13")
85 | sys.exit(0)
86 |
87 |
88 |
--------------------------------------------------------------------------------
/examples/ex14_qwiic_serlcd_show_firmware_version.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex14_qwiic_serlcd_show_firmware_version.py
4 | #
5 | # This example prints the devices firmware version on the screen.
6 | #
7 | #------------------------------------------------------------------------
8 | #
9 | # Written by SparkFun Electronics, August 2020
10 | #
11 | # Ported from Arduino Library code with many contributions from
12 | # Gaston Williams - August 29, 2018
13 | #
14 | # This python library supports the SparkFun Electroncis qwiic
15 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
16 | # board computers.
17 | #
18 | # More information on qwiic is at https://www.sparkfun.com/qwiic
19 | #
20 | # Do you like this library? Help support SparkFun. Buy a board!
21 | #
22 | #==================================================================================
23 | # Copyright (c) 2020 SparkFun Electronics
24 | #
25 | # Permission is hereby granted, free of charge, to any person obtaining a copy
26 | # of this software and associated documentation files (the "Software"), to deal
27 | # in the Software without restriction, including without limitation the rights
28 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
29 | # copies of the Software, and to permit persons to whom the Software is
30 | # furnished to do so, subject to the following conditions:
31 | #
32 | # The above copyright notice and this permission notice shall be included in all
33 | # copies or substantial portions of the Software.
34 | #
35 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
36 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
37 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
38 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
39 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
40 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
41 | # SOFTWARE.
42 | #==================================================================================
43 | # Example 14
44 | #
45 |
46 | import qwiic_serlcd
47 | import time
48 | import sys
49 |
50 | def runExample():
51 |
52 | print("\nSparkFun Qwiic SerLCD Example 14\n")
53 | print("\nType CTRL+C to end.\n")
54 | myLCD = qwiic_serlcd.QwiicSerlcd()
55 |
56 | if myLCD.connected == False:
57 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
58 | file=sys.stderr)
59 | return
60 |
61 | myLCD.setBacklight(255, 255, 255) # bright white
62 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
63 | myLCD.begin() # call this for default settings (no
64 | myLCD.leftToRight()
65 | myLCD.noCursor()
66 | time.sleep(1) # give a sec for system messages to complete
67 |
68 | while True:
69 | myLCD.command(ord(',')) # send the comma to display the frimware version
70 | time.sleep(0.5) # Firmware will be displayed for 500ms, so keep re-printing it
71 |
72 | if __name__ == '__main__':
73 | try:
74 | runExample()
75 | except (KeyboardInterrupt, SystemExit) as exErr:
76 | print("\nEnding Example 14")
77 | sys.exit(0)
78 |
79 |
80 |
--------------------------------------------------------------------------------
/examples/ex15_qwiic_serlcd_message_enable.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex15_qwiic_serlcd_message_enable.py
4 | #
5 | # This example demonstrates how to turn off the system messages displayed when
6 | # the user changes a setting. For instance 'Contrast: 5' or 'Backlight: 100%' is
7 | # no longer displayed.
8 | #
9 | # Note - This example and the disableSystemMessages() and enableSystemMessages()
10 | # commands are only supported on SerLCD v1.2 and above.
11 | #
12 | #------------------------------------------------------------------------
13 | #
14 | # Written by SparkFun Electronics, August 2020
15 | #
16 | # Ported from Arduino Library code with many contributions from
17 | # Gaston Williams - August 29, 2018
18 | #
19 | # This python library supports the SparkFun Electroncis qwiic
20 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
21 | # board computers.
22 | #
23 | # More information on qwiic is at https://www.sparkfun.com/qwiic
24 | #
25 | # Do you like this library? Help support SparkFun. Buy a board!
26 | #
27 | #==================================================================================
28 | # Copyright (c) 2020 SparkFun Electronics
29 | #
30 | # Permission is hereby granted, free of charge, to any person obtaining a copy
31 | # of this software and associated documentation files (the "Software"), to deal
32 | # in the Software without restriction, including without limitation the rights
33 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
34 | # copies of the Software, and to permit persons to whom the Software is
35 | # furnished to do so, subject to the following conditions:
36 | #
37 | # The above copyright notice and this permission notice shall be included in all
38 | # copies or substantial portions of the Software.
39 | #
40 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
41 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
42 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
43 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
44 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
45 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
46 | # SOFTWARE.
47 | #==================================================================================
48 | # Example 15
49 | #
50 |
51 | import qwiic_serlcd
52 | import time
53 | import sys
54 |
55 | def runExample():
56 |
57 | print("\nSparkFun Qwiic SerLCD Example 15\n")
58 | print("\nType CTRL+C to end.\n")
59 | myLCD = qwiic_serlcd.QwiicSerlcd()
60 |
61 | if myLCD.connected == False:
62 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
63 | file=sys.stderr)
64 | return
65 |
66 | myLCD.setBacklight(255, 255, 255) # bright white
67 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
68 | myLCD.begin() # call this for default settings (no
69 | myLCD.leftToRight()
70 | myLCD.noCursor()
71 | time.sleep(1) # give a sec for system messages to complete
72 |
73 | myLCD.disableSystemMessages() # Now whenever you change a system setting like Contrast,
74 | # SerLCD will not display the setting. This makes changing the setting faster, and also
75 | # invisible to the user.
76 |
77 | #myLCD.enableSystemMessages() # This will re-enable the printing of system messages
78 |
79 | myLCD.clearScreen()
80 | myLCD.print("Hello World!")
81 |
82 | counter = 0
83 |
84 | while True:
85 | # do something that would normally cause a system message
86 | # let's change color of backlight values every other count value
87 | if (counter % 2) == 0:
88 | myLCD.setBacklight(255, 0, 0)
89 | else:
90 | myLCD.setBacklight(0, 255, 0)
91 |
92 | time.sleep(0.1) # give it a sec to change backlight
93 |
94 | print("counter: %d" % counter)
95 | myLCD.setCursor(0,1)
96 | myLCD.print(str(counter))
97 | counter = counter + 1
98 | time.sleep(1)
99 |
100 | if __name__ == '__main__':
101 | try:
102 | runExample()
103 | except (KeyboardInterrupt, SystemExit) as exErr:
104 | print("\nEnding Example 15")
105 | sys.exit(0)
106 |
107 |
108 |
--------------------------------------------------------------------------------
/examples/ex16_qwiic_serlcd_set_splash.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex16_qwiic_serlcd_set_splash.py
4 | #
5 | # This example demonstrates how to create your own custom splash screen.
6 | #
7 | # This is done by first writing the text you want as your splash to the display,
8 | # then 'saving' it as a splash screen.
9 | #
10 | # You can also disable or enable the displaying of the splash screen.
11 | #
12 | # Note - The disableSplash() and enableSplash() commands
13 | # are only supported on SerLCD v1.2 and above. But you can still use the
14 | # toggle splash command (Ctrl+i) to enable/disable the splash.
15 | #
16 | #------------------------------------------------------------------------
17 | #
18 | # Written by SparkFun Electronics, August 2020
19 | #
20 | # Originally written for the Arduino Library by Nathan Seidle 2/16/2019
21 | #
22 | # Ported to this python example by Pete Lewis 8/18/2020
23 | #
24 | # Ported from Arduino Library code with many contributions from
25 | # Gaston Williams - August 29, 2018
26 | #
27 | # This python library supports the SparkFun Electroncis qwiic
28 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
29 | # board computers.
30 | #
31 | # More information on qwiic is at https://www.sparkfun.com/qwiic
32 | #
33 | # Do you like this library? Help support SparkFun. Buy a board!
34 | #
35 | #==================================================================================
36 | # Copyright (c) 2020 SparkFun Electronics
37 | #
38 | # Permission is hereby granted, free of charge, to any person obtaining a copy
39 | # of this software and associated documentation files (the "Software"), to deal
40 | # in the Software without restriction, including without limitation the rights
41 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
42 | # copies of the Software, and to permit persons to whom the Software is
43 | # furnished to do so, subject to the following conditions:
44 | #
45 | # The above copyright notice and this permission notice shall be included in all
46 | # copies or substantial portions of the Software.
47 | #
48 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
49 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
50 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
51 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
52 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
53 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
54 | # SOFTWARE.
55 | #==================================================================================
56 | # Example 16
57 | #
58 |
59 | import qwiic_serlcd
60 | import time
61 | import sys
62 |
63 | def runExample():
64 |
65 | print("\nSparkFun Qwiic SerLCD Example 16\n")
66 | print("\nType CTRL+C to end.\n")
67 | myLCD = qwiic_serlcd.QwiicSerlcd()
68 |
69 | if myLCD.connected == False:
70 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
71 | file=sys.stderr)
72 | return
73 |
74 | myLCD.setBacklight(255, 255, 255) # bright white
75 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
76 | myLCD.begin() # call this for default settings (no
77 | myLCD.leftToRight()
78 | myLCD.noCursor()
79 | time.sleep(1) # give a sec for system messages to complete
80 |
81 | myLCD.clearScreen()
82 | myLCD.print("Tea-O-Matic")
83 | time.sleep(1)
84 |
85 | myLCD.saveSplash() # save this current text as the splash screen at next power up
86 |
87 | myLCD.enableSplash() # This will cause the splash to be displayed at power on
88 | #myLCD.disableSplash() # This will supress the splash from being displayed at power on
89 |
90 | counter = 0
91 |
92 | myLCD.clearScreen()
93 | myLCD.print("Cups of tea: ")
94 |
95 | while True:
96 | print("counter: %d" % counter)
97 | myLCD.setCursor(0,1)
98 | myLCD.print(str(counter))
99 | counter = counter + 1
100 | time.sleep(1)
101 |
102 | if __name__ == '__main__':
103 | try:
104 | runExample()
105 | except (KeyboardInterrupt, SystemExit) as exErr:
106 | print("\nEnding Example 16")
107 | sys.exit(0)
108 |
109 |
110 |
--------------------------------------------------------------------------------
/examples/ex17_qwiic_serlcd_change_i2c_address.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex17_qwiic_serlcd_change_i2c_address.py
4 | #
5 | # This example demonstrates how to change the i2c address on your LCD.
6 | # Note, once you change the address, then you will need to intatiate your class
7 | # using your new address.
8 | #
9 | # Once you have changed the address, you can try using the optional instantiation
10 | # line of code that is currently commented out.
11 | #
12 | # There is a set range of available addresses from 0x07 to 0x78, so make sure your
13 | # chosen address falls within this range.
14 | #
15 | # The next thing to note is that when you change the address you'll
16 | # need to call an instance of the QwiicSerlcd class that includes your new
17 | # address, like so: "myLCD = qwiic_serlcd.QwiicSerlcd(address=YOUR_NEW_ADDRESS_HERE)"
18 | # so that the new address is fed to all the available functions.
19 | #
20 | # Finally if for some reason you've forgotten your new address. No big deal, run a
21 | # hardware reset on your screen to get it back to the default address (0x72).
22 | # To cause a hardware reset, simply tie the RX pin LOW, and they cycle power
23 | # (while continuing to hold RX low). Then release RX, and cycle power again.
24 | #
25 | #------------------------------------------------------------------------
26 | #
27 | # Written by SparkFun Electronics, August 2020
28 | #
29 | # Ported from Arduino Library code with many contributions from
30 | # Gaston Williams - August 29, 2018
31 | #
32 | # Some code/comments/ideas ported from the Qwiic Quad Relay Arduino Library
33 | # Written by Elias Santistevan, July 2019
34 | #
35 | # This python library supports the SparkFun Electroncis qwiic
36 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
37 | # board computers.
38 | #
39 | # More information on qwiic is at https://www.sparkfun.com/qwiic
40 | #
41 | # Do you like this library? Help support SparkFun. Buy a board!
42 | #
43 | #==================================================================================
44 | # Copyright (c) 2020 SparkFun Electronics
45 | #
46 | # Permission is hereby granted, free of charge, to any person obtaining a copy
47 | # of this software and associated documentation files (the "Software"), to deal
48 | # in the Software without restriction, including without limitation the rights
49 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
50 | # copies of the Software, and to permit persons to whom the Software is
51 | # furnished to do so, subject to the following conditions:
52 | #
53 | # The above copyright notice and this permission notice shall be included in all
54 | # copies or substantial portions of the Software.
55 | #
56 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
57 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
58 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
59 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
60 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
61 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
62 | # SOFTWARE.
63 | #==================================================================================
64 | # Example 17
65 | #
66 |
67 | import qwiic_serlcd
68 | import time
69 | import sys
70 |
71 | old_address = 0x72 # default
72 | new_address = 0x71 # must be within 0x07 to 0x78, DEFAULT: 0x72
73 |
74 | def runExample():
75 |
76 | print("\nSparkFun Qwiic SerLCD Example 17\n")
77 | print("\nType CTRL+C to end.\n")
78 | myLCD = qwiic_serlcd.QwiicSerlcd(address=old_address)
79 |
80 | print("Attemping to connect to %s..." % hex(myLCD.address))
81 |
82 | if myLCD.connected == False:
83 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
84 | file=sys.stderr)
85 | return
86 | else:
87 | print("Connected!")
88 | myLCD.setBacklight(255, 255, 255) # bright white
89 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
90 | myLCD.begin() # call this for default settings (no
91 | myLCD.leftToRight()
92 | myLCD.noCursor()
93 | time.sleep(1) # give a sec for system messages to complete
94 |
95 | myLCD.clearScreen()
96 |
97 | myLCD.setAddress(new_address) # note this updates class member myLCD.address to the new_address
98 |
99 | if myLCD.connected == True:
100 | print("Address changed to %s successfully!" % hex(myLCD.address))
101 | myLCD.clearScreen()
102 | myLCD.print("My new add: %s" % hex(myLCD.address))
103 | else:
104 | print("Address change failed :(")
105 | while True:
106 | time.sleep(1) # do nothing
107 |
108 | if __name__ == '__main__':
109 | try:
110 | runExample()
111 | except (KeyboardInterrupt, SystemExit) as exErr:
112 | print("\nEnding Example 17")
113 | sys.exit(0)
114 |
115 |
116 |
--------------------------------------------------------------------------------
/examples/ex1_qwiic_serlcd_hello_world.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex1_qwiic_serlcd_hello_world.py
4 | #
5 | # Simple Example demonstrating how to print "hello world" and a counting number to the SerLCD (Qwiic).
6 | #------------------------------------------------------------------------
7 | #
8 | # Written by SparkFun Electronics, August 2020
9 | #
10 | # Ported from Arduino Library code with many contributions from
11 | # Gaston Williams - August 29, 2018
12 | #
13 | # This python library supports the SparkFun Electroncis qwiic
14 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
15 | # board computers.
16 | #
17 | # More information on qwiic is at https://www.sparkfun.com/qwiic
18 | #
19 | # Do you like this library? Help support SparkFun. Buy a board!
20 | #
21 | #==================================================================================
22 | # Copyright (c) 2020 SparkFun Electronics
23 | #
24 | # Permission is hereby granted, free of charge, to any person obtaining a copy
25 | # of this software and associated documentation files (the "Software"), to deal
26 | # in the Software without restriction, including without limitation the rights
27 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
28 | # copies of the Software, and to permit persons to whom the Software is
29 | # furnished to do so, subject to the following conditions:
30 | #
31 | # The above copyright notice and this permission notice shall be included in all
32 | # copies or substantial portions of the Software.
33 | #
34 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
35 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
36 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
37 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
38 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
39 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
40 | # SOFTWARE.
41 | #==================================================================================
42 | # Example 1
43 | #
44 |
45 | import qwiic_serlcd
46 | import time
47 | import sys
48 |
49 | def runExample():
50 |
51 | print("\nSparkFun Qwiic SerLCD Example 1\n")
52 | myLCD = qwiic_serlcd.QwiicSerlcd()
53 |
54 | if myLCD.connected == False:
55 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
56 | file=sys.stderr)
57 | return
58 |
59 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
60 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
61 | myLCD.clearScreen() # clear the screen - this moves the cursor to the home position as well
62 |
63 | time.sleep(1) # give a sec for system messages to complete
64 |
65 | myLCD.print("Hello World!")
66 | counter = 0
67 | while True:
68 | print("counter: %d" % counter)
69 | myLCD.setCursor(0,1)
70 | myLCD.print(str(counter))
71 | counter = counter + 1
72 | time.sleep(1)
73 |
74 | if __name__ == '__main__':
75 | try:
76 | runExample()
77 | except (KeyboardInterrupt, SystemExit) as exErr:
78 | print("\nEnding Example 1")
79 | sys.exit(0)
80 |
81 |
82 |
--------------------------------------------------------------------------------
/examples/ex2_qwiic_serlcd_backlight.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex2_qwiic_serlcd_backlight.py
4 | #
5 | # Simple Example demonstrating various backlight controls on the SerLCD (Qwiic).
6 | #
7 | # This sketch changes the backlight color and displays text using
8 | # the OpenLCD functions. This works with the original version of
9 | # SerLCD. See FastBacklight example for version 1.1 and later.
10 | #------------------------------------------------------------------------
11 | #
12 | # Written by SparkFun Electronics, August 2020
13 | #
14 | # Ported from Arduino Library code with many contributions from
15 | # Gaston Williams - August 29, 2018
16 | #
17 | # This python library supports the SparkFun Electroncis qwiic
18 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
19 | # board computers.
20 | #
21 | # More information on qwiic is at https://www.sparkfun.com/qwiic
22 | #
23 | # Do you like this library? Help support SparkFun. Buy a board!
24 | #
25 | #==================================================================================
26 | # Copyright (c) 2020 SparkFun Electronics
27 | #
28 | # Permission is hereby granted, free of charge, to any person obtaining a copy
29 | # of this software and associated documentation files (the "Software"), to deal
30 | # in the Software without restriction, including without limitation the rights
31 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
32 | # copies of the Software, and to permit persons to whom the Software is
33 | # furnished to do so, subject to the following conditions:
34 | #
35 | # The above copyright notice and this permission notice shall be included in all
36 | # copies or substantial portions of the Software.
37 | #
38 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
41 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
42 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
43 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
44 | # SOFTWARE.
45 | #==================================================================================
46 | # Example 2
47 | #
48 |
49 | import qwiic_serlcd
50 | import time
51 | import sys
52 |
53 | def runExample():
54 |
55 | print("\nSparkFun Qwiic SerLCD Example 2\n")
56 | myLCD = qwiic_serlcd.QwiicSerlcd()
57 |
58 | if myLCD.connected == False:
59 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
60 | file=sys.stderr)
61 | return
62 |
63 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
64 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
65 |
66 | time.sleep(1) # give a sec for system messages to complete
67 |
68 | while True:
69 | myLCD.setBacklight(0, 0, 0) # black is off
70 | myLCD.clearScreen() # Clear the display - this moves the cursor to home position as well
71 | myLCD.print("Black (off)")
72 | time.sleep(5)
73 |
74 | myLCD.setBacklight(255, 0, 0) # bright red
75 | myLCD.clearScreen()
76 | myLCD.print("Red")
77 | time.sleep(5)
78 |
79 | myLCD.setBacklight(0xFF, 0x8C, 0x00) # orange
80 | myLCD.clearScreen()
81 | myLCD.print("Orange")
82 | time.sleep(5)
83 |
84 | myLCD.setBacklight(255, 255, 0) # bright yellow
85 | myLCD.clearScreen()
86 | myLCD.print("Yellow")
87 | time.sleep(5)
88 |
89 | myLCD.setBacklight(0, 255, 0) # bright green
90 | myLCD.clearScreen()
91 | myLCD.print("Green")
92 | time.sleep(5)
93 |
94 | myLCD.setBacklight(0, 0, 255) # bright blue
95 | myLCD.clearScreen()
96 | myLCD.print("Blue")
97 | time.sleep(5)
98 |
99 | myLCD.setBacklight(0x4B, 0x00, 0x82) # indigo, a kind of dark purplish blue
100 | myLCD.clearScreen()
101 | myLCD.print("Indigo")
102 | time.sleep(5)
103 |
104 | myLCD.setBacklight(0xA0, 0x20, 0xF0) # violet
105 | myLCD.clearScreen()
106 | myLCD.print("Violet")
107 | time.sleep(5)
108 |
109 | myLCD.setBacklight(0x80, 0x80, 0x80) # grey
110 | myLCD.clearScreen()
111 | myLCD.print("Grey")
112 | time.sleep(5)
113 |
114 | myLCD.setBacklight(255, 255, 255) # bright white
115 | myLCD.clearScreen()
116 | myLCD.print("White")
117 | time.sleep(5)
118 |
119 | if __name__ == '__main__':
120 | try:
121 | runExample()
122 | except (KeyboardInterrupt, SystemExit) as exErr:
123 | print("\nEnding Example 2")
124 | sys.exit(0)
125 |
126 |
127 |
--------------------------------------------------------------------------------
/examples/ex3_qwiic_serlcd_set_cursor_position.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex3_qwiic_serlcd_set_cursor_position.py
4 | #
5 | # Simple Example demonstrating cursor posistion controls on the SerLCD (Qwiic).
6 | #
7 | # This sketch randomly picks a cursor position, goes to
8 | # that position using the setCursor() method, and prints a character
9 | #------------------------------------------------------------------------
10 | #
11 | # Written by SparkFun Electronics, August 2020
12 | #
13 | # Ported from Arduino Library code with many contributions from
14 | # Gaston Williams - August 29, 2018
15 | #
16 | # This python library supports the SparkFun Electroncis qwiic
17 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
18 | # board computers.
19 | #
20 | # More information on qwiic is at https://www.sparkfun.com/qwiic
21 | #
22 | # Do you like this library? Help support SparkFun. Buy a board!
23 | #
24 | #==================================================================================
25 | # Copyright (c) 2020 SparkFun Electronics
26 | #
27 | # Permission is hereby granted, free of charge, to any person obtaining a copy
28 | # of this software and associated documentation files (the "Software"), to deal
29 | # in the Software without restriction, including without limitation the rights
30 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
31 | # copies of the Software, and to permit persons to whom the Software is
32 | # furnished to do so, subject to the following conditions:
33 | #
34 | # The above copyright notice and this permission notice shall be included in all
35 | # copies or substantial portions of the Software.
36 | #
37 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
38 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
39 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
40 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
41 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
42 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
43 | # SOFTWARE.
44 | #==================================================================================
45 | # Example 3
46 | #
47 |
48 | import qwiic_serlcd
49 | import time
50 | import sys
51 | import random
52 |
53 |
54 | def runExample():
55 |
56 | print("\nSparkFun Qwiic SerLCD Example 3\n")
57 | myLCD = qwiic_serlcd.QwiicSerlcd()
58 |
59 | if myLCD.connected == False:
60 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
61 | file=sys.stderr)
62 | return
63 |
64 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
65 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
66 | myLCD.clearScreen()
67 |
68 | time.sleep(1) # give a sec for system messages to complete
69 |
70 | # These constants won't change. But you can change the size of
71 | # your LCD using them:
72 | numRows = 2
73 | # numRows = 4
74 | numCols = 16
75 | # numCols = 20
76 |
77 | thisLetter = "a"
78 |
79 | while True:
80 | randomColumn = random.randint(0, numCols)
81 | randomRow = random.randint(0, numRows)
82 |
83 | # set the cursor position:
84 | myLCD.setCursor(randomColumn, randomRow)
85 |
86 | # print the letter:
87 | myLCD.print(thisLetter) # print to screen
88 | time.sleep(0.2)
89 |
90 | thisLetter = chr(ord(thisLetter) + 1)
91 | if thisLetter > "z":
92 | thisLetter = "a" # Wrap the variable
93 |
94 | if __name__ == '__main__':
95 | try:
96 | runExample()
97 | except (KeyboardInterrupt, SystemExit) as exErr:
98 | print("\nEnding Example 3")
99 | sys.exit(0)
100 |
101 |
102 |
--------------------------------------------------------------------------------
/examples/ex4_qwiic_serlcd_move_cursor.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex4_qwiic_serlcd_move_cursor.py
4 | #
5 | # Simple Example demonstrating the move cursor controls on the SerLCD (Qwiic).
6 | #
7 | # This example displays text and then moves the cursor back and forth. These
8 | # functions are not usually part of the LiquidCrystal library, but these functions
9 | # are available in the Serial OpenLCD display.
10 | #------------------------------------------------------------------------
11 | #
12 | # Written by SparkFun Electronics, August 2020
13 | #
14 | # Ported from Arduino Library code with many contributions from
15 | # Gaston Williams - August 29, 2018
16 | #
17 | # This python library supports the SparkFun Electroncis qwiic
18 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
19 | # board computers.
20 | #
21 | # More information on qwiic is at https://www.sparkfun.com/qwiic
22 | #
23 | # Do you like this library? Help support SparkFun. Buy a board!
24 | #
25 | #==================================================================================
26 | # Copyright (c) 2020 SparkFun Electronics
27 | #
28 | # Permission is hereby granted, free of charge, to any person obtaining a copy
29 | # of this software and associated documentation files (the "Software"), to deal
30 | # in the Software without restriction, including without limitation the rights
31 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
32 | # copies of the Software, and to permit persons to whom the Software is
33 | # furnished to do so, subject to the following conditions:
34 | #
35 | # The above copyright notice and this permission notice shall be included in all
36 | # copies or substantial portions of the Software.
37 | #
38 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
41 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
42 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
43 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
44 | # SOFTWARE.
45 | #==================================================================================
46 | # Example 4
47 | #
48 |
49 | import qwiic_serlcd
50 | import time
51 | import sys
52 |
53 | def runExample():
54 |
55 | print("\nSparkFun Qwiic SerLCD Example 4\n")
56 | myLCD = qwiic_serlcd.QwiicSerlcd()
57 |
58 | if myLCD.connected == False:
59 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
60 | file=sys.stderr)
61 | return
62 |
63 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
64 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
65 | myLCD.clearScreen()
66 | myLCD.cursor() # Turn on the underline cursor
67 |
68 | time.sleep(1) # give a sec for system messages to complete
69 | myLCD.print("Watch the cursor!")
70 |
71 | while True:
72 | # move cursor left with three function calls
73 | myLCD.moveCursorLeft()
74 | time.sleep(0.5)
75 | myLCD.moveCursorLeft()
76 | time.sleep(0.5)
77 | myLCD.moveCursorLeft()
78 | time.sleep(0.5)
79 |
80 | # move curor right three spaces in one function call
81 | myLCD.moveCursorRight(3) # notice the optional count argument of "3"
82 | time.sleep(0.5)
83 |
84 | # move cursor left three spaces in one function call
85 | myLCD.moveCursorLeft(3)
86 | time.sleep(0.5)
87 |
88 | # move cursor right with three function calls
89 | myLCD.moveCursorRight()
90 | time.sleep(0.5)
91 | myLCD.moveCursorRight()
92 | time.sleep(0.5)
93 | myLCD.moveCursorRight()
94 | time.sleep(0.5)
95 |
96 | if __name__ == '__main__':
97 | try:
98 | runExample()
99 | except (KeyboardInterrupt, SystemExit) as exErr:
100 | print("\nEnding Example 4")
101 | sys.exit(0)
102 |
103 |
104 |
--------------------------------------------------------------------------------
/examples/ex5_qwiic_serlcd_enable_cursor.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex5_qwiic_serlcd_enable_cursor.py
4 | #
5 | # Simple Example demonstrating the enable and disable cursor controls on the SerLCD (Qwiic).
6 | #
7 | # This example prints "Hello World!" to the LCD and
8 | # uses the cursor() and noCursor() methods to turn
9 | # on and off the cursor.
10 | #------------------------------------------------------------------------
11 | #
12 | # Written by SparkFun Electronics, August 2020
13 | #
14 | # Ported from Arduino Library code with many contributions from
15 | # Gaston Williams - August 29, 2018
16 | #
17 | # This python library supports the SparkFun Electroncis qwiic
18 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
19 | # board computers.
20 | #
21 | # More information on qwiic is at https://www.sparkfun.com/qwiic
22 | #
23 | # Do you like this library? Help support SparkFun. Buy a board!
24 | #
25 | #==================================================================================
26 | # Copyright (c) 2020 SparkFun Electronics
27 | #
28 | # Permission is hereby granted, free of charge, to any person obtaining a copy
29 | # of this software and associated documentation files (the "Software"), to deal
30 | # in the Software without restriction, including without limitation the rights
31 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
32 | # copies of the Software, and to permit persons to whom the Software is
33 | # furnished to do so, subject to the following conditions:
34 | #
35 | # The above copyright notice and this permission notice shall be included in all
36 | # copies or substantial portions of the Software.
37 | #
38 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
41 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
42 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
43 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
44 | # SOFTWARE.
45 | #==================================================================================
46 | # Example 5
47 | #
48 |
49 | import qwiic_serlcd
50 | import time
51 | import sys
52 |
53 | def runExample():
54 |
55 | print("\nSparkFun Qwiic SerLCD Example 5\n")
56 | myLCD = qwiic_serlcd.QwiicSerlcd()
57 |
58 | if myLCD.connected == False:
59 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
60 | file=sys.stderr)
61 | return
62 |
63 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
64 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
65 | myLCD.clearScreen()
66 | myLCD.cursor() # Turn on the underline cursor
67 |
68 | time.sleep(1) # give a sec for system messages to complete
69 | myLCD.print("Hello World!")
70 |
71 | while True:
72 | # turn off the cursor
73 | print("Cursor OFF")
74 | myLCD.noCursor()
75 | time.sleep(1)
76 |
77 | # turn on the cursor
78 | print("Cursor ON")
79 |
80 | myLCD.cursor()
81 | time.sleep(1)
82 |
83 | if __name__ == '__main__':
84 | try:
85 | runExample()
86 | except (KeyboardInterrupt, SystemExit) as exErr:
87 | print("\nEnding Example 5")
88 | sys.exit(0)
89 |
90 |
91 |
--------------------------------------------------------------------------------
/examples/ex6_qwiic_serlcd_blink_cursor.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex6_qwiic_serlcd_blink_cursor.py
4 | #
5 | # Simple example demonstrating the blinking cursor controls on the SerLCD (Qwiic).
6 | #
7 | # This example prints "Hello World!" to the LCD and
8 | # uses the blink() and noBlink() methods to turn
9 | # on and off the blinking.
10 | #------------------------------------------------------------------------
11 | #
12 | # Written by SparkFun Electronics, August 2020
13 | #
14 | # Ported from Arduino Library code with many contributions from
15 | # Gaston Williams - August 29, 2018
16 | #
17 | # This python library supports the SparkFun Electroncis qwiic
18 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
19 | # board computers.
20 | #
21 | # More information on qwiic is at https://www.sparkfun.com/qwiic
22 | #
23 | # Do you like this library? Help support SparkFun. Buy a board!
24 | #
25 | #==================================================================================
26 | # Copyright (c) 2020 SparkFun Electronics
27 | #
28 | # Permission is hereby granted, free of charge, to any person obtaining a copy
29 | # of this software and associated documentation files (the "Software"), to deal
30 | # in the Software without restriction, including without limitation the rights
31 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
32 | # copies of the Software, and to permit persons to whom the Software is
33 | # furnished to do so, subject to the following conditions:
34 | #
35 | # The above copyright notice and this permission notice shall be included in all
36 | # copies or substantial portions of the Software.
37 | #
38 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
41 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
42 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
43 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
44 | # SOFTWARE.
45 | #==================================================================================
46 | # Example 6
47 | #
48 |
49 | import qwiic_serlcd
50 | import time
51 | import sys
52 |
53 | def runExample():
54 |
55 | print("\nSparkFun Qwiic SerLCD Example 6\n")
56 | myLCD = qwiic_serlcd.QwiicSerlcd()
57 |
58 | if myLCD.connected == False:
59 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
60 | file=sys.stderr)
61 | return
62 |
63 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
64 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
65 | myLCD.clearScreen()
66 | myLCD.cursor() # Turn on the underline cursor
67 |
68 | time.sleep(1) # give a sec for system messages to complete
69 | myLCD.print("Hello World!")
70 |
71 | while True:
72 | # turn off the blinking cursor
73 | print("Cursor blinking OFF")
74 | myLCD.noBlink()
75 | time.sleep(5)
76 |
77 | # turn on the blinking cursor
78 | print("Cursor blinking ON")
79 | myLCD.blink()
80 | time.sleep(5)
81 |
82 | if __name__ == '__main__':
83 | try:
84 | runExample()
85 | except (KeyboardInterrupt, SystemExit) as exErr:
86 | print("\nEnding Example 6")
87 | sys.exit(0)
88 |
89 |
90 |
--------------------------------------------------------------------------------
/examples/ex7_qwiic_serlcd_scroll.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex7_qwiic_serlcd_scroll.py
4 | #
5 | # Simple example demonstrating the scroll controls on the SerLCD (Qwiic).
6 | #
7 | # This example prints "Hello World!" to the LCD and uses the
8 | # scrollDisplayLeft() and scrollDisplayRight() methods to scroll
9 | # the text.
10 | #------------------------------------------------------------------------
11 | #
12 | # Written by SparkFun Electronics, August 2020
13 | #
14 | # Ported from Arduino Library code with many contributions from
15 | # Gaston Williams - August 29, 2018
16 | #
17 | # This python library supports the SparkFun Electroncis qwiic
18 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
19 | # board computers.
20 | #
21 | # More information on qwiic is at https://www.sparkfun.com/qwiic
22 | #
23 | # Do you like this library? Help support SparkFun. Buy a board!
24 | #
25 | #==================================================================================
26 | # Copyright (c) 2020 SparkFun Electronics
27 | #
28 | # Permission is hereby granted, free of charge, to any person obtaining a copy
29 | # of this software and associated documentation files (the "Software"), to deal
30 | # in the Software without restriction, including without limitation the rights
31 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
32 | # copies of the Software, and to permit persons to whom the Software is
33 | # furnished to do so, subject to the following conditions:
34 | #
35 | # The above copyright notice and this permission notice shall be included in all
36 | # copies or substantial portions of the Software.
37 | #
38 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
41 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
42 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
43 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
44 | # SOFTWARE.
45 | #==================================================================================
46 | # Example 7
47 | #
48 |
49 | import qwiic_serlcd
50 | import time
51 | import sys
52 |
53 | def runExample():
54 |
55 | print("\nSparkFun Qwiic SerLCD Example 7\n")
56 | myLCD = qwiic_serlcd.QwiicSerlcd()
57 |
58 | if myLCD.connected == False:
59 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
60 | file=sys.stderr)
61 | return
62 |
63 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
64 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
65 | myLCD.clearScreen()
66 |
67 | time.sleep(1) # give a sec for system messages to complete
68 | myLCD.print("Hello World!")
69 |
70 | while True:
71 | # scroll 13 positions (string length) to the left
72 | # to move it offscreen left:
73 | for i in range(13):
74 | myLCD.scrollDisplayLeft() # scroll one position left
75 | time.sleep(0.15) # wait a bit
76 |
77 | # scroll 29 positions (string length + display length) to the right
78 | # to move it offscreen right:
79 | for i in range(29):
80 | myLCD.scrollDisplayRight() # scroll one position right
81 | time.sleep(0.15) # wait a bit
82 |
83 | # scroll 16 positions (display length + string length) to the left
84 | # to move it back to center:
85 | for i in range(16):
86 | myLCD.scrollDisplayLeft() # scroll one position left
87 | time.sleep(0.15) # wait a bit
88 |
89 | time.sleep(1) # delay at the end of the full loop
90 |
91 | if __name__ == '__main__':
92 | try:
93 | runExample()
94 | except (KeyboardInterrupt, SystemExit) as exErr:
95 | print("\nEnding Example 7")
96 | sys.exit(0)
97 |
98 |
99 |
--------------------------------------------------------------------------------
/examples/ex8_qwiic_serlcd_autoscroll_with_text.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex8_qwiic_serlcd_autoscroll_with_text.py
4 | #
5 | # Simple example demonstrating the autoscroll feature on the SerLCD (Qwiic).
6 | #
7 | # This example demonstrates the use of the autoscroll()
8 | # and noAutoscroll() functions to make new text scroll or not.
9 | #------------------------------------------------------------------------
10 | #
11 | # Written by SparkFun Electronics, August 2020
12 | #
13 | # Ported from Arduino Library code with many contributions from
14 | # Gaston Williams - August 29, 2018
15 | #
16 | # This python library supports the SparkFun Electroncis qwiic
17 | # qwiic sensor/board ecosystem on a Raspberry Pi (and compatable) single
18 | # board computers.
19 | #
20 | # More information on qwiic is at https://www.sparkfun.com/qwiic
21 | #
22 | # Do you like this library? Help support SparkFun. Buy a board!
23 | #
24 | #==================================================================================
25 | # Copyright (c) 2020 SparkFun Electronics
26 | #
27 | # Permission is hereby granted, free of charge, to any person obtaining a copy
28 | # of this software and associated documentation files (the "Software"), to deal
29 | # in the Software without restriction, including without limitation the rights
30 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
31 | # copies of the Software, and to permit persons to whom the Software is
32 | # furnished to do so, subject to the following conditions:
33 | #
34 | # The above copyright notice and this permission notice shall be included in all
35 | # copies or substantial portions of the Software.
36 | #
37 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
38 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
39 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
40 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
41 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
42 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
43 | # SOFTWARE.
44 | #==================================================================================
45 | # Example 8
46 | #
47 |
48 | import qwiic_serlcd
49 | import time
50 | import sys
51 |
52 | def runExample():
53 |
54 | print("\nSparkFun Qwiic SerLCD Example 8\n")
55 | myLCD = qwiic_serlcd.QwiicSerlcd()
56 |
57 | if myLCD.connected == False:
58 | print("The Qwiic SerLCD device isn't connected to the system. Please check your connection", \
59 | file=sys.stderr)
60 | return
61 |
62 | myLCD.setBacklight(255, 255, 255) # Set backlight to bright white
63 | myLCD.setContrast(5) # set contrast. Lower to 0 for higher contrast.
64 | myLCD.begin() # call this for default settings (no
65 | myLCD.leftToRight()
66 | time.sleep(1) # give a sec for system messages to complete
67 |
68 | while True:
69 | myLCD.setCursor(0, 0) # set the cursor to (0,0)
70 |
71 | for thisChar in range(10): # print from 0 to 9
72 | myLCD.print(str(thisChar))
73 | time.sleep(0.5)
74 |
75 | myLCD.autoscroll() # set the display to automatically scroll
76 |
77 | for thisChar in range(0,10): # print from 0 to 9
78 | myLCD.setCursor(10+thisChar,1)
79 | myLCD.print(str(thisChar))
80 | time.sleep(0.5)
81 |
82 | myLCD.noAutoscroll() # turn off automatic scrolling
83 | myLCD.clearScreen() # clear screen for the next loop
84 |
85 | if __name__ == '__main__':
86 | try:
87 | runExample()
88 | except (KeyboardInterrupt, SystemExit) as exErr:
89 | print("\nEnding Example 8")
90 | sys.exit(0)
91 |
92 |
93 |
--------------------------------------------------------------------------------
/examples/ex9_qwiic_serlcd_custom_character.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | #-----------------------------------------------------------------------------
3 | # ex9_qwiic_serlcd_custom_character.py
4 | #
5 | # This example prints "I |
98 | $projectname
99 | $projectnumber
101 |
102 |
103 | $projectbrief
104 | |
105 |
106 |
107 |
108 |
109 | $projectbrief
110 | |
111 |
112 |
113 |
114 |
115 | $searchbox | 116 | 117 | 118 |