Quick Start For The
5.7" Amulet-On-Board LCD

Your Amulet-On-Board 5.7" module comes pre-programmed from the factory with sample µHTML pages stored in the onboard flash. If you haven't already done so, please take a few minutes to power up the Amulet module to review the pre-programmed demo. To power up the Amulet Starter Kit and begin GUI navigation, proceed as follows:

1. Make sure that the DIP switch (SW2) settings on your Programming Interface Board (PIB) are set to the following default values:
   

   Switch 1 ON --- Boot Mode (Run in Normal Mode) Switch 2 OFF -- Program Baud Rate (115200) Switch 3 OFF -- RAM Test (No RAM test) Switch 4 ON --- Touch Panel Mode (No Initial Calibration Routine)

   
   
   
Figure 1. Amulet Programming Interface Board (PIB).


2. Connect the 30-pin connector on the Programming Interface Board to the 30-pin header on the back of the Amulet-On-Board LCD module. Ensure the key on the PIB's connector is aligned with the slot on the header. Make sure power is NOT applied while connecting the PIB to the Amulet On Board.




 Figure 2. Amulet 5.7" Amulet-On-Board, component side. Connected to PIB.

3. Connect the included 5V power adapter to power input J1 on the PIB.
   CAUTION: Do not reverse the polarity on the power input. Do not use a power adapter greater than 5 Volts. Doing so will permanently damage the module and invalidate your warranty.
   
4. The unit powers up and displays the "Easy As 123" Home Page. Use a touch panel stylus to navigate the GUI. (A stylus was included with the Starter Kit.)
5. LCD contrast and backlight brightness are both adjustable via software. On the "Easy As 123" Home Page, select UI Demos. From the UI Demos page, select Contrast & Backlight Adjust.

Creating Your First Amulet Graphical User Interface

By now, you should be familiar with the operation and navigation of the Amulet module. The next step is to use the Amulet HTMLCompiler to compile and program a GUI. In keeping with a long-standing programming tradition, this section introduces you to the Amulet development tools by guiding you through the creation of a "Hello, World!" program -- Amulet Style. Proceed as follows:

Launch the HTMLCompiler by whichever means you prefer.

1. From the HTMLCompiler's File menu, select Open. You will be presented with a file dialog box.
2. Use the controls in the file dialog to locate the file home.htm from the \projects\tour\ subdirectory of the Amulet main directory. By default the Amulet main directory is C:\Program Files\Amulet, however you may have specified a different path during the install.
3. Select home.htm and click the Open button.

The HTMLCompiler will open and compile home.htm and all other files that are linked from home.htm. When the conversion is complete the HTMLCompiler will display:

<Successful Compile! Ready to Program 17 files (12032 bytes) into Flash>

NOTE: DO NOT click on the Program Flash button yet because you must first prepare the Amulet module for programming.

Setting up the RS232 port for Flash programming

Before you can program your "Hello, World" program into the Amulet Flash, you must first select a comm port and a programming baud rate.

To select a serial port for programming:

1. From the HTMLCompiler's Settings menu, select RS232. You will be presented with an RS232 dialog box similar to the one pictured below.
   
2. Next, select any available serial port from the Comm Port list. All ports listed in your Windows Registry will be listed.
3. Choose a baud from the FLASH Rate list. The FLASH rate must match the baud rate selected by Switch 2 of the Programming Interface Board's DIP switch. If selecting 115200, be sure to place Switch 2 in the OFF position. If selecting 19200, be sure to place Switch 2 in the ON position.
4. Then, choose a baud from the uP Comm Rate list. The uP comm rate should match the baud rate specified in the home page of your project. By default, that rate is 115200. This is the baud rate that is used between the Amulet chip and your microprocessor. See the META documentation to change the uP comm rate within your HTML page. This is the initial baud rate the HTMLCompiler uses to attempt to wake-up the Amulet module when programming the flash.
5. Finally click the OK button.

Now, you must connect the Amulet module to the PC. Before proceeding, make sure the Programming Interface Board's DIP switch(SW2) settings are as follows:

Switch 1 (Boot Mode) = ON (normal) (*See note below) Switch 2 (Program Baud Rate) = OFF (115200) or ON (19200) Switch 3 (RAM Test) = OFF (disabled) Switch 4 (Touch Panel Mode) = ON (Normal operation)

Connect one end of the 9-pin serial cable (included with the starter kit) to the serial port (J3) on the Programming Interface Board and the other end to the assigned serial port on your computer.

* Note: The only time you should have to set Switch 1 to OFF (program mode) is when the project you compiled locks up the Amulet OS to the point where it won't accept the wake up message or if the Amulet OS has been corrupted and you need to reload the OS.

Programming The Flash

Click on the Program Flash button in the HTMLCompiler window. If there is a comm port conflict, the HTMLCompiler will display "Port is in use." Upon clicking the Program Flash button, the HTMLCompiler attempts to send out an auto-baud "wake-up" message to the Amulet module. If unsuccessful, the HTMLCompiler will display "Serial port timed out." If the HTMLCompiler wakes the Amulet module, the LCD will display a generic "Please wait while programming flash..." screen and commence programming. Once programming begins, the HTMLCompiler will display a series of messages as each file within the page is flashed. When the flash programming is complete, the HTMLCompiler will display:

<Successfully Flashed...>

Congratulations! You have successfully compiled and flashed your first Amulet uHTML page(s). The home page is now displayed on the LCD of the Amulet module. Navigate the GUI before proceeding to the next section.

Editing home.htm

