xAP Weather Schema Schema add change request
Collapse
X
-
Ah, OK that makes sense Kevin; apologies.- Pete C
HW-HAI OPII - X10,UPB,Z-Wave,Russound,1-Wire(X4 networks) OmniTouch screens, Intel & Arm Touchscreens (Android, Wintel & Linux)and OmniStat2
SW-HSPro - Atom D525/4Gb -W2003SP2 X86 - 18 serial ports via USB (Digi Edgeports & Digi Hub)
Weather Cumulus - Fine Offset & Davis Vantage Vue
Comment
-
-
How long is a max size message currently - does anyone know ?
Here are two Cumulus generated xAP messages.
Code:xap-header { v=12 hop=1 uid=FF437500 class=weather.report source=sanday.cumulus.ICS-HST } weather.report { UTC=16:39 DATE=20120209 WindM=10.0 WindK=16.1 WindGustsM=17.0 WindGustsK=27.4 WindDirD=197 WindDirC=S TempC=-1.4 TempF=29.4 DewC=-5.3 DewF=22.5 AirPressure=1026.0 Rain=0.0 }
Code:xap-header { v=12 hop=1 uid=FF437500 class=weather.report source=sanday.cumulus.ICS-STORAGE-2 } weather.report { UTC=16:42 DATE=20120209 WindM=2.2 WindK=3.6 WindGustsM=5.4 WindGustsK=8.6 WindDirD=360 WindDirC=N TempC=2.7 TempF=36.9 DewC=-6.2 DewF=20.9 AirPressure=1028.0 Rain=0.0 }
- Pete C
HW-HAI OPII - X10,UPB,Z-Wave,Russound,1-Wire(X4 networks) OmniTouch screens, Intel & Arm Touchscreens (Android, Wintel & Linux)and OmniStat2
SW-HSPro - Atom D525/4Gb -W2003SP2 X86 - 18 serial ports via USB (Digi Edgeports & Digi Hub)
Weather Cumulus - Fine Offset & Davis Vantage Vue
Comment
-
-
Which brings us to
weather.report
{
UTC=(Time of report in hh:mm format using utc time zone)
-- mandatory
DATE=(Date of report in YYYYMMDD format)
-- mandatory
WindM=(Value of wind in mph or "Gusty" if gusty)
-- optional
WindK=(Value of wind in kph or "Gusty" if gusty)
-- optional
WindGustsM=(Value of wind gusts in mph)
-- optional
WindGustsK=(Value of wind gusts in kph)
-- optional
WindDirC=(Compas heading of wind N|NE|E|SE|S|SW|W|NW)
-- optional
WindDirD=(Compas heading of wind in degrees)
-- optional
TempC=(Temperature in centigrade)
-- optional
TempF=(Temperature in fahrenheit)
-- optional
DewC=(Dew point in fahrenheit)
-- optional
DewF=(Dew point in fahrenheit)
-- optional
RainM=(Rainfall since midnight in mm)
-- optional
RainI=(Rainfall since midnight in inches)
-- optional
Humidity=(Relative Humidity as %)
-- optional
AirPressure=(Air pressure in hPa)
-- optional
Cloud=(Overal cloud cover currently only "Clear Skies")
-- optional
CloudM.X=(Cloud type and height in miles ie "Overcast at 5.4M. X increments on each cloud layer)
-- optional
CloudK.X=(Cloud type and heightin kilometers ie "Overcast at 5.4Km. X increments on each cloud layer)
-- optional
Icon=(The name of the picture to use, icon names from kweather www.kde.org. File names below)
-- optional
Error=(Download errors either "NoData" if last connection failed or "StationNotFound" if ICAO code isn't valid)
-- optional
}
If we agree on this I will update the wiki
kevint
Comment
-
-
I have received one email from someone who can't post to AH forum (for some reason) re WindChill - any thoughts - is this an important one Pete, and have you others ?
Also I don't really like RainM (for mm) because CloudM is miles - however it's already messed up in the existing schema with WindDirC for 'compass' and TempC for centigrade so I think we scuppered that earlier. RainM it is, even though it's wet in the Pennines I've never seen it measured in miles.
In hindsight I think a metric and/or imperial body would have been better, or appending units to values (and maybe 'period' blocks eg hourly, daily ). Definite scope here for a new schema.
K
PS Do people want to include indoor humidity and temperature in a weather schema - I know a lot of weather stations have this built in ?Last edited by Kevin; 9 February 2012, 06:02 PM.
Comment
-
-
Windchill
Windchill is certainly available inside Weather Display
and could be defined in the schema as follows:-
WindchillC=(Windchill Temperature in centigrade)
-- optional
WindchillF=(Windchill Temperature in fahrenheit)
-- optional
Edit---
Indoor Temperature and Humidity could be
InTempC=(Indoor Temperature in centigrade)
-- optional
InTempF=(Indoor Temperature in fahrenheit)
-- optional
InHumidity=(Indoor Relative Humidity as %)
-- optional
We could also add for a webcam or weather picture
Picture=(url to weather/webcam picture)
--optional
End edit
kevintLast edited by kev_t; 9 February 2012, 06:15 PM.
Comment
-
-
The adds sound good. Regarding the rain nomenclature; it really doesn't matter to me as long as there is a distinction between metric and inches. So in summary we are looking at?
Forgot too that barometric pressure can be in:
inHg and millibars/hectopascal?
weather.report
{
UTC=(Time of report in hh:mm format using utc time zone)
-- mandatory
DATE=(Date of report in YYYYMMDD format)
-- mandatory
WindM=(Value of wind in mph or "Gusty" if gusty)
-- optional
WindK=(Value of wind in kph or "Gusty" if gusty)
-- optional
WindGustsM=(Value of wind gusts in mph)
-- optional
WindGustsK=(Value of wind gusts in kph)
-- optional
WindDirC=(Compas heading of wind N|NE|E|SE|S|SW|W|NW)
-- optional
WindDirD=(Compas heading of wind in degrees)
-- optional
TempC=(Temperature in centigrade)
-- optional
TempF=(Temperature in fahrenheit)
-- optional
DewC=(Dew point in fahrenheit)
-- optional
DewF=(Dew point in fahrenheit)
-- optional
RainM=(Rainfall since midnight in mm)
-- optional
RainI=(Rainfall since midnight in inches)
-- optional
Humidity=(Relative Humidity as %)
-- optional
AirPressure=(Air pressure in hPa)
-- optional
Cloud=(Overal cloud cover currently only "Clear Skies")
-- optional
CloudM.X=(Cloud type and height in miles ie "Overcast at 5.4M. X increments on each cloud layer)
-- optional
CloudK.X=(Cloud type and heightin kilometers ie "Overcast at 5.4Km. X increments on each cloud layer)
-- optional
WindchillC=(Windchill Temperature in centigrade)
-- optional
WindchillF=(Windchill Temperature in fahrenheit)
-- optional
InTempC=(Indoor Temperature in centigrade)
-- optional
InTempF=(Indoor Temperature in fahrenheit)
-- optional
InHumidity=(Indoor Relative Humidity as %)
-- optional
Picture=(url to weather/webcam picture)
--optional
Icon=(The name of the picture to use, icon names from kweather www.kde.org. File names below)
-- optional
Error=(Download errors either "NoData" if last connection failed or "StationNotFound" if ICAO code isn't valid)
-- optional
}Last edited by pete_c; 10 February 2012, 02:07 AM.- Pete C
HW-HAI OPII - X10,UPB,Z-Wave,Russound,1-Wire(X4 networks) OmniTouch screens, Intel & Arm Touchscreens (Android, Wintel & Linux)and OmniStat2
SW-HSPro - Atom D525/4Gb -W2003SP2 X86 - 18 serial ports via USB (Digi Edgeports & Digi Hub)
Weather Cumulus - Fine Offset & Davis Vantage Vue
Comment
-
-
Anyone else?
Anyone else want to chip in?
or comment about the airpressure issue pete has raised
kevint
edit -->
From wikipedia
The SI unit of measure is the Pascal, meteorlogists apparantly prefer the hectopascal (hPa) for atmospheric air pressure, which is equivalent to the older unit millibar (mbar).
The inch of mercury (inHg) is still widely used for barometric pressure in weather reports, refrigeration and aviation in the United States, but is seldom used elsewhere.
end wikipedia
end editLast edited by kev_t; 10 February 2012, 09:35 PM.
Comment
-
-
Mostly though for air pressure what is personally looked at is if its going up or down and by how much; seldom just the value itself. Typically I utilize an up, down or sideways icon to designate what is going on with the barometric air pressure.
Still like my little glass tube filled with a colored liquid in my office; old fashioned a bit and works well.
Thank you Kev_t for having a look see / and adds to the xAP weather report stuff.- Pete C
HW-HAI OPII - X10,UPB,Z-Wave,Russound,1-Wire(X4 networks) OmniTouch screens, Intel & Arm Touchscreens (Android, Wintel & Linux)and OmniStat2
SW-HSPro - Atom D525/4Gb -W2003SP2 X86 - 18 serial ports via USB (Digi Edgeports & Digi Hub)
Weather Cumulus - Fine Offset & Davis Vantage Vue
Comment
-
-
So following the existing conventions
AirPressureP=(Air pressure in hPa)
-- optional
AirPressureH=(Air pressure in inHg)
-- optional
and perhaps?
AirPressureI=(Air Pressure Indication Rising/Steady/Falling)
-- optional
Although this is based on an existing schema, this proposal has been significantly changed and extended. Perhaps we should, for reference purposes, call the original version 1, and this one version 2, with version 1 retained on the wiki, but marked as depracated? (http://en.wikipedia.org/wiki/Deprecation)
Comment
-
-
The three references would be nice Kev.
AirPressureP=(Air pressure in hPa)
-- optional
AirPressureH=(Air pressure in inHg)
-- optional
AirPressureI=(Air Pressure Indication Rising/Steady/Falling)
-- optional
So as not to overwhelm the weather report page of the wiki can the depreciated version 1 be referred to and linked instead of on the same page?
Does that make sense?Last edited by pete_c; 11 February 2012, 04:36 PM.- Pete C
HW-HAI OPII - X10,UPB,Z-Wave,Russound,1-Wire(X4 networks) OmniTouch screens, Intel & Arm Touchscreens (Android, Wintel & Linux)and OmniStat2
SW-HSPro - Atom D525/4Gb -W2003SP2 X86 - 18 serial ports via USB (Digi Edgeports & Digi Hub)
Weather Cumulus - Fine Offset & Davis Vantage Vue
Comment
-
-
Looking at current implementations...
Looking at extensions to current implementations of the weather.report schema, and do we keep them for version 2?....
There is I think for one wire weather stations:-
extratemp1=-100.0
extratemp2=-100.0
extratemp3=-100.0
extrahum1=-100
extrahum2=-100
extrahum3=-100
from James at mi4's weather connector a complete section:-
Time
{
TOD=Day
Time=11:06:55
SunRise=07:29
SunSet=16:58
}
for which each key is mandatory( http://www.mi4.biz/modules.php?name=...showpage&pid=4)
but I think the section as a whole is intended to be optional
In addition there is a related class for requests
class=weather.request
request
{
request=XXX
}
where XXX is all,report or forecast, where the transmitting staion would be expected to respond with current data. This feature would be optional.
I am also aware that there are the mcs weather connectors http://mcssprinklers.com/xapXap.htm, xapmcsAWS xAP Connector, xapmcsWeatherXML xAP Connector and xapmcsMSNBC xAP Connector which support a Weather.Display schema which is probably different but may be worth examining. I confess to not having much success with these, presumably because I do not run homeseer and they are also probaly US-centric, but I am just guessing really
On editing the wiki, I would probably put version 2 at the top of the page and version 1 below it ..
and as a reminder for editing
Compass has 2 s's
DewC=(Dew point in centigrade)
kevintLast edited by kev_t; 11 February 2012, 06:43 PM.
Comment
-
-
Relating to Cumulus; here is the txt file generated by the data.
As you have mentioned 1-Wire / weather stuff.
I have the following related to weather measurements and it works well (years now) via now 5 autonomous 1-wire networks (2 Temp08's, Temp05 and 3 9097's). Testing 1-wire via Linux appliances of sorts lately.
Lightning counter, light sensor, many temperature and humidity sensors inside and outside. I do take multiple reads of the outside temperature/humidity sensors.
Extra temperature/humidity sensors would be good to keep from version 1. I am not sure how many folks have lightning or light sensors with their weather stations though.
I didn't know there was another link and configuration schema (mi4.biz).
yes; it would be nice to include:
Time
{
TOD=Day
Time=11:06:55
SunRise=07:29
SunSet=16:58
}
I have been slow shifting to the stand alone mcsxAP applications running them mostly in the wintel world and now also testing them in the Linux world.
They work fine without utilizing Homeseer. I have a few running on different computers (wintel and linux today).Last edited by pete_c; 11 February 2012, 10:28 PM.- Pete C
HW-HAI OPII - X10,UPB,Z-Wave,Russound,1-Wire(X4 networks) OmniTouch screens, Intel & Arm Touchscreens (Android, Wintel & Linux)and OmniStat2
SW-HSPro - Atom D525/4Gb -W2003SP2 X86 - 18 serial ports via USB (Digi Edgeports & Digi Hub)
Weather Cumulus - Fine Offset & Davis Vantage Vue
Comment
-
-
xAP from Cumulus
Hi guys
I've got a Weather Station pumping data to Cumulus 1.8.9 and it spits out xAP packets which I'm picking up with an HAHHub and displaying on a Joggler using Flash.
The xAP construct I'm getting from Cumulus is....
xap-header
{
v=12
hop=1
uid=FF437500
class=weather.report
source=sanday.cumulus.ASROCK
}
weather.report
{
UTC=23:37
DATE=20120116
WindM=0.0
WindK=0.0
WindGustsM=2.2
WindGustsK=3.6
WindDirD=360
WindDirC=N
TempC=0.7
TempF=33.3
DewC=-1.5
DewF=29.3
AirPressure=1017.8
}
Is this what you're after ?
Looking forward to getting more info posted in the xAP packet - it looks like you guys are on a roll......
Keep warm....EJ
Comment
-
-
Originally posted by kev_t View PostSo following the existing conventions
AirPressureP=(Air pressure in hPa)
-- optional
AirPressureH=(Air pressure in inHg)
-- optional
and perhaps?
AirPressureI=(Air Pressure Indication Rising/Steady/Falling)
-- optional
PressureTrend=falling|steady|rising ?
or maybe even a numeric
PressureTrend=-3.2 based on hourly or whatever is the key period or something ?
Just thoughts - the rate of fall is probably of interest.
I'm kind of against the 1-wire multiple sensors thing as there could be any number of them, and several types although temperature will be the predominant one. They aren't really identified as to location and if they stem from say different room sensors they're not really weather information. I think a developer would be better reporting them in a separate block or schema, possibly BSC although it's not ideal for temperature.
I'm concious of the xAP packet size especially if you include paths to files/images etc...
KLast edited by Kevin; 12 February 2012, 12:12 PM.
Comment
-
Comment