|
2 | 2 |
|
3 | 3 | Packages in this repo provide interfaces, API, examples for [MBARI WEC](https://github.com/osrf/mbari_wec/tree/main). |
4 | 4 |
|
5 | | -Complete examples starting from template repositories may be found here: |
6 | | -[Python linear damper](https://github.com/mbari-org/mbari_wec_template_py/tree/linear_damper_example) |
| 5 | +Documentation on API, messages, and services may be found here: |
| 6 | +[Python API](https://osrf.github.io/mbari_wec/main/ROS2/python_api/) |
| 7 | +[C++ API](https://osrf.github.io/mbari_wec/main/ROS2/cpp_api/) |
| 8 | +[ROS 2 Interfaces](https://osrf.github.io/mbari_wec/main/ROS2/messages/) |
| 9 | + |
| 10 | +Complete examples starting from template repositories may be found here: |
| 11 | +[Python linear damper](https://github.com/mbari-org/mbari_wec_template_py/tree/linear_damper_example) |
7 | 12 | [C++ linear damper](https://github.com/mbari-org/mbari_wec_template_cpp/tree/linear_damper_example) |
8 | 13 |
|
9 | 14 | And tutorials may be found [here](https://osrf.github.io/mbari_wec/main/tutorials). |
10 | 15 |
|
11 | 16 | For more information about ROS 2 interfaces, see [docs.ros.org](https://docs.ros.org/en/rolling/Concepts/About-ROS-Interfaces.html). |
12 | 17 |
|
13 | | -## Messages (.msg) |
14 | | -Collection of telemetry (feedback) from buoy sensors and microcontrollers. |
15 | | - |
16 | | -### Telemetry |
17 | | -Telemetry data from sensors available per microcontroller |
18 | | - |
19 | | -- type: `BCRecord` |
20 | | - topic: `/bc_record` |
21 | | - Description: (TODO) battery data |
22 | | - |
23 | | -- type: `PCRecord` |
24 | | - topic: `/pc_record` |
25 | | - Description: (TODO) power controller data |
26 | | - |
27 | | -- type: `SCRecord` |
28 | | - topic: `/sc_record` |
29 | | - Description: (TODO) spring controller data |
30 | | - |
31 | | -- type: `TFRecord` |
32 | | - topic: `/tf_record` |
33 | | - Description: (TODO) trefoil data |
34 | | - |
35 | | -- type: `XBRecord` |
36 | | - topic: `/xb_record` |
37 | | - Description: (TODO) Crossbow AHRS data |
38 | | - |
39 | | -### Consolidated (Time-Synchronized) Telemetry |
40 | | -Snapshot in time of all data from the buoy. |
41 | | - |
42 | | -- type: `PBRecord` |
43 | | - topic: `/pb_record` |
44 | | - Description: TODO |
45 | | - |
46 | | -## Services (.srv) |
47 | | -Collection of commands to configure/control the Power Buoy. |
48 | | - |
49 | | -### Power Microcontroller |
50 | | -Services available to configure the Power Microcontroller. |
51 | | - |
52 | | -- type: `PCBattSwitchCommand` |
53 | | - topic: `/pc_batt_switch_command` |
54 | | - args: OFF, ON (enum) |
55 | | - Description: TODO |
56 | | - |
57 | | -- type: `PCBiasCurrCommand` |
58 | | - topic: `/pc_bias_curr_command` |
59 | | - args: -15.0 to +15.0 (float, amps) |
60 | | - Description: TODO |
61 | | - |
62 | | -- type: `PCChargeCurrLimCommand` |
63 | | - topic: `/pc_charge_curr_lim_command` |
64 | | - args: 2.0 to 12.0 (float, amps) |
65 | | - Description: TODO |
66 | | - |
67 | | -- type: `PCDrawCurrLimCommand` |
68 | | - topic: `/pc_draw_curr_lim_command` |
69 | | - args: 2.0 to 12.0 (float, amps) |
70 | | - Description: TODO |
71 | | - |
72 | | -- type: `PCPackRateCommand` |
73 | | - topic: `/pc_pack_rate_command` |
74 | | - args: 10 to 50 (int, hz) |
75 | | - Description: set PCRecord publish rate in Hz |
76 | | - |
77 | | -- type: `PCRetractCommand` |
78 | | - topic: `/pc_retract_command` |
79 | | - args: 0.4 to 1.0 (float) |
80 | | - Description: TODO |
81 | | - |
82 | | -- type: `PCScaleCommand` |
83 | | - topic: `/pc_scale_command` |
84 | | - args: 0.5 to 1.4 (float) |
85 | | - Description: TODO |
86 | | - |
87 | | -- type: `PCStdDevTargCommand` |
88 | | - topic: `/pc_std_dev_targ_command` |
89 | | - args: 0 to 2000 (int) |
90 | | - Description: TODO |
91 | | - |
92 | | -- type: `PCVTargMaxCommand` |
93 | | - topic: `/pc_v_targ_max_command` |
94 | | - args: 320.0 to 330.0 (float, volts) |
95 | | - Description: TODO |
96 | | - |
97 | | -- type: `PCWindCurrCommand` |
98 | | - topic: `/pc_wind_curr_command` |
99 | | - args: -35.0 to 35.0 (float, amps) |
100 | | - Description: TODO |
101 | | - |
102 | | -- type: `GainCommand` |
103 | | - topic: `/gain_command` |
104 | | - args: OFF, 1 to 200 (enum or int) |
105 | | - Description: TODO |
106 | | - |
107 | | -### Battery Microcontroller |
108 | | -Services available to configure the Battery Microcontroller. |
109 | | - |
110 | | -- type: `BCResetCommand` |
111 | | - topic: `/bc_reset_command` |
112 | | - args: None |
113 | | - Description: TODO |
114 | | - |
115 | | -### Spring Microcontroller |
116 | | -- type: `SCPackRateCommand` |
117 | | - topic: `/sc_pack_rate_command` |
118 | | - args: 10 to 50 (int, hz) |
119 | | - Description: set SCRecord publish rate in Hz |
120 | | - |
121 | | -- type: `SCResetCommand` |
122 | | - topic: `/sc_reset_command` |
123 | | - args: None |
124 | | - Description: TODO |
125 | | - |
126 | | -- type: `ValveCommand` |
127 | | - topic: `/valve_command` |
128 | | - args: OFF, 1 to 127 (enum or int, seconds) |
129 | | - Description: TODO |
130 | | - |
131 | | -- type: `PumpCommand` |
132 | | - topic: `/pump_command` |
133 | | - args: OFF, 1 to 127 (enum or int, seconds) |
134 | | - Description: TODO |
135 | | - |
136 | | -- type: `BenderCommand` |
137 | | - topic: `/bender_command` |
138 | | - args: OFF, ON, AUTO (enum) |
139 | | - Description: TODO |
140 | | - |
141 | | -- type: `TetherCommand` |
142 | | - topic: `/tether_command` |
143 | | - args: OFF, ON (enum) |
144 | | - Description: TODO |
145 | | - |
146 | | -### Trefoil Microcontroller |
147 | | -Services available to configure the Trefoil. |
148 | | - |
149 | | -- type: `TFResetCommand` |
150 | | - topic: `/tf_reset_command` |
151 | | - args: None |
152 | | - Description: TODO |
153 | | - |
154 | | -- type: `TFSetActualPosCommand` |
155 | | - topic: `/tf_set_actual_pos_command` |
156 | | - args: OPEN, CLOSED (enum) |
157 | | - Description: TODO |
158 | | - |
159 | | -- type: `TFSetChargeModeCommand` |
160 | | - topic: `/tf_set_charge_mode_command` |
161 | | - args: OFF, ON, AUTO_TIME, AUTO_VOLTAGE (enum) |
162 | | - Description: TODO |
163 | | - |
164 | | -- type: `TFSetCurrLimCommand` |
165 | | - topic: `/tf_set_curr_lim_command` |
166 | | - args: 500 to 5000 (int, TODO(units)) |
167 | | - Description: TODO |
168 | | - |
169 | | -- type: `TFSetModeCommand` |
170 | | - topic: `/tf_set_mode_command` |
171 | | - args: POWER_10W, MONITOR_POS, HOLD_POS (enum) |
172 | | - Description: TODO |
173 | | - |
174 | | -- type: `TFSetPosCommand` |
175 | | - topic: `/tf_set_pos_command` |
176 | | - args: OPEN, CLOSED (enum) |
177 | | - Description: TODO |
178 | | - |
179 | | -- type: `TFSetStateMachineCommand` |
180 | | - topic: `/tf_set_state_machine_command` |
181 | | - args: HOME_MOVE, VEL_MOVE (enum) |
182 | | - Description: TODO |
183 | | - |
184 | | -- type: `TFWatchDogCommand` |
185 | | - topic: `/tf_watchdog_command` |
186 | | - args: None |
187 | | - Description: TODO |
188 | | - |
189 | | - |
190 | 18 | ## Quality Declaration |
191 | 19 |
|
192 | 20 | This package claims to be in the **Quality Level 5** category, see the [Quality Declaration](QUALITY_DECLARATION.md) for more details. |
0 commit comments