Config...d44780(3pm)

📦
version 2.055 · 4 versions
, in debian trixie, ubuntu resolute

💖 Config...d44780 💖

okay bestie, so this is the Config...d44780(3pm) page — yes that's really the name, the man page tooling shortened it, we don't make the rules 💅 — and it's a Perl thing, a User Contributed Perl Documentation situation. Anyway. Sit down, hydrate, we're doing config classes.

✨ NAME ✨

Config::Model::models::LCDd::hd44780 — Configuration class LCDd::hd44780. That's it, that's the whole name, she's long but she's worth it 🫶

🌸 DESCRIPTION 🌸

These are the configuration classes used by Config::Model, and they were generated from LCDd.conf. So like, the vibes are auto-generated but the details are all real, no cap.

👑 Elements 👑

🎀 Backlight 🎀

So if you have a switchable backlight — that's what this is for. It's optional. Type uniline.

  • default value: no

🎀 Brightness 🎀

Set the brightness of the backlight (that's lcd2usb and usb4all). Brightness is literally the brightness while the backlight is set to 'on', iykyk. Optional. Type integer.

  • upstream_default value: 800

🎀 CharMap 🎀

The character map, to map ISO-8859-1 to the LCD's character set.

okay important detail bestie: hd44780_koi8_r, hd44780_cp1251, hd44780_8859_5 and upd16314 are only possible if compiled with additional charmaps. Don't come for me if they're not there 🙈

Optional. Type enum.

choice: 'hd44780_default', 'hd44780_euro', 'ea_ks0073', 'sed1278f_0b', 'hd44780_koi8_r', 'hd44780_cp1251', 'hd44780_8859_5', 'upd16314'.

  • upstream_default value: hd44780_default

🎀 ConnectionType 🎀

Select what type of connection you want. See the documentation for the available types, okay? Optional. Type uniline.

  • default value: 4bit

🎀 Contrast 🎀

Sets the initial contrast — this one's for bwctusb, lcd2usb, and usb4all. Optional. Type integer.

  • upstream_default value: 800

🎀 DelayBus 🎀

You can reduce the inserted delays by setting this to false. ⚠️ But heads up: on fast PCs it is possible your LCD does not respond correctly, so like, be careful. Default: true. Optional. Type uniline.

  • default value: true

🎀 DelayMult 🎀

If your display is slow and can't keep up with the flow of data from LCDd, garbage can appear on the LCDd 💀 (not the cute kind of garbage). Set this delay factor to 2 or 4 to increase the delays. Default: 1. Optional. Type uniline.

  • upstream_default value: 2

🎀 Device 🎀

The device of the serial, I2C, or SPI interface. Optional. Type uniline.

  • upstream_default value: /dev/lcd

🎀 ExtendedMode 🎀

If you have an HD66712, a KS0073 or another controller with 'extended mode', set this flag to get into 4-line mode. On displays with just two lines, do not set this flag, bestie, I'm begging.

And an additional restriction, listen up: controllers with and without extended mode AND 4 lines cannot be mixed for those connection types that support more than one display! That's a whole restriction, it's giving strict. Optional. Type uniline.

  • upstream_default value: yes

🎀 KeepAliveDisplay 🎀

Some displays (e.g. vdr-wakeup) need a message from the driver to say that it's still alive 🫶. When set to a value bigger then null, the character in the upper left corner is updated every <KeepAliveDisplay> seconds. Default: 0. Optional. Type uniline.

  • upstream_default value: 0

🎀 KeyMatrix_4_1 🎀

If you have a keypad you can assign keystrings to the keys. See the documentation for the used terms and how to wire it. For example, to give directly connected key 4 the string "Enter", use:

KeyDirect_4=Enter

For matrix keys, use the X and Y coordinates of the key:

KeyMatrix_1_3=Enter

Optional. Type uniline.

  • default value: Enter

🎀 KeyMatrix_4_2 🎀

Optional. Type uniline.

  • default value: Up

🎀 KeyMatrix_4_3 🎀

Optional. Type uniline.

  • default value: Down

🎀 KeyMatrix_4_4 🎀

Optional. Type uniline.

  • default value: Escape

🎀 Keypad 🎀

If you have a keypad connected. You may also need to configure the keypad layout further on in this file, so don't forget that part 👀. Optional. Type uniline.

  • default value: no

🎀 Lastline 🎀

Specifies if the last line is pixel addressable (yes) or if it controls an underline effect (no). Optional. Type boolean.

  • upstream_default value: yes

🎀 LineAddress 🎀

In extended mode, on some controllers like the ST7036 (in 3 line mode), the next line in DDRAM won't start 0x20 higher. Optional. Type uniline.

  • upstream_default value: 0x20

🎀 OffBrightness 🎀

OffBrightness is the brightness while the backlight is set to 'off'. Optional. Type integer.

  • upstream_default value: 300

🎀 OutputPort 🎀

If you have the additional output port ("bargraph") and you want to be able to control it with the lcdproc OUTPUT command. Optional. Type uniline.

  • default value: no

🎀 Port 🎀

The I/O address of the LPT port. Usual values are: 0x278, 0x378 and 0x3BC. For I2C connections, this sets the slave address (usually 0x20). Optional. Type uniline.

  • default value: 0x378

🎀 RefreshDisplay 🎀

If you experience occasional garbage on your display 😭 you can use this option as a workaround. If set to a value bigger than null, it forces a full screen refresh <RefreshDiplay> seconds. Default: 0. Optional. Type uniline.

  • upstream_default value: 5

🎀 Size 🎀

Specifies the size of the LCD. In case of multiple combined displays, this should be the total size. Optional. Type uniline.

  • default value: 20x4

🎀 Speed 🎀

Bitrate of the serial port (0 for interface default). Optional. Type uniline.

  • default value: 0

🎀 vspan 🎀

For multiple combined displays: how many lines does each display have. Vspan=2,2 means both displays have 2 lines. Optional. Type uniline.

  • upstream_default value: 2,2

🌈 SEE ALSO 🌈

  • cme

perl v5.40.1 · dated 2025-03-04 — that's the version and the date bestie, and that's the whole page 💖 slay, go configure ur LCD, you've got this 🦋✨👑

📦 where this page comes from