1. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. RESTful Service Oriented Device Architecture(SODA)‏ Lee Surprenant lmsurpre@us.ibm.com Andy Smith andybs@us.ibm.com

2. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Eclipse™ Open Healthcare Framework (OHF)‏ Expediting healthcare informatics technology Extensible frameworks and tools in healthcare  Interoperable open source infrastructure  Lower barriers  Leverage existing and emerging standards HL7™, IHE™, Healthcare Terminology, Public Healthcare Maintenance, and Medical Devices

3. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Service Oriented Device Architecture Standardize and simplify integration of devices with the Enterprise Leverage existing standards in embedded and I/T domains to provide well defined interfaces for hardware devices Allow developers to interact with sensors and actuators like business services in an SOA sense

4. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. The SODA Stack SOA Binding Framework Device Services: Industry Standards ECLIPSE-Based Tooling with OSGI Programming Model Support Device Interfaces: Proprietary and Industry Standards ESB or Other SOA Mechanism Device Interface and Protocol Adapters Agents: Device and Scenario Specific Logic Application Code Device Service Generic Device Service Enterprise Adapter Service OSGi Framework

5. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Representational State Transfer (REST) Key set of architectural constraints  Universal Identifiers for Resources (URI)‏  Uniform Interface for interactions  GET, PUT, POST, DELETE GET, PUT, and DELETE are idempontent GET is cachable HTTP as the application protocol

6. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Why REST Simplicity Small footprint  OSGi HttpService  Scale to contrained environments Aligns well with hosted web UI capabilties that were planned for in-home control Provides another approach to interfacing with SODA devices

7. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. The Thermostat API Integrating a new http-based thermostat device Current Temperature  /Device/Thermostat/{ThermostatId}/Reading  Get Current Mode  /Device/Thermostat/{ThermostatId}/Mode  Get, Put Current Setting  /Device/Thermostat/{ThermostatId}/Setting  Get, Put Current Status  /Device/Thermostat/{ThermostatId}/Status  Get

8. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Controlling the Home HTML and JavaScript web pages to control devices Leverage Ajax toolkits (eg. Dojo)‏ UI bundles in OSGi Built on existing Stepstone edge architecture Broad OSGi™ platform support (Windows™, Linux®, Mac OS X™, etc)‏

9. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Device Kit (DK)‏ Device Layer –Provides an interface to the hardware device –Understands the meaning of messages Transport Layer –Parses input bytes into valid messages –Understands the format of messages Connection Layer –Supports the reading and writing of byte streams to the hardware device

10. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Device Kit Concepts Commands  A request to the hardware device Measurements  A property, attribute, or observed value on the hardware device Signals  A report or notification from the hardware device

11. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Mapping Device Kit Concepts to REST POST commands to a device URI GET/PUT measurements from a device URI Subscribe and Unsubscribe from signal feeds  Where do we store the data?  Edge: Depends on your requirements and environment  Backend: Atom Publishing Protocol on the backend Building the URI space  Too Many Parameters  Device type, Device Id, Unit Id/Context Id/Patient Id, Sender/Receiver Identification, Parameter Name/Content Type, Parameter Value/Payload, Timestamp

12. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Closing & Next steps Provided a simple approach to enabling a REST style web service for devices Apply these principles to other areas of SODA and Stepstone ATOM feeds and the Atom Publishing Protocol (APP)‏  Mashups http://www.eclipse.org/ohf/components/soda

13. Copyright © IBM Corp., 2007-2008. All rights reserved. The presentation is licensed under Creative Commons Att. Nc Nd 2.5 license. Legal Notices IBM and the IBM logo are trademarks or registered trademarks of IBM Corporation, in the United States, other countries or both. Java and all Java-based marks, among others, are trademarks or registered trademarks of Sun Microsystems in the United States, other countries or both. Eclipse and the Eclipse logo are trademarks of Eclipse Foundation, Inc. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Mac and Mac OS X are trademarks of Apple Inc, registered in the United States and other countries. Linux® is the registered trademark of Linus Torvalds in the United States and other countries. OSGi is a trademark or a registered trademark of the OSGi Alliance in the United States, other countries, or both. Other company, product and service names may be trademarks or service marks of others. THE INFORMATION DISCUSSED IN THIS PRESENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION, IT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, AND IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, SUCH INFORMATION. ANY INFORMATION CONCERNING IBM'S PRODUCT PLANS OR STRATEGY IS SUBJECT TO CHANGE BY IBM WITHOUT NOTICE.