ASCOM driver allowing to open a roll off roof with an IPX800 v2, an IPX800 v3 or IPX800 v4.

It allows the opening of any roof whose opening can be triggered by the activation of a relay (e.g. garage door or portal opening system, ...).

IPX800 v3
IPX800 v2
  • Microsoft .NET Framework 4 or above
  • Plateform ASCOM 6.2 or above

configuration dialog

IPX800 settings

IPX800 version

Version of the IPX800: version 2, version 3 or version 4

Protocol

The IPX800 can be controlled using two protocols: M2M (Machine to Machine) or HTTP (equivalent to a control by the web interface).

Note: In case of use of an X880 extension and a firmware version older than v3.05.46 it's recommended to use the HTTP protocol; the extensions do not always react properly to the M2M commands with older version.

IP address and port

IP address and port of the IPX800.

The default port numbers are: 9870 for M2M protocol and 80 for the HTTP protocol.

User and password

The user and password configured to access the web interface of IPX800.

When using the M2M protocol, the password is only required if the firmware version is 5.3.46 or higher.

Relay settings

Relays

These parameters define the behavior of the relay that have to be activated to trigger the opening and closing of the roof.

For each action, "open" and "close", specify the relay number to activate. If configured in pulse mode (from the IPX800 web interface) check the box. If this is not the case it is necessary to indicate the period during which the relay has to be activated.

In the case of an IPX800 v4, it is possible to select a virtual output.

Open/close timeout

If one of the relays is configured in pulse mode, the time required to open / close the roof must be configured. It is recommended to specify a value slightly higher than the actual duration.

Abort mode

The abort mode allows to configure the behavior of the ASCOM Abort Slew functionality. The role of this function is to interrupt the roof slew. Three values are possible:

Not supported: this is the option to select if your system does not allow interruption. The call of ASCOM AbortSlew function will have no effect.

Open relay: Select this option if the interruption of the roof slew can be done by opening the relay.

Close relay: Select this option if the interruption of the roof slew can be done by closing the relay. This is for example the case for some garage door or portal opening system...

Sensors settings

Open/close sensor

The driver allows to use sensors (e.g. magnetic sensor) to identify the roof position (open or closed). If you use such detectors, check the boxes and indicate on which entries of IPX800 they are connected.

Security sensor

You can use an entry in the IPX800 as a safety sensor. This can be useful for example to prevent the slew of the roof if the telescope is not at its park position.

Number of attempts

This option is useful on systems where the opening/closing is controlled by a pulse (short closure of the relay, which acts as a switch). If the system does not react to the impulsion, it is possible to repeat the operation. After the time required to open/close the roof, if the detector corresponding to the performed action is not enabled, the driver will try again. And if the sensor is still not active after the maximum number of attempts reached the status change to "error."

Update frequency

The update interval specifies the time between two checks of the sensor status while the roof is closing or opening.

Initial state

The initial state allows to specify the roof position at the time of connection. This can be useful if you manually open the roof before connecting to the driver. If a sensor is used, it will always override the state indicated in the configuration.

v3.2.1 (18-07-2017)
Correction of an error preventing to write the logs
v3.2.0 (08-07-2017)
Support of the virtual outputs (IPX800 v4)
v3.1.1 (18-02-2017)
Increase the timeout of tooltips in the setup dialog box
v3.1.0 (20-11-2016)
IPX800 v4 support
v3.0.1 (29-09-2016)
Improvement of the state handling. In cases where the roof moves at a very low speed, it could happen that the state remains open or closed during the roof slew
v3.0.0 (27-09-2016)
Ability the use of different relays to open and close the roof
Ability to use an input of the IPX800 to check if it is safe to close or open the roof
Various minor improvements
Code refactoring to allow future drivers development for IPX800 controlled domes
v2.4.3 (01-11-2015)
Fixed an error that can cause a shutterError status on some configurations if the number of close/open attempts is configured with a value above 1
v2.4.2 (06-04-2015)
English version. If the operating system is in french, this language will be used, otherwise english will be used
v2.4.1 (15-03-2015)
Modification in AbortSlew to avoid unwanted behavior if called when not slewing
Improvement in the initial shutter state setting on connection if the shutter was in an unknown state before the last disconnection
Compatibility with the firmware 3.05.46 and above of the IPX800 v3 when a password is used
v2.4.0 (08-03-2015)
Improved error handling
Implementation of the abort function (AbortSlew) of the ASCOM platform
Fixed a bug that could potentially cause crashes of the calling software if communication with the IPX800 is not possible (eg network problem)
v2.3.0 (28-02-2015)
IPX800 v2 compatibility
v2.2.0 (12-02-2015)
Add the ability to try to open/close several times in case of failure
v2.1.2 (09-02-2015)
Improvement in some log methods
v2.1.1 (07-02-2015)
Add log when exception is thrown by open/close dome
v2.1.0 (01-02-2015)
Add the possibility to use the IPX with HTTP protocol
v2.0.0 (25-01-2015)
New version developed from scratch
v1.1.0 (23-08-2014)
Various bugs corrections in communications with the IPX800
v1.0.0 (07-03-2013)
Initial version, created from ASCOM driver template

This software is free, but any donation is welcome

Download IPX800RollOffRoof_Setup_v3.2.1.exe 1446343 bytes
Download IPX800RollOffRoof_Setup_v3.2.0.exe 1446327 bytes
Download IPX800RollOffRoof_Setup_v3.1.1.exe 1436435 bytes
Download IPX800RollOffRoof_Setup_v3.1.0.exe 1436671 bytes
Download IPX800RollOffRoof_Setup_v3.0.1.exe 1278277 bytes
Download IPX800RollOffRoof_Setup_v3.0.0.exe 1278055 bytes
Download IPX800RollOffRoof_Setup_v2.4.3.exe 829537 bytes
Download IPX800RollOffRoof_Setup_v2.4.2.exe 829243 bytes
Download IPX800RollOffRoof_Setup_v2.4.1.exe 756400 bytes
Download IPX800RollOffRoof_Setup_v2.4.0.exe 753595 bytes
Download IPX800RollOffRoof_Setup_v2.3.0.exe 751404 bytes
Download IPX800RollOffRoof_Setup_v2.2.0.exe 748619 bytes