Signal Meta Tag

PocketBrowser 3.x API

The Signal Meta Tag is an action tag used to set position and display parameters of the wireless signal indicator on the screen.

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: Copy META Tag template to clipboard META Tags Copy Javascript template to clipboard Javascript

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
Copy this return value template to clipboard: Copy META Tag template to clipboard META Tags Copy Javascript template to clipboard 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 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">
Copy example to clipboard 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">
Copy example to clipboard 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')">
Copy example to clipboard Copy example to clipboard
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.