Webtags (preserving history): Difference between revisions

m
Tried to swap MX information and CI information throughout page, so MX read first
m (Corrections)
m (Tried to swap MX information and CI information throughout page, so MX read first)
Line 33: Line 33:
There is a basic guide to what these parameters can do, and another link to the new page at [[#Input Modification Parameters and Output Modification Parameter]] later on this page.
There is a basic guide to what these parameters can do, and another link to the new page at [[#Input Modification Parameters and Output Modification Parameter]] later on this page.


{{TOCright}}
{{TOCright}} [[Category:Cumulus 1]]
 
===The tag names===
===The tag names===


Line 307: Line 308:
|-
|-
|<#feelslike>
|<#feelslike>
|{{Version badge 1}} Not available in Cumulus 1.
|[[File:Badge v1.png]] Not available in Cumulus 1.


[[File:Badge vMx.png]]Not available in all MX versions. Please see [[#Feels_Like|sub-section before this table]] regarding availability by MX versions if you are using a MX version earlier than 3.6.10.
[[File:Badge vMx.png]]Not available in all MX versions. Please see [[#Feels_Like|sub-section before this table]] regarding availability by MX versions if you are using a MX version earlier than 3.6.10.
Line 713: Line 714:
Ecowitt stations are sold under other names depending on nation,  e.g. Ambient in USA, Froggit in central Europe, so Ecowitt is used as a generic name in same way as Fine Offset is used as a generic name for stations sold under a variety of branding, in this Wiki.
Ecowitt stations are sold under other names depending on nation,  e.g. Ambient in USA, Froggit in central Europe, so Ecowitt is used as a generic name in same way as Fine Offset is used as a generic name for stations sold under a variety of branding, in this Wiki.


{{Version badge 1}} Not available in Cumulus 1..
[[File:Badge v1.png]]Not available in Cumulus 1.


=====Extra Sensors: Ecowitt WH45 CO₂ sensor=====
=====Extra Sensors: Ecowitt WH45 CO₂ sensor=====
Line 759: Line 760:


=====Extra Sensors: Ecowitt Air quality, leak sensors, lighting detector, and extra temperature sensors=====
=====Extra Sensors: Ecowitt Air quality, leak sensors, lighting detector, and extra temperature sensors=====
{{Version badge 1}} Not available in Cumulus 1.
 
[[File:Badge v1.png]] Not available in Cumulus 1.


[[File:Badge vMx.png]] Please see release announcements for when individual web tags became available
[[File:Badge vMx.png]] Please see release announcements for when individual web tags became available
Line 852: Line 854:
|-
|-
|<#RecentFeelsLike>
|<#RecentFeelsLike>
|{{Version badge 1}} Not available in Cumulus 1.
| [[File:Badge v1.png]] Not available in Cumulus 1.


[[File:Badge vMx.png]] Available from version 3.6.11 (b.3087) onwards.
[[File:Badge vMx.png]] Available from version 3.6.11 (b.3087) onwards.
Line 860: Line 862:
|-
|-
|<#RecentHumidex>
|<#RecentHumidex>
|{{Version badge 1}} Not available in Cumulus 1.
| [[File:Badge v1.png|File]] Not available in Cumulus 1.


[[File:Badge vMx.png]] Available from version 3.7.0 (build 3089) onwards.
[[File:Badge vMx.png]] Available from version 3.7.0 (build 3089) onwards.
Line 999: Line 1,001:
|-
|-
|<#SystemUpTime>
|<#SystemUpTime>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|How long the system has been up, e.g. "8 hours 21 minutes"  
|How long the system has been up, e.g. "8 hours 21 minutes"  
|-
|-
Line 1,007: Line 1,011:
|-
|-
|<#CpuName>
|<#CpuName>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|CPU type, e.g. "Intel(R) Core(TM)2 Quad CPU Q6600 @ 2.40GHz"
|CPU type, e.g. "Intel(R) Core(TM)2 Quad CPU Q6600 @ 2.40GHz"
|-
|-
|<#CpuCount>
|<#CpuCount>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|Number of processors, e.g. "4"
|Number of processors, e.g. "4"
|-
|-
|<#MemoryStatus>
|<#MemoryStatus>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|Free and total system RAM, e.g. "4619/8191 MB (free/total)"
|Free and total system RAM, e.g. "4619/8191 MB (free/total)"
|-
|-
|<#DisplayMode>
|<#DisplayMode>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|Screen display mode, e.g. "1680x1050, 32 bit"
|Screen display mode, e.g. "1680x1050, 32 bit"
|-
|-
|<#AllocatedMemory>
|<#AllocatedMemory>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|Amount of memory allocated to Cumulus, e.g. "18.76 MB"
|Amount of memory allocated to Cumulus, e.g. "18.76 MB"
|-
|-
|<#DiskSize>
|<#DiskSize>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|Size of disk on which Cumulus is running, e.g. "931.51 GB"  
|Size of disk on which Cumulus is running, e.g. "931.51 GB"  
|-
|-
|<#DiskFree>
|<#DiskFree>
|{{Version badge 1}}(not available on MX)
| (not available on MX)
 
[[File:Badge v1.png]] only in legacy Cumulus
|Free space on disk on which Cumulus is running, e.g. "515.36 GB"
|Free space on disk on which Cumulus is running, e.g. "515.36 GB"
|}
|}
Line 1,246: Line 1,264:
**Between midnight and 9am/10am the <#metdate> will return the date associated with previous calendar day, but will still return current time   
**Between midnight and 9am/10am the <#metdate> will return the date associated with previous calendar day, but will still return current time   


{{Version badge 1}}Can be used with relevant format parameters to [[Customised templates|customise]] '''todayT.htm''' template page to display current meteorological day, to customise '''thismonthT.htm''' template page to display meteorological month, and to customise '''thisyearT.htm''' template page to display correct meteorological year. This will be particularly useful on first and last day of month/year when rollover happens at 9 (or 10) a.m. and the month (and maybe year) is different before and after rollover.
Legacy website: Can be used with relevant format parameters to [[Customised templates|customise]] '''todayT.htm''' template page to display current meteorological day, to customise '''thismonthT.htm''' template page to display meteorological month, and to customise '''thisyearT.htm''' template page to display correct meteorological year. This will be particularly useful on first and last day of month/year when rollover happens at 9 (or 10) a.m. and the month (and maybe year) is different before and after rollover.


[[File:Badge vMx.png]] Earlier MX releases provide a similar web template set, so these can be customised in same way as for legacy Cumulus above (but note capital "M" must be used for any month formatting). From release 3.10.1 the supplied web pages are web server based, there are no web templates to customise, and the supplied '''.json files''' do not include any meteorological date functionality.
[[File:Badge vMx.png]] Earlier MX releases provide a similar web template set, so these can be customised in same way as for legacy Cumulus above (but note capital "M" must be used for any month formatting). From release 3.10.1 the supplied web pages are web server based, there are no web templates to customise, and the supplied '''.json files''' do not include any meteorological date functionality.
Line 1,315: Line 1,333:
|-
|-
|<#timeJavaScript>
|<#timeJavaScript>
|{{Version badge 1}} Not available in Cumulus 1.
| [[File:Badge vMx.png]]Available from version 3.5.2, so not available in legacy software
 
[[File:Badge vMx.png]]Available from version 3.5.2


The JavaScript '''Date''' object contains the number of miliseconds since 00:00:00.000 UTC on 1st January 1970, that date and time is known as the UNIX Epoch.  In JavaScript, you can use <tt>Math.floor(new Date().getTime()/1000.0)</tt> This getTime method returns the time in milliseconds.  The web tag returns an integer (currently with 13 digits) representing the number of milliseconds since the UNIX epoch when the web tag was processed. It can be used in a script where you wish to re-express other times output by Cumulus MX into UTC (Coordinated Universal Time).  Mac OS X uses 00:00:00.000 UTC on 1st January 2001 as the starting time and date for its millisecond count, so that is considerably lower.
The JavaScript '''Date''' object contains the number of miliseconds since 00:00:00.000 UTC on 1st January 1970, that date and time is known as the UNIX Epoch.  In JavaScript, you can use <tt>Math.floor(new Date().getTime()/1000.0)</tt> This getTime method returns the time in milliseconds.  The web tag returns an integer (currently with 13 digits) representing the number of milliseconds since the UNIX epoch when the web tag was processed. It can be used in a script where you wish to re-express other times output by Cumulus MX into UTC (Coordinated Universal Time).  Mac OS X uses 00:00:00.000 UTC on 1st January 2001 as the starting time and date for its millisecond count, so that is considerably lower.
Line 1,326: Line 1,342:
|-
|-
|<#timeUnix>
|<#timeUnix>
|{{Version badge 1}} Not available in Cumulus 1.
| [[File:Badge vMx.png]]Available from version 3.7.0, so not available in legacy software
 
[[File:Badge vMx.png]]Available from version 3.7.0


Unix tracks the number of seconds since the UNIX epoch. So this web tag can be used when you do not want the millisecond accuracy of the previous web tag. Like previous web tag this relates to UTC, so see details for that tag to find out more. This is equivalent in PHP 5 and PHP 7 to '''time();''' (in PHP 8, a parameter is mandatory for time function, so the call changes).
Unix tracks the number of seconds since the UNIX epoch. So this web tag can be used when you do not want the millisecond accuracy of the previous web tag. Like previous web tag this relates to UTC, so see details for that tag to find out more. This is equivalent in PHP 5 and PHP 7 to '''time();''' (in PHP 8, a parameter is mandatory for time function, so the call changes).
Line 1,382: Line 1,396:
If there is no entry in Weather Diary for the day explained above, reports zero.
If there is no entry in Weather Diary for the day explained above, reports zero.


{{Version badge 1}} Input and output is always as integer. Available from very early builds, weather diary input amended from version 1.8.6 14th April 2009 to allow units to be specified on diary edit screen. If you choose to enter as whole millimetres, you can use JavaScript (or another script language) on your web page to divide the web tag by 10 and get centimetres to 1 decimal place on output.  
[[File:Badge vMx.png]] Input is to 2 decimal places. Available from version 3.1.1 - build 3054 when weather diary editor was added to MXMX allows output in centimetres with decimal places without any script. You can't change the units shown in admin interface, but your value can be input as inches to 2 decimal places if you ignore "cm" that is displayed in that interface.


[[File:Badge vMx.png]] Input is to 2 decimal places. Available from version 3.1.1 - build 3054 when weather diary editor was added to MX. MX allows output in centimetres with decimal places without any script. You can't change the units shown in admin interface, but your value can be input as inches to 2 decimal places if you ignore "cm" that is displayed in that interface.
[[File:Badge v1.png|Fil]] Input and output is always as integer. Available from very early builds, weather diary input amended from version 1.8.6 14th April 2009 to allow units to be specified on diary edit screen. If you choose to enter as whole millimetres, you can use JavaScript (or another script language) on your web page to divide the web tag by 10 and get centimetres to 1 decimal place on output.  
|-
|-
|<#snowlying>
|<#snowlying>
|{{Version badge 1}}Although this tag is not available in Cumulus 1, your web page can use a script to check if <#snowdepth> is non zero, as that means snow is lying
| [[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.  If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.


[[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.  If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.
[[File:Badge v1.png]] Although this tag is not available in Cumulus 1, your web page can use a script to check if <#snowdepth> is non zero, as that means snow is lying
|-
|-
|<#snowfalling>
|<#snowfalling>
|{{Version badge 1}} Not available in Cumulus 1. There is no web page workaround, unless you write a script that reads [[Weather Diary]] and makes relevant information available on your web server.
| [[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.     If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.


[[File:Badge vMx.png]] Available from version 3.1.1 - build 3054.     If there is no entry in Weather Diary for the day explained above, , this web tag returns Null. Otherwise reports 1 if tick in diary, 0 is unticked.
[[File:Badge v1.png]] Not available in Cumulus 1. There is no web page workaround, unless you write a script that reads [[Weather Diary]] and makes relevant information available on your web server.
|}
|}


Line 2,628: Line 2,642:
|<#newrecord>  
|<#newrecord>  
|Indicates when any tracked extreme is changed.
|Indicates when any tracked extreme is changed.
*{{Version badge 1}}In Cumulus 1.x.x:
* [[File:Badge vMx.png]]In Cumulus MX: 1 from when new record is set until
** either all records have cleared
** or until next rollover is completed,
** or (in recent releases) until the number of hours for clearing extreme record notifications has passed
* 0 otherwise
* [[File:Badge v1.png]]In Cumulus 1.x.x:
** 1 if 'new record' light is flashing,  
** 1 if 'new record' light is flashing,  
**0 if not
** 0 if not
*[[File:Badge vMx.png]]In Cumulus MX: 1 from when new record is set until
** either all records have cleared
**or until next rollover is completed,
*0 otherwise
|-
|-
|<#TempRecordSet>
|<#TempRecordSet>
5,838

edits