cadManiac.org
    navigation
>projects
   KontrollerLab
>login
    KontrollerLab
>info page
>download
>release schedule
>documentation
  introduction
  installation
  first steps
  compiler settings
  linker settings
  assembler settings
  programmer settings
  debugger
    first steps
    configuration
    direct memory debugger
    PC only debugger
    in circuit debugger
  wizards
    seven segments wizards
    dot matrix library wizard
    dot matrix character wizard
    font wizard
>examples
  font wizard tutorial
hosted by
SourceForge.net Logo
    news
>New site up and running
>New project launched:
KontrollerLab
    information
>propose new project
>bugtracking
>FAQ
>contact
>legal disclaimer
>Not logged in.
    KontrollerLab 

Dot matrix library wizard

Using this wizard, You can add the LCD library of Peter Fleury. That library is in the KontrollerLab package and will be copied to Your project automatically by this wizard.

To add it, check the check box saying "Add HD44780 library by Peter Fleury to the project", as shown in figure 1.

Figure 1: The wizard window

In short, here are the options:
  • General settings
    • LCD_CONTROLLER_KS0073: If You are using a HD44780 based LCD, set this value to 0. If You are using a KS0073 based LCD, set this value to 1.
    • LCD_DISP_LENGTH: This setting specifies the number of characters in one line of Your display. See the datasheet of Your LCD for details.
    • LCD_LINE_LENGTH: This setting specifies the number of bytes for one line of Your display in the sense of a RAM adress. For a standard 2x16 characters LCD, this is 0x40 in most cases. See the datasheet of Your LCD for details.
    • LCD_LINES: This setting specifies the number of lines of Your display. See the datasheet of Your LCD for details.
    • LCD_START_LINE1: This setting specifies the start RAM adress for the first line of Your display. 0x0 should be a correct value in most cases. See the datasheet of Your LCD for details.
    • LCD_START_LINE2: This setting specifies the start RAM adress for the second line of Your display. 0x40 should be a correct value in most cases. See the datasheet of Your LCD for details.
    • LCD_START_LINE3: This setting specifies the start RAM adress for the third line of Your display. This is only valid if Your display has a third line. 0x14 should be a correct value in most cases. See the datasheet of Your LCD for details.
    • LCD_START_LINE4: This setting specifies the start RAM adress for the fourth line of Your display. This is only valid if Your display has a fourth line. 0x54 should be a correct value in most cases. See the datasheet of Your LCD for details.
    • LCD_WRAP_LINES: If this setting is 1, the library will wrap the line at the end of the visible line. Otherwise, no wrapping is performed.
    • XTAL: The crystal frequency in Hz. By default, this is set to F_CPU, which is a constant preprocessor value that can be set in the compiler settings.
  • Interface
    • LCD_DATA0_PIN: The number of the pin connected to the display's data pin 0.
    • LCD_DATA0_PORT: The name of the port of the pin connected to the display's data pin 0.
    • LCD_DATA1_PIN: The number of the pin connected to the display's data pin 1.
    • LCD_DATA1_PORT: The name of the port of the pin connected to the display's data pin 1.
    • LCD_DATA2_PIN: The number of the pin connected to the display's data pin 2.
    • LCD_DATA2_PORT: The name of the port of the pin connected to the display's data pin 2.
    • LCD_DATA3_PIN: The number of the pin connected to the display's data pin 3.
    • LCD_DATA3_PORT: The name of the port of the pin connected to the display's data pin 3.
    • LCD_E_PIN: The number of the pin connected to the display's E (enable) pin.
    • LCD_E_PORT: The name of the port of the pin connected to the display's E (enable) pin.
    • LCD_RS_PIN: The number of the pin connected to the display's RS pin.
    • LCD_RS_PORT: The name of the port of the pin connected to the display's RS pin.
    • LCD_RW_PIN: The number of the pin connected to the display's RW pin.
    • LCD_RW_PORT: The name of the port of the pin connected to the display's RW pin.
    • LCD_IO_MODE: There are two different modes to access the LCD: Set this property to 1 if You want to use the IO ports. If You want to map a memory location to the display's pins, set it to 0.
    • LCD_PORT: By default, all connection pins are set to be on a common port. This common port can be specified here. Besides, these default settings provide the highest performance.
Detailed information can be found on the home page of Peter Fleury.
To change a property, click on the according list item. You are then able to change the value using the line below the list. As an example, when You click on "LCD_LINE_LENGHT", the wizard will give You a box to edit the numerical value below the list, as shown in figure 2.

Figure 2: The wizard window while editing a property


By clicking "OK", all settings are applied. If You do this the first time in Your project, the library's header and code file (dm_lcd.h and dm_lcd.c) are copied to Your project's directory. If You deselect the "Add HD44780 library by Peter Fleury to the project" checkbox and click on the "OK" button, the wizard will ask You if You really want to remove the library from Your project.
This site was created using free software only:
The GIMP, Quanta, KPovModeler and Povray.
©2006 cadManiac.org