From b32e25933c711a45cce139a76bdd61f6655fa935 Mon Sep 17 00:00:00 2001 From: NON-K <3255867418@qq.com> Date: Fri, 10 Jul 2026 16:41:10 +0800 Subject: [PATCH] Add Askar WAF focuser driver documentation Co-authored-by: Cursor --- .../focusers/askar/askar-waf/askar-waf.md | 61 ++++++++++++++++++ .../focusers/askar/askar-waf/askar-waf.webp | Bin 0 -> 3732 bytes .../focusers/askar/askar-waf/askar-waf.yaml | 11 ++++ 3 files changed, 72 insertions(+) create mode 100644 src/content/docs/focusers/askar/askar-waf/askar-waf.md create mode 100644 src/content/docs/focusers/askar/askar-waf/askar-waf.webp create mode 100644 src/content/docs/focusers/askar/askar-waf/askar-waf.yaml diff --git a/src/content/docs/focusers/askar/askar-waf/askar-waf.md b/src/content/docs/focusers/askar/askar-waf/askar-waf.md new file mode 100644 index 0000000..81b2438 --- /dev/null +++ b/src/content/docs/focusers/askar/askar-waf/askar-waf.md @@ -0,0 +1,61 @@ +--- +title: Askar WAF +categories: ["focusers"] +description: INDI driver for the Askar WAF USB focuser. +thumbnail: ./askar-waf.webp +--- + +[Askar](https://gb.sharpstar-optics.com/) (Jiaxing Ruixing Optical Instrument Co., Ltd.) manufactures the **Askar WAF**, a USB focuser for astronomy. The device presents a USB CDC virtual serial port and is controlled with logical step coordinates. + +_Askar WAF_ is the INDI focuser driver for this device. It is part of the INDI core package and uses only the standard serial connection already available in INDI Core. + +## Features + +- Absolute and relative focus moves +- Abort / halt +- Sync logical position (no motor motion) +- Reverse motion direction +- Firmware backlash compensation +- Read and set maximum travel +- Firmware version and model name display + +## Installation + +The driver is included in the INDI core package and does not require extra dependencies. + +Start the INDI server with the focuser driver: + +```shell +indiserver -v indi_askar_waf_focus +``` + +## Configuration + +1. Open the INDI Control Panel and select **Askar WAF**. +2. On the **Connection** tab, choose the USB CDC serial port (typically `/dev/ttyACM0` on Linux). Baud rate is required to open the port but is otherwise irrelevant for CDC. +3. Click **Connect**. On success, the driver reads firmware version, model name, max travel, current position, backlash, and reverse settings. + +On the **Main Control** tab you can use: + +| Control | Description | +| ------- | ----------- | +| Absolute Position | Move to a logical step position in `[0, Max Position]` | +| Relative Position | Move inward (−) or outward (+) by a number of steps | +| Abort | Stop motion immediately | +| Sync | Set the reported logical position without moving the motor | +| Reverse | Invert physical motor direction for all moves | +| Backlash | Firmware compensation steps (`0` disables compensation) | +| Max Position | Maximum logical travel (firmware range `100`–`1000000`) | +| Firmware | Read-only firmware version and model name | + +## Usage & Tips + +> [!NOTE] +> All positions are **logical steps**. After power-up, the firmware restores the last saved logical position from NVS when available; otherwise it defaults near mid-travel. If the reported position does not match the mechanics, use **Sync** (for example sync to `0` when fully retracted). + +> [!TIP] +> When changing **Max Position**, the current logical position must not exceed the new maximum, or the device rejects the command. A common setup is: fully retract → **Sync** to `0` → extend to the mechanical limit → set **Max Position**. + +- **Reverse** only inverts motor rotation; logical coordinates stay the same. Use it when the focuser is mounted so that “outward” moves the tube the wrong way. +- Moves are asynchronous. The driver polls motion state and position until the focuser is idle. +- To inspect `F…#` serial traffic, enable Focuser logging in Ekos **Logs** (or the driver Debug control in the INDI Control Panel Options tab). diff --git a/src/content/docs/focusers/askar/askar-waf/askar-waf.webp b/src/content/docs/focusers/askar/askar-waf/askar-waf.webp new file mode 100644 index 0000000000000000000000000000000000000000..1d48e954d32c4fefab31dd29e8a4253038375977 GIT binary patch literal 3732 zcmb7`S2!CC!-f$On^LN(b_t5ww3HGvq4p@MR;}2p_N={%D%IenMr%b;TTr95sS(=P zTdj~r2>IXd>_7Uh>w6CF>$#rO`{Xg!)zV61BqOuXR5vs?ROF5Rw@(_7A;?AVliw$Q zEXAGz;pgMKLG9GZ3!rRj@#!#JciHtmjT$VbQ0=%@4Z3xndM3GO09R4nQaFifjPkf% zxC|ylU`Zh)UQ_|GT~{z1IBbB^4<*E-XV@~KM7(ur-z$j!z-g)FZ<<)48`Qhq9I;g7_9Gx zWk`i?bKX(g%9zpk=R*&ZiKo(mEv&)H^&)pELvv7S5nJ3$BbZ2DK3I}c39c-lbfhr) zN~#uVnf~q}DVl$OV|3=#ENp#*K@g{Py4jRGtFDKPeP13#`YNizqS4UJWumnhrhQz_ zl-{4#;|NRhS_}oHyCZNG&;BP1|KAskjO?0({g-59pzzZnUrR+FYy9JiW!N~X^6R?6 zZ%;g3t>Y#0i|DKNzxo`K2XVLHu$Do9D?&iIfM4>Xo?z(3jWg@UjGH`6$ltI`aC5bI zpb*|>s{|OwYC0@|`U7z?mdiHN!^9|e6O=VOGJ>R&a^_~19ELIgx((Bg9eV3 zJW)<5ABSx3QEwj2vbm+#lcF24frX)*H$vdg~WnFeM(;26?nXPhwO=uI*&+{3%%LGobD5CkDell;4P9;+~| z5@2h-y$A28{!L?x4ufw7UGN7p^?bql`r(eQeLd>6x{mgS7kM+!vY*X4>Xob{O3KDH0-M)*^X9J2j@US2Tnd6#^}bn5{16Mhb0 zAA&&U1+-SQbpes-uV|clBa1W)f*IFn6V>`FQ7L*;12rQ0S6HT{A;QoZ-h101>%r45Zc# z+!`HMal+3k{uqA=7ybFU{u|e>yePDIvw*s*)RozTZl4jym@HN~vN27bZ&v@X6^h!| z+mSo20bRGrFDG7ZQCYFK9DMKBdr9vVDYzpExT1Z?fgYaJg>Oo^CqrsUKa6?Y4xQD(NSW3^JcKZ6XUVk)MnR>iRp9$$veLlI9#nmF_|l zaPw{P58p4yxu9(?$0;Su!yc0fbJMW(&8U40`4l)xUUF7Za6Pw8m3yMUn9lRZy%k?t zZIz?ge4lQH<@2#hlWv^$HEpK|RTT=E;oQVer(6NW#El*laYn4!csO30)i5(OZEa%R z_6FGcd_^s&rS_BM#_K|@VFz~m-UwQW-kj2;7sFnPuM-wSjFhBv?(8)VpEoK#S*Tv( z3lq*wNi~UTgUw#)fL|%6#nPwcK*FedDLBwt;!9H0hN`=MY&sRG+0VCta%dD>UYv#` zwVQx;7}5{05t!yu&Mzh%kNlVb{7J>g|9HvAT5IFA9H+<-fSDJ3{Q)FHb=mat!a0)m z-i8l-cD;0;T_JK$I_qn&W7f;So4i4cw3zLL7FaZWZ2rOI?n(81J<#`Vx)F^hr<6V0 zuv{bLo5IHZm3Qu2t}^HciIPHa2<~(Qyi|RAUHTB3c%5c;P3`}P;A1Z*K;fEsDIEBx zF3G016@2T#=>-csNQ1%g<)OHD&KE|9XN$LbeQ+0v^*;}4qTUR>&NdgMt;XAEeLnZ( zXS6)+>`<8q@9=wu)lhFa*8m)Ip0lbOBgL0b3x~k>063?}prKzA)U0qL`Us><_A5n+ zHLyu$iMz2$EFN=Jex&dBg^tAlM3pORckpycL%og=Kz_p&MY&>>c98PC6XH`*)A>@T zM|0$qKSNxuV_0D*Om7>SvC}LBw3DtaZ?HX@DO&r&%R*b;qp1CQ%KeUFwVP$-jg1UW zX7_%^mH8y>VP&V@sP1SoTG$N1UQ;K0QCP5ua~O1vXubt!Zg6!l0Q$z(CIJfP0ahOh z(3VFunpeAb-OZRq+p-QnaCS6_Sz4Pi>-b0XVymS?V1&unPC=x>adA-skjsFcN4U>D zxp_RLSdrcT-Ab9W@EgX#2G6fMJI!i*kLQ(zGVcTDlU8#cGOfnFZfqHI%Ky}d>^w9K zaflM)en>6gQ|d+-Bh#d^yN=a{(adpQnEJo_k@0jN1ABk(auEavL9@&vh;Iy4138gpy8%3+r9@QB2xY)B81~CseKBKaQV7f&rmb9P9Ja%;Tl38 z$l8LQR;`HqP_>PWzeSYGy{Cp*G7dG3=zITJ-v2U%-twrcnf&KRyiQ>|gTy98PCm{N zK5MAQG&)bLEA=^Q#9Az0<;XK!9o2hb#y%tngL-0g?TxkRyC^zDIbJot_~omn(m9ZK zGEZhBT*m%!MG#VEB4Lgj9EM3DsTQz=0&t+GgvZK7S4NnA;{E}bRerWRWq2Krkby+b zJHkn*3G+UeL`7YqC?Y2!_ID1k#=7SN$Ib_2;I1tEOp6D?T5-ygs@qlR5$<5#M#`rB z>o+)!!As0$iC~2C9=L@@lCQ>(fAI-IU+b!&MI`Ve<%Ugk_tYjh*K+n~n@fa&5s#ye6+mQ+Hkx}?9 zuW{*?7^;+c_jmTyY_IQ)ZxqDoT4_3^^~O{?r9oD%VQ<1|8C1f@6^36hOHhmm!CP_Wdjw${*ZoWx}JZ;N0OZG9BouwH3_FuGVBrTppP87T9HM z;pE5kiV2FLLra$tbw|KfyBJ$xD>a+x8r-1$nCQ1Mu-Xl|;`@`RW#8p+|JUH{n`f-bVkyr|v{`dy4p-VGoTCUx$_6zjEg zFsq_zbv&*Wk*Ol@;$sW8Q_t0$1{G_DE)~6F6VKaZ?Hu1O!@`H@!RajdGrr>HP&zRs zwG=iiK^4OQHMXw-b`YFkH3UP~A*^uU~+txVpIXwSk-zHFB-!1l7SRuQIQ8 zhK&&OY~7D2#FhNqq4XrAxwC%AZ<}@xE~Txwl!5Jfv!8J=A2|_mzGb+pux4cfyf%o( z6-2_E4?$<<37#n>!*9!3U3WfHv~{n~m<)up`U-;mv5n!yE8RAB!^=fP=-bsj5n~iP zg#$f*`Ay1C1e(c8Thh4v3on618E|5?jL!_(hH<5m z?Tx*n!p!(j{f?PC(iYm5U2FLOfw`r`9co|$*7sqAN3wN&MuOQOw`LswZOW{sv(|u3 WnB?e}i5?xuKW_6i|M~p?$^QYk4Nm3& literal 0 HcmV?d00001 diff --git a/src/content/docs/focusers/askar/askar-waf/askar-waf.yaml b/src/content/docs/focusers/askar/askar-waf/askar-waf.yaml new file mode 100644 index 0000000..436c167 --- /dev/null +++ b/src/content/docs/focusers/askar/askar-waf/askar-waf.yaml @@ -0,0 +1,11 @@ +# Display Names (Human-Friendly) +driver_name: Askar WAF +categories: ["focusers"] +manufacturer_name: Askar + +# Additional Metadata +website: https://gb.sharpstar-optics.com/ +executable: indi_askar_waf_focus +platforms: Linux, BSD, OSX +author: Jiaxing Ruixing Optical Instrument Co., Ltd. +version: 1.0