Restructuring of the easy-setup service.
[platform/upstream/iotivity.git] / service / easy-setup / inc / escommon.h
1 //******************************************************************
2 //
3 // Copyright 2015 Samsung Electronics All Rights Reserved.
4 //
5 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
6 //
7 // Licensed under the Apache License, Version 2.0 (the "License");
8 // you may not use this file except in compliance with the License.
9 // You may obtain a copy of the License at
10 //
11 //      http://www.apache.org/licenses/LICENSE-2.0
12 //
13 // Unless required by applicable law or agreed to in writing, software
14 // distributed under the License is distributed on an "AS IS" BASIS,
15 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 // See the License for the specific language governing permissions and
17 // limitations under the License.
18 //
19 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
20
21 #ifndef ES_COMMON_H_
22 #define ES_COMMON_H_
23
24 #include <iostream>
25 #include <string>
26 #ifndef WITH_ARDUINO
27 #include <memory>
28 #endif
29
30 #include "ocstack.h"
31 #include "octypes.h"
32
33 using namespace std;
34
35 // Defines
36 #define OIC_STRING_MAX_VALUE    100
37 #define IPV4_ADDR_SIZE          16
38 #define IP_PORT                 55555
39 #define NET_WIFI_SSID_SIZE      100
40 #define NET_WIFI_PWD_SIZE       100
41
42 /**
43  * @brief Mac address length for BT port
44  */
45 #define NET_MACADDR_SIZE 18
46
47 /**
48  * Attributes used to form a proper easysetup conforming JSON message.
49  */
50 #define OC_RSRVD_ES_PS                     "ps"
51 #define OC_RSRVD_ES_TNN                    "tnn"
52 #define OC_RSRVD_ES_CD                     "cd"
53 #define OC_RSRVD_ES_TR                     "tr"
54 #define OC_RSRVD_ES_TNT                    "tnt"
55 #define OC_RSRVD_ES_ANT                    "ant"
56 #define OC_RSRVD_ES_URI_PROV               "/oic/prov"
57 #define OC_RSRVD_ES_URI_NET                "/oic/net"
58
59 /**
60  * @brief Defines for Provisioning status accepted values
61  */
62 #define ES_PS_NEED_PROVISIONING         1
63 #define ES_PS_PROVISIONING_COMPLETED    2
64
65 /**
66 * Device Roles defined for each device type used in easy setup
67 */
68 typedef enum
69 {
70     ENROLLEE,
71     MEDIATOR,
72     ENROLLER,
73 } DeviceRole;
74
75 /**
76 * On-boarding connection to create Adhoc network.
77 */
78 typedef enum
79 {
80     SOFTAP,
81     BLE,
82 } OBConnection;
83
84 typedef enum
85 {
86     ES_ERROR = -1,
87     ES_OK = 0,
88     ES_NETWORKFOUND = 1,
89     ES_NETWORKCONNECTED,
90     ES_NETWORKNOTCONNECTED,
91     ES_RESOURCECREATED = 11,
92     ES_RECVREQOFPROVRES = 21,
93     ES_RECVREQOFNETRES,
94     ES_RECVUPDATEOFPROVRES,
95     ES_RECVTRIGGEROFPROVRES,
96 } ESResult;
97
98 typedef enum
99 {
100     /**
101      * Default state of the device
102      */
103     ES_INIT_STATE,
104
105     /**
106      * Device will move to this state once the on boarding begins
107      */
108     ES_ON_BOARDING_STATE,
109
110     /**
111      * Device will move to this state after successful on-boarding of the device
112      */
113     ES_ON_BOARDED_STATE,
114
115     /**
116      * Device will move to this state once the on boarding is done
117      */
118     ES_PROVISIONING_STATE,
119
120     /**
121      * Easy setup process is successful.
122      */
123     ES_PROVISIONED_STATE,
124
125     /**
126      * This state is arbitrary one, any time device can come into this state
127      * Device will move to this state if the ownership transfer initiated  by the Application
128      */
129     ES_OWNERSHIP_TRANSFERRING_STATE,
130
131     /**
132      * This state is arbitrary one, any time device can come into this state
133      * Device will move to this state if the ownership transfer is completed
134      */
135     ES_OWNERSHIP_TRANSFERRED_STATE,
136
137     /**
138      * This state is arbitrary one, any time device can come into this state
139      * Device will move to this state once the Application factory reset the device
140      */
141     ES_FACTORY_RESET_STATE,
142
143     /**
144      * Enrollee moves to this state after connecting to target network
145      */
146     ES_ON_BOARDED_TARGET_NETWORK_STATE,
147 }EnrolleeState;
148
149 /**
150  * Provisioning Device Status
151  */
152 typedef struct
153 {
154     // Address of remote server
155     OCDevAddr * addr;
156     // Indicates adaptor type on which the response was received
157     OCConnectivityType connType;
158 } EasySetupDeviceInfo;
159
160 /**
161  * Provosioning Status
162  */
163 typedef enum
164 {
165     DEVICE_PROVISIONED = 0,
166     DEVICE_NOT_PROVISIONED,
167     DEVICE_OWNED,
168     DEVICE_NOT_OWNED
169 } EasySetupState, ProvStatus;
170
171 /**
172  * Response from queries to remote servers.
173  */
174 typedef struct
175 {
176     // EasySetup Status
177     EasySetupState provStatus;
178     // EasySetup Device Info
179     EasySetupDeviceInfo provDeviceInfo;
180 } EasySetupInfo, ProvisioningInfo;
181
182 /**
183  * @brief  Network information of the Enroller
184  */
185 typedef union
186 {
187     /**
188      * @brief BT Mac Information
189      */
190     struct
191     {
192         char btMacAddress[NET_MACADDR_SIZE];   /**< BT mac address **/
193     } BT;
194
195     /**
196      * @brief LE MAC Information
197      */
198     struct
199     {
200         char leMacAddress[NET_MACADDR_SIZE];   /**< BLE mac address **/
201     } LE;
202
203     /**
204      * @brief IP Information
205      */
206     struct
207     {
208         char ipAddress[IPV4_ADDR_SIZE]; /**< IP Address of the Enroller**/
209         char ssid[NET_WIFI_SSID_SIZE]; /**< ssid of the Enroller**/
210         char pwd[NET_WIFI_PWD_SIZE]; /**< pwd of the Enroller**/
211     } WIFI;
212 } EnrolleeInfo;
213
214
215 /**
216  * @brief Network Information
217  */
218 typedef struct
219 {
220     EnrolleeInfo netAddressInfo;    /**< Enroller Network Info**/
221     OCConnectivityType connType;    /**< Connectivity Type**/
222     bool isSecured;                 /**< Secure connection**/
223     // TODO : Ideally isSecured should be renamed to needSecuredEasysetup.
224     // To provide backward compatibility to v1.0 release, a new variable is being added.
225     // If isSecured is not used by other applications, isSecured will be depricated.
226     bool needSecuredEasysetup;      /**< Need of secure ownership transfer during easysetup**/
227 } EnrolleeNWProvInfo;
228
229 /**
230  * Client applications implement this callback to consume responses received from Servers.
231  */
232 typedef void (*OCProvisioningStatusCB)(EasySetupInfo *easySetupInfo);
233
234 #endif //ES_COMMON_H_