Envisalink 2DS - TPI Documentation

[GrandWizard]

Here is the TPI (API) document for the Envisalink 2DS.

[SecurityBuff]

Hi,

Can anyone offer a little direction on how to get started with using the TPI documentation?

*recommended programming language to use
*how to calculate the checksum? (36 + 35 + 34 + 33 = D2)
*is there a terminal program one can use to test the commands?

Any example code would be very helpful.

ie login.
*envisalink:4025 005 pass chksumCR/LF


Thank you.

[nlmike]

Can anyone offer a little direction on how to get started with using the TPI documentation?

*recommended programming language to use
*how to calculate the checksum? (36 + 35 + 34 + 33 = D2)

I attached a simple Perl script that you can use to generate commands with checksums.

Example use, assuming that your password is "passwd". It returns the login command including the checksum.
> ./getChecksumUtil.pl 005passwd
005passwd27

Another example: the "Poll" command "000":
> ./getChecksumUtil.pl 000
00090

*is there a terminal program one can use to test the commands?

I use "nc" in Linux. Example assuming that the IP of the 2DS is "192.168.1.5":
> nc -C 192.168.1.5 4025

I hope this helps,
mike

[Jsalinger]

Hi,

Can anyone offer a little direction on how to get started with using the TPI documentation?

*recommended programming language to use
*how to calculate the checksum? (36 + 35 + 34 + 33 = D2)
*is there a terminal program one can use to test the commands?

Any example code would be very helpful.

ie login.
*envisalink:4025 005 pass chksumCR/LF


Thank you.

Hi SecurityBuff,

I was a member of the beta for the TPI, and I have been working on an open-source Android app for the 2DS for a little over a month. This is just a hobby for me, so I have been hoping others who are interested might want to get involved with and help improve the project.

Even if you do not have expertise in Java/Android development, you might be interested in giving my google code site a look:

https://code.google.com/p/homewatcher/

It contains my work-in-progress source code and an APK (Android application file) for what I've built so far.

-Jsalinger

[metamatt]

Is this thread a good place to post questions/clarifications about the docs?

I was able to get a test app working without a whole lot of trouble, but it would have been much easier if the intro section had said that *I* send the envisalink the commands in section 3.2 ("application commands"), and the envisalink sends back the commands in section 3.3 ("TPI commands"), both in direct reply to the application commands and also asynchronously due to system events.

It's the kind of thing where once you know it it's obvious, but the docs don't make it obvious enough, and when you're just starting out and reading docs you by definition don't already know this.

[metamatt]

For those looking for sample code, here's a little snippet of Python I've been playing with.

It's basically just a monitor -- it logs in, listens for events generated by the system, and prints them out -- it also sends the poll command every 10 seconds to make sure the connection is still alive.

[pauliep]

I, too, would like some help. I have an ISY-994i and the 2DS. I have trolled the posts here and in the Universal Devices forums. Seems that Michel from UD indicates the ISY will not work with the DS2 as it requires a persistent socket connection which is not possible at this time.

Has anyone figured out a work-around for this?

Also, how do I initiate a TCP socket with the 2DS? I can's seem to do it.

Finally, I am using a Mac.

Paul

[GrandWizard]

Here is a link from the Universal Devices forum. The '2DS is now supported through the DSCLink software.

http://forum.universal-devices.com/view ... =58&t=8800