KB0MVQ: Created page with "'''Note:''' This document assumes you are familiar with Garmin Device Interface Specification (Drawing Number: 001-00063-00) and how to establish communication with a Garmin devi..."

2012-10-16T19:01:54Z

Created page with "'''Note:''' This document assumes you are familiar with Garmin Device Interface Specification (Drawing Number: 001-00063-00) and how to establish communication with a Garmin devi..."

New page

'''Note:''' This document assumes you are familiar with Garmin Device Interface Specification (Drawing Number: 001-00063-00) and how to establish communication with a Garmin device.

=== Link Protocol ===
==== Packet IDs ====
<code>
<pre>
enum
{
Pid_Tracked_Asset_Data = 3078
};
</pre>
</code>

=== Application Protocol ===
==== A1100 – Basestation Protocol ====
Tracked asset data is transmitted upon the user enabling the feature on the unit.

The packet sequence for the Basestation Protocol is show below:
{| class="wikitable"
! N !! Direction !! Packet ID !! Packet Data Type
|-
| 0 || Device to Host (ACK/NACK optional) || Pid_Tracked_Asset_Data || <D1100_Tracked_Asset_Type>
|}

=== Data Types ===

==== asset_info_type ====

The asset_info_type is a uint32 bit field that indicates the type of receiving unit, the asset's type and it's associated status.

{| class="wikitable"
! Bit
! Interpretation
|-
| 0-3 (least significant bits)
| Dog Status
|-
| 4-8
| Platform
|-
| 9-11
| Type
|-
| 12
| Low Battery
|-
| 13
| GPS Lost
|-
| 14
| Communication Lost
|-
| 15
| Text Message Received
|-
| 16
| Asset Removed
|-
| 17-31 (most significant bits)
| Undefined
|}

"Dog Status" can be one of the following values:
<code>
<pre>
enum
{
DOG_STATUS_INVALID = 0,
DOG_STATUS_SITTING = 1,
DOG_STATUS_MOVING = 2,
DOG_STATUS_TREED = 3,
DOG_STATUS_ON_POINT = 4
};
</pre>
</code>

"Platform" can be one of the following values:
<code>
<pre>
enum
{
PLATFORM_ASTRO320 = 0,
PLATFORM_RINO = 1,
PLATFORM_ALPHA = 2
};
</pre>
</code>

"Type" can be one of the following values:
<code>
<pre>
enum
{
TYPE_DOG = 0,
TYPE_CONTACT = 1
};
</pre>
</code>

"Dog Status", "Low Battery", "GPS Lost", and "Communication Lost" are only valid if "Type" is <code>TYPE_DOG</code>.

For "Low Battery", "GPS Lost", "Communication Lost", a set bit indicates the condition is true.

The "Text Message Received" bit being set indicates that a new text message has been received.

The "Asset Removed" bit being set indicates that the user has removed the asset from the list of tracked assets on their device.

==== D1100_Tracked_Asset_Type ====

<code>
<pre>
typedef struct
{
position_type posn;
float alt;
time_type time;
asset_info_type status;
symbol_type smbl; /* contact symbol */
uint16 collar_id; /* assigned dog collar ID */
uint8 color; /* track color */
uint8 batt; /* Battery level 0% - 100% */
uint8 gps; /* Signal strength 0 - 5 bars */
uint8 comm; /* Signal strength 0 - 5 bars */
uint8 channel; /* FRS/GMRS channel */
uint8 code; /* FRS/GMRS squelch code */
uint8 idx; /* index */
uchar_t8 ident[37]; /* identifier */
uchar_t8 msg[31]; /* text message or note */
} D1100_Tracked_Asset_Type;
</pre>
</code>

The "smbl" is only valid if the "Type" field of the "status" member is <code>TYPE_CONTACT</code>.

The "collar_id", "batt", "gps", and "comm" members are only valid if the "Type" field of the "status" member is <code>TYPE_DOG</code>.

The “color” member is the display color of the asset's track and can be one of the following values:
<code>
<pre>
enum
{
clr_black = 0,
clr_dark_red = 1,
clr_dark_green = 2,
clr_dark_yellow = 3,
clr_dark_blue = 4,
clr_dark_magenta = 5,
clr_dark_cyan = 6,
clr_light_gray = 7,
clr_dark_gray = 8,
clr_red = 9,
clr_green = 10,
clr_yellow = 11,
clr_blue = 12,
clr_magenta = 13,
clr_cyan = 14,
clr_white = 15,
clr_light_blue = 16,
clr_transparent = 17,
clr_default_color = 255
};
</pre>
</code>

The "idx" member is a unique index for a given asset. This allows the host to track changes of the identifier. A given index may be reused after the unit sends a packet with the "Asset Removed" bit of the "status" member set for that index.

The "msg" member is only valid when the "Text Message Received" bit of "status" member is set. Otherwise the previously received message should be considered the latest message.

Garmin Basestation Mode - Revision history

KB0MVQ: Created page with "'''Note:''' This document assumes you are familiar with Garmin Device Interface Specification (Drawing Number: 001-00063-00) and how to establish communication with a Garmin devi..."