Difference between revisions of "Component: Zigbee (EB051, XBEE) (XBEE) (Wireless)"

From Flowcode Help
Jump to navigationJump to search
(XML import - Pre 8.0 release)
 
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
+
{| style="width:50%"
 
 
{| width="50%"
 
 
|-
 
|-
| width="20%" style="color: gray;" | Author
+
| width="20%" style="color:gray;" | Author
 
| Matrix Ltd.
 
| Matrix Ltd.
 
|-
 
|-
| width="20%" style="color: gray;" | Version
+
| width="20%" style="color:gray;" | Version
| 1.5 (Release)
+
| 1.5
 
|-
 
|-
| width="20%" style="color: gray;" | Category
+
| width="20%" style="color:gray;" | Category
 
| Wireless
 
| Wireless
 
|}
 
|}
  
  
 +
==Zigbee (EB051, XBEE) component==
 +
Zigbee component designed to work with the XBEE range of modules from Digi. Provides a very simple interface to allow Zigbee mesh networks and communications. Also available in the form of the EB051 Zigbee E-block. Can also be used with Zigbee MIAC Addon module
  
==[[File:Component Icon 53548cbe_cd57_471c_8ac1_3205d0e9da38.png|Image]] Zigbee (EB051, XBEE) (XBEE) component==
+
==Component Source Code==
Zigbee component designed to work with the XBEE range of modules from Digi.
 
Provides a very simple interface to allow Zigbee mesh networks and communications.
 
Also available in the form of the EB051 Zigbee E-block. Can also be used with Zigbee MIAC Addon module
 
  
==Examples==
+
Please click here to download the component source project: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_Zigbee.fcfx FC_Comp_Source_Zigbee.fcfx]
''<span style="color:red;">No additional examples</span>''
 
  
 +
Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_Zigbee.fcfx FC_Comp_Source_Zigbee.fcfx]
  
==Downloadable macro reference==
+
==Detailed description==
  
===<span style="font-weight: normal;"><u><tt>NodeConfigureSleep</tt></u></span>===
 
Sets the Zigbee device sleep mode (only applicable for end node type devices) ,
 
  
'''Parameters'''
 
  
:[[Variable Types|BYTE]] ''Mode''
 
::1=Hibernate, 2=Doze, 4=Cyclic Sleep, 5=Cyclic Doze
 
  
:[[Variable Types|UINT]] ''Timeout''
 
::Time to sleep in milli seconds (ms)
 
  
  
'''Return value'''
 
  
:''This call does not return a value''
 
  
  
===<span style="font-weight: normal;"><u><tt>ReadNameFromBuffer</tt></u></span>===
 
Returns a byte from the 8-Byte name
 
  
'''Parameters'''
 
  
:[[Variable Types|BYTE]] ''Device''
 
::The Device name to collect. Range: 0-7
 
  
:[[Variable Types|BYTE]] ''Idx''
 
::The index position of the name. Range: 0-7
 
  
  
'''Return value'''
 
  
:[[Variable Types|BYTE]]
 
  
  
===<span style="font-weight: normal;"><u><tt>NodeWake</tt></u></span>===
 
Wakes up the local Zigbee module from sleep mode.
 
  
'''Parameters'''
 
  
:''This macro has no parameters''
 
  
  
'''Return value'''
 
  
:''This call does not return a value''
 
  
  
===<span style="font-weight: normal;"><u><tt>ReadATResponse</tt></u></span>===
 
Reads a single byte from the received AT command response.
 
  
'''Parameters'''
+
''No detailed description exists yet for this component''
  
:[[Variable Types|BYTE]] ''idx''
+
==Examples==
::Specified the byte index in the buffer. Range 0-15
 
  
  
'''Return value'''
 
  
:[[Variable Types|BYTE]]
 
  
  
===<span style="font-weight: normal;"><u><tt>ScanBuffer</tt></u></span>===
 
Returns a binary list of matched identifier names
 
  
'''Parameters'''
 
  
:[[Variable Types|STRING]] ''Compare_Str''
 
  
:[[Variable Types|BYTE]] ''Length''
 
  
  
'''Return value'''
 
  
:[[Variable Types|BYTE]]
 
  
  
===<span style="font-weight: normal;"><u><tt>SendChar</tt></u></span>===
 
Transmits a byte value to the Zigbee module.
 
  
'''Parameters'''
 
  
:[[Variable Types|BYTE]] ''Byte''
 
::Data byte to transmit. Range 0-255
 
  
  
'''Return value'''
 
  
:''This call does not return a value''
 
  
  
===<span style="font-weight: normal;"><u><tt>InitNetwork</tt></u></span>===
 
Initialises the Zigbee module and attempts to setup or join the network
 
  
'''Parameters'''
 
  
:''This macro has no parameters''
 
  
  
'''Return value'''
 
  
:''This call does not return a value''
 
  
 +
''<span style="color:red;">No additional examples</span>''
  
===<span style="font-weight: normal;"><u><tt>ConnectToCoordinator</tt></u></span>===
 
Attempts to connect the data channel to the network coordinator node.
 
  
'''Parameters'''
 
  
:''This macro has no parameters''
 
  
  
'''Return value'''
 
  
:[[Variable Types|BYTE]]
 
  
  
