Developer:LPEC

From LinnDocs
Revision as of 09:50, 17 June 2008 by Grahamd (talk | contribs)
Jump to: navigation, search

Introduction

Linn's UPnP products can be controlled over a home network in an ever increaing number of ways. The primary means of control is, of course, UPnP itself, which subdivides product control into smaller units called services. A DS product, for instance, will provide some standard UPnP AV services:


  • AVTransport
  • RenderingControl
  • ConnectionManager


and additional Linn-specific services, such as:


  • Ds
  • Volkano
  • Product
  • Ui


It is possible in Bute and later software releases to control a Linn UPnP product using an alternative mechanism known as the Linn Protocol for Eventing and Control.


This is a basic Telnet-like protocol, which relies on the developer knowing in advance, or having discovered by some means, the TCP/IP of the device to be controlled. Knowing this, LPEC can be accessed by creating a raw socket session to port 23 of the device.


The rest of this document describes the format of the messages that LPEC expects and delivers.


Control

Each service contains actions that can be performed. Thes are like methods that can be called on the device with input and output arguments.

An action can be perfomed on a device by sending the following message:


ACTION [id]/[type] [version] [action] "[inarg1]" "[inarg2]" ... "[inargn]"

e.g.

ACTION MediaRenderer/AVTransport 1 SetAVTransportURI "0" "http://192.168.0.1/Abba/Dancing Queen.mp3" ""

Eventing

Discovery