Apparatus and method for UPnP device code generation using XML

• US 7,017,148 B2
• Filed: 07/10/2001
• Issued: 03/21/2006
• Est. Priority Date: 07/10/2001
• Status: Expired due to Fees

• Current Assignee: Intel Corporation
• Original Assignee: Intel Corporation
• Inventors: Kumar, Murari
• Primary Examiner(s): Dam, Tuan
• Assistant Examiner(s): CHOW, CHIH CHING
• Application Number:
  US09/903,019
• Publication Number:
  US 20030093769A1
• Time in Patent Office: 1,715 Days
• Field of Search: 717/168, 717/174, 717120-123, 717/140, 703/223, 709/227, 709/220, 709/223, 709/224, 707/10, 714/4, 710/8, 710/10, 710/15
• US Class Current: 717/114
• CPC Class Codes: G06F 8/30 Creation or generation of source code
• CPC Class Codes: H04L 12/281 indicating a format for calling an appliance service function in a home automation network for remote control or remote monitoring of applications H04L67/025

Abstract

An apparatus and method for UPnP device code generation using XML are described. The method includes receiving a UPnP device description document from a device developer. Once received, one or more service control class files are generated, including one or more service control stub-methods. Next, the service control class files are received, including updated service control stub-methods. The updated stub-methods are modified by the device developer in order to respond to actions received by a UPnP device described by the UPnP device description document. Finally, the service control class files and the updated service control stub-methods, along with a device class library and a UPnP SDK are compiled to generate a device executable for the UPnP device described by the UPnP device description document.

Claims

1. A computer implemented method comprising:

generating one or more service control class files including one or more service control stub-methods according to a UPnP device description document received from a device vendor;

receiving the service control class files including the service control stub-methods updated by the device vendor for responding to actions and events received by a UPnP device described by the UPnP device description document; and

compiling the service control class files and the updated service control stub-methods along with a device class library and a UPnP software development kit to generate a UPnP device executable to provide an implementation of a UPnP network protocol for the UPnP device described by the UPnP device description document.

2. The computer implemented method of claim 1, wherein generating the service control class files further comprises:

parsing the UPnP device description document to determine a root device including one or more services and one or more embedded devices each including one or more services, each service defined by a service control protocol description (SCPD) file;

generating a service control class file for each of the one or more services of the root device;

selecting an embedded device from the one or more embedded devices of the root device;

generating a service control class file for each of the one or more services of the selected embedded device;

repeating the generating and selecting for each of the one or more embedded devices of the root device; and

once each of the service control class files are generated, generating a class service linker file based on the generated service control class files, the class service file linker enabling linking the service control class files during compiling to generate the device executable.

3. The computer implemented method of claim 2, further comprising:

generating a root directory for the root device;

storing each of the one or more services of the root device within the root directory;

selecting an embedded device from the one or more embedded devices of the root device;

generating a sub-root directory for the selected embedded device;

storing each of the one or more services of the selected embedded device within the sub-root directory; and

repeating generating and storing for each of the one or more embedded devices of the root device.

4. The computer implemented method of claim 2, wherein generating service control class files for the root device further comprises:

selecting a service from the one or more services of the root device;

generating a class generator object for the selected service of the root device;

passing an SCPD file describing the selected service, including a device identification code of the root device and a service identification of the selected service to the class generator object;

generating, by the class generator object, a service control class file based on the received SCPD file, the service identification code and the device identification code;

generating a header file corresponding to the generated service control class file and the SCPD file;

once generated, destroying the class generator object; and

repeating the selecting, generating, passing, generating and destroying for each of the one or more services of the root device.

5. The computer implemented method of claim 2, wherein generating service control class files for the selected embedded device further comprises:

selecting a service from the one or more services of the selected embedded device;

generating a class generator object for the selected service of the selected embedded device;

passing an SCPD file describing the selected service, including a device identification code of the selected embedded device and a service identification code of the selected service to the class generator object;

generating, by the class generator object, a service control class file based on the received SCPD file, the service identification code and the device identification code;

generating a header file corresponding to the generated service control class file and the SCPD file;

once generated, destroying the class generator object; and

repeating the selecting, generating, passing, generating and destroying for each of the one or more services of the selected embedded device.

6. The computer implemented method of claim 2, wherein generating the service linker class file further comprises:

generating a class service linker object;

storing class information regarding each generated service control class file within a service table of the class service linker object;

generating, by the class service linker object, the class service linker file based on the service table; and

destroying the class service linker object.

7. The computer implemented method of claim 1, wherein receiving the service control class files further comprises:

displaying the one or more service control stub-methods to the device vendor;

receiving code from the device vendor for implementing the one or more service control stub-methods for responding to actions and events received by the UPnP device; and

