-
Notifications
You must be signed in to change notification settings - Fork 13
/
Copy pathreadme.txt
140 lines (80 loc) · 4.1 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
LedDisplay Library
For details, see http://www.arduino.cc/playground/Main/LedDisplay
This library allows you to send text to an Avago HCMS-29xx LED display. The HCMS 29xx displays are pretty little displays that contain a row of 5x7 LED matrices.
The displays have a synchronous serial interface. You'll need five digital output lines to control them. The pins are as follows:
* data - bits in from the microcontroller
* register select - selects whether you're sending display data or control data
* clock - timing clock from the microcontroller
* enable - enables or disables the display
* reset - resets the display
The library manages all the necessary pin control and data shifting for you.
Methods:
LedDisplay(int dataPin, int registerSelect, int clockPin, int chipEnable, int resetPin, int displayLength) - instantiates the library. The first five parameters are the Arduino pin numbers that are connected to the display. The last sets the length of the display (8 for the HCMS-291x and HCMS-297x, 4 for the HCMS-290x and 296x).
example:
LedDisplay myDisplay = LedDisplay(2,3,4,5,6,8);
begin() - initializes and resets the display.
example:
myDisplay.begin();
Printing methods
write(char whatCharacter, byte whatPosition) - writes a single character to the display at a particular position
example:
myDisplay.write('A', 4);
LedDisplay inherits all the print() and println() methods from the Print library, so you can use those methods to print to the display, as long as what you print fits within the display. For example here's how to print the millis and a title string to the display:
myDisplay.print("ms:");
myDisplay.print(millis());
You can also do the usual Print things, like:
int myInt = 12;
myDisplay.print(myInt, DEC);
// or
myDisplay.print(myInt, HEX);
Scrolling methods
If you want to be able to automatically scroll a string of text, you need to use the setString() method first. This method stores a character string in the library instance, so you can then use the scroll() method to move it left and right.
setString(char* stringToDisplay) - displays a string on the display. If the string is longer than the display, the beginning of the string is displayed. You can use the scroll() method to step the string forward on the display.
getString() - returns the string to display.
example:
// print out the display string for debugging:
Serial.println(myDisplay.getString());
stringLength() - returns the length of the display string. See the scrolling example below for usage.
scroll(int direction) - scrolls the display using the string set by setString(). Negative numbers scroll left, positive numbers scroll right.
example:
...
void setup() {
...
// scroll a string that's longer than the display:
myDisplay.setString("This is a very long string");
}
void loop() {
// when the string scrolls off the display, reverse scroll direction.
// On the right, it scrolls off at position 8.
// on the left, it scrolls off when the cursor is less than -(the length of the string):
if ((myDisplay.cursorPosition() > displayLength) ||
(myDisplay.cursorPosition() <= -(myDisplay.stringLength()))) {
myDirection = -myDirection;
delay(1000);
}
// scroll:
myDisplay.scroll(myDirection);
delay(100);
}
Cursor control methods
clear() - clear the display.
example:
myDisplay.clear();
home() - set cursor to far left hand position.
example:
myDisplay.home();
setCursor(int whichPosition) - set cursor to any position.
example:
myDisplay.serCursor(4);
getCursor() - get the cursor position.
example:
int cursorPosition = myDisplay.getCursor();
Display Control methods
setBrightness(int bright) - lets you set the brightness from 0 to 15.
example:
myDisplay.setBrightness(15);
If you want to set the opcodes of the display directly (you can learn them from the data sheet), the following methods will do the trick.
loadControlRegister(int dataByte) - sends 8 bits to one of the control registers.
loadDotRegister() - sends 320 bits to the dot register
Version method
version() - returns the version number of the library.