ASCOM ObservingConditions: Difference between revisions

From Deep Sky Chile
← Older editNewer edit →
No edit summary
No edit summary
Line 1: Line 1:
= Deep Sky Chile Observing Conditions Driver =
====== Deep Sky Chile Observing Conditions Driver ======


== Overview ==
===== Description =====
The '''Deep Sky Chile Observing Conditions''' driver is an ASCOM-compliant driver that exposes weather and seeing data from the Deep Sky Chile site. It retrieves real-time meteorological data from the Deep Sky Chile API and maps it to standard ASCOM ObservingConditions properties. This driver is intended for remote observatory automation systems (like N.I.N.A., Voyager, SGP) to monitor environmental conditions. {| class="wikitable"
[cite_start]The **Deep Sky Chile Observing Conditions** driver is an ASCOM-compliant driver that exposes weather and seeing data from the Deep Sky Chile site[cite: 1]. [cite_start]It retrieves real-time meteorological data from the Deep Sky Chile API and maps it to standard ASCOM ObservingConditions properties[cite: 2].
! Property
! Value
|-
| '''Version'''
| 1.0.0 |-
| '''Author'''
| Cédric Thomas |}


== Supported Sensors ==
[cite_start]This driver is intended for remote observatory automation systems (like N.I.N.A., Voyager, SGP) to monitor environmental conditions[cite: 3].
The driver supports the following sensors: * Temperature, Humidity, Dew Point
* Wind Speed & Wind Gust
* Seeing (StarFWHM)
* Sky Quality (NSB)
* Sky Temperature
* Cloud Cover & Rain Rate


