The options Graphics Hardware Platform, DISPLAY_CONTROLLER and DISPLAY_PANEL are specific to the hardware used. The Graphics Hardware Platform selects the Graphics PICtail™ Plus Board version, PIC24FJ256DA210 Development Board or any other Microchip demo boards for the Graphics Library. Currently there are two Graphics PICtail™ Plus Board versions supported as shown in the Getting Started section.
The rest of the settings are used to specify the the display parameters when using an RGB type display controller such as SSD1906 and SSD1926 from Solomon Systech. The table below summarizes the generic parameters found in RGB type display controllers and when each type is used.
|
Options |
Color STN |
Mono STN |
TFT |
|
YES |
YES |
YES | |
|
YES |
YES |
YES | |
|
YES |
YES |
YES | |
|
YES |
YES |
YES | |
|
NO |
NO |
YES | |
|
NO |
NO |
YES | |
|
NO |
NO |
YES | |
|
NO |
NO |
YES | |
|
YES |
YES |
YES | |
|
YES |
YES |
YES | |
|
YES |
YES |
YES |
All the options listed here are set in the HardwareProfile.h header file implemented in the application layer. An example of this file is shown in HardwareProfile.h Example section.
|
Name |
Description |
|
Defines the display controller's physical interface to the display panel. Valid Values:
| |
|
Defines the display rotation with respect to its native orientation. For example, if the display has a resolution specifications that says 240x320 (QVGA), the display is natively in portrait mode. If the application uses the display in landscape mode (320x240), then the orientation must be defined as 90 or 180 degree rotation. Graphics Library will calculate the actual pixel location to rotate the contents of the screen. So when users view the display, the image on the screen will come out in the correct orientation. Valid values:
| |
|
Defines the native horizontal dimension of the screen. This is the horizontal pixel count given by the display's data sheet. For example a 320x240 display will have DISP_HOR_RESOLUTION of 320. Valid Values:
| |
|
Defines the native vertical dimension of the screen. This is the vertical pixel count given by the display's data sheet. For xxample a 320x240 display will have DISP_VER_RESOLUTION of 240. Valid Values:
| |
|
Defines the horizontal front porch. DISP_HOR_BACK_PORCH + DISP_HOR_FRONT_PORCH + DISP_HOR_PULSE_WIDTH makes up the horizontal blanking period. Value used will be based on the display panel used. | |
|
Defines the horizontal back porch. DISP_HOR_BACK_PORCH + DISP_HOR_FRONT_PORCH + DISP_HOR_PULSE_WIDTH makes up the horizontal blanking period. Value used will be based on the display panel used. | |
|
Defines the vertical front porch. DISP_VER_BACK_PORCH + DISP_VER_FRONT_PORCH + DISP_VER_PULSE_WIDTH makes up the vertical blanking period. Value used will be based on the display panel used. | |
|
Defines the vertical back porch. DISP_VER_BACK_PORCH + DISP_VER_FRONT_PORCH + DISP_VER_PULSE_WIDTH makes up the vertical blanking period. Value used will be based on the display panel used. | |
|
Defines the horizontal sync signal pulse width in pixels. Value used will be based on the display panel used. | |
|
Defines the vertical sync signal pulse width in lines. Value used will be based on the display panel used. | |
|
Indicates that the color data is sampled in the falling edge of the pixel clock. |