notes

//
//  
//  openHAB iOS User Interface
//  Copyright © 2011 Pablo Romeu
//
//  This program is free software: you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation, either version 3 of the License, or
//  (at your option) any later version.
//
//  This program is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU General Public License for more details.
//
//  You should have received a copy of the GNU General Public License
//  along with this program.  If not, see <http://www.gnu.org/licenses/>.

TO DO:

- IMAGES FOR ROLLERSHUTTERS
- See http://code.google.com/p/openhab/wiki/Security LOGIN and HTTPS
- Server and sitemap cells in master or Hide
- MJPEG not working - Solve image error: should timeout if image is not retrieved
- Refresh items too...
- Fast setup wiki


How the model works:

- openhab manages everything
--- openhabItem is an item/group
--- openhabWidget is a widget/s
---> restqueue calls commlibrary and creates a request queue
--------> commLibrary executes the calls

ITEMS GRAMAR
------------
rammar org.openhab.model.Items with org.eclipse.xtext.common.Terminals

generate items "http://www.openhab.org/model/Items"

ItemModel :
	{ItemModel} (items+=ModelItem)*
;

ModelItem :
	(ModelNormalItem | ModelGroupItem) name=ID
	(label=STRING)?
	('<' icon=(ID|STRING) '>')?
	('(' groups+=[ModelGroupItem] (',' groups+=[ModelGroupItem])* ')')? 
	('{' bindings+=ModelBinding (',' bindings+=ModelBinding)* '}')? 
;

ModelGroupItem :
	{ModelGroupItem} 'Group' (':' type=ModelItemType ( ':' function=ModelGroupFunction ('(' args+=(ID|STRING) (',' args+=(ID|STRING))* ')')?)?)?
;

enum ModelGroupFunction :
	AND='AND' | OR='OR' | AVG='AVG' | MAX='MAX' | MIN='MIN'
;

ModelNormalItem :
	type=ModelItemType
;

ModelItemType :
	'Switch' | 'Rollershutter' | 'Number' | 'String' | 'Dimmer' | 'Contact' | 'DateTime'
;

ModelBinding:
	type=ID '=' configuration=STRING
;


WIDGET GRAMMAR
--------------

grammar org.openhab.model.Sitemap with org.eclipse.xtext.common.Terminals

import "http://www.eclipse.org/emf/2002/Ecore" as ecore

generate sitemap "http://www.openhab.org/model/Sitemap"

SitemapModel :
	'sitemap' Sitemap;

Sitemap :
		name=ID ('label=' label=STRING)? ('icon=' icon=STRING)? '{'
			(children+=Widget)+
		'}';

Widget :
	(LinkableWidget | ((Switch | Selection | Slider | List) ));	

LinkableWidget :
	(Text | Group | Image | Frame) ('label=' label=(ID|STRING))? ('icon=' icon=(ID|STRING))?
	('{'
			(children+=Widget)+
	'}')?;

Frame : 'Frame' {Frame} ('item=' item=ID)?;

Text : 
	'Text' {Text} ('item=' item=ID)?;
	
Group : 
	'Group' ('item=' item=ID);

Image : 
	'Image' ('item=' item=ID)? ('url=' url=(STRING));
	
Switch : 
	'Switch' ('item=' item=ID) ('label=' label=(ID|STRING))? ('icon=' icon=(ID|STRING))? ('mappings=[' mappings+=Mapping (',' mappings+=Mapping)* ']')?;
	
Slider :
	'Slider' ('item=' item=ID) ('label=' label=(ID|STRING))? ('icon=' icon=(ID|STRING))? ('sendFrequency=' frequency=ID)? (switchEnabled?='switchSupport')?;
	
Selection : 
	'Selection' ('item=' item=ID) ('label=' label=(ID|STRING))? ('icon=' icon=(ID|STRING))? ('mappings=[' mappings+=Mapping (',' mappings+=Mapping)* ']')?;

List : 
	'List' ('item=' item=ID) ('label=' label=(ID|STRING))? ('icon=' icon=(ID|STRING))? ('separator=' separator=STRING);

Mapping :
	cmd=(ID|STRING) '=' label=(ID|STRING);

terminal ID : '^'?('a'..'z'|'A'..'Z'|'_'|'0'..'9')+;
	
terminal INT returns ecore::EInt: '/*deactivate int definition as we dont need it*/';