UnicView RD v1.0.0 User Guide Rev 1.0

Transcription

1 UnicView RD v1.0.0 User Guide Rev 1.0 Proculus Technologies 11/20/2015

2 2 of 63 User Guide Rev 1.0

3 Proculus Technologies provides this document to its customers with a product purchase to use in the product operation. This document is copyright protected and any reproduction of the whole or any part of this document is strictly prohibited, except with the written authorization of Proculus Technologies. The contents of this document are subject to change without notice. All technical information in this document is for reference purposes only. System configurations and specifications in this document supersede all previous information received by the purchaser. Proculus Technologies makes no representations that this document is complete, accurate or errorfree and assumes no responsibility and will not be liable for any errors, omissions, damage or loss that might result from any use of this document, even if the information in the document is followed properly. This document is not part of any sales contract between Proculus Technologies and a purchaser. This document shall in no way govern or modify any Terms and Conditions of Sale, which Terms and Conditions of Sale shall govern all conflicting information between the two documents. For Research Use Only. Not for use in diagnostic procedures. PATENT PENDING 3 of 63 User Guide Rev 1.0

4 Introduction - Document Overview Contents 1 Introduction Document Overview Software Overview Main Window Menu bar Tool bar Secondary Windows Screen View Terminal Images Object Parameters Command List Serial Port Communication Settings Open/Close Handshake Baudrate Objects Touch Button Line Rectangle Circle Copy/Paste Copy Rotation Icon Definition (IconDef) IconFromDef IconFromICO Tools Clear Screen Touch Panel Test Touch Panel Calibration Color Palette Command Group Adjust RTC Adjust Backlight Sound Buzzer of 63 User Guide Rev 1.0

5 Introduction - Document Overview Text Tools Curve Plot Demos Create default bitmap file Parameter Settings Baudrate Param 1 and Param Miscellaneous Project folder structure Auto-backup Images Taskbar Icon/Messages Troubleshooting Error Report Known Issues of 63 User Guide Rev 1.0

6 Introduction - Document Overview 1 Introduction 1.1 Document Overview This document provides a general overview of UnicView RD features, and descriptions of its tools and usage alongside a connected supported LCM (Liquid Crystal Module). 6 of 63 User Guide Rev 1.0

7 Software Overview - Document Overview 2 Software Overview UnicView RD is a configuring, testing and debugging software tool, intended for use with compatible LCMs running the RD (Real Design) firmware. In addition to the main application, UnicView RD comes bundled with additional utility and productivity tools, referred to in this document as External Tools. 7 of 63 User Guide Rev 1.0

8 Software Overview - Main Window 2.1 Main Window When UnicView RD is started, it presents the main window, without any projects open (Figure 1). On this welcome view, the External Tools (Section ) are easily accessed. Figure 1 - UnicView RD main window, no project open 8 of 63 User Guide Rev 1.0

9 Software Overview - Main Window After opening a project, the tools will be enabled and additional secondary windows will appear (Figure 2). Figure 2 - UnicView RD main window, project open 9 of 63 User Guide Rev 1.0

10 Software Overview - Main Window Menu bar The menu bar is located at the top of the main window File menu Comprises the project options. Figure 3 - File menu Table 1 - File menu items Item Description New Creates a new project Open Opens an existing project Save Saves the current project (overwriting) Open Folder Opens the current project s containing folder Close Closes the current project Recent projects Opens an existing project, from a recently opened projects list Exit Closes the current project and exits the application 10 of 63 User Guide Rev 1.0

11 Software Overview - Main Window View menu Comprises the layout and visibility options for the secondary windows. Figure 4 - View menu 11 of 63 User Guide Rev 1.0

12 Software Overview - Main Window Table 2 - View menu items Item Description Terminal Toggles the visibility of the Terminal window Command List Toggles the visibility of the Command List window Image List Toggles the visibility of the Image List window Save current layout Saves the current layout in an user-defined file Sets the layout to be used when reopening the current project. [Default] is the Choose initial layout factory layout, and [Other ] specifies an user-defined layout 12 of 63 User Guide Rev 1.0

13 Software Overview - Main Window Settings menu Comprises general options and configuration settings. Figure 5 - Settings menu Table 3 - Settings menu items Item Description Serial Port... Opens the advanced serial communication port settings window Resolution Opens the resolution setting window Parameter Opens the LCM Settings Window Settings Send Parameter Sends the current settings to the LCM Settings Colors Opens the application color settings 13 of 63 User Guide Rev 1.0