once the code is received, storing the received code within the one or more corresponding service control stub-methods.

8. The computer implemented method of claim 1, further comprising:

executing the device executable;

creating an instance of the root device and each of the one or more services of the root device;

creating an instance of each embedded device and each of the one or more services of the respective embedded device;

organizing the root device and embedded devices, as well as the services of the root device and the embedded devices within a tree hierarchy based on the device description document to form a device object tree; and

registering the root device and the one or more embedded device within the device object tree with the device class library to enable receipt of events for the services of the root device and the services of the one or more registered embedding devices.

9. The computer implemented method of claim 8, wherein registering the root device and one or more embedded devices further comprises:

registering an event listener object of the device class library with the UPnP software development kit to enable receipt of action and event requests received/generated by one or more control points of the UPnP device;

registering the root device and one or more embedded devices with the event listener object;

receiving, by the event listener object, a respective action/event request from a control point;

finding a service object for response to the respective action request using a received device identification code and service identification code;

once the service object is found, invoking a callback function of the service object to determine an appropriate action method to execute in response to the respective action request;

executing the appropriate action method; and

once the action method is processed, setting an event object with a response string that is received by the control point.

10. A computer readable storage medium including program instructions that direct a computer to function in a specified manner when executed by a processor, the program instructions comprising:

generating one or more service control class files including one or more service control stub-method according to a UPnP device description document received from a device vendor;

receiving the service control class files including the service control stub-methods updated by the device vendor for responding to actions and events received by a UPnP device described by the UPnP device description document; and

compiling the service control class files and the updated service control stub-methods along with a device class library and a UPnP software development kit to generate a UPnP device executable to provide an implementation of a UPnP network protocol for the UPnP device.

11. The computer readable storage medium of claim 10, wherein generating the service control class files further comprises:

parsing the UPnP device description document to determine a root device including one or more services and one or more embedded device each including one or more services, each service defined by a service control protocol description (SCPD) file;

generating a service control class file for each of the one or more services of the root device;

selecting an embedded device from the one or more embedded devices of the root device;

generating a service control class file for each of the one or more services of the selected embedded device;

repeating the generating and selecting for each of the one or more embedded devices of the root device; and

once each of the service control class files are generated, generating a class service linker class file based on the generated service control class files, the class service linker file enabling linking the service control class files during compiling to generate the device executable.

12. The computer readable storage medium of claim 11, further comprising:

generating a root directory for the root device;

storing each of the one or more services of the root device within the root directory;

selecting an embedded device from the one or more embedded devices of the root device;

generating a sub-root directory for the selected embedded device;

storing each of the one or more services of the selected embedded device within the sub-root directory; and

repeating generating and storing for each of the one or more embedded devices of the root device.

13. The computer readable storage medium of claim 11, wherein generating service control class files for the root device further comprises:

selecting a service from the one or more services of the root device;

generating a class generator object for the selected service of the root device;

passing an SCPD file describing the selected service, including a device identification code of the root device and a service identification of the selected service to the class generator object;

generating, by the class generator object, a service control class file based on the received SCPD file, the service identification code and the device identification code;

generating a header file corresponding to the generated service control class file and the SCPD file;

once generated, destroying the class generator object; and

repeating the selecting, generating, passing, generating and destroying for each of the one or more services of the root device.

14. The computer readable storage medium of claim 11, wherein generating service control class files for the selected embedded device further comprises:

selecting a service from the one or more services of the selected embedded device;

generating a class generator object for the selected service of the selected embedded device;

passing an SCPD file describing the selected service, including a device identification code of the selected embedded device and a service identification code of the selected service to the class generator object;

generating, by the class generator object, a service control class file based on the received SCPD file, the service identification and the device identification;

generating a header file corresponding to the generated service control class file and the SCPD file;

once generated, destroying the class generator object; and

repeating the selecting, generating, passing, generating and destroying for each of the one or more services of the selected embedded device.

15. The computer readable storage medium of claim 11, wherein generating the service linker class file further comprises:

generating a class service linker object;

storing class information regarding each generated service control class file within a service table of the class service linker object;

generating, by the class service linker object, the service class linker file based on the service table; and

destroying the class service linker object.

16. The computer readable storage medium of claim 10, wherein receiving the service control class files further comprises:

displaying the one or more service control stub-methods to the device vendor;

receiving code from the device vendor for implementing the one or more service control stub-methods for responding to actions and events received by the UPnP device; and

once the code is received, storing the received code within the one or more corresponding service control stub-methods.

17. The computer readable storage medium of claim 10, further comprises:

executing the device executable;

creating an instance of the root device and each of the one or more services of the root device;

