Skip to content

Commit a3eafee

Browse files
authored
update readme (#69)
* update readme Signed-off-by: Michael Anderson <anderson@mbari.org> * update readme Signed-off-by: Michael Anderson <anderson@mbari.org> --------- Signed-off-by: Michael Anderson <anderson@mbari.org>
1 parent d571560 commit a3eafee

File tree

1 file changed

+7
-179
lines changed

1 file changed

+7
-179
lines changed

README.md

Lines changed: 7 additions & 179 deletions
Original file line numberDiff line numberDiff line change
@@ -2,191 +2,19 @@
22

33
Packages in this repo provide interfaces, API, examples for [MBARI WEC](https://github.com/osrf/mbari_wec/tree/main).
44

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)
712
[C++ linear damper](https://github.com/mbari-org/mbari_wec_template_cpp/tree/linear_damper_example)
813

914
And tutorials may be found [here](https://osrf.github.io/mbari_wec/main/tutorials).
1015

1116
For more information about ROS 2 interfaces, see [docs.ros.org](https://docs.ros.org/en/rolling/Concepts/About-ROS-Interfaces.html).
1217

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-
19018
## Quality Declaration
19119

19220
This package claims to be in the **Quality Level 5** category, see the [Quality Declaration](QUALITY_DECLARATION.md) for more details.

0 commit comments

Comments
 (0)