14 Software Overview - Main Window Tools menu Comprises various utility and configuration tools. Figure 6 - Tools menu Table 4 - Tools menu items Item Description Generate TouchConfig file Generates the touch button mapping file (0x1E) Send TouchConfig file Sends the touch button mapping file to the LCM Generate IconDefinition file Generates the icon mapping file (0x1D) Send IconDefinition file Sends the icon mapping file to the LCM Clear Screen Sends the Clear Screen command to the LCM Start Touchscreen Test Starts the touchscreen test routine Calibrate Touchscreen Sends the Calibration commando to the LCM Command group loop Opens the Command Group Loop window Adjust RTC (clock) Opens the RTC tools window Adjust backlight Opens the backlight tools window Sound buzzer Opens the buzzer tool window Text tools Opens the text tools window Curve plot Demos Opens the curve plot demonstration window Create default bitmap file Creates a 0_default.bmp image in the project s Images folder Section Tools presents detailed description of the tools. 14 of 63 User Guide Rev 1.0

15 Software Overview - Main Window External Tools menu Comprises the External Tools, a set of utility and productivity applications used in conjunction with UnicView RD and Proculus LCMs. Figure 7 - External Tools menu Table 5 - External Tools menu items Item Description Firmware Downloader Used to update or change the LCM s firmware Font Generator Used to create font files for Proculus LCMs ICO Generator Used to create *.ICO files for Proculus LCMs Image Converter Used to resize images and convert them to proper format Documentation of External Tools is included on each specific application. 15 of 63 User Guide Rev 1.0

16 Software Overview - Main Window Help menu Comprises documentation files and additional software information. Figure 8 - Help menu Table 6 - Help menu items Item Description User Guide Opens the User Guide document (this document) Opens the Command Set document, containing information about the Command Set RD firmware Opens a dialog to change the current serial key registered. Used Change Serial Key mainly to change from a Trial License to a Full License About Opens version and contact information about UnicView RD 16 of 63 User Guide Rev 1.0

17 Software Overview - Main Window Tool bar The tool bar is located right below the menu bar. It contains most of the tools presented on the tools menu, as well as the condensed serial port controls. Section Tools presents detailed description of several tools. The tool bar is divided into functional groups (Figure 9). For example, the Alignment and Resizing group, detailed in Figure 10. Figure 9 - Tool groups Figure 10 - Alignment and Resizing tool bar After clicking any of the alignment or size controls, it is necessary to choose the reference object, by clicking it. 17 of 63 User Guide Rev 1.0

18 Software Overview - Secondary Windows 2.2 Secondary Windows Screen View This is the main work area, and shows a preview of the images and their objects. Figure 11 - Screen View There are three zoom levels (1x, 2x, 4x), selectable on the controls at the top-right region of the window. It is possible to select between three visibility options, on the Display: dropdown menu, described in Table 7. Table 7 - Object visibility options Item Description All Shows all the objects on the screen Touch buttons Shows only Touch Button objects All graphics Shows all objects except Touch Buttons On the top-left region, the current coordinates of the cursor are shown. The coordinates system is defined according to Figure of 63 User Guide Rev 1.0

19 Software Overview - Secondary Windows Figure 12 - Coordinates System On the lower region, there is the Serial Command preview box, which shows the serial command of the currently selected object. This command can be sent to the LCM by clicking the [Send] button. 19 of 63 User Guide Rev 1.0

20 Software Overview - Secondary Windows Terminal This window is used to send and receive commands to/from the LCM. Figure 13 - Terminal window The upper box (log text box) shows both incoming (in red) and outgoing (in blue) data. Its contents are cleared by clicking the [Clear] button. The lower box is used for user input of serial commands, which are sent to the LCM by clicking the [Send] button. The data format must be Hexadecimal. Spaces are ignored. 20 of 63 User Guide Rev 1.0

