Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision |
livebox:xapflash [2012/05/12 22:06] – [Buttons] minerva9 | livebox:xapflash [2017/01/17 20:41] – brett |
---|
* Android based systems | * Android based systems |
* Browsers | * Browsers |
* Flash Player (Linux,windows) | * Flash Player (Linux, Windows) |
| |
| |
<note warning>The installation assumes that you have command line access to your Joggler.\\ If you haven't done this then you need to consult the following documentation.\\ http://www.jogglerwiki.com/wiki/SSH</note> | <note warning>The installation assumes that you have command line access to your Joggler.\\ If you haven't done this then you need to consult the following documentation.\\ http://www.jogglerwiki.com/wiki/SSH</note> |
| |
Above instructions replicated locally in case they ever disappear! [[livebox/xapflash/ssh|Joggler SSH access]] | Above instructions replicated locally in case they ever disappear! [[livebox/xapflash/ssh|Joggler SSH access]] there is also an alternative method that involves booting into a Ubuntu distribution [[jogglercommandshell]] |
| |
{{ :livebox:o2-joggler-tablet.jpg?320}} | {{ :livebox:o2-joggler-tablet.jpg?320}} |
| |
{{ :livebox:xfx-iserver-joggler.png|}} | {{ :livebox:xfx-iserver-joggler.png|}} |
| |
| ==== Joggler xAP binaries ==== |
| |
Installation onto the Joggler is straightforward. | Installation onto the Joggler is straightforward. |
<code> | <code> |
# cd /tmp | # cd /tmp |
# wget http://www.dbzoo.com/public/iserver.run | # wget http://www.dbzoo.com/public/joggler-xap.run |
# sh iserver.run | # sh joggler-xap.run |
</code> | </code> |
| |
Each Joggler installation will use the last 4 HEX digits of the interface to create a unique UID and Source name. In the example screen shot, the iServer is running on my Joggler and you can see it's using part of my MAC address to make itself unique. | This self extracting shell script will install the following onto your Joggler. |
| <code> |
| / |
| |-- etc |
| | |-- init.d |
| | | `-- boot.d |
| | | `-- S70boot.xap |
| | |-- plugboard |
| | | |-- plugboard.lua |
| | | `-- samples |
| | | |-- airytecSwitchoffApplet.lua |
| | | |-- ... |
| | | `-- xapCacheWebserverApplet.lua |
| | `-- xap.d |
| | |-- build |
| | |-- iserver.ini |
| | |-- plugboard.ini |
| | `-- xap-serial.ini |
| |-- setup |
| `-- usr |
| |-- bin |
| | |-- aliasmsg |
| | |-- bscmsg |
| | |-- iServer |
| | |-- ini |
| | |-- iniget -> ini |
| | |-- iniset -> ini |
| | |-- xap-hub |
| | |-- xap-plugboard |
| | `-- xap-serial |
| |-- lib |
| | `-- libxap2.so |
| `-- share |
| `-- lua |
| `-- 5.1 |
| |-- pl |
| | |-- Date.lua |
| | |-- ... |
| | `-- xml.lua |
| `-- xap |
| |-- bluenode.lua |
| |-- ... |
| `-- roomnodetwin.lua |
| </code> |
| |
| To enable various features you edit the ini files in /etc/xap.d setting enable=1 |
| |
| If you are running your Joggler over wireless you need to edit /etc/init.d/boot.d/S70boot.xap and uncomment the "ra0" network interface usage. |
<code> | <code> |
ra0 Link encap:Ethernet HWaddr 00:0E:8E:22:9E:F0 | # Uncomment for WIRELESS |
| MYDEV="-i ra0" |
</code> | </code> |
| |
The following are placed on your Joggler | Your hostname for the Joggler by default is "atom" you can change this in /etc/hostname it will be used in the triple "dbzoo.atom.XAP-PROGRAM" |
* /etc/init.d/boot.d/S70boot.iServer | |
* /usr/bin/iServer | Starting the Joggler xAP software |
| <code> |
| /etc/init.d/boot.d/S70boot.xap start |
| </code> |
| |
| see [[#The 'iserver' parent element]] for configuration of the XML. |
==== xAPFlash installation ==== | ==== xAPFlash installation ==== |
| |
If you already have xapflash installed on your Joggler this will perform an upgrade of the graphics and application leaving your XML configuration files intact. If you don't already have it installed, it will additionally modify a configuration file so that the LAUNCH icon appears on your Joggler dashboard. A reboot will be required if installing for the first time. UPDATE: I found that even if just upgrading you needed a reboot for the new version to load. | If you already have xAPFlash installed on your Joggler this will perform an upgrade of the graphics and application leaving your XML configuration files intact. If you don't already have it installed, it will additionally modify a configuration file so that the LAUNCH icon appears on your Joggler dashboard. A reboot will be required if installing for the first time. UPDATE: I found that even if just upgrading you needed a reboot for the new version to load. |
| |
<code> | <code> |
* xapconfig.xml: ''<joggler> <layout> <background>'' | * xapconfig.xml: ''<joggler> <layout> <background>'' |
* xapconfig.xml: ''<joggler> <page> <background>'' | * xapconfig.xml: ''<joggler> <page> <background>'' |
* xapconfig.xml: ''<joggler> <page> <textbox> <background>'' | * xapconfig.xml: ''%%<joggler> <page> <textbox> <background>%%'' |
* config.xml: ''<joggler> <override> <layout> <background>'' | * config.xml: ''<joggler> <override> <layout> <background>'' |
| |
* L - Usable in the <layout> section | * L - Usable in the <layout> section |
* P - Usable in a <page> section | * P - Usable in a <page> section |
* T - Usable in a <textbox> section | * T - Usable in a %%<textbox>%% section |
| |
^ Tag ^ Key ^ Value ^ Description ^ | ^ Tag ^ Key ^ Value ^ Description ^ |
| |
Parent tag locations: | Parent tag locations: |
* config.xml: ''<joggler> <layout> <defaults>'' | * config.xml: ''%%<joggler> <layout> <defaults>%%'' |
* xapconfig.xml: ''<joggler> <layout> <defaults>'' | * xapconfig.xml: ''%%<joggler> <layout> <defaults>%%'' |
* config.xml: ''<joggler> <override> <layout> <defaults>'' | * config.xml: ''%%<joggler> <override> <layout> <defaults>%%'' |
| |
Here we establish the baseline for our visual components to create a common look and feel and to reduce the amount of repetition in their specification. | Here we establish the baseline for our visual components to create a common look and feel and to reduce the amount of repetition in their specification. |
| |
^^ Parent tag ^^ Allowed child tags ^^ Description ^^ | ^^ Parent tag ^^ Allowed child tags ^^ Description ^^ |
|| <label> || <font> <fontsize> <fontcolour> <alpha> <offset> || || | || %%<label>%% || %%<font> <fontsize> <fontcolour> <alpha> <offset>%% || || |
|| <bsctext> || <font> <fontsize> <fontcolour> <alpha>|| || | || <bsctext> || %%<font> <fontsize> <fontcolour> <alpha>%%|| || |
|| <button> || <font> <fontsize> <fontcolour> <alpha>|| || | || %%<button>%% || %%<font> <fontsize> <fontcolour> <alpha>%%|| || |
|| <textBox> || <font> <fontsize> <fontcolour> <alpha> <align> || || | || %%<textBox>%% || %%<font> <fontsize> <fontcolour> <alpha> <align>%% || || |
|| <time> || <font> <fontsize> <fontcolour> <alpha> <show> || || | || <time> || %%<font> <fontsize> <fontcolour> <alpha> <show>%% || || |
|| <button> || <style> <height> <width> <alpha> || || | || %%<button>%% || %%<style> <height> <width> <alpha>%% || || |
| |
Details about the children | Details about the children |
^^ Tag ^^ Description ^^ | ^^ Tag ^^ Description ^^ |
|| <font> || The name of a Font available from inside Flash. **Default: Verdana** || | || %%<font>%% || The name of a Font available from inside Flash. **Default: Verdana** || |
|| <fontsize> || the size of the font. **Default: 14** || | || <fontsize> || the size of the font. **Default: 14** || |
|| <fontcolour> || A Hex triple in the format 0xRRGGBB \\ \\ Default: \\ label,textBox: 0xFFFFFF\\ bsctext,time: 0xFFFFCC || | || <fontcolour> || A Hex triple in the format 0xRRGGBB \\ \\ Default: \\ label,textBox: 0xFFFFFF\\ bsctext,time: 0xFFFFCC || |
|| <show> || valid values: true, false. **Default: true** || | || <show> || valid values: true, false. **Default: true** || |
|| <offset> || This is the vertical offset of the label from its default - just below the button position (positive or negative, you can also use the word 'centre' to auto compute an offset. || | || <offset> || This is the vertical offset of the label from its default - just below the button position (positive or negative, you can also use the word 'centre' to auto compute an offset. || |
|| <style> || Defines the look and feel for the button. see [[#the 'style' tag]] || | || %%<style>%% || Defines the look and feel for the button. see [[#the 'style' tag]] || |
|| <width> || Default width || | || <width> || Default width || |
|| <height> || Default height || | || <height> || Default height || |
| |
They maybe populated with any of the following child tags according to the usage key legend below | They maybe populated with any of the following child tags according to the usage key legend below |
* BT - ''<button>'' & ''<textbox>'' | * BT - ''<button>'' & ''%%<textbox>%%'' |
* B - ''<button>'' only | * B - ''<button>'' only |
* T - ''<textbox>'' only | * T - ''%%<textbox>%%'' only |
| |
^ Tag ^ Key ^ Description ^ | ^ Tag ^ Key ^ Description ^ |
No feedback from the endpoint can be rendered as part of the button's state, this is a fire-and-forget xAP message generator. | No feedback from the endpoint can be rendered as part of the button's state, this is a fire-and-forget xAP message generator. |
| |
<note important>The UID an SOURCE tags will be overwritten with the xAPFlash applications values however place holders for them must be present in the RAW xAP message and they cannot be omitted.</note> | <note important>The UID and SOURCE tags will be overwritten with the xAPFlash applications values however place holders for them must be present in the RAW xAP message and they cannot be omitted.</note> |
| |
<code xml> | <code xml> |
| <background> | see [[#the 'background' section]]. | | | <background> | see [[#the 'background' section]]. | |
| <alpha> | Alpha blending from 0.0 (transparent) to 1.0 (opaque). ALL objects on the page will inherit this value. | | | <alpha> | Alpha blending from 0.0 (transparent) to 1.0 (opaque). ALL objects on the page will inherit this value. | |
| <visible> | Boolean to shows or hides the element at startup. Default: true | | | <visible> | Boolean to show or hide the element at startup. Default: true | |
| <group> | Only one member of a group can be active at once (radio group). If a page in the group is made visible all others will be hidden. | | | <group> | Only one member of a group can be active at once (radio group). If a page in the group is made visible all others will be hidden. | |
| |
Some buttons of various colours. | Some buttons of various colours. |
| |
| {{:livebox:glossy_yellow_button.png|}} | {{:livebox:glossy_blue_button.png|}} | {{:livebox:glossy_purple_button.png|}} | | | {{:livebox:glossy_yellow_button.png|}} | {{:livebox:glossy_blue_button.png|}} | {{:livebox:glossy_purple_button.png|}} | {{:livebox:glossy_button_dkgreen.png|}} | |
| {{:livebox:glossy_button_off_.png| }} | {{:livebox:glossy_button_on_.png| }} | {{:livebox:glossy_pink_button.png|}} | | | {{:livebox:glossy_button_off_.png| }} | {{:livebox:glossy_button_on_.png| }} | {{:livebox:glossy_pink_button.png|}} | |
| {{:livebox:glossy_orange_button.png|}} | {{:livebox:glossy_cyan_button.png|}} | {{:livebox:glossy_gray_button.png|}} | | | {{:livebox:glossy_orange_button.png|}} | {{:livebox:glossy_cyan_button.png|}} | {{:livebox:glossy_gray_button.png|}} | |