===<span style="font-weight: normal;"><u><tt>ConnectToName</tt></u></span>===
 
Attempts to connect the data channel to a named device on the network.
 
  
'''Parameters'''
 
  
:[[Variable Types|<- STRING]] ''Name''
 
::''This parameter may be returned back to the caller''
 
  
  
'''Return value'''
+
==Macro reference==
  
:[[Variable Types|BYTE]]
+
===ConnectFromLibrary===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ConnectFromLibrary'''
 +
|-
 +
| colspan="2" | Attempts to connect the data channel to a known device on the network.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Mode
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Device
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
  
===<span style="font-weight: normal;"><u><tt>StoreParams</tt></u></span>===
+
===ConnectToAddress===
Stores the current register set into the Zigbee module's non volatile memory
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ConnectToAddress'''
 +
|-
 +
| colspan="2" | Attempts to connect the data channel to a specific device address on the network.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
 +
| width="90%" | Address
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
'''Parameters'''
 
  
:''This macro has no parameters''
+
===ConnectToAll===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ConnectToAll'''
 +
|-
 +
| colspan="2" | Attempts to connect the data channel to all devices on the network.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
  
'''Return value'''
+
===ConnectToCoordinator===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ConnectToCoordinator'''
 +
|-
 +
| colspan="2" | Attempts to connect the data channel to the network coordinator node.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
:''This call does not return a value''
 
  
 +
===ConnectToName===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ConnectToName'''
 +
|-
 +
| colspan="2" | Attempts to connect the data channel to a named device on the network.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
 +
| width="90%" | Name
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
===<span style="font-weight: normal;"><u><tt>EnterCommandMode</tt></u></span>===
 
Moves from data mode into command mode by sending the special characters
 
  
'''Parameters'''
+
===EnterCommandMode===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''EnterCommandMode'''
 +
|-
 +
| colspan="2" | Moves from data mode into command mode by sending the special characters&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
:''This macro has no parameters''
 
  
 +
===ExitCommandMode===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ExitCommandMode'''
 +
|-
 +
| colspan="2" | Returns from command mode to allow data to be sent and received&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
'''Return value'''
 
  
:''This call does not return a value''
+
===GetATResponse===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetATResponse'''
 +
|-
 +
| colspan="2" | Waits for a response from the Zigbee module. If the Logging parameter is set then the response is stored in memory allowing the software to read the reply.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Logging
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
  
===<span style="font-weight: normal;"><u><tt>RestartNetwork</tt></u></span>===
+
===GetSignalLevel===
Attempts to restart the network
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetSignalLevel'''
 +
|-
 +
| colspan="2" | Returns the signal strength of the last signal received&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
'''Parameters'''
 
  
:''This macro has no parameters''
+
===InitNetwork===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''InitNetwork'''
 +
|-
 +
| colspan="2" | Initialises the Zigbee module and attempts to setup or join the network&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
  
'''Return value'''
+
===MIAC_Module_GetData===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''MIAC_Module_GetData'''
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Index
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
:''This call does not return a value''
 
  
 +
===MIAC_Module_Message===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''MIAC_Module_Message'''
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 +
| width="90%" | CAN_ID
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 +
| width="90%" | CMD_ID
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
===<span style="font-weight: normal;"><u><tt>ConnectToAll</tt></u></span>===
 
Attempts to connect the data channel to all devices on the network.
 
  
'''Parameters'''
+
===MIAC_Module_PushData===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''MIAC_Module_PushData'''
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
:''This macro has no parameters''
 
  
 +
===NodeConfigureSleep===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''NodeConfigureSleep'''
 +
|-
 +
| colspan="2" | Sets the Zigbee device sleep mode (only applicable for end node type devices) , &nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Mode
 +
|-
 +
| colspan="2" | 1=Hibernate, 2=Doze, 4=Cyclic Sleep, 5=Cyclic Doze&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 +
| width="90%" | Timeout
 +
|-
 +
| colspan="2" | Time to sleep in milli seconds (ms)&nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
'''Return value'''
 
  
:[[Variable Types|BYTE]]
+
===NodeWake===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''NodeWake'''
 +
|-
 +
| colspan="2" | Wakes up the local Zigbee module from sleep mode.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
  
===<span style="font-weight: normal;"><u><tt>ConnectFromLibrary</tt></u></span>===
+
===ReadATResponse===
Attempts to connect the data channel to a known device on the network.
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadATResponse'''
 +
|-
 +
| colspan="2" | Reads a single byte from the received AT command response.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | idx
 +
|-
 +
| colspan="2" | Specified the byte index in the buffer. Range 0-15&nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
'''Parameters'''
 
  
:[[Variable Types|BYTE]] ''Mode''
+
===ReadAddressFromBuffer===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadAddressFromBuffer'''
 +
|-
 +
| colspan="2" | Reads a byte from a 16-bit Zigbee device address&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Device
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Idx
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
:[[Variable Types|BYTE]] ''Device''
 
  
 +
===ReadNameFromBuffer===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadNameFromBuffer'''
 +
|-
 +
| colspan="2" | Returns a byte from the 8-Byte name&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Device
 +
|-
 +
| colspan="2" | The Device name to collect. Range: 0-7&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Idx
 +
|-
 +
