Signal Meta Tag

Signal (META Tag) Syntax
<META HTTP-Equiv="Signal" content="[parameter>
<META HTTP-Equiv="Signal" content="SignalEvent:url('[jsFunction | url]')">

Items listed in this section indicate parameters, or attributes which can be set.

Name	Possible Values	Description	Default Value
Visibility:[Value]	Visible or Hidden	Sets whether or not the battery indicator is shown	Hidden
Left:[Value]	Pixel value	Sets the horizontal position of the wireless signal indicator in pixels. If negative the indicator will be off the screen	Top right of screen
Top:[Value]	Pixel value	Sets the vertical position of the wireless signal indicator in pixels. If negative then it will be off the screen	Top right of screen
IconPosition:[Value]	Left, Right, Top, Bottom	Sets the position of indicator icon with respect to Graph position. "Iconposition" and "Graphposition" combination must be valid combination e.g both cannot be left.	Bottom
GraphPosition:[Value]	Left, Right, Top, Bottom	Sets the direction towards which level bars will grow e.g if value is Left then level bars grow from right to left. "Iconposition" and "Graphposition" combination must be valid combination e.g both cannot be left.	Right
Color:[Value]	Hex Values (#000000 - #FFFFFF)	RGB value that sets the color of the wireless signal indicator using HTML web colors RR-Red, GG-Green and BB-Blue	#000000

Copy parameters template to clipboard:

META Tags

Javascript

<!-- The Signal META Tag is an action tag used to set positional and display parameters of the wireless signal indicator on the screen. --> <!-- <META HTTP-Equiv="Signal" Content="Visibility:[Value]"> --> <!-- Sets whether or not the battery indicator is shown --> <!-- <META HTTP-Equiv="Signal" Content="Left:[Value]"> --> <!-- Sets the horizontal position of the wireless signal indicator in pixels. If negative the indicator will be off the screen --> <!-- <META HTTP-Equiv="Signal" Content="Top:[Value]"> --> <!-- Sets the vertical position of the wireless signal indicator in pixels. If negative then it will be off the screen --> <!-- <META HTTP-Equiv="Signal" Content="IconPosition:[Value]"> --> <!-- Sets the position of indicator icon with respect to Graph position. "Iconposition" and "Graphposition" combination must be valid combination e.g both cannot be left. --> <!-- <META HTTP-Equiv="Signal" Content="GraphPosition:[Value]"> --> <!-- Sets the direction towards which level bars will grow e.g if value is Left then level bars grow from right to left. "Iconposition" and "Graphposition" combination must be valid combination e.g both cannot be left. --> <!-- <META HTTP-Equiv="Signal" Content="Color:[Value]"> --> <!-- RGB value that sets the color of the wireless signal indicator using HTML web colors RR-Red, GG-Green and BB-Blue -->

<script> /* The Signal META Tag is an action tag used to set positional and display parameters of the wireless signal indicator on the screen. */ function doSignalInit() { var objGeneric = new ActiveXObject("PocketBrowser.Generic"); //objGeneric.InvokeMETAFunction('Signal', 'Visibility:[Value]'); /* Sets whether or not the battery indicator is shown */ //objGeneric.InvokeMETAFunction('Signal', 'Left:[Value]'); /* Sets the horizontal position of the wireless signal indicator in pixels. If negative the indicator will be off the screen */ //objGeneric.InvokeMETAFunction('Signal', 'Top:[Value]'); /* Sets the vertical position of the wireless signal indicator in pixels. If negative then it will be off the screen */ //objGeneric.InvokeMETAFunction('Signal', 'IconPosition:[Value]'); /* Sets the position of indicator icon with respect to Graph position. "Iconposition" and "Graphposition" combination must be valid combination e.g both cannot be left. */ //objGeneric.InvokeMETAFunction('Signal', 'GraphPosition:[Value]'); /* Sets the direction towards which level bars will grow e.g if value is Left then level bars grow from right to left. "Iconposition" and "Graphposition" combination must be valid combination e.g both cannot be left. */ //objGeneric.InvokeMETAFunction('Signal', 'Color:[Value]'); /* RGB value that sets the color of the wireless signal indicator using HTML web colors RR-Red, GG-Green and BB-Blue */ } </script>

Modules return information back to their web pages via retrieval tags, for example the scanner has a retrieval tag called 'DecodeEvent' which is called whenever it decodes a barcode. To register to receive a retrieval tag call the module as follows:

<META HTTP-Equiv="[Module]" content="[RetrievalTag]:url('[URI]')">

So to register to retrieve the Scanner's DecodeEvent the following syntax would be used:

<META HTTP-Equiv="Scanner" content="DecodeEvent:url('Javascript:doScan('%6', '%s', %3, '%2');')">

Retrieval tags return information by replacing the text in place holders, defined as '%s' or '%<number>'. Each place holder represents 1 return value with '%s' being populated sequentially or '%<number>' providing direct acces to the desired value.

If the content for the Scanner's DecodeEvent is:

"url('Javascript:doScan('%6', '%s', %3, '%2');')"

The function would be called as follows:

"Javascript:doScan('Decode', '5449000053879', 0x35, 'SCN:EAN13');"

SignalEvent

The SignalEvent gives an indication of the signal level and other associated information. Once registered for you will receive a SignalEvent at regular intervals, as specified by the SignalRefresh configuration setting.

ID	Name	Description
1	Signal Strength	Signal strength value as a percentage
2	ESSID	Current ESSID
3	MAC Address	Device's MAC address
4	Adapter Name	Device's adapter name
5	DHCP Server	Current DHCP servers address
6	DHCP Static	Whether the unit has a static or DHCP address
7	Gateway	Current gateway IP address
8	IP Address	Current IP address
9	RSSI	Signal strength in RSSI terms
10	Subnet Mask	Current subnet mask
11	Wins	Current WINs server IP address

<!-- <META HTTP-Equiv="Signal" Content="SignalEvent:url('JavaScript:fnJSCallbackHandler('%1', '%2', '%3', '%4', '%5', '%6', '%7', '%8', '%9', '%10', '%11');')"> -->

<script> /* function doSignalInit() { var objGeneric = new ActiveXObject("PocketBrowser.Generic"); //objGeneric.InvokeMETAFunction('Signal', 'SignalEvent:url('JavaScript:fnJSCallbackHandler('%1', '%2', '%3', '%4', '%5', '%6', '%7', '%8', '%9', '%10', '%11');')'); /* The SignalEvent gives an indication of the signal level and other associated information. Once registered for you will receive a SignalEvent at regular intervals, as specified by the SignalRefresh configuration setting. */ } </script>

Copy this return value template to clipboard:

META Tags

Javascript

The following example shows the wireless signal indicator, sets the position to (50, 50), the color of the indicator beneath the bars growing from right to left:

<META HTTP-Equiv="Signal" Content="Visibility:Visible"> <META HTTP-Equiv="Signal" Content="Left:50"> <META HTTP-Equiv="Signal" Content="Top:50"> <META HTTP-Equiv="Signal" Content="Iconposition:Bottom; GraphPosition:Right"> <META HTTP-Equiv="Signal" Content="Color:#FF0000">

Copy example to clipboard

<!-- The following example shows the wireless signal indicator, sets the position to (50, 50), the color of the indicator beneath the bars growing from right to left: --> <META HTTP-Equiv="Signal" Content="Visibility:Visible"> <META HTTP-Equiv="Signal" Content="Left:50"> <META HTTP-Equiv="Signal" Content="Top:50"> <META HTTP-Equiv="Signal" Content="Iconposition:Bottom; GraphPosition:Right"> <META HTTP-Equiv="Signal" Content="Color:#FF0000">

Above example can also be written in EMML1.1 as given below

<META HTTP-Equiv="Signal" Content="Left:50; Top:50; Color:#FF0000; Visibility:Visible">

Copy example to clipboard

<!-- Above example can also be written in EMML1.1 as given below --> <META HTTP-Equiv="Signal" Content="Left:50; Top:50; Color:#FF0000; Visibility:Visible">

In EMML1.1 it is also possible to concatenate the Parameter with the module name. The example above can also be written as:

<META HTTP-Equiv="Signal-Left" Content="50"> <META HTTP-Equiv="Signal-Top" Content="50"> <META HTTP-Equiv="Signal-Color" Content="#FF0000">

Copy example to clipboard

<!-- In EMML1.1 it is also possible to concatenate the Parameter with the module name. The example above can also be written as: --> <META HTTP-Equiv="Signal-Left" Content="50"> <META HTTP-Equiv="Signal-Top" Content="50"> <META HTTP-Equiv="Signal-Color" Content="#FF0000">

The following example navigates to a new page with parameters upon a wirelss signal status change:

<META HTTP-Equiv="Signal" Content="signalevent:url('mypage.asp?Signal percentage=%s&ESSID=%s&MacAdd=%s&Adapter=%s&DHCPServ=%s&Mode=%s&Gateway=%s&IPAddress=%s&RSSI=%s&Subnet=%s&Wins=%s')">

Copy example to clipboard

<!-- The following example navigates to a new page with parameters upon a wirelss signal status change: --> <META HTTP-Equiv="Signal" Content="signalevent:url('mypage.asp?Signal percentage=%s&ESSID=%s&MacAdd=%s&Adapter=%s&DHCPServ=%s&Mode=%s&Gateway=%s&IPAddress=%s&RSSI=%s&Subnet=%s&Wins=%s')">

Overlapping

Do not display the Battery indicator overlapping with the Signal indicator.

Indicator Positions

For an illustrative guide to the meaning of IconPosition and GraphPositions see the 'Indicator Positions' section.

Supported Platforms	Windows CE, Windows Mobile, Windows Mobile SE
Persistence	With the exception of the return events, this tag is persistent.
Min. Requirements	None.