ASCOM ObservingConditions: Difference between revisions

From Deep Sky Chile
Created page with "= Deep Sky Chile Observing Conditions Driver = == Overview == [cite_start]The **Deep Sky Chile Observing Conditions** driver is an ASCOM-compliant driver designed to expose weather and seeing data from the Deep Sky Chile site[cite: 1]. [cite_start]It is intended for use with remote observatory automation systems, such as N.I.N.A., Voyager, or SGP, allowing them to monitor environmental conditions effectively[cite: 3]. {| class="wikitable" ! Attribute ! Detail |- | '''V..."
 
No edit summary
Line 2: Line 2:


== Overview ==
== Overview ==
[cite_start]The **Deep Sky Chile Observing Conditions** driver is an ASCOM-compliant driver designed to expose weather and seeing data from the Deep Sky Chile site[cite: 1]. [cite_start]It is intended for use with remote observatory automation systems, such as N.I.N.A., Voyager, or SGP, allowing them to monitor environmental conditions effectively[cite: 3].
[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 <ref>[cite: 1]</ref>. [cite_start]It retrieves real-time meteorological data from the Deep Sky Chile API and maps it to standard ASCOM ObservingConditions properties <ref>[cite: 2]</ref>. [cite_start]This driver is intended for remote observatory automation systems (like N.I.N.A., Voyager, SGP) to monitor environmental conditions <ref>[cite: 3]</ref>.


{| class="wikitable"
{| class="wikitable"
! Attribute
! Property
! Detail
! Value
|-
|-
| '''Version'''
| '''Version'''
| [cite_start]1.0.0 [cite: 1]
| [cite_start]1.0.0 <ref>[cite: 1]</ref>
|-
|-
| '''Author'''
| '''Author'''
| [cite_start]Cédric Thomas [cite: 1]
| [cite_start]Cédric Thomas <ref>[cite: 1]</ref>
|-
| '''Compliance'''
| [cite_start]ASCOM ObservingConditions [cite: 2]
|}
|}


== Functionality ==
== Supported Sensors ==
[cite_start]The driver retrieves real-time meteorological data from the Deep Sky Chile API and maps it to standard ASCOM ObservingConditions properties[cite: 2].
[cite_start]The driver supports the following sensors <ref>[cite: 3]</ref>:
 
* Temperature, Humidity, Dew Point
 
* Wind Speed & Wind Gust
=== Supported Sensors ===
[cite_start]The driver supports the following environmental readings[cite: 3]:
* Temperature, Humidity, and Dew Point
* Wind Speed and Wind Gust
* Seeing (StarFWHM)
* Seeing (StarFWHM)
* Sky Quality (NSB)
* Sky Quality (NSB)
* Sky Temperature
* Sky Temperature
* Cloud Cover and Rain Rate
* Cloud Cover & Rain Rate


=== Operation Logic ===
== How it works ==
[cite_start]The driver operates by periodically querying the API (default endpoint: `http://api.deepskychile.com/weather`)[cite: 4]. [cite_start]The operational workflow is as follows[cite: 5]:
[cite_start]The driver periodically queries the API (default: <code>http://api.deepskychile.com/weather</code>) <ref>[cite: 4]</ref>.
# Retrieves JSON data via HTTP (secured with TLS 1.2).
 
# Extracts specific sensor values (Temp, Hum, Seeing, etc.).
 
# Converts cloud and rain status into percentage or rate formats.
 
# Applies stale data protection using a configurable multiplier.
[Image of API data flow diagram]
# Generates detailed trace logs.
 
 
[cite_start]It performs the following logic <ref>[cite: 5]</ref>:
# 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 ==
== Configuration ==
Configuration is managed via the driver’s Setup dialog, accessible from any ASCOM application. [cite_start]Users can configure the following settings[cite: 6]:
[cite_start]Configuration is handled via the driver’s Setup dialog from any ASCOM application <ref>[cite: 5]</ref>.
* **API URL Endpoint**
* **Polling interval** (in seconds)
* **Stale data multiplier**
* **Trace logging** (Enable/Disable)


=== Settings ===
[cite_start]You may configure the following parameters <ref>[cite: 6]</ref>:
* API URL Endpoint
* Polling interval (seconds)
* Stale data multiplier
* Trace logging (Enable/Disable)


=== Logging ===
=== Logging ===
[cite_start]Trace logs are generated to assist with troubleshooting and are stored in the following directory[cite: 6]:
[cite_start]Trace logs are stored in <ref>[cite: 6]</ref>:
: <code>Documents\ASCOM\Logs</code>
: <code>Documents\ASCOM\Logs</code>


== Installation and Removal ==
== Installation and Uninstallation ==
; Installation
; Installation
[cite_start]Running the installer performs the following actions[cite: 7]:
[cite_start]Run the installer to copy driver files, register the COM driver, and add ASCOM profile entries <ref>[cite: 7]</ref>.
* Copies the necessary driver files.
* Registers the COM driver.
* Adds the required ASCOM profile entries.


; Uninstallation
; Uninstallation
To remove the driver, use the Windows Add/Remove Programs feature. [cite_start]The uninstaller will remove all files and registry entries associated with the driver[cite: 8].
Use Windows Add/Remove Programs. [cite_start]The uninstaller removes all files and registry entries <ref>[cite: 8]</ref>.


== Safety and Disclaimer ==
== Disclaimer ==
[cite_start]This driver relies entirely on the Deep Sky Chile API[cite: 9]. [cite_start]It is strongly recommended to always use redundant safety systems in remote observatory operations[cite: 9].
This driver relies entirely on the Deep Sky Chile API. [cite_start]Always use redundant safety systems in remote observatory operations <ref>[cite: 9]</ref>.


== Support ==
== Support ==
[cite_start]For assistance, please contact Cédric Thomas at `[email protected]`[cite: 8].
[cite_start]For help, contact Cédric Thomas at <code>[email protected]</code> <ref>[cite: 8]</ref>.
 
== References ==
<references />

Revision as of 13:23, 4 December 2025

Deep Sky Chile Observing Conditions Driver

Overview

[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 <ref>[cite: 1]</ref>. [cite_start]It retrieves real-time meteorological data from the Deep Sky Chile API and maps it to standard ASCOM ObservingConditions properties <ref>[cite: 2]</ref>. [cite_start]This driver is intended for remote observatory automation systems (like N.I.N.A., Voyager, SGP) to monitor environmental conditions <ref>[cite: 3]</ref>.

Property Value
Version [cite_start]1.0.0 <ref>[cite: 1]</ref>
Author [cite_start]Cédric Thomas <ref>[cite: 1]</ref>

Supported Sensors

[cite_start]The driver supports the following sensors <ref>[cite: 3]</ref>:

  • 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) <ref>[cite: 4]</ref>.


[Image of API data flow diagram]


[cite_start]It performs the following logic <ref>[cite: 5]</ref>:

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

Configuration

[cite_start]Configuration is handled via the driver’s Setup dialog from any ASCOM application <ref>[cite: 5]</ref>.

Settings

[cite_start]You may configure the following parameters <ref>[cite: 6]</ref>:

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

Logging

[cite_start]Trace logs are stored in <ref>[cite: 6]</ref>:

Documents\ASCOM\Logs

Installation and Uninstallation

Installation

[cite_start]Run the installer to copy driver files, register the COM driver, and add ASCOM profile entries <ref>[cite: 7]</ref>.

Uninstallation

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

Disclaimer

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

Support

[cite_start]For help, contact Cédric Thomas at [email protected] <ref>[cite: 8]</ref>.

References

<references />