adams_car通讯器
娄底三中-广州体育学院研究生
Communicators in the Suspension Test Rig
The following tables describe the input and
output communicators in the suspension test rig
(.__MDI_SUSPENSION_TESTRIG). In the tables,
the notation: 
[lr] indicates that there is
both a left and right communicator of the
specified name, as in 
ci[lr]_camber_angle.
s indicates a single communicator, as in
cis_steering_rack_joint. 
Communicators in the
Suspension Test Rig 
:The communicators
ci[lr]_camber_angle 
Belongs to the
class 
parameter_real 
Form minor
receives 
role 
Any Camber angle value from
the 
suspension subsystem. Sets the correct
orientation of the test rig wheels.
ci[lr]_diff_tripot 
ci[lr]_toe_angle
location 
parameter_real 
ci[lr]_suspension_mount
ci[lr]_suspension_upright
ci[lr]_jack_frame 
ci[lr]_wheel_center
mount 
mount 
mount 
location 
any
Any 
Any 
Any 
any 
any
Location of the differential 
Toe angle
value from the suspension 
subsystem. Sets the
correct orientation 
of the test rig wheels.
Part to which the test rig wheels can
attach. 
Upright part from suspension
subsystem. 
Not matched (fixed to ground).
Location of the wheel center from the
suspension subsystem. Test rig wheels
attach to the suspension at that location.
cis_driveline_active parameter_integer Any
Integer value stored in the suspension
templatesubsystem that indicates the
activity of the drivetrain.
cis_powertrain_to_body
cis_leaf_adjustment_steps
cis_steering_rack_joint
cis_steering_wheel_joint 
mount
parameter_integer 
joint_for_motion
joint_for_motion 
Any 
Any 
Any
Any 
any 
Part to which differential
outputs are 
constrained. 
Integer value
stored in the leaf spring 
template (currently
not available). 
Steering-rack translational
joint from 
the steering subsystem.
Steering-wheel revolute joint from the
steering subsystem.
cis_suspension_parameters_ARRAY array 
 
Output Communicators in Suspension Test
Rig 
 
Array used in the suspension
characteristic calculations; comes from
the suspension subsystems 
 
1
The  communicators
cos_leaf_adjustment_multiplier 
Belongs to
the Form minor 
outputs 
class
 
array
role
 
Any 
Any 
Leaf Spring
toolkit. It is currently not 
supported in the
standard product. 
Suspension, vehicle, and
test-rig 
parameters array IDs used by
suspension characteristics calculations
routines. 
cos_characteristics_input_ARRAY  
array 
co[l,r]_tripot_to_differential
cos_tire_forces_array_left 
mount 
any
Any 
any 
Outputs the ge[lr]_diff_output
parts. 
Outputs array of Adams IDs used by
the conceptual suspension module. 
Outputs
array of Adams IDs used by 
the conceptual
suspension module. 
Array 
array 
cos_tire_forces_array_right 
Communicators in the SDI Test Rig 
The
following tables describe the input and output
communicators in the SDI test rig
(.__MDI_SDI_TESTRIG). In the tables, the
notation [lr] indicates that there is both a left
and right 
communicator of the specified name.
Input Communicators in SDI Test Rig 
The
communicators
 
cis_body_subsystem
Belongs to the Form minor 
receives
class
 
mount 
 
role
inherit Output from the body subsystem. It
indicates the part that represents the
body. 
Marker from the body subsystem. It
is 
used to measure path, roll, and sideslip
error in a constant radius cornering
maneuver. 
cis_driver_reference marker 
cis_engine_rpm solver_variable 
cis_chassis_path_reference 
  
 
Any
 
marker 
 
 
any 
Marker from
the body subsystem. It is 
used in
AdamsSmartDriver 
simulations. 
Any
AdamsSolver variable for engine 
revolute
speed, in rotations per minute, 
from the
powertrain subsystem. 
 
cis_engine_speed
 
solver_variable 
any 
AdamsSolver
variable for engine 
revolute speed, in radians
per second, 
from the powertrain subsystem.
 
cis_measure_for_distance 
cis_diff_ratio 
 
marker 
parameter_real 
 
 
Marker used to
measure the distance 
traveled in the forward
direction of the 
vehicle, from the body
subsystem. 
 
Real parameter variable for
final drive 
ratio, from the powertrain
subsystem. 
 
2
cis_steering_rack_joint 
cis_steering_wheel_joint 
cis_max_brake_value 
cis_max_engine_speed 
cis_max_gears 
cis_max_rack_displacement 
cis_max_rack_force 
cis_max_steering_angle 
cis_max_steering_torque 
cis_max_throttle
 
cis_min_engine_speed 
cis_rotation_diff 
 
joint_for_motion
 
joint_for_motion 
 
parameter_real
 
parameter_real 
 
front 
front
 
 
 
