<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=utf-8">
<meta name=Generator content="Microsoft Word 12 (filtered medium)">
<base href="x-msg://21/">
<style>
<!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:"MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
@font-face
{font-family:"MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
{font-family:"Microsoft YaHei";
panose-1:2 11 5 3 2 2 4 2 2 4;}
@font-face
{font-family:"\@Microsoft YaHei";
panose-1:2 11 5 3 2 2 4 2 2 4;}
@font-face
{font-family:"\@MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
@font-face
{font-family:NeuzeitGroT-Bol;}
@font-face
{font-family:NeuzeitGroT-Reg;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
{mso-style-priority:34;
margin-top:0cm;
margin-right:0cm;
margin-bottom:0cm;
margin-left:36.0pt;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif";}
span.apple-style-span
{mso-style-name:apple-style-span;}
span.apple-converted-space
{mso-style-name:apple-converted-space;}
span.E-MailFormatvorlage19
{mso-style-type:personal;
font-family:"Calibri","sans-serif";
color:#1F497D;}
span.E-MailFormatvorlage20
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page Section1
{size:612.0pt 792.0pt;
margin:70.85pt 70.85pt 2.0cm 70.85pt;}
div.Section1
{page:Section1;}
/* List Definitions */
@list l0
{mso-list-id:1154836246;
mso-list-type:hybrid;
mso-list-template-ids:-1723031604 -1422616650 67567619 67567621 67567617 67567619 67567621 67567617 67567619 67567621;}
@list l0:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;
font-family:Symbol;
mso-fareast-font-family:Calibri;
mso-bidi-font-family:NeuzeitGroT-Reg;}
@list l0:level2
{mso-level-tab-stop:72.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level3
{mso-level-tab-stop:108.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level4
{mso-level-tab-stop:144.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level5
{mso-level-tab-stop:180.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level6
{mso-level-tab-stop:216.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level7
{mso-level-tab-stop:252.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level8
{mso-level-tab-stop:288.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level9
{mso-level-tab-stop:324.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
ol
{margin-bottom:0cm;}
ul
{margin-bottom:0cm;}
-->
</style>
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=DE link=blue vlink=purple style='word-wrap: break-word;-webkit-nbsp-mode: space;
-webkit-line-break: after-white-space'>
<div class=Section1>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>Hi
Dev-List, Hi Xue<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>The
dSK20 has a prototype dSS with a minimal software (no scripting and no
long-term-metering-storage), but it has a webinterface, which differes in the
json calls from the opensource dss, but can provide the same features (attempts
to provide the same interface from the older dSS in the newer dSS were not successful)
….<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>So you can write a App for digitalSTROM and you can use the
dSK20 Interface, but you should be aware that without a addition plugin the official
opensource dSS will have a other interface. But I’m sure, that you can handle
it </span><span style='font-size:11.0pt;font-family:Wingdings;color:#1F497D'>J</span><span
style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>.<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>It is true, that there is no documentation about the JSON-Calls for
that dSK dSS, according to the original timeframe the opensource dSS should has
already been world standard, so I was too lazy to make such a documentation </span><span
style='font-size:11.0pt;font-family:Wingdings;color:#1F497D'>J</span><span
style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>.<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>But there is a js-file in the Webinterface which covers most oft
he possible json calls, you can make tot he dSK, it is the digitalSTROM.js
(http:serverid/digitalstrom.js), where all json-calls are encapsulated as a
javascript command with the http-requests. There you can look at to see what
command you can use.<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Additional I can provide you these guildlines which I have
provided some partners (sorry, only german):<o:p></o:p></span></p>
<div style='mso-element:para-border-div;border:none;border-bottom:solid windowtext 1.0pt;
padding:0cm 0cm 1.0pt 0cm'>
<p class=MsoNormal style='border:none;padding:0cm'><span style='font-size:11.0pt;
font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p>
</div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Struktur dSS in dSKXX (dSS10)<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Das
Wohnungs API besteht aus den Definition für Objekte und Zugriffs Methoden. Das digitalSTROM<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>System
wird mit fünf Objekt Klassen abgebildet:<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'><o:p> </o:p></span></p>
<p class=MsoListParagraph style='text-indent:-18.0pt;mso-list:l0 level1 lfo1;
text-autospace:none'><![if !supportLists]><span style='font-family:Symbol'><span
style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]><span style='font-family:NeuzeitGroT-Reg'>Apartment:
Ein einzelnes Objekt für jede dS Installation<o:p></o:p></span></p>
<p class=MsoListParagraph style='text-indent:-18.0pt;mso-list:l0 level1 lfo1;
text-autospace:none'><![if !supportLists]><span style='font-family:Symbol'><span
style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]><span style='font-family:NeuzeitGroT-Reg'>Group:
digitalSTROM Farb- und Benutzergruppen<o:p></o:p></span></p>
<p class=MsoListParagraph style='text-indent:-18.0pt;mso-list:l0 level1 lfo1;
text-autospace:none'><![if !supportLists]><span style='font-family:Symbol'><span
style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]><span style='font-family:NeuzeitGroT-Reg'>Zone: Festlegung
von Räumen<o:p></o:p></span></p>
<p class=MsoListParagraph style='text-indent:-18.0pt;mso-list:l0 level1 lfo1;
text-autospace:none'><![if !supportLists]><span style='font-family:Symbol'><span
style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]><span style='font-family:NeuzeitGroT-Reg'>Circuit:
Entspricht einem Schaltkreis<o:p></o:p></span></p>
<p class=MsoListParagraph style='text-indent:-18.0pt;mso-list:l0 level1 lfo1;
text-autospace:none'><![if !supportLists]><span style='font-family:Symbol'><span
style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]><span style='font-family:NeuzeitGroT-Reg'>Device:
Ein digitalSTROM Gerät, Schalter oder Sensor<o:p></o:p></span></p>
<p class=MsoListParagraph style='text-indent:-18.0pt;mso-list:l0 level1 lfo1;
text-autospace:none'><![if !supportLists]><span style='font-family:Symbol'><span
style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>
</span></span></span><![endif]><span style='font-family:NeuzeitGroT-Reg'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Für
jedes Objekt besteht eine Reihe von Methoden zur Identifikation, Abfrage von Information
und<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Steuerung.<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Die
Objekt Klasse </span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Device
</span><span style='font-family:NeuzeitGroT-Reg'>steht für ein digitalSTROM Device,
also alle dSID Chips und dS-ready<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Geräte.
Ein </span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Device </span><span
style='font-family:NeuzeitGroT-Reg'>ist beschrieben durch seine eindeutige dSID
und Funktions-ID, und kann mit<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>einem
Namen gekennzeichnet werden. Jedes </span><span style='font-size:11.5pt;
font-family:NeuzeitGroT-Reg'>Device </span><span style='font-family:NeuzeitGroT-Reg'>kann
mehreren Gruppen angehören, ist aber<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>mindestens
Mitglied einer vordefinierten digitalSTROM Farbgruppe. Jedes </span><span
style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Device </span><span
style='font-family:NeuzeitGroT-Reg'>kann genau einer<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Zone
zugeordnet werden. Definitionsgemäß kann es natürlich auch nur genau in einem Circuit<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>vorhanden
sein.<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Die
Objekt Klasse </span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Circuit
</span><span style='font-family:NeuzeitGroT-Reg'>entspricht einem physikalischen
Stromkreis und beschreibt somit genau<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>einen
digitalSTROM Meter. Ein </span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Circuit
</span><span style='font-family:NeuzeitGroT-Reg'>wird beschrieben durch die dSID
des zugehörigen Meters und<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>kann
mit einem Namen gekennzeichnet werden. Ein </span><span style='font-size:11.5pt;
font-family:NeuzeitGroT-Reg'>Circuit </span><span style='font-family:NeuzeitGroT-Reg'>kann
in mehreren Zonen vorhanden<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>sein
und damit in virtuelle Schaltkreise aufgeteilt werden.<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Die
Objekt Klasse </span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Zone
</span><span style='font-family:NeuzeitGroT-Reg'>beschreibt die realen Räume oder
räumlichen Abgrenzungen im Gebäude.<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Eine
</span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Zone </span><span
style='font-family:NeuzeitGroT-Reg'>kann sich über mehrere Schaltkreise erstrecken
und dementsprechend mehrere Devices<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>aus
unterschiedlichen Schaltkreisen beinhalten.<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Die
Objekt Klasse </span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Group
</span><span style='font-family:NeuzeitGroT-Reg'>kann von drei Typen abstammen:
den vordefinierten digitalSTROM<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Farbgruppen,
einer benutzerdefinierten Gruppe in einer Zone und einer benutzerdefinierten Gruppe<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>die
sich über die gesamte Installation erstreckt. Auch eine Benutzergruppe kann mit
einem Namen<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-family:NeuzeitGroT-Reg'>gekennzeichnet werden.</span><span
style='font-family:NeuzeitGroT-Bol;color:black'><o:p></o:p></span></p>
<p class=MsoNormal><span style='font-family:"Calibri","sans-serif"'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Die
Objekt Klasse </span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg'>Apartment
</span><span style='font-family:NeuzeitGroT-Reg'>beinhaltet alle Circuits und Zonen
der Installation, und die in ihnen<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>enthaltenen
Devices und Gruppen.<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Die
Befehle zur Steuerung sind für ein Device und eine Gruppe in gleicher Art vorhanden.
Für beide<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg'>Objekte
lassen sich die Ausgangswerte erhöhen, vermindern, das Maximum, Minimum oder eine<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-family:NeuzeitGroT-Reg'>definierte Szene einstellen.<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-family:NeuzeitGroT-Reg'>…<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Bol;
color:black'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Bol;
color:black'>JSON<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>JavaScript Object Notation (JSON) ist ein textbasiertes Datenaustauschformat,
es basiert auf einer<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>Untermenge der JavaScript Programmiersprache, Standard ECMA-262. Die
Verwendung ist<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>allerdings nicht nur auf JavaScript Umgebungen beschränkt, für alle
geläufigen<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>Programmiersprachen existieren Parser und Interfaces zu JSON.<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>Der Aufruf einer Methode des Wohnungs API erfolgt mittels HTTP und
der folgenden Notation:<o:p></o:p></span></p>
<p class=MsoNormal style='text-indent:35.4pt;text-autospace:none'><span
lang=EN-US style='font-family:NeuzeitGroT-Reg;color:black'>HTTP/Get </span><span
lang=EN-US style='font-family:NeuzeitGroT-Reg;color:blue'><a
href="http://a.b.c.d/api/basic">http://a.b.c.d/api/basic</a></span><span
lang=EN-US style='font-family:NeuzeitGroT-Reg;color:black'>?<o:p></o:p></span></p>
<p class=MsoNormal style='text-indent:35.4pt;text-autospace:none'><span
lang=EN-US style='font-family:NeuzeitGroT-Reg;color:black'>class=n<o:p></o:p></span></p>
<p class=MsoNormal style='text-indent:35.4pt;text-autospace:none'><span
lang=EN-US style='font-family:NeuzeitGroT-Reg;color:black'>& function=m<o:p></o:p></span></p>
<p class=MsoNormal style='text-indent:35.4pt;text-autospace:none'><span
lang=EN-US style='font-family:NeuzeitGroT-Reg;color:black'>& selector=a0b1c2d3<o:p></o:p></span></p>
<p class=MsoNormal style='text-indent:35.4pt;text-autospace:none'><span
style='font-family:NeuzeitGroT-Reg;color:black'>& subselector=a4b5c6d7<o:p></o:p></span></p>
<p class=MsoNormal style='text-indent:35.4pt;text-autospace:none'><span
style='font-family:NeuzeitGroT-Reg;color:black'>& parameter=anytext<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'><o:p> </o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>Die Werte n und m für </span><span style='font-size:11.5pt;
font-family:NeuzeitGroT-Reg;color:black'>class </span><span style='font-family:
NeuzeitGroT-Reg;color:black'>und </span><span style='font-size:11.5pt;
font-family:NeuzeitGroT-Reg;color:black'>function </span><span
style='font-family:NeuzeitGroT-Reg;color:black'>werden numerisch angegeben und sind
im Wohnungs API<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>für jede Methode definiert. </span><span style='font-size:11.5pt;
font-family:NeuzeitGroT-Reg;color:black'>Selector </span><span
style='font-family:NeuzeitGroT-Reg;color:black'>und </span><span
style='font-size:11.5pt;font-family:NeuzeitGroT-Reg;color:black'>subselector </span><span
style='font-family:NeuzeitGroT-Reg;color:black'>sind hexadizimal dargestellte Qualifizierer
des<o:p></o:p></span></p>
<p class=MsoNormal style='text-autospace:none'><span style='font-family:NeuzeitGroT-Reg;
color:black'>Methoden Aufrufs, in der Regel die textuelle Darstellung der dSID eines
Objektes. Optional ist ein<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-family:NeuzeitGroT-Reg;color:black'>weiterer
</span><span style='font-size:11.5pt;font-family:NeuzeitGroT-Reg;color:black'>parameter
</span><span style='font-family:NeuzeitGroT-Reg;color:black'>möglich, ebenfalls
in Textform.<o:p></o:p></span></p>
<div style='mso-element:para-border-div;border:none;border-bottom:solid windowtext 1.0pt;
padding:0cm 0cm 1.0pt 0cm'>
<p class=MsoNormal style='border:none;padding:0cm'><span style='font-size:11.0pt;
font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p>
</div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Best Practice<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><a href="http://url/api/basic?class=0&function=0">http://url/api/basic?class=0&function=0</a>
: Liefert die Struktur der digitalSTROM Installation als JSON-String. Es kann mit
einen Befehl sofort alle Circuits (dSM) mit angeschlossenen Devices bzw. alle
logischen Zones (Räume) mit Ihren Gruppen zurückgegeben werden.<o:p></o:p></p>
<p class=MsoNormal><a href="http://url/api/basic?class=0&function=1">http://url/api/basic?class=0&function=1</a>
: Liefert eine Struktur mit allen dSMs mit ihren aktuellen Energiemesswert
zurück.<o:p></o:p></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal>Wir empfehlen Dringend die Steuerung über Gruppen, genauer
Gruppen der Zonen.<o:p></o:p></p>
<p class=MsoNormal>Zwar geht auch die direkte Steuerung von Devices, es
entspricht aber nicht den digitalSTROM Konzept, da per Taster eben auch nur
Gruppenbefehle schicken wird.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Man benötigt hierbei die ZoneID, die über Apartment-Classe
abfragbar ist, z.B. mit dem Iterator getZoneByIndex. Die ZoneID ist relativ
willkürlich gewählt, muss daher abgefragt werden. Man kann diese Nummer aber
auch der gesamten Datenstruktur entnehmen.<o:p></o:p></p>
<p class=MsoNormal><a href="http://url/api/basic?class=1&function=9&parameter=0">http://url/api/basic?class=1&function=9&parameter=0</a>
(ruft die ID des ersten Raumes ab)<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Für den Aufruf einer Szene benötigt man noch eine
Gruppennummer, die ebenfalls über einen Iterator kommen kann, aber hier gilt
immer für die ersten 10 Gruppen Standardwerte, daher wird immer Gruppe 1 alle
gelben Klemmen und damit die Lichtgruppe ansprechen. Da kann man bei normen
Gruppen Konstanten nehmen.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Idealerweise wird für die Ansteuerung der selectScene
Befehle der Group Klasse verwendet. <o:p></o:p></p>
<p class=MsoNormal><a
href="http://url/api/basic?class=3&function=16&selector=GroupNr&subselector=ZoneNr&parameter=Szenennummer">http://url/api/basic?class=3&function=16&selector=GroupNr&subselector=ZoneNr&parameter=Szenennummer</a><o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Folgende Szenen sind die „richtigen“ für die normale
Steuerung:<o:p></o:p></p>
<p class=MsoNormal> 0: Ausszene<o:p></o:p></p>
<p class=MsoNormal> 5: Anszene<o:p></o:p></p>
<p class=MsoNormal>17: Szene 2<o:p></o:p></p>
<p class=MsoNormal>18: Szene 3<o:p></o:p></p>
<p class=MsoNormal>19: Szene 4<o:p></o:p></p>
<p class=MsoNormal>48: Standby: Ausszene mit Löschung der lokalen Priorisierung<o:p></o:p></p>
<p class=MsoNormal>49: DeepOff: Ausszene für alle Geräte<o:p></o:p></p>
<p class=MsoNormal>11: Wert verringern (Dimmen)<o:p></o:p></p>
<p class=MsoNormal>12: Wert verringern (Dimmen)<o:p></o:p></p>
<p class=MsoNormal>13: Minimalwert (sprich AUS)<o:p></o:p></p>
<p class=MsoNormal>14: Maximalwert (sprich AN)<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Die anderen Szenen dienen teilweise speziellen Zwecken, die
6 gelisteten sind die am meisten verwendeten und werden auch von Lichtschaltern
gesteuert.<o:p></o:p></p>
<p class=MsoNormal>Neben den Szenen kann im Augenblick zum Ausschalten auch ein
StartDimDec bzw. ein StopDim ausgeführt werden, ein Anschalten durch ein
StartDimInc, ich bitte aber darum, dies nach Möglichkeit zur vermeiden, da
diese Befehle nicht wirklich für die Lichtsteuerung geeignet sind. Insbesondere
sind dann Steuerbefehle aus einen Webfrontend nicht mehr synchron mit der
Bedienung am Taster. Wenn man konsequent auf dem Frontent die oben beschrieben
Szenen zum schalten verwendet, so bewahrt man die Synchronität.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Synchronität in Bezug zum Bedienkonzept: Einfaches Beispiel:
ein Druck auf den Taster schaltet das Licht an, ein weiterer Druck (etwas
später) schaltet das Licht wieder aus. Wenn vom Webfrontend ein selectScene mit
5 an einen ausgeschalteten Raum kommt, wird dieser angeschaltet, und der
nächste Wandtasterdruck schaltet den Raum wieder ab. Wenn aber nun ein
startDimInc ausgeführt werden würde, kann es sein, dass das Licht im Raum
selbst leuchtet, aber der Raum noch der Meinung ist, er sei abgeschaltet, ein
Druck auf den Taster würde nun anstatt das Licht auszuschalten die Szene 5 aufrufen.
<o:p></o:p></p>
<p class=MsoNormal>Hierbei gilt aber bei Deviceansteuerung dies nicht. Ein
Device kann in einen beliebigen Modus gefahren werden, ein Tasterdruck erzeugt
einen Gruppenbefehl, dieser übersteuert das Device, sofern es nicht wirklich
lokal bedient worden ist.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Devices und Circuit werden anders selektiert. Die selector
und subselector Werte sind hierbei die dSID als String. Diesen muss man dann
bei den apicalls auch wieder zurückreichen. Ansonsten funktioniert der Zugriff
ähnlich d.h. es können ebenfalls die gleichen Szenen aufgerufen wrden.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Ich empfehle, nicht eigene Gruppen zu bilden, denn dies ist
noch nicht komplett durchgetestet. Ich empfehle, keine verwaltenden
Funktionen wie AddRoom,registerDeviceInRoom usw. zu verwenden, die direkt
Einfluss auf die Struktur der Installation nehmen. Zwar funktionieren diese
Befehle, aber es kann dort durch Fehlbedienung schnell Chaos entstehen und
seltsame Effekte auftreten.<o:p></o:p></p>
<div style='mso-element:para-border-div;border:none;border-bottom:solid windowtext 1.0pt;
padding:0cm 0cm 1.0pt 0cm'>
<p class=MsoNormal style='border:none;padding:0cm'><o:p> </o:p></p>
</div>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<div>
<div style='border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0cm 0cm 0cm'>
<p class=MsoNormal><b><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>Von:</span></b><span
style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'> Xue Chen
[mailto:xuechen628@googlemail.com] <br>
<b>Gesendet:</b> Mittwoch, 25. August 2010 15:48<br>
<b>An:</b> Hofmann, Christoph<br>
<b>Betreff:</b> Re: [dss-developer] Question about dss Web<o:p></o:p></span></p>
</div>
</div>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Hi Hofmann,<o:p></o:p></p>
<div>
<p class=MsoNormal>Thanks for your Help!! I am a student in FH Hagenberg, in our
FH we have only "Aizo Demokoffer dSK20", I want use it
development a iPhone App(control the devices in iPhone through
dSS, e.g. turn on or turn off the light). so, now I can't use your
open source dSS software, can you give me some suggestions, where can
I get the dSS software for dSK20? How can I do for my project? <o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><o:p> </o:p></p>
</div>
<div>
<p class=MsoNormal>Thanks for your help!!!<o:p></o:p></p>
</div>
<div>
<p class=MsoNormal>Xue Chen<br>
<a href="mailto:xuechen628@googlemail.com">xuechen628@googlemail.com</a><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><o:p> </o:p></p>
</div>
<div>
<p class=MsoNormal><o:p> </o:p></p>
<div>
<div>
<p class=MsoNormal><span style='font-family:"MS Mincho"'>在</span> 25.08.2010<span
style='font-family:"MS Mincho"'>，</span>15:02<span style='font-family:"MS Mincho"'>，</span>
Hofmann, Christoph <span style='font-family:"MS Mincho"'>写道：</span><o:p></o:p></p>
</div>
<p class=MsoNormal style='margin-bottom:12.0pt'><o:p> </o:p></p>
<div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Hi Xue,</span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>our open source dSS software is a software which can run on
linux, windows (using cygwin) or ARM platforms and so on. This software is
written in c++ and can be compiled using our makefiles. The files from the
„core“ folder and the files from all other folders are needed to build this
software. As this dSS software also contains a webserver, the webroot folder
contains web-files for that.</span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Your dSK20 has a very old dSS module which uses a completely
different platform which CAN NOT RUN OUR OPEN SOURCE DSS SOFTWARE!!!</span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>As our new dSS module (dSS11) is not available for the public
right now you can use our open source software on any PC or MAC. You can use a
common RS485->USB module to connect our dS485 bus from the dSM modules to
your PC. Please refer to the dSK20 documentation and our documentation in
Redmine.</span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Best regards</span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Christoph</span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'> </span><o:p></o:p></p>
</div>
<div style='border:none;border-left:solid blue 1.5pt;padding:0cm 0cm 0cm 4.0pt;
border-width:initial;border-color:initial;z-index:auto'>
<div>
<div style='border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0cm 0cm 0cm;
border-width:initial;border-color:initial'>
<div>
<p class=MsoNormal><b><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>Von:</span></b><span
class=apple-converted-space><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'> </span></span><span
style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'><a
href="mailto:dss-developer-bounces@forum.digitalstrom.org">dss-developer-bounces@forum.digitalstrom.org</a><span
class=apple-converted-space> </span>[mailto:dss-developer-bounces@forum.digitalstrom.org]<span
class=apple-converted-space> </span><b>Im Auftrag von<span
class=apple-converted-space> </span></b>Xue Chen<br>
<b>Gesendet:</b><span class=apple-converted-space> </span>Mittwoch, 25.
August 2010 14:12<br>
<b>An:</b><span class=apple-converted-space> </span><a
href="mailto:dss-developer@forum.digitalstrom.org">dss-developer@forum.digitalstrom.org</a><br>
<b>Betreff:</b><span class=apple-converted-space> </span>[dss-developer]
Question about dss Web</span><o:p></o:p></p>
</div>
</div>
</div>
<div>
<p class=MsoNormal> <o:p></o:p></p>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#080000'>Dear digitalSTROM team,</span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#080000'>I still have a question about dss websrc.</span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#444444'> </span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#080000'>1. I used </span><span class=apple-style-span><span
style='font-size:13.5pt;font-family:"Microsoft YaHei","sans-serif";color:black'>Aizo
Demokoffer dSK20 and connect through the network cable between the dSS and
computer, when I browse to "<a href="http://localhost:8080/">http://localhost:8080/</a>browse/",
it has been running just display "loading..." </span></span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:black'>and in "</span><span class=apple-style-span><span
style='font-size:13.5pt;font-family:"Microsoft YaHei","sans-serif";color:black'><a
href="http://localhost:8080/browse/setup.html">http://localhost:8080/browse/setup.html</a>"
have nothing too.. Did I something wrong? (I used tomcat and copy the files
from "/dss-mainline/data/webroot" to
"/apache-tomcat/webapps/browse/", how should I do?</span></span><span
style='font-size:10.0pt;font-family:"Arial","sans-serif";color:#444444'>)</span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#444444'> </span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:black'>2. What is the role of these </span><span
class=apple-style-span><span style='font-size:13.5pt;font-family:"Microsoft YaHei","sans-serif";
color:black'>c++ code in the directory(e.g. in "core")?</span></span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#444444'> </span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#444444'> </span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#080000'>Thank you very much for your help!!</span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#080000'>Have a nice day!</span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#444444'> </span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span class=apple-style-span><span style='font-size:10.0pt;
font-family:"Arial","sans-serif";color:black'>P.S. </span></span><span
class=apple-style-span><span style='font-size:13.5pt;font-family:"Microsoft YaHei","sans-serif";
color:black'>Patrick, Thanks your Help and hope you have a nice holiday!! </span></span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif";
color:#444444'> </span><o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class=MsoNormal style='margin-bottom:12.0pt'><span class=apple-style-span><span
style='font-size:13.5pt;font-family:"Microsoft YaHei","sans-serif";color:black'>Xue
Chen</span></span><span style='font-size:13.5pt;font-family:"Microsoft YaHei","sans-serif";
color:black'><br>
<span class=apple-style-span><a href="mailto:xuechen628@googlemail.com">xuechen628@googlemail.com</a></span><br>
<br>
<br>
</span><o:p></o:p></p>
</div>
</div>
<div>
<p class=MsoNormal> <o:p></o:p></p>
</div>
</div>
<p class=MsoNormal><span style='font-size:13.5pt;font-family:"Microsoft YaHei","sans-serif"'>_______________________________________________<br>
dss-developer mailing list<br>
<a href="mailto:dss-developer@forum.digitalstrom.org">dss-developer@forum.digitalstrom.org</a><br>
<a href="http://forum.digitalstrom.org/cgi-bin/mailman/listinfo/dss-developer">http://forum.digitalstrom.org/cgi-bin/mailman/listinfo/dss-developer</a><o:p></o:p></span></p>
</div>
</div>
<div>
<p class=MsoNormal style='margin-bottom:12.0pt'><span style='font-size:13.5pt;
font-family:"Microsoft YaHei","sans-serif";color:black'><br>
<br>
</span><o:p></o:p></p>
</div>
<p class=MsoNormal><o:p> </o:p></p>
</div>
</div>
</body>
</html>