== Operation Logic ==
^ Attribute ^ Detail ^
The driver periodically queries the API (default: <code>http://api.deepskychile.com/weather</code>). It then performs the following operations: # Retrieves the JSON data via HTTP (TLS 1.2 secured)
| **Version** | [cite_start]1.0.0 [cite: 1] |
# Extracts sensor values (Temp, Hum, Seeing, etc.)
| **Author** | [cite_start]Cédric Thomas [cite: 1] |
# Converts cloud/rain status into percentage/rate
| **Compliance** | [cite_start]ASCOM ObservingConditions [cite: 1] |
# Supports stale data protection (configurable multiplier)
# Provides detailed trace logging


===== Supported Sensors =====
[cite_start]The driver supports the following sensors[cite: 3]:
  * Temperature, Humidity, Dew Point
  * Wind Speed & Wind Gust
  * Seeing (StarFWHM)
  * Sky Quality (NSB)
  * Sky Temperature
  * Cloud Cover & Rain Rate


===== How it works =====
[cite_start]The driver periodically queries the API (default: http://api.deepskychile.com/weather)[cite: 4].


[Image of API data flow diagram]
[cite_start]It then performs the following steps[cite: 5]:
  - Retrieves the JSON data via HTTP (TLS 1.2 secured)
  - Extracts sensor values (Temp, Hum, Seeing, etc.)
  - Converts cloud/rain status into percentage/rate
  - Supports stale data protection (configurable multiplier)
  - Provides detailed trace logging


===== Configuration =====
[cite_start]Open the driver’s Setup dialog from any ASCOM application[cite: 5].


== Configuration ==
[cite_start]You may configure the following[cite: 6]:
Open the driver’s Setup dialog from any ASCOM application to configure the following: * API URL Endpoint
  * API URL Endpoint
* Polling interval (seconds)
  * Polling interval (seconds)
* Stale data multiplier
  * Stale data multiplier
* Trace logging (Enable/Disable)
  * Trace logging (Enable/Disable)


=== Logging ===
Trace logs are stored in:
Trace logs are stored in: : <code>Documents\ASCOM\Logs</code>
[cite_start]''Documents\ASCOM\Logs'' [cite: 6]


== Installation ==
===== Installation =====
Run the installer to: * Copy driver files
Run the installer. [cite_start]It will[cite: 7]:
* Register the COM driver
  * Copy driver files
* Add ASCOM profile entries
  * Register the COM driver
  * Add ASCOM profile entries


== Uninstallation ==
===== Uninstallation =====
Use Windows Add/Remove Programs. The uninstaller removes all files and registry entries. == Support ==
Use Windows Add/Remove Programs. [cite_start]The uninstaller removes all files and registry entries[cite: 8].
For help, contact: : Cédric Thomas (cedric@deepskychile.com)


== Disclaimer ==
===== Support =====
This driver relies entirely on the Deep Sky Chile API. Always use redundant safety systems in remote observatory operations. ```
For help, contact:
Cédric Thomas
[cite_start]cedric@deepskychile.com [cite: 8]


***
===== Disclaimer =====
 
This driver relies entirely on the Deep Sky Chile API. [cite_start]**Always use redundant safety systems in remote observatory operations.** [cite: 9]
### Page 2: Deep Sky Chile Safety Monitor Driver
 
```mediawiki
= Deep Sky Chile Safety Monitor =
 
== Overview ==
The '''Deep Sky Chile Safety Monitor''' is an ASCOM-compliant driver that exposes the safety status of Deep Sky Chile observatories. It retrieves the ''roofState'' ("open" or "closed") from the Deep Sky Chile API and converts it into an ASCOM SafetyMonitor ''IsSafe'' value. This driver is intended for remote observatory automation systems that rely on ASCOM SafetyMonitor devices. {| class="wikitable"
! Property
! Value
|-
| '''Version'''
| 1.2.0 |-
| '''Author'''
| Cédric Thomas |}
 
== Safety Logic ==
The driver maps the roof state to the ASCOM safety status: * '''Roof open''' → Safe = True
* '''Roof closed''' → Safe = False
 
== Operation Logic ==
The driver periodically queries the API at: : <code>http://api.deepskychile.com/observatories</code>
 
It then performs the following steps: # Identifies the selected observatory
# Reads its roofState
# Converts this into ASCOM IsSafe
# Supports stale data protection
# Provides optional trace logging
 
== Configuration ==
Open the driver’s Setup dialog from any ASCOM application to configure: * API URL
* Observatory selection (dropdown list)
* Polling interval
* Stale data multiplier
* Fail-safe mode
* Trace logging
 
=== Logging ===
Trace logs are stored in: : <code>Documents\ASCOM\Logs</code>
 
== Installation ==
Run the installer to: * Copy driver files
* Register the COM driver
* Add ASCOM profile entries
 
== Uninstallation ==
Use Windows Add/Remove Programs. The uninstaller removes all files and registry entries. == Support ==
For help, contact: : Cédric Thomas ([email protected])
 
== Disclaimer ==
This driver relies entirely on the Deep Sky Chile API. Always use redundant safety systems in remote observatory operations. ```
 
### Next Step
Would you like me to generate a summary email to Cédric Thomas notifying him that the documentation has been drafted?

Revision as of 13:26, 4 December 2025

Deep Sky Chile Observing Conditions Driver
Description

[cite_start]The **Deep Sky Chile Observing Conditions** driver is an ASCOM-compliant driver that exposes weather and seeing data from the Deep Sky Chile site[cite: 1]. [cite_start]It retrieves real-time meteorological data from the Deep Sky Chile API and maps it to standard ASCOM ObservingConditions properties[cite: 2].

[cite_start]This driver is intended for remote observatory automation systems (like N.I.N.A., Voyager, SGP) to monitor environmental conditions[cite: 3].

^ Attribute ^ Detail ^ | **Version** | [cite_start]1.0.0 [cite: 1] | | **Author** | [cite_start]Cédric Thomas [cite: 1] | | **Compliance** | [cite_start]ASCOM ObservingConditions [cite: 1] |

Supported Sensors

[cite_start]The driver supports the following sensors[cite: 3]: 

 * Temperature, Humidity, Dew Point
 * Wind Speed & Wind Gust
 * Seeing (StarFWHM)
 * Sky Quality (NSB)
 * Sky Temperature
 * Cloud Cover & Rain Rate
How it works

[cite_start]The driver periodically queries the API (default: http://api.deepskychile.com/weather)[cite: 4].

[cite_start]It then performs the following steps[cite: 5]: 

 - Retrieves the JSON data via HTTP (TLS 1.2 secured)
 - Extracts sensor values (Temp, Hum, Seeing, etc.)
 - Converts cloud/rain status into percentage/rate
 - Supports stale data protection (configurable multiplier)
 - Provides detailed trace logging
Configuration

[cite_start]Open the driver’s Setup dialog from any ASCOM application[cite: 5].

[cite_start]You may configure the following[cite: 6]: 

 * API URL Endpoint
 * Polling interval (seconds)
 * Stale data multiplier
 * Trace logging (Enable/Disable)

Trace logs are stored in: [cite_start]Documents\ASCOM\Logs [cite: 6]

Installation

Run the installer. [cite_start]It will[cite: 7]: 

 * Copy driver files
 * Register the COM driver
 * Add ASCOM profile entries
Uninstallation

Use Windows Add/Remove Programs. [cite_start]The uninstaller removes all files and registry entries[cite: 8].

Support

For help, contact: Cédric Thomas [cite_start][email protected] [cite: 8]

Disclaimer

This driver relies entirely on the Deep Sky Chile API. [cite_start]**Always use redundant safety systems in remote observatory operations.** [cite: 9]

Retrieved from "https://wiki.deepskychile.com/index.php?title=ASCOM_ObservingConditions&oldid=109"