Developer:Documentation

Developer Documentation

The open nature of Linn's DS products allow any interested party to write their own application and interact with the DS. The following pages document the interfaces the DS exposes.

Compatibility Islands

DS releases are cateogrised by the name of a Scottish island. Any DS software release described by the same island is interface compatible. This means that properly written applications written against that island will work across all releases of that island. More information is available here: Software Compatibility Families

Existing Islands

• Cara Documentation
• Bute Documentation
• Auskerry Documentation

Develoment Releases

Prior to the full release of a new island, Linn provides development releases to allow external developers to update their applications to work with the new interfaces. Development releases are for developers, not early adopters. Although they are feature complete, there are still a number of bugs, some of them potentially bad.

• Development releases can be downloaded from: http://products.linn.co.uk/VersionInfo/Downloads/Development/
• Developers should report defects via the products trac database: http://products.linn.co.uk/trac/
• Questions, comments, and concerns should be raised in the development forum: http://forums.linn.co.uk/bb/forumdisplay.php?fid=5
• A considerable amount of BSD licensed source code is available for reuse and/or sample code on Linn's Open Source Software site: http://oss.linn.co.uk/

The easiest way to upgrade your device(s) to the latest development firmware is to download the development ConfigApp, and enable the 'Show Development Releases' option (Tools->Options->Updates, 'Show Advanced Options' must also be enabled). If you then right click on your device, you will be given the option to Update to the latest development firmware.

Miscellaneous Links

• UPnP architecture primer - http://oss.linn.co.uk/trac/wiki/UPnP
• Kinsky open source UPnP Library - http://oss.linn.co.uk/trac/wiki/UpnpDevelopment
• UPnP protocol - http://www.upnp.org
  • Generic UPnP device architecture spec http://www.upnp.org/specs/arch/UPnP-DeviceArchitecture-v1.0.pdf
  • UPnP AV Media Renderer specification http://www.upnp.org/specs/av/
  • V1.0 MediaServer and MediaRenderer standards http://www.upnp.org/standardizeddcps/mediaserver.asp
• Linn UPnP Media service - http://oss.linn.co.uk/trac/wiki/LinnMediaService
• Simple Point-to-Point Control protocol - LPEC (Linn Protocol for Eventing and Control)
• Device Diagnostics - Developer:Diagnostics
• DS Audio transport protocol - Developer:Audio Transport