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
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Deep Sky Chile Observing Conditions Driver =
This page describes the '''Deep Sky Chile Observing Conditions''' ASCOM driver.
 
It exposes real-time weather and seeing data from the Deep Sky Chile site through the standard ASCOM <code>ObservingConditions</code> interface, so that automation software (N.I.N.A., Voyager, SGP, etc.) can use it for monitoring and safety decisions.
 
See also: [[ASCOM_SafetyMonitor|Deep Sky Chile Safety Monitor (ASCOM driver)]]


== 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].


{| class="wikitable"
The '''Deep Sky Chile Observing Conditions''' driver is an ASCOM-compliant driver that publishes:
! Attribute
 
! Detail
* Ambient and sky conditions (temperature, humidity, wind, rain…)
|-
* Seeing and sky quality
| '''Version'''
* Cloud and rain status converted to standard ASCOM fields
| [cite_start]1.0.0 [cite: 1]
 
|-
It retrieves meteorological data from the Deep Sky Chile API and maps it to ASCOM <code>ObservingConditions</code> properties used by most automation software. 
| '''Author'''
This driver is intended for '''remote observatory automation''', to help you make safe decisions about starting, stopping and continuing imaging sessions.
| [cite_start]Cédric Thomas [cite: 1]
 
|-
== Features ==
| '''Compliance'''
 
| [cite_start]ASCOM ObservingConditions [cite: 2]
'''Supported sensors'''
|}
 
* '''Temperature'''
* '''Humidity'''
* '''Dew point'''
* '''Wind speed''' and '''wind gust'''
* '''Seeing''' (star FWHM)
* '''Sky quality''' (NSB)
* '''Sky temperature'''
* '''Cloud cover'''
* '''Rain rate'''
 
'''Other key features'''
 
* Periodic polling of the Deep Sky Chile weather API
* Conversion of raw values into standard ASCOM properties
* Stale-data protection with a configurable time multiplier
* Optional detailed trace logging for troubleshooting
 
== How it works ==
 
The driver periodically queries the Deep Sky Chile weather API (default endpoint):
 
* <code>http://api.deepskychile.com/weather</code>
 
On each poll it:
 
# Retrieves the JSON weather data over HTTP (TLS 1.2 secured)
# Extracts the relevant sensor values (temperature, humidity, seeing, etc.)
# Converts cloud and rain status into ASCOM-compatible percentage / rate values
# Verifies that the data is not stale (based on the configured multiplier)
# Exposes everything through the ASCOM <code>ObservingConditions</code> interface
 
== Requirements ==


== Functionality ==
To use this driver you need:
[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].


* A Windows PC 
* The '''ASCOM Platform 7.1 or later''' installed 
* An internet connection to reach the Deep Sky Chile API 
* Compatible client software (for example N.I.N.A., Voyager, SGP, …)


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


=== Operation Logic ===
# Download and run the driver installer from your Deep Sky Chile customer area.
[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]:
# The installer will:
# Retrieves JSON data via HTTP (secured with TLS 1.2).
#* Copy the driver files to your system
# Extracts specific sensor values (Temp, Hum, Seeing, etc.).
#* Register the COM driver with ASCOM
# Converts cloud and rain status into percentage or rate formats.
#* Add the required ASCOM profile entries
# Applies stale data protection using a configurable multiplier.
 
# Generates detailed trace logs.
Once installed, the driver appears in the ASCOM chooser as '''Deep Sky Chile Observing Conditions''' (or similar).


== 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]:
* **API URL Endpoint**
* **Polling interval** (in seconds)
* **Stale data multiplier**
* **Trace logging** (Enable/Disable)


You configure the driver via its '''Setup''' dialog, accessible from any ASCOM-compatible application.
'''API URL endpoint'''
* Default: <code>http://api.deepskychile.com/weather</code> 
* Change this only if instructed by Deep Sky Chile.
'''Polling interval (seconds)'''
* Defines how often the driver queries the API. 
* Shorter intervals give fresher data but generate more network traffic.
'''Stale data multiplier'''
* Protects against using old data. 
* If the last update is older than <code>multiplier × polling interval</code>, the driver can treat the data as stale.
'''Trace logging'''
* When enabled, the driver writes a detailed log of its activity.
Trace logs are stored in:
* <code>Documents\ASCOM\Logs</code>
== Usage with automation software ==
A typical usage pattern:
# Open your automation software (for example N.I.N.A., Voyager, SGP).
# In the '''Weather''' (or equivalent) device selection:
#* Open the ASCOM chooser.
#* Select '''Deep Sky Chile Observing Conditions'''.
#* Click '''Properties''' (or '''Setup''') to configure API URL, polling interval, etc.
#* Confirm and connect.
Once connected, your software can read:
* Temperature, humidity, dew point 
* Wind speed and gusts 
* Cloud cover and rain rate 
* Seeing and sky quality 
* Sky temperature 
These values can then be used to drive safety limits, session start/stop rules and observing plans.
== Logging and troubleshooting ==
If you encounter issues:
# Enable '''trace logging''' in the Setup dialog.
# Reproduce the problem (for example connection error, missing data).
# Check the latest log files in:
#* <code>Documents\ASCOM\Logs</code>
Typical checks:
* Is the API URL correct? 
* Is the polling interval reasonable (not too short or too long)? 
* Is the system time on the PC correct (for stale-data calculations)?


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


