93#define NETROTCTL_RET "RPRT "
102#define ROT_RESET_ALL 1
125#define ROT_TYPE_MASK (ROT_FLAG_AZIMUTH|ROT_FLAG_ELEVATION)
138#define ROT_TYPE_OTHER 0
139#define ROT_TYPE_AZIMUTH ROT_FLAG_AZIMUTH
140#define ROT_TYPE_ELEVATION ROT_FLAG_ELEVATION
141#define ROT_TYPE_AZEL (ROT_FLAG_AZIMUTH|ROT_FLAG_ELEVATION)
154#define ROT_MOVE_UP (1<<1)
166#define ROT_MOVE_DOWN (1<<2)
178#define ROT_MOVE_LEFT (1<<3)
191#define ROT_MOVE_CCW ROT_MOVE_LEFT
203#define ROT_MOVE_RIGHT (1<<4)
216#define ROT_MOVE_CW ROT_MOVE_RIGHT
231#define ROT_MOVE_UP_LEFT (1<<5)
246#define ROT_MOVE_UP_CCW ROT_MOVE_UP_LEFT
261#define ROT_MOVE_UP_RIGHT (1<<6)
276#define ROT_MOVE_UP_CW ROT_MOVE_UP_RIGHT
291#define ROT_MOVE_DOWN_LEFT (1 << 7)
307#define ROT_MOVE_DOWN_CCW ROT_MOVE_DOWN_LEFT
322#define ROT_MOVE_DOWN_RIGHT (1 << 8)
337#define ROT_MOVE_DOWN_CW ROT_MOVE_DOWN_RIGHT
362#define HAMLIB_MAX_ROTOR_STATUS 16
366#define ROT_STATUS_N(n) (1u<<(n))
372#define ROT_SPEED_NOCHANGE (-1)
392#define ROT_LEVEL_FLOAT_LIST (0)
394#define ROT_LEVEL_READONLY_LIST (0)
396#define ROT_LEVEL_IS_FLOAT(l) ((l)&ROT_LEVEL_FLOAT_LIST)
397#define ROT_LEVEL_SET(l) ((l)&~ROT_LEVEL_READONLY_LIST)
422#define ROT_PARM_FLOAT_LIST (0)
423#define ROT_PARM_READONLY_LIST (0)
425#define ROT_PARM_IS_FLOAT(l) ((l)&ROT_PARM_FLOAT_LIST)
426#define ROT_PARM_SET(l) ((l)&~ROT_PARM_READONLY_LIST)
444#define ROT_FUNC_NONE 0
447#define ROT_FUNC_BIT63 CONSTANT_64BIT_FLAG (63)
553 int (*
move)(
ROT *rot,
int direction,
int speed);
556 const char * (*get_info)(
ROT *rot);
582#define ROT_MODEL(arg) .rot_model=arg,.macro_name=#arg
633 rig_ptr_t *pstrotator_handler_priv_data;
634 deferred_config_header_t config_queue;
658extern HAMLIB_EXPORT(
ROT *)
661extern HAMLIB_EXPORT(
int)
664extern HAMLIB_EXPORT(
int)
667extern HAMLIB_EXPORT(
int)
670extern HAMLIB_EXPORT(
int)
674extern HAMLIB_EXPORT(
int)
679extern HAMLIB_EXPORT(
int)
680rot_get_conf2 HAMLIB_PARAMS((
ROT *rot,
689extern HAMLIB_EXPORT(
int)
693extern HAMLIB_EXPORT(
int)
698extern HAMLIB_EXPORT(
int)
701extern HAMLIB_EXPORT(
int)
704extern HAMLIB_EXPORT(
int)
708extern HAMLIB_EXPORT(
int)
734extern HAMLIB_EXPORT(
int)
738extern HAMLIB_EXPORT(
int)
743extern HAMLIB_EXPORT(
int)
747extern HAMLIB_EXPORT(
int)
752extern HAMLIB_EXPORT(
int)
756extern HAMLIB_EXPORT(
int)
761extern HAMLIB_EXPORT(
int)
765extern HAMLIB_EXPORT(
int)
770extern HAMLIB_EXPORT(
int)
774extern HAMLIB_EXPORT(
int)
779extern HAMLIB_EXPORT(
int)
783extern HAMLIB_EXPORT(
int)
788extern HAMLIB_EXPORT(
const char *)
791extern HAMLIB_EXPORT(
int)
795extern HAMLIB_EXPORT(
int)
796rot_register HAMLIB_PARAMS((
const struct rot_caps *caps));
798extern HAMLIB_EXPORT(
int)
799rot_unregister HAMLIB_PARAMS((
rot_model_t rot_model));
801extern HAMLIB_EXPORT(
int)
802rot_list_foreach HAMLIB_PARAMS((
int (*cfunc)(
const struct rot_caps *,
806extern HAMLIB_EXPORT(
int)
807rot_load_backend HAMLIB_PARAMS((
const char *be_name));
809extern HAMLIB_EXPORT(
int)
810rot_check_backend HAMLIB_PARAMS((
rot_model_t rot_model));
812extern HAMLIB_EXPORT(
int)
813rot_load_all_backends HAMLIB_PARAMS((
void));
816rot_probe_all HAMLIB_PARAMS((hamlib_port_t *p));
818extern HAMLIB_EXPORT(
int)
824extern HAMLIB_EXPORT(
const struct confparams *)
832extern HAMLIB_EXPORT(
int)
838extern HAMLIB_EXPORT(
int)
844extern HAMLIB_EXPORT(
int)
851extern HAMLIB_EXPORT(
const struct confparams *)
855extern HAMLIB_EXPORT(
const struct confparams *)
862extern HAMLIB_EXPORT(
const struct rot_caps *)
863rot_get_caps HAMLIB_PARAMS((
rot_model_t rot_model));
865extern HAMLIB_EXPORT(
int)
866qrb HAMLIB_PARAMS((
double lon1,
873extern HAMLIB_EXPORT(
double)
876extern HAMLIB_EXPORT(
double)
880extern HAMLIB_EXPORT(
int)
886extern HAMLIB_EXPORT(
int)
889 const char *locator));
892extern HAMLIB_EXPORT(
double)
893dms2dec HAMLIB_PARAMS((
int degrees,
898extern HAMLIB_EXPORT(
int)
899dec2dms HAMLIB_PARAMS((
double dec,
905extern HAMLIB_EXPORT(
int)
911extern HAMLIB_EXPORT(
double)
936#define rot_debug rig_debug
const char * rot_strstatus(rot_status_t status)
Convert enum ROT_STATUS_... to a string.
Definition misc.c:2344
setting_t rot_parse_level(const char *s)
Convert alpha string to enum ROT_LEVEL_...
Definition misc.c:1123
const char * rot_strparm(setting_t parm)
Convert enum ROT_PARM_... to alpha string.
Definition misc.c:1383
const char * rot_strlevel(setting_t level)
Convert enum ROT_LEVEL_... to alpha string.
Definition misc.c:1209
const char * rot_strfunc(setting_t func)
Convert enum ROT_FUNC_... to alpha string.
Definition misc.c:917
setting_t rot_parse_func(const char *s)
Convert alpha string to enum ROT_FUNC_...
Definition misc.c:861
setting_t rot_parse_parm(const char *s)
Convert alpha string to ROT_PARM_...
Definition misc.c:1328
serial_parity_e
Serial parity.
Definition rig.h:333
long hamlib_token_t
configuration token
Definition rig.h:861
uint64_t setting_t
Setting.
Definition rig.h:1202
rig_port_e
Port type.
Definition rig.h:312
serial_handshake_e
Serial handshake.
Definition rig.h:345
#define RIG_SETTING_MAX
Maximum # of rig settings.
Definition rig.h:1208
struct gran gran_t
gran_t type
Definition rig.h:1739
rig_status_e
Development status of the backend.
Definition rig.h:417
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:204
const char * rot_get_info(ROT *rot)
Get general information from the rotator.
Definition rotator.c:1038
int rot_model_t
Convenience type definition for a rotator model.
Definition rotlist.h:723
rot_status_t
Rotator status flags.
Definition rotator.h:342
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:263
rot_parm_e
Rotator Parameters.
Definition rotator.h:416
int rot_get_parm(ROT *rot, setting_t parm, value_t *val)
Query the value of a requested rotator parameter.
Definition rot_settings.c:206
int rot_get_func(ROT *rot, setting_t func, int *status)
Query the status of functions of the rotator.
Definition rot_settings.c:514
int rot_set_parm(ROT *rot, setting_t parm, value_t val)
Set a rotator parameter to a given value.
Definition rot_settings.c:166
int rot_set_conf(ROT *rot, hamlib_token_t token, const char *val)
Set a rotator configuration parameter.
Definition rot_conf.c:746
int rot_reset_t
Type definition for rotator reset.
Definition rotator.h:112
int rot_set_position(ROT *rot, azimuth_t azimuth, elevation_t elevation)
Set the azimuth and elevation of the rotator.
Definition rotator.c:755
int rot_set_func(ROT *rot, setting_t func, int status)
Activate or deactivate functions of a rotator.
Definition rot_settings.c:470
int rot_reset(ROT *rot, rot_reset_t reset)
Reset the rotator.
Definition rotator.c:962
struct s_rot ROT
Main rotator handle type definition.
Definition rotator.h:63
int rot_get_status(ROT *rot, rot_status_t *status)
Query status flags of the rotator.
Definition rotator.c:1071
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:582
int rot_get_level(ROT *rot, setting_t level, value_t *val)
Query the value of a requested rotator level.
Definition rot_settings.c:121
setting_t rot_has_get_level(ROT *rot, setting_t level)
Check which rotator level settings can be queried.
Definition rot_settings.c:248
int rot_get_conf(ROT *rot, hamlib_token_t token, char *val)
Query the value of a rotator configuration parameter.
Definition rot_conf.c:805
int rot_set_level(ROT *rot, setting_t level, value_t val)
Set a rotator level to a given value.
Definition rot_settings.c:77
int rot_set_ext_level(ROT *rot, hamlib_token_t token, value_t val)
Set a rotator extension level to a given value.
Definition rot_settings.c:557
setting_t rot_has_get_parm(ROT *rot, setting_t parm)
Check which rotator parameter settings can be queried.
Definition rot_settings.c:324
rot_level_e
Rotator Level Settings.
Definition rotator.h:384
int rot_park(ROT *rot)
Park the rotator.
Definition rotator.c:887
int rot_set_ext_parm(ROT *rot, hamlib_token_t token, value_t val)
Set a rotator extension parameter to a given value.
Definition rot_settings.c:727
int rot_get_ext_func(ROT *rot, hamlib_token_t token, int *status)
Query the status of extension functions of a rotator.
Definition rot_settings.c:685
void * rot_data_pointer(ROT *rot, rig_ptrx_t idx)
Get the address of rotator data structure(s)
Definition rotator.c:1094
int rot_set_ext_func(ROT *rot, hamlib_token_t token, int status)
Activate or deactivate extension functions of a rotator.
Definition rot_settings.c:641
int rot_move(ROT *rot, int direction, int speed)
Move the rotator in the specified direction and speed.
Definition rotator.c:1003
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:148
setting_t rot_has_set_level(ROT *rot, setting_t level)
Query the rotator levels that may be set.
Definition rot_settings.c:286
int rot_get_position(ROT *rot, azimuth_t *azimuth, elevation_t *elevation)
Query the azimuth and elevation of the rotator.
Definition rotator.c:827
int rot_cleanup(ROT *rot)
Release a ROT handle and free associated memory.
Definition rotator.c:699
int rot_get_ext_parm(ROT *rot, hamlib_token_t token, value_t *val)
Query the value of a requested rotator extension parameter.
Definition rot_settings.c:765
float elevation_t
Type definition for elevation.
Definition rotator.h:75
int rot_get_ext_level(ROT *rot, hamlib_token_t token, value_t *val)
Query the value of a requested rotator extension level.
Definition rot_settings.c:597
rot_type_t
Rotator type flags for bitmasks.
Definition rotator.h:118
const struct confparams * rot_ext_lookup_tok(ROT *rot, hamlib_token_t token)
Searches for an extension levels, functions, or parameters token by its constant value and return a p...
Definition rot_ext.c:315
setting_t rot_has_set_func(ROT *rot, setting_t func)
Query support of rotator functions.
Definition rot_settings.c:434
const struct confparams * rot_confparam_lookup(ROT *rot, const char *name)
Query a rotator configuration parameter token by its name.
Definition rot_conf.c:646
setting_t rot_has_set_parm(ROT *rot, setting_t parm)
Query the rotator parameters that may be set.
Definition rot_settings.c:361
setting_t rot_has_get_func(ROT *rot, setting_t func)
Check which rotator functions can be queried.
Definition rot_settings.c:397
int rot_close(ROT *rot)
Close the communication channel to the rotator.
Definition rotator.c:610
hamlib_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:369
int rot_stop(ROT *rot)
Stop the rotator.
Definition rotator.c:925
hamlib_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:711
float azimuth_t
Type definition for azimuth.
Definition rotator.h:87
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:92
int rot_open(ROT *rot)
Open the communication channel to the rotator.
Definition rotator.c:372
ROT * rot_init(rot_model_t rot_model)
Allocate a new ROT handle.
Definition rotator.c:218
@ ROT_STATUS_OVERLAP_LEFT
Definition rotator.h:358
@ ROT_STATUS_NONE
Definition rotator.h:343
@ ROT_STATUS_LIMIT_LEFT
Definition rotator.h:354
@ ROT_STATUS_OVERLAP_UP
Definition rotator.h:356
@ ROT_STATUS_MOVING_EL
Definition rotator.h:349
@ ROT_STATUS_MOVING_RIGHT
Definition rotator.h:348
@ ROT_STATUS_MOVING_AZ
Definition rotator.h:346
@ ROT_STATUS_MOVING_LEFT
Definition rotator.h:347
@ ROT_STATUS_MOVING
Definition rotator.h:345
@ ROT_STATUS_OVERLAP_RIGHT
Definition rotator.h:359
@ ROT_STATUS_LIMIT_UP
Definition rotator.h:352
@ ROT_STATUS_MOVING_UP
Definition rotator.h:350
@ ROT_STATUS_OVERLAP_DOWN
Definition rotator.h:357
@ ROT_STATUS_LIMIT_DOWN
Definition rotator.h:353
@ ROT_STATUS_LIMIT_RIGHT
Definition rotator.h:355
@ ROT_STATUS_MOVING_DOWN
Definition rotator.h:351
@ ROT_STATUS_BUSY
Definition rotator.h:344
@ ROT_PARM_NONE
Definition rotator.h:417
@ ROT_LEVEL_NONE
Definition rotator.h:385
@ ROT_LEVEL_63
Definition rotator.h:387
@ ROT_LEVEL_SPEED
Definition rotator.h:386
@ ROT_FLAG_ELEVATION
Definition rotator.h:120
@ ROT_FLAG_AZIMUTH
Definition rotator.h:119
int locator2longlat(double *longitude, double *latitude, const char *locator)
Convert QRA locator (Maidenhead grid square) to Longitude/Latitude.
Definition locator.c:451
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:180
int longlat2locator(double longitude, double latitude, char *locator, int pair_count)
Convert longitude/latitude to QRA locator (Maidenhead grid square).
Definition locator.c:545
double azimuth_long_path(double azimuth)
Calculate the long path bearing between two points.
Definition locator.c:759
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:619
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:297
double distance_long_path(double distance)
Calculate the long path distance between two points.
Definition locator.c:739
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:237
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:395
Hamlib rig data structures.
Hamlib rotator model definitions.
Configuration parameter structure.
Definition rig.h:901
Rotator capability data structure.
Definition rotator.h:474
int(* get_func)(ROT *rot, setting_t func, int *status)
Definition rotator.h:562
azimuth_t min_az
Definition rotator.h:518
const char * macro_name
Definition rotator.h:578
setting_t has_set_parm
Definition rotator.h:502
rot_status_t has_status
Definition rotator.h:504
enum rig_port_e port_type
Definition rotator.h:483
enum serial_handshake_e serial_handshake
Definition rotator.h:490
int(* get_parm)(ROT *rot, setting_t parm, value_t *val)
Definition rotator.h:565
int(* get_conf2)(ROT *rot, hamlib_token_t token, char *val, int val_len)
Definition rotator.h:579
int serial_data_bits
Definition rotator.h:487
int(* rot_open)(ROT *rot)
Definition rotator.h:536
setting_t has_set_func
Definition rotator.h:498
int * ext_tokens
Definition rotator.h:512
int(* get_ext_parm)(ROT *rot, hamlib_token_t token, value_t *val)
Definition rotator.h:574
const struct confparams * extfuncs
Definition rotator.h:511
int(* get_conf)(ROT *rot, hamlib_token_t token, char *val)
Definition rotator.h:540
const char * copyright
Definition rotator.h:479
int(* park)(ROT *rot)
Definition rotator.h:551
enum serial_parity_e serial_parity
Definition rotator.h:489
const rig_ptr_t priv
Definition rotator.h:527
int(* rot_cleanup)(ROT *rot)
Definition rotator.h:535
rot_model_t rot_model
Definition rotator.h:475
int post_write_delay
Definition rotator.h:493
int serial_rate_min
Definition rotator.h:485
int write_delay
Definition rotator.h:492
int(* get_ext_level)(ROT *rot, hamlib_token_t token, value_t *val)
Definition rotator.h:568
int(* set_ext_func)(ROT *rot, hamlib_token_t token, int status)
Definition rotator.h:570
setting_t has_get_level
Definition rotator.h:499
int(* get_status)(ROT *rot, rot_status_t *status)
Definition rotator.h:576
int serial_stop_bits
Definition rotator.h:488
int(* set_conf)(ROT *rot, hamlib_token_t token, const char *val)
Definition rotator.h:539
int(* set_ext_level)(ROT *rot, hamlib_token_t token, value_t val)
Definition rotator.h:567
int(* set_position)(ROT *rot, azimuth_t azimuth, elevation_t elevation)
Definition rotator.h:547
const char * version
Definition rotator.h:478
setting_t has_set_level
Definition rotator.h:500
elevation_t min_el
Definition rotator.h:521
int(* move)(ROT *rot, int direction, int speed)
Definition rotator.h:553
gran_t parm_gran[64]
Definition rotator.h:507
int retry
Definition rotator.h:495
int timeout
Definition rotator.h:494
enum rig_status_e status
Definition rotator.h:480
int(* get_level)(ROT *rot, setting_t level, value_t *val)
Definition rotator.h:559
int serial_rate_max
Definition rotator.h:486
int rot_type
Definition rotator.h:482
const char * mfg_name
Definition rotator.h:477
setting_t has_get_parm
Definition rotator.h:501
int(* get_position)(ROT *rot, azimuth_t *azimuth, elevation_t *elevation)
Definition rotator.h:548
setting_t has_get_func
Definition rotator.h:497
int(* reset)(ROT *rot, rot_reset_t reset)
Definition rotator.h:552
int(* rot_init)(ROT *rot)
Definition rotator.h:534
int(* rot_close)(ROT *rot)
Definition rotator.h:537
const struct confparams * extparms
Definition rotator.h:509
elevation_t max_el
Definition rotator.h:523
int(* set_parm)(ROT *rot, setting_t parm, value_t val)
Definition rotator.h:564
int(* set_ext_parm)(ROT *rot, hamlib_token_t token, value_t val)
Definition rotator.h:573
const struct confparams * extlevels
Definition rotator.h:510
azimuth_t max_az
Definition rotator.h:519
const struct confparams * cfgparams
Definition rotator.h:526
int(* get_ext_func)(ROT *rot, hamlib_token_t token, int *status)
Definition rotator.h:571
const char * model_name
Definition rotator.h:476
gran_t level_gran[64]
Definition rotator.h:506
int(* set_level)(ROT *rot, setting_t level, value_t val)
Definition rotator.h:558
int(* stop)(ROT *rot)
Definition rotator.h:550
int(* set_func)(ROT *rot, setting_t func, int status)
Definition rotator.h:561
Rotator state structure.
Definition rotator.h:596
rig_ptr_t obj
Definition rotator.h:628
rig_ptr_t priv
Definition rotator.h:627
setting_t has_set_parm
Definition rotator.h:613
gran_t level_gran[64]
Definition rotator.h:617
azimuth_t az_offset
Definition rotator.h:605
setting_t has_set_func
Definition rotator.h:609
gran_t parm_gran[64]
Definition rotator.h:618
hamlib_port_t_deprecated rotport_deprecated
Definition rotator.h:623
azimuth_t max_az
Definition rotator.h:601
rot_status_t has_status
Definition rotator.h:615
int current_speed
Definition rotator.h:630
hamlib_port_t rotport2
Definition rotator.h:632
hamlib_port_t_deprecated rotport2_deprecated
Definition rotator.h:624
setting_t has_get_parm
Definition rotator.h:612
azimuth_t min_az
Definition rotator.h:600
hamlib_port_t rotport
Definition rotator.h:631
setting_t has_get_func
Definition rotator.h:608
setting_t has_get_level
Definition rotator.h:610
int comm_state
Definition rotator.h:626
elevation_t min_el
Definition rotator.h:602
elevation_t max_el
Definition rotator.h:603
setting_t has_set_level
Definition rotator.h:611
elevation_t el_offset
Definition rotator.h:606
int south_zero
Definition rotator.h:604
Master rotator structure.
Definition rotator.h:649
struct rot_state state
Definition rotator.h:651
struct rot_caps * caps
Definition rotator.h:650
Universal approach for passing values.
Definition rig.h:1026