QScreen Controller Users Guide

Welcome, and thanks for purchasing the QScreen Controller™. This manual provides instructions for using your new embedded computer. The QScreen Controller combines a C-programmable single-board computer with a liquid crystal display (LCD) touch panel to implement a complete graphical user interface (GUI) for your instrument. Designed as a fully-functional, compact industrial PC powered by a Freescale 68HC11 microcontroller, the QScreen is ideal for OEM applications where installation space is critical, such as embedded control systems, scientific instruments, robotics, and portable data acquisition. The QScreen can be commanded remotely from a PC or used stand-alone providing real-time control of dozens of analog and digital I/O lines.

The QScreen Controller sports a touchscreen-operated graphical user interface on a high-contrast 128x240 pixel display with a 5x4 touchscreen overlay. It comes complete with object-oriented menu software that makes it easy to control your application using buttons, menus, graphs, and bitmapped pictures.

Display your own custom graphics on a bright white-on-blue cold-cathode fluorescent (CCFL) backlit screen. You can create hundreds of sophisticated screens including your company logo, system diagrams, and icon-based control panels using basic drawing programs, such as MS Paint. Startup screens and your application program execute automatically on power-up.

Choose among many options: from 512K Flash and 128K RAM for a standard configuration up to 1M Flash and 512K RAM with the expanded memory option. For those applications that require extensive data logging, add the Compact Flash Wildcard to provide up to 2GB of mass storage.

The QScreen Controller includes a powerful microcontroller you can program either in Control C™ or QED-Forth™. It comes loaded with a real-time multitasking operating system and hundreds of precoded device drivers. Programming is a snap using the interactive debugger and multitasking executive. Libraries of hardware control routines including drawing functions for the display are preprogrammed for you. Program in ANSI C by compiling your application on your PC and downloading the code to the QScreen Controller where it is automatically executed. The real-time operating system in onboard flash memory manages all required initializations and autostarts your application code.

Control dozens of analog and digital I/O lines in real time. The QScreen Controller commands eight 8-bit A/D lines, 8 digital I/O lines including timer-controlled and PWM channels, and two RS232/485 ports. Pre-coded I/O drivers are provided for all I/O, and make it easy to do data acquisition, pulse width modulation, motor control, frequency measurement, data analysis, analog control, PID control, and communications.

Need even more I/O? The QScreen Controller hosts Mosaic’s Wildcards™, small stackable I/O modules for sophisticated and dedicated I/O. Stack up to seven Wildcards for: 16- or 24-bit resolution programmable gain A/D; 12-bit D/A; compact flash mass memory; opto-isolated AC or DC solid state relays; configurable digital I/O; additional RS232, RS422 or RS485; or high-voltage, high-current DC inputs and outputs.

The QScreen Controller is intended for use by experienced programmers up to the challenge of real-time programming. We assume that if you’re designing a product requiring an embedded computer, you have experience in the design of the hardware and software needed to customize the QScreen Controller to your product, and an understanding of the basics of writing, compiling and debugging software programs. You should be comfortable programming in either the C or Forth programming languages; you can program the QScreen Controller in either. This manual is geared to the C programmer. If you would rather program in Forth, give us a call and we’ll send you the Forth programmers manual. We recommend the following references for novice programmers:

• The C Programming Language, by Kernighan and Ritchie
• C: A Reference Manual, by Harbison and Steel

Motorola’s M68HC11 Reference Manual and MC68HC11F1 Technical Data Manual are available on this site as Adobe Acrobat Portable Document Format (.pdf) files.

This manual is laid out in several pages, in an order we hope you find most useful. The available software and hardware functions are all described in detail, and many coded examples are presented. For those who are designing "turnkeyed" instruments, we have included a complete turnkeyed application program. This well documented program illustrates how to use dozens of features, including the graphical user interface, interrupts, floating point math, formatted display of calculated results, multitasking, and automatic program startup. The source code is included with your Mosaic IDE installation. This sample program can serve as a useful template for a wide variety of applications. This manual contains the following parts:

Getting to Know Your QScreen Controller will familiarize you with the QScreen Controller and its programming environment, and Your First Program will get you writing your first program. These first pages guide you through the QScreen Controller’s hardware, explain how to establish communications with it, tell you how to install your compiler, and show you how to compile and run your first program.

After working through the above examples you will have exercised some of the key hardware and software features of your controller. You might then leaf through the C V4.4 Function Summary and GUI Function Summary to get a feel for the wealth of precoded library functions available for you to use.

With the introduction behind you, the next set of pages provide everything you need to know to master real-time programming on the QScreen Controller:

• The IDE: Writing, Compiling, Downloading and Debugging Programs
• Making Effective Use of Memory
• Real Time Programming
• Failure and Run-Time Error Recovery

Following is a set of pages that focuses on the QScreen’s hardware resources – A/D, serial communications, timer-controlled I/O, real-time clock and others – and provides examples for using each:

• Digital and Timer-Controlled I/O
• Data Acquisition Using Analog to Digital Conversion
• Serial Communications
• The Battery-Backed Real-Time Clock and Beeper

Finally, A Turnkeyed Application introduces a real-time interactive application, and provides code you can use as a template for your application. It also discusses the nuts and bolts of product integration, mounting, noise considerations and power requirements.

The appendices contains detailed specifications, pin-outs, and schematics:

• Appendix A: QScreen Electrical Specifications
• Appendix B: Connector Pinouts
• Appendix C: Schematics

There are several other important documents regarding the QScreen:

• C V4.4 Function Glossary – contains glossary entries for all precoded kernel library functions.
• QScreen Software GUI Toolkit Documentation – describes in detail how to use the GUI Toolkit to create an intuitive user interface for your instrument.
• QScreen Mechanical Drawing – shows exact dimensions and connector locations for instrument integration.

The following conventions are use throughout this manual:

We have tested and verified the sample code in this user’s guide to the best of our ability, but you may find that some features have changed, or even that we have made a mistake or two. If you find an error, please Contact Us and we’ll fix it pronto.

If you are facing a challenging software hurdle, or a hardware problem in interfacing to our products, please don’t hesitate to Contact Us. We provide free technical help to all customers, including new code examples, and can often help you over the hurdle and save you a lot of time.

Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trade-marks. Where those designations appear in this document, and Mosaic Industries, Inc. was aware of a trade-mark claim, the designations have been printed in caps or initial caps. For example, Microsoft, Microsoft Windows, and Visual Basic are registered trademarks of Microsoft Corporation.
While every precaution has been taken in the preparation of this manual, Mosaic assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.