Proxy service

1. Proxy service

The proxy service is a new feature which allows you to connect multiple devices through one dedicated device to you Domintell installation using one DETH02 module.

Note: This is an experimental feature. The Domintell supported way to connect multiple devices to the Domintell Master at the same time is to use multiple DETH02 modules. For maximal performance and reliability I suggest to use the Domintell supported way, however the proxy service might be a working solution also.

Above a simple topology draw about how the proxy service is working. If you would like to use this feature, you have to dedicate one device to be a proxy server in your house. This could be – practically – a tablet device, which is kept most of the time in the reach of your home Wifi network, and could always be connected to your Domintell installation. All other devices will connect to this proxy server instead of the Domintell installation, and this proxy server will share the Domintell connection between other devices.

Important: this feature should work not only with domRemote, but also with other software, so for example with iDomintell for iPhone/iPad also! Just you have to configure the connection properly!

So the version 1.1.11 is out with this feature enabled. To use this feature, you need an active Wifi connection on your device. Then you can enable the proxy feature in the settings. You should see your device IP address under Proxy IP address: Please note this IP as this is the IP you have to enter on this and all other devices in the LAN profile for Domintell connection! In Domintell device IP and Domintell device port you have to put the IP and Port of your DETH02, as now the proxy service will connect to your DETH02 and not the software itself (the Proxy service is a background agent).  There is one more option, Proxy service port, it has a default 5555, I suggest to leave it this way, but this is the port number where the proxy service listens for incoming connections. The proxy service uses UDP as communication protocol like the DETH02 does.

So after you set up successfully the proxy service, exit the settings. The proxy service should start up in a few seconds, and you should see it in your notification bar, like this:

If you click the notification, a proxy service control window opens, where you can control and get information about the proxy service.

In the first line you see the status of your proxy service. If it is connected to the DETH02 or not (in my example it is disconnected, but you should read connected!). If something is wrong with the proxy service you can restart it with “Restart proxy service” button. If the proxy service disconnects for some reason from DETH02, you can force a reconnection with the “Reconnect Domintell device” button. The proxy service caches the Module list to get a quick access for clients, but if your hardware configuration changes, you can force a Module List query using the “Refresh APPINFO cache” button. The proxy service also caches the states of each device, but with the “Refresh STATE cache” button you can always force to refresh its state.

In the “List of proxy clients and last activity” you will see the list of connected clients and a time stamp when they had last time conversation with the Proxy service.

Now if you managed to start up correctly the Proxy service, you have to configure your clients to connect the proxy service instead of the DETH02. Important, that you can use domRemote on the proxy device the same way as on the others!

To set up connection go back to domRemote, and go into the settings. Then choose “Domintell device settings” option, and then set up the LAN profile like this:

In the IP/Host field enter the IP address you have noted in the”Proxy IP address”field!

In the Port field enter the Port number you set up in the”Proxy service port” field (default is 5555)!

Now you should be able to connect to the Proxy service running on your device. To connect from an other device, follow exactly the same steps described above. To connect from an other software (eg. Apple iThing software), set up the connection data like described above (DETH02 IP should be the IP address of the Proxy service, and the DETH02 port should be the Proxy service port). It’s been tested with iDomintell from an iPad, and it worked parallel with two other Android devices 🙂

Important things:

  1. Use static IP address (or fixed DHCP address) for your Proxy device to avoid IP address change!
  2. Do not use exclusive session mode in your DETH02!
  3. Do not set up a connection time-out in your DETH02 (set connection time-out to ZERO in your DETH02 configuration)!
  4. Do not connect directly to your DETH02 from any other devices, as it will terminate connection between the DETH02 and the Proxy service! Use connection through the Proxy service!
  5. Place the Proxy device to a place where your Wifi connection strength is at or at least near maximal strength! As UDP protocol is not a guaranteed transfer protocol, package loss might occur, but you can lower the possibility with proper connection signal strength.
  6. Note, that this is an experimental feature yet!

Using connection through proxy service from 3G (Internet):

If you would like to connect to your DETH02 from the Internet (3G, external Wifi, etc), you should set up your firewall to forward the incoming traffic to the proxy service IP address and Port, so incoming Internet traffic will also go through the Proxy service!

  1. May 3rd, 2012

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: