Configuration Properties Quick Reference
You configure the 1-Wire Weather Service for Java by setting properties.
Properties are a collection of name/value pairs. Each name is associated
with a value. Service stores default values internally, but you can
override these defaults by entering different values in a file called
wxmonitor.properties to configure WxMonitor.
On Windows systems, the properties are located in the current user account home
directory, \Documents and Settings\user-dir\wxservice
.
Localized Units
WxMonitor should switch to the proper units for your locale, but you may
switch between English or metric units by changing the units property:
# Units for displaying sensor data.
wxmonitor.units=english
or, for metric,
# Units for displaying sensor data.
wxmonitor.units=metric
Wind speed has its own separate units.
# Wind speed in kilometers per hour.
wxmonitor.units.wind=kilos
# Wind speed in knots.
wxmonitor.units.wind=knots
# Wind speed in meters per second.
wxmonitor.units.wind=meters
# Wind speed in miles per hour.
wxmonitor.units.wind=miles
# Anemometer revolutions per minute.
wxmonitor.units.wind=revs
If the property is deleted or commented out, units will default to the
units commonly used for your locale.
WxMonitor Slider Defaults
You can change the way WxMonitor displays the sliders for different units,
or to change the range or calibration of the sliders. The sensor data is
converted to an integer corresponding to the index of the slider to
control the slider's position. A slider might require an index range in
the thousands in order to display fractional data, so it is necessary to
scale the fractional data to an integer slider index. Each index can have
a label associated with it that converts the index value to a display value.
Each slider configuration consists of a comma-delimited list of parameters:
- lower -- the index of the lowest position on the slider
- upper -- the index of the highest position on the slider
- minorTick -- the interval to display short tick marks ( - ) on the slider
- majorTick -- the interval to display long tick marks ( -- ) on the slider
- multiplier -- constant to scale the sensor data to the corresponding slider index position
- index, label -- repeating pairs of data that associate an index value with a label value
You can study the configurations below to get an idea of how this works.
# Slider configuration - english: lower, upper, minorTick, majorTick, multiplier, index, label, ..., index, label
english.slider.air.pressure=2750,3150,10,50,100,2750,27.5,2800,28.0,2850,28.5,2900,29.0,2950,29.5,3000,30.0,3050,30.5,3100,31.0,3150,31.5
english.slider.humidity=0,100,2,10,1,0,0,10,10,20,20,30,30,40,40,50,50,60,60,70,70,80,80,90,90,100,100
english.slider.rainfall=0,100,2,10,100,0,0.0,10,0.1,20,0.2,30,0.3,40,0.4,50,0.5,60,0.6,70,0.7,80,0.8,90,0.9,100,1.0
english.slider.temperature=-400,1200,20,100,10,-400,-40,-300,-30,-200,-20,-100,-10,0,0,100,10,200,20,300,30,400,40,500,50,600,60,700,70,800,80,900,90,1000,100,1100,110,1200,120
# Slider configuration - metric: lower, upper, minorTick, majorTick, multiplier, index, label, ..., index, label
metric.slider.air.pressure=700,800,2,10,1,700,700,710,710,720,720,730,730,740,740,750,750,760,760,770,770,780,780,790,790,800,800
metric.slider.humidity=0,100,2,10,1,0,0,10,10,20,20,30,30,40,40,50,50,60,60,70,70,80,80,90,90,100,100
metric.slider.rainfall=0,1000,20,100,100,0,0,100,1,200,2,300,3,400,4,500,5,600,6,700,7,800,8,900,9,1000,10
metric.slider.temperature=-400,500,10,50,10,-400,-40,-350,-35,-300,-30,-250,-25,-200,-20,-150,-15,-100,-10,-50,-5,0,0,55,5,100,10,150,15,200,20,250,25,300,30,350,35,400,40,450,45,500,50
# Slider configuration - millibar: lower, upper, minorTick, majorTick, multiplier, index, label, ..., index, label
millibar.slider.air.pressure=940,1060,2,10,1,940,940,950,950,960,960,970,970,980,980,990,990,1000,1000,1010,1010,1020,1020,1030,1030,1040,1040,1050,1050,1060,1060
Common WxMonitor Defaults
This section lists the common WxMonitor default settings.
These settings in WxService.properties will configure all WxMonitor
sites unless overridden in WxMonitor.properties.
# Configuration properties for wxmonitor.MonitorPanel.
# Name of the air pressure sensor task.
wxmonitor.air.pressure.task=barometer.task
# Name of the dewpoint sensor task.
wxmonitor.dewpoint.task=hygrometer.task
# Name of the humidity sensor task.
wxmonitor.humidity.task=hygrometer.task
# Name of the rainfall rate sensor task.
wxmonitor.rainfall.rate.task=precipitation.task
# Name of the rainfall total sensor task.
wxmonitor.rainfall.total.task=precipitation.task
# Name of the temperature sensor task.
wxmonitor.temperature.task=thermometer.task
# Name of the wind direction sensor task.
wxmonitor.wind.direction.task=windvane.task
# Interval in milliseconds between wind history markers (2 minutes).
wxmonitor.wind.history.interval=120000
# Length of time in milliseconds to keep wind history markers (1 hour).
wxmonitor.wind.history.length=3600000
# Name of the wind speed sensor task.
wxmonitor.wind.speed.task=anemometer.task
This listing is in the properties file format, using the
name=value syntax.