21 Software Overview - Secondary Windows Images This window handles image addition, deletion and selection on the project, as well as picture downloading, saving and switching on the LCM. Figure 14 - Images window To add pictures to the project, click the [+] button. All images on the project must be name according to the template bellow, and cannot have overlapping PicIDs. For example, 123_Intro.bmp or 1_Main.bmp are valid names. The resolution of the images must match the project s resolution in order to be downloaded correctly to the LCM, even though the Screen View window s preview stretches incorrect resolutions. #_<name>.bmp, where # represents an integer in the [0, 65535] range, and <name> is an optional string. After selecting the desired files, the Define PicIDs dialog will appear. All filenames that are already named according to the template, will have their PicIDs suggested on the PicID column (Figure 15). Any filename incorrectly named will have the PicID set to -1 (Figure 16). In case of PicID overlapping (Figure 17) or images without PicIDs allocated (Figure 18), errors will be generated, and the issue must be resolved before continuing, or the addition must be canceled. 21 of 63 User Guide Rev 1.0

22 Software Overview - Secondary Windows Figure 15 - PicID definition, numbered filenames Figure 16 - PicID definition, unnumbered filenames 22 of 63 User Guide Rev 1.0

23 Software Overview - Secondary Windows Figure 17 - PicID definition, overlapping PicIDs Figure 18 - PicID definition, unallocated PicIDs Once the images have been added, they are shown on the image table, which has the columns described on Table of 63 User Guide Rev 1.0

24 Software Overview - Secondary Windows Table 8 - Image table columns Item Description Send Check to include in the download list PicID PicID of the image File Name Name of the image file Notes Edit to change the PicID; File name automatically renamed; Click the column header to sort by PicID Click to display on the Screen View window; Click the column header to sort by File Name The images may be excluded from the project by selecting them and clicking the [X] button (Figure 19). Multiple rows can be selected by holding the CTRL or SHIFT keys. The Images window includes Jump and Save controls, which send the Jump to PicID and Save to PicID commands, respectively. The Jump control changes the current PicID show on the LCM, and the Save control stores the current screen state of the LCM to the indicated PicID. Figure 19 - Images window (detail) The lower region of the window contains the image downloading controls. This process sends all the selected images to their respective PicIDs on the LCM, and is initiated by clicking the [Start] button. The Top-Speed option enables download at 6.250Mbps, provided that the LCM supports this baudrate. It is also possible to send images in 16-bit and 24-bit format, according to the LCM s requirements. 24 of 63 User Guide Rev 1.0

25 Software Overview - Secondary Windows Object Parameters The selected object(s) properties are shown on this window. Figure 20 - Object Parameters window. Left: Undocked, no objects selected. Right: Docked, Touch Button selected If more than one object of the same type is selected, the values that are equal across them are shown. The other values are left blank, and can be edited to make all of them equal. If more than one object type is selected, only the equivalent parameters are displayed. The user inputs most of the parameters manually, but some have a Selector Window or have a Dropdown List to choose from predefined values. Parameters which have a Selector Window or a Dropdown List exhibit an icon on the right side of the value column when clicked: Dropdown List Selector Window A Selector Window is a dialog window used to set the associated parameters visually. More details on the pertinent controls of the Objects section. 25 of 63 User Guide Rev 1.0

26 Software Overview - Secondary Windows Command List Provides a quick access command list and automatic command sending capabilities. Figure 21 - Command List window Table 9 - Command List parameters Item Description Notes Send Click to immediately send the command to the LCM Auto Check to include the command on the auto-send list Delay Time interval after the command is sent Range: [0, 9999] Name Description of the command Optional Hexadecimal format; Data Serial command data Max. length: 512 digits (256 bytes); Spaces are ignored Auto-send: When checked, all of the checked commands are sent sequentially, from top to bottom. Use global delay: The same time interval is used after every command, when auto-sending. The command list may be saved and loaded, using the [Save] and [Load] buttons on the top-right region of the window. The command list file has the extension *.CLF. 26 of 63 User Guide Rev 1.0

27 Software Overview - Serial Port Communication 2.3 Serial Port Communication The serial port is used to establish bilateral communication with connected LCMs, using standard UART protocol. It can be accessed on the condensed controls (Figure 22) or the expanded window (Figure 23). Figure 22 - Serial Port Settings condensed controls Figure 23 - Serial Port Settings expanded window Settings Usually the only settings that need to be changed are Port and Baudrate. If additional parameters must be changed, the expanded window should be used. Table 10 - Serial Port Settings Item Description Port Serial port name Baudrate Data transfer rate, in bps Data Bits Number of data bits Stop Bits Number of stop bits Parity Parity verification Notes Automatically updated when clicked Open/Close The serial port must be open before sending or receiving data. Attempting to send data while the port is closed results in a taskbar icon warning (see section ). 27 of 63 User Guide Rev 1.0

