User Guide to Q4000/QPRO To build the Turnkey project: Information classified Confidential - Do not copy (See last page for obligations) CONFIDENTIAL 1. Select the Project drop-down menu and select Make, or use the F7 key as a shortcut to build the project. Figure 12-4: Project menu Document Number 1135-4713 Rev G Page 69 THIS DOCUMENT CONTAINS CONFIDENTIAL AND PROPRIETARY INFORMATION OF QUAKE GLOBAL CORPORATION.
User Guide to Q4000/QPRO Figure 12-5: A successful build of Turnkey Ensure that there are no errors and no warnings. To verify the files were built correctly, go to …\Orbcomm_API_and_Files_1_3\APL_Orbcomm\Turnkey\Exe. There should be a TurnKey.out and a Q4Ka-xGT-x.x.x.x-TurnKey.bin file with current timestamps, as shown below: Figure 12-6: Turnkey executable files Document Number 1135-4713 Rev G Page 70 THIS DOCUMENT CONTAINS CONFIDENTIAL AND PROPRIETARY INFORMATION OF QUAKE GLOBAL CORPORATION.
User Guide to Q4000/QPRO Note: See Appendix E - Software file naming convention for the key to the file names. The application’s binary file is an independent executable. QUAKE’S foundation code does not have to be compiled and linked to the application file during the build process. Pointers allow the application to access required foundation functions and global variables. Changes to the application do not require the modem’s foundation code to be downloaded again.
User Guide to Q4000/QPRO 3. Select the correct COM port, with Baud Rate of 4800, and then click . Information classified Confidential - Do not copy (See last page for obligations) Figure 12-7: QCT - Communication port settings CONFIDENTIAL 4. QCT will then display your connection status: Figure 12-8: QCT - Connection status 5. Select , then .
User Guide to Q4000/QPRO Information classified Confidential - Do not copy (See last page for obligations) CONFIDENTIAL 6. A dialog box appears, allowing you to browse to TurnKey.bin. Browse to the directory containing the xxx-TurnKey.bin and double-click to select it. Figure 12-10: QCT - Application Load (browse) 7. Click to begin the download process.
User Guide to Q4000/QPRO Figure 12-12: QCT - Successful file download Note: The application is always stored in the modem’s non-volatile memory (NVM) in APL/CUST_APL.BIN. If you have problems with the download, please consult the QCT Manual. 12.2.3 Running Turnkey If the requirements of your application are similar to Turnkey or one of the DemoApps, make a copy of the application and use it as a starting point for your application.
User Guide to Q4000/QPRO CONFIDENTIAL Information classified Confidential - Do not copy (See last page for obligations) Once you have the Logger port connected and configured, and the Turnkey binary file has been downloaded, cycle power on the modem.
User Guide to Q4000/QPRO APL_init(void) is the first application function called by the QUAKE firmware, and is the starting point for custom code development. The statement: Quake Turnkey APL Version Nov 30 2010, 09:54:30 indicates that the application is running properly and your development environment is ready to begin developing custom applications. 12.2.4 Stopping and removing Turnkey from the modem CONFIDENTIAL To stop the application: 1. Type ‘d’ ‘R’ on the Logger port to initiate a reboot. 2.
User Guide to Q4000/QPRO CONFIDENTIAL Information classified Confidential - Do not copy (See last page for obligations) 4. To remove the binary application file from NVM, type ‘d’ ‘f’ on the Logger port. You should see the following debug menu screen. Figure 12-14: Entering the Debug Flash menu Document Number 1135-4713 Rev G Page 77 THIS DOCUMENT CONTAINS CONFIDENTIAL AND PROPRIETARY INFORMATION OF QUAKE GLOBAL CORPORATION.
User Guide to Q4000/QPRO 5. To remove the bad application file completely, type: ‘r’, and then ‘APL/CUST_APL.BIN’ when prompted for the file name. Information classified Confidential - Do not copy (See last page for obligations) The application is always stored in this directory under this name. This removes the file from NVM. CONFIDENTIAL Note: Figure 12-15: Stopping and removing the application 6. Type ‘q’ to quit the debug mode.
User Guide to Q4000/QPRO Figure 12-16: The application was successfully removed Note: In most cases it is not necessary to remove an application from the modem if you simply want to replace it with a new application. When you load the new application with QCT, it will over-write the existing application file. Document Number 1135-4713 Rev G Page 79 THIS DOCUMENT CONTAINS CONFIDENTIAL AND PROPRIETARY INFORMATION OF QUAKE GLOBAL CORPORATION.