Changes between Version 5 and Version 6 of ZigbeeGateway


Ignore:
Timestamp:
Sep 19, 2010, 5:36:59 PM (14 years ago)
Author:
Sensei
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • ZigbeeGateway

    v5 v6  
    12121. Through a Zigbee USB dongle attached to the PC. In this case the PC needs to be in the rario coverage of the Zigbee island.
    13132. Through IP connection to an external concentrator. This concentrator is an element that simple translates the Zigbee binary message into IP and transports it using a TCP/IP socket.
    14 [[Image(ZB2SenseiGwConnection.JPG, 50%, center)]]
     14[[Image(zb2senseigw_mainsreen.jpg, 50%, center)]]
    1515 
    1616
    1717== Installation ==
    18 There is not an installation package available. To run this software just copy and paste the files contain in the [#PakageContent package] in a directory and run the exe file “Zb2SenseiGw.exe”. Prior to that, it is convenient to adjust the configuration file (see [#Configuration Configuration section]).
     18There is not an installation package available. To run this software just copy and paste the files contain in the [#PakageContent package] in a directory and run the exe file "Zb2SenseiGw.exe". Prior to that, it is convenient to adjust the configuration file (see [#Configuration Configuration section]).
    1919
    2020=== Requirements ===
    … …  
    2323* No special computer performance requirements are needed.
    2424* External Hardware:
    25        * Zigbee dongle. It has been tested the Zigbee dongle of “Integration” model “IA DAUB-DK1 2400”.
     25       * Zigbee dongle. It has been tested the Zigbee dongle of "Integration" model "IA DAUB-DK1 2400".
    2626              * Drivers of this dongle should be properly installed before running the package.
    2727       * External concentrator, that convert the Zigbee messages into IP for transmitting using TCP/IP protocol.
    … …  
    4040=== Compilation ===
    4141The sources are written in C# language. Microsoft Visual Studio 2010.
    42 Open “ZB2SenseiGW.sln” solution and compile the project.
    43 The executable files will be located on “.\bin\release” or “.\bin\debug” (depending on the configuration) directory.
     42Open "ZB2SenseiGW.sln" solution and compile the project.
     43The executable files will be located on ".\bin\release" or ".\bin\debug" (depending on the configuration) directory.
    4444
    4545== Specification ==
    … …  
    7575It is not needed special editor for changing these files. Whichever text editor used is enough. But special care should be followed for not modifying the overall xml structure, and the rest of the tags. Read this manual before proceed to edit the files.
    7676
    77 Do not worry if you are not familiar with **xml basis**. Look for the target name that follow “//key=//”, and you must **edit only** the text between double apostrophes after the “//value=//” text.
     77Do not worry if you are not familiar with **xml basis**. Look for the target name that follow "//key=//", and you must **edit only** the text between double apostrophes after the "//value=//" text.
    7878
    7979=== Zb2SenseiGw.exe.config file===
    … …  
    125125
    126126Figure shows the main screen of the application.
    127 [[Image(ZB2SenseiGw.JPG, 50%, center)]]
    128  On the upper side, appears the type of connection to the Zigbee island. The "**USB**" is through a dongle and the "**IP**" through an external concentrator. The "**IP/Ch**" select box contains the Zigbee channel for USB or the connection name (see [#Configuration <netConn> idNet in Configuration]) for IP. The button “**Connect**” and “**Disconnect**” allows to attach or detach to the Zigbee island.
    129 The connection process takes a while, firtsly it engages in the Zigbee island. Secondly it discovers the nodes and resources. The node list appears on the “**Tree of nodes**” tree box.
     127[[Image(zb2senseigw_connection.JPG, 50%, center)]]
     128 On the upper side, appears the type of connection to the Zigbee island. The "**USB**" is through a dongle and the "**IP**" through an external concentrator. The "**IP/Ch**" select box contains the Zigbee channel for USB or the connection name (see [#Configuration <netConn> idNet in Configuration]) for IP. The button "**Connect**" and "**Disconnect**" allows to attach or detach to the Zigbee island.
     129The connection process takes a while, firtsly it engages in the Zigbee island. Secondly it discovers the nodes and resources. The node list appears on the "**Tree of nodes**" tree box.
    130130Details of a node selected in the tree box are shown on the right side of the screen:
    131131* Short and MAC address, father node (for sleeping nodes).
    … …  
    135135* Relative position.
    136136
    137 For every sensor, actuator or counter (sensor) additional details are shown in the corresponding tags on the “**Node Description**”
     137For every sensor, actuator or counter (sensor) additional details are shown in the corresponding tags on the "**Node Description**"
    138138
    139139
    … …  
    170170{{{
    171171<SubscriptionNodeInfo>
    172         <SubscriptionInfo sensor=”0”>
     172        <SubscriptionInfo sensor="0">
    173173                <Subscription>
    174174                         … Subscription info
    … …  
    178178                <Subscription>
    179179        </SubscriptionInfo>
    180         <SubscriptionInfo actuator=”0”>
     180        <SubscriptionInfo actuator="0">
    181181                <Subscription>
    182182                         … Subscription info
    … …  
    189189== RAI interface ==
    190190This Gateway uses a REST interface for iterate with the Zigbee island. This interface is defined here (**PUT LINK** to the xml specification).
    191 Each resource has its one URL, which format is “//**BASE_URL/nodeMAC/X/number**//”
     191Each resource has its one URL, which format is "//**BASE_URL/nodeMAC/X/number**//"
    192192* nodeMAC is the node MAC address in hexadecimal capital letters (16 characters).
    193 * X is the letter “s” for a sensor or “a” for an actuator.
    194 * number is the number of sensor or actuator, starting with “0”.
     193* X is the letter "s" for a sensor or "a" for an actuator.
     194* number is the number of sensor or actuator, starting with "0".
    195195
    196196Over this URL the following operations can be done:
    … …  
    200200=== Subscriptions ===
    201201A POST http method over the resource URL is used for adding a new subscription. In this case it should be add at the end of the resource URL the subscription identity: 
    202 “//**BASE_URL/nodeMAC/X/number/SubscriptionID**//”
     202"//**BASE_URL/nodeMAC/X/number/SubscriptionID**//"
    203203* SubscriptionID is whatever text allowed in the URL names.
    204204
    … …  
    208208A POST http method over this subscription URL returns an error.
    209209
    210 GET over “//**BASE_URL/nodeMAC/X/number?Subscription**//” for getting the list of subscriptions of a resource.
    211 GET over “//**BASE_URL/nodeMAC **//” returns an html page with node information, sensors and actuators, and links for the subscriptions. Ideally for a browser
    212 
    213 
     210GET over "//**BASE_URL/nodeMAC/X/number?Subscription**//" for getting the list of subscriptions of a resource.
     211GET over "//**BASE_URL/nodeMAC **//" returns an html page with node information, sensors and actuators, and links for the subscriptions. Ideally for a browser
     212
     213
     214
     215
     216
     217