1
- # PACMod3 (Platform Actuation and Control MODule) ROS Driver #
1
+ # PACMod4 (Platform Actuation and Control MODule) ROS Driver #
2
2
3
- [ ![ CircleCI] ( https://circleci.com/gh/astuff/pacmod3 /tree/ros1_master.svg?style=svg )] ( https://circleci.com/gh/astuff/pacmod3/tree/ros1_master )
3
+ [ ![ CircleCI] ( https://circleci.com/gh/astuff/pacmod4 /tree/ros1_master.svg?style=svg )] ( https://circleci.com/gh/astuff/pacmod3/tree/ros1_master )
4
4
5
- This ROS node is designed to allow the user to control a vehicle (see SUPPORTED VEHICLES below) with the PACMod drive-by-wire system, board revision 3 .
5
+ This ROS node is designed to allow the user to control a vehicle with the PACMod drive-by-wire system.
6
6
The main purpose of the driver is to provide a common ROS API to PACMod devices regardless of vehicle type or specific PACMod version in use.
7
7
8
8
For access to the DBC file which defines the CAN interface for the PACMod, see the [ pacmod_dbc] ( https://github.com/astuff/pacmod_dbc ) repo.
9
9
10
10
## Installation
11
11
12
- Install pacmod3 using our debian repository:
12
+ Install pacmod4 using our debian repository:
13
13
14
14
``` sh
15
15
sudo apt install apt-transport-https
16
16
sudo sh -c ' echo "deb [trusted=yes] https://s3.amazonaws.com/autonomoustuff-repo/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/autonomoustuff-public.list'
17
17
sudo apt update
18
- sudo apt install ros-$ROS_DISTRO -pacmod3
18
+ sudo apt install ros-$ROS_DISTRO -pacmod4
19
19
```
20
20
21
- Note: Previously the pacmod3 driver was released via the ROS buildfarm.
22
- This has changed as of Ubuntu 20.04 (ROS2 Foxy and ROS1 Noetic) to keep old package versions available for download, which gives users greater control over their installed software and also allows downgrades if an upgrade breaks software dependencies.
23
-
24
21
## ROS API
25
22
26
23
The driver will automatically adapt the ROS API (published and subscribed topics) according to what data the PACMod system supports.
@@ -34,90 +31,4 @@ Please consult the PACMod user manual you received with your vehicle in order to
34
31
- ** kvaser_circuit_id** : The circuit/channel id that the PACMod is plugged into on the kvaser device, only applies if ` use_kvaser ` is true.
35
32
- ** use_socketcan** : Set this to true if Linux SocketCAN drivers are being used to connect to the PACMod. Defaults to ` false ` .
36
33
- ** socketcan_device** : The device id of the SocketCAN channel the PACMod is plugged into, only applies if ` use_socketcan ` is true.
37
- - ** namespace** : The namespace of the PACMod driver, topics will be namespaced accordingly. Defaults to ` pacmod ` .
38
-
39
- ### Published Topics
40
-
41
- Topics published on all platforms:
42
-
43
- - ` accel_rpt ` ([ pacmod3_msgs/SystemRptFloat] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptFloat.msg ) )
44
- - ` accel_aux_rpt ` ([ pacmod3_msgs/AccelAuxRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/AccelAuxRpt.msg ) )
45
- - ` brake_rpt ` ([ pacmod3_msgs/SystemRptFloat] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptFloat.msg ) )
46
- - ` brake_aux_rpt ` ([ pacmod3_msgs/BrakeAuxRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/BrakeAuxRpt.msg ) )
47
- - ` steering_rpt ` ([ pacmod3_msgs/SystemRptFloat] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptFloat.msg ) )
48
- - ` steering_aux_rpt ` ([ pacmod3_msgs/SteeringAuxRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SteeringAuxRpt.msg ) )
49
- - ` shift_rpt ` ([ pacmod3_msgs/SystemRptInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptInt.msg ) )
50
- - ` shift_aux_rpt ` ([ pacmod3_msgs/ShiftAuxRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/ShiftAuxRpt.msg ) )
51
- - ` turn_rpt ` ([ pacmod3_msgs/SystemRptInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptInt.msg ) )
52
- - ` turn_aux_rpt ` ([ pacmod3_msgs/TurnAuxRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/TurnAuxRpt.msg ) )
53
- - ` vehicle_speed_rpt ` ([ pacmod3_msgs/VehicleSpeedRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/VehicleSpeedRpt.msg ) )
54
- - ` vin_rpt ` ([ pacmod3_msgs/VinRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/VinRpt.msg ) )
55
- - ` global_rpt ` ([ pacmod3_msgs/GlobalRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/GlobalRpt.msg ) )
56
- - ` component_rpt_00 ` ([ pacmod3_msgs/ComponentRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/ComponentRpt.msg ) )
57
- - ` component_rpt_01 ` ([ pacmod3_msgs/ComponentRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/ComponentRpt.msg ) )
58
- - ` component_rpt_02 ` ([ pacmod3_msgs/ComponentRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/ComponentRpt.msg ) )
59
- - ` all_system_statuses ` ([ pacmod3_msgs/AllSystemStatuses] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/AllSystemStatuses.msg ) )
60
- - ` can_rx ` ([ can_msgs/Frame] ( http://docs.ros.org/en/noetic/api/can_msgs/html/msg/Frame.html ) )
61
-
62
- Topics published on supported platforms only:
63
-
64
- - ` brake_motor_rpt_1 ` ([ pacmod3_msgs/MotorRpt1] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/MotorRpt1.msg ) )
65
- - ` brake_motor_rpt_2 ` ([ pacmod3_msgs/MotorRpt2] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/MotorRpt2.msg ) )
66
- - ` brake_motor_rpt_3 ` ([ pacmod3_msgs/MotorRpt3] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/MotorRpt3.msg ) )
67
- - ` cruise_control_buttons_rpt ` ([ pacmod3_msgs/SystemRptInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptInt.msg ) )
68
- - ` date_time_rpt ` ([ pacmod3_msgs/DateTimeRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/DateTimeRpt.msg ) )
69
- - ` detected_object_rpt ` ([ pacmod3_msgs/DetectedObjectRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/DetectedObjectRpt.msg ) )
70
- - ` door_rpt ` ([ pacmod3_msgs/DoorRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/DoorRpt.msg ) )
71
- - ` estop_rpt ` ([ pacmod3_msgs/EStopRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/EStopRpt.msg ) )
72
- - ` global_rpt_2 ` ([ pacmod3_msgs/GlobalRpt2] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/GlobalRpt2.msg ) )
73
- - ` engine_brake_rpt ` ([ pacmod3_msgs/SystemRptInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptInt.msg ) )
74
- - ` hazard_lights_rpt ` ([ pacmod3_msgs/SystemRptBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptBool.msg ) )
75
- - ` headlight_aux_rpt ` ([ pacmod3_msgs/HeadlightAuxRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/HeadlightAuxRpt.msg ) )
76
- - ` headlight_rpt ` ([ pacmod3_msgs/SystemRptInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptInt.msg ) )
77
- - ` horn_rpt ` ([ pacmod3_msgs/SystemRptBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptBool.msg ) )
78
- - ` interior_lights_rpt ` ([ pacmod3_msgs/InteriorLightsRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/InteriorLightsRpt.msg ) )
79
- - ` lat_lon_heading_rpt ` ([ pacmod3_msgs/LatLonHeadingRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/LatLonHeadingRpt.msg ) )
80
- - ` marker_lamp_rpt ` ([ pacmod3_msgs/SystemRptBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptBool.msg ) )
81
- - ` occupancy_rpt ` ([ pacmod3_msgs/OccupancyRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/OccupancyRpt.msg ) )
82
- - ` parking_brake_rpt ` ([ pacmod3_msgs/SystemRptBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptBool.msg ) )
83
- - ` rear_lights_rpt ` ([ pacmod3_msgs/RearLightsRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/RearLightsRpt.msg ) )
84
- - ` sprayer_rpt ` ([ pacmod3_msgs/SystemRptBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptBool.msg ) )
85
- - ` steering_motor_rpt_1 ` ([ pacmod3_msgs/MotorRpt1] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/MotorRpt1.msg ) )
86
- - ` steering_motor_rpt_2 ` ([ pacmod3_msgs/MotorRpt2] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/MotorRpt2.msg ) )
87
- - ` steering_motor_rpt_3 ` ([ pacmod3_msgs/MotorRpt3] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/MotorRpt3.msg ) )
88
- - ` vehicle_dynamics_rpt ` ([ pacmod3_msgs/VehicleDynamicsRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/VehicleDynamicsRpt.msg ) )
89
- - ` wheel_speed_rpt ` ([ pacmod3_msgs/WheelSpeedRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/WheelSpeedRpt.msg ) )
90
- - ` wiper_aux_rpt ` ([ pacmod3_msgs/WiperAuxRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/WiperAuxRpt.msg ) )
91
- - ` wiper_rpt ` ([ pacmod3_msgs/SystemRptInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemRptInt.msg ) )
92
- - ` yaw_rate_rpt ` ([ pacmod3_msgs/YawRateRpt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/YawRateRpt.msg ) )
93
-
94
- ### Subscribed Topics
95
-
96
- Topics subscribed on all platforms:
97
-
98
- - ` accel_cmd ` ([ pacmod3_msgs/SystemCmdFloat] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdFloat.msg ) )
99
- - ` brake_cmd ` ([ pacmod3_msgs/SystemCmdFloat] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdFloat.msg ) )
100
- - ` steering_cmd ` ([ pacmod3_msgs/SystemCmdFloat] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdFloat.msg ) )
101
- - ` shift_cmd ` ([ pacmod3_msgs/SystemCmdInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdInt.msg ) )
102
- - ` turn_cmd ` ([ pacmod3_msgs/SystemCmdInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdInt.msg ) )
103
- - ` can_tx ` ([ can_msgs/Frame] ( http://docs.ros.org/en/noetic/api/can_msgs/html/msg/Frame.html ) )
104
-
105
- Topics subscribed on supported platforms only:
106
-
107
- - ` cruise_control_buttons_cmd ` ([ pacmod3_msgs/SystemCmdInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdInt.msg ) )
108
- - ` engine_brake_cmd ` ([ pacmod3_msgs/SystemCmdInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdInt.msg ) )
109
- - ` hazard_lights_cmd ` ([ pacmod3_msgs/SystemCmdBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdBool.msg ) )
110
- - ` headlight_cmd ` ([ pacmod3_msgs/SystemCmdInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdInt.msg ) )
111
- - ` horn_cmd ` ([ pacmod3_msgs/SystemCmdBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdBool.msg ) )
112
- - ` marker_lamp_cmd ` ([ pacmod3_msgs/SystemCmdBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdBool.msg ) )
113
- - ` rear_pass_door_cmd ` ([ pacmod3_msgs/SystemCmdInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdInt.msg ) )
114
- - ` sprayer_cmd ` ([ pacmod3_msgs/SystemCmdBool] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdBool.msg ) )
115
- - ` wiper_cmd ` ([ pacmod3_msgs/SystemCmdInt] ( https://github.com/astuff/pacmod3_msgs/blob/master/msg/SystemCmdInt.msg ) )
116
-
117
- ## Supported Vehicles ##
118
-
119
- At the moment, this pacmod3 driver supports DBC versions 3 through 12 for a core set of common messages.
120
- This means not all vehicle-specific CAN messages are currently supported.
121
- If you need a specific CAN message to be supported please open an issue [ here] ( https://github.com/astuff/pacmod3/issues ) .
122
-
123
- If you are unsure about which DBC version your existing PACMod supports, please reach out to our support team: https://autonomoustuff.com/support
34
+ - ** namespace** : The namespace of the PACMod driver, topics will be namespaced accordingly. Defaults to ` pacmod ` .
0 commit comments