Double-sided, spring-loaded rotational detent
Simscape / Driveline / Brakes & Detents / Rotational
The Rotational Detent block represents a double-sided, spring-loaded rotational detent.
The detent rod rotates over the detent case. The case has notches or magnets that create a net relative torque with the rod as the rod rotates. With the block, you can model rotational detents with peak torque and notch width, or with a table lookup. The model also includes viscous damping and kinetic friction between the rod and case. You can set the friction to zero.
Rotational Detent Model
As the rod rotates over the case, the relative rotation ϕ = ϕR – ϕC causes a torque τ to develop. Depending on your choice of parameterization, the torque model is defined by the peak torque and notch width, or by a table lookup specifying relative rotation versus torque.
Regardless of the parameterization, if you specify multiple detents, all detents have the same torque-relative rotation function.
Peak Torque and Notch Width
If you choose the peak torque and notch width parameterization, the block ensures that the torque-relative rotation curve provides a continuous torque and torque derivative over the detent region. The peak torques are halfway between the detent center and detent edge, as shown in the following figure.
By Table Lookup
With the table lookup parameterization, you can create an arbitrary function relating torque to relative rotation. If you create such a function, consider the following best practices.
If you want to ensure that the detent conserves energy, the total integral of the torque-relative rotation curve (area under the curve) must be zero.
To stabilize simulation of the detent, avoid discontinuities in the torque-relative rotation function.
The model does not account for inertia. Add inertia terms externally to the R and C ports as required.
If you use the peak torque-notch width or the table lookup parameterization, the kinetic friction is independent of the detent normal force.
R and C are rotational conserving ports associated with the rod and case, respectively.
Select how to specify the detent characteristics. The default is
By peak torque and notch width.
By peak torque and notch width— Specify detent characteristics by the peak torque and the notch width.
By table lookup— Define the detent characteristics by one-dimensional table lookup based on the relative displacement between the slider and case. If you select this option, the panel changes from its default option.
- Detent spacing
Select how to specify the detent spacing. The default is
- Viscous friction coefficient
Specify the viscous friction coefficient for the rod-case contact. Must be greater than or equal to 0. The default is
From the drop-down list, choose units. The default is newton-meters/(radians/second) (
- Friction to peak torque ratio
Specify the kinetic friction coefficient for the rod-case contact. Must be greater than or equal to 0. The default is
The kinetic friction is this ratio multiplied by the peak torque.
- Friction velocity threshold
Specify the relative angular velocity required for peak kinetic friction in the detent. Must be greater than 0. The default is
From the drop-down list, choose units. The default is revolutions/minute (
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Introduced in R2011b