Quake Global 96XXCS Q4000 / QPRO Satellite Module User Manual 1135 4713G GREEN Users Guide to Q4000 QPRO
Quake Global Inc. Q4000 / QPRO Satellite Module 1135 4713G GREEN Users Guide to Q4000 QPRO
Contents
Full Manual part 6
User Guide to Q4000/QPRO 14.25 SPEED_ALARM A GPS measurement completed and a speed violation occurred. The parameter [0-15] indicates which Sensor Table was used. 14.26 TIMER CONFIDENTIAL Table 14-1: Timer types and properties Timer Numbers Timer Type Description / Notes 0 - 9 Volatile Value and status of these timers are lost when the modem powers down. These timers should be used for general purpose timing requirements. On power-up, all Volatile timers are set to disabled. 10 - 19 Non-Volatile Value and status of these timers are stored in NVM. This type of timer is used when timing data relating to an event or action must be maintained during power off. When a Non-Volatile timer expires, it does not cause a wake up of the modem, but does cause a timer event to be sent to the application on the next power on. 20 - 29 Wake-Up Wake-up timers are like nonvolatile timers, except that when a power down is called, the Real-Time Clock (RTC) is programmed to wake up at the timer expiration time (if this time is less than the specified power down interval). Time-Of-Day These timers are identical to Wake-Up timers, except that the duration of the timer is specified as an absolute time of day rather than relative to the current time. Time-Of-Day Timers always expire within 24 hours. 30 - 39 14.27 TIME_SYNC The time has been received from a source such as a satellite or GSM and the real-time clock has been updated to the new time. Parameter one is the value of the change and should be converted to a signed 32 value to ensure negative adjustments are accounted for. Document Number 1135-4713 Rev G Page 140 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. Information classified Confidential - Do not copy (See last page for obligations) This occurs when a software timer expires. The parameter [0-39] indicates which timer expired. Timers may be set, examined and read using function calls such as TIMER_set(), TIMER_clear(), TIMER_checkWakeup(), TIMER_setDuration() and TIMER_getRemaining(). Note that in making calls to the timer utilities, a particular timer must be selected. It is important to select a timer with the appropriate type for the intended use. The types and properties of all timers are shown in Table 14-1. User Guide to Q4000/QPRO 14.28 USER_CMD An Over-The-Air command was received. The parameter [0-255] indicates which action to take. This is currently supported for ORBCOMM and GSM/GPRS networks. When a USER_CMD is sent, byte 0 of the data represents how many user commands will be sent. This is based on User Data Bytes 1-4 content in conjunction with User Byte 0’s value. For example, using: USER DATA BYTES • One USER_CMD event would be sent to the application. • It would be USER_CMD 255. • Notice that User Data Bytes 2-4 have no meaning. CONFIDENTIAL Example. 2: If the data bytes sent were 0x02 0xFF 0x00 0x00 0x00 • Two USER_CMD events would be sent to the application. • They would be USER_CMD 255 and USER_CMD 0. • In this case User Data Bytes 3 and 4 have no meaning. Example. 3: If the data bytes sent were 0x03 0x01 0x02 0x03 0x00 • Three USER_CMD events would be sent to the application. • They would be USER_CMD 0, USER_CMD 1 and USER_CMD 3. • In this case User Byte 4 has no meaning. Example. 4: If the data bytes sent were 0x04 0x01 0x02 0x03 0x0A • Four USER_CMD events would be sent to the application. • They would be USER_CMD 1, USER_CMD 2, USER_CMD 3, and USER_CMD 10. Document Number 1135-4713 Rev G Page 141 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. Information classified Confidential - Do not copy (See last page for obligations) Example. 1: If the data bytes sent were 0x01 0xFF 0x00 0x00 0x00 User Guide to Q4000/QPRO 15 QUAKE firmware and APIs CONFIDENTIAL Information classified Confidential - Do not copy (See last page for obligations) Figure 15-1 shows the software architecture of the modem. The customer can write applications that reside in the user space of the modem. The application makes use of the QUAKE Application Programming Interface (API) to connect to the various tasks and drivers operating on the modem. The custom application is either developed by the customer utilizing QUAKE’s API, or by QUAKE’s engineering development services. Figure 15-1: Software block diagram for fully loaded modem The QUAKE foundation is statically linked as a single module. Only one customer module may be dynamically linked to the foundation at a time. If a customer requires dynamically linked modules in their application, they must design their own methods for linking in multiple objects. Global variables are not linked between modules; however, customers may define and use their own global variables. APIs must be explicitly declared by placing them in the function table and the application cannot link to functions that are not provided in the API, even if they are in the code. To add more functions, the user may build their own function table in memory and then pass that address to other modules. That same mechanism can be used to create a ‘global structure’ that contains all ‘global variables’ that can be passed to all modules. Document Number 1135-4713 Rev G Page 142 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. User Guide to Q4000/QPRO Please see the API Function Reference for detailed explanations on how to make function calls to all the various tasks, drivers and objects operating on the modem. • QUAKE Real-Time Operating System (RTOS) • QUAKE Flash File System (FFS) • Hardware drivers ( ADC, DIO, Relay, Serial Ports, GPS, etc.) • QUAKE foundation software RTOS tasks • Digital Signal Processing executables • QUAKE code providing the event and application frameworks CONFIDENTIAL It is not necessary to understand the operation of each of these modules in detail. The API Function Reference provides the information that an application programmer is likely to need, listing the functions available, information about the parameters and returns for the functions, as well as additional notes and example code. A brief overview of the firmware modules, including an overview of the module’s purpose and description of the more common calls, is provided below. 15.1 ADC module (Analog to Digital Converter) The ADC module provides access to the analog to digital converter hardware on the Q4000/QPRO. The value of external analog inputs in the range 0 to 3.5 V applied to pins 29 and 31 of the external connector, may be read using the ADC_readChannel() function. As noted in the API Function Reference, ADC_readChannel() should be called from a single task, usually the application task. 15.2 APL module (Applications) The APL module implements certain features which may be needed by specific applications. If an application is designed to handle a specific AT command set, such as from an external modem, APL_registerATCmdHandler() is used to register the handler for that device. Messages specific to that type of AT command are sent to the application using the queue set up by the function APL_msgQueueCreate(). Executables that an application needs to download can be transferred into application memory via APL_loadObjects(). Other related APIs are provided by the module described in the API Function Reference. 15.3 DIO module (Digital Input/Output) There are 8 digital input/output lines on the Q4000/QPRO, accessed through pins 32-39. The DIO module provides APIs to manipulate this hardware. Lines may be configured individually as either inputs or outputs using the DIO_config(chan, direction) function, where the second parameter may be either DIO_INPUT (0) or DIO_OUTPUT (1). All DIOs configured as inputs have a weak pull-down resistor in the input circuitry, so an open is reliably sensed as low. The 8 lines may be read as a group using DIO_readAll(). The nth bit in the value returned by the call will be 1 or 0 when the nth channel is high or low, respectively. Lines configured as outputs may be written by DIO_writeChannel(). Document Number 1135-4713 Rev G Page 143 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. Information classified Confidential - Do not copy (See last page for obligations) QUAKE modems contain factory-installed foundation firmware that consists of the following components: User Guide to Q4000/QPRO 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 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. CONFIDENTIAL 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. Document Number 1135-4713 Rev G Page 144 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. Information classified Confidential - Do not copy (See last page for obligations) 15.5 FTP module (File Transfer) User Guide to Q4000/QPRO An ORBCOMM packet is constructed specifying a particular type of ORBCOMM message, based on packet descriptions in the ORBCOMM Serial Interface Specification. The packet is queued to the OSI using MSG_queueOsiPkt(). The module contains utilities as well as functions to read and write ORBCOMM parameters (CFG_getValOrb()and CFG_setValOrb()). The QUAKE event structure provides the application easy access to much of the ORBCOMM functionality; for example, in the SAT_IN_VIEW, MESSAGE_ACK, and RX_SER_PKT cases, which are executed when the corresponding event is posted. A message received by the Q4000/QPRO is handled by the application in the appropriate sub-case of the RX_SER_PKT case. CONFIDENTIAL The J1939 module supports use of the Controller Area Network (CAN) hardware, and the protocols using CAN. Currently, J1939 is the only CAN protocol supported. Most calls to setup and configure the CAN hardware and J1939 stack are handled automatically by the foundation code. Typically, an application would request a J1939 message containing a particular Parameter Group Number (PGN) using the call J1939_getPgnMsg(). The structure for a QCAN_J1939Msg can be found in User_libQuake.h. The offsets for various SPNs (Suspect Parameter Numbers) in the message data buffer are specified by the Society of Automotive Engineers (SAE), and described in their document, J1939-71. In the DemoAppCAN example, the application requests and receives a specific PGN and SPN from the message. The application structure is set to field a CAN_MSG event, in the corresponding CAN_MSG case. In the rare case in which a desired PGN is not spontaneously transmitted on the bus, an request for that PGN must be transmitted, using the API call J1939_txRequestMsg(). 15.10 QCFG module (Configuration) The QCFG module provides an interface to manipulate QUAKE’s configuration parameters. The current set of QUAKE parameters may be viewed from the Logger port of the Q4000/QPRO; in the Logger type ‘U’ ‘C’ ‘v’. Parameters may be numeric or strings. The API call to this module is QCfg_getQCfgPtr(), which returns a pointer to the configuration structure. 15.11 QEV module (Events) The QEV module implements functions related to QUAKE’s event processing. The application relies on the event processing supported in the foundation code, by executing code when specific events are posted to the application. This activity can be seen in all of the DemoApps in Section 12.4. In addition, the application may post an event by calling QEV_sendEvent(). The public APIs in this module also provide the utility, QEV_getEventDefinition(), which returns a pointer to the name of the event whose number is passed as a parameter. 15.12 QLM module (Logger) The Logger port of the QUAKE modems provides a wealth of information and functionality. Typically, messages about modem status such as downlink information, state transitions, or error messages are printed to the Logger port. Debug and Utility menus and features are accessed from the Logger port. The QLM module’s public APIs allow the application to post messages to the Logger using LOG_print() or to suspend Logger output entirely using LOG_suspend(). The function, LOG_logErrorMsg()provides a way to print error messages to the Logger, Document Number 1135-4713 Rev G Page 145 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. Information classified Confidential - Do not copy (See last page for obligations) 15.9 J1939 module (Controller Area Network - CAN) User Guide to Q4000/QPRO complete with the name of the function in which the error occurred, the line number, and a string identifying the type of error. Note: The message packet should not be freed by the application; this is done by the foundation code. The QMM module implements QUAKE’s Message Manager. The firmware code in the module checks for network availability, and handles the details of transferring messages from one network to another based on availability. This is all transparent to the application. The primary public API implemented in this module is MSG_send(); this and other APIs for actions such as deleting messages and getting a current message count are described in the API Function Reference. CONFIDENTIAL 15.14 SYS module (System) On the Q4000/QPRO, the Real-Time Operating System (RTOS) is abstracted to QUAKE calls so that regardless of any changes to the underlying RTOS calls, the APIs available on QUAKE modems remain constant. This abstraction is performed by the SYS module. Functionality to manage tasks and message queues is provided with names like SYS_taskCreate() or SYS_taskSuspend()which clearly indicate the functionality to any application developer familiar with using an RTOS on an embedded target. For most applications, no direct calls to the SYS module need to be made since the foundation code and the event driven architecture allow complex applications to be developed without direct calls to the RTOS. For those applications that need direct RTOS access, however, it is provided by the SYS module. SYS_pwrDown() is used to power down the Q4000/QPRO in a controlled fashion. Everything is shut off cleanly in the correct order, ensuring that on a subsequent reboot no data will have been lost and the Q4000/QPRO is in an appropriate state. 15.15 SERIAL module Access to the serial ports is provided by the QUAKE Serial Manager module. One goal in developing SERIAL was to provide a high-level serial interface that allows different tasks, such as OSI, QCT, or an AT protocol, that are managing different serial protocols, to share a single physical serial port. These sorts of activities are handled by the foundation and should not be needed by the application. Calls to SERIAL_readBytes() and SERIAL_write() allow the application to read and write to the serial ports. The UARTPORTS are enumerated in User_libQuake.h. SERIAL_openPort and SERIAL_closePort are provided, as well as SERIAL_portFlush, and are described in the API Function Reference. 15.16 RELAY module The RELAY module provides access to the relay hardware on the Q4000/QPRO. Four relay lines are implemented. Two of them, UBATT0 and UBATT1, when asserted, provide closure to the supply voltage at pins 25 and 27, respectively. The other two, GND0 and GND1, when asserted, provide closure to ground at pins 26 and 28. The RELAY_CHAN_NAME type is enumerated in User_libQuake.h. The RELAY module APIs allow the application to read the state of the lines or assert or deassert the lines by individual channel number. Document Number 1135-4713 Rev G Page 146 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. Information classified Confidential - Do not copy (See last page for obligations) 15.13 QMM module (Messages) User Guide to Q4000/QPRO 15.17 UART module The UART module provides direct access to the serial hardware on the Q4000/QPRO. Application access to the serial ports should be made through the SERIAL module, described in Section 15.15. SERIAL allows the foundation firmware to exercise more control and oversight. For those applications requiring more direct access, the public API to the UART module is UART_ioctl(), which allows the parity, stop bits and baud rate to be set for serial ports. 15.18 UTL module (Utilities) 15.19 VSWR module (Voltage Standing Wave Ratio) CONFIDENTIAL The single public API in the VSWR module is ANT_readVswrOrb(). This reports the last VSWR reading of the ORBCOMM antenna. Notes in the API Function Reference give details on interpreting the reading. Document Number 1135-4713 Rev G Page 147 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. Information classified Confidential - Do not copy (See last page for obligations) The UTL module proves a number of utility functions. Some allow manipulation of the QUAKE software counters and timers, such as CNTR_set(), and CNTR_read() or the system’s realtime clock, such as SYS_readSeconds(). The API Function Reference should be consulted for a current list with complete descriptions. User Guide to Q4000/QPRO Appendix A - ORBCOMM configuration parameters Table A-1: ORBCOMM configuration parameters Name Def. Value Min Value Max Value DTE Access Description Personal Identification Number, used 0x00 pin_code 1234 9999 R/W as a security measure Instructs modem to acquire satellite 1 (U.S.) 0x01 desired_gwy_id 255 R/W connected to this ORBCOMM Gateway Additional notes: This parameter should be set according to where the application/modem will be located. If the modem is only used in North or South America this parameter should be set to 1. If the application/modem is located in Japan, it should be 130. The rest of the world should be set to 120. For mobile applications that are not specific not one area please consider use of the Auto-roaming feature (parameter 0x8b). More information on this feature may be found below. Modem-Originated messages polled by ORBCOMM Gateway or initiated 0x02 def_polled R/W by modem (see OSI Section 3.2, note 1). Type Codes 1, 4, and 5 are supported. Default acknowledgement level for messages (see OSI Section 3.2 note 0x03 def_ack_level R/W 3). Note: Values other than 2 are not recommended. Default Report O/R Indicator (see 0x04 def_rep_or_ind R/W OSI Section 3.2, note 4) Additional notes: This parameter is used for setting the O/R indicator that will be associated with the ‘Default Report’ message type. All Default Reports will be routed to the specified O/R indicator. Default Message O/R Indicator (see 0x05 def_msg_or_ind 15 R/W OSI Section 3.2, note 4) Additional notes: This parameter is used for setting the O/R indicator that will be associated with the ‘Default Message’ message type. All Default Messages will be routed to the specified O/R indicator. Default Priority Level (see OSI 0x06 def_priority R/W Section 3.2 note 5) Default Priority Level (see OSI 0x07 def_msg_body_type 14 15 R/W Section 3.2 note 6). Note: Only values 0 and 14 are supported. Additional notes: This parameter primarily comes into play when using email as a delivery method for modem-O messages. The only two supported modes are 0 (data will be received in the form of AmodemII text within the email message body) or 14 (data will be received as a binary data attachment to the email). If using direct IP a setting of 14 should be used. Default Service Type for reports (see OSI Section 3.2 note 2). Note: 0x08 def_serv_type 15 R/W Values other than 2 are not recommended. 0=continuously search downlink band for desired GWY; 1=search band once for desired GWY, if not found then maintain lock with first discovered downlink; 2=maintain lock with first discovered downlink; 3=search band once for desired 0x09 gwy_search_mode R/W GWY, if found, open search to include any ORBCOMM GWY, if none found, maintain lock with first discovered downlink; 4=search band once for desired GWY, if not found, continuously search band for downlink having no ORBCOMM Gateway or desired GWY Document Number 1135-4713 Rev G Page 148 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. Information classified Confidential - Do not copy (See last page for obligations) CONFIDENTIAL Num User Guide to Q4000/QPRO Def. Min Max DTE Description Value Value Value Access Additional notes: This parameter defines the way in which the modem will connect to satellites as they come into view. It works in conjunction with parameter 0x01 (desired_gwy_id). By default the modem will only connect to satellites that are attached to the desired gateway. If using global grams a setting of 3 or 4 is recommended so that the modem can connect with satellites that are not attached to a gateway (this condition is required to send a global gram). Using a setting of 3 or 4 in conjunction with Auto Roaming (0x8b) enabled will allow the modem to connect and send messages to different gateways automatically (see Auto Roaming description for more information). Route outbound messages/ commands to: 0=local application 0x0a ob_route R/W task; 1=serial port; 2=both. This value should be 0 for QCP. 0x0b inactive_interval 86400 R/W NOT SUPPORTED State of modem message transport processes: 0=Idle; 1=Sending modem-Originated message; 2=Sending modem-Originated report; 3=Sending modem-Originated Globalgram; 4=Receiving modemTerminated message; 5=Receiving 0x0c sc_state 10 modem-Terminated command; 6=Receiving modem-Terminated Global Gram; 7=Performing self-test; 8=Performing local loop-back; 9=performing ORBCOMM Gateway loop-back test (may require a minute or two, depending on Satellite availability) modem Diagnostics Result Code 0x0d sc_diag_code ----R (See OSI Section 3.2 note 9) Active MHA Message Reference 0x0e active_mha_ref_num 255 number (255 = no messages) Number of Current Satellite in View (0 if no satellite in view). Note: 0x0f sat_in_view 255 Currently this parameter returns only 0 or 1 (0=no satellite in view, 1=satellite in view) List of IDs of ORBCOMM Gateways 0x10 gwy_id_list ------R connected to the current satellite List of minimum acceptable message priorities for each Gateway identified 0x11 min_gwy_pri_list ------R in parameter 0x10, in the same order as the Gateways identified in param0x10 Numb Def. Min Max DTE Name Description er Value Value Value Access 0x12 msg_queue_size ------R NOT SUPPORTED 0x13 sco_msg_queue_size ------R/W NOT SUPPORTED 0x14 sct_msg_queue_size ------R/W NOT SUPPORTED Number of modem-Terminated 0x15 queue_ob_msgs ------R messages in queue Number of modem-Originated 0x16 queue_ib_msgs --0 --R messages in queue UTC time week (0 = week starting 0x17 week_bytes --0 --R/W Sunday January 6, 1980 00:00:00 UTC) 24-bit integer representing the number of seconds since 00:00:00 0x18 time_bytes --0 604799 R/W UTC of the previous Sunday (resets 12:00 A.M. Saturday night / Sunday morning) 0x19 total_sats ------R Total number of satellites in system 0x1a stored_sats --R NOT SUPPORTED 0x1b pos_calc_active R/W NOT SUPPORTED 0x1c pos_age --0 65535 NOT SUPPORTED Name Document Number 1135-4713 Rev G Page 149 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. Information classified Confidential - Do not copy (See last page for obligations) CONFIDENTIAL Num User Guide to Q4000/QPRO Def. Value Min Value Max Value DTE Access Description Coded geodetic latitude 0: North Pole, 0xffffff: South Pole Coded geodetic longitude 0: 0x1e lon_code --0 0xffffff R/W Greenwich Median, increasing in eastern direction NOT SUPPORTED - DO NOT 0x1f msg_requeue_opt R/W MODIFY 0x20 poll_response_timeout 30 R/W NOT SUPPORTED Number of successive packet retries 0x21 ser_max_retries 255 R/W without receiving valid ACK before discarding packets Additional notes: This parameter works in conjunction with parameter 0x22 (ser_pkt_timeout). It specifies the number of attempts the modem will make to re-send a packet (to the application) that it does not receive a valid Link Level Acknowledgement (LLACK) packet for. For example: The modem receives a modem-T message from the network and ser_max_retries (0x21) is set to a value of 3. The modem will make its initial attempt to send this packet to the application. If the application does not return a valid LLACK packet, the modem will wait X number of seconds (specified by parameter 0x22) and then try to resend the packet. In this example, it would retry 3 times before discarding the packet. Number of seconds modem waits for 0x22 ser_pkt_timeout 30 R/W ACK after sending last byte of a packet before resending Additional notes: As mentioned above, this parameter specifies the number of second the modem will wait between retrying to send a packet to the application that it did not receive a valid LLACK packet for. Abort Response 0: do nothing, 1: 0x23 abort_response R/W send abort report Abort Report values of ncc_id, 0x24 abort_report ------W polled, serv_type, or_ind, and info bytes 0-5 for abort report 0x25 ops_mode R/W NOT SUPPORTED Sending packets/bytes to DTE: 0: deactivated DTR stops it 0x26 ob_flow_cntl 1: activated RTS stops it 2: either 3: no outbound flow control 0x27 ib_flow_cntl NOT SUPPORTED 0: Not enabled 1: DSR activated if one or more 0x28 DSR_treatment modem-Terminated messages queued in modem (Used with parameter 0x26) DTE baud rate (MTS Port) 4: 4800, 0x29 baud_rate 10 R/W 5: 9600, 6: 19200, 7: 38400, 8: 57600, 9: 76800, 10: 115200 Additional notes: This parameter can be used to modify the baud rate of the MTS port. 0x2a parity_bits R/W DTE parity 0: none, 1: odd, 2: even 0x2b stop_bits R/W DTE stop bits 0x2c data_bits R/W DTE data bits NOT SUPPORTED (MTS Port is full 0x2d duplex R/W duplex) Test Mode 0: normal operation 1: echo downlink data to DTE 0x2e test_mode R/W 2: echo uplink data to DTE 3: echo both to DTE 4: echo DTE to uplink as reservation burst 0: receiver power controlled by DTE DTR signal 0x2f pwr_down_mode 1: receiver power controlled by rcvr_power parameter Additional notes: When this parameter is set to 0 the modem will power down when DTR is deasserted. 0x30 active_set_id R/W NOT SUPPORTED 0x31 serial_num ------R modem Serial Number 0x1d CONFIDENTIAL Name lat_code Document Number 1135-4713 Rev G --- 0xffffff R/W Page 150 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. Information classified Confidential - Do not copy (See last page for obligations) Num Num Name Def. Value Min Value Max Value DTE Access 0x32 sw_version --- --- --- 0x33 hw_version --- --- --- Numb er Name Def. Value Min Value Max Value DTE Access Description Modem software version. For example, July 5, 2005 will return decimal 7055. NOT SUPPORTED Description modem Serial Interface Specification revision supported 4: QUAKE Global, Inc. NOT SUPPORTED Most recent downlink channel NOT SUPPORTED NOT SUPPORTED 0. Receiver OFF 1. Listen to DL 6/16 2. Receiver continuously ON When 1, passes Ephemeris, Satellite plane orbital elements packets to Application/DTE 0x34 ser_spec_rev 'G' 'G' --- 0x35 0x36 0x37 0x38 0x39 manu_id pos_det_supported most_recent_dl dl_chan_list debug_lvl ----5 50 --0 349 --5 R/W 0x3a rcvr_power R/W 0x3b send_pass_predict 0x3c 0x72 0x73 0x74 0x78 0x79 0x7f RESERVED FOR FUTURE ORBCOMM USE initial_pos_det DOPPLER POSITIONING PARAMETERS --- --- --- --- --- NOT SUPPORTED --- --- --- --- NOT SUPPORTED BYTE MODE PARAMETERS --- --- --- --- NOT SUPPORTED See Appendix B QUAKE’s ORBCOMM configuration parms (QCFG) --- --- --- --- QUAKE-specific configuration parameters 0x80 0xff Document Number 1135-4713 Rev G Page 151 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. Information classified Confidential - Do not copy (See last page for obligations) CONFIDENTIAL User Guide to Q4000/QPRO User Guide to Q4000/QPRO Appendix B - QUAKE’s ORBCOMM configuration parms (QCFG) Table B-1: QUAKE’s ORBCOMM configuration parameters Def Val Min Val Max Val 0x82 QCFG_TL_LOGGING 0x83 QCFG_DLEVPROC_LOG_LEVEL 0x84 QCFG_ULMGR_LOG_LEVEL 0x85 QCFG_SPP_LOG_LEVEL 0x86 QCFG_MODEM-TMGR_LOG_LEVEL 0x87 QCFG_MODEM_LOG_LEVEL 0x88 QCFG_OSPM_LOG_LEVEL 0x89 QCFG_MSN_SAVE_OPTION 0x8b QCFG_MTS_AUTO_ROAMING_ENA 0x8c QCFG_QLM_LOG_MASK 900 30 CONFIDENTIAL 0x80 QCFG_LOG_DEBUG_LEVEL 0x81 QCFG_GPS_LOGGING 0x8d QCFG_DUPL_USR_CMD_TIME_S DTE Description Access R/W Logger Port log level R/W GPS Task debug logging enable R/W 0: Not enabled 1: Enable Transport Layer debug logging (must be set for prms 0x83-0x88 to take effect) R/W Downlink Event Proc Task debug level R/W Uplink Mgr Task debug level R/W Serial Pkt Proc Task debug level R/W modem-T Msg Mgr Task debug level R/W TL modem Task debug level R/W OB Serial Pkt Mgr Task debug level R/W 0: Save MSN data to flash on [controlled] power down only 1: Save MSN data to flash on any change R/W 0: Not enabled 1: Enable Auto-Roaming for message packets received on MTS Port - Not supported 3600 R/W Number of seconds for which User Command duplicates will be discarded 0x8e QCFG_POWER_SAVING_MASK - Not supported 0x90 QCFG_PREF_NETWORK 0 – GSM first 1 – ORBCOMM first 2 – GSM only 3 – ORBCOMM only 0x92 QCFG_MDMIF_PORT Do not change 0x94 QCFG_DBG_UTILITY_LEVEL R/W Debug mode log level 0x95 QCFG_MTS_ARCHIVING_ENA R/W 0: Not enabled 1: Enable message archiving to flash memory of message packets received on MTS port Additional notes: When this parameter is enabled modem-O messages will be stored in NVM. If the modem loses power or is put into sleep mode it will retrieve any unsent messages at boot up and return them to the message queue. 0x98 QCFG_MODEM_APN_USER None User login name if required Document Number 1135-4713 Rev G Page 152 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. Information classified Confidential - Do not copy (See last page for obligations) Num Name User Guide to Q4000/QPRO CONFIDENTIAL 0x99 QCFG_MODEM_APN_PASS 0x9a QCFG_OSI_IB_ROUTE Def Val None Min Val Max Val DTE Description Access User password if required R/W Route inbound messages/commands to: 0=Application; 1=Transport Layer; 2=Both 0x9b QCFG_MODEM_BAND Not supported 0x9d QCFG_MODEM_APN_ADDRESS Network provider name. Default: ORBCOMM.tmobile.com 0x9e QCFG_MODEM_CONNECT_DUR_S 90 65535 If there’s no data exchange within this timeout period (seconds) the connection is closed. 0 for no timeout 0x9f QCFG_EXT_MODEM_ID_INTERVAL 65535 R/W ID Message interval (in seconds). 0xa0 QCFG_MDMIF_BAUD_RATE - Not supported 0xa1 QCFG_REQUEST_GLOBALGRAMS R/W 0: Not Enabled 1: Automatically send a Communications Command 2 (Request Globalgrams) to satellites that come into view Additional notes: This parameter (0xa1) must be enabled in order to receive modem-T Globalgrams. When set to 1 the modem will send a request to each satellite passing over that is in Globalgram mode requesting any modem-T Globalgrams. 0xa2 QCFG_POS_FILTER_MAX_VEL 50 65535 R/W Max. allowed speed in GPS position samples (meters per Second). GPS samples with a larger speed will be discarded 0xa3 QCFG_POS_FILTER_MAX_DIFF 25 100 R/W Max. allowed difference in change in distance vs. speed × change in time between successive GPS samples (%). Higher values (50-75%) can reduce average time-to-fix (particularly in high acceleration scenarios) but will reduce outlier rejection effectiveness. Set to 100 to disable this algorithm 0xa4 QCFG_SMTP_SERVER_ADDR None Address of SMTP mail server 0xa5 QCFG_SMTP_SERVER_PORT 25 65535 SMTP port (generally 25) 0xa6 QCFG_SMTP_USER None SMTP account user name 0xa7 QCFG_SMTP_PASS None SMTP account password 0xa8 QCFG_SMTP_TO_ADDR None Default email address to which to send messages 0xa9 QCFG_SMTP_SUBJ None Default subject of the email 0xaa QCFG_POP_SERVER_ADDR None None None R/W POP server address 0xab QCFG_POP_SERVER_PORT 25 65535 R/W POP port 0xac QCFG_POP_USER None None None R/W Pop username 0xad QCFG_POP_PASS None None None R/W Pop password Document Number 1135-4713 Rev G Page 153 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. Information classified Confidential - Do not copy (See last page for obligations) Num Name User Guide to Q4000/QPRO 0xae 0xaf 0xb0 0xb1 0xb2 0xb3 QCFG_GLSS_CHAN QCFG_GLSS_RETRY_COUNT QCFG_GLSS_MIN_INTERVAL_S QCFG_GLSS_MAX_INTERVAL_S QCFG_MDMIF_IRI_PORT QCFG_AUX_BAUD_RATE 0xb4 QCFG_MTS_BAUD_RATE 0xb5 QCFG_POWER_DOWN_MODE DTE Description Access R/W R/W R/W R/W R/W R/W GlobalStar channel GlobalStar retry count GlobalStar minimum interval GlobalStar maximum interval Iridium port Note that the maximum speed of the AUX is 57600 bps 1200 115200 R/W R/W 1=power down when DTR goes low 1.2.345 R/W Version 1.2, SVN (3456), 6.789 Coverity (789) 4800 CONFIDENTIAL 0xb6 QCFG_SOFTWARE_VERSION Def Min Max Val Val Val N/A N/A 20 N/A 30 300 N/A 60 600 N/A 19200 1200 115200 Document Number 1135-4713 Rev G Page 154 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. Information classified Confidential - Do not copy (See last page for obligations) Num Name User Guide to Q4000/QPRO Appendix C - QUAKE’s Iridium & Inmarsat config parms (QCFG) Table C-1: QUAKE’s Iridium and Inmarsat configuration parameters Name Def Val Min Val Max Val Access 0x81 QCFG_GPS_LOGGING R/W 0x82 QCFG_TL_LOGGING R/W 0x83 QCFG_DLEVPROC_LOG_LEVEL R/W 0x84 QCFG_ULMGR_LOG_LEVEL R/W 0x85 QCFG_SPP_LOG_LEVEL R/W 0x86 QCFG_MODEM-TMGR_LOG_LEVEL R/W 0x87 QCFG_MODEM_LOG_LEVEL R/W 0x88 QCFG_OSPM_LOG_LEVEL R/W 0x89 QCFG_MSN_SAVE_OPTION R/W 0x8b QCFG_MTS_AUTO_ROAMING_ENA R/W 900 30 3600 R/W 0x8e QCFG_POWER_SAVING_MASK 0x90 QCFG_PREF_NETWORK 0x92 QCFG_MDMIF_PORT 0x94 QCFG_DBG_UTILITY_LEVEL 0x95 QCFG_MTS_ARCHIVING_ENA CONFIDENTIAL 0x80 QCFG_LOG_DEBUG_LEVEL 0x8c QCFG_QLM_LOG_MASK 0x8d QCFG_DUPL_USR_CMD_TIME_S DTE R/W R/W Description Level of logging messages output GPS Task debug logging enable 0: Not enabled 1: Enable Transport Layer debug logging (must be set for prms 0x83-0x88 to take effect) Downlink Event Proc Task debug level Uplink Mgr Task debug level Serial Pkt Proc Task debug level modem-T Msg Mgr Task debug level TL modem Task debug level OB Serial Pkt Mgr Task debug level 0: Save MSN data to flash on [controlled] power down only 1: Save MSN data to flash on any change 0: Not enabled 1: Enable Auto-Roaming for message packets received on MTS Port Not supported Number of Seconds for which User Command duplicates will be discarded Not supported 0 – GSM first 1 – Sat first 2 – GSM only 3 – Sat only Debug Mode log level 0: Not enabled 1: Enable Message Archiving to flash memory of msg packets received on the MTS Port Additional notes: When this parameter is enabled, modem-O msgs will be stored in NVM. If the modem loses power or is put into sleep mode it will retrieve any unsent msgs at boot up and return them to the msg queue. 0x98 QCFG_MODEM_APN_USER 0x99 QCFG_MODEM_APN_PASS Document Number 1135-4713 Rev G None None User login name if required User password if required Page 155 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. Information classified Confidential - Do not copy (See last page for obligations) Num User Guide to Q4000/QPRO Name Def Val Min Val Max Val 0x9e QCFG_MODEM_CONNECT_DUR_S 90 65535 0x9f QCFG_EXT_MODEM_ID_INTERVAL 65535 R/W 0xa0 QCFG_MDMIF_BAUD_RATE 0xa1 QCFG_REQUEST_GLOBALGRAMS R/W 0xa2 QCFG_POS_FILTER_MAX_VEL 50 65535 R/W 0xa3 QCFG_POS_FILTER_MAX_DIFF 25 100 R/W 65535 CONFIDENTIAL 0x9b QCFG_MODEM_BAND 0x9d QCFG_MODEM_APN_ADDRESS DTE Access 0xa4 QCFG_SMTP_SERVER_ADDR None 0xa5 0xa6 0xa7 0xa8 QCFG_SMTP_SERVER_PORT QCFG_SMTP_USER QCFG_SMTP_PASS QCFG_SMTP_TO_ADDR 25 None None None 0xa9 0xaa 0xab 0xac 0xad 0xb2 0xb3 QCFG_SMTP_SUBJ QCFG_POP_SERVER_ADDR QCFG_POP_SERVER_PORT QCFG_POP_USER QCFG_POP_PASS QCFG_MDMIF_IRI_PORT QCFG_AUX_BAUD_RATE None None 25 None None 19200 None None R/W 65535 R/W None None R/W None None R/W R/W 1200 115200 R/W 0xb4 QCFG_MTS_BAUD_RATE 0xb5 QCFG_POWER_DOWN_MODE 4800 1200 115200 0xb6 QCFG_SOFTWARE_VERSION 1.2.34 56.789 Document Number 1135-4713 Rev G R/W R/W R/W Description Not supported Network provider name Default: ORBCOMM.tmobile.com If there’s no data exchange within this timeout period (seconds) the connection is closed. 0 for no timeout ID Message interval (in seconds). Not supported This is not a valid parameter for nonORBCOMM modems. It is ignored by them. Max. allowed speed in GPS position samples (meters per Second). GPS samples with a larger speed will be discarded Max. allowed difference in change in distance vs. speed × change in time between successive GPS samples (%). Higher values (50-75%) can reduce average time-to-fix (particularly in high acceleration scenarios) but will reduce outlier rejection effectiveness. Set to 100 to disable this algorithm Address of SMTP Mail Server SMTP Port (generally 25) SMTP Account User Name SMTP Account Password Default email address to send messages to Default subject of the email POP server address POP port Pop username Pop password Iridium port Note that the maximum speed of the AUX port is 57600 bps 1=power down when DTR goes low Version 1.2, SVN (3456), Coverity (789) Page 156 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. Information classified Confidential - Do not copy (See last page for obligations) Num User Guide to Q4000/QPRO Appendix D - Debug and utility menus QUAKE Global provides a large group of debug and utility menus which are accessible via the Logger port. These menus allow the user to send and receive messages and email, view operational performance, conduct serial tests and many more functions. Some of the menus require a password and are accessible to QUAKE personnel only. The menus are accessible from the Logger port using the following settings: 115200 bps None None CONFIDENTIAL Two different commands can be used to enter the menus, either ‘d’ (debug) or ‘U’ (utility). Each command will display a listing of debug or utility menus respectively. Each menu can be entered by typing the corresponding letter code in the list. The list of letter codes for either menu can be displayed by typing ‘?’. For example, ‘d’ ‘?’ gives the list of letter codes (commands) for all the debug menus listed under ‘d’. Figure E-1: Debug menus available from ‘d’ ‘?’ Document Number 1135-4713 Rev G Page 157 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. Information classified Confidential - Do not copy (See last page for obligations) Baud rate: Data bits: Parity: Stop bits: Flow control: User Guide to Q4000/QPRO Information classified Confidential - Do not copy (See last page for obligations) Additional utility commands are available by typing ‘U’ ‘?’: CONFIDENTIAL Figure E- 2, Debug menus available from 'U' '?' Note: See section 7.2.1 for examples of using the menu commands on the Logger port. Document Number 1135-4713 Rev G Page 158 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. User Guide to Q4000/QPRO Appendix E - Software file naming convention The name of a code file follows the format:- -aa.bb.cccc.dd- .bin where: Product Label is defined in • Table E-1 • File Type is defined in Table E-2 • Hardware Features Label is defined in CONFIDENTIAL Information classified Confidential - Do not copy (See last page for obligations) • Document Number 1135-4713 Rev G Page 159 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. User Guide to Q4000/QPRO • Table E-3 • aa is the Major version • bb is the Minor version • cccc is the Subversion build • dd is the Coverity Checker ID • File Identifier is defined in Table E-4 Example: CONFIDENTIAL Table E-1: File naming – Product label Product Label Description Q4K Q1K QPRO (for applications and foundation code produced before 4/9/2011) Q4000 Q1000 QPRO-3G Q4KI (for applications produced before 4/9/2011) Iridium application Table E-2: File naming – File type File Type Description a Foundation image an application image Document Number 1135-4713 Rev G Page 160 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. Information classified Confidential - Do not copy (See last page for obligations) Q4Kf-HGT-2.20.5434.10452-ENC.bin User Guide to Q4000/QPRO Table E-3: File naming – Hardware features label Hardware Features Label ONN Description ORBCOMM GGT HGT IGT H3T JGT Globalstar, GSM, Trimble ORBCOMM, GSM, Trimble Iridium, GSM, Trimble ORBCOMM, 3G, Trimble InmarSat, GSM, Trimble Description ENC an encrypted, loadable image the name of the application. If the app is customer-specific image the value will be the customer name. CONFIDENTIAL File Type Document Number 1135-4713 Rev G Page 161 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. Information classified Confidential - Do not copy (See last page for obligations) Table E-4: File naming – File identifier User Guide to Q4000/QPRO ADC API BPS CAN CD CR DIO DTE DTR EDA FFS FTP GPRS GPS GSM GUI ICD IDE IMS LEO LF LSB MHz MID MO MT MTS NCC NVM O/R OSI OTA PGN POP QCFG QCP QCT QFFS QMM QRTOS RPM RTC RTOS Analog to Digital Converter Application Programming Interface Bits per Second Controller Area Network Carrier Detect Signal Carriage Return Digital Input/Output Data Terminal Equipment Data Terminal Ready signal Event Driven Architecture Flash File System File Transport Protocol General Packet Radio Service Global Positioning System Global System for Mobile communications Graphical User Interface Interface Control Drawing Integrated Development Environment International Mobile Subscriber identify Low Earth Orbit Line Feed Least Significant Bit Megahertz Message Identification Mobile Originated (Iridium network) Mobile Terminated (Iridium network) Main Transport Socket Network Control Center Non-Volatile Memory Originator/Recipient ORBCOMM Serial Interface Over the Air Parameter Group Number Post Office Protocol QUAKE Configuration Parameters QUAKE Configuration Protocol QUAKE Configuration Tool QUAKE Flash File System QUAKE Memory Manager QUAKE Real-time Operating System Revolutions Per Minute Real-time Clock Real-time Operating System Document Number 1135-4713 Rev G Information classified Confidential - Do not copy (See last page for obligations) CONFIDENTIAL Appendix F - Glossary of terms Page 162 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. User Guide to Q4000/QPRO Society of Automotive Engineers Short Burst Data Simple Mail Transfer Protocol Universal Asynchronous Receiver/Transmitter Voltage Standing Wave Ratio Very High Frequency CONFIDENTIAL Information classified Confidential - Do not copy (See last page for obligations) SAE SBD SMTP UART VSWR VHF Document Number 1135-4713 Rev G Page 163 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. User Guide to Q4000/QPRO 16 Active Graveyard (where to place?) CONFIDENTIAL Information classified Confidential - Do not copy (See last page for obligations) 16.1 DTR handling (used to be in 9.6 Working with Turnkey) Document Number 1135-4713 Rev G Page 164 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. User Guide to Q4000/QPRO 17 Load conditions • send messages on the GSM/GPRS port at 115200 bps continuously • send messages via satellite network continuously • use MTS port at 115200 bits per second (bps) • use AUX port at 115200 bps The AUX port • maximum speed is 57600 bps • may not be available on certain configurations of the Q4000/QPRO. The Q4000/QPRO with Iridium or Inmarsat, for example, does not have the AUX port available. CONFIDENTIAL Note: • continuously obtain GPS fixes • run Logger port at debug level 6 • access CAN bus messages by providing the desired PGN. • As long as filtering is done in foundation, a fully loaded CAN bus at 250 Kbps is supported. Raw CAN bus filtering cannot be done at the application level because the input queue can quickly overflow if the ORBCOMM module is running (see Note below). • continuously run OSI protocol at 115200 • perform OTA upgrades • CPU load can reach 85-90% during these loading conditions. Note: For CAN usage: • at high load and 30 PGNs, CPU usage is 26% • at moderate load and 30 PGNs, CPU usage is 16% • adding the reception of 10 PGNs per second increases the load by 2-3%. Note: The Logger port, if used by the customer to receive data, should not be run above 19200. It could drop bytes otherwise. The Logger port should be used for debugging purposes only. Document Number 1135-4713 Rev G Page 165 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. Information classified Confidential - Do not copy (See last page for obligations) The Q4000/QPRO can perform the following actions simultaneously: User Guide to Q4000/QPRO Confidentiality obligations This document contains sensitive information and is classified “CONFIDENTIAL”. Its distribution is subject to the recipient’s signature of a Non-Disclosure Agreement (NDA). At all times you should comply with the following security rules (Refer to the NDA for detailed obligations): This document may not be altered in any way that removes or obscures the Confidentiality notices. Keep this document locked away. Please read carefully: CONFIDENTIAL Information in this document is provided solely in connection with Quake Global, Inc. (“QUAKE”) products. QUAKE™ reserves the right to make changes, corrections, modifications or improvements to this document and the products and services described herein at any time, without notice. All QUAKE products are sold pursuant to QUAKE’s terms and conditions of sale. Purchasers are solely responsible for the choice, selection and use of QUAKE products and services described herein, and QUAKE assumes no liability whatsoever relating to the choice, selection or use of QUAKE products and services described herein. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted under this document. If any part of this document refers to any third party products or services, it shall not be deemed a license grant by QUAKE for the use of such third party products or services, or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such third party products or services or any intellectual property contained therein. UNLESS OTHERWISE SET FORTH IN QUAKE’S TERMS AND CONDITIONS OF SALE, QUAKE DImodemLAIMS ANY EXPRESS OR IMPLIED WARRANTY WITH RESPECT TO THE USE AND/OR SALE OF QUAKE PRODUCTS INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE (AND THEIR EQUIVALENTS UNDER THE LAWS OF ANY JURISDICTION), OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. UNLESS EXPRESSLY APPROVED IN WRITING BY AN AUTHORIZED QUAKE REPRESENTATIVE, QUAKE PRODUCTS ARE NOT RECOMMENDED, AUTHORIZED OR WARRANTED FOR USE IN MILITARY, AIRCRAFT, SPACE, LIFE SAVING, OR LIFE SUSTAINING APPLICATIONS, NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY, DEATH OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE. Resale of QUAKE products with provisions different from the statements and/or technical features set forth in this document shall immediately void any warranty granted by QUAKE for the QUAKE product or service described herein and shall not create or extend in any manner whatsoever, any liability to QUAKE. QUAKE™ and the QUAKE logo are trademarks or registered trademarks of QUAKE Global. Information in this document supersedes and replaces all information previously supplied. © 2011 QUAKE GLOBAL, INC. - All rights reserved www.quakeglobal.com Document Number 1135-4713 Rev G Page 166 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. Information classified Confidential - Do not copy (See last page for obligations) Additional copies can be provided on a “need to know basis”, please contact your QUAKE account manager.
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.4 Linearized : No Page Count : 27 Producer : GPL Ghostscript 8.15 Create Date : 2012:01:16 18:10:18 Modify Date : 2012:01:16 18:10:18 Title : 1135-4713G, GREEN, Users Guide to Q4000_QPRO.pdf Creator : Adobe Acrobat 9.4.3 Author : BRogersonEXIF Metadata provided by EXIF.tools