File: LCD.man

package info (click to toggle)
owfs 3.2p3+dfsg1-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster
  • size: 8,688 kB
  • sloc: ansic: 65,085; pascal: 5,957; tcl: 2,688; makefile: 1,357; python: 1,114; sh: 891; cs: 623; php: 600; perl: 587; java: 404; ruby: 289; cpp: 105; asm: 102; xml: 53
file content (155 lines) | stat: -rw-r--r-- 3,619 bytes parent folder | download | duplicates (2)
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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
'\"
'\" Copyright (c) 2003-2004 Paul H Alfille, MD
'\" (paul.alfille@gmail.com)
'\"
'\" Device manual page for the OWFS -- 1-wire filesystem package
'\" Based on Dallas Semiconductor, Inc's datasheets, and trial and error.
'\"
'\" Free for all use. No warranty. None. Use at your own risk.
'\"
.TH LCD 3  2003 "OWFS Manpage" "One-Wire File System"
.SH NAME
.B LCD
\- LCD controller
.SH SYNOPSIS
1-wire LCD controller by Louis Swart
.PP
.B FF
[.]XXXXXXXXXXXX[XX][/[
.B backlight
|
.B counters.[0-3|ALL]
|
.B cumulative.[0-3|ALL]
|
.B branch.[0-1|ALL]
|
.B data
|
.B gpio.[0-3|ALL]
|
.B LCDon
|
.B line16.[0-3|ALL]
|
.B line20.[0-3|ALL]
|
.B line40.[0|1|ALL]
|
.B memory
|
.B register
|
.B screen16
|
.B screen20
|
.B screen40
|
.B version
|
.so man3/standard_mini.3so
]]
.SH FAMILY CODE
.PP
.I FF
.SH SPECIAL PROPERTIES
.SS backlight
.I write-only,yes-no
.br
Write a non-zero value to turn on the LCD backlight. Write zero to turn off.
.SS counters[0-3,ALL]
.I read-only,unsigned integer
.br
Read the number of times the gpio has been externally changed. If wired to a push switch, will count twice per button press. The LCD firmware resets all the counter when any one is read. Use the
.I ALL
extension to read them all, simultaneously, or use the
.I cumulative
property instead.
.br
.I ALL
is an aggregate of the properties, comma separated. Read atomically.
.SS cumulative[0-3,ALL]
.I read-write,unsigned integer
.br
Cumulative sum of the
.I counters
property. To reset, write a zero. The cumulative counter can have any value written, which allows preservation of counts across program restarts if the value at program termination is stored.
.br
Reading
.I cumulative
will reset the
.I counters
property. All the cumulative counters will be updated so that no counts will be lost. Reads of
.I counters
can be interspersed without losing
.I cumulative
accuracy.
.br
Note:
.I cumulative
requires the
.I caching
system be compiled into libow.
.br
.I ALL
is an aggregate of the properties, comma separated.
.SS data
.I read-write,unsigned int
.br
Contents of the LCD data byte (see datasheet). Not usually needed.
.SS LCDon
.I write-only,yes-no
.br
Write a non-zero value to turn on the LCD screen (also clears). Write a zero to turn off.
.SS line16[0-3,ALL] line20[0-3,ALL] line40[0-1,ALL]
.I write-only,ascii
.br
Write text to the LCD screen. Assumes 16/20/40 char width. (Cannot be determined from controller).
.br
.I ALL
is an aggregate of the properties, comma separated. Each is set in turn.
.SS memory
.I read-write,binary
.br
112 bytes of on-board memory.
.SS register
.I read-write,unsigned int
.br
Contents of the LCD register (see datasheet). Not usually needed.
.SS screen16 screen20 screen40
.I write-only,ascii
.br
Write text to the LCD screen. Assumes 16/20/40 char width. (Cannot be determined from controller).
.br
.SS version
.I read-only,ascii
.br
Self-reported LCD controller version. 16 bytes.
.SH STANDARD PROPERTIES
.so man3/standard.3so
.SH ALARMS
None implemented.
.SH DESCRIPTION
.so man3/description.3so
.SS LCD
The
.B LCD (3)
controller is a microprocessor driven device that simulates the operation of 1-wire devices. It's creator has arbitrarily chosen the
.I family code
FF. The controller requires external power. Full details are available from the designer.
.br
The main draw of the
.B LCD
controller is as any easy way to provide output to users.
.SH ADDRESSING
.so man3/addressing.3so
.SH DATASHEET
.br
Available from http://www.louisswart.co.za/1-Wire_index.html
.SH SEE ALSO
.so man3/seealso.3so
.SH AVAILABILITY
http://www.owfs.org
.SH AUTHOR
Paul Alfille (paul.alfille@gmail.com)