| colspan="2" | The index position of the name. Range: 0-7&nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
'''Return value'''
 
  
:[[Variable Types|BYTE]]
+
===ReceiveChar===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReceiveChar'''
 +
|-
 +
| colspan="2" | Attempt to receive a byte from the Zigbee module.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | nTimeout
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
  
===<span style="font-weight: normal;"><u><tt>ConnectToAddress</tt></u></span>===
+
===RestartNetwork===
Attempts to connect the data channel to a specific device address on the network.
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RestartNetwork'''
 +
|-
 +
| colspan="2" | Attempts to restart the network&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
'''Parameters'''
 
  
:[[Variable Types|<- STRING]] ''Address''
+
===ScanBuffer===
::''This parameter may be returned back to the caller''
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ScanBuffer'''
 +
|-
 +
| colspan="2" | Returns a binary list of matched identifier names&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
 +
| width="90%" | Compare_Str
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Length
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
  
'''Return value'''
+
===ScanNetwork===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ScanNetwork'''
 +
|-
 +
| colspan="2" | Scans the local network for devices and stores into a local device array. Mode = 0 store device names, mode = 1 store device addresses. Returns the number of devices found.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Mode
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
:[[Variable Types|BYTE]]
 
  
 +
===SendATCommand===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendATCommand'''
 +
|-
 +
| colspan="2" | Transmits a string of values to the Zigbee module.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
 +
| width="90%" | Command
 +
|-
 +
| colspan="2" | Transmits a command to the Zigbee module followed by a carriage return&nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
===<span style="font-weight: normal;"><u><tt>GetSignalLevel</tt></u></span>===
 
Returns the signal strength of the last signal received
 
  
'''Parameters'''
+
===SendChar===
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendChar'''
 +
|-
 +
| colspan="2" | Transmits a byte value to the Zigbee module.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Byte
 +
|-
 +
| colspan="2" | Data byte to transmit. Range 0-255&nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
:''This macro has no parameters''
 
 
 
'''Return value'''
 
 
:[[Variable Types|BYTE]]
 
  
 
+
===StoreParams===
===<span style="font-weight: normal;"><u><tt>ExitCommandMode</tt></u></span>===
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
Returns from command mode to allow data to be sent and received
+
|-
 
