Hamlib 4.4
rotator.h
Go to the documentation of this file.
1/*
2 * Hamlib Interface - Rotator API header
3 * Copyright (c) 2000-2005 by Stephane Fillod
4 *
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 *
20 */
21
22#ifndef _ROTATOR_H
23#define _ROTATOR_H 1
24
25#include <hamlib/rig.h>
26#include <hamlib/rotlist.h>
27
45__BEGIN_DECLS
46
47/* Forward struct references */
48
49struct rot;
50struct rot_state;
51
52
62typedef struct s_rot ROT;
63
64
74typedef float elevation_t;
75
76
86typedef float azimuth_t;
87
88
92#define NETROTCTL_RET "RPRT "
93
94
101#define ROT_RESET_ALL 1
102
103
111typedef int rot_reset_t;
112
113
117typedef enum {
118 ROT_FLAG_AZIMUTH = (1 << 1),
119 ROT_FLAG_ELEVATION = (1 << 2)
121
123/* So far only used in ests/dumpcaps_rot.c. */
124#define ROT_TYPE_MASK (ROT_FLAG_AZIMUTH|ROT_FLAG_ELEVATION)
126
137#define ROT_TYPE_OTHER 0
138#define ROT_TYPE_AZIMUTH ROT_FLAG_AZIMUTH
139#define ROT_TYPE_ELEVATION ROT_FLAG_ELEVATION
140#define ROT_TYPE_AZEL (ROT_FLAG_AZIMUTH|ROT_FLAG_ELEVATION)
141
142
153#define ROT_MOVE_UP (1<<1)
154
165#define ROT_MOVE_DOWN (1<<2)
166
177#define ROT_MOVE_LEFT (1<<3)
178
190#define ROT_MOVE_CCW ROT_MOVE_LEFT
191
202#define ROT_MOVE_RIGHT (1<<4)
203
215#define ROT_MOVE_CW ROT_MOVE_RIGHT
216
217
221typedef enum {
223 ROT_STATUS_BUSY = (1 << 0),
224 ROT_STATUS_MOVING = (1 << 1),
240
242/* So far only used in tests/sprintflst.c. */
243#define ROT_STATUS_N(n) (1u<<(n))
245
249#define ROT_SPEED_NOCHANGE (-1)
250
251
263 ROT_LEVEL_SPEED = (1 << 0),
264 ROT_LEVEL_63 = CONSTANT_64BIT_FLAG(63),
265};
266
267
269#define ROT_LEVEL_FLOAT_LIST (0)
270
271#define ROT_LEVEL_READONLY_LIST (0)
272
273#define ROT_LEVEL_IS_FLOAT(l) ((l)&ROT_LEVEL_FLOAT_LIST)
274#define ROT_LEVEL_SET(l) ((l)&~ROT_LEVEL_READONLY_LIST)
276
277
295};
296
297
299#define ROT_PARM_FLOAT_LIST (0)
300#define ROT_PARM_READONLY_LIST (0)
301
302#define ROT_PARM_IS_FLOAT(l) ((l)&ROT_PARM_FLOAT_LIST)
303#define ROT_PARM_SET(l) ((l)&~ROT_PARM_READONLY_LIST)
305
306
321#define ROT_FUNC_NONE 0
322#ifndef SWIGLUAHIDE
323/* Hide the top 32 bits from the old Lua binding as they can't be represented */
324#define ROT_FUNC_BIT63 CONSTANT_64BIT_FLAG (63)
325/* 63 is this highest bit number that can be used */
326#endif
327
328
329/* Basic rot type, can store some useful info about different rotators. Each
330 * lib must be able to populate this structure, so we can make useful
331 * enquiries about capabilities.
332 */
333
351struct rot_caps {
353 const char *model_name;
354 const char *mfg_name;
355 const char *version;
356 const char *copyright;
372 int retry;
386 const struct confparams *extparms;
387 const struct confparams *extlevels;
388 const struct confparams *extfuncs;
391 /*
392 * Movement range, az is relative to North
393 * negative values allowed for overlap
394 */
403 const struct confparams *cfgparams;
404 const rig_ptr_t priv;
406 /*
407 * Rot Admin API
408 *
409 */
410
411 int (*rot_init)(ROT *rot);
412 int (*rot_cleanup)(ROT *rot);
413 int (*rot_open)(ROT *rot);
414 int (*rot_close)(ROT *rot);
416 int (*set_conf)(ROT *rot, token_t token, const char *val);
417 int (*get_conf)(ROT *rot, token_t token, char *val);
419 /*
420 * General API commands, from most primitive to least.. :()
421 * List Set/Get functions pairs
422 */
423
424 int (*set_position)(ROT *rot, azimuth_t azimuth, elevation_t elevation);
425 int (*get_position)(ROT *rot, azimuth_t *azimuth, elevation_t *elevation);
427 int (*stop)(ROT *rot);
428 int (*park)(ROT *rot);
429 int (*reset)(ROT *rot, rot_reset_t reset);
430 int (*move)(ROT *rot, int direction, int speed);
432 /* get firmware info, etc. */
433 const char * (*get_info)(ROT *rot);
435 int (*set_level)(ROT *rot, setting_t level, value_t val);
436 int (*get_level)(ROT *rot, setting_t level, value_t *val);
438 int (*set_func)(ROT *rot, setting_t func, int status);
439 int (*get_func)(ROT *rot, setting_t func, int *status);
441 int (*set_parm)(ROT *rot, setting_t parm, value_t val);
442 int (*get_parm)(ROT *rot, setting_t parm, value_t *val);
444 int (*set_ext_level)(ROT *rot, token_t token, value_t val);
445 int (*get_ext_level)(ROT *rot, token_t token, value_t *val);
447 int (*set_ext_func)(ROT *rot, token_t token, int status);
448 int (*get_ext_func)(ROT *rot, token_t token, int *status);
450 int (*set_ext_parm)(ROT *rot, token_t token, value_t val);
451 int (*get_ext_parm)(ROT *rot, token_t token, value_t *val);
455 const char *macro_name;
456};
458#define ROT_MODEL(arg) .rot_model=arg,.macro_name=#arg
460
461
472struct rot_state {
473 /*
474 * overridable fields
475 */
496 /*
497 * non overridable fields, internal use
498 */
499 hamlib_port_t rotport;
500 hamlib_port_t rotport2;
503 rig_ptr_t priv;
504 rig_ptr_t obj;
507 /* etc... */
508};
509
510
522struct s_rot {
523 struct rot_caps *caps;
525};
526
527
529/* --------------- API function prototypes -----------------*/
530
531extern HAMLIB_EXPORT(ROT *)
532rot_init HAMLIB_PARAMS((rot_model_t rot_model));
533
534extern HAMLIB_EXPORT(int)
535rot_open HAMLIB_PARAMS((ROT *rot));
536
537extern HAMLIB_EXPORT(int)
538rot_close HAMLIB_PARAMS((ROT *rot));
539
540extern HAMLIB_EXPORT(int)
541rot_cleanup HAMLIB_PARAMS((ROT *rot));
542
543extern HAMLIB_EXPORT(int)
544rot_set_conf HAMLIB_PARAMS((ROT *rot,
545 token_t token,
546 const char *val));
547extern HAMLIB_EXPORT(int)
548rot_get_conf HAMLIB_PARAMS((ROT *rot,
549 token_t token,
550 char *val));
551
552/*
553 * General API commands, from most primitive to least.. )
554 * List Set/Get functions pairs
555 */
556extern HAMLIB_EXPORT(int)
557rot_set_position HAMLIB_PARAMS((ROT *rot,
558 azimuth_t azimuth,
559 elevation_t elevation));
560extern HAMLIB_EXPORT(int)
561rot_get_position HAMLIB_PARAMS((ROT *rot,
562 azimuth_t *azimuth,
563 elevation_t *elevation));
564
565extern HAMLIB_EXPORT(int)
566rot_stop HAMLIB_PARAMS((ROT *rot));
567
568extern HAMLIB_EXPORT(int)
569rot_park HAMLIB_PARAMS((ROT *rot));
570
571extern HAMLIB_EXPORT(int)
572rot_reset HAMLIB_PARAMS((ROT *rot,
573 rot_reset_t reset));
574
575extern HAMLIB_EXPORT(int)
576rot_move HAMLIB_PARAMS((ROT *rot,
577 int direction,
578 int speed));
579
580extern HAMLIB_EXPORT(setting_t)
581rot_has_get_level HAMLIB_PARAMS((ROT *rot,
582 setting_t level));
583extern HAMLIB_EXPORT(setting_t)
584rot_has_set_level HAMLIB_PARAMS((ROT *rot,
585 setting_t level));
586
587extern HAMLIB_EXPORT(setting_t)
588rot_has_get_parm HAMLIB_PARAMS((ROT *rot,
589 setting_t parm));
590extern HAMLIB_EXPORT(setting_t)
591rot_has_set_parm HAMLIB_PARAMS((ROT *rot,
592 setting_t parm));
593
594extern HAMLIB_EXPORT(setting_t)
595rot_has_get_func HAMLIB_PARAMS((ROT *rot,
596 setting_t func));
597extern HAMLIB_EXPORT(setting_t)
598rot_has_set_func HAMLIB_PARAMS((ROT *rot,
599 setting_t func));
600
601extern HAMLIB_EXPORT(int)
602rot_set_func HAMLIB_PARAMS((ROT *rot,
603 setting_t func,
604 int status));
605extern HAMLIB_EXPORT(int)
606rot_get_func HAMLIB_PARAMS((ROT *rot,
607 setting_t func,
608 int *status));
609
610extern HAMLIB_EXPORT(int)
611rot_set_level HAMLIB_PARAMS((ROT *rig,
612 setting_t level,
613 value_t val));
614extern HAMLIB_EXPORT(int)
615rot_get_level HAMLIB_PARAMS((ROT *rig,
616 setting_t level,
617 value_t *val));
618
619extern HAMLIB_EXPORT(int)
620rot_set_parm HAMLIB_PARAMS((ROT *rig,
621 setting_t parm,
622 value_t val));
623extern HAMLIB_EXPORT(int)
624rot_get_parm HAMLIB_PARAMS((ROT *rig,
625 setting_t parm,
626 value_t *val));
627
628extern HAMLIB_EXPORT(int)
629rot_set_ext_level HAMLIB_PARAMS((ROT *rig,
630 token_t token,
631 value_t val));
632extern HAMLIB_EXPORT(int)
633rot_get_ext_level HAMLIB_PARAMS((ROT *rig,
634 token_t token,
635 value_t *val));
636
637extern HAMLIB_EXPORT(int)
638rot_set_ext_func HAMLIB_PARAMS((ROT *rig,
639 token_t token,
640 int status));
641extern HAMLIB_EXPORT(int)
642rot_get_ext_func HAMLIB_PARAMS((ROT *rig,
643 token_t token,
644 int *status));
645
646extern HAMLIB_EXPORT(int)
647rot_set_ext_parm HAMLIB_PARAMS((ROT *rig,
648 token_t token,
649 value_t val));
650extern HAMLIB_EXPORT(int)
651rot_get_ext_parm HAMLIB_PARAMS((ROT *rig,
652 token_t token,
653 value_t *val));
654
655extern HAMLIB_EXPORT(const char *)
656rot_get_info HAMLIB_PARAMS((ROT *rot));
657
658extern HAMLIB_EXPORT(int)
659rot_get_status HAMLIB_PARAMS((ROT *rot,
660 rot_status_t *status));
661
662extern HAMLIB_EXPORT(int)
663rot_register HAMLIB_PARAMS((const struct rot_caps *caps));
664
665extern HAMLIB_EXPORT(int)
666rot_unregister HAMLIB_PARAMS((rot_model_t rot_model));
667
668extern HAMLIB_EXPORT(int)
669rot_list_foreach HAMLIB_PARAMS((int (*cfunc)(const struct rot_caps *,
670 rig_ptr_t),
671 rig_ptr_t data));
672
673extern HAMLIB_EXPORT(int)
674rot_load_backend HAMLIB_PARAMS((const char *be_name));
675
676extern HAMLIB_EXPORT(int)
677rot_check_backend HAMLIB_PARAMS((rot_model_t rot_model));
678
679extern HAMLIB_EXPORT(int)
680rot_load_all_backends HAMLIB_PARAMS((void));
681
682extern HAMLIB_EXPORT(rot_model_t)
683rot_probe_all HAMLIB_PARAMS((hamlib_port_t *p));
684
685extern HAMLIB_EXPORT(int)
686rot_token_foreach HAMLIB_PARAMS((ROT *rot,
687 int (*cfunc)(const struct confparams *,
688 rig_ptr_t),
689 rig_ptr_t data));
690
691extern HAMLIB_EXPORT(const struct confparams *)
692rot_confparam_lookup HAMLIB_PARAMS((ROT *rot,
693 const char *name));
694
695extern HAMLIB_EXPORT(token_t)
696rot_token_lookup HAMLIB_PARAMS((ROT *rot,
697 const char *name));
698
699extern HAMLIB_EXPORT(int)
700rot_ext_func_foreach HAMLIB_PARAMS((ROT *rot,
701 int (*cfunc)(ROT *,
702 const struct confparams *,
703 rig_ptr_t),
704 rig_ptr_t data));
705extern HAMLIB_EXPORT(int)
706rot_ext_level_foreach HAMLIB_PARAMS((ROT *rot,
707 int (*cfunc)(ROT *,
708 const struct confparams *,
709 rig_ptr_t),
710 rig_ptr_t data));
711extern HAMLIB_EXPORT(int)
712rot_ext_parm_foreach HAMLIB_PARAMS((ROT *rot,
713 int (*cfunc)(ROT *,
714 const struct confparams *,
715 rig_ptr_t),
716 rig_ptr_t data));
717
718extern HAMLIB_EXPORT(const struct confparams *)
719rot_ext_lookup HAMLIB_PARAMS((ROT *rot,
720 const char *name));
721
722extern HAMLIB_EXPORT(const struct confparams *)
723rot_ext_lookup_tok HAMLIB_PARAMS((ROT *rot,
724 token_t token));
725extern HAMLIB_EXPORT(token_t)
726rot_ext_token_lookup HAMLIB_PARAMS((ROT *rot,
727 const char *name));
728
729extern HAMLIB_EXPORT(const struct rot_caps *)
730rot_get_caps HAMLIB_PARAMS((rot_model_t rot_model));
731
732extern HAMLIB_EXPORT(int)
733qrb HAMLIB_PARAMS((double lon1,
734 double lat1,
735 double lon2,
736 double lat2,
737 double *distance,
738 double *azimuth));
739
740extern HAMLIB_EXPORT(double)
741distance_long_path HAMLIB_PARAMS((double distance));
742
743extern HAMLIB_EXPORT(double)
744azimuth_long_path HAMLIB_PARAMS((double azimuth));
745
746extern HAMLIB_EXPORT(int)
747longlat2locator HAMLIB_PARAMS((double longitude,
748 double latitude,
749 char *locator_res,
750 int pair_count));
751
752extern HAMLIB_EXPORT(int)
753locator2longlat HAMLIB_PARAMS((double *longitude,
754 double *latitude,
755 const char *locator));
756
757extern HAMLIB_EXPORT(double)
758dms2dec HAMLIB_PARAMS((int degrees,
759 int minutes,
760 double seconds,
761 int sw));
762
763extern HAMLIB_EXPORT(int)
764dec2dms HAMLIB_PARAMS((double dec,
765 int *degrees,
766 int *minutes,
767 double *seconds,
768 int *sw));
769
770extern HAMLIB_EXPORT(int)
771dec2dmmm HAMLIB_PARAMS((double dec,
772 int *degrees,
773 double *minutes,
774 int *sw));
775
776extern HAMLIB_EXPORT(double)
777dmmm2dec HAMLIB_PARAMS((int degrees,
778 double minutes,
779 double seconds,
780 int sw));
781
782extern HAMLIB_EXPORT(setting_t) rot_parse_func(const char *s);
783extern HAMLIB_EXPORT(setting_t) rot_parse_level(const char *s);
784extern HAMLIB_EXPORT(setting_t) rot_parse_parm(const char *s);
785extern HAMLIB_EXPORT(const char *) rot_strfunc(setting_t);
786extern HAMLIB_EXPORT(const char *) rot_strlevel(setting_t);
787extern HAMLIB_EXPORT(const char *) rot_strparm(setting_t);
788extern HAMLIB_EXPORT(const char *) rot_strstatus(rot_status_t);
789
791
799#define rot_debug rig_debug
800
801__END_DECLS
802
803#endif /* _ROTATOR_H */
804
setting_t rot_parse_level(const char *s)
Convert alpha string to enum ROT_LEVEL_...
Definition: misc.c:952
const char * rot_strparm(setting_t parm)
Convert enum ROT_PARM_... to alpha string.
Definition: misc.c:1206
const char * rot_strlevel(setting_t level)
Convert enum ROT_LEVEL_... to alpha string.
Definition: misc.c:1038
const char * rot_strfunc(setting_t func)
Convert enum ROT_FUNC_... to alpha string.
Definition: misc.c:810
setting_t rot_parse_func(const char *s)
Convert alpha string to enum ROT_FUNC_...
Definition: misc.c:754
setting_t rot_parse_parm(const char *s)
Convert alpha string to ROT_PARM_...
Definition: misc.c:1151
serial_parity_e
Serial parity.
Definition: rig.h:261
token_t token
Definition: rig.h:739
uint64_t setting_t
Setting.
Definition: rig.h:1036
rig_port_e
Port type.
Definition: rig.h:240
serial_handshake_e
Serial handshake.
Definition: rig.h:273
#define RIG_SETTING_MAX
Maximum # of rig settings.
Definition: rig.h:1042
long token_t
configuration token
Definition: rig.h:699
rig_status_e
Development status of the backend.
Definition: rig.h:327
int rot_ext_parm_foreach(ROT *rot, int(*cfunc)(ROT *, const struct confparams *, rig_ptr_t), rig_ptr_t data)
Executes cfunc on all the elements stored in the rot_caps::extparms extension parameters table.
Definition: rot_ext.c:206
const char * rot_get_info(ROT *rot)
Get general information from the rotator.
Definition: rotator.c:928
int rot_model_t
Convenience type definition for a rotator model.
Definition: rotlist.h:632
rot_status_t
Rotator status flags.
Definition: rotator.h:221
const struct confparams * rot_ext_lookup(ROT *rot, const char *name)
Lookup an extension functions, levels, or parameters token by its name and return a pointer to the co...
Definition: rot_ext.c:265
rot_parm_e
Rotator Parameters.
Definition: rotator.h:293
int rot_get_parm(ROT *rot, setting_t parm, value_t *val)
Query the value of a requested rotator parameter.
Definition: rot_settings.c:213
int rot_get_func(ROT *rot, setting_t func, int *status)
Query the status of functions of the rotator.
Definition: rot_settings.c:521
int rot_set_parm(ROT *rot, setting_t parm, value_t val)
Set a rotator parameter to a given value.
Definition: rot_settings.c:173
int rot_get_conf(ROT *rot, token_t token, char *val)
Query the value of a rotator configuration parameter.
Definition: rot_conf.c:759
int rot_set_ext_func(ROT *rot, token_t token, int status)
Activate or deactivate extension functions of a rotator.
Definition: rot_settings.c:648
int rot_reset_t
Type definition for rotator reset.
Definition: rotator.h:111
int rot_set_position(ROT *rot, azimuth_t azimuth, elevation_t elevation)
Set the azimuth and elevation of the rotator.
Definition: rotator.c:646
int rot_set_func(ROT *rot, setting_t func, int status)
Activate or deactivate functions of a rotator.
Definition: rot_settings.c:477
int rot_reset(ROT *rot, rot_reset_t reset)
Reset the rotator.
Definition: rotator.c:853
int rot_get_status(ROT *rot, rot_status_t *status)
Query status flags of the rotator.
Definition: rotator.c:961
int rot_token_foreach(ROT *rot, int(*cfunc)(const struct confparams *, rig_ptr_t), rig_ptr_t data)
Executes cfunc on all the elements stored in the configuration parameters table.
Definition: rot_conf.c:539
int rot_set_ext_level(ROT *rot, token_t token, value_t val)
Set a rotator extension level to a given value.
Definition: rot_settings.c:564
int rot_get_level(ROT *rot, setting_t level, value_t *val)
Query the value of a requested rotator level.
Definition: rot_settings.c:128
setting_t rot_has_get_level(ROT *rot, setting_t level)
Check which rotator level settings can be queried.
Definition: rot_settings.c:255
int rot_set_level(ROT *rot, setting_t level, value_t val)
Set a rotator level to a given value.
Definition: rot_settings.c:84
token_t rot_ext_token_lookup(ROT *rot, const char *name)
Simple search returning the extension token ID associated with name.
Definition: rot_ext.c:370
setting_t rot_has_get_parm(ROT *rot, setting_t parm)
Check which rotator parameter settings can be queried.
Definition: rot_settings.c:331
rot_level_e
Rotator Level Settings.
Definition: rotator.h:261
int rot_park(ROT *rot)
Park the rotator.
Definition: rotator.c:778
token_t rot_token_lookup(ROT *rot, const char *name)
Search for the token ID associated with a rotator configuration parameter token name.
Definition: rot_conf.c:668
int rot_move(ROT *rot, int direction, int speed)
Move the rotator in the specified direction and speed.
Definition: rotator.c:893
int rot_ext_level_foreach(ROT *rot, int(*cfunc)(ROT *, const struct confparams *, rig_ptr_t), rig_ptr_t data)
Executes cfunc on all the elements stored in the rot_caps::extlevels extension levels table.
Definition: rot_ext.c:150
setting_t rot_has_set_level(ROT *rot, setting_t level)
Query the rotator levels that may be set.
Definition: rot_settings.c:293
int rot_get_position(ROT *rot, azimuth_t *azimuth, elevation_t *elevation)
Query the azimuth and elevation of the rotator.
Definition: rotator.c:718
int rot_cleanup(ROT *rot)
Release a ROT handle and free associated memory.
Definition: rotator.c:592
float elevation_t
Type definition for elevation.
Definition: rotator.h:74
rot_type_t
Rotator type flags for bitmasks.
Definition: rotator.h:117
setting_t rot_has_set_func(ROT *rot, setting_t func)
Query support of rotator functions.
Definition: rot_settings.c:441
const struct confparams * rot_confparam_lookup(ROT *rot, const char *name)
Query a rotator configuration parameter token by its name.
Definition: rot_conf.c:603
int rot_get_ext_parm(ROT *rot, token_t token, value_t *val)
Query the value of a requested rotator extension parameter.
Definition: rot_settings.c:772
setting_t rot_has_set_parm(ROT *rot, setting_t parm)
Query the rotator parameters that may be set.
Definition: rot_settings.c:368
setting_t rot_has_get_func(ROT *rot, setting_t func)
Check which rotator functions can be queried.
Definition: rot_settings.c:404
int rot_close(ROT *rot)
Close the communication channel to the rotator.
Definition: rotator.c:507
int rot_get_ext_level(ROT *rot, token_t token, value_t *val)
Query the value of a requested rotator extension level.
Definition: rot_settings.c:604
const struct confparams * rot_ext_lookup_tok(ROT *rot, token_t token)
Searches for an extension levels, functions, or parameters token by its constant value and return a p...
Definition: rot_ext.c:317
int rot_stop(ROT *rot)
Stop the rotator.
Definition: rotator.c:816
int rot_set_ext_parm(ROT *rot, token_t token, value_t val)
Set a rotator extension parameter to a given value.
Definition: rot_settings.c:734
int rot_get_ext_func(ROT *rot, token_t token, int *status)
Query the status of extension functions of a rotator.
Definition: rot_settings.c:692
float azimuth_t
Type definition for azimuth.
Definition: rotator.h:86
int rot_set_conf(ROT *rot, token_t token, const char *val)
Set a rotator configuration parameter.
Definition: rot_conf.c:703
int rot_ext_func_foreach(ROT *rot, int(*cfunc)(ROT *, const struct confparams *, rig_ptr_t), rig_ptr_t data)
Executes cfunc on all the elements stored in the rot_caps::extfuncs table.
Definition: rot_ext.c:94
int rot_open(ROT *rot)
Open the communication channel to the rotator.
Definition: rotator.c:355
ROT * rot_init(rot_model_t rot_model)
Allocate a new ROT handle.
Definition: rotator.c:218
@ ROT_STATUS_OVERLAP_LEFT
Definition: rotator.h:237
@ ROT_STATUS_NONE
Definition: rotator.h:222
@ ROT_STATUS_LIMIT_LEFT
Definition: rotator.h:233
@ ROT_STATUS_OVERLAP_UP
Definition: rotator.h:235
@ ROT_STATUS_MOVING_EL
Definition: rotator.h:228
@ ROT_STATUS_MOVING_RIGHT
Definition: rotator.h:227
@ ROT_STATUS_MOVING_AZ
Definition: rotator.h:225
@ ROT_STATUS_MOVING_LEFT
Definition: rotator.h:226
@ ROT_STATUS_MOVING
Definition: rotator.h:224
@ ROT_STATUS_OVERLAP_RIGHT
Definition: rotator.h:238
@ ROT_STATUS_LIMIT_UP
Definition: rotator.h:231
@ ROT_STATUS_MOVING_UP
Definition: rotator.h:229
@ ROT_STATUS_OVERLAP_DOWN
Definition: rotator.h:236
@ ROT_STATUS_LIMIT_DOWN
Definition: rotator.h:232
@ ROT_STATUS_LIMIT_RIGHT
Definition: rotator.h:234
@ ROT_STATUS_MOVING_DOWN
Definition: rotator.h:230
@ ROT_STATUS_BUSY
Definition: rotator.h:223
@ ROT_PARM_NONE
Definition: rotator.h:294
@ ROT_LEVEL_NONE
Definition: rotator.h:262
@ ROT_LEVEL_63
Definition: rotator.h:264
@ ROT_LEVEL_SPEED
Definition: rotator.h:263
@ ROT_FLAG_ELEVATION
Definition: rotator.h:119
@ ROT_FLAG_AZIMUTH
Definition: rotator.h:118
int locator2longlat(double *longitude, double *latitude, const char *locator)
Convert QRA locator (Maidenhead grid square) to Longitude/Latitude.
Definition: locator.c:454
double dms2dec(int degrees, int minutes, double seconds, int sw)
Convert Degrees Minutes Seconds (DMS) notation to decimal degrees (D.DDD) angle.
Definition: locator.c:183
int longlat2locator(double longitude, double latitude, char *locator, int pair_count)
Convert longitude/latitude to QRA locator (Maidenhead grid square).
Definition: locator.c:548
double azimuth_long_path(double azimuth)
Calculate the long path bearing between two points.
Definition: locator.c:762
int qrb(double lon1, double lat1, double lon2, double lat2, double *distance, double *azimuth)
Calculate the distance and bearing between two points.
Definition: locator.c:622
int dec2dms(double dec, int *degrees, int *minutes, double *seconds, int *sw)
Convert a decimal degrees (D.DDD) angle into Degrees Minutes Seconds (DMS) notation.
Definition: locator.c:300
double distance_long_path(double distance)
Calculate the long path distance between two points.
Definition: locator.c:742
double dmmm2dec(int degrees, double minutes, double seconds, int sw)
Convert degrees decimal minutes (D M.MMM) notation to decimal degrees (D.DDD) angle.
Definition: locator.c:240
int dec2dmmm(double dec, int *degrees, double *minutes, int *sw)
Convert a decimal degrees (D.DDD) angle into degrees decimal minutes (D M.MMM) notation.
Definition: locator.c:398
Hamlib rig data structures.
Hamlib rotator model definitions.
Configuration parameter structure.
Definition: rig.h:738
level/parm granularity definition
Definition: rig.h:1550
Rotator capability data structure.
Definition: rotator.h:351
int(* get_func)(ROT *rot, setting_t func, int *status)
Definition: rotator.h:439
azimuth_t min_az
Definition: rotator.h:395
const char * macro_name
Definition: rotator.h:455
setting_t has_set_parm
Definition: rotator.h:379
rot_status_t has_status
Definition: rotator.h:381
int(* get_ext_parm)(ROT *rot, token_t token, value_t *val)
Definition: rotator.h:451
enum rig_port_e port_type
Definition: rotator.h:360
enum serial_handshake_e serial_handshake
Definition: rotator.h:367
int(* get_parm)(ROT *rot, setting_t parm, value_t *val)
Definition: rotator.h:442
int serial_data_bits
Definition: rotator.h:364
int(* set_ext_parm)(ROT *rot, token_t token, value_t val)
Definition: rotator.h:450
int(* rot_open)(ROT *rot)
Definition: rotator.h:413
setting_t has_set_func
Definition: rotator.h:375
int * ext_tokens
Definition: rotator.h:389
const struct confparams * extfuncs
Definition: rotator.h:388
const char * copyright
Definition: rotator.h:356
int(* park)(ROT *rot)
Definition: rotator.h:428
enum serial_parity_e serial_parity
Definition: rotator.h:366
const rig_ptr_t priv
Definition: rotator.h:404
int(* rot_cleanup)(ROT *rot)
Definition: rotator.h:412
rot_model_t rot_model
Definition: rotator.h:352
int post_write_delay
Definition: rotator.h:370
int serial_rate_min
Definition: rotator.h:362
int write_delay
Definition: rotator.h:369
setting_t has_get_level
Definition: rotator.h:376
int(* get_status)(ROT *rot, rot_status_t *status)
Definition: rotator.h:453
int serial_stop_bits
Definition: rotator.h:365
int(* set_position)(ROT *rot, azimuth_t azimuth, elevation_t elevation)
Definition: rotator.h:424
int(* get_ext_func)(ROT *rot, token_t token, int *status)
Definition: rotator.h:448
const char * version
Definition: rotator.h:355
setting_t has_set_level
Definition: rotator.h:377
elevation_t min_el
Definition: rotator.h:398
int(* move)(ROT *rot, int direction, int speed)
Definition: rotator.h:430
gran_t parm_gran[64]
Definition: rotator.h:384
int retry
Definition: rotator.h:372
int timeout
Definition: rotator.h:371
enum rig_status_e status
Definition: rotator.h:357
int(* get_level)(ROT *rot, setting_t level, value_t *val)
Definition: rotator.h:436
int serial_rate_max
Definition: rotator.h:363
int rot_type
Definition: rotator.h:359
const char * mfg_name
Definition: rotator.h:354
setting_t has_get_parm
Definition: rotator.h:378
int(* get_ext_level)(ROT *rot, token_t token, value_t *val)
Definition: rotator.h:445
int(* get_position)(ROT *rot, azimuth_t *azimuth, elevation_t *elevation)
Definition: rotator.h:425
setting_t has_get_func
Definition: rotator.h:374
int(* reset)(ROT *rot, rot_reset_t reset)
Definition: rotator.h:429
int(* set_ext_func)(ROT *rot, token_t token, int status)
Definition: rotator.h:447
int(* rot_init)(ROT *rot)
Definition: rotator.h:411
int(* rot_close)(ROT *rot)
Definition: rotator.h:414
const struct confparams * extparms
Definition: rotator.h:386
elevation_t max_el
Definition: rotator.h:400
int(* set_parm)(ROT *rot, setting_t parm, value_t val)
Definition: rotator.h:441
int(* set_ext_level)(ROT *rot, token_t token, value_t val)
Definition: rotator.h:444
int(* set_conf)(ROT *rot, token_t token, const char *val)
Definition: rotator.h:416
int(* get_conf)(ROT *rot, token_t token, char *val)
Definition: rotator.h:417
const struct confparams * extlevels
Definition: rotator.h:387
azimuth_t max_az
Definition: rotator.h:396
const struct confparams * cfgparams
Definition: rotator.h:403
const char * model_name
Definition: rotator.h:353
gran_t level_gran[64]
Definition: rotator.h:383
int(* set_level)(ROT *rot, setting_t level, value_t val)
Definition: rotator.h:435
int(* stop)(ROT *rot)
Definition: rotator.h:427
int(* set_func)(ROT *rot, setting_t func, int status)
Definition: rotator.h:438
Rotator state structure.
Definition: rotator.h:472
rig_ptr_t obj
Definition: rotator.h:504
rig_ptr_t priv
Definition: rotator.h:503
setting_t has_set_parm
Definition: rotator.h:489
gran_t level_gran[64]
Definition: rotator.h:493
azimuth_t az_offset
Definition: rotator.h:481
setting_t has_set_func
Definition: rotator.h:485
gran_t parm_gran[64]
Definition: rotator.h:494
azimuth_t max_az
Definition: rotator.h:477
rot_status_t has_status
Definition: rotator.h:491
int current_speed
Definition: rotator.h:506
hamlib_port_t rotport2
Definition: rotator.h:500
setting_t has_get_parm
Definition: rotator.h:488
azimuth_t min_az
Definition: rotator.h:476
hamlib_port_t rotport
Definition: rotator.h:499
setting_t has_get_func
Definition: rotator.h:484
setting_t has_get_level
Definition: rotator.h:486
int comm_state
Definition: rotator.h:502
elevation_t min_el
Definition: rotator.h:478
elevation_t max_el
Definition: rotator.h:479
setting_t has_set_level
Definition: rotator.h:487
elevation_t el_offset
Definition: rotator.h:482
int south_zero
Definition: rotator.h:480
Master rotator structure.
Definition: rotator.h:522
struct rot_state state
Definition: rotator.h:524
struct rot_caps * caps
Definition: rotator.h:523
Universal approach for passing values.
Definition: rig.h:875