summaryrefslogtreecommitdiffhomepage
path: root/digital/zigbit/bitcloud/stack/Components/ZDO/include/private/zdoStartNetwork.h
blob: 57be2ed0db77f3c906550d453249b25ec0492684 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
/**************************************************************************//**
  \file zdoStartNetwork.h

  \brief Interface for ZDO Start Network request routines

  \author
    Atmel Corporation: http://www.atmel.com \n
    Support email: avr@atmel.com

  Copyright (c) 2008-2011, Atmel Corporation. All rights reserved.
  Licensed under Atmel's Limited License Agreement (BitCloudTM).

  \internal
  History:
    17.09.09 A. Taradov - Created
******************************************************************************/
#ifndef _ZDOSTARTNETWORK_H
#define _ZDOSTARTNETWORK_H

/******************************************************************************
                        Includes section
******************************************************************************/
#include <zdo.h>
#include <queue.h>
#include <nwk.h>

/******************************************************************************
                        Definitions section
******************************************************************************/

/******************************************************************************
                        Types section
******************************************************************************/
typedef enum _ZdoStartNetworkState_t
{
  ZDO_START_NETWORK_IDLE_STATE,
  ZDO_START_NETWORK_BEGIN_STATE,
  ZDO_START_NETWORK_APS_RESET_STATE,
  ZDO_START_NETWORK_FORMATION_STATE,
  ZDO_START_NETWORK_JOIN_STATE,
  ZDO_START_NETWORK_REJOIN_STATE,
  ZDO_START_NETWORK_JOINED_STATE,
  ZDO_START_NETWORK_START_ROUTER_STATE,
  ZDO_START_NETWORK_PERMIT_JOIN_STATE,
  ZDO_START_NETWORK_APS_START_STATE,
  ZDO_START_NETWORK_ANNCE_STATE,
  ZDO_START_NETWORK_CONFIRM_STATE
} ZdoStartNetworkState_t;

typedef void (ZdoStartNetworkConf_t)(ZDO_Status_t status);

typedef struct _ZdoStartNetwork_t
{
  QueueDescriptor_t        queue;
  ZdoStartNetworkState_t   state;
  NWK_RejoinNetwork_t      startupType;
  ZdoStartNetworkConf_t    *confirm;
  NWK_PowerFailureControl_t powerFailureControl;
#if defined(_ROUTER_) || defined(_ENDDEVICE_)
  uint8_t                  joinAttempts;
  HAL_AppTimer_t           joinTimer;
#endif
} ZdoStartNetwork_t;

/******************************************************************************
                        Prototypes section
******************************************************************************/

/******************************************************************************
  Reset Start Network component.
  Parameters:
    none
  Return:
    none
******************************************************************************/
void zdoStartNetworkReset(void);

/******************************************************************************
  Start network rejoin
  Parameters:
    none
  Return:
    none
******************************************************************************/
void zdoRejoinNetwork(void);

/******************************************************************************
  Start Network request task handler.
  Parameters:
    none
  Return:
    none
******************************************************************************/
void zdoStartNetworkTaskHandler(void);

/******************************************************************************
  Allocate Start Network module
  Parameters:
    startNetworkConf - confirmation callback
  Return:
    true - if module was alocated, false otherwise
******************************************************************************/
bool zdoStartNetworkAlloc(ZdoStartNetworkConf_t *startNetworkConf);

/******************************************************************************
  Free Start Network module
  Parameters:
    none
  Return:
    none
******************************************************************************/
void zdoStartNetworkFree(void);

#ifdef _COORDINATOR_
/******************************************************************************
  NLME-NETWORK-FORMATION.request preparing and sending.
  Parameters:
    none
  Return:
    none
******************************************************************************/
void zdoNetworkFormationReq(void);
#endif /* _COORDINATOR_ */

#endif // _ZDOSTARTNETWORK_H

// eof zdoStartNetwork.h