Steering-rack translational
joint from 
the steering subsystem.
Steering-wheel revolute joint from the
steering subsystem. 
Output from brake
subsystem 
(maximum brake signal value).
Output from powertrain subsystem 
(maximum
engine rpm value). 
Output from powertrain
(maximum 
number of allowed gears). 
Output
displacement limits from 
steering subsystem.
Used by the 
Standard Driver Interface.
parameter_integer  
 
parameter_real
 
parameter_real 
 
parameter_real
 
parameter_real 
parameter_real 
parameter_real 
 
diff 
 
 
 
 
 
 
 
Output force limits
from steering 
subsystem. Used by the Standard
Driver Interface. 
Output angle limits from
steering 
subsystem. Used by the Standard
Driver Interface. 
Output from steering
subsystem. 
Output from powertrain (maximum
value of throttle signal). 
Output from
powertrain subsystem 
(minimum engine rpm
value, used for 
shifting strategy). 
Output
from powertrain (it is a 
differential equation
used to measure 
crankshaft acceleration; its
integral is 
used for engine rpm).
cis_transmission_spline 
cis_transmission_input_omega 
cis_clutch_diff 
cis_clutch_displacement_ic 
ci[lr]_front_suspension_mount 
ci[lr]_rear_suspension_mount 
spline 
solver_variable 
 
diff 
solver_variable 
 
mount 
 
 
Spline for transmission gears (output 
from
powertrain: reduction ratios for 
every gear).
 
 
 
The transmission input engine
variable 
from the powertrain template.
Clutch slip differential equation from 
the
powertrain template. 
The clutch initial
displacement (engine 
crankshaft torque at
static equilibrium) 
from the powertrain
template. 
front 
 
rear 
The hub
parts (wheel carriers) from 
suspension
templates (front and rear) 
The hub parts
(wheel carriers) from 
suspension templates
(front and rear) 
Output Communicators in SDI
Test Rig 
 
3 
The
communicators
 
cos_brake_demand
cos_clutch_demand 
cos_desired_velocity 
Belongs to the Form
minor 
outputs 
class
solver_variable 
solver_variable
role
 
Any 
Any 
any 
Brake
demand to the brake subsystem. 
Clutch demand
to the powertrain 
subsystem. 
Desired
velocity AdamsSolver 
variable. Other
subsystems can 
reference it. 
solver_variable 
cos_initial_engine_rpm parameter_real 
Any
any 
 
 
Initial engine RPM real
variable to the 
powertrain subsystem.
Throttle demand to the powertrain
subsystem. 
Transmission (gear) demand to
the 
powertrain subsystem. 
Differential
equation computed during 
quasi-static
prephase, used to control 
the vehicle
longitudinal dynamics. 
cos_throttle_demand 
 
solver_variable
 
cos_transmission_demand 
cos_sse_diff1 
 
solver_variable 
diff 
 
cos_std_tire_ref 
location 
 
 
X,Y,Z location of
standard tire 
reference marker (positioned
appropriately at the correct height,
including 2% of road penetration).
Matching Communicators with Test Rigs 
When
you create a template, you must meet the following
conditions to ensure that an analysis will
work with your new template:  
 the
template is a suspension template (for example,
its major role is suspension), the template must
contain a suspension parameters array. The
suspension parameters array identifies to the
suspension 
analysis how the steer axis should
be calculated and whether the suspension is
independent or 
dependent. 
 template must
be compatible with other templates and with the
test rigs, for example, 
the
.__MDI_SUSPENSION_TESTRIG. The template must also
contain the proper output 
communicators.
For example, for a suspension template to be
compatible with the suspension test rig, the
suspension 
template must contain either the
mount or the upright output communicators. In the
following table, the 
notation [lr] indicates
that there is both a left and right communicator
of the specified name.  
Output Communicators
in Suspension Templates 
The  communicators
co[lr]_suspension_mount
co[lr]_suspension_upright
co[lr]_wheel_center
 
co[lr]_toe_angle
co[lr]_camber_angle 
Belongs to the Form
minor 
receives 
class
 
mount
mount 
location 
parameter_real
parameter_real 
role
 
inherit
inherit 
inherit 
inherit 
inherit
suspension_mount 
suspension_upright
wheel_center 
toe_angle 
camber_angle
 
4 
The co[lr]_suspension_mount
output communicators publish the parts to which
the test rig wheels 
should mount. As you
create these communicators, ensure that you set
their minor role to inherit. By 
setting the
minor role to inherit, the communicator takes its
minor role from the minor role of the
subsystems that use your suspension template.
The co[lr]_wheel_center output communicators
publish the location of the wheel centers to the
test rig 
so the test rig can locate itself
relative to the suspension. As you create these
types of communicators, 
make sure that you
also leave their minor role set to inherit.
The toe and camber communicators
(co[lr]_toe_angle and co[lr]_camber_angle)
publish, to the test rig, 
the toe and camber
angles set in the suspension so that the test rig
can orient the wheels correctly. 
 
 
5