== Installation and Removal ==
To remove the driver:
; Installation
[cite_start]Running the installer performs the following actions[cite: 7]:
* Copies the necessary driver files.
* Registers the COM driver.
* Adds the required ASCOM profile entries.


; Uninstallation
# Open '''Windows Settings → Apps''' (or '''Control Panel → Programs and Features''').
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].
# Locate '''Deep Sky Chile Observing Conditions'''.
# Click '''Uninstall'''.


== Safety and Disclaimer ==
The uninstaller removes all installed files and related registry entries.
[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].


== Support ==
== Support ==
[cite_start]For assistance, please contact Cédric Thomas at `[email protected]`[cite: 8].
 
For help, contact:
 
* '''Cédric Thomas''' 
* E-mail: <code>[email protected]</code>
 
== Disclaimer ==
 
This driver relies entirely on the '''Deep Sky Chile API''' for its data.
 
Always use redundant safety systems in remote observatories. This driver is intended as an information source and must not be your only line of defence.
 
 
[[Category:User manuals]]

Latest revision as of 13:47, 4 December 2025

This page describes the Deep Sky Chile Observing Conditions ASCOM driver.

It exposes real-time weather and seeing data from the Deep Sky Chile site through the standard ASCOM ObservingConditions interface, so that automation software (N.I.N.A., Voyager, SGP, etc.) can use it for monitoring and safety decisions.

See also: Deep Sky Chile Safety Monitor (ASCOM driver)

Overview[edit]

The Deep Sky Chile Observing Conditions driver is an ASCOM-compliant driver that publishes:

  • Ambient and sky conditions (temperature, humidity, wind, rain…)
  • Seeing and sky quality
  • Cloud and rain status converted to standard ASCOM fields

It retrieves meteorological data from the Deep Sky Chile API and maps it to ASCOM ObservingConditions properties used by most automation software. This driver is intended for remote observatory automation, to help you make safe decisions about starting, stopping and continuing imaging sessions.

Features[edit]

Supported sensors

  • Temperature
  • Humidity
  • Dew point
  • Wind speed and wind gust
  • Seeing (star FWHM)
  • Sky quality (NSB)
  • Sky temperature
  • Cloud cover
  • Rain rate

Other key features

  • Periodic polling of the Deep Sky Chile weather API
  • Conversion of raw values into standard ASCOM properties
  • Stale-data protection with a configurable time multiplier
  • Optional detailed trace logging for troubleshooting

How it works[edit]

The driver periodically queries the Deep Sky Chile weather API (default endpoint):

On each poll it:

  1. Retrieves the JSON weather data over HTTP (TLS 1.2 secured)
  2. Extracts the relevant sensor values (temperature, humidity, seeing, etc.)
  3. Converts cloud and rain status into ASCOM-compatible percentage / rate values
  4. Verifies that the data is not stale (based on the configured multiplier)
  5. Exposes everything through the ASCOM ObservingConditions interface

Requirements[edit]

To use this driver you need:

  • A Windows PC
  • The ASCOM Platform 7.1 or later installed
  • An internet connection to reach the Deep Sky Chile API
  • Compatible client software (for example N.I.N.A., Voyager, SGP, …)

Installation[edit]

  1. Download and run the driver installer from your Deep Sky Chile customer area.
  2. The installer will:
    • Copy the driver files to your system
    • Register the COM driver with ASCOM
    • Add the required ASCOM profile entries

Once installed, the driver appears in the ASCOM chooser as Deep Sky Chile Observing Conditions (or similar).

Configuration[edit]

You configure the driver via its Setup dialog, accessible from any ASCOM-compatible application.

API URL endpoint

Polling interval (seconds)

  • Defines how often the driver queries the API.
  • Shorter intervals give fresher data but generate more network traffic.

Stale data multiplier

  • Protects against using old data.
  • If the last update is older than multiplier × polling interval, the driver can treat the data as stale.

Trace logging

  • When enabled, the driver writes a detailed log of its activity.

Trace logs are stored in:

  • Documents\ASCOM\Logs

Usage with automation software[edit]

A typical usage pattern:

  1. Open your automation software (for example N.I.N.A., Voyager, SGP).
  2. In the Weather (or equivalent) device selection:
    • Open the ASCOM chooser.
    • Select Deep Sky Chile Observing Conditions.
    • Click Properties (or Setup) to configure API URL, polling interval, etc.
    • Confirm and connect.

Once connected, your software can read:

  • Temperature, humidity, dew point
  • Wind speed and gusts
  • Cloud cover and rain rate
  • Seeing and sky quality
  • Sky temperature

These values can then be used to drive safety limits, session start/stop rules and observing plans.

Logging and troubleshooting[edit]

If you encounter issues:

  1. Enable trace logging in the Setup dialog.
  2. Reproduce the problem (for example connection error, missing data).
  3. Check the latest log files in:
    • Documents\ASCOM\Logs

Typical checks:

  • Is the API URL correct?
  • Is the polling interval reasonable (not too short or too long)?
  • Is the system time on the PC correct (for stale-data calculations)?

Uninstallation[edit]

To remove the driver:

  1. Open Windows Settings → Apps (or Control Panel → Programs and Features).
  2. Locate Deep Sky Chile Observing Conditions.
  3. Click Uninstall.

The uninstaller removes all installed files and related registry entries.

Support[edit]

For help, contact:

Disclaimer[edit]

This driver relies entirely on the Deep Sky Chile API for its data.

Always use redundant safety systems in remote observatories. This driver is intended as an information source and must not be your only line of defence.

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