DISPATCHSCHEDULE

Scheduled sequence of authorized services

Platform:

OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, CPT7, CPT7700, SMART7, SMART2

Firmware:

This log is available only on 7.09.xx firmware. Specifically on versions 7.09.06 or greater.

The DISPATCHSCHEDULE log describes the scheduled sequence of authorized services – corrections services and receiver features – for this receiver (see Receiver Features: Authorization and Subscriptions). All subscribed products appear along with the time period(s) subscribed including those current, future and recent past. Authorized services start on the first power on or reset after midnight local time at the start date of the service period. The service period ends at midnight local time at the end of the end date, but the receiver features continue until the next reset, at which point the next service period (if any) becomes active. If a contiguous service period also has corrections services, corrections continue until the reset so there is no gap between services, otherwise the corrections (only) are discontinued at midnight.

The log has three parts, describing what is currently authorized and active, the schedule of periods past, current and future, and the authorized configuration that applies outside of the scheduled service periods.

The Active Parameters section indicates the currently applied receiver features, GNSS channel configuration and services (by name). These may be due to a service period or the permanent receiver features. If a service period begins or ends during operation, the status will change from CURRENT to EXPIRED or EXPIRED_STOP, indicating that service will change on the next reboot and whether corrections have stopped.

The Service Period array describes a sequence of periods of time which do not overlap (but may not be contiguous). Each service period record includes the receiver features and service products authorized for that period and whether the period is future, current or past. When a new start date occurs, that period becomes PENDING and will take effect on the next reset. When an end date occurs, that period becomes EXPIRED and while the receiver features continue until the next reset, any PPP corrections continue only if a now PENDING period also has a corrections service enabled. Otherwise, any PPP position will gracefully degrade after the end date.

The Outside Periods section indicates what receiver features and channel configuration will be applied when no service periods are active – before, between or after all service periods. The receiver features are the selected permanent software model as delivered and selected by the dispatch message (see the DISPATCHSET command), auth code (see the AUTH command) and/or model (see the MODEL command).

See also the LBANDBEAMTABLE log and LBANDTRACKSTAT log to ensure PPP corrections can be delivered from the satellites.

Message ID: 2556

Log Type: Synch

Recommended input: 

log dispatchschedule once

ASCII Examples:

Example 1 – Normal case with an active period with 2 services.

CURRENT “FFNRYNTMNP1” PERIOD 7 GEOGATED 0 2

     “TerraStar-X”

     “ALIGN”

3

     2023 04 1 2024 04 20 PAST “FFNPNNTMNP1” PERIOD SERVICE NONE 0 “TerraStar-C PRO” “” ”” ”” ”” ”” ””

     2024 04 21 2024 04 27 CURRENT “FFNRYNTMNP1” PERIOD SERVICE GEOGATED 0 “TerraStar-X” “ALIGN” ”” ”” ”” ”” ””

     2024 04 28 2025 04 20 FUTURE “DDNLNNTMNP1” PERMANENT DEFAULT GEOGATED 0 “TerraStar-L” “” ”” ”” ”” ”” ””

BASELINE “DDNLNNTMN” 1 0

 

Example 2 - During a time when no service periods are authorized.

CURRENT “DDNLNNTMN” PERMANENT 1 GEOGATED 0 0

0

NONE “DDNLNNTMN” 1 0

 

Example 3 – During a time in-between authorized service periods. In this example, the current date is 2024-04-11.

CURRENT “DDNLNNTMN” PERMANENT 1 GEOGATED 0 0

3

   2023 04 1 2024 04 10 PAST “FFNPNNTMNP1” PERIOD SERVICE NONE 0 “TerraStar-C PRO” “” ”” ”” ”” ”” ””

   2024 04 21 2024 04 27 FUTURE “FFNRYNTMNP1” PERIOD SERVICE GEOGATED 0 “TerraStar-X” “ALIGN” ”” ”” ”” ”” ””

    2024 04 28 2025 04 20 FUTURE “DDNLNNTMNP1” PERMANENT DEFAULT GEOGATED 0 “TerraStar-L” “” ”” ”” ”” ”” ””

BASELINE “DDNLNNTMN” 1 0

 

Example 4 – When one service period has expired and the following is pending (service will change on reset). In this example, the current date is 2024-04-28:

EXPIRED “FFNRYNTMNP1” PERIOD 7 GEOGATED 0 2

     “TerraStar-X”

     “ALIGN”

