Preparing the Display for Operation

Several steps need to be taken before the display will become operational. Some of these steps are display-specific. Supported Controllers/Panels provides examples of start-up code for each supported display.

Generally speaking, you need to take the following steps:

• Define which I/O lines and ports of your device control the display. This is done through the lcd.iomapping property.
• Configure some I/O lines/ports as outputs, as required for controlling your particular display. This is only necessary on platforms with explicit output buffer control. For more details see your device's platform documentation (for example, the EM1000's is here).
• Set the resolution of the display (lcd.width and lcd.height). These values depend on the panel, not the controller, so they cannot be detected automatically. Your application needs to set them "manually."
• Set lcd.rotated = 1 — YES if you wish the display image to be rotated 180 degrees (that is, the display of your device is installed upside down).
• Set lcd.inverted = 1 — YES if you need to invert the image on the display (may be required for certain panels).
• Enable the display by setting lcd.enabled = 1 — YES. This step will only work if your display is properly connected, the correct display type is selected in your project, lcd.iomapping is set properly, and the necessary I/O lines are configured as outputs. The lcd.error read-only property will indicate 1 — YES if there was a problem enabling the display.
• Enable, the backlight, if needed — this is not related to the controller/panel itself, but is still a necessary step. Light it up, don't linger in the dark!