1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383
|
/*------------------------------------------------------------------------------
* rtcm.c : rtcm functions
*
* Copyright (C) 2009-2014 by T.TAKASU, All rights reserved.
*
* references :
* [1] RTCM Recommended Standards for Differential GNSS (Global Navigation
* Satellite Systems) Service version 2.3, August 20, 2001
* [2] RTCM Standard 10403.1 for Differential GNSS (Global Navigation
* Satellite Systems) Services - Version 3, Octobar 27, 2006
* [3] RTCM 10403.1-Amendment 3, Amendment 3 to RTCM Standard 10403.1
* [4] RTCM Paper, April 12, 2010, Proposed SSR Messages for SV Orbit Clock,
* Code Biases, URA
* [5] RTCM Paper 012-2009-SC104-528, January 28, 2009 (previous ver of [4])
* [6] RTCM Paper 012-2009-SC104-582, February 2, 2010 (previous ver of [4])
* [7] RTCM Standard 10403.1 - Amendment 5, Differential GNSS (Global
* Navigation Satellite Systems) Services - version 3, July 1, 2011
* [8] RTCM Paper 019-2012-SC104-689 (draft Galileo ephmeris messages)
* [9] RTCM Paper 163-2012-SC104-725 (draft QZSS ephemeris message)
* [10] RTCM Paper 059-2011-SC104-635 (draft Galileo and QZSS ssr messages)
* [11] RTCM Paper 034-2012-SC104-693 (draft multiple signal messages)
* [12] RTCM Paper 133-2012-SC104-709 (draft QZSS MSM messages)
* [13] RTCM Paper 122-2012-SC104-707.r1 (draft MSM messages)
* [14] RTCM Standard 10403.2, Differential GNSS (Global Navigation Satellite
* Systems) Services - version 3, February 1, 2013
* [15] RTCM Standard 10403.2, Differential GNSS (Global Navigation Satellite
* Systems) Services - version 3, with amendment 1/2, november 7, 2013
* [16] Proposal of new RTCM SSR Messages (ssr_1_gal_qzss_sbas_dbs_v05)
* 2014/04/17
*
* version : $Revision:$ $Date:$
* history : 2009/04/10 1.0 new
* 2009/06/29 1.1 support type 1009-1012 to get synchronous-gnss-flag
* 2009/12/04 1.2 support type 1010,1012,1020
* 2010/07/15 1.3 support type 1057-1068 for ssr corrections
* support type 1007,1008,1033 for antenna info
* 2010/09/08 1.4 fix problem of ephemeris and ssr sequence upset
* (2.4.0_p8)
* 2012/05/11 1.5 comply with RTCM 3 final SSR format (RTCM 3
* Amendment 5) (ref [7]) (2.4.1_p6)
* 2012/05/14 1.6 separate rtcm2.c, rtcm3.c
* add options to select used codes for msm
* 2013/04/27 1.7 comply with rtcm 3.2 with amendment 1/2 (ref[15])
* 2013/12/06 1.8 support SBAS/BeiDou SSR messages (ref[16])
*-----------------------------------------------------------------------------*/
#include "rtklib.h"
static const char rcsid[]="$Id:$";
/* function prototypes -------------------------------------------------------*/
extern int decode_rtcm2(rtcm_t *rtcm);
extern int decode_rtcm3(rtcm_t *rtcm);
extern int encode_rtcm3(rtcm_t *rtcm, int type, int sync);
/* constants -----------------------------------------------------------------*/
#define RTCM2PREAMB 0x66 /* rtcm ver.2 frame preamble */
#define RTCM3PREAMB 0xD3 /* rtcm ver.3 frame preamble */
/* initialize rtcm control -----------------------------------------------------
* initialize rtcm control struct and reallocate memory for observation and
* ephemeris buffer in rtcm control struct
* args : rtcm_t *raw IO rtcm control struct
* return : status (1:ok,0:memory allocation error)
*-----------------------------------------------------------------------------*/
extern int init_rtcm(rtcm_t *rtcm)
{
gtime_t time0={0};
obsd_t data0={{0}};
eph_t eph0 ={0,-1,-1};
geph_t geph0={0,-1};
ssr_t ssr0={{{0}}};
int i,j;
trace(3,"init_rtcm:\n");
rtcm->staid=rtcm->stah=rtcm->seqno=rtcm->outtype=0;
rtcm->time=rtcm->time_s=time0;
rtcm->sta.name[0]=rtcm->sta.marker[0]='\0';
rtcm->sta.antdes[0]=rtcm->sta.antsno[0]='\0';
rtcm->sta.rectype[0]=rtcm->sta.recver[0]=rtcm->sta.recsno[0]='\0';
rtcm->sta.antsetup=rtcm->sta.itrf=rtcm->sta.deltype=0;
for (i=0;i<3;i++) {
rtcm->sta.pos[i]=rtcm->sta.del[i]=0.0;
}
rtcm->sta.hgt=0.0;
rtcm->dgps=NULL;
for (i=0;i<MAXSAT;i++) {
rtcm->ssr[i]=ssr0;
}
rtcm->msg[0]=rtcm->msgtype[0]=rtcm->opt[0]='\0';
for (i=0;i<6;i++) rtcm->msmtype[i][0]='\0';
rtcm->obsflag=rtcm->ephsat=0;
for (i=0;i<MAXSAT;i++) for (j=0;j<NFREQ+NEXOBS;j++) {
rtcm->cp[i][j]=0.0;
rtcm->lock[i][j]=rtcm->loss[i][j]=0;
rtcm->lltime[i][j]=time0;
}
rtcm->nbyte=rtcm->nbit=rtcm->len=0;
rtcm->word=0;
for (i=0;i<100;i++) rtcm->nmsg2[i]=0;
for (i=0;i<400;i++) rtcm->nmsg3[i]=0;
rtcm->obs.data=NULL;
rtcm->nav.eph =NULL;
rtcm->nav.geph=NULL;
/* reallocate memory for observation and ephemris buffer */
if (!(rtcm->obs.data=(obsd_t *)malloc(sizeof(obsd_t)*MAXOBS))||
!(rtcm->nav.eph =(eph_t *)malloc(sizeof(eph_t )*MAXSAT))||
!(rtcm->nav.geph=(geph_t *)malloc(sizeof(geph_t)*MAXPRNGLO))) {
free_rtcm(rtcm);
return 0;
}
rtcm->obs.n=0;
rtcm->nav.n=MAXSAT;
rtcm->nav.ng=MAXPRNGLO;
for (i=0;i<MAXOBS ;i++) rtcm->obs.data[i]=data0;
for (i=0;i<MAXSAT ;i++) rtcm->nav.eph [i]=eph0;
for (i=0;i<MAXPRNGLO;i++) rtcm->nav.geph[i]=geph0;
return 1;
}
/* free rtcm control ----------------------------------------------------------
* free observation and ephemris buffer in rtcm control struct
* args : rtcm_t *raw IO rtcm control struct
* return : none
*-----------------------------------------------------------------------------*/
extern void free_rtcm(rtcm_t *rtcm)
{
trace(3,"free_rtcm:\n");
/* free memory for observation and ephemeris buffer */
free(rtcm->obs.data); rtcm->obs.data=NULL; rtcm->obs.n=0;
free(rtcm->nav.eph ); rtcm->nav.eph =NULL; rtcm->nav.n=0;
free(rtcm->nav.geph); rtcm->nav.geph=NULL; rtcm->nav.ng=0;
}
/* input rtcm 2 message from stream --------------------------------------------
* fetch next rtcm 2 message and input a message from byte stream
* args : rtcm_t *rtcm IO rtcm control struct
* unsigned char data I stream data (1 byte)
* return : status (-1: error message, 0: no message, 1: input observation data,
* 2: input ephemeris, 5: input station pos/ant parameters,
* 6: input time parameter, 7: input dgps corrections,
* 9: input special message)
* notes : before firstly calling the function, time in rtcm control struct has
* to be set to the approximate time within 1/2 hour in order to resolve
* ambiguity of time in rtcm messages.
* supported msgs RTCM ver.2: 1,3,9,14,16,17,18,19,22
* refer [1] for RTCM ver.2
*-----------------------------------------------------------------------------*/
extern int input_rtcm2(rtcm_t *rtcm, unsigned char data)
{
unsigned char preamb;
int i;
trace(5,"input_rtcm2: data=%02x\n",data);
if ((data&0xC0)!=0x40) return 0; /* ignore if upper 2bit != 01 */
for (i=0;i<6;i++,data>>=1) { /* decode 6-of-8 form */
rtcm->word=(rtcm->word<<1)+(data&1);
/* synchronize frame */
if (rtcm->nbyte==0) {
preamb=(unsigned char)(rtcm->word>>22);
if (rtcm->word&0x40000000) preamb^=0xFF; /* decode preamble */
if (preamb!=RTCM2PREAMB) continue;
/* check parity */
if (!decode_word(rtcm->word,rtcm->buff)) continue;
rtcm->nbyte=3; rtcm->nbit=0;
continue;
}
if (++rtcm->nbit<30) continue; else rtcm->nbit=0;
/* check parity */
if (!decode_word(rtcm->word,rtcm->buff+rtcm->nbyte)) {
trace(2,"rtcm2 partity error: i=%d word=%08x\n",i,rtcm->word);
rtcm->nbyte=0; rtcm->word&=0x3;
continue;
}
rtcm->nbyte+=3;
if (rtcm->nbyte==6) rtcm->len=(rtcm->buff[5]>>3)*3+6;
if (rtcm->nbyte<rtcm->len) continue;
rtcm->nbyte=0; rtcm->word&=0x3;
/* decode rtcm2 message */
return decode_rtcm2(rtcm);
}
return 0;
}
/* input rtcm 3 message from stream --------------------------------------------
* fetch next rtcm 3 message and input a message from byte stream
* args : rtcm_t *rtcm IO rtcm control struct
* unsigned char data I stream data (1 byte)
* return : status (-1: error message, 0: no message, 1: input observation data,
* 2: input ephemeris, 5: input station pos/ant parameters,
* 10: input ssr messages)
* notes : before firstly calling the function, time in rtcm control struct has
* to be set to the approximate time within 1/2 week in order to resolve
* ambiguity of time in rtcm messages.
*
* to specify input options, set rtcm->opt to the following option
* strings separated by spaces.
*
* -EPHALL : input all ephemerides
* -STA=nnn : input only message with STAID=nnn
* -GLss : select signal ss for GPS MSM (ss=1C,1P,...)
* -RLss : select signal ss for GLO MSM (ss=1C,1P,...)
* -ELss : select signal ss for GAL MSM (ss=1C,1B,...)
* -JLss : select signal ss for QZS MSM (ss=1C,2C,...)
* -CLss : select signal ss for BDS MSM (ss=2I,7I,...)
*
* supported RTCM 3 messages
* (ref [2][3][4][5][6][7][8][9][10][11][12][13][14][15])
*
* TYPE GPS GLOASS GALILEO QZSS BEIDOU SBAS
* ----------------------------------------------------------------------
* OBS C-L1 : 1001~ 1009~ - - - -
* F-L1 : 1002 1010 - - - -
* C-L12 : 1003~ 1011~ - - - -
* F-L12 : 1004 1012 - - - -
*
* NAV : 1019 1020 1045* 1044* 1047* -
* - - 1046* - - -
*
* MSM 1 : 1071~ 1081~ 1091~ 1111*~ 1121*~ 1101*~
* 2 : 1072~ 1082~ 1092~ 1112*~ 1122*~ 1102*~
* 3 : 1073~ 1083~ 1093~ 1113*~ 1123*~ 1103*~
* 4 : 1074 1084 1094 1114* 1124* 1104*
* 5 : 1075 1085 1095 1115* 1125* 1105*
* 6 : 1076 1086 1096 1116* 1126* 1106*
* 7 : 1077 1087 1097 1117* 1127* 1107*
*
* SSR OBT : 1057 1063 1240* 1246* 1258* -
* CLK : 1058 1064 1241* 1247* 1259* -
* BIAS : 1059 1065 1242* 1248* 1260* -
* OBTCLK: 1060 1066 1243* 1249* 1261* -
* URA : 1061 1067 1244* 1250* 1262* -
* HRCLK : 1062 1068 1245* 1251* 1263* -
*
* ANT INFO : 1005 1006 1007 1008 1033
* ----------------------------------------------------------------------
* (* draft, ~ only encode)
*
* for MSM observation data with multiple signals for a frequency,
* a signal is selected according to internal priority. to select
* a specified signal, use the input options.
*
* rtcm3 message format:
* +----------+--------+-----------+--------------------+----------+
* | preamble | 000000 | length | data message | parity |
* +----------+--------+-----------+--------------------+----------+
* |<-- 8 --->|<- 6 -->|<-- 10 --->|<--- length x 8 --->|<-- 24 -->|
*
*-----------------------------------------------------------------------------*/
extern int input_rtcm3(rtcm_t *rtcm, unsigned char data)
{
trace(5,"input_rtcm3: data=%02x\n",data);
/* synchronize frame */
if (rtcm->nbyte==0) {
if (data!=RTCM3PREAMB) return 0;
rtcm->buff[rtcm->nbyte++]=data;
return 0;
}
rtcm->buff[rtcm->nbyte++]=data;
if (rtcm->nbyte==3) {
rtcm->len=getbitu(rtcm->buff,14,10)+3; /* length without parity */
}
if (rtcm->nbyte<3||rtcm->nbyte<rtcm->len+3) return 0;
rtcm->nbyte=0;
/* check parity */
if (rtk_crc24q(rtcm->buff,rtcm->len)!=getbitu(rtcm->buff,rtcm->len*8,24)) {
trace(2,"rtcm3 parity error: len=%d\n",rtcm->len);
return 0;
}
/* decode rtcm3 message */
return decode_rtcm3(rtcm);
}
/* input rtcm 2 message from file ----------------------------------------------
* fetch next rtcm 2 message and input a messsage from file
* args : rtcm_t *rtcm IO rtcm control struct
* FILE *fp I file pointer
* return : status (-2: end of file, -1...10: same as above)
* notes : same as above
*-----------------------------------------------------------------------------*/
extern int input_rtcm2f(rtcm_t *rtcm, FILE *fp)
{
int i,data=0,ret;
trace(4,"input_rtcm2f: data=%02x\n",data);
for (i=0;i<4096;i++) {
if ((data=fgetc(fp))==EOF) return -2;
if ((ret=input_rtcm2(rtcm,(unsigned char)data))) return ret;
}
return 0; /* return at every 4k bytes */
}
/* input rtcm 3 message from file ----------------------------------------------
* fetch next rtcm 3 message and input a messsage from file
* args : rtcm_t *rtcm IO rtcm control struct
* FILE *fp I file pointer
* return : status (-2: end of file, -1...10: same as above)
* notes : same as above
*-----------------------------------------------------------------------------*/
extern int input_rtcm3f(rtcm_t *rtcm, FILE *fp)
{
int i,data=0,ret;
trace(4,"input_rtcm3f: data=%02x\n",data);
for (i=0;i<4096;i++) {
if ((data=fgetc(fp))==EOF) return -2;
if ((ret=input_rtcm3(rtcm,(unsigned char)data))) return ret;
}
return 0; /* return at every 4k bytes */
}
/* generate rtcm 2 message -----------------------------------------------------
* generate rtcm 2 message
* args : rtcm_t *rtcm IO rtcm control struct
* int type I message type
* int sync I sync flag (1:another message follows)
* return : status (1:ok,0:error)
*-----------------------------------------------------------------------------*/
extern int gen_rtcm2(rtcm_t *rtcm, int type, int sync)
{
trace(4,"gen_rtcm2: type=%d sync=%d\n",type,sync);
rtcm->nbit=rtcm->len=rtcm->nbyte=0;
/* not yet implemented */
return 0;
}
/* generate rtcm 3 message -----------------------------------------------------
* generate rtcm 3 message
* args : rtcm_t *rtcm IO rtcm control struct
* int type I message type
* int sync I sync flag (1:another message follows)
* return : status (1:ok,0:error)
*-----------------------------------------------------------------------------*/
extern int gen_rtcm3(rtcm_t *rtcm, int type, int sync)
{
unsigned int crc;
int i=0;
trace(4,"gen_rtcm3: type=%d sync=%d\n",type,sync);
rtcm->nbit=rtcm->len=rtcm->nbyte=0;
/* set preamble and reserved */
setbitu(rtcm->buff,i, 8,RTCM3PREAMB); i+= 8;
setbitu(rtcm->buff,i, 6,0 ); i+= 6;
setbitu(rtcm->buff,i,10,0 ); i+=10;
/* encode rtcm 3 message body */
if (!encode_rtcm3(rtcm,type,sync)) return 0;
/* padding to align 8 bit boundary */
for (i=rtcm->nbit;i%8;i++) {
setbitu(rtcm->buff,i,1,0);
}
/* message length (header+data) (bytes) */
if ((rtcm->len=i/8)>=3+1024) {
trace(2,"generate rtcm 3 message length error len=%d\n",rtcm->len-3);
rtcm->nbit=rtcm->len=0;
return 0;
}
/* message length without header and parity */
setbitu(rtcm->buff,14,10,rtcm->len-3);
/* crc-24q */
crc=rtk_crc24q(rtcm->buff,rtcm->len);
setbitu(rtcm->buff,i,24,crc);
/* length total (bytes) */
rtcm->nbyte=rtcm->len+3;
return 1;
}
|