Now, it is time to personalize your GUI. Using a text editor, such as Notepad or a "WYSIWYG" tool like Namo, open "home.htm" located in the \projects\tour\ subdirectory of the Amulet main directory. View the source code for the page and search for "Hello, World!" between the <BODY> and </BODY> tags.

Replace "World" with your name. For example, "Hello, World" should now read "Hello, John!"

Save the modified file and compile it.

Click on the Program Flash button.

Congratulations! You have successfully modified an Amulet uHTML page. A personalized version of the home page is now displayed on the LCD of the Amulet module. If desired, see Restoring The Flash To Factory Configuration.

Creating A GUI from Scratch

Before you embark on creating your own GUI from scratch, a few tips are in order:

• Learn from our examples: We have assembled a number of examples to show you how to use HTML and Amulet Widgets. To find out more about the examples, Click Here. You may also want to examine the source code for the sample pages that were factory configured into your Amulet's Flash. The code resides in the \projects\EasyAs123(4 MBit) subdirectory of the Amulet main directory. The home page is called home.html. You can use any of these pages as templates for your own GUI. Just copy these pages to your own subdirectory in \projects\
• Minimum page requirements: You MUST have either at least one table on your HTML page or an absolutely positioned floating box using the <DIV> tag. If using tables, the table dimensions attributes must specify the Height and Width of the LCD (WIDTH=320, HEIGHT=240). All visible content must reside within this table. You may add any number of rows and columns to this table. You may also embed additional tables within any cell in this table. The width and height must be specified for every table and the width must be specified for every column in each table. Optionally, you can also specify the height of each row. If using absolutely positioned floating boxes, no TABLE is required, but there must be at least one <DIV> tag absolutely positioned.
• Start with a Template:Finally, you should also be aware that there is a Templates directory which contains two pages: Template.htm and DivTemplate.htm. Template.htm contains the mandatory 320x240 TABLE that is required by the HTMLCompiler unless using absolute positioning. You may add any number of rows and columns to this table. You may also embed additional tables within any cell in this table.
  
  DivTemplate.htm contains a large 320 x 240 floating box located at 0,0, used primarily as a guide so you can see the 320 x 240 dimensions of the display. There is a smaller floating box with the text "Floating Box Template" located inside the larger floating box. Template.htm and DivTemplate.htm are located in the \projects\Templates subdirectory.

5.7" Hardware Specific Issues

Power Supply and Reset

The Programming Interface Board comes equipped with a 2.5 mm external power connector (J1). The power requirement is 5 VDC @ 250 mA. A reset switch (momentary pushbutton, SW1, on the Programming Interface Board) resets the Amulet controller chip as well as LCD power.

DIP Switch Settings

The Amulet 5.7" module can be powered up in different modes via the settings of the DIP switch (SW2). Some of the power up modes include: programming mode, run mode, RAM test mode, and touchpanel mode.

Boot Mode (Switch 1) -- This switch is monitored during a reboot to determine the operational mode of the controller board; ON is the normal mode and OFF is the FLASH program mode. Upon clicking the HTMLCompiler's Program Flash button, the HTMLCompiler will attempt to send out an auto-baud "wake-up" message to the Amulet module. If the HTMLCompiler is successful in waking the Amulet module, the LCD will display a generic "Please wait while programming flash..." screen and commence programming. The only time you should have to set Switch 1 to OFF (program mode) is when the project you compiled locks up the Amulet OS to the point where it won't accept the wake-up message or if the Amulet OS has been corrupted and you need to reload the OS.

Flash Mode Baud Rate (Switch 2) -- This switch sets the baud rate used during a Flash Reprogram. The ON position sets the hardware to 19,200 baud; OFF sets the hardware to 115,200 baud. This setting must match the baud rate selected in the HTMLCompiler software.

RAM Test (Switch 3) -- Turn this switch ON and then reboot the controller board to auto-execute a RAM test. If the RAM test is successful, the module will display the home page immediately following the test. If the RAM test fails, the screen will remain blank.

Touchpanel Mode (Switch 4) -- This switch should remain ON during normal operation. Turn this switch OFF and then reboot the controller board to begin a touchpanel calibration. The controller will display a series of three calibration targets. Use a stylus to touch the center of each target. If necessary, the controller will repeat the calibration. When calibration is complete, the controller will return to normal operation. The switch must be returned to the normal mode (ON) before the next reboot to continue normal operation.

NOTES:

• A copy of the "Please wait while programming flash..." page is stored in ..\Amulet\Projects\OS Files\Flashing\Flashing.ahtml. It is setup specifically for 320 X 240 displays. If a different sized display is used, the size of the table in Flashing.ahtml should be changed to match the dimensions of the new display. Once the dimensions have been changed, open Flashing.ahtml in the HTMLCompiler and then program into the flash.
  
• The text in Flashing.ahtml can be changed, but no images can be added.

RS-232 Spec

A serial connection is required between the controller board and a personal computer in order to program uHTML pages into the FLASH memory of the controller board.

• Pin 1 - N/C
• Pin 2 - TX (Amulet GUI module transmits data on Pin 2 while the PC receives data on Pin 2)
• Pin 3 - RX (Amulet GUI module receives data on Pin 3 while the PC transmits data on Pin 3)
• Pin 4 to 6 - Jumpered
• Pin 5 - Ground
• Pin 7 to 8 - Jumpered
• Pin 9 - N/C

The serial parameters for communications between the Amulet module and the server are, as follows:

Baud Rate: 9600, 19200, 57600, or 115200bps
Parity: None
Data Bits: 8
Stop Bits: 1

Back to Welcome - Contact Amulet - Amulet Home