Update documentation for CFontzPacket changes.
This commit is contained in:
@@ -6,6 +6,14 @@ This section talks about using LCDproc with LCD displays that use the
|
|||||||
CFontz633 chipset.
|
CFontz633 chipset.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
<warning>
|
||||||
|
<para>
|
||||||
|
This driver is deprecated. Please use the <code>CFontzPacket</code> driver
|
||||||
|
with <literal>Model=633</literal> instead. This driver will be removed in
|
||||||
|
a future version.
|
||||||
|
</para>
|
||||||
|
</warning>
|
||||||
|
|
||||||
<!-- ## CrystalFontz633 driver (for CF633 only) ## -->
|
<!-- ## CrystalFontz633 driver (for CF633 only) ## -->
|
||||||
<sect2 id="CFontz633-config">
|
<sect2 id="CFontz633-config">
|
||||||
<title>Configuration in LCDd.conf</title>
|
<title>Configuration in LCDd.conf</title>
|
||||||
@@ -22,7 +30,6 @@ CFontz633 chipset.
|
|||||||
<listitem><para>
|
<listitem><para>
|
||||||
Select the output device to use [default: <filename>/dev/lcd</filename>]
|
Select the output device to use [default: <filename>/dev/lcd</filename>]
|
||||||
may be serial device or USB device in serial emulation mode.
|
may be serial device or USB device in serial emulation mode.
|
||||||
|
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
|||||||
@@ -21,6 +21,8 @@ Currently this line of modules comprises the models:
|
|||||||
<listitem><para>keypad with 4 keys: Up, Down, enter & Escape</para></listitem>
|
<listitem><para>keypad with 4 keys: Up, Down, enter & Escape</para></listitem>
|
||||||
<listitem><para>USB connection for data and power</para></listitem>
|
<listitem><para>USB connection for data and power</para></listitem>
|
||||||
<listitem><para>mounting bracket to fit into 3,5" drive bays</para></listitem>
|
<listitem><para>mounting bracket to fit into 3,5" drive bays</para></listitem>
|
||||||
|
<listitem><para>Optional (via add-on board) temperature sensor, fan and
|
||||||
|
ATX power control connectors (all unsupported by LCDproc)</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -29,10 +31,25 @@ Currently this line of modules comprises the models:
|
|||||||
<term>CFA-633</term>
|
<term>CFA-633</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>16x2 character LCDi with backlight</para></listitem>
|
<listitem><para>16x2 character LCD with backlight</para></listitem>
|
||||||
<listitem><para>keypad with 6 keys: 4 directions, Enter & Escape</para></listitem>
|
<listitem><para>keypad with 6 keys: 4 directions, Enter & Escape</para></listitem>
|
||||||
<listitem><para>serial or USB connection</para></listitem>
|
<listitem><para>serial or USB connection</para></listitem>
|
||||||
<listitem><para>mounting bracket to fit into 5,25" drive bays</para></listitem>
|
<listitem><para>mounting bracket to fit into 5,25" drive bays</para></listitem>
|
||||||
|
<listitem><para>Temperature sensor and fan control connectors (both
|
||||||
|
unsupported by LCDproc)</para></listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>CFA-533</term>
|
||||||
|
<listitem>
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>This is the same as CFA-633 except it misses the fan control
|
||||||
|
capabilities. The temperature monitoring is not supported in LCDproc
|
||||||
|
though.</para>
|
||||||
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@@ -41,7 +58,7 @@ Currently this line of modules comprises the models:
|
|||||||
<term>CFA-635</term>
|
<term>CFA-635</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>20x4 characters LCDi with backlight</para></listitem>
|
<listitem><para>20x4 characters LCD with backlight</para></listitem>
|
||||||
<listitem><para>keypad with 6 keys: 4 directions, Enter & Escape</para></listitem>
|
<listitem><para>keypad with 6 keys: 4 directions, Enter & Escape</para></listitem>
|
||||||
<listitem><para>USB connection for data and power</para></listitem>
|
<listitem><para>USB connection for data and power</para></listitem>
|
||||||
<listitem><para>four bi-color LEDs to show status information</para></listitem>
|
<listitem><para>four bi-color LEDs to show status information</para></listitem>
|
||||||
@@ -52,7 +69,7 @@ Currently this line of modules comprises the models:
|
|||||||
</variablelist>
|
</variablelist>
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<!-- ## CrystalFontz packet driver (for CF631, CF633 & CF635) ## -->
|
<!-- ## CrystalFontz packet driver ## -->
|
||||||
<sect2 id="CFontzPacket-config">
|
<sect2 id="CFontzPacket-config">
|
||||||
<title>Configuration in LCDd.conf</title>
|
<title>Configuration in LCDd.conf</title>
|
||||||
|
|
||||||
@@ -64,6 +81,7 @@ Currently this line of modules comprises the models:
|
|||||||
<term>
|
<term>
|
||||||
<property>Model</property> =
|
<property>Model</property> =
|
||||||
{
|
{
|
||||||
|
<parameter><literal>533</literal></parameter> |
|
||||||
<parameter><literal>631</literal></parameter> |
|
<parameter><literal>631</literal></parameter> |
|
||||||
<emphasis><parameter><literal>633</literal></parameter></emphasis> |
|
<emphasis><parameter><literal>633</literal></parameter></emphasis> |
|
||||||
<parameter><literal>635</literal></parameter>
|
<parameter><literal>635</literal></parameter>
|
||||||
@@ -72,6 +90,7 @@ Currently this line of modules comprises the models:
|
|||||||
<listitem><para>
|
<listitem><para>
|
||||||
Select the LCD model that is connected.
|
Select the LCD model that is connected.
|
||||||
Legal values for this option are <literal>631</literal>,
|
Legal values for this option are <literal>631</literal>,
|
||||||
|
<literal>533</literal>,
|
||||||
<literal>633</literal>, or <literal>635</literal>,
|
<literal>633</literal>, or <literal>635</literal>,
|
||||||
with the default being <literal>633</literal>.
|
with the default being <literal>633</literal>.
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
@@ -97,15 +116,27 @@ Currently this line of modules comprises the models:
|
|||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>
|
||||||
|
<property>USB</property> = ¶meters.yesnodef;
|
||||||
|
</term>
|
||||||
|
<listitem><para>
|
||||||
|
Enable this flag if the device is connected to an USB port. For serial ports
|
||||||
|
leave it disabled. [default: <literal>no</literal>; legal: <literal>yes</literal>,
|
||||||
|
<literal>no</literal>]
|
||||||
|
</para></listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>
|
<term>
|
||||||
<property>Size</property> = ¶meters.size;
|
<property>Size</property> = ¶meters.size;
|
||||||
</term>
|
</term>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
Select the LCD size [default: depending on model: 635: <literal>20x4</literal>,
|
Select the LCD size. This overrides the size the driver uses for the
|
||||||
631: <literal>20x2</literal>,
|
selected model (631: <literal>20x2</literal>, 533/633: <literal>16x2</literal>,
|
||||||
633: <literal>16x2</literal>]
|
635: <literal>20x4</literal>).</para>
|
||||||
</para></listitem>
|
<note><para>You should usually not need to set this value!</para></note>
|
||||||
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
@@ -146,27 +177,30 @@ Currently this line of modules comprises the models:
|
|||||||
<term>
|
<term>
|
||||||
<property>Speed</property> =
|
<property>Speed</property> =
|
||||||
{
|
{
|
||||||
<parameter><literal>1200</literal></parameter> |
|
|
||||||
<parameter><literal>2400</literal></parameter> |
|
|
||||||
<parameter><literal>9600</literal></parameter> |
|
|
||||||
<parameter><literal>19200</literal></parameter> |
|
<parameter><literal>19200</literal></parameter> |
|
||||||
<parameter><literal>115200</literal></parameter>
|
<parameter><literal>115200</literal></parameter>
|
||||||
}
|
}
|
||||||
</term>
|
</term>
|
||||||
<listitem><para>
|
<listitem>
|
||||||
Set the the baud rate for communication with the LCD.
|
<para>
|
||||||
If not specified, the default depends on the model: it is <literal>9600</literal>
|
Override the default baud rate the driver uses for communication with the
|
||||||
for the CFA633 and <literal>115200</literal> for the CFA631 and CFA635.
|
selected LCD model. Allowed values are <literal>19200</literal> (default for
|
||||||
</para></listitem>
|
CFA-533 and CFA-633) and <literal>115200</literal> (default for the CFA631
|
||||||
|
and CFA635).
|
||||||
|
</para>
|
||||||
|
<note><para>You should usually not need to set this value!</para></note>
|
||||||
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>
|
<term>
|
||||||
<property>NewFirmware</property> = ¶meters.yesnodef;
|
<property>OldFirmware</property> = ¶meters.yesnodef;
|
||||||
</term>
|
</term>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
Set the firmware version (<emphasis>New</emphasis> means >= 2.0) [default: <literal>no</literal>; legal: <literal>yes</literal>, <literal>no</literal>]
|
Very old 633 firmware versions do not support partial screen updates using
|
||||||
Currently this flag is not in use, there is no such thing as NewFirmware. ;=)
|
'Send Data to LCD' command (31). For those devices it may be necessary to
|
||||||
|
enable this flag. [default: <literal>no</literal>; legal: <literal>yes</literal>,
|
||||||
|
<literal>no</literal>]
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
@@ -175,8 +209,8 @@ Currently this line of modules comprises the models:
|
|||||||
<property>Reboot</property> = ¶meters.yesnodef;
|
<property>Reboot</property> = ¶meters.yesnodef;
|
||||||
</term>
|
</term>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
Reinitialize the LCD's BIOS [default: <literal>no</literal>; legal: <literal>yes</literal>, <literal>no</literal>]
|
Reinitialize the LCD's BIOS [default: <literal>no</literal>; legal:
|
||||||
I want to reboot the LCD to make sure we start from a known state
|
<literal>yes</literal>, <literal>no</literal>].
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
</variablelist>
|
</variablelist>
|
||||||
|
|||||||
@@ -280,7 +280,7 @@ CFontzPacket_init (Driver *drvthis)
|
|||||||
tmp = drvthis->config_get_int(drvthis->name, "Speed", 0, p->model_desc->speed);
|
tmp = drvthis->config_get_int(drvthis->name, "Speed", 0, p->model_desc->speed);
|
||||||
debug(RPT_INFO, "%s: Speed (in config) is '%d'", __FUNCTION__, tmp);
|
debug(RPT_INFO, "%s: Speed (in config) is '%d'", __FUNCTION__, tmp);
|
||||||
if ((tmp != 19200) && (tmp != 115200)) {
|
if ((tmp != 19200) && (tmp != 115200)) {
|
||||||
report(RPT_WARNING, "%s: Speed must be 19200 or 11500; using default %d",
|
report(RPT_WARNING, "%s: Speed must be 19200 or 115200; using default %d",
|
||||||
drvthis->name, p->model_desc->speed);
|
drvthis->name, p->model_desc->speed);
|
||||||
tmp = p->model_desc->speed;
|
tmp = p->model_desc->speed;
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user