+
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
'''Parameters'''
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''StoreParams'''
 
+
|-
:''This macro has no parameters''
+
| colspan="2" | Stores the current register set into the Zigbee module's non volatile memory&nbsp;
 
+
|-
 
+
|-
'''Return value'''
+
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 
+
| width="90%" style="border-top: 2px solid #000;" | ''Return''
:''This call does not return a value''
+
|}
 
 
 
 
===<span style="font-weight: normal;"><u><tt>ReadAddressFromBuffer</tt></u></span>===
 
Reads a byte from a 16-bit Zigbee device address
 
 
 
'''Parameters'''
 
 
 
:[[Variable Types|BYTE]] ''Device''
 
 
 
:[[Variable Types|BYTE]] ''Idx''
 
 
 
 
 
'''Return value'''
 
 
 
:[[Variable Types|BYTE]]
 
 
 
 
 
===<span style="font-weight: normal;"><u><tt>SendATCommand</tt></u></span>===
 
Transmits a string of values to the Zigbee module.
 
 
 
'''Parameters'''
 
 
 
:[[Variable Types|<- STRING]] ''Command''
 
::Transmits a command to the Zigbee module followed by a carriage return
 
::''This parameter may be returned back to the caller''
 
 
 
 
 
'''Return value'''
 
 
 
:''This call does not return a value''
 
 
 
 
 
===<span style="font-weight: normal;"><u><tt>ScanNetwork</tt></u></span>===
 
Scans the local network for devices and stores into a local device array. Mode = 0 store device names, mode = 1 store device addresses. Returns the number of devices found.
 
 
 
'''Parameters'''
 
 
 
:[[Variable Types|BYTE]] ''Mode''
 
 
 
 
 
'''Return value'''
 
 
 
:[[Variable Types|BYTE]]
 
 
 
 
 
===<span style="font-weight: normal;"><u><tt>GetATResponse</tt></u></span>===
 
Waits for a response from the Zigbee module. If the Logging parameter is set then the response is stored in memory allowing the software to read the reply.
 
 
 
'''Parameters'''
 
 
 
:[[Variable Types|BYTE]] ''Logging''
 
 
 
 
 
'''Return value'''
 
 
 
:[[Variable Types|BYTE]]
 
 
 
 
 
===<span style="font-weight: normal;"><u><tt>ReceiveChar</tt></u></span>===
 
Attempt to receive a byte from the Zigbee module.
 
 
 
'''Parameters'''
 
 
 
:[[Variable Types|BYTE]] ''nTimeout''
 
 
 
 
 
'''Return value'''
 
 
 
:[[Variable Types|BYTE]]
 
 
 
 
 
 
 
==Simulation macro reference==
 
 
 
''This component does not contain any simulation macros''
 
  
  
 
==Property reference==
 
==Property reference==
<span style="font-weight: normal;"><u>Device Name</u></span>
 
  
This property is of type ''Line of text'' and can be referenced with the variable name ''dev_name''.
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 
+
|-
String of characters used to allow the Zigbee node to use the name addressing mode of operation.
+
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
 
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
Can be left blank if name addressing is not being used.
+
|-
 
+
|-
<span style="font-weight: normal;"><u>Zigbee Mode</u></span>
+
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
 
+
| width="90%" | Device Name
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''zig_mode''.
+
|-
 
+
| colspan="2" | String of characters used to allow the Zigbee node to use the name addressing mode of operation. Can be left blank if name addressing is not being used.&nbsp;
Specifies the functionality of the Zigbee node.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
Coordinator - Must be used with a Coordinator Zigbee E-Block EB051C, Responsible for starting the network and assigning addresses.
+
| width="90%" | Zigbee Mode
 
+
|-
Router - Must be used with a Router / End Node E-Block EB051R, Responsible for forwarding / repeating packets on the network.
+
| colspan="2" | Specifies the functionality of the Zigbee node. Coordinator - Must be used with a Coordinator Zigbee E-Block EB051C, Responsible for starting the network and assigning addresses. Router - Must be used with a Router / End Node E-Block EB051R, Responsible for forwarding / repeating packets on the network. End Device - Must be used with a Router / End Node E-Block EB051R, Capable of low power operation.&nbsp;
 
+
|-
End Device - Must be used with a Router / End Node E-Block EB051R, Capable of low power operation.
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | Auto ID
<span style="font-weight: normal;"><u>Auto ID</u></span>
+
|-
 
+
| colspan="2" | Automatically generate a PAN ID &nbsp;
This property is of type ''True or false'' and can be referenced with the variable name ''auto_id''.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
Automatically generate a PAN ID
+
| width="90%" | PAN ID
 
+
|-
<span style="font-weight: normal;"><u>PAN ID</u></span>
+
| colspan="2" | Assigns a Personal Area Network Identifier code to the Zigbee node. Random / Search - Scans the local area for Zigbee PAN networks and joins the existing network, otherwise a random value is chosen. Preset - Assigns a preset PAN ID to the Zigbee node, Must be between 0x0 and 0x3FFF.&nbsp;
 
+
|-
This property is of type ''Line of text'' and can be referenced with the variable name ''pan_id''.
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
+
| width="90%" | Node Join Time
Assigns a Personal Area Network Identifier code to the Zigbee node.
+
|-
 
+
| colspan="2" | Length of time in seconds where nodes are allowed to join the network. Infinte - Nodes are always allowed to join the network. Preset - Nodes are only allowed to join the network for a specific amount of time. Note: Join time not available for End Device nodes. &nbsp;
Random / Search - Scans the local area for Zigbee PAN networks and joins the existing network, otherwise a random value is chosen.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
Preset - Assigns a preset PAN ID to the Zigbee node, Must be between 0x0 and 0x3FFF.
+
| width="90%" | Max Hops
 
+
|-
<span style="font-weight: normal;"><u>Node Join Time</u></span>
+
| colspan="2" | Specifies the maximum number of retransmits for a Broadcast transmission.&nbsp;
 
+
|-
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''join_time''.
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
+
| width="90%" | Sleep Buffer Time
Length of time in seconds where nodes are allowed to join the network.
+
|-
 
+
| colspan="2" | Length of time to buffer packets for sleeping or powered down nodes. This value must be consistent throughout the Zigbee network. Default - Assigns the maximum buffer time of 28 seconds. Preset - Allows for a custom sleep time of 0.32 - 28 seconds.&nbsp;
Infinte - Nodes are always allowed to join the network.
+
|-
 
+
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
Preset - Nodes are only allowed to join the network for a specific amount of time.
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
 
+
|-
Note: Join time not available for End Device nodes.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
<span style="font-weight: normal;"><u>Max Hops</u></span>
+
| width="90%" | Channel
 
+
|-
This property is of type ''Signed integer'' and can be referenced with the variable name ''max_hops''.
+
| colspan="2" | UART Channel selector Software channels are bit banged using generic I/O pins but are not as reliable as hardware channels. Hardware channels use the selected peripheral on-board the target microcontroller.&nbsp;
 
+
|-
Specifies the maximum number of retransmits for a Broadcast transmission.
+
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 
+
| width="90%" | TX
<span style="font-weight: normal;"><u>Sleep Buffer Time</u></span>
+
|-
 
+
| colspan="2" | Pin to be used for Transmit data&nbsp;
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''sleep_buffer''.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
Length of time to buffer packets for sleeping or powered down nodes. This value must be consistent throughout the Zigbee network.
+
| width="90%" | RX
 
+
|-
Default - Assigns the maximum buffer time of 28 seconds.
+
| colspan="2" | Pin to be used for Receive data&nbsp;
 
+
|-
Preset - Allows for a custom sleep time of 0.32 - 28 seconds.
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
+
| width="90%" | Baud Options
<span style="font-weight: normal;"><u>Channel</u></span>
+
|-
 
+
| colspan="2" | Baud rate option selector&nbsp;
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''cal_uart::CHANNEL''.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
UART Channel selector
+
| width="90%" | Baud Rate
 
+
|-
Software channels are bit banged using generic I/O pins but are not as reliable as hardware channels.
+
| colspan="2" | &nbsp;
 
+
|-
Hardware channels use the selected peripheral on-board the target microcontroller.
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
+
| width="90%" | Use Flow Control
<span style="font-weight: normal;"><u>TX</u></span>
+
|-
 
+
| colspan="2" | Flow Control (Handshake) enable or disable.    On: Two I/O pins are used to control the flow of data in and out of the device.    Off: Flow control is disabled.&nbsp;
This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_uart::TX''.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
Pin to be used for Transmit data
+
| width="90%" | RTS
 
+
|-
<span style="font-weight: normal;"><u>RX</u></span>
+
| colspan="2" | Pin to be used for Request To Send handshake function Output from target micro to inform remote device we are ready to receive data. Low = Ready to receive data High = Not ready to receive data&nbsp;
 
+
|-
This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_uart::RX''.
+
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 
+
| width="90%" | CTS
Pin to be used for Receive data
+
|-
 
+
| colspan="2" | Pin to be used for Clear To Send handshake function. Input to target micro to inform when the remote device is ready to transmit data. Low = Ready to transmit data High = Not ready to transmit data&nbsp;
<span style="font-weight: normal;"><u>Baud Options</u></span>
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''cal_uart::BAUD_LIST''.
+
| width="90%" | Sleep Pin
 
+
|-
Baud rate option selector
+
| colspan="2" | Zigbee Sleep Control Pin&nbsp;
 
+
|-
<span style="font-weight: normal;"><u>Baud Rate</u></span>
+
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Scan Channels
This property is of type ''Signed integer'' and can be referenced with the variable name ''cal_uart::BAUD''.
+
|-
 
+
|-
''<span style="color:red;">No additional information</span>''
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x0B
 
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
<span style="font-weight: normal;"><u>Use Flow Control</u></span>
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''cal_uart::FLOWEN''.
+
| width="90%" | 0x0C
 
+
|-
Flow Control (Handshake) enable or disable.
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
    On: Two I/O pins are used to control the flow of data in and out of the device.
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x0D
    Off: Flow control is disabled.
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
<span style="font-weight: normal;"><u>RTS</u></span>
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_uart::RTS''.
+
| width="90%" | 0x0E
 
+
|-
Pin to be used for Request To Send handshake function
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
Output from target micro to inform remote device we are ready to receive data.
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x0F
Low = Ready to receive data
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
High = Not ready to receive data
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
<span style="font-weight: normal;"><u>CTS</u></span>
+
| width="90%" | 0x10
 
+
|-
This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_uart::CTS''.
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
Pin to be used for Clear To Send handshake function.
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x11
Input to target micro to inform when the remote device is ready to transmit data.
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
Low = Ready to transmit data
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
High = Not ready to transmit data
+
| width="90%" | 0x12
 
+
|-
<span style="font-weight: normal;"><u>Sleep Pin</u></span>
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
This property is of type ''Single digital pin'' and can be referenced with the variable name ''pin_sleep''.
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x13
Zigbee Sleep Control Pin
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
<span style="font-weight: normal;"><u>0x0B</u></span>
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
This property is of type ''True or false'' and can be referenced with the variable name ''chan_0''.
+
| width="90%" | 0x14
 
+
|-
Determines if channel will be scanned
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
<span style="font-weight: normal;"><u>0x0C</u></span>
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x15
This property is of type ''True or false'' and can be referenced with the variable name ''chan_1''.
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
Determines if channel will be scanned
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
<span style="font-weight: normal;"><u>0x0D</u></span>
+
| width="90%" | 0x16
 
+
|-
This property is of type ''True or false'' and can be referenced with the variable name ''chan_2''.
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
Determines if channel will be scanned
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x17
<span style="font-weight: normal;"><u>0x0E</u></span>
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
This property is of type ''True or false'' and can be referenced with the variable name ''chan_3''.
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
Determines if channel will be scanned
+
| width="90%" | 0x18
 
+
|-
<span style="font-weight: normal;"><u>0x0F</u></span>
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
This property is of type ''True or false'' and can be referenced with the variable name ''chan_4''.
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | 0x19
Determines if channel will be scanned
+
|-
 
+
| colspan="2" | Determines if channel will be scanned&nbsp;
<span style="font-weight: normal;"><u>0x10</u></span>
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
This property is of type ''True or false'' and can be referenced with the variable name ''chan_5''.
+
| width="90%" | 0x1A
 
+
|-
Determines if channel will be scanned
+
| colspan="2" | Determines if channel will be scanned&nbsp;
 
+
|-
<span style="font-weight: normal;"><u>0x11</u></span>
+
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
 
+
| width="90%" | Scan Duration
This property is of type ''True or false'' and can be referenced with the variable name ''chan_6''.
+
|-
 
+
| colspan="2" | Configures the length of time to scan each channel for network activity. The overall time for the entire channel scan is shown as channel scan time.&nbsp;
Determines if channel will be scanned
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
<span style="font-weight: normal;"><u>0x12</u></span>
+
| width="90%" | Total Scan Time (ms)
 
+
|-
This property is of type ''True or false'' and can be referenced with the variable name ''chan_7''.
+
| colspan="2" | The total amount of time that it will take to perform a complete RF channel scan based on the selected scan channels and duration.&nbsp;
 
+
|-
Determines if channel will be scanned
+
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
<span style="font-weight: normal;"><u>0x13</u></span>
+
|-
 
+
|-
This property is of type ''True or false'' and can be referenced with the variable name ''chan_8''.
+
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
 
+
| width="90%" | Label
Determines if channel will be scanned
+
|-
 
+
| colspan="2" | &nbsp;
<span style="font-weight: normal;"><u>0x14</u></span>
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
This property is of type ''True or false'' and can be referenced with the variable name ''chan_9''.
+
| width="90%" | Scope Traces
 
+
|-
Determines if channel will be scanned
+
| colspan="2" | Selects if the scope traces are automatically added to the data recorder window or not.    Simulation - draws an approximation of the UART data onto the scope trace.     ICT - sets up the scope trace for incoming data and adds UART packet decoding at the correct BAUD.&nbsp;
 
+
|-
<span style="font-weight: normal;"><u>0x15</u></span>
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
+
| width="90%" | Console Data
This property is of type ''True or false'' and can be referenced with the variable name ''chan_10''.
+
|-
 
+
| colspan="2" | Selects if the console data is automatically generated or not&nbsp;
Determines if channel will be scanned
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-21-icon.png]]
<span style="font-weight: normal;"><u>0x16</u></span>
+
| width="90%" | Console Columns
 
+
|-
This property is of type ''True or false'' and can be referenced with the variable name ''chan_11''.
+
| colspan="2" | Number of characters that can be displayed on a single line of the console.&nbsp;
 
+
|-
Determines if channel will be scanned
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
+
| width="90%" | Data Source
<span style="font-weight: normal;"><u>0x17</u></span>
+
|-
 
+
| colspan="2" | Simulation data source used to allow the component to connect to various remote devices    Nothing - Simulation data is ignored    COM port - Routes the communication data to and from a physical or virtual COM port      API - Routes the communication data via a data API component on the Panel.&nbsp;
This property is of type ''True or false'' and can be referenced with the variable name ''chan_12''.
+
|}
 
 
Determines if channel will be scanned
 
 
 
<span style="font-weight: normal;"><u>0x18</u></span>
 
 
 
This property is of type ''True or false'' and can be referenced with the variable name ''chan_13''.
 
 
 
Determines if channel will be scanned
 
 
 
<span style="font-weight: normal;"><u>0x19</u></span>
 
 
 
This property is of type ''True or false'' and can be referenced with the variable name ''chan_14''.
 
 
 
Determines if channel will be scanned
 
 
 
<span style="font-weight: normal;"><u>0x1A</u></span>
 
 
 
This property is of type ''True or false'' and can be referenced with the variable name ''chan_15''.
 
 
 
Determines if channel will be scanned
 
 
 
<span style="font-weight: normal;"><u>Scan Duration</u></span>
 
 
 
This property is of type ''Signed integer'' and can be referenced with the variable name ''scan_duration''.
 
 
 
Configures the length of time to scan each channel for network activity. The overall time for the entire channel scan is shown as channel scan time.
 
 
 
<span style="font-weight: normal;"><u>Total Scan Time (ms)</u></span>
 
 
 
This property is of type ''Signed integer'' and can be referenced with the variable name ''scan_total''.
 
 
 
The total amount of time that it will take to perform a complete RF channel scan based on the selected scan channels and duration.
 
 
 
<span style="font-weight: normal;"><u>Label</u></span>
 
 
 
This property is of type ''Line of text'' and can be referenced with the variable name ''label''.
 
 
 
''<span style="color:red;">No additional information</span>''
 
 
 
 
 
 
 
<span style="font-weight: normal;"><u>Scope Traces</u></span>
 
 
 
This property is of type ''True or false'' and can be referenced with the variable name ''cal_uart::ScopeTraces''.
 
 
 
Selects if the scope traces are automatically added to the data recorder window or not.
 
 
 
    Simulation - draws an approximation of the UART data onto the scope trace.
 
 
 
    ICT - sets up the scope trace for incoming data and adds UART packet decoding at the correct BAUD.
 
 
 
<span style="font-weight: normal;"><u>Console Data</u></span>
 
 
 
This property is of type ''True or false'' and can be referenced with the variable name ''cal_uart::ConsoleData''.
 
 
 
Selects if the console data is automatically generated or not
 
 
 
<span style="font-weight: normal;"><u>Console Columns</u></span>
 
 
 
This property is of type ''Unsigned integer'' and can be referenced with the variable name ''cal_uart::ConsoleColumns''.
 
 
 
Number of characters that can be displayed on a single line of the console.
 
 
 
<span style="font-weight: normal;"><u>Data Source</u></span>
 
 
 
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''cal_uart::DataSource''.
 
 
 
Simulation data source used to allow the component to connect to various remote devices
 
 
 
    Nothing - Simulation data is ignored
 
 
 
    COM port - Routes the communication data to and from a physical or virtual COM port
 
 
 
    Injector - Routes the communication data via a data injector component on the Panel.
 

Latest revision as of 13:13, 7 February 2023

Author Matrix Ltd.
Version 1.5
Category Wireless


Zigbee (EB051, XBEE) component

Zigbee component designed to work with the XBEE range of modules from Digi. Provides a very simple interface to allow Zigbee mesh networks and communications. Also available in the form of the EB051 Zigbee E-block. Can also be used with Zigbee MIAC Addon module

Component Source Code

Please click here to download the component source project: FC_Comp_Source_Zigbee.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_Zigbee.fcfx

Detailed description

No detailed description exists yet for this component

Examples

No additional examples







Macro reference

ConnectFromLibrary

Fc9-comp-macro.png ConnectFromLibrary
Attempts to connect the data channel to a known device on the network. 
Fc9-u8-icon.png - BYTE Mode
 
Fc9-u8-icon.png - BYTE Device
 
Fc9-u8-icon.png - BYTE Return


ConnectToAddress

Fc9-comp-macro.png ConnectToAddress
Attempts to connect the data channel to a specific device address on the network. 
Fc9-string-icon.png - STRING Address
 
Fc9-u8-icon.png - BYTE Return


ConnectToAll

Fc9-comp-macro.png ConnectToAll
Attempts to connect the data channel to all devices on the network. 
Fc9-u8-icon.png - BYTE Return


ConnectToCoordinator

Fc9-comp-macro.png ConnectToCoordinator
Attempts to connect the data channel to the network coordinator node. 
Fc9-u8-icon.png - BYTE Return


ConnectToName

Fc9-comp-macro.png ConnectToName
Attempts to connect the data channel to a named device on the network. 
Fc9-string-icon.png - STRING Name
 
Fc9-u8-icon.png - BYTE Return


EnterCommandMode

Fc9-comp-macro.png EnterCommandMode
Moves from data mode into command mode by sending the special characters 
Fc9-void-icon.png - VOID Return


ExitCommandMode

Fc9-comp-macro.png ExitCommandMode
Returns from command mode to allow data to be sent and received 
Fc9-void-icon.png - VOID Return


GetATResponse

Fc9-comp-macro.png GetATResponse
Waits for a response from the Zigbee module. If the Logging parameter is set then the response is stored in memory allowing the software to read the reply. 
Fc9-u8-icon.png - BYTE Logging
 
Fc9-u8-icon.png - BYTE Return


GetSignalLevel

Fc9-comp-macro.png GetSignalLevel
Returns the signal strength of the last signal received 
Fc9-u8-icon.png - BYTE Return


InitNetwork

Fc9-comp-macro.png InitNetwork
Initialises the Zigbee module and attempts to setup or join the network 
Fc9-void-icon.png - VOID Return


MIAC_Module_GetData

Fc9-comp-macro.png MIAC_Module_GetData
 
Fc9-u8-icon.png - BYTE Index
 
Fc9-u8-icon.png - BYTE Return


MIAC_Module_Message

Fc9-comp-macro.png MIAC_Module_Message
 
Fc9-u16-icon.png - UINT CAN_ID
 
Fc9-u16-icon.png - UINT CMD_ID
 
Fc9-u8-icon.png - BYTE Return


MIAC_Module_PushData

Fc9-comp-macro.png MIAC_Module_PushData
 
Fc9-u8-icon.png - BYTE Data
 
Fc9-void-icon.png - VOID Return


NodeConfigureSleep

Fc9-comp-macro.png NodeConfigureSleep
Sets the Zigbee device sleep mode (only applicable for end node type devices) ,  
Fc9-u8-icon.png - BYTE Mode
1=Hibernate, 2=Doze, 4=Cyclic Sleep, 5=Cyclic Doze 
Fc9-u16-icon.png - UINT Timeout
Time to sleep in milli seconds (ms) 
Fc9-void-icon.png - VOID Return


NodeWake

Fc9-comp-macro.png NodeWake
Wakes up the local Zigbee module from sleep mode. 
Fc9-void-icon.png - VOID Return


ReadATResponse

Fc9-comp-macro.png ReadATResponse
Reads a single byte from the received AT command response. 
Fc9-u8-icon.png - BYTE idx
Specified the byte index in the buffer. Range 0-15 
Fc9-u8-icon.png - BYTE Return


ReadAddressFromBuffer

Fc9-comp-macro.png ReadAddressFromBuffer
Reads a byte from a 16-bit Zigbee device address 
Fc9-u8-icon.png - BYTE Device
 
Fc9-u8-icon.png - BYTE Idx
 
Fc9-u8-icon.png - BYTE Return


ReadNameFromBuffer

Fc9-comp-macro.png ReadNameFromBuffer
Returns a byte from the 8-Byte name 
Fc9-u8-icon.png - BYTE Device
The Device name to collect. Range: 0-7 
Fc9-u8-icon.png - BYTE Idx
The index position of the name. Range: 0-7 
Fc9-u8-icon.png - BYTE Return


ReceiveChar

Fc9-comp-macro.png ReceiveChar
Attempt to receive a byte from the Zigbee module. 
Fc9-u8-icon.png - BYTE nTimeout
 
Fc9-u8-icon.png - BYTE Return


RestartNetwork

Fc9-comp-macro.png RestartNetwork
Attempts to restart the network 
Fc9-void-icon.png - VOID Return


ScanBuffer

Fc9-comp-macro.png ScanBuffer
Returns a binary list of matched identifier names 
Fc9-string-icon.png - STRING Compare_Str
 
Fc9-u8-icon.png - BYTE Length
 
Fc9-u8-icon.png - BYTE Return


ScanNetwork

Fc9-comp-macro.png ScanNetwork
Scans the local network for devices and stores into a local device array. Mode = 0 store device names, mode = 1 store device addresses. Returns the number of devices found. 
Fc9-u8-icon.png - BYTE Mode
 
Fc9-u8-icon.png - BYTE Return


SendATCommand

Fc9-comp-macro.png SendATCommand
Transmits a string of values to the Zigbee module. 
Fc9-string-icon.png - STRING Command
Transmits a command to the Zigbee module followed by a carriage return 
Fc9-void-icon.png - VOID Return


SendChar

Fc9-comp-macro.png SendChar
Transmits a byte value to the Zigbee module. 
Fc9-u8-icon.png - BYTE Byte
Data byte to transmit. Range 0-255 
Fc9-void-icon.png - VOID Return


StoreParams

Fc9-comp-macro.png StoreParams
Stores the current register set into the Zigbee module's non volatile memory 
Fc9-void-icon.png - VOID Return


Property reference

Fc9-prop-icon.png Properties
Fc9-type-10-icon.png Device Name
String of characters used to allow the Zigbee node to use the name addressing mode of operation. Can be left blank if name addressing is not being used. 
Fc9-type-16-icon.png Zigbee Mode
Specifies the functionality of the Zigbee node. Coordinator - Must be used with a Coordinator Zigbee E-Block EB051C, Responsible for starting the network and assigning addresses. Router - Must be used with a Router / End Node E-Block EB051R, Responsible for forwarding / repeating packets on the network. End Device - Must be used with a Router / End Node E-Block EB051R, Capable of low power operation. 
Fc9-type-7-icon.png Auto ID
Automatically generate a PAN ID  
Fc9-type-10-icon.png PAN ID
Assigns a Personal Area Network Identifier code to the Zigbee node. Random / Search - Scans the local area for Zigbee PAN networks and joins the existing network, otherwise a random value is chosen. Preset - Assigns a preset PAN ID to the Zigbee node, Must be between 0x0 and 0x3FFF. 
Fc9-type-16-icon.png Node Join Time
Length of time in seconds where nodes are allowed to join the network. Infinte - Nodes are always allowed to join the network. Preset - Nodes are only allowed to join the network for a specific amount of time. Note: Join time not available for End Device nodes.  
Fc9-type-14-icon.png Max Hops
Specifies the maximum number of retransmits for a Broadcast transmission. 
Fc9-type-16-icon.png Sleep Buffer Time
Length of time to buffer packets for sleeping or powered down nodes. This value must be consistent throughout the Zigbee network. Default - Assigns the maximum buffer time of 28 seconds. Preset - Allows for a custom sleep time of 0.32 - 28 seconds. 
Fc9-conn-icon.png Connections
Fc9-type-16-icon.png Channel
UART Channel selector Software channels are bit banged using generic I/O pins but are not as reliable as hardware channels. Hardware channels use the selected peripheral on-board the target microcontroller. 
Fc9-type-5-icon.png TX
Pin to be used for Transmit data 
Fc9-type-5-icon.png RX
Pin to be used for Receive data 
Fc9-type-16-icon.png Baud Options
Baud rate option selector 
Fc9-type-14-icon.png Baud Rate
 
Fc9-type-16-icon.png Use Flow Control
Flow Control (Handshake) enable or disable. On: Two I/O pins are used to control the flow of data in and out of the device. Off: Flow control is disabled. 
Fc9-type-5-icon.png RTS
Pin to be used for Request To Send handshake function Output from target micro to inform remote device we are ready to receive data. Low = Ready to receive data High = Not ready to receive data 
Fc9-type-5-icon.png CTS
Pin to be used for Clear To Send handshake function. Input to target micro to inform when the remote device is ready to transmit data. Low = Ready to transmit data High = Not ready to transmit data 
Fc9-type-5-icon.png Sleep Pin
Zigbee Sleep Control Pin 
Fc9-conn-icon.png Scan Channels
Fc9-type-7-icon.png 0x0B
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x0C
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x0D
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x0E
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x0F
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x10
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x11
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x12
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x13
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x14
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x15
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x16
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x17
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x18
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x19
Determines if channel will be scanned 
Fc9-type-7-icon.png 0x1A
Determines if channel will be scanned 
Fc9-type-14-icon.png Scan Duration
Configures the length of time to scan each channel for network activity. The overall time for the entire channel scan is shown as channel scan time. 
Fc9-type-14-icon.png Total Scan Time (ms)
The total amount of time that it will take to perform a complete RF channel scan based on the selected scan channels and duration. 
Fc9-conn-icon.png Simulation
Fc9-type-10-icon.png Label
 
Fc9-type-7-icon.png Scope Traces
Selects if the scope traces are automatically added to the data recorder window or not. Simulation - draws an approximation of the UART data onto the scope trace. ICT - sets up the scope trace for incoming data and adds UART packet decoding at the correct BAUD. 
Fc9-type-7-icon.png Console Data
Selects if the console data is automatically generated or not 
Fc9-type-21-icon.png Console Columns
Number of characters that can be displayed on a single line of the console. 
Fc9-type-16-icon.png Data Source
Simulation data source used to allow the component to connect to various remote devices Nothing - Simulation data is ignored COM port - Routes the communication data to and from a physical or virtual COM port API - Routes the communication data via a data API component on the Panel.