Returns GPSERROR_NONE on success or GPSERROR_CONFIG on failure.
Remarks
Almanac data takes 12.5 minutes to update during normal GPS usage. In some PDA applications it cannot be guaranteed that the receiver will navigate continuously for that long, so it might be convenient to update the almanac data from external sources. Almanac data is valid for approximately one year.
The almanac data is stored in the code as a 448-element array of INT16 values. These 448 elements are partitioned as 32 x 14 elements where the 32 represents the satellite number minus 1 and the 14 represents the number of INT16 values associated with this satellite. The data is packed; the exact format of this representation and packing method can be extracted from the ICD-GPS-2000 document. The ICD-GPS- 2000 document describes the data format of each GPS navigation sub-frame and is available on the web at http://www.arinc.com/gps.
The user is responsible for allocating and freeing the memory for the parameter(s).