Component: Zigbee (EB051, XBEE) (XBEE) (Wireless): Difference between revisions
Appearance
No edit summary |
m Text replacement - "style="background-color:#EAE1EA;"" to "class="mtx-class-propfolder"" |
||
| (21 intermediate revisions by 2 users not shown) | |||
| Line 14: | Line 14: | ||
==Zigbee (EB051, XBEE) component== | ==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 | 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: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_Zigbee.fcfx FC_Comp_Source_Zigbee.fcfx] | |||
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] | |||
==Detailed description== | ==Detailed description== | ||
''No detailed description exists yet for this component'' | ''No detailed description exists yet for this component'' | ||
| Line 22: | Line 52: | ||
''<span style="color:red;">No additional examples</span>'' | |||
==Macro reference== | |||
{| class="wikitable | ===ConnectFromLibrary=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ConnectFromLibrary''' | ||
|- | |- | ||
| colspan="2" | Attempts to connect the data channel to a known device on the network. | | colspan="2" | Attempts to connect the data channel to a known device on the network. | ||
| Line 305: | Line 115: | ||
{| class="wikitable | ===ConnectToAddress=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ConnectToAddress''' | ||
|- | |- | ||
| colspan="2" | Attempts to connect the data channel to a specific device address on the network. | | colspan="2" | Attempts to connect the data channel to a specific device address on the network. | ||
| Line 323: | Line 134: | ||
{| class="wikitable | ===ConnectToAll=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ConnectToAll''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Attempts to connect the data channel to all devices on the network. | ||
|- | |- | ||
|- | |- | ||
| Line 336: | Line 148: | ||
{| class="wikitable | ===ConnectToCoordinator=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ConnectToCoordinator''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Attempts to connect the data channel to the network coordinator node. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | | 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'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===ConnectToName=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ConnectToName''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Attempts to connect the data channel to a named device on the network. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9- | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING | ||
| width="90%" | | | width="90%" | Name | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
| Line 390: | Line 181: | ||
{| class="wikitable | ===EnterCommandMode=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''EnterCommandMode''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Moves from data mode into command mode by sending the special characters | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 408: | Line 195: | ||
{| class="wikitable | ===ExitCommandMode=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ExitCommandMode''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Returns from command mode to allow data to be sent and received | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | |||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | |||
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===GetATResponse=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''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. | | 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. | ||
| Line 444: | Line 228: | ||
{| class="wikitable | ===GetSignalLevel=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''GetSignalLevel''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Returns the signal strength of the last signal received | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| Line 462: | Line 242: | ||
{| class="wikitable | ===InitNetwork=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''InitNetwork''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Initialises the Zigbee module and attempts to setup or join the network | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 480: | Line 256: | ||
{| class="wikitable | ===MIAC_Module_GetData=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''MIAC_Module_GetData''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | Index | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | | 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'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===MIAC_Module_Message=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''MIAC_Module_Message''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
|- | |- | ||
| width="10% | | width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT | ||
| width="90%" | CAN_ID | |||
| width="90%" | |||
| | |||
|- | |- | ||
| colspan="2" | | |||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT | | width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT | ||
| width="90%" | | | width="90%" | CMD_ID | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | | 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'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===MIAC_Module_PushData=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''MIAC_Module_PushData''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | Data | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 596: | Line 318: | ||
{| class="wikitable | ===NodeConfigureSleep=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''NodeConfigureSleep''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Sets the Zigbee device sleep mode (only applicable for end node type devices) , | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | Mode | |||
| width="90%" | |||
|- | |- | ||
| colspan="2" | 1=Hibernate, 2=Doze, 4=Cyclic Sleep, 5=Cyclic Doze | |||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT | | width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT | ||
| width="90%" | | | width="90%" | Timeout | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Time to sleep in milli seconds (ms) | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 645: | Line 342: | ||
{| class="wikitable | ===NodeWake=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''NodeWake''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Wakes up the local Zigbee module from sleep mode. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 676: | Line 356: | ||
{| class="wikitable | ===ReadATResponse=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ReadATResponse''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Reads a single byte from the received AT command response. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:]] - | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | idx | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Specified the byte index in the buffer. Range 0-15 | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | | 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'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===ReadAddressFromBuffer=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ReadAddressFromBuffer''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Reads a byte from a 16-bit Zigbee device address | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | Device | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90% | | width="90%" | Idx | ||
|- | |- | ||
| | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE | |||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | |||
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===ReadNameFromBuffer=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ReadNameFromBuffer''' | ||
|- | |- | ||
| colspan="2" | Returns | | colspan="2" | Returns a byte from the 8-Byte name | ||
|- | |- | ||
|- | |- | ||
| width="10% | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | Device | |||
| width="90% | |||
|- | |- | ||
| colspan="2" | The Device name to collect. Range: 0-7 | |||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | Idx | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | The index position of the name. Range: 0-7 | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | | 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'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===ReceiveChar=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ReceiveChar''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Attempt to receive a byte from the Zigbee module. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | nTimeout | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | | 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'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===RestartNetwork=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''RestartNetwork''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Attempts to restart the network | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 836: | Line 456: | ||
{| class="wikitable | ===ScanBuffer=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ScanBuffer''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Returns a binary list of matched identifier names | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING | ||
| width="90%" | Compare_Str | |||
| width="90% | |||
|- | |- | ||
| colspan="2" | | |||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | Length | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | | 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'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===ScanNetwork=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''ScanNetwork''' | ||
|- | |- | ||
| colspan="2" | | | 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. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90% | | width="90%" | Mode | ||
|- | |- | ||
| | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE | |||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:]] - | |||
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
{| class="wikitable | ===SendATCommand=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''SendATCommand''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Transmits a string of values to the Zigbee module. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING | ||
| width="90% | | width="90%" | Command | ||
|- | |- | ||
| colspan="2" | Transmits a command to the Zigbee module followed by a carriage return | |||
| colspan="2" | | |||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 929: | Line 518: | ||
{| class="wikitable | ===SendChar=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''SendChar''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Transmits a byte value to the Zigbee module. | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | ||
| width="90%" | | | width="90%" | Byte | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Data byte to transmit. Range 0-255 | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 947: | Line 537: | ||
{| class="wikitable | ===StoreParams=== | ||
{| class="mtx-class-macrotable wikitable" | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''StoreParams''' | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Stores the current register set into the Zigbee module's non volatile memory | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID | ||
| Line 978: | Line 551: | ||
==Property reference== | |||
{| class="mtx-class-macrotable wikitable" | |||
{| class="wikitable | |||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''Properties''' | ||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]] | |||
| width="90%" | Device Name | |||
|- | |- | ||
| | | 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. | ||
|- | |- | ||
| | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
| width="90%" | Zigbee Mode | |||
|- | |- | ||
| | | 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. | ||
|- | |- | ||
| width="10% | | width="10%" align="center" | [[File:Fc9-type-7-icon.png]] | ||
| width="90% | | width="90%" | Auto ID | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Automatically generate a PAN ID | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]] | |||
| width="90%" | PAN ID | |||
|- | |- | ||
| | | 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. | ||
|- | |- | ||
| | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
| width="90%" | Node Join Time | |||
|- | |- | ||
| | | 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. | ||
|- | |- | ||
| width="10% | | width="10%" align="center" | [[File:Fc9-type-14-icon.png]] | ||
| width="90% | | width="90%" | Max Hops | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Specifies the maximum number of retransmits for a Broadcast transmission. | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | |||
| width="90%" | Sleep Buffer Time | |||
|- | |- | ||
| | | 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. | ||
|- | |- | ||
| | | width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]] | ||
| width="90%" class="mtx-class-propfolder" | Connections | |||
|- | |- | ||
|- | |- | ||
| width="10% | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
| width="90% | | width="90%" | Channel | ||
|- | |- | ||
| colspan="2" | | | 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. | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]] | |||
| width="90%" | TX | |||
|- | |- | ||
| | | colspan="2" | Pin to be used for Transmit data | ||
|- | |- | ||
| | | width="10%" align="center" | [[File:Fc9-type-5-icon.png]] | ||
| width="90%" | RX | |||
|- | |- | ||
| | | colspan="2" | Pin to be used for Receive data | ||
|- | |- | ||
| width="10%" align="center | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
| width="90% | | width="90%" | Baud Options | ||
|- | |- | ||
| colspan="2" | Baud rate option selector | |||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type- | | width="10%" align="center" | [[File:Fc9-type-14-icon.png]] | ||
| width="90%" | | | width="90%" | Baud Rate | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
| width="90%" | | | width="90%" | Use Flow Control | ||
|- | |- | ||
| colspan="2" | | | 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. | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type- | | width="10%" align="center" | [[File:Fc9-type-5-icon.png]] | ||
| width="90%" | | | width="90%" | RTS | ||
|- | |- | ||
| colspan="2" | | | 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 | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type- | | width="10%" align="center" | [[File:Fc9-type-5-icon.png]] | ||
| width="90%" | | | width="90%" | CTS | ||
|- | |- | ||
| colspan="2" | | | 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 | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type- | | width="10%" align="center" | [[File:Fc9-type-5-icon.png]] | ||
| width="90%" | | | width="90%" | Sleep Pin | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | Zigbee Sleep Control Pin | ||
|- | |- | ||
| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]] | |||
| width="90%" class="mtx-class-propfolder" | Scan Channels | |||
| width="10%" align="center" | [[File:Fc9- | |||
| width="90%" | | |||
|- | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]] | | width="10%" align="center" | [[File:Fc9-type-7-icon.png]] | ||
| Line 1,198: | Line 737: | ||
| 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. | | 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. | ||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]] | ||
| width="90%" | | width="90%" class="mtx-class-propfolder" | Simulation | ||
|- | |- | ||
|- | |- | ||
Latest revision as of 14:37, 13 July 2026
| 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
| ConnectFromLibrary | |
| Attempts to connect the data channel to a known device on the network. | |
| Mode | |
| Device | |
| Return | |
ConnectToAddress
| ConnectToAddress | |
| Attempts to connect the data channel to a specific device address on the network. | |
| Address | |
| Return | |
ConnectToAll
| ConnectToAll | |
| Attempts to connect the data channel to all devices on the network. | |
| Return | |
ConnectToCoordinator
| ConnectToCoordinator | |
| Attempts to connect the data channel to the network coordinator node. | |
| Return | |
ConnectToName
| ConnectToName | |
| Attempts to connect the data channel to a named device on the network. | |
| Name | |
| Return | |
EnterCommandMode
| EnterCommandMode | |
| Moves from data mode into command mode by sending the special characters | |
| Return | |
ExitCommandMode
| ExitCommandMode | |
| Returns from command mode to allow data to be sent and received | |
| Return | |
GetATResponse
| 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. | |
| Logging | |
| Return | |
GetSignalLevel
| GetSignalLevel | |
| Returns the signal strength of the last signal received | |
| Return | |
InitNetwork
| InitNetwork | |
| Initialises the Zigbee module and attempts to setup or join the network | |
| Return | |
MIAC_Module_GetData
| MIAC_Module_GetData | |
| Index | |
| Return | |
MIAC_Module_Message
| MIAC_Module_Message | |
| CAN_ID | |
| CMD_ID | |
| Return | |
MIAC_Module_PushData
| MIAC_Module_PushData | |
| Data | |
| Return | |
NodeConfigureSleep
NodeWake
| NodeWake | |
| Wakes up the local Zigbee module from sleep mode. | |
| Return | |
ReadATResponse
| ReadATResponse | |
| Reads a single byte from the received AT command response. | |
| idx | |
| Specified the byte index in the buffer. Range 0-15 | |
| Return | |
ReadAddressFromBuffer
| ReadAddressFromBuffer | |
| Reads a byte from a 16-bit Zigbee device address | |
| Device | |
| Idx | |
| Return | |
ReadNameFromBuffer
| ReadNameFromBuffer | |
| Returns a byte from the 8-Byte name | |
| Device | |
| The Device name to collect. Range: 0-7 | |
| Idx | |
| The index position of the name. Range: 0-7 | |
| Return | |
ReceiveChar
| ReceiveChar | |
| Attempt to receive a byte from the Zigbee module. | |
| nTimeout | |
| Return | |
RestartNetwork
| RestartNetwork | |
| Attempts to restart the network | |
| Return | |
ScanBuffer
| ScanBuffer | |
| Returns a binary list of matched identifier names | |
| Compare_Str | |
| Length | |
| Return | |
ScanNetwork
SendATCommand
| SendATCommand | |
| Transmits a string of values to the Zigbee module. | |
| Command | |
| Transmits a command to the Zigbee module followed by a carriage return | |
| Return | |
SendChar
| SendChar | |
| Transmits a byte value to the Zigbee module. | |
| Byte | |
| Data byte to transmit. Range 0-255 | |
| Return | |
StoreParams
| StoreParams | |
| Stores the current register set into the Zigbee module's non volatile memory | |
| Return | |