From OpenHome

---

Revision as of 11:23, 12 December 2011

Contents 1 What is it? 2 How do I get it? 3 Developers 3.1 Overview docs 3.2 API docs 3.3 Discussion

What is it?

ohNet is a modern, cross platform UPnP stack. ohNet includes both a control point and a device stack that can be used together or independently. It runs on Linux, Windows, Mac, iOS and Android. The public APIs are available for the device and control point stacks in C++, C#, Java, C. There is an JavaScript api for the control point stack.

UPnP services are presented as classes with actions appearing as functions and state variables appearing as member variables. These classes are referred to as proxies for users of the control point stack and providers for users of the device stack.

Proxies and Providers are included for all OpenHome and UPnP AV services. If your application uses other services, ohNet includes a tool (ohNetGen) to generate proxies and/or providers from the service XML in any of the supported languages.

Source code is available under a Simplified BSD license.

How do I get it?

ohNet is available as source code from https://github.com/openhome/ohNet.

Setup a (free) github account then

 git clone git@github.com:openhome/ohNet.git ohnet

build using

 cd ohnet
 make

There are also binaries available for certain popular platforms/architectures. See http://www.openhome.org/releases/artifacts/ohNet.

Developers

Overview docs

• Control Point stack (PDF)
• Device stack (PDF)

API docs

• C++
• C#
• Java
• JavaScript
• C

Discussion

Developer forum

ohNet is written using C++ with std::string replaced by special buffer classes. These buffer classes allow for more efficient use of memory at the cost of a steeper learning curve. Memory use benefits can be especially pronounced for the Device stack. API docs for this version of the stack are available but the buffer classes are intended for internal use of the library and are as such currently undocumented.