User Manual Part 6

User Guide to Q4000/QPRO
Document Number 1135-4713 Rev G
THIS DOCUMENT CONTAINS CONFIDENTIAL AND PROPRIETARY INFORMATION OF QUAKE GLOBAL CORPORATION. IT MAY BE USED BY
RECIPIENT ONLY FOR THE PURPOSE FOR WHICH IT WAS TRANSMITTED AND WILL BE RETURNED UPON REQUEST OR WHEN NO LONGER NEEDED
BY RECIPIENT. DISCLOSURE TO UNAUTHORIZED THIRD PARTIES OR DUPLICATION WITHOUT THE EXPRESS WRITTEN PERMISSION OF QUAKE
GLOBAL IS PROHIBITED.
Page 144
CONFIDENTIAL
Information classified Confidential
-
Do not copy (See last page for obligations)
15.4 FFS module (Flash)
The Q4000/QPRO uses a FLASH File System (FFS). This FFS was designed specifically to be
robust and immune to problems encountered during uncontrolled power downs. FFS calls are
abstracted through a QUAKE FFS_ layer similar to the SYS layer, with calls such as
FFS_open(), FFS_read(), FFS_write(), FFS_close(). The application does not need
direct access to the FFS. However, the FFS_ calls are available if a custom application requires
them, and are intended to provide the same types of standard ‘C’ calls that are available for
accessing a UNIX file system
15.5 FTP module (File Transfer)
The FTP module implements the file transport protocol for transferring files, typically containing
large amounts of data, on terrestrial networks. Currently, FTP transfers are supported only on
the terrestrial network. The supported functions are described in the API Function Reference.
15.6 GPS module (Global Positioning System)
The GPS module supports finding the location, speed, heading, and altitude of the Q4000/QPRO
using the Global Positioning System. In addition, for Q4000/QPROs so equipped, the GPS is
used to obtain an accurate time to synchronize the real-time clock. Use of the GPS module is
demonstrated in the Turnkey sample application (see Section 2.6); however, the call to the key
GPS function GPS_read() is also made routinely in all the DemoAppXXX sample applications.
As seen in those examples, GPS_read() does everything needed to set up the GPS engine and
get a valid fix. When the fix is found, a POSITION_FIX event is posted to the application so that
the application can take appropriate action. Once a position fix has been made, the application
can retrieve the fix information using GPS_getPosData()to retrieve all the GPS information into
a structure of type GPS_Sample.
In addition, the GPS module provides a number of utility functions related to the GPS facility.
These are described in detail in the API Function Reference.
15.7 TERR module (Terrestrial)
The Terrestrial module supports communication over the terrestrial
GSM/GPRS/GSM/TCP/UDP/SMS networks. For sending a message from the application, the
module provides MSG_sendTerr(); for receiving a message, the application calls
MSG_receiveTerr(). Note also the event CELL_NET_IN_VIEW which provides information to
the application about the status of the cellular/GSM network and the fact that a MSG_ACK event is
posted when a GSM message has been successfully sent. The module provides a number of
additional utilities which may be useful in special circumstances which are described in the API
Function Reference.
15.8 ORBCOMM modules
OSI modules provide ORBCOMM support. The OSI module implements code to support the
ORBCOMM Serial Interface and related features. It is available on Q4000/QPROs with the
ORBCOMM satellite transceiver. The OSI is described in the ORBCOMM Serial Interface
Specification. A typical use of the module and transceiver is shown in the DemoAppGSM sample
application in Section 12.4.1.