28 Software Overview - Serial Port Communication Attempting to open the port without selecting a port name results in a taskbar icon warning (see section ) Handshake In order to check if the communication is operating correctly, and to read the firmware version, the [Handshake] button may be used. If successful, a taskbar icon info will appear. See section Baudrate The data transfer rate, or baudrate, must match the current LCM s baudrate in order to stablish a working connection. Default value is bps. 28 of 63 User Guide Rev 1.0

29 Software Overview - Objects 2.4 Objects All objects, except from the Touch object, display their serial command on the Serial Command preview box (Screen View window), which can then be sent to the LCM, or copied to the clipboard Touch Button Defines a region of the touch panel that will be considered a button. When touched, the button may perform a Jump to PicID operation and a pressed effect, and will send a 0x78 serial command with the Command parameter s value. The pressed effect is usually achieved by having a duplicate image with all button regions displaying a pressed style. To generate the TouchConfig file, containing the Touch Button mapping, use the Generate TouchConfig File tool. To send it to the LCM, use the Generate TouchConfig File (Section ). Figure 24 Touch Button object properties Table 11 - Touch Button object properties description Parameter Description Notes X Top-left horizontal coordinate of the object area Y Top-left vertical coordinate of the object area Width Width of the object area Height Height of the object area Range: [-1, 65535] Fx PicID of the animation effect while button is held pressed Set to -1 to disable Range: [-1, 65535] Jump Destination PicID after button is released Set to -1 to disable Command Command code associated to the object Range: [0, 65535] Name Optional designator for the object 29 of 63 User Guide Rev 1.0

30 Software Overview - Objects Usage example Supposing the picture on PicID 1 is as shown in Figure 25, and the picture on PicID 4 is as shown in Figure 26, a Touch Button object is created on PicID 1, with the Fx property set to 4, and Jump property set to 0. Figure 25 - Image on PicID 2, containing a Touch Button Figure 26 - Image on PicID 4, containing the button effects (Fx) The Touch Config file is then created, by clicking on the [Generate Touch Panel Configuration file] button. Figure 27 - Creating the Touch Config File 30 of 63 User Guide Rev 1.0

31 Software Overview - Objects Figure 28 Touch Config File created Once the file is created, it is sent to the LCM by clicking on the [Send Touch Panel Configuration File to LCM] button. Figure 29 - Sending the Touch Config File Figure 30 Touch Config File sent Now, when the user touches the region define as a button on PicID 2, while they hold the button pressed, the corresponding area from PicID 4 will be painted on top of it, providing a pressed effect, and when the button is released, the LCM will change the current PicID to of 63 User Guide Rev 1.0

32 Software Overview - Objects Line Draws a line on the LCM screen. Figure 31 - Line object properties Table 12 - Line object properties description Parameter Description Color Color of the line Start Point First vertex of the line End Point Second vertex of the line Optional designator for the Name object Notes Foreground: Paints the Line using the foreground palette color Background: Paints the Line using the background palette color 32 of 63 User Guide Rev 1.0

33 Software Overview - Objects Rectangle Draws a rectangle on the LCM screen. Figure 32 - Rectangle object properties Table 13 - Rectangle object properties description Parameter Description Notes Stroke_Foreground: Paints the edge of the Rectangle, using the foreground palette color Fill_Foreground: Fills the interior of the Rectangle, using the background palette color Fill Style X Y Width Height Name Style of drawing Top-left horizontal coordinate of the object area Top-left vertical coordinate of the object area Width of the object area Height of the object area Optional designator for the object Stroke_Background: Paints the edge of the Rectangle, using the foreground palette color Fill_Background: Fills the interior of the Rectangle, using the background palette color Reverse: Fills the interior of the Rectangle, reversing the current colors 33 of 63 User Guide Rev 1.0

