ZigBee PRO
Configuration Guide
JN-UG-3065
Revision 1.1
2-Dec-2009
Jennic
ZigBee PR
O
Configuration Guide
2 © Jennic 2009 JN-UG-3065 v1.1
Jenni
c
ZigBee PRO
Configuration Guide
Contents
About this Manual 5
Organisation 5
Conventions 5
Acronyms and Abbreviations 5
Related Documents 6
Feedback Address 6
1 Network and OS Configuration 7
1.1 Configuration Overview 7
1.1.1 Configuration Tools 7
1.1.2 Configuration Principles 8
1.2 Configuring Use of JenOS Resources 9
1.3 Configuring ZigBee Network Parameters 11
2 JenOS Configuration Editor 15
2.1 Getting Started 16
2.2 Building Configuration Diagrams 19
2.2.1 Starting the Diagram – the OS Icon 19
2.2.2 Adding a Module 21
2.3 Example 1 – Using a Task 22
2.3.1 Adding a Task to the Diagram 23
2.3.2 Other Elements Needed on the Diagram 25
2.4 Example 2 – Hardware and Software Timers 30
2.4.1 Adding the Hardware Counter 30
2.4.2 Adding the Software Timers and Tasks 37
2.5 Example 3 – Using Messages and Queues 40
2.5.1 Adding the Switch Scan Task and ISR 40
2.5.2 Adding the Message Queue 41
2.5.3 How it Works 43
2.6 Example 4 – Critical Sections 46
2.6.1 Adding the Mutex to the Diagram 47
2.6.2 How it Works 48
2.7 Example 5 – Using Callbacks 49
3 ZPS Configuration Editor 51
3.1 Getting Started 51
3.2 Using the ZPS Configuration Editor 52
3.2.1 New ZPS Configuration 52
3.2.2 Set Basic Network Parameters 53
3.2.3 Adding Device Types 53
3.2.4 Setting Co-ordinator Properties 55
3.3 Set the Advanced Device Parameters 59
JN-UG-3065 v1.1 © Jennic 2009 3
Jennic
ZigBee PR
O
Configuration Guide
Appendices 61
A Example Applications for OS Configuration 61
B ZigBee Wireless Network Parameters 64
B.1 Profile Definition Parameters 65
B.1.1 Cluster Definition Parameters 66
B.2 Co-ordinator Parameters 67
B.3 Router Parameters 68
B.4 End Device Parameters 69
B.5 Advanced Device Parameters 70
B.5.1 Endpoint Parameters 74
B.5.2 Bound Addressing Table 76
B.5.3 PDU Manager 76
B.5.4 Group Addressing Table 77
B.5.5 RF Channels 77
B.5.6 Node Descriptor 78
B.5.7 Node Power Descriptor 81
B.5.8 Key Descriptor Table 81
B.5.9 Trust Centre 82
B.5.10 ZDO Configuration 84
C Hardware Counter Details 90
4 © Jennic 2009 JN-UG-3065 v1.1
Jenni
c
ZigBee PRO
Configuration Guide
About this Manual
This manual describes the editors provided by Jennic for configuring a ZigBee PRO
wireless network, based on the Jennic JN5148 wireless microcontroller and being
developed using the JN5148 ZigBee PRO Software Developer’s Kit (SDK).
You will need to refer to this manual during application development in order to
configure the JenOS resources to be used by your application and to set the
parameters of the ZigBee PRO network.
To support the tutorials in this manual, a number of example application files are
bundled with the manual in a ZIP file (for a summary of these examples, refer to
Appendix
A).
Organisation
This manual consists of three chapters and three appendices, as follows:
• Chapter 1 introduces the configuration editors.
•
Chapter 2 describes how to use the JenOS Configuration Editor to configure
the use of JenOS resources.
•
Chapter 3 describes how to use the ZPS Configuration Editor to configure the
ZigBee PRO network parameters.
• The appendices detail the example applications provided with this manual, the
ZigBee PRO network parameters and the use of a hardware counter to drive
software timers (for event scheduling).
Conventions
Files, folders, functions and parameter types are represented in bold type.
Function parameters are represented in italics type.
Code fragments are represented in the Courier
typeface.
Acronyms and Abbreviations
API Application Programming Interface
IDE Integrated Development Environment
ISR Interrupt Service Routine
JenOS Jennic Operating System
PDUM Protocol Data Unit Manager
RTOS Real-Time Operating System
SDK Software Developers Kit
JN-UG-3065 v1.1 © Jennic 2009 5