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   

ulong Get_Property ( uint object_reference, uint property )

Get_Property( u1 \ u2 – ud | u1 = object reference, u2 = property, ud = value )

Type

Function

Input Parameters

object_reference         A 16 bit number that refers to the object whose property is to be read.

property                    A 16 bit number that specifies the property to get.

Return Value

A 32 bit number that contains the value of the property. All property values are 32 bits.

Description

A method used to read the value of a property of an object.  Errors include: INVALID_OBJECT and INVALID_PROPERTY.

Usage

longHeight = Get_Property(GUI_DISPLAY, HEIGHT_IN_PIXELS);

GUI_DISPLAY HEIGHT_IN_PIXELS Get_Property height 2!

Library

library.c

library.4th

See Also

Set_Property

GRAPHIC

GRAPHIC

Type

Constant

Return Value

Integer

Description

The name of an object type used to create new graphic objects.  Before a graphic is loaded into a screen, its IMAGE must be set using the Set_Property method.

Usage

graphicStop = New_Object ( GRAPHIC );

GRAPHIC New_Object graphicStop !

Library

library.c

library.4th

GUI_BUZZER

GUI_BUZZER

Type

Constant

Return Value

Integer

Description

The name used to refer to the buzzer of the GUI Toolkit.

Usage

Set_Property(GUI_BUZZER, BUZZER_ON, GUI_TRUE);

GUI_BUZZER BUZZER_ON GUI_TRUE Set_Property

Library

library.c

library.4th

GUI_BATTERY

GUI_BATTERY

Type

Constant

Return Value

Integer

Description

The name used to refer to the battery of the GUI Toolkit.

Usage

  // Get the battery voltage in millivolts.

longVoltage = Get_Property ( GUI_BATTERY, BATTERY_VOLTAGE );

\ Get the battery voltage in millivotls.

GUI_BATTERY BATTERY_VOLTAGE Get_Property voltage 2!

Library

library.c

library.4th

GUI_DISPLAY

GUI_DISPLAY

Type

Constant

Return Value

Integer

Description

The name used to refer to the display of the GUI Toolkit.

Usage

longHeight = Get_Property(GUI_DISPLAY,HEIGHT_IN_PIXELS);

GUI_DISPLAY HEIGHT_IN_PIXELS Get_Property height 2!

Library

library.c

library.4th

GUI_EXISTS

GUI_EXISTS

Type

Constant

Return Value

Integer

Description

The name of an error that indicates Initialize_GUI was called more than once.

Usage

Initialize_GUI( START_GUI_HEAP, END_GUI_HEAP);

If(Read_Error() == GUI_EXISTS)

{

  printf(“Don’t initialize the GUI Toolkit more than once!\n”);

  Clear_Error();

}

START_GUI_HEAP END_GUI_HEAP Initialize_GUI

Read_Error GUI_EXISTS =

if

  cr .” Don’t initialize the GUI Toolkit more than once!”

  Clear_Error

endif

Library

library.c

library.4th

GUI_FALSE

GUI_FALSE

Type

Constant

Return Value

Long

Description

A 32 bit constant equal to 0.

Usage

Set_Property(GUI_DISPLAY, BACKLIGHT_ON, GUI_FALSE);

GUI_DISPLAY BACKLIGHT_ON GUI_FALSE Set_Property

Library

library.c

library.4th

See Also

GUI_TRUE

GUI_FONT

GUI_FONT

Type

Constant

Return Value

Integer

Description

The name used to refer to the default font of the GUI Toolkit.  When Initialize_GUI is called, the GUI Toolkit property STANDARD_FONT is set to GUI_FONT which is a proportional font (i.e. the widths of each character vary depending on the character) with a height of 10 pixels. 

Usage

longHeight = Get_Property(GUI_FONT, HEIGHT_IN_PIXELS);

GUI_FONT HEIGHT_IN_PIXELS Get_Property fontHeight 2!

Library

library.c

library.4th

GUI_KEYPAD0

GUI_KEYPAD0

Type

Constant

Return Value

Integer

Description

The name used to refer to keypad 0 which is associated with GUI_SCREEN0 of the GUI Toolkit.  The GUI Toolkit has four screens and a keypad associated with each screen named GUI_KEYPAD0 to GUI_KEYPAD3. Keys must be inserted into a keypad before they become active and respond to presses.  Only keys on the keypad of the visible screen are active.

Usage

Insert_Key ( GUI_KEYPAD0, actionkeyReturn, 6 );

GUI_KEYPAD0 actionkeyReturn 6 Insert_Key

Library

library.c

library.4th

GUI_KEYPAD1