creating an instance of each embedded device and each of the one or more services of the respective embedded device;

organizing the root device and embedded devices, as well as the services of the root device and the embedded devices within a tree hierarchy based on the device description document to form a device object tree; and

registering the root device and one or more embedded devices of the device object tree with the device class library to enable receipt of actions/events for the one or more services of the root device and the one or more services of the one or more registered embedded devices.

18. The computer readable storage medium of claim 17, wherein registering the root device and one or more embedded devices further comprises:

registering an event listener object of the device class library with the UPnP software development kit to enable receipt of action and event requests received/generated by one or more control points of the UPnP device;

registering the root device and one or more embedded devices with the event listener object;

receiving, by the event listener object, a respective action/event request from a control point;

finding a service object for response to the respective action request using a received device identification code and service identification code;

once the service object is found, invoking a callback function of the service object to determine an appropriate action method to execute in response to the respective action request;

executing the appropriate action method; and

once the action method is processed, setting an event object with a response string that is received by the control point.

19. A system, comprising:

a processor having circuitry to execute instructions;

a communications interface coupled to the processor, the communications interface to advertise services to a control point, provide device description to the control point, provide service description for each service to the control point, to receive action/event requests from the control point and to publish updates during state changes in response to received action/event requests; and

a storage device coupled to the processor, having sequences of instructions stored therein, which when executed by the processor cause the processor to;

receive service control class files including service control stub-methods updated by a device vendor for responding to actions and events received by a UPnP device described by a UPnP device description document,

compile the service control class files and the updated service control stub-methods along with a device class library and a UPnP software development kit to generate a UPnP device executable to provide an implementation of a UPnP network protocol for the UPnP device described by the UPnP device description document, and

execute the UPnP device executable to enable response to actions/events received by the UPnP device.

20. The system of claim 19, wherein the instruction to execute the device executable further causes the processor to:

create an instance of a root device and each of one or more services of the root device;

create an instance of each embedded device of the root device and each of one or more services of a respective embedded device;

organize the root device and embedded devices, as well as the services of the root device and the embedded devices within a tree hierarchy based on the device description document to form a device object tree;

register the device object tree with the device class library to enable receipt of actions/events for the services or the root device and the service, of the embedded devices; and

register an event listener class of the device class library with the UPnP software developing kit to receive action/event requests from one or more control points of the UPnP device that are forwarded to service objects within the device object tree.

21. The system of claim 19, comprising:

one or more root devices, each including one or more services for responding to actions and events received by the respective root device, and one or more embedded devices including one or more services to respond to actions and events received by a respective embedded device.

22. The system of claim 20, wherein the processor is further caused to:

receive the UPnP device description document from the device vendor,

generate one or more service control class files including one or more service control stub-methods based on the UPnP device description document and one or more service control protocol description files listed within the UPnP device description document, and

provide the service control class files including service control stub-methods to the device developer in order to receive updated service control stub-methods including code for responding to actions and events received by a UPnP device described by the UPnP device description document.

23. A computer implemented method comprising:

generating at least one service control class file including at least one service control stub-method according to a UPnP description document received from a device vendor, and

generating a UPnP device executable for a UPnP device described by the UPnP description document, wherein the device executable to provide an implementation of a UPnP network protocol for the UPnP device.

24. The computer implemented method of claim 23 wherein generating the device executable further comprises:

receiving the service control class files including the service control stub-methods updated by the device vendor for responding to actions and events received by the UPnP device described by the UPnP device description document; and

compiling the service control class files and the updated service control stub-methods along with a device class library and a UPnP software development kit to generate the UPnP device executable.

25. The computer implemented method of claim 23, wherein generating the service control class file further comprises:

displaying the service control stub-method to the device vendor;

receiving code from the device vendor for implementing the service control stub-method for responding to actions and events received by the UPnP device; and

scoring the code received from the device vendor within the service control stub-method.

26. A computer implemented method comprising:

displaying, to a device vendor, at least one service control stub-method of at least one service control class file generated according to a UPnP device description document received from the device vendor; and

compiling the service control class files and the service control stub-methods updated by the device vendor along with a device class library and a UPnP software development kit to generate a UPnP device executable to provide an implementation of a UPnP network protocol for the UPnP device.

27. The computer implemented method of claim 26, wherein displaying the at least one service control stub-method further comprises:

receiving code from the device vendor for implementing the service control stub-method for responding to actions and events received by the UPnP device; and

storing the updated code received from the device vendor within the service control stub-method.

28. The computer implemented method of claim 26, wherein display further comprises:

receiving the UPnP device description document from the device developer; and

generating one or more service control class files including one or more service control stub-methods according to the UPnP device description document received from the device vendor.