34 Software Overview - Objects Circle Draws a circle on the LCM screen. Figure 33 - Circle object properties Table 14 - Circle object properties description Parameter Description Fill Style Style of drawing X Y Top-left horizontal coordinate of the object area Top-left vertical coordinate of the object area Width Width of the object area Height Height of the object area Optional designator for the Name object Notes Stroke_Reverse: Paints the edge of the Circle, reversing the current colors Stroke_Foreground: Paints the edge of the Circle, using the foreground palette color Fill_Reverse: Fills the interior of the Rectangle, reversing the current colors Fill_Foreground: Fills the interior of the Circle, using the background palette color The diameter of the circle is calculated as the smallest between Width and Height 34 of 63 User Guide Rev 1.0

35 Software Overview - Objects Copy/Paste Copies the region of the object in its current PicID, and pastes it on the LCM screen. Figure 34 - Copy/Paste object properties Table 15 - Copy/Paste object properties description Parameter Description Paste Mode Style of drawing Top-left horizontal coordinate X of the object area Top-left vertical coordinate of Y the object area Width Width of the object area Height Height of the object area Top-left coordinates of the Coordinates pasting area Optional designator for the Name object Notes Opaque: Pastes the origin area to the target area Transparent_Single: Pastes the origin area to the target area, replacing the background color on the origin area by the target s original background picture Transparent_Overlay: Pastes the origin area to the target area, replacing the background color on the origin area by the current picture on screen Use the Selector Window to visually set the pasting area coordinates (Figure 35) 35 of 63 User Guide Rev 1.0

36 Software Overview - Objects The Selector Window is used to set the paste location. The location is set by clicking on the preview area (left region of the window). The preview image may be chosen from the thumbnail list on the right region of the window. Figure 35 - Copy/Paste Selector Window 36 of 63 User Guide Rev 1.0

37 Software Overview - Objects Copy Rotation Copies the region of the object in its current PicID, and pastes it on the LCM screen, with selectable rotation angle. Figure 36 - Copy Rotation object properties Table 16 - Copy Rotation object properties description Parameter Description Transparency Mode Style of drawing Top-left horizontal coordinate of X the object area Top-left vertical coordinate of the Y object area Width Width of the object area Height Height of the object area Rotation Center Icon s center of rotation Target Origin Angle Angle of rotation Top-left coordinates of the pasting area Name Optional designator for the object Notes Transparent: Draws the icon on the target area, replacing the background color by the target s original background picture. The icon s background color is defined by the top-left pixel Opaque: Draws the icon on the target area Read only. Set by Target Origin parameter Given in 0.5 degree increments. Must be twice the desired angle Use the Selector Window to visually set the values; Rotation centers are automatically calculated, thus use of the Selector Window is mandatory (Figure 37) 37 of 63 User Guide Rev 1.0

38 Software Overview - Objects The Selector Window is used to set the paste location and the rotation center of the copied area. Both locations are set by clicking on the preview area (left region of the window), after clicking the [Set Box] or [Set Center] buttons. The preview image may be chosen from the thumbnail list on the right region of the window. Figure 37 - Copy Rotation Selector Window This tool automatically calculates the command s center parameters, thus, the Selector Window must always be used when changing any parameter other than Transparency Mode or Angle. 38 of 63 User Guide Rev 1.0

39 Software Overview - Objects Icon Definition (IconDef) Defines a rectangular area on its PicID, associated to an IconID, which can be later accessed via the IconFromDef object. An Icon Definition File file is created based on all IconDef objects, which contains the information used by IconFromDef objects. To generate the IconDefinition file, containing the IconDef mapping, use the Generate IconDefinition File tool. To send it to the LCM, use the Generate IconDefinition File (Section ). Figure 38 - Icon Definition (IconDef) object properties Table 17 - Icon Definition (IconDef) object properties description Parameter Description Notes X Top-left horizontal coordinate of the object area Y Top-left vertical coordinate of the object area Width Width of the object area Height Height of the object area IconID Reference ID used to draw this icon Range: [0, 65535] Name Optional designator for the object 39 of 63 User Guide Rev 1.0

40 Software Overview - Objects Usage example Supposing the picture on PicID 2 is as shown in Figure 39, two IconDef objects are inserted, covering the balloon and lightning figures, with IconIDs 0 and 1, respectively. Figure 39 - Image on PicID 2, with figures intended to be used as icons The Icon Definition file is then created, by clicking on the [Generate icon definition file] button. Figure 40 - Creating the Icon Definition File Figure 41 - Icon Definition File created Once the file is created, it is sent to the LCM by clicking on the [Send icon definition file to LCM] button. 40 of 63 User Guide Rev 1.0