GUI_KEYPAD1

Type

Constant

Return Value

Integer

Description

The name used to refer to keypad 1 which is associated with GUI_SCREEN1 of the GUI Toolkit. The GUI Toolkit has four screens and a keypad associated with each screen named GUI_KEYPAD0 to GUI_KEYPAD3. Keys must be inserted into a keypad before they become active and respond to presses.  Only keys on the keypad of the visible screen are active.

Usage

Insert_Key ( GUI_KEYPAD1, actionkeyReturn, 6 );

GUI_KEYPAD1 actionkeyReturn 6 Insert_Key

Library

library.c

library.4th

GUI_KEYPAD2

GUI_KEYPAD2

Type

Constant

Return Value

Integer

Description

The name used to refer to keypad 2 which is associated with GUI_SCREEN2 of the GUI Toolkit. The GUI Toolkit has four screens and a keypad associated with each screen named GUI_KEYPAD0 to GUI_KEYPAD3. Keys must be inserted into a keypad before they become active and respond to presses.  Only keys on the keypad of the visible screen are active.

Usage

Insert_Key ( GUI_KEYPAD2, actionkeyReturn, 6 );

GUI_KEYPAD2 actionkeyReturn 6 Insert_Key

Library

library.c

library.4th

GUI_KEYPAD3

GUI_KEYPAD3

Type

Constant

Return Value

Integer

Description

The name used to refer to keypad 3 which is associated with GUI_SCREEN3 of the GUI Toolkit. The GUI Toolkit has four screens and a keypad associated with each screen named GUI_KEYPAD0 to GUI_KEYPAD3. Keys must be inserted into a keypad before they become active and respond to presses.  Only keys on the keypad of the visible screen are active.

Usage

Insert_Key ( GUI_KEYPAD3, actionkeyReturn, 6 );

GUI_KEYPAD3 actionkeyReturn 6 Insert_Key

Library

library.c

library.4th

GUI_PEN

GUI_PEN

Type

Constant

Return Value

Integer

Description

The name used to refer to the pen of the GUI Toolkit.

Usage

Set_Property(GUI_PEN, SHAPE, LINE);

GUI_PEN SHAPE LINE Set_Property

Library

library.c

library.4th

GUI_SCREEN0

GUI_SCREEN0

Type

Constant

Return Value

Integer

Description

The name used to refer to screen 0 of the GUI Toolkit.  The GUI Toolkit has four standard screens named GUI_SCREEN0 to GUI_SCREEN3.

Usage

Clear( GUI_SCREEN0 );

GUI_SCREEN0 Clear

Library

library.c

library.4th

GUI_SCREEN1

GUI_SCREEN1

Type

Constant

Return Value

Integer

Description

The name used to refer to screen 1 of the GUI Toolkit.  The GUI Toolkit has four standard screens named GUI_SCREEN0 to GUI_SCREEN3.

Usage

Clear( GUI_SCREEN1 );

GUI_SCREEN1 Clear

Library

library.c

library.4th

GUI_SCREEN2

GUI_SCREEN2

Type

Constant

Return Value

Integer

Description

The name used to refer to screen 2 of the GUI Toolkit.  The GUI Toolkit has four standard screens named GUI_SCREEN0 to GUI_SCREEN3.

Usage

Clear( GUI_SCREEN2 );

GUI_SCREEN2 Clear

Library

library.c

library.4th

GUI_SCREEN3

GUI_SCREEN3

Type

Constant

Return Value

Integer

Description

The name used to refer to screen 3 of the GUI Toolkit.  The GUI Toolkit has four standard screens named GUI_SCREEN0 to GUI_SCREEN3.

Usage

Clear( GUI_SCREEN3 );

GUI_SCREEN3 Clear

Library

library.c

library.4th

GUI_TOOLKIT

GUI_TOOLKIT

Type

Constant

Return Value

Integer

Description

The name used to refer to the GUI Toolkit.

Usage

Set_Property(GUI_TOOLKIT, ABORT_ON_ERROR, GUI_TRUE);

GUI_TOOLKIT ABORT_ON_ERROR GUI_TRUE Set_Property

Library

library.c

library.4th

 

GUI_TRUE

GUI_TRUE

Type

Constant

Return Value

Long

Description

A 32 bit constant equal to 0xFFFFFFFF.

Usage

Set_Property(GUI_TOOLKIT, ABORT_ON_ERROR, GUI_TRUE);

GUI_TOOLKIT ABORT_ON_ERROR GUI_TRUE Set_Property

Library

library.c

library.4th

See Also

GUI_FALSE

<< Previous | Next >>


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