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