Tizen/Artik IoT Lecture Chapter 7. IoTivity Connectivity Abstraction

Transcription

1 1 Tizen/Artik IoT Lecture Chapter 7. IoTivity Connectivity Abstraction Sungkyunkwan University

2 Contents 2 Architecture Routing Through Heterogeneous Connectivity Blockwise Transfer Call Path Sending Data Receiving Data CA APIs

3 Architecture IoTivity v1.0 Resource Encapsulation CA Control Resource Introspection Network Config. Transport Adapter IP Adapter Platform Adapter Ubuntu Interface CoAP Protocol BLE Adapter IoTivity Application Android Interface CA API BT Adapter Message Switching Blockwise Transfer TCP Adapter Tizen Interface Configuration Routing Manager Message Forwarder Interface Controller NFC Adapter Arduino Interface Message Switching Gateway resource discovery Routing table update and managing Message routing( forwarding ) CA Control Component Target network selection and interface control and monitoring CoAP message serialization and parsing Blockwise messaging flow control Transport Adapter Component Data transmission over UDP, TCP, BLE( GATT ), BT( SPP ) and NFC Secure data exchanging using DTLS Platform Adapter Component Ubuntu Wifi, Ethernet and BLE Android Wifi, BLE and BT Tizen Wifi, BLE and BT Arduino Wifi, Ethernet and BLE Legend CA Component CA Module External 3 Ubuntu Android Tizen Arduino Ubuntu Android Tizen Arduino

4 Routing Through Heterogeneous Connectivity If any intermediary gateway device has multiple connectivity (ex. IP and BT), it can forward requests and responses so that resources on different transports can be discovered and communicated. 4 ROUTING=GW compile option ROUTING=EP compile option

5 Blockwise Transfer OIC client and OIC server can send/receive the large size messages by means of transferring of small block unit 5

6 Start from Basic API Example 6 OCPlatform::findResource (const std::string& host const std::string& resourcename OCConnectivityType connectivitytype FindCallback resourcehandler) Example: simpleclient.cpp... requesturi << OC_RSRVD_WELL_KNOWN_URI; OCPlatform::findResource(, requesturi.str(), CT_DEFAULT, &foundresource);... /oic/res = all OIC devices that are discoverable API for Service and Resource discovery (client side only) host == null: multicast resource discovery query

7 Call Path 7 OCPlatform OCPlatform_impl InProcClientWrapper OCStack CaAPI Same as other Restful APIs call path; POST, GET, PUT, OBSERVE OCPlatform::findResource( host, resourcename, connectivitytype, resourcehandler ) IClientWrapper OCPlatform OCPlatform_impl InProcClientWrapper OCStack CaAPI OCPlatform_impl::instance().findResource() ListenForResource() OCDoResource() OCSendRequest() CASendRequest()

8 Source Code Hierarchy 8 iotivity/resource/csdk/connectivity/src Routing manager source code is under the iotivity/resource/csdk/routing IoTivity Connectivity/src Resource caconnectivity manager.c camessage handler.c ip_adapter src csdk cacainterface controller.c canetwork configurator.c android ocplatform.cpp ocplatform_impl.cpp stack/src Connectivity/src caprotocol message.c caqueueing thread.c linux ocstack.c caretransmission.c arduino tizen

9 Call Path: Sending Data 9 1. Send requests are processed by Block-wise transfer(bwt) basically in case of UDP and BT 2. BWT prepares atomic data with default size (1KB) of block data and send it to SendQueue thread 3. SendQueueThread send data to handler of interested transport 4. ~ 6. In case of UDP, SendQueueThread for UDP send data to endpoint 2 Types of SendQueue: Common Adapter

10 Call Path: Receiving Data In case of UDP, ReceiveThread for UDP receive data from endpoint 2. In case that interested transport is UDP or BT, BWT prepares next atomic data of block data 3. It is sent to SendQueueThread again 4. If received data is the last data for block in BWT, it is sent to ReceiveQueueThread and finally sent to upper layer

11 CA APIs CAResult_t CAInitialize(); void CATerminate(); CAResult_t CAStartListeningServer(); CAResult_t CAStopListeningServer(); CAResult_t CAStartDiscoveryServer(); void CARegisterHandler( CARequestCallback ReqHandler, CAResponseCallback RespHandler, CAErrorCallback ErrorHandler ); CAResult_t CACreateEndpoint( CATransportFlags_t flags, CATransportAdapter_t adapter, const char *addr, uint16_t port, CAEndpoint_t **object ); void CADestroyEndpoint(CAEndpoint_t *object); CAResult_t CAGenerateToken(CAToken_t *token, uint8_t tokenlength); void CADestroyToken(CAToken_t token); CAResult_t CASendRequest(const CAEndpoint_t *object, const CARequestInfo_t *requestinfo); CAResult_t CASendResponse(const CAEndpoint_t *object, const CAResponseInfo_t *responseinfo); CAResult_t CASelectNetwork(CATransportAdapter_t interestednetwork); CAResult_t CAUnSelectNetwork(CATransportAdapter_t noninterestednetwork); CAResult_t CAGetNetworkInformation(CAEndpoint_t **info, uint32_t *size); CAResult_t CAHandleRequestResponse(); CAResult_t CASetRAInfo(const CARAInfo_t *carainfo); *input parameter *output parameter 11

12 CA API Initialize 12 CAInitialize() Initialize the connectivity abstraction module Initialize adapters common thread pool other modules

13 CA API Select Network 13 CASelectNetwork () Select network to use

14 CA API Start Server 14 CAStartDiscover yserver() Used by resource required clients for listening multicast requests Based on the adapters configurations, different kinds of servers are started

15 CA API Create Endpoint 15 CACreateEndpoint() Create an endpoint description Freed using CADestroyEndpoint()

16 CA API Generate Token 16 CAGenerateToken() Generating the token for matching the request and response

17 CA API Send Request/Response 17 CASendRequest() Send control request on a resource CA_GET/CA_POST/CA_PUT/CA_DELE TE 2. CADetachSendMessage() for the interested transport(s) 3. BWT if IP, NFC, DEFAULT CASendThreadProcess() in common queue thread 4. CAGeneratePDU() 5. Check block options 6. CASendUnicastData() Retransmission if IP/RFCOMM/GATT 7. CASendIPUnicastData()

18 CA API Send Request/Response if BLE, TCP Not through BWT 18

19 CA API - Receive Request/Response 19 CAReceivePacketCallb ack() 2. CAParsePDU() 3. CAGenerateHandlerData() Generate CA data to enqueue 4. Stop if ACK/RST message has been received 5. BWT 6. Add CA data to queueing thread CAReceiveThreadProces s() 7. HandleCARequest() in OCStack

20 CA API Receive Request/Response 20 Not passing to upper layer, but just keep it in send queueing thread

21 CA API Receive Response if BLE, TCP No BWT 21

22 CA API Get Network Information CAGetNetworkIn formation() Get network information