Difference between revisions of "Telnet Interface"

From Hubitat Documentation
Jump to: navigation, search
Line 5: Line 5:
  
 
===Hubitat Provided Methods===
 
===Hubitat Provided Methods===
 +
 +
== <code>telnetConnect</code> ==
 +
 +
'''Signature'''
 
void telnetConnect(Map options, String ip, int port, String username, String password)
 
void telnetConnect(Map options, String ip, int port, String username, String password)
  

Revision as of 16:47, 27 December 2018

Overview

You are able to open and maintain a connection to a telnet endpoint from the hub. All code needs to be contained in a driver, there is not option to open a telnet connection from an app. Hubitat provides methods to connect and disconnect to the endpoint, in addition you will need to create a method in the driver that accepts incoming messages (parse) and another method that will be called with any status updates for the endpoint (telnetStatus).

Methods

Hubitat Provided Methods

telnetConnect

Signature void telnetConnect(Map options, String ip, int port, String username, String password)

ip - The IP Address of the endpoint you want to connect to

port - The port number of the endpoint, typically 23 for telnet interfaces

username - The username to use to log in, pass null if no username is required

password - The password to use to log in, pass null if no password is required

options - The options to use when connecting to the telnet interface.

void telnetConnect(String ip, int port, String username, String password)

ip - The IP Address of the endpoint you want to connect to

port - The port number of the endpoint, typically 23 for telnet interfaces

username - The username to use to log in, pass null if no username is required

password - The password to use to log in, pass null if no password is required

void telnetClose()

User defined methods

parse(String message) - This method is called with any incoming messages from the telnet endpoint. This is a standard method for drivers.

telnetStatus(String message) - This method is called with any status messages from the telnet connection (disconnections, errors during connect, etc)