2.2.45. Geographic Location Command Class, version 1 [OBSOLETED]

Warning

THIS COMMAND CLASS HAS BEEN OBSOLETED

New implementations MUST NOT support this version of the Command Class. Use Geographic Location Command Class, version 2 for all new implementations. No certified devices claimed support for version 1.

The Geographic Location Command Class is used to read latitude and longitude from another device. The latitude and longitude may also be set according to the geographic location in question. Date and geographic location may be used to calculate sunrise and sunset for e.g. automatic lighting control.

2.2.45.1. Multi Channel Considerations

Multi Channel End Points SHOULD NOT support the Geographic Location Command Class.

2.2.45.2. Geographic Location Set Command

This command is used to set latitude and longitude.

Table 2.250 Geographic Location Set Command

7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_GEOGRAPHIC_LOCATION (0x8C)
Command = GEOGRAPHIC_LOCATION_SET (0x01)
Longitude Degrees
Long. Sign	Longitude Minutes
Latitude Degrees
Lat. Sign	Latitude Minutes

Longitude (16 bits)

The longitude determines one’s location on the earth’s surface, East or West of the Greenwich Meridian. The Greenwich Meridian is located at the Greenwich observatory, in Greenwich, England to be the geographic point for where East and West meet. Therefore, Greenwich Meridian is indicated as 0° longitude. Longitude values for points East of the Meridian are always positive, while points West of the Meridian are always negative. Valid ranges are for degrees (from -180 to 180) and minutes (0-59). Other values will be interpreted as 0.

Latitude (16 bits)

The latitude determines one’s location on the earth’s surface, North or South of the Equator. Latitude is measured between -90° South, and +90° North of the Equator point (0°). Valid ranges are for degrees (from -90 to 90) and minutes (0-59). Other values will be interpreted as 0.

2.2.45.3. Geographic Location Get Command

This command is used to request latitude and longitude from a device.

The Geographic Location Report Command MUST be returned in response to this command.

This command MUST NOT be issued via multicast addressing.

A receiving node MUST NOT return a response if this command is received via multicast addressing. The Z-Wave Multicast frame, the broadcast NodeID and the Multi Channel multi-End Point destination are all considered multicast addressing methods.

Table 2.251 Geographic Location Get Command

7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_GEOGRAPHIC_LOCATION (0x8C)
Command = GEOGRAPHIC_LOCATION_GET (0x02)

2.2.45.4. Geographic Location Report Command

This command returns latitude and longitude from a device in a Z-Wave network.

Table 2.252 Geographic Location Report Command

7	6	5	4	3	2	1	0
Command Class = COMMAND_CLASS_GEOGRAPHIC_LOCATION (0x8C)
Command = GEOGRAPHIC_LOCATION_REPORT (0x03)
Longitude Degrees
Long. Sign	Longitude Minutes
Latitude Degrees
Lat. Sign	Latitude Minutes

Refer to description under the Geographic Location Set Command.