Añadir y configurar sensores
Un sensor necesita su definición en el modelo, el sistema que lo actualiza y una ruta hasta la aplicación receptora. Añade uno cada vez y comprueba sus mediciones.
Entorno de trabajo
Usa las terminales Linux preparadas en Ubuntu nativo, WSL o Docker. En macOS, trabaja dentro del escritorio RDP. Edita y compila allí; POSIM_WS indica ese espacio de trabajo.
Elegir dónde integrarlo
| Medición | Ubicación en el modelo | Sistema del mundo / conexión ROS |
|---|---|---|
| IMU | link/sensor type="imu" |
Sistema IMU; puente de gz.msgs.IMU a ROS Imu |
| Cámara submarina | Sensor RGBD y plugin de efectos | Sistema Sensors con renderizador y tópicos de cámara |
| DVL | Sensor DVL y configuración de haces | Sistema DVL y puente de mensajes acústicos incluido |
| Presión | Plugin directamente bajo model |
Publicación ROS directa de presión y profundidad |
| GNSS marino | Plugin del receptor en el modelo | Mensajes Gazebo gz.msgs.Double_V; se necesita un adaptador aparte para ROS |
| USBL | Plugins del transceptor y transpondedor | Identificadores acústicos compatibles e interfaces ROS |
| Sonar multihaz | Sensor personalizado bajo un eslabón | Renderizador Sensors, sistema multihaz del mundo y CPU/WGPU/CUDA |
Consulta el SDF y los parámetros de cada referencia. Respeta su ubicación: los sistemas del mundo van en el mundo; los plugins de modelo necesitan la entidad sobre la que actúan.
Añadir una IMU al mundo de ejemplo
Abre calm_water.sdf de Crear un mundo. Añade este sistema directamente en <world>, junto al sistema de física:
<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu"/>
Dentro de <link name="base_link"> del modelo pressure_station, añade:
<sensor name="imu" type="imu">
<pose>0 0 0.1 0 0 0</pose>
<always_on>true</always_on>
<update_rate>20</update_rate>
<topic>/tutorial/imu</topic>
<imu/>
</sensor>
La pose es relativa al eslabón, en metros y radianes. La frecuencia usa tiempo simulado. Como la estación está fija, la velocidad angular debe ser cercana a cero; la aceleración incluye la respuesta a la gravedad.
Conectar y observar
Detén el mundo anterior. En la terminal A, valida y reinicia:
gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf
En la terminal B, con el entorno cargado, inicia el puente y déjalo ejecutándose:
ros2 run ros_gz_bridge parameter_bridge \
'/tutorial/imu@sensor_msgs/msg/Imu[gz.msgs.IMU'
En la terminal C, preparada del mismo modo, consulta una medida:
ros2 topic echo --no-daemon /tutorial/imu sensor_msgs/msg/Imu --once
Comprueba marca temporal, identificador del sistema de referencia, velocidad angular y aceleración. Quita --once para observar continuamente; Ctrl+C detiene la lectura. Al terminar, detén puente y simulador. Terminales y tópicos ROS explica cómo comparten el entorno.
Cambiar la frecuencia
Cambia update_rate de 20 a 5 y reinicia mundo y puente. Los intervalos entre marcas temporales deben pasar de unos 0,05 s a 0,2 s de tiempo simulado. La frecuencia recibida en tiempo real depende también del factor de tiempo real y del transporte.
En cámaras, revisa juntos resolución, campo de visión y distancias cercana y lejana. En sensores de barrido, comprueba haces y límites de alcance. Antes de mover un sensor, confirma su sistema de referencia y orientación.
Comprobar la integración
- Modelo: pose válida, configuración y tópico único.
- Mundo: sistema requerido y renderizador para sensores de imagen.
- ROS: dirección del puente, tipo de mensaje, sistema de referencia y QoS.
- Datos: marcas temporales recientes y respuesta a un cambio controlado.
Verifica el fondo con Terrenos. Para comparar sonar, usa Configuración y rendimiento junto con sus parámetros.