3

     2023 04 1 2024 04 10 PAST “FFNPNNTMNP1” PERIOD SERVICE NONE 0 “TerraStar-C PRO” “” ”” ”” ”” ”” ””

     2024 04 21 2024 04 27 EXPIRED “FFNRYNTMNP1” PERIOD SERVICE GEOGATED 0 “TerraStar-X” “ALIGN” ”” ”” ”” ”” ””

     2024 04 28 2025 04 20 PENDING “DDNLNNTMNP1” PERMANENT DEFAULT GEOGATED 0 “TerraStar-L” “” ”” ”” ”” ”” ””

BASELINE “DDNLNNTMN” 1 0

Field	Field type	Description	Format	Binary bytes	Binary offset
1	Log header	DISPATCHSCHEDULE header For information about log headers, see ASCII, Abbreviated ASCII or Binary.	–	H	0
Active parameters
2	active status	Are the active authorized services current or will they change (start or end a service period) on the next reset. See Table: Active status.	Enum	4	H
3	active receiver features	Software model currently applied. This indicates what functions are authorized for use. See the MODELFEATURES log for details.	Char[16]	16	H+4
4	active receiver features source	How the active receiver features were determined. See Table: Receiver features source.	Enum	4	H+20
5	active channel configuration	GNSS channel configuration currently applied. This determines which satellites and signals are tracked. See the SELECTCHANCONFIG command for details.	Ulong	4	H+24
6	active region restriction	For region restricted services, the type of region restriction currently applied. Receiver features are not region restricted. See Table: Region restrictions.	Enum	4	H+28
7	reserved	A reserved field filled with zero.	Ulong	4	H+32
8	# active services	Number of active service records to follow.	Ulong	4	H+36
9	active service name	Names of the active service product(s).	Char[16]	16	H+40+ (#services x 16)
Service periods
10	# service periods	Number of service period records to follow.	Ulong	4	H+40+ (#services x 16) +16
11	service period start year	The year in which the service period begins.	Ushort	2	H+44+ (#services x 16) +16+ (#periods x 156)
12	service period start month	The month in which the service period begins.	Uchar	1	H+46+ (#services x 16) +16 + (#periods x 156)
13	service period start day	Service period begins at midnight local time of this day.	Uchar	1	H+47+ (#services x 16) +16 + (#periods x 156)
14	service period end year	The year in which the service period ends. 0 = No end date – service persists indefinitely.	Ushort	2	H+48+ (#services x 16) +16 + (#periods x 156)
15	service period end month	The month in which the service period ends. 0 = No end date – service persists indefinitely.	Uchar	1	H+50+ (#services x 16) +16 + (#periods x 156)
16	service period end day	Service period ends at midnight local time of this day. 0 = No end date – service persists indefinitely.	Uchar	1	H+51+ (#services x 16) +16 + (#periods x 156)
17	service period status	Indicates if this service period is current, past or future and whether it will change on a reboot. See Table: Service period status.	Enum	4	H+52+ (#services x 16) +16 + (#periods x 156)
18	service period receiver features	Software model applied during the service period. Indicates what functions are authorized for use. See the MODELFEATURES log for details.	Char[16]	16	H+56+ (#services x 16) +16 + (#periods x 156)
19	service period receiver features source	Indicates whether the service period specifies a specific model. See Table: Receiver features source.	Enum	4	H+72+ (#services x 16) +16 + (#periods x 156)
20	service period channel configuration	Indicates whether GNSS channel configuration optimization is specified. See Table: Channel configuration optimization.	Enum	4	H+76+ (#services x 16) +16 + (#periods x 156)
21	service period region restriction	For region restricted services, the type of region restriction applied for this period. Receiver features are not region restricted. See Table: Region restrictions.	Enum	4	H+80+ (#services x 16) +16 + (#periods x 156)
22	reserved	A reserved field filled with zero.	Ulong	4	H+84+ (#services x 16) +16 + (#periods x 156)
23	Name1	Name of the service product authorized for this service period. If multiple products are authorized for this service period, the addition products are listed in the following fields.	Char[16]	16	H+88+ (#services x 16) +16 + (#periods x 156)
24	Name2	Name of the second service product authorized (if present). Blank if a second service is not authorized.	Char[16]	16	H+104+ (#services x 16) +16 + (#periods x 156)
25	Name3	Name of the third service product authorized (if present). Blank if a third service is not authorized.	Char[16]	16	H+120+ (#services x 16) +16 + (#periods x 156)
26	Name4	Name of the fourth service product authorized (if present). Blank if a fourth service is not authorized.	Char[16]	16	H+136+ (#services x 16) +16 + (#periods x 156)
27	Name5	Name of the fifth service product authorized (if present). Blank if a fifth service is not authorized.	Char[16]	16	H+152+ (#services x 16) +16 + (#periods x 156)
28	Name6	Name of the sixth service product authorized (if present). Blank if a sixth service is not authorized.	Char[16]	16	H+168+ (#services x 16) +16 + (#periods x 156)
29	Name7	Name of the seventh service product authorized (if present). Blank if a seventh service is not authorized.	Char[16]	16	H+184+ (#services x 16) +16 + (#periods x 156)
Outside of service periods
30	baseline present	Indicates that the baseline subscription type will ensure the final service period does not expire. See Table: Baseline present.	Enum	4	H+200+ (#services x 16) +16 + (#periods x 156)
31	selected permanent model	These receiver features will take effect when no service period is scheduled. See the MODEL command.	Char[16]	16	H+204+ (#services x 16) +16 + (#periods x 156)
32	selected channel configuration	This channel configuration will take effect when no service period is scheduled. See the SELECTCHANCONFIG command for details.	Ulong	4	H+220+ (#services x 16) +16 + (#periods x 156)
33	reserved	A reserved field filled with zero.	Ulong	4	H+224+ (#services x 16) +16 + (#periods x 156)
34	xxxx	32-bit CRC (ASCII and Binary only)	Hex	4	H+228+ (#services x 16) +16 + (#periods x 156)
35	[CR][LF]	Sentence terminator (ASCII only)	–	–	–

Active status

Binary value	ASCII value	Description
0	UNKNOWN	GNSS time is not available yet, so it is not known whether the current period has expired or a new one started. The active receiver features and service continue to be authorized.
1	CURRENT	The active receiver features and services continue to be authorized and will continue through the next reset. This includes when no service period is active and the permanent model is applied.
2	EXPIRED	The service period has ended or a period of no service has ended and a different configuration will start with the next reset. Receiver features and any PPP corrections continue until reset.
3	EXPIRED_STOP	The service period has ended and a different configuration will start with the next reset. Receiver features continue until reset, but PPP corrections have been disabled (because the following time has no corrections).

Receiver features source

Binary value	ASCII value	Description
0	PERIOD	The service period specified a model to use.
1	PERMANENT	The service period does not specify a model to use, so the selected permanent model is in use.
2	OVERRIDE	The service period model has been overridden using the MODEL command.

Region restrictions

Binary value	ASCII value	Description
0	NONE	Corrections operation has no region restrictions.
1	GEOGATED	Corrections operation is limited to on-land. GEOGATED is also the default value reported if there is no subscription.
3	NEARSHORE	Corrections operation is limited to on land and near shore (coastal) regions.

Service period status

Binary value	ASCII value	Description
0	FUTURE	The start date has not yet occurred.
1	PENDING	The current date is between the start and end date so the service will begin on the next reset.
2	CURRENT	The current date is between the start and end date and the service is being offered. It will continue on the next reset.
3	EXPIRED	The end date has passed while the service was being offered. Receiver features continue, but unless the next period has corrections services, corrections have stopped. The next period will take effect on the next reset.
4	PAST	The end date has passed and the service is not active.
5	PENDING_DICTIONARY	A service dispatch is installed for which a dictionary reference is not yet resolved. No service period will become current until a matching dictionary dispatch is received. The dictionary is transmitted over L-band and NTRIP approximately once per hour. A reset will not change this state. May also occur if a service is purchased that requires a newer firmware version. Update to the latest firmware.

Channel configuration optimization

Binary value	ASCII value	Description
0	DEFAULT	The default channel configuration, or the channel configuration selected using the SELECTCHANCONFIG command will be used.
1	SERVICE	The GNSS channel configuration will be optimized for the given service if TERRASTARAUTOCHANCONFIG is set to ENABLE.

Baseline present

Binary value	ASCII value	Description
0	NONE	No baseline subscription is present.
1	BASELINE	A baseline subscription type is present and will automatically extend the end date to ensure the service does not expire.