ASCOM ObservingConditions - Revision history

Cedric at 11:47, 4 December 2025

2025-12-04T11:47:58Z

← Older revision		Revision as of 13:47, 4 December 2025
Line 102:		Line 102:

	# Open your automation software (for example N.I.N.A., Voyager, SGP).		# Open your automation software (for example N.I.N.A., Voyager, SGP).
	# In the '''~~Observing Conditions~~''' (or equivalent) device selection:		# In the '''Weather''' (or equivalent) device selection:
	#* Open the ASCOM chooser.		#* Open the ASCOM chooser.
	#* Select '''Deep Sky Chile Observing Conditions'''.		#* Select '''Deep Sky Chile Observing Conditions'''.
Line 129:		Line 129:
	Typical checks:		Typical checks:

	* Can the PC reach the API URL in a web browser?
	* Is the API URL correct?		* Is the API URL correct?
	* Is the polling interval reasonable (not too short or too long)?		* Is the polling interval reasonable (not too short or too long)?

Cedric at 11:39, 4 December 2025

2025-12-04T11:39:52Z

Show changes

Cedric at 11:33, 4 December 2025

2025-12-04T11:33:05Z

← Older revision		Revision as of 13:33, 4 December 2025
Line 45:		Line 45:

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

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

			[[Category:User manuals]]

Cedric at 11:28, 4 December 2025

2025-12-04T11:28:46Z

Show changes

Cedric at 11:26, 4 December 2025

2025-12-04T11:26:41Z

Show changes

Cedric at 11:24, 4 December 2025

2025-12-04T11:24:58Z

Show changes

Cedric at 11:23, 4 December 2025

2025-12-04T11:23:17Z

← Older revision		Revision as of 13:23, 4 December 2025
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 `cedric@deepskychile.com`[cite: 8].		[cite_start]For help, contact Cédric Thomas at <code>cedric@deepskychile.com</code> <ref>[cite: 8]</ref>.

			== References ==
			<references />

Cedric: 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..."

2025-12-04T11:21:22Z

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..."

New page

= 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
|-
| '''Version'''
| [cite_start]1.0.0 [cite: 1]
|-
| '''Author'''
| [cite_start]Cédric Thomas [cite: 1]
|-
| '''Compliance'''
| [cite_start]ASCOM ObservingConditions [cite: 2]
|}

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

=== 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)
* Sky Quality (NSB)
* Sky Temperature
* Cloud Cover and Rain Rate

=== Operation Logic ===
[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]:
# 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.
# Generates detailed trace logs.

== 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)

=== Logging ===
[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 ==
; 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
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].

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

== Support ==
[cite_start]For assistance, please contact Cédric Thomas at `cedric@deepskychile.com`[cite: 8].