User Manual Part 5

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 104
CONFIDENTIAL
Information classified Confidential
-
Do not copy (See last page for obligations)
For the Iridium network, this file must be created as an attachment and have an
additional blank line below the LocalFile name.
12.4.3.2 Remotely download a file to the modem (via email)
The Q4000/QPRO API includes function calls that allow a user to download a file from a remote
server to the modem’s file system. This allows you to update an application running on the
modem. The DemoAppREMOTE application demonstrates the File Transfer Protocol (FTP)
capability by processing an email to download a file to the modem.
The email sent to the Q4000/QPRO should contain the words “APPLICATION UPDATE” in the
body of the message, as well as FTP download information. The body of the plain text email
should contain information relating to your FTP server, and to the file to be downloaded to the
Q4000/QPRO, as shown in Figure 12-42.
Figure 12-42: DemoAppREMOTE - Remote application update email
The email is processed as in the “set relay” example above. After determining that it is a POP
incoming message, it is parsed by ParseCommandMessage(). The code first checks to see if
“APPLICATION UPDATE” is in the body of the message. If so, it extracts the Server Name,
Username, Password, RemoteFile and LocalFile from the message. Note that the Remote File is
the name of the file on the FTP server and LocalFile is the name the file will be on the modem
itself.
Any file that is named: /tffs0/APL/CUST_APL.bin is executed as the custom application when the
modem boots up, so if this file is replaced, the new custom application is executed after the next
boot sequence.
Note: