This page last changed on Feb 28, 2011 by kide.


The Telnet documentation for sensor readings etc. draft has been completed and i would like to get some comments on review.

OpenRemote 2.0 HowTo - Telnet Interfaces

Please shoot if anything seems off


Hey Ernst,

Great job on the Telnet docs; it will be nice to see a complete set of similar guides for the other protocols eventually just to make it easier for the newbies to get going.


Posted by kurrazyman at Mar 10, 2011 18:40

Good to hear that we are getting somewhere

Rich: if you do your socket thing like you did with telnet i'll be more than happy to document it!


Posted by kide at Mar 11, 2011 10:29


I have looked at the telnet Documentation and have the following question.

Using Telnet I want to  sends a request to the server and the server responds. There are no client messages sent to the server that do not generate a reply from the server. These messages confirm

that the message has been received corectly and that the command has been caried out. In the case of an "ON" command the return message confirmes that the switch has been turned on.

In the Documentation you show 2 methods for receiving Status Feedback. I would presume that

the return response from the server should use one of thes methods.

Do I have to send a request status command after I send an on command?


Posted by pjmm at Mar 18, 2011 16:19

My two corrections have not been done.
There is at least one more typo-spelling error.

Posted by filipc at Mar 18, 2011 17:35

Hi Pierce,

I think i get the picture here let me draw a sitation and tell me if this is correct

set volume 50%
volume set to 50% <--------- This would be your feedback directly

So there is no way to request what the value of "volume" is without issuing a command?

Could you explain your application why and how you would want to use this?

Posted by kide at Mar 19, 2011 07:18

thank you for pointing out the typo's, they have been corrected. 

Posted by kide at Mar 19, 2011 07:21

Hi Ernst

I currently use Home Control Assistant (HCA) which is a Windows based home automation program

this program has an interface which works over Telnet/TCPIP.

All communication is in text format over a standard IP connection the first message you need to send is

HCA0002010000001 the HCA server validates this message and send back HCA0102010000001.

If the HCA server has a problem with the message bit 4 will be 1 instead of 0.

Once the connection has been successful you can then start sending commands to HCA which are in the following format all messages receive a reply from the server

Client sends

<!-- @page

Unknown macro: { margin}
Unknown macro: { margin-bottom}

<preamble><4 spaces><data>

The preamble tels HCA the length and number of parameters in the message

003700550076007700780079    HCAObjectDevice.RockerPressBedroom - Bath Lights000

Each command sent to the server generates a reply. This could be a short error if the command can't be processed because of the format etc,

0012 -100

(there are 5 different types of errors represented by -100.-102,-103,-104 and -105)

or if the message can be processed, then the server returns:

An example:

0 HCAObject HCADevice.RockerPress 0

This is the return message reporting that the command worked.

If the command did not work it would not start with a "0"

This is how I would like to  use OpenRemote using Telnet to comunicate.

Any help you can give me would be appriciated.

One other question when I make a telnet connection to HCA Openremote closes it after sending a command How do I keep the connrction Active?


Posted by pjmm at Mar 19, 2011 13:59


I have tried to use the telnet function trying to connect to 2 different applications.

I can conect and send one command the telnet sesion then disconects I can reconect

again and send one command.

I tested on 2 different aplications which use telnet and the both disconect after sending the command from


I tested both aplications using Putty and both work without disconecting.

Any Help would be appriciated


Posted by pjmm at Mar 20, 2011 19:36


That is the way OpenRemote works at present; it connects -> send/read command -> and disconnects.

I have developed a Connection Manager for OpenRemote that allows a permanent connection to be made but this isn't in the main trunk as of yet and is still in development.

Do you need the connection to stay alive for your application?


Posted by kurrazyman at Mar 20, 2011 20:12

Hi Rich

yes i need the conection to stay open.

Is it possable to get a copy of your development

If you look at my post above you will see what I am trying to do


Posted by pjmm at Mar 20, 2011 20:23

There are quite a few differences in how my branch works from the current controller, you need to manually change the controller.xml, which would need some explanation/documentation that I haven't yet written. The details of how/if my code makes it into the main branch need to be ironed out with Juha.

Hopefully over the next few weeks a more usable version of my branch will become available for you to try out.

I will keep you posted.


Posted by kurrazyman at Mar 20, 2011 21:15

Hi Rich

many thanks for that info I look forward to receiving your update when it is available


Posted by pjmm at Mar 20, 2011 21:28


If you still have a need for a permanent connection to your telnet server then I have a made my connection manager branch available and you shouldn't have to make any changes to the controller.xml (unless you want to); have a look at this post I have written: -

Posted by kurrazyman at Mar 27, 2011 23:03

Hi Richard

have you any update on when your code will make it into the main branch


Posted by pjmm at Apr 18, 2011 21:11

Hi Pierce,

I'm a bit out of the loop as to what the plans are with Open Remote and last I heard from Juha he was doing some heavy changes to the controller model and I can't really work on code until I know what the state of play is.

The work I have done was simply to help me get Open Remote working for my requirements and there's still lots to be done, just need to make sure everyone is pulling in the same direction.

I don't know what the next major release of Open Remote has in store but there is talk of event handling and scripting (I have implemented a basic form of command scripting into my branch but a more general solution is needed)....Like any open source project, communication is key, maybe Juha would be willing to put a road map on the forums....

In the meantime if you have a particular requirement that my code can help with then I'd be happy to help you with that; my code now supports HTTP (GET and POST requests), UDP and of course telnet.


Posted by kurrazyman at Apr 18, 2011 21:36

Hi Richard

mamy thanks for your prompt responce. I note from your post that your code supports HTTP get requests.
Is it possable that your code can talk to Yamaha RX-V3900 over TCPIP.

It would realy help if this was the case.
If you Google "RX-V3900_Z7_ETHERNET_IF_Spec_e_1.0" you can download the documentation



Posted by pjmm at Apr 18, 2011 22:14
Document generated by Confluence on Jun 05, 2016 09:32