#
# $Id: README.MatrixOrbital,v 1.2 2000/03/22 07:33:50 reinelt Exp $
#

This is the README file for the MatrixOrbital display driver for lcd4linux

This driver supports the serial interface alphanumeric display modules by
Matrix Orbital Corporation (http://www.matrixorbital.com).

I could only test it with the LCD2041 model, but I think every other (LCD) model 
should work. These displays are supported:

  LCD0821: 2 lines by  8 characters
  LCD1621: 2 lines by 16 characters
  LCD2021: 2 lines by 20 characters
  LCD2041: 4 lines by 20 characters (tested)
  LCD4021: 2 lines by 40 characters

I could not test the vacuum fluorescent display models, but I think they should work, too.
There are no entries for this models in the driver table (at the bottom of MatrixOrbital.c),
but they could be easily added.

The displays come with an RS-232 and an I2C interface. The driver supports the RS-232 interface
only (because I have no idea how to find the I2C bus on my motherboard). 

Power can be applied either via an external DC power supply, a modified floppy power connector
(be aware that you can destroy your display if you get the pins wrong!) or via the RI (ring) 
signal of the RS-232 port. I choosed the latter, and modified a serial card so that it supplies 
+5V from the ISA bus to this pin (again, be aware that this is dangerous if you connect any other 
serial device to this modified port).

The driver supports vertical, horizontal and split bars (two independent bars in one line),
all bar types can be used simultanously. As the displays only have 8 user-defined characters,
the needed characters to display all the bars must be reduced to 8. This is done by replacing
characters with similar ones. To reduce flicker, a character which is displayed at the moment,
will not be redefined, even if it's not used in this run. Only if the character compaction 
fails, this characters will be redefined, too.

The displays have a GPO (general purpose output), where you can connect a LED or something. 
The driver supports controlling this GPO, but this function is unused by now.


Configuration:

The driver needs/supports the following entries in lcd4linux.conf:

Display: a valid Matrix Orbital Display name (e.g. "LCD2041")
Port: serial device the display is attached to (e.g. /dev/ttyS2)
Speed: the baud rate from the display (configured via jumpers) must match 
       this value. Possible values are 1200, 2400, 9600 and 19200
Contrast: sets the LCD display contrast to a level between 0 (light) 
          and 256 (dark). Default value: 160

s='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr class='logheader'><td><span title='2024-01-31 13:08:32 +0100'>2024-01-31</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Tocantinopolis?id=e810c267c3a6960c8d57935bb1a9b334026038ed&amp;follow=1'>isdb-t: Update Brazil channel lists</a></td><td>Mauro Carvalho Chehab</td><td>1935</td><td><span class='deletions'>-11312</span>/<span class='insertions'>+70605</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Use the current lists from portalbsd.com.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2024-01-30 17:34:57 +0100'>2024-01-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Trksat-3A4A-42.0E?id=76c5a9110f7ee40fd1c63eca8ca84b125a0ac11e&amp;follow=1'>dvb-s: drop transponders that aren't there at Lyngsat anymore</a></td><td>Mauro Carvalho Chehab</td><td>50</td><td><span class='deletions'>-20357</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Those transponders may have been renamed or decommissioned. So,
drop them.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2024-01-30 17:31:26 +0100'>2024-01-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-601-49.0E?id=118e8c00436b524273499b6c01b0c4e77083a4b5&amp;follow=1'>dvb-s: update from today's Lyngsat report</a></td><td>Mauro Carvalho Chehab</td><td>196</td><td><span class='deletions'>-15543</span>/<span class='insertions'>+15859</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2024-01-30 17:06:37 +0100'>2024-01-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/uk-WinterHill?id=fca403cc92717328bccb3b2a4c747a474632c0da&amp;follow=1'>dtv-scan-tables: full uk transmitter update</a></td><td>Simon Liddicott</td><td>81</td><td><span class='deletions'>-500</span>/<span class='insertions'>+163</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
updates all transmitter files, removes discontinued muxes

Link: https://lore.kernel.org/linux-media/20230216010528.5921-1-simon@liddicott.com
Signed-off-by: Simon Liddicott &lt;simon@liddicott.com&gt;
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-11-25 11:46:20 +0000'>2022-11-25</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-c/hu-Digikabel?id=833d4cc1dddb3560e93ef7dc6951ab5c204b5c13&amp;follow=1'>dtv-scan-tables: hu-Digikabel changes</a></td><td>Hrotkó Gábor</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+26</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Modifications by: https://digi.hu/tv/csatornalista

         FREQUENCY = 121000000

Link: https://lore.kernel.org/linux-media/8c632dad-d428-402e-a171-baf7234f2d85@gmail.com
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-04-30 16:02:58 +0100'>2022-04-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/pt-All?id=57ed2982275045ea5e92ef2a40b9fa58255852e5&amp;follow=1'>pt-All: fix modulation</a></td><td>Mauro Carvalho Chehab</td><td>1</td><td><span class='deletions'>-10</span>/<span class='insertions'>+10</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-04-30 15:50:08 +0100'>2022-04-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/pt-All?id=5f7b549da3c7ed1e9dfe4fcbbda742a9d7ee5aec&amp;follow=1'>pt-All: Update Portugal channels</a></td><td>Mauro Carvalho Chehab</td><td>1</td><td><span class='deletions'>-34</span>/<span class='insertions'>+70</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
There were some changes at Portugal channel frequencies, mostly
in 2020. Update the DVB-T channel list accordingly, in order to
reflect the current list of emitters.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-03-07 17:34:29 +0100'>2022-03-07</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Palmas?id=e403f83644167e240668c0668a8de04532060683&amp;follow=1'>Update Brazilian ISDB-T tables</a></td><td>Mauro Carvalho Chehab</td><td>549</td><td><span class='deletions'>-2923</span>/<span class='insertions'>+13860</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-03-07 17:05:00 +0100'>2022-03-07</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Intelsat-38-45.1E?id=0eb034356d9699799ed8633ac3fe01622d39e6ff&amp;follow=1'>Update satellite channel lists from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>54</td><td><span class='deletions'>-1882</span>/<span class='insertions'>+2326</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-12-14 12:36:28 +0100'>2021-12-14</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/uk-WinterHill?id=5acecf65ccd5633c50b8c199cce50fb734635097&amp;follow=1'>dtv-scan-tables: latest UK changes</a></td><td>Simon Liddicott</td><td>4</td><td><span class='deletions'>-24</span>/<span class='insertions'>+24</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
only includes transmitters where there have been changes

Link: https://lore.kernel.org/linux-media/20210128234622.75009-1-simon@liddicott.com
Signed-off-by: Simon Liddicott &lt;simon@liddicott.com&gt;
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-04-30 21:33:05 +0200'>2021-04-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Tupirama?id=25ee9e0ce4bbacdb278d4cff306ceb6528c4f548&amp;follow=1'>update Brazilian scan files</a></td><td>Mauro Carvalho Chehab</td><td>2476</td><td><span class='deletions'>-12805</span>/<span class='insertions'>+69312</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Data updated according with https://portalbsd.com.br/.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-04-30 13:29:02 +0200'>2021-04-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal201-90.0E?id=66ec1eabbf6a596b42f6d4802b6aead3e8ba1ad5&amp;follow=1'>Remove legacy entries</a></td><td>Mauro Carvalho Chehab</td><td>129</td><td><span class='deletions'>-24898</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
There are several entries that used to be at Lyngsat.
Several of them were merged with other entries.
On others, there's no TV signal anymore.

So, drop them.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-04-30 13:28:58 +0200'>2021-04-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-601-49.0E?id=f46e7874dd45f03f47b31e8cd56108f3f10711f8&amp;follow=1'>Add new satellites from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>75</td><td><span class='deletions'>-21</span>/<span class='insertions'>+29721</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Those are are new satellite descriptions that didn't use to
exist on Lyngsat. Add them.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-04-30 10:31:15 +0200'>2021-04-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Intelsat-38-45.1E?id=137a4b9176f8fb074c955a49ae97865d2fb85095&amp;follow=1'>Rename a few satellites with two names and update frequencies</a></td><td>Mauro Carvalho Chehab</td><td>2</td><td><span class='deletions'>-283</span>/<span class='insertions'>+182</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Those two satellites have two names. Use Just one of them.

While here, update their frequencies from Lyngsat.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-04-30 10:29:42 +0200'>2021-04-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-402-54.9E?id=cf6e4b502139112c82f092001eb6b9ac3912182a&amp;follow=1'>Update frequencies from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>188</td><td><span class='deletions'>-12304</span>/<span class='insertions'>+12666</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;


</td></tr>