The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Device::LaCrosse::WS23xx::MemoryMap - Weather station address meanings

SYNOPSIS

    use Device::LaCrosse::WS23xx::MemoryMap;

    my $map = Device::LaCrosse::WS23xx::MemoryMap->new();

This is NOT intended as a user-visible module. It is used internally by Device::LaCrosse::WS23xx. This interface is subject to change without notice.

DESCRIPTION

CONSTRUCTOR

new()

Parses the data table contained in the module itself.

METHODS

find_field( FIELD )

Canonicalizes FIELD and looks it up. If found, returns a hashref with the following elements:

name

Canonical field name.

units

Units of the measurement. See Units below.

address

Starting address of this field in the WS-23xx memory map

count

Length, in nybbles, of the field.

expr

Perl expression used to convert data nybbles to a useful form.

If FIELD is not found, returns undef.

Known Fields

The known data fields -- i.e., what you can use as an argument to Device::LaCrosse::WS23xx->get() -- are:

   Wind_unit
   LCD_contrast
   Forecast
   Tendency
   Indoor_Temperature                      C
   Min_Indoor_Temperature                  C
   Max_Indoor_Temperature                  C
   Min_Indoor_Temperature_datetime         time_t
   Max_Indoor_Temperature_datetime         time_t
   Low_Alarm_Indoor_Temperature            C
   High_Alarm_Indoor_Temperature           C
   Outdoor_Temperature                     C
   Min_Outdoor_Temperature                 C
   Max_Outdoor_Temperature                 C
   Min_Outdoor_Temperature_datetime        time_t
   Max_Outdoor_Temperature_datetime        time_t
   Low_Alarm_Outdoor_Temperature           C
   High_Alarm_Outdoor_Temperature          C
   Windchill                               C
   Min_Windchill                           C
   Max_Windchill                           C
   Min_Windchill_datetime                  time_t
   Max_Windchill_datetime                  time_t
   Low_Alarm_Windchill                     C
   High_Alarm_Windchill                    C
   Dewpoint                                C
   Min_Dewpoint                            C
   Max_Dewpoint                            C
   Min_Dewpoint_datetime                   time_t
   Max_Dewpoint_datetime                   time_t
   Low_Alarm_Dewpoint                      C
   High_Alarm_Dewpoint                     C
   Indoor_Humidity                         %
   Min_Indoor_Humidity                     %
   Max_Indoor_Humidity                     %
   Min_Indoor_Humidity_datetime            time_t
   Max_Indoor_Humidity_datetime            time_t
   Low_Alarm_Indoor_Humidity               %
   High_Alarm_Indoor_Humidity              %
   Outdoor_Humidity                        %
   Min_Outdoor_Humidity                    %
   Max_Outdoor_Humidity                    %
   Min_Outdoor_Humidity_datetime           time_t
   Max_Outdoor_Humidity_datetime           time_t
   Low_Alarm_Outdoor_Humidity              %
   High_Alarm_Outdoor_Humidity             %
   Rain_24hour                             mm
   Max_Rain_24hour                         mm
   Max_Rain_24hour_datetime                time_t
   Rain_1hour                              mm
   Max_Rain_1hour                          mm
   Max_Rain_1hour_datetime                 time_t
   Rain_Total                              mm
   Rain_Total_datetime                     time_t
   Min__wind                               m/s
   Max__wind                               m/s
   Min_Date/Time_wind_datetime             time_t
   Max_Date/Time_wind_datetime             time_t
   Wind_Speed                              m/s
   Wind_Direction                          degrees
   Low_wind_alarm_setting                  m/s
   High_wind_alarm_setting                 m/s
   Connection_Type
   Countdown_time_to_next_datBinary        seconds
   Absolute_Pressure                       hPa
   Relative_Pressure                       hPa
   Pressure_Correction                     hPa
   Min_Absolute_Pressure                   hPa
   Min_Relative_Pressure                   hPa
   Max_Absolute_Pressure                   hPa
   Max_Relative_Pressure                   hPa
   Min_Pressure_datetime                   time_t
   Max_Pressure_datetime                   time_t
   Low_Alarm_Pressure                      hPa
   High_Alarm_Pressure                     hPa
   History_saving_interval                 minutes
   Countdown_to_next_saving                minutes
   Date/Time_last_record_datetime          time_t
   Pointer_to_last_written_Record
   Number_of_Records

Where applicable, units are displayed to the right of each field.

Units

The WS-23xx devices return data in the following units:

C

Degrees Centigrade (temperature)

%

Percent (humidity)

hPa

hectoPascals (pressure)

m/s

Meters per Second (wind speed)

mm

Millimeters (rainfall)

degrees

Compass degrees, 0-359, (wind direction)

minutes

Minutes.

seconds

Seconds.

time_t

Seconds since the Epoch; you probably want to use it as an argument to localtime().

AUTHOR

Ed Santiago <esm@cpan.org>

SEE ALSO

Device::LaCrosse::WS23xx