41 Software Overview - Objects Figure 42 - Sending the Icon Definition File Figure 43 - Icon Definition File sent The icons are now ready to be drawn using the IconFromDef object. 41 of 63 User Guide Rev 1.0

42 Software Overview - Objects IconFromDef Pastes the rectangular area defined by its IconID parameter (associated using the IconDef object) on the LCM screen. The Icon Definition File file must be downloaded to the LCM before using this object. Figure 44 - IconFromDef object properties Table 18 - IconFromDef object properties description Parameter Description X Top-left horizontal coordinate of the object area Y Top-left vertical coordinate of the object area Width Width of the object area Height Height of the object area Reference ID used to draw this icon. Defined by the IconDef IconID objects Name Optional designator for the object Notes Range: [0, 65535] 42 of 63 User Guide Rev 1.0

43 Software Overview - Objects Usage example Considering the Icon Definition File created on the usage example of the IconDef object, an IconFromDef object is created on PicID 1, as seen on Figure 45. Figure 45 - IconFromDef on PicID 1 If, for example, the IconFromDef object s IconID parameter is set to 0, it will draw the ballon icon on the LCM screen, as seen on Figure 46. Figure 46 - Icon associated to IconID 0 pasted on PicID 1 (LCM screen) 43 of 63 User Guide Rev 1.0

44 Software Overview - Objects IconFromICO Pastes the icon (from an *.ICO file) defined by its IconID parameter on the LCM screen. *.ICO files can be created using the Proculus ICO Generator External Tool. Figure 47 - IconFromICO object properties Table 19 - IconFromICO object properties description Parameter Description Display Mode Style of drawing Top-left horizontal coordinate of the X object area Top-left vertical coordinate of the Y object area Width Width of the object area Height Height of the object area Flash memory address ID of the icon LibID library Reference ID used to draw this icon. IconID Defined by the IconDef objects Name Optional designator for the object Notes Transparent: Draws the icon on the target area, replacing the background color by the target s original background picture. The icon s background color is defined by the top-left pixel Opaque: Draws the icon on the target area *.ICO file must be inside the Icons project folder Use the Dropdown List to choose from valid values 44 of 63 User Guide Rev 1.0

45 Software Overview - Tools 2.5 Tools All tools present the serial commands they generate, either on a Command labeled text box, on the Terminal window s log, or both Clear Screen Fills the screen with the LCM s set background color Touch Panel Test When active, draws inverting color circles at the coordinates touched. Figure 48 - Touch Panel Test example In order to use this tool properly, the Parameter Settings must be set as shown in Table 20. Table 20 - Parameter Settings configuration for Touch Panel Test Parameter Description P1.6 Send 0x73 command every 100ms after pressing touch panel 45 of 63 User Guide Rev 1.0

46 Software Overview - Tools P1.5 Coordinate Mode P2.2 Automatic refresh Touch Panel Calibration Starts the calibration routine. The LCM displays three crosses on screen, which must be precisely touched to calibrate correctly the touch panel s coordinates. Figure 49 - Touch Panel Calibration example Color Palette Presents two color selection dialogs (foreground and background), and a [Send] button, which sends the chosen colors to the LCM. 46 of 63 User Guide Rev 1.0

47 Software Overview - Tools Command Group The RD firmware supports auto-execution of groups of up to 128 commands. The Command Group tool provides the user with the ability to create up to 16 command groups. Only one (or none) group may be active at any time. The command structure works exactly like the Command List window s structure. After filling the desired fields, the Command Group File must be generated and sent to the LCM. Figure 50 - Command Group tool The command group lists may be saved and loaded, using the [Save] and [Load] buttons on the top-right region of the window. The command list file has the extension *.cgf. The delay time is given in increments of 8ms. Frame Header (AA) and Frame Tail (CC33C33C) must not be included on the commands. 47 of 63 User Guide Rev 1.0

48 Software Overview - Tools Adjust RTC Used to set, read, show and hide the Real Time Clock Write Writes the selected date/time to the LCM. Figure 51 Adjust RTC tool Click the [Now] button to get the computer s current date/time, and the [Write RTC] button to send to LCM Read Reads the RTC from the LCM and displays the formatted date/time to the user. Click the [Read RTC] button to perform the read operation Show/Hide Selects the coordinates, font size and display mode of the RTC. Preconfigured to use the project s current foreground color as font color. Click the [Show RTC] button to enable RTC display, and the [Hide RTC] button to disabled it. The background picture is not automatically restored when disabling RTC display. 48 of 63 User Guide Rev 1.0

