Intel Confidential — Do Not Forward Look Inside. ™ Intel-Samsung Conference Call – 2014/09/10 Topic 1: Device Description & Discovery Resource 1
Intel Confidential — Do Not Forward Overview The device description resource is a virtual resource that provides a representation that that contains information about the device. Problem Statement The device description resource addresses two issues: It provides a standard mechanism to query well-known device meta-data including but not limited to device id, name, description, etc. (All-Seen’s About Feature) The framework already provides discovery service allowing a client to find resources that are currently on the network. However, as a resource-based query mechanism, the mechanism finds all resources or resources that have specific interfaces. It does not provide a mechanism to find devices based on specific device-level attributes. 2 Overview and Problem Statement
Intel Confidential — Do Not Forward Server offers the description resource at “/oc/core/d” GET allows querying the resource with or without a filter PUT, POST, DELETE are not currently supported GET request can be sent directly (unicast) or to all nodes (multicast) GET returns a complete representation or empty representation (if filtered) 3 Basic Operation
Intel Confidential — Do Not Forward Representation is in JSON A number of standard attributes are defined Currently, all attributes are optional 4 Representation
Intel Confidential — Do Not Forward The following standard attributes have been defined: 5 Standard Attributes NameTagDescription Device Namedn Human friendly name For example, “Bob’s Thermostat” Host Namehn Fully qualified (domain segmented) hostname For example, “thermostat1.home.com” IP AddressipIP address Device IDdiUnique identifier for device (UUID) Content TypectDefault content type – this is a hint to see if client supports this content type VersionicvVersion of the OIC server Manufacturer Name mnmnName of manufacturer (not to exceed 16 characters) Manufacturer Details Link (URL) mnmlURL to manufacturer (not to exceed 32 characters) Model NumbermnmoModel number as designated by manufacturer Date of Manufacturemndt Platform VersionmnpvVersion of platform – string (defined by manufacturer) Firmware versionmnfv Support URLmnslURL that points to support information from manufacturer
Intel Confidential — Do Not Forward Simple Temperature Sensor at { “dn” : “Outdoor Temperature”, “di” : “3c3e4483-c8eb-4870-ab8c dcfc64”, “mnmn” : “Sensors Emporium” } Simple Humidity Sensor at { “dn” : “Outdoor Humidity”, “di” : “83f3f101-8c09-4ad1-8cb5-bfab83c618e6”, “mnmn” : “Sensors Emporium” } 6 Sample Representations
Intel Confidential — Do Not Forward Request (Unicast) GET // /oc/core/d Response (Unicast) { “dn” : “Outdoor Temperature”, “di” : “3c3e4483-c8eb-4870-ab8c dcfc64”, “mnmn” : “Sensors Emporium” } 7 Direct Query Example
Intel Confidential — Do Not Forward Request (Multicast) GET // /oc/core/d?di=83f3f101-8c09-4ad1-8cb5-bfab83c618e6” Response from (Unicast) No response as “di” attribute does not match Response from (Unicast) { “dn” : “Outdoor Humidity”, “di” : “83f3f101-8c09-4ad1-8cb5-bfab83c618e6”, “mnmn” : “Sensors Emporium” } 8 Discovery Using Device Description Resource