ドーム制御 ASCCOM Alplacaにて

2025.01.19

早速ASCOM Alpaca（以降、単にAlpacaとします）のAPIを調べました。
此方です：ASCOM Alpaca Device API v1 OAS 3.1

Alpacaでのデバイス指定は、”Alpaca Device API URLs” でURLで指定します。その方法や規定は
以下の感じです（上記URLの一部をDeepLで翻訳）

AlpacaデバイスAPIのURLは、http(s)://host:port/pathの形式です。pathは、「/api/v1/」の後に以下のメソッド名のいずれかが続きます。例えば、IPアドレス192.168.1.89のデバイスのポート7843で動作しているAlpacaインターフェースの場合：

・望遠鏡の「インターフェース・バージョン」メソッドURLは、http://192.168.1.89:7843/api/v1/telescope/0/interfaceversion
・ローテーターの 「Halt 」メソッドのURLは
http://192.168.1.89:7843/api/v1/rotator/0/halt

GET操作の場合、パラメータはURLのクエリー文字列の中に、
PUT操作の場合、パラメータはメッセージ本文の中に置くべきである。

応答はJSON形式で返され、クライアントのトランザクショ ン番号、サーバーのトランザクション番号、エラーメッセージ、エラー番号を含む 共通の値セットを常に含む。

この通り、正に自分が思っていたような方式、形式に違い近いです。さらに仕様では細かく規定されています。

１．ASCOM Methods Common To All Devices

#操作指定記述要否
1PUT/{device_type}/{device_number}/actionInvokes the named device-specific action調査検討
2PUT/{device_type}/{device_number}/commandblindTransmits an arbitrary string to the device調査検討
3PUT/{device_type}/{device_number}/commandboolTransmit an arbitrary string to device and returns a boolean value from device調査検討
4PUT/{device_type}/{device_number}/commandstringTransmit an arbitrary string to device and returns a string value from device調査検討
5PUT/{device_type}/{device_number}/connectStarts an asynchronous connect to the device調査検討
6GET/{device_type}/{device_number}/connectedRetrieves the connected state of the device〇
7PUT/{device_type}/{device_number}/connectedSet the connected stats to the device調査検討
8GET/{device_type}/{device_number}/connectingCompletion variable for the asynchronous Connect() and Disconnect() methods調査検討
9GET/{device_type}/{device_number}/descriptionDevice Discription〇
10GET/{device_type}/{device_number}/devicestateReturns the device’s operational state in a single call〇
11PUT/{device_type}/{device_number}/disconnectStarts an asynchronous disconnect from the device調査検討
12GET/{device_type}/{device_number}/driverinfoDevice driver description〇
13GET/{device_type}/{device_number}/driverversionDevice Version〇
14GET/{device_type}/{device_number}/interfaceversionThe ASCOM Device interface version number thar this device supports〇
15GET/{device_type}/{device_number}/nameDevice name〇
16GET/{device_type}/{device_number}/supportedactionsReturn the list of action names supported by this device調査検討

２．Dome Specific Method

#操作指定記述要否
1GET/dome/{device_number}/altitudeThe dome altitude×
2GET/dome/{device_number}/athomeIndicates whether the dome is in the home position〇
3GET/dome/{device_number}/atparkIndicates whether the dome is in the park position×
4GET/dome/{device_number}/azimuthThe dome azimuth〇
5GET/dome/{device_number}/canfindhomeIndicates whether the dome can find the home position〇
6GET/dome/{device_number}/canparkIndicate whether the dome ca be parkedfalse
7GET/dome/{device_number}/cansetaltitudeIndicates whether the dome altitude can be setfalse
8GET/dome/{device_number}/cansetazimuthIndicates whether the dome azimuth can be set検討
9GET/dome/{device_number}/cansetparkIndicates whether the dome park position can be set.false
10GET/dome/{device_number}/cansetshutterIndicates whether the dome shutter position can be set.false
11GET/dome/{device_number}/canslaveIndicates whether the dome supports slaving to a telescopefalse
13GET/dome/{device_number}/cansyncazimuthIndicates whether the dome azimuth position can be synched〇
13GET/dome/{device_number}/shutterstatusStatus of the dome shutter or roll-off roof〇
14GET/dome/{device_number}/slavedIndicates whether the dome is slaved to the telescope×
15PUT/dome/{device_number}/slavedSets whether the dome is slaved to the telescope×
16GET/dome/{device_number}/slewingIndicates whether the any part of the dome is moving〇
17PUT/dome/{device_number}/abortslewImmediately cancel current dome operation〇
18PUT/dome/{device_number}/closeshutterClose the shutter or otherwise shield telescope from the shy〇
19PUT/dome/{device_number}/findhomeStart Operation to search for the dome home position〇
20PUT/dome/{device_number}/openshutterOpen shutter or otherwise expose telescope to the sky〇
21PUT/dome/{device_number}/parkRotate dome in azimuth to park position×
22PUT/dome/{device_number}/setparkSet the current azimuth, altitude position of dome to be the park position×
33PUT/dome/{device_number}/slewtoaltitudeSlew the dome to the given altitude position×
24PUT/dome/{device_number}/slewtoazimuthSlew the dome to the given azimuth position〇
25PUT/dome/{device_number}/synctoazimuthSynchronize the current position of the dome to the given azimuth検討

３．要調査、要検討に関して
　基本的に以下の機能は具備しない事とする。
　i）高度の関連：スリットは０～９０開いているので高度は提供しない。
　ii）パーク機能：任意の方位での停止は提供しない事とする。
　　自動追尾はしないので当該方位でのパークも意味無いので有しない。
　iii）Slave：自律的なSlave機能は持たない（単にPCからの方位指定：slewtoazimuthで移動のみ）
　要調査項目：
　１）action：どういった内容か
　２）commandblind, commandbool, commandstring：どういった使い方をするものか
　３）connect, connecting, connected, disconnectなど
　４）supportedaction：内容など
　
　検討項目：
　Ａ）cansetazimuth：使い方とか調べて
　Ｂ）syncazumuth：指定方位の設定だが無条件か条件ありとするか

2025/1/20 誤記訂正

コメント

タイトルとURLをコピーしました