====== RouterBoard ======

This driver supports HD44780 or HD66712 displays connected to a "[[http://www.routerboard.com|Router Board]] LCD port"

This particulary board not have paralell port but have a special LCD header where can connect an HD44780 display.
This port called IOSC0 port, and is write only, this port control the 4 leds on board too.

Because its a write only port you can't control leds outside lcd driver or inverse, for this added the socket controlled leds. To send led status
simply open an UDP socket and send to localhost 127.0.0.1 port 3333 one byte or more anyway only the first byte 4 low bits used the others is
cleared and ignored bit0 = Led1 ,bit1 = Led2 ...

This socket polled via timer callback, for detail see at drv_RB_start()

I add at to end of the file //drv_!RouterBoard.c// an example!

If you don't want coment #define RB_WITH LEDS and this part will be ignored

----

===== Display Section =====

<code>
Display <name> {
    Driver    'RouterBoard'
    Model     <string>
    Size      <string>
    Backlight <0|1>
    GPOs      <number>
    asc255bug <0|1>
    Icons     <number>
}
</code>


----

===== Parameters =====

|**Driver**|'RouterBoard'|
|**Model**|'HD44780' or 'HD66712'|
|**Size**|<columns>x<rows> e.g. "16x2"|
|**Backlight**|initial backlight state 0=off 1=on|
|**GPOs**|number of GPO's (not supported at the moment)|
|**asc255bug**|set to 1 if you don't get solid blocks in bars, but an inverted P (the Portishead syndrome :-)|
|**Icons**|Number of user-defined chars reserved for Icons (default: 0)|

----

===== Example =====

<code>
Display RB {
    Driver    'RouterBoard'
    Model     'HD44780'
    Size      '20x4'
    Backlight  0
    GPOs       0
    asc2355bug 0
    Icons      1
}
</code>


----

===== Connection details: =====

The IOCS0 port lower 16 bits connected as follows:

|**bit**|**LCD**|**LEDS**|
|0..7|data| |
|8|INITX| |
|9|SLINX| |
|10|AFDX| |
|11|backlit| |
|12| |LED1|
|13| |LED2|
|14| |LED3|
|15| |LED4|
   
LCD male header:

|1|Vcc +5V|
|2|GND|
|3|RS (Register Select,AFDX)|
|4|Contrast adjust (controlled) but how? if you know tell me not mentioned on User Manual|
|5|E (enable signal, INITX)|
|6|R/W (Data read/write or SLINX) not used connect LCD pin to ground|
|7|Data 1|
|8|Data 0|
|9|Data 3|
|10|Data 2|
|11|Data 5|
|12|Data 4|
|13|Data 7|
|14|Data 6|
|15|Backlit GND (controlled) (IOSC0 bit 11)|
|16|Backlit Vcc +5V|

If you using this driver and board and you have any fun device connected, program or story :-) please share for me. Thanks.

----

===== Literature =====

  * Geode SC1100 Information Appliance On a Chip http://www.national.com/ds/SC/SC1100.pdf	   
  * RouterBoard User Manual http://www.routerboard.com)

----