49 Software Overview - Tools Adjust Backlight Used to set the current backlight brightness level, and configure the sleep function. Figure 52 - Adjust Brightness tool When parameter P1.4 (section Parameter Settings) is set to Automatic backlight sleep, the backlight will dim to the Off state level after Sleep delay time, and will be restored to On state brightness level when the touch panel is pressed. The Sleep delay time is set in 0.5 second increments Sound Buzzer Sounds the LCM s buzzer. Time is given in increments of 10 milliseconds. Figure 53 - Sound Buzzer tool 49 of 63 User Guide Rev 1.0

50 Software Overview - Tools Text Tools This tool is used to draw text on the LCM s screen, set several parameters, and download font files to the LCM. All the sub-tools that need coordinates can be configured by inputting the values manually, or by clicking the [Set] or [Set Window] buttons and some coordinate(s) on the preview area. Font files can be created using the Proculus Font Generator External Tool. Figure 54 - Text Tools window 50 of 63 User Guide Rev 1.0

51 Software Overview - Tools Standard Fonts Draws text using the standard font set. Figure 55 - Standard Fonts tab 51 of 63 User Guide Rev 1.0

52 Software Overview - Tools Custom Fonts Draws text using user-created fonts. The fonts IDs are selected on the LibID field, which ranges from 0x02 to 0x19 and from 0x24 to 0x3B. Figure 56 - Custom Fonts tab 52 of 63 User Guide Rev 1.0

53 Software Overview - Tools Text Window This tool establishes wrapping regions for the text drawing tools. By setting the window area, any text with origin coordinates inside the box will automatically wrap around to reside completely inside it, as long as that the Text Window is enabled. Figure 57 - Text Window tab 53 of 63 User Guide Rev 1.0

54 Software Overview - Tools Spacing and Cursor Text Spacing: Sets the character row and column distances, in pixels. Cursor: Enables and disables a blinking cursor at the specified coordinates, with the specified width and height. Figure 58 Spacing & Cursor tab 54 of 63 User Guide Rev 1.0

55 Software Overview - Tools Font Download Downloads both standard and custom fonts. The standard fonts are bundled with the software, and custom fonts must be added from the computer by clicking the [+] button. Fonts may be removed from the list by selecting them and clicking the [X] button. Figure 59 - Font Download tab 55 of 63 User Guide Rev 1.0

56 Software Overview - Tools Curve Plot Demos This tool presents three semi-predefined curve-plotting commands, and is used for illustration of the usage of the three associated curve-plotting commands (Dynamic Curve, Spectrum and Static Curve). Each tab has its own [Send] button, and there is a single text box, which shows the commands sent Create default bitmap file Figure 60 - Curve Demos window tabs Creates a generic image with PicID 0, with the same resolution as the project s current setting, and saves it on the project s folder. Used to add a test image to the list quickly. 56 of 63 User Guide Rev 1.0

57 Software Overview - Parameter Settings 2.6 Parameter Settings Used to configure general LCM behavior. Figure 61 - Parameter Settings Baudrate Sets the LCM s baudrate. When changed, the port settings must be adjusted accordingly Param 1 and Param 2 Several configuration options for the LCM. Param 2 also has a checkbox that determines if the Parameters Settings should be permanently saved to the LCM. Otherwise, all changes are volatile, and will be reset after a LCM reboot. Each parameter on Param 1 and Param 2 is associated to a single bit, named Py.x. Description of each bit is given in Table 21 and Table of 63 User Guide Rev 1.0

