GNU Linux-libre 4.14.266-gnu1
[releases.git] / Documentation / misc-devices / lcd-panel-cgram.txt
1 Some LCDs allow you to define up to 8 characters, mapped to ASCII
2 characters 0 to 7. The escape code to define a new character is
3 '\e[LG' followed by one digit from 0 to 7, representing the character
4 number, and up to 8 couples of hex digits terminated by a semi-colon
5 (';'). Each couple of digits represents a line, with 1-bits for each
6 illuminated pixel with LSB on the right. Lines are numbered from the
7 top of the character to the bottom. On a 5x7 matrix, only the 5 lower
8 bits of the 7 first bytes are used for each character. If the string
9 is incomplete, only complete lines will be redefined. Here are some
10 examples :
11
12   printf "\e[LG0010101050D1F0C04;"  => 0 = [enter]
13   printf "\e[LG1040E1F0000000000;"  => 1 = [up]
14   printf "\e[LG2000000001F0E0400;"  => 2 = [down]
15   printf "\e[LG3040E1F001F0E0400;"  => 3 = [up-down]
16   printf "\e[LG40002060E1E0E0602;"  => 4 = [left]
17   printf "\e[LG500080C0E0F0E0C08;"  => 5 = [right]
18   printf "\e[LG60016051516141400;"  => 6 = "IP"
19
20   printf "\e[LG00103071F1F070301;"  => big speaker
21   printf "\e[LG00002061E1E060200;"  => small speaker
22
23 Willy
24