manufacturer of I/O-rich SBCs, operator interfaces, handheld instruments, and development tools for embedded control low cost single board computers, embedded controllers, and operator interfaces for scientific instruments & industrial control development tools for embedded control order our low cost I/O-rich embedded control products embedded controller manufacturer profile single board computers & embedded controllers development tools & starter kits for your embedded design operator interfaces with touchscreens and graphical user interface plug-in expansion modules for digital & analog I/O C language & Forth language integrated development tools, IDE single board and embedded computer accessories embedded controller enclosures, bezels, environmental gaskets

The C Programmer’s Guide to the Mosaic Handheld

Table of Contents

PART 1 GETTING STARTED

Introduction. How to Use This Manual

Chapter 1: Getting to Know Your Handheld Instrument

Chapter 2: Powering Your Handheld

PART 2 PROGRAMMING THE MOSAIC HANDHELD

Chapter 3: Your First Program

Chapter 4: The IDE: Writing, Compiling, Downloading and Debugging Programs

Chapter 5: Making Effective Use of Memory

Chapter 6: Real Time Programming

Chapter 7: Failure and Run-Time Error Recovery

Chapter 8: Programming the Graphical User Interface

PART 3 COMMUNICATIONS, MEASUREMENT, AND CONTROL

Chapter 9: Digital and Timer-Controlled I/O

Chapter 10: Data Acquisition

Chapter 11: Serial Communications

Chapter 12: The Battery-Backed Real Time Clock

Chapter 13: Customizing the Handheld's I/O

PART 4: REFERENCE DATA

Appendix A: GUI Function Reference

Appendix B: Handheld Schematics

Glossary

<< Previous | Next >>

A     B     C     DF    G     H     I     K     LM    N     P     R     S    T    UVWXY   

CHARGER_STATE

CHARGER_STATE

Type

Constant

Return Value

Integer

Description

The name of a read-only battery property that contains the state of the battery charger.  Possible contents of this property are the booleans GUI_TRUE when the batteries are charging and GUI_FALSE when the batteries are not charging. Read_Battery must be called before reading this property to get the latest battery information.

Usage

Read_Battery(); // Get the latest battery information.

Get_Property(GUI_BATTERY, CHARGER_STATE);

Read_Battery \ Get the latest battery information.

GUI_BATTERY CHARGER_STATE Get_Property

Library

library.c

library.4th

See Also

Read_Battery

 

void Clear( uint object_reference )

Clear( u -- | u = object reference )

Type

Function

Input Parameters

object_reference         A 16 bit number that refers to a textbox, plot, or screen object.

Description

A method that clears all data in the specified textbox, plot, or screen.  If the object is a textbox, writes ASCII space to all positions in the textbox and sets the refresh flag to true so the textbox will be re-rendered the next time Refresh is called.  If the object is a plot, sets each cell of the plot buffer to zero and sets the refresh flag to true. so the plot will be re-rendered the next time Refresh is called  If the object is a screen, erases and unloads all objects in the screen.  Refresh does not have to be called after clearing a screen.  Errors include: INVALID_OBJECT.

Usage

Clear( GUI_SCREEN0 );

GUI_SCREEN0 Clear

Library

library.c

library.4th

void Clear_Error ( void )

Clear_Error ( -- )

Type

Function

Description

A method that sets the last reported error to NO_ERROR. Clear_Error should be called after Read_Error to prevent servicing the same error more than once.

Usage

Clear_Error();

Clear_Error

Library

library.c

library.4th

 

void Copy_Screen ( uint source_screen, uint destination_screen )

Copy_Screen ( source_screen_reference \ destination_screen_reference )

Type

Function

Input Parameters

source_screen_reference         A 16 bit number that refers to the screen object you want to copy from.

destination_screen_reference   A 16 bit number that refers to the screen object you want to copy to.

Description

A method that copys the contents of the source screen into the destination screen, overwriting all of the previously loaded objects in the destination screen.  The source and destination screens can be in display memory (GUI_SCREEN0 to GUI_SCREEN3) or in RAM in the heap.  However, only screens in the display memory can be made visible (see the VISIBLE property of the display object).  Posible errors include INVALID_SCREEN and HEAP_FULL.

Usage

screenIntro = New_Object ( SCREEN );  // Create a new screen in RAM.

Load(screenIntro,graphicLogo,0,0);    // Load an image into the screen.

Copy_Screen(screenIntro,GUI_SCREEN0); // Copy screen into the display.

SCREEN New_Object screenIntro !       \ Create a new screen in RAM.

ScreenIntro @ graphicLogo @ 0 0 Load  \ Load an image into the screen.

ScreenIntro @ GUI_SCREEN0 Copy_Screen \ Copy screen into the display.

Library

library.c

library.4th

See Also

VISIBLE

CONTRAST

CONTRAST

Type

Constant

Return Value

Integer

Description

The name of a display property that sets the contrast of a monochrome display.  Valid values are 0 to 31.  Values less than 0 and greater than 31 saturate at 0 and 31 respectively and have no additional effect on the contrast.  The initial value of the contrast after Initialize_GUI is called is 16.  For larger contrast adjustments use the hardware potentiometer.

Usage

Set_Property(GUI_DISPLAY, CONTRAST, (ulong) 1);

GUI_DISPLAY CONTRAST 1 u>d Set_Property

Library

library.c

library.4th

CURRENT_SCREEN

CURRENT_SCREEN

Type

Constant

Return Value

Integer

Description

The name of a read-only GUI Toolkit property that contains the current visible screen. The CURRENT_SCREEN property is set to GUI_SCREEN0 when Initialize_GUI is called.

Usage

Get_Property ( GUI_TOOLKIT, CURRENT_SCREEN );

GUI_TOOLKIT CURRENT_SCREEN Get_Property

Library

library.c

library.4th


Home|Site Map|Products|Manuals|Resources|Order|About Us
Copyright (c) 2006 Mosaic Industries, Inc.
Your source for single board computers, embedded controllers, and operator interfaces for instruments and automation