58 Software Overview - Parameter Settings Table 21 - Param 1 bits (P1.x) Bit Description 7 Enables or disables the LCM sending of command 0x72 after touch panel is released (Button Mode only). Defines whether command 0x73 is sent by the LCM only once after pressing down the touch panel, or 6 every 100ms while it s held down Coordinate Mode: LCM operates in a coordinates-based fashion, and Touch buttons are disabled 5 Button Mode: LCM operates using button regions. Touch buttons are enabled 4 Defines whether backlight brightness is fixed or changes based on the touch panel state 3 Defines whether the buzzer is enabled or disabled 1 2 Defines whether the LCM is in 90 (or 270, if P2.5 is set) rotation Defines whether the buzzer sounds only when a button region is pressed, or whenever the touch panel is 1 pressed (Button Mode only) 0 Enables or disables the LCM sending of command 0x79 after touch panel is pressed (Button Mode only) Table 22 - Param 2 bits (P2.x) Bit Description 7 Defines whether the LCM executes the buffered commands every 200 ms or as soon as possible 6 Defines whether the touch panel coordinates should be rotated when using 90 rotation 5 Defines whether the LCM is in 180 (or 270, if P1.2 is set) rotation Defines whether the background picture or background palette color should be displayed when drawing 4 text Defines whether the buffered commands are executed according P2.7 parameter, or manually (by using 2 0xD0 command) Not all LCM kernels support Param 2; for those that do not, the Kernel supports Param 2 checkbox should be unchecked. After setting the desired parameters, the user may send, save, save and send, or dismiss the changes, using the control buttons on the lower portion of the window. 1 In Button Mode, if P1.1 is set to sound only in button regions, the buzzer cannot be disabled. 58 of 63 User Guide Rev 1.0

59 Software Overview - Miscellaneous 2.7 Miscellaneous Project folder structure The project folder contains the subfolders listed in Table 23 and the files listed in Table 24. Table 23 - Project's folder subfolders Folder Description Icons Contains the *.ICO icon files Images Contains the *.bmp image files Output Contains the generated configuration files ProjData Contains the project s object collection file, PrjData.prjdat File Description PrjSettings.prj General project settings PrjSettings.prbkpj Backup of PrjSettings.prj file ErrorReport.txt Error log file Table 24 - Project's folder files Auto-backup The current project is automatically backed up every five minutes. Only the latest backup is kept in the folder. The backup files are copies of the PrjSettings.prj and PrjData.prjdat files. In order to restore the backup files, their extensions must have the bkp characters removed, thus, PrjSettings.prjbkp becomes PrjSettings.prj, and PrjData.prjdatbkp becomes PrjData.prjdat Images Image files names must begin with an integer number from 0 to 65535, followed by an underscore ( _ ), an optional name, and the.bmp extension. Examples: 0_intro.bmp 42_awnseroflife.bmp 237_.bmp The image format must be: Color-depth: 24 bits Resolution: Same as the target LCM When using vertical resolutions (width greater than height), the project s images must be rotated 90 clockwise (Figure 62), in order to be correctly shown and downloaded via serial port. 59 of 63 User Guide Rev 1.0

60 Software Overview - Miscellaneous Figure 62 - On the left, the original image. On the right, the rotated image on the project's folder 60 of 63 User Guide Rev 1.0

61 Software Overview - Miscellaneous Taskbar Icon/Messages While UnicView RD is running, a Windows taskbar icon (Figure 63) will appear. It can be right-clicked to quickly open and close the serial port. Figure 63 - Taskbar icon Additionally, message balloons may pop up on the occurrence of certain events, which can be warning or information messages Warning: Can t access serial port No port selected! Occurs when trying to open the serial port with no Port selected Warning: Can t access serial port Serial port is closed! Occurs when trying to access a closed serial port Information: Project saved Occurs when the current project is saved. 61 of 63 User Guide Rev 1.0

62 Software Overview - Miscellaneous Information: Handshake successful Occurs on a successful Handshake Information: Default bitmap created Occurs when the default bitmap is generated ( Create default bitmap file tool). 62 of 63 User Guide Rev 1.0

63 Troubleshooting - Error Report 3 Troubleshooting 3.1 Error Report In case of unexpected software failure, it will try to log the crash information. This information can be accessed by opening the ErrorReport.txt file. If the failure persists, this error report file may be sent to Proculus Technologies Customer Support for analysis. For feature requests or suggestions, please contact Proculus Technologies Customer Support. Customer support address: support@proculustech.com 3.2 Known Issues This section describes known issues that will be corrected in later software versions. 1. When changing the project resolution to a smaller resolution, objects are not re-dimensioned, and may end up outside the image area. In this case, the objects must be re-located before changing the resolution. The unreachable objects can still be selected using the Select All (CTRL + A) command. 63 of 63 User Guide Rev 1.0