FrankenRobotics

Sinew: actuators, transmissions, power

7,354 words15 subsections13 tablesPlan version 1.1

On this page15
15.1 What it owns, and why actuators are first-class15.2 Decisions15.3 The actuator card15.4 The model ladder15.5 The port-Hamiltonian form of each element15.6 Stiction and backlash as rows in the solve15.7 Winding temperature, resistance, and thermal runaway15.8 The voltage limit and field weakening15.9 Transmissions15.10 The power bus and the battery15.11 Energy at the ports15.12 What agreement between tiers cannot show15.13 Refusals, invariants and known answers15.14 Foundations, gates, kill gates, open questions15.15 Coupled transmissions: the torque set, the rotor energy and the direction witness

15.1 What it owns, and why actuators are first-class

frob-actuate owns the actuator, battery and transmission cards (.fcard); the model ladder; the joint rows that carry stiction and backlash into the solve; the power bus and the battery; the port-Hamiltonian form of every element and the energy accounting at its ports; and the static functions (torque, speed and voltage envelope, thermal steady state, bus feasibility) that A-11 and stage 6 of the preflight call. Verbs: actuator.list, actuator.show, actuator.check, actuator.envelope, actuator.thermal, actuator.bus.

Recent sim-to-real studies agree on where the gap lives: actuator dynamics. Identifying armature, joint friction and delay gave 46% more travel distance and 75% less rotational deviation in one 2026 study; static friction is commonly missing from randomization; joint friction and actuator delay were called particularly critical for a point-foot biped (FACT, Appendix H). A simulator with exact rigid-body dynamics and an ideal torque source is precise about the wrong thing.

Electrical and thermal actuator models exist in current simulators on the CPU and on the GPU (FACT, Appendix H). This chapter claims parity for them, not novelty. What it adds is a card with provenance on every field, a port energy balance with a recorded residual, friction and backlash as rows of the solve, and static functions that refuse a design before any simulation is spent on it.

15.2 Decisions

  • ADR-SINEW-01: the card is the unit of actuator knowledge. It is immutable and content-addressed, every field carries a provenance and an uncertainty, and no actuator constant lives in code. Reason: randomization, strict-data refusals and calibration (§30) all need to know where a number came from.
  • ADR-SINEW-02: stiction and backlash are rows of the solve, not forces computed before it. Reason: a friction force computed from the previous velocity chatters about zero and cannot hold a load at rest; a row with a bounded multiplier can. A dead zone computed outside the solve cannot produce the impact when the gap closes.
  • ADR-SINEW-03: row bounds are frozen within a solve. The breakaway bound and its load-dependent part are evaluated from the state at the start of the step. Reason: a bound that falls with speed makes the friction potential non-convex, and the fast tiers rely on a strictly convex problem (C-06).
  • ADR-SINEW-04: winding resistance and magnet flux depend on temperature from L2 upward, and the static thermal check uses the temperature-dependent law at every level. Reason: §15.7.
  • ADR-SINEW-05: three-phase machines are written in power-invariant dq coordinates, and a card must state its current convention. Reason: FrankenSim's field-oriented controller uses power-invariant normalization (FACT: frankensim/crates/fs-control/src/synchronous.rs); in these coordinates the torque constant equals the back-EMF constant, which is a passivity check on the card; and a torque constant quoted per peak phase ampere, per RMS phase ampere or per q-axis ampere differs by factors of √(3/2), √2 and √3, so a missing convention is a silent torque error of 22% to 73%.
  • ADR-SINEW-06: a transmission loses energy in every quadrant. Efficiency is a pair, one value for each direction of power flow, or a loss law. A single multiplier applied in all quadrants creates energy when the load drives the motor (§15.9).
  • ADR-SINEW-07: stiff electrical and thermal states take implicit rational updates on the batched tiers, and slow states run on their own rational clocks. Reason: the electrical time constant L/R is below a physics tick, an explicit update is unstable there, and batched kernels use no transcendental built-ins (§35).
  • ADR-SINEW-08: thermal state starts from a duty history, not from ambient. Reason: thermal time constants are minutes and episodes are seconds, so an episode that starts cold never meets the limit that decides the design (§15.7).

15.3 The actuator card

An ActuatorCard is immutable, content-addressed data: torque constant, back-EMF constant, winding resistance and inductance, rotor inertia, gear ratio and efficiency map, Coulomb, viscous and Stribeck friction, peak and continuous torque, speed limit, bus voltage and current limits, thermal resistances and capacitances, mass, envelope geometry, encoder resolution, driver control rate and latency. Every field carries a provenance (datasheet with a citation, measured, generic, assumed) and an uncertainty. The starter catalog contains generic classes (small, medium and large quasi-direct-drive; hobby servo; strain-wave; hub motor) marked generic. Real parts enter only with a cited datasheet (OPEN-SINEW-1).

The fields added to that list, by group:

Group Fields Why the field exists
Convention current_convention: dc, phase-peak, phase-rms or q-axis; pole_pairs; modulation: dc, svm-linear or six-step ADR-SINEW-05. Required; a card without it refuses (FROB-REF-134).
Electrical r_phase at t_ref; alpha_r, the temperature coefficient of resistance; l_d, l_q; flux_linkage; alpha_flux, the temperature coefficient of magnet flux; iron_loss coefficients Temperature-dependent copper loss (§15.7); the voltage limit and field weakening (§15.8)
Friction coulomb, breakaway, stribeck_velocity, stribeck_shape: lorentzian or gaussian; viscous; load_coefficient per quadrant; side: motor or output; stiction_eps The stiction row and its bound (§15.6)
Transmission Signed gear_ratio; efficiency_forward, efficiency_back or a loss law; backlash; tooth_stiffness; restitution §15.6, §15.9
Thermal c_winding, c_housing, g_winding_housing, g_housing_ambient; t_max_winding, t_max_magnet; derating bands The two-node network and the runaway condition (§15.7)
Driver control_rate, latency, regen_policy: to-battery, shunt or clip; current-loop bandwidth Braking modes (§15.11); the clock contract of §20
Sensing encoder_bits, encoder_side: motor or output With backlash the two sides read different angles
Cost unit_cost with currency The cost budget of §14.4

actuator.check runs three checks when a card is admitted and again when it is bound to a joint: the torque and back-EMF constants agree in power-invariant coordinates within the card's stated uncertainty; every loss term is nonnegative in all four quadrants (FROB-REF-130 otherwise); and the stated peak and continuous torques are reachable inside the card's own voltage, current and thermal limits.

15.4 The model ladder

Each level is a Component with shaft, electrical and thermal ports. The level is part of ModelId.

Level Contents Tier
L0 Ideal torque source. Used only by mathematical tests. S
L1 Torque-speed envelope from the bus: i ≤ min(I_max, (V_lim − k_e·N·ω)/R); output torque η·N·k_t·i minus friction; reflected inertia N²·J_rotor added to the joint; first-order delay; position-velocity loop at the driver rate. Friction enters as the stiction row of §15.6. V_lim is the bus voltage for a DC machine and the modulation limit of §15.8 for a three-phase machine. S
L2 Winding current dynamics; resistance and flux as functions of winding temperature; a two-node thermal network with torque derating; the voltage limit in the dq plane with field weakening; bus voltage from the two-RC battery; state of charge. S
L3 The rotor as its own coordinate, with backlash rows (S); series elasticity as an added degree of freedom and cable and belt compliance (F). S / F
L4 Hydraulic actuation. M

Two options sit beside the ladder and are also part of ModelId: battery ageing between episodes (F, §15.10), and a rotor port for flight, which is a lumped element with thrust c_T·ρ·A·(Ω·r)² and a reaction torque about its axis (M, off the critical path, used only by the hybrid variant of §14.10).

L1 is the default for training because the literature above says it is the minimum that transfers, and because reflected inertia also conditions the contact solve (it adds to the diagonal of A in C-06). L1 neglects the reactive voltage drop ω_e·L_q·i_q. A card on which L_q·I_max exceeds one tenth of the flux linkage is flagged (DESIGN: a screening threshold), and envelope claims for it require L2.

15.5 The port-Hamiltonian form of each element

Every element is written as ẋ = (J(x) − R(x))·∇H(x) + G(x)·u with output y = G(x)ᵀ·∇H(x), where J is skew-symmetric and R is positive semidefinite. Then Ḣ = uᵀy − ∇Hᵀ·R·∇H: stored energy changes by the power at the ports minus what the element dissipates, and dissipation is never negative. Elements are joined by power-conserving junctions (§14.6), so the property survives composition. This is the form FrankenSim's fs-phs implements (FACT: frankensim/crates/fs-phs), and it is what makes the checks of §15.11 statements about structure instead of bookkeeping.

Element State Stored energy H Structure and dissipation Ports
Winding Flux linkage φ = L·i (per axis in dq) φ²/(2L) R = R_w(T) Electrical (v, i)
Electromechanical conversion — — A gyrator of modulus k: τ = k·i and e = k·ω. Lossless. Couples winding and rotor
Rotor Angular momentum p = J_r·ω p²/(2J_r) Viscous b Shaft
Gear — — A transformer of modulus N, with the loss element of §15.9 in series Two shafts
Coupling transmission — — A transformer with a matrix modulus T: q̇ = T·θ̇ and τ_actuator = Tᵀ·τ_joint Several shafts
Stiction — — A monotone set-valued resistive relation between torque and speed Shaft
Backlash Relative angle δ Zero inside the gap; ½·k_tooth·e² beyond it on compliant tiers, with e the excess of the magnitude of δ over β/2 Tooth damping; an impact law on the referee Two shafts
Series spring Deflection ½·k_s·δ² Internal damping Two shafts
Thermal node Internal energy U = C·(T − T_ref) U Conductances to neighbours and ambient Thermal (T, Q̇); receives every loss as heat
Battery Charge q; polarization charges q₁, q₂ ∫OCV dq + q₁²/(2C₁) + q₂²/(2C₂) R₀, R₁, R₂ Electrical
Bus Bus capacitor charge q_b²/(2C_b) Harness resistance A node: equal voltages, currents sum to zero
Driver Controller states, which are signals — Modulation as a lossless transformer of duty; switching loss as a resistance Two electrical, one signal

Worked instance, the brushed or q-axis motor: x = (φ, p), H = φ²/(2L) + p²/(2J_r), ∇H = (i, ω), J = [[0, −k], [k, 0]], R = diag(R_w, b), u = (v, −τ_load). The two rows read L·di/dt = v − R_w·i − k·ω and J_r·dω/dt = k·i − b·ω − τ_load, and Ḣ = v·i − τ_load·ω − R_w·i² − b·ω².

With the thermal nodes included the composite is lossless up to its ports: the R terms reappear as heat flowing into thermal storage, and the only energy that leaves is mechanical work at the shaft and heat to ambient. That is the first law for the actuator. The second law is a per-step test: with temperatures in kelvin, the entropy production P_loss/T_w + G·(T_w − T_amb)²/(T_w·T_amb) is never negative. Temperature, not entropy, is the stored variable of a node.

On the referee the elements step with FrankenSim's discrete-gradient integrators, which keep the power identity in the discrete step (FACT: stated in fs-phs/src/circuit/battery.rs for the battery). On the batched tiers the arithmetic is re-derived as kernels: the current update is i₊ = (i + (h/L)·(v − k·ω))/(1 + h·R(T)/L), thermal nodes advance on a slower rational clock and receive the heat accumulated since their last tick in a compensated sum, and the resistance seen by the fast update is the temperature at the last thermal tick. Each of these choices leaves a residual, which GATE-SINEW-02 bounds.

15.6 Stiction and backlash as rows in the solve

What it is. S. Sinew emits row descriptors from the card; Kinesis assembles them with the contact rows (§16), and the cones are Marrow's and Traction's (§13, §18). Two row kinds are added to the joint limits that were already rows.

The stiction row. For joint velocity v, step h and bound τ_b, the row's potential on the convex tiers is

ℓ(v) = h·τ_b·ψ_ε(v), with ψ_ε(v) = v²/(2ε) for |v| ≤ ε and |v| − ε/2 otherwise.

Its impulse −∂ℓ/∂v lies in [−h·τ_b, h·τ_b]: it balances any smaller applied impulse with the joint almost at rest and saturates when the joint slides. The bound is

τ_b = τ_c + (τ_s − τ_c)·σ(v⁻/v_s) + c_load·|τ_transmitted⁻|,

with Coulomb level τ_c, breakaway level τ_s, Stribeck velocity v_s, the shape σ(x) = 1/(1 + x²) or exp(−x²) as the card says, a load coefficient per quadrant, and the superscript marking values at the start of the step (ADR-SINEW-03). The rational shape is the default on batched tiers because it needs no exponential. Viscous friction is not in the row; it is implicit damping on the diagonal of A. On the referee the same law is solved set-valued, with ε = 0, by FrankenSim's implicit friction step (FACT: frankensim/crates/fs-tribo/src/stribeck_friction.rs has solve_implicit_friction and SetValuedFrictionStep).

What the convex form costs is stated and measured: a joint holding a torque τ below its bound creeps at ε·τ/τ_b, so over a time t it drifts by at most ε·t; and because the bound is frozen within a step, a stick-slip oscillation can depend on h. Both appear in the fidelity ledger against the referee. The row's Hessian term is h·τ_b/ε inside the kink and zero outside, so the objective stays a sum of positive-semidefinite terms and T-08 is unaffected.

The backlash rows. Backlash needs the rotor as its own coordinate (L3). With rotor angle θ, joint angle q and ratio N, the relative angle is δ = θ/N − q and the two rows are the unilateral gaps

β/2 − δ ≥ 0 and β/2 + δ ≥ 0,

each with a nonnegative multiplier, exactly as a joint limit on δ. On the convex tiers they are compliant with the card's tooth stiffness and a dissipation time; on the referee they are hard, with the card's restitution, zero by default. Inside the gap the rotor and the link are uncoupled, which is the physics that matters: the motor accelerates freely across the gap and arrives with a relative speed, and the encoder on the motor side no longer reports the joint.

Rotor elimination. Twelve backlash joints would raise the velocity count of a quadruped from 18 to 30. They do not raise the size of the dense factorization. Under the usual flexible-joint simplification, in which a rotor's kinetic energy is that of its own spin, the rotor block of A is diagonal and each backlash or motor-side stiction row couples one rotor to one joint. The rotor block is then eliminated in closed form: its Schur complement changes only diagonal entries of the link block, at a cost linear in the number of rotors (a rotor behind a coupling transmission of §15.9 is the exception: its complement is the block Cᵀ·J_r·C over the joints it drives, which has off-diagonal entries and is added once). The simplification neglects the gyroscopic torque J_r·N·q̇·Ω of a spinning rotor carried by a link turning at Ω; with J_r = 10⁻⁴ kg·m², N = 9, q̇ = 20 rad/s and Ω = 5 rad/s that is 0.09 N·m (illustrative), under one percent of the joint torques of such an actuator. It is a HYPOTHESIS that this stays negligible for the cards on file; the test is the referee with full coupling against the reduced model, recorded in the fidelity ledger.

Known answers (hand-checkable; the gate is GATE-SINEW-04):

Case Expected
A torque ramp r·t on a joint at rest with breakaway τ_s Motion begins at t = τ_s/r, within one step
A mass on a spring of stiffness k with Coulomb friction τ_c, released from rest The amplitude falls by 4·τ_c/k per cycle, and the motion ends inside the band of half-width τ_s/k
A held load τ below the bound on a convex tier Drift of at most ε·t
A motor reversal smaller than the gap Zero output motion
A slow sinusoid through a gap β An input-output loop of width β
A rotor of reflected inertia J₁ = N²·J_r closing the gap at relative speed Δω onto a link of inertia J₂ at rest, no restitution Common speed J₁·Δω/(J₁ + J₂); energy lost ½·J₁·J₂/(J₁ + J₂)·Δω². With N = 9, J_r = 10⁻⁴ kg·m², J₂ = 0.02 kg·m², Δω = 2 rad/s (illustrative): 0.577 rad/s and 0.0115 J

15.7 Winding temperature, resistance, and thermal runaway

What it is. S. Copper resistance rises with temperature, R(T) = R₀·[1 + α·(T − T₀)], so copper loss at a given current rises as the winding heats, which heats it further. With one thermal node of capacity C and conductance G to ambient, at constant current I:

C·dT/dt = I²·R₀·[1 + α·(T − T₀)] − G·(T − T_amb).

Write s = I²·R₀·α, the extra watts of loss per kelvin, and P_amb for the loss at ambient temperature.

  • If s < G there is a stable equilibrium at T = T_amb + P_amb/(G − s), approached with time constant C/(G − s). Both are larger than the constant-resistance values P_amb/G and C/G by the factor 1/(1 − s/G).
  • If s ≥ G there is no equilibrium. The temperature grows without bound at rate (s − G)/C until a limit or a protection acts. This is thermal runaway, and the current at which it begins is I_crit = √(G/(R₀·α)).
  • In general, for any loss curve P(T), an operating point has a stable thermal equilibrium if and only if P(T) meets the removal line G·(T − T_amb) at a temperature where dP/dT < G. For a network of nodes with the loss in the winding node, the condition is that the conductance matrix with s subtracted from the winding's diagonal entry stays positive definite; for a winding and a housing in series that reads s < G_wh·G_ha/(G_wh + G_ha).
  • A controller that holds torque makes it worse. Magnet flux falls with temperature, k(T) = k₀·[1 + α_B·(T − T₀)] with α_B negative, so holding torque needs more current as the motor heats and the loss becomes P(T) = I₀²·R₀·[1 + α·(T − T₀)]/[1 + α_B·(T − T₀)]², where I₀ is the current that gives the torque when cold. This curve is convex, so the equilibrium vanishes at a tangency that lies well below the estimate from its slope at T₀. The linear formula is not conservative here, and actuator.thermal solves the tangency.

Worked card (illustrative; every number derived for this plan, none measured). A medium quasi-direct-drive actuator with R₀ = 0.20 Ω at T₀ = 25 °C, α = 0.00393 K⁻¹, G = 0.80 W/K, C = 120 J/K, ambient 25 °C and a winding limit of 155 °C.

Question Constant-resistance model Temperature-dependent model
Steady state at a constant 20 A (80 W of loss when cold) Rise 80/0.80 = 100 K, so 125 °C: inside the limit s = 0.314 W/K; rise 80/(0.80 − 0.314) = 164.7 K, so 190 °C: outside the limit. The loss at equilibrium is 132 W.
Time constant at 20 A 150 s 247 s
Time from cold to the 155 °C limit at 20 A Never 385 s
Largest continuous current for the limit √(0.80·130/0.20) = 22.8 A 22.8/√(1 + 0.00393·130) = 18.6 A, which is 19% lower
Current at which no equilibrium exists None I_crit = √(0.80/(0.20·0.00393)) = 31.9 A
At 35 A An equilibrium 306 K above ambient; the limit is reached at 83 s No equilibrium; growth rate 0.00136 s⁻¹; the limit is reached at 61 s
Holding torque with α_B = −0.0011 K⁻¹ 22.8 A cold-equivalent Limit reached at 15.9 A cold-equivalent, 30% lower; no equilibrium above 16.5 A, where the slope estimate √(G/(R₀·(α − 2·α_B))) says 25.5 A

Three things follow, and each is a mechanism.

  1. The static check uses the corrected law (ADR-SINEW-04). A-11 and stage 6 compute the equilibrium, or its absence, for each required operating point and for the root-mean-square current of the nominal gait, and refuse with FROB-REF-132. In the card above a design sized to hold 20 A passes the constant-resistance check and is refused by the corrected one.
  2. The continuous rating and the runaway threshold are close together under torque control. In the card they are 15.9 A and 16.5 A cold-equivalent, four percent apart. A design that sits just inside its continuous rating has almost no thermal margin against a slightly heavier payload, and actuator.thermal reports the margin to the tangency, not only the equilibrium temperature.
  3. Episodes are too short to see any of this. In 20 s from cold at 20 A the winding of the card rises by 164.7·(1 − e^(−20/247)) = 12.8 K. A policy trained and evaluated on episodes that start at ambient never meets derating. Thermal state is therefore initialized from a declared duty history (ADR-SINEW-08): cold, soaked(T), or steady(task), the equilibrium for the task's mean loss from the closed form above. Evaluation defaults to steady(task); training draws from the three.

Torque derating on the approach to a limit uses authored bands, as FrankenSim's controller does (FACT: frankensim/crates/fs-control/src/thermal.rs), and a trip latches until reset. FrankenSim's winding model derives resistance from material and geometry and infers no temperature law (FACT: frankensim/crates/fs-em/src/winding.rs), so the temperature dependence is new in frob-actuate on every tier.

15.8 The voltage limit and field weakening

What it is. S. In power-invariant dq coordinates, with electrical speed ω_e = p·ω for p pole pairs:

v_d = R·i_d − ω_e·L_q·i_q, v_q = R·i_q + ω_e·(L_d·i_d + λ), τ = p·[λ·i_q + (L_d − L_q)·i_d·i_q],

subject to v_d² + v_q² ≤ V_lim² and i_d² + i_q² ≤ I_max². For a three-phase bridge in its linear range V_lim is the radius of the circle inscribed in the inverter's voltage hexagon, V_bus/√2 in these coordinates; for a DC machine it is V_bus. The referee enforces the exact hexagon, as FrankenSim's controller does (FACT: fs-control/src/synchronous.rs); the batched tiers use the inscribed circle, which is conservative by at most 1 − √3/2, or 13.4%, of voltage at a hexagon vertex.

Neglecting R, the voltage constraint is an ellipse in the current plane,

(λ + L_d·i_d)² + (L_q·i_q)² ≤ (V_lim/ω_e)²,

centred at (−λ/L_d, 0) and shrinking as speed rises. The available torque at a speed is the maximum of τ over the intersection of this ellipse with the current circle. Below base speed the intersection contains the point (0, I_max). Above it, negative i_d moves the operating point toward the ellipse's centre: field weakening trades torque for speed. actuator.envelope returns the boundary of that intersection as torque against speed, at a stated winding temperature and bus voltage, and L2 applies it every step with the bus voltage of §15.10.

Closed forms for the non-salient lossless case (L_d = L_q = L, R = 0), which are the known answers of GATE-SINEW-06:

Quantity Expression Illustrative card: λ = 0.010 V·s, L = 100 µH, I_max = 40 A, V_bus = 48 V
Voltage limit V_lim = V_bus/√2 33.9 V
Base speed, the last speed with full torque V_lim/√(λ² + (L·I_max)²) 3,151 rad/s electrical
No-load speed without field weakening V_lim/λ 3,394 rad/s
Currents on the limit above base speed i_d = [(V_lim/ω_e)² − λ² − (L·I_max)²]/(2·λ·L), i_q = √(I_max² − i_d²) At 1.5 times base speed: i_d = −32.2 A, i_q = 23.7 A, so 59% of peak torque
Top speed with field weakening V_lim/(λ − L·I_max) if λ > L·I_max, otherwise unbounded in this model 5,657 rad/s

At 1.5 times base speed the card's motor delivers 59% of its peak torque with field weakening and none without it, because that speed is above the no-load speed. A model without the ellipse gets fast swing-leg motions and high-speed wheel bases wrong in one direction or the other, depending on which simplification it made.

15.9 Transmissions

  • Four-quadrant loss S. With ω_motor = N·ω_joint: when the motor drives, τ_joint = η_f·N·τ_motor; when the load drives, τ_motor = η_b·τ_joint/N. Both lose energy. The pair is implemented as the load-dependent part of the stiction bound of §15.6, with coefficient (1 − η_f)/η_f on the transmitted joint torque when motoring and 1 − η_b when back-driven, so there is one friction mechanism and not two.
  • Counterexample: one multiplier in all quadrants creates energy. Take η = 0.8 and N = 10, and let the load drive the joint with 10 N·m at 1 rad/s, which is 10 W in. The single-multiplier law τ_joint = η·N·τ_motor gives τ_motor = 1.25 N·m at 10 rad/s: 12.5 W arrives at the motor, and 2.5 W came from nowhere. The correct law gives 0.8 N·m and 8 W, with 2 W lost. The fixture refuses under FROB-REF-130.
  • Self-locking S. A transmission with η_b ≤ 0 cannot be back-driven; the joint holds until the motor assists. For a screw with lead angle a and friction angle φ the efficiencies are η_f = tan a/tan(a + φ) and η_b = tan(a − φ)/tan a, and the screw locks exactly when φ ≥ a. This is the known answer for helical joints.
  • Coupling transmissions S. Differential ankles, wrists and waists drive several joints from several motors through a constant matrix: q̇ = T·θ̇ and τ_actuator = Tᵀ·τ_joint, which conserves power. The rotor inertias reflect into joint space as T⁻ᵀ·diag(J_r)·T⁻¹, which is not diagonal in general. Known answer: for a symmetric differential with q₁ = (θ₁ + θ₂)/2 and q₂ = (θ₁ − θ₂)/2 and rotor inertias J₁ and J₂, the reflected inertia is [[J₁ + J₂, J₁ − J₂], [J₁ − J₂, J₁ + J₂]]: equal rotors decouple, unequal ones do not.
  • Linkage transmissions S. A ratio that depends on position is a closure in the design term (§14.3), and its Jacobian is the transformer modulus at each configuration.
  • Belts, cables and series elasticity F. An added coordinate per compliant element, with the spring row of §15.5. The ceiling of the benefit is fidelity on designs whose resonance lies inside the control bandwidth; for stiff quasi-direct drives it may be nil.

15.10 The power bus and the battery

The bus. S. Every member actuator's electrical port joins one node: voltages equal, currents summing to zero, with the harness resistance in series with the battery. The bus is why limbs that the tree separates are coupled, and why an edit to it is global (§14.6).

The battery. S. A two-RC equivalent circuit with open-circuit voltage against state of charge z:

V = OCV(z) − R₀·I − V₁ − V₂, dVₖ/dt = −Vₖ/(Rₖ·Cₖ) + I/Cₖ, dz/dt = −I/Q,

with I positive on discharge, R₀ a function of cell temperature, and Q the capacity. The two pairs give the fast and slow parts of voltage sag and recovery. FrankenSim's battery has a series resistance, one polarization pair, a bus capacitor and a bounded state of charge that refuses on exhaustion, and states that ageing, thermal drift and hysteresis need separate laws (FACT: frankensim/crates/fs-phs/src/circuit/battery.rs). The second pair and the temperature dependence are therefore added here, on the referee by composing a further RC element and on the batched tiers as kernels.

Brownout is a feasibility question with a closed form. Actuators under current control draw power, not current. A bus with source voltage E = OCV − V₁ − V₂ and series resistance R can deliver power P only if P ≤ E²/(4·R), and then V = [E + √(E² − 4·R·P)]/2. With E = 48 V and R = 0.08 Ω (illustrative) the ceiling is 7,200 W, and at 1,800 W the bus sits at 44.8 V and carries 40.2 A. A demand above the ceiling has no operating point: the bus voltage collapses, the driver's undervoltage policy acts, and the step records a brownout event. It never completes at the requested power. Stage 6 checks the ceiling for the peak demand of the nominal gait at the end-of-discharge voltage and at the cold-temperature resistance, and refuses with FROB-REF-133. An exhausted battery supplies nothing: state of charge is bounded, exhaustion is an event (FROB-REF-135 if a caller asks for power beyond it), and no kernel clips it.

Regeneration. A braking actuator returns power to the bus. The driver's policy decides what happens to it: it charges the battery up to the charge-current limit, the excess heats a shunt on the shared sink, or the driver clips the braking torque. The three are different energy paths and different mechanical behaviours, and each is accounted on its own ledger line (§15.11).

Ageing. F. Two slow states, capacity fade f_Q and resistance growth f_R, with Q = Q₀·(1 − f_Q) and R₀ = R₀₀·(1 + f_R). They advance between episodes, never within a step, by a semi-empirical law in charge throughput and calendar time whose coefficients are card fields with provenance. With no card data the states are user-set constants. Ageing answers lifecycle questions (§31): whether the design that passes stage 6 when new still passes at eighty percent capacity and higher resistance.

15.11 Energy at the ports

Because an actuator is a port component, its balance is checked every step: electrical energy in equals mechanical work out plus copper loss i²R plus friction loss plus gear loss plus the change in stored magnetic and thermal energy. The balance residual is recorded, and it is what lets the energy ledger of §29 report a measured residual instead of an estimate. The claim is made only once GATE-SINEW-02 has recorded that residual.

Four rules keep the account from lying.

  • Heat that is stored is stored energy. Copper, iron, friction and gear losses flow into thermal nodes. They are listed for attribution and are not added again as losses: the energy that leaves the system is mechanical work at the joint and heat to ambient. Counting stored heat twice produces a false defect.
  • The identity, per step and per element: decrease of chemical energy = mechanical work out + increase of magnetic, rotor-kinetic, elastic, polarization and thermal stored energy + heat to ambient + residual.
  • Braking modes are separate lines: motoring; regeneration to the battery; dissipation in a shunt; clipped braking. A design that depends on regeneration the bus cannot accept shows it here.
  • The first offending event is named. When the residual of a step exceeds its tolerance, the ledger reports the earliest step and the element whose local balance failed, not only the episode total.

15.12 What agreement between tiers cannot show

Every tier reads the same card. If the card is wrong, the referee, the CPU batch tier and both GPU tiers are wrong together, and their agreement says nothing about it. Three defences are in place and none is a proof. Randomization draws each field from its stated uncertainty, so a verdict is a statement over the card's band. A verdict that changes sign inside that band is labeled card-conditional by the sensitivity analysis (A-16) and names the field that decides it. Under --strict-data a verdict resting on an assumed field is refused. The only evidence about the card itself is measurement, which is the business of §30.

15.13 Refusals, invariants and known answers

Code Refused Returned with the refusal
FROB-REF-130 A card or transmission that is not passive: loss negative in some quadrant, efficiency above one, or torque and back-EMF constants inconsistent beyond the stated uncertainty The quadrant and the power created
FROB-REF-131 A required operating point outside the torque, speed and voltage envelope The point, the envelope boundary, and the gear-ratio or card edit that admits it
FROB-REF-132 No stable thermal equilibrium at a required operating point, or an equilibrium above a limit The equilibrium or the margin to the tangency; the largest sustainable load
FROB-REF-133 Peak demand above the bus ceiling E²/(4·R) The ceiling, the demand, and the battery or harness edit that admits it
FROB-REF-134 A card without a current convention, or with conventions that disagree The fields in conflict
FROB-REF-135 Power requested from an exhausted battery, or state of charge driven outside its bounds The step and the energy short
FROB-REF-136 A row option the requested tier does not carry The tiers that carry it
ID Invariant
INV-SINEW-01 Every element is passive: its dissipation is nonnegative in all four quadrants of every port.
INV-SINEW-02 The port energy balance of every element closes each step to a recorded residual.
INV-SINEW-03 Entropy production of every thermal node is nonnegative each step.
INV-SINEW-04 State of charge stays in its bounds; exhaustion is an event and is never clipped.
INV-SINEW-05 Row bounds are constant within a solve, and every row potential is convex.
INV-SINEW-06 A card's content hash covers every field, its provenance and its uncertainty; an override creates a new hash.
ID Statement Verification
PO-SINEW-01 The composite of passive elements through power-conserving junctions is passive. Structural: skew-symmetry of J and semidefiniteness of R per element, checked exactly on card rationals; a candidate theorem card for §12.
PO-SINEW-02 The rotor-eliminated solve equals the full solve. Exact rational comparison on small cases; round-off comparison on 10⁴ random cases.
PO-SINEW-03 The ideal gear law conserves power: f₂ = r·f₁ and e₁ = −r·e₂ imply e₁·f₁ + e₂·f₂ = 0. A polynomial identity; a candidate theorem card for §12.

Known answers owned by this chapter beyond those tabulated in §15.6 to §15.10 (numbered in §38): stall torque η·N·k_t·min(I_max, V_lim/R); no-load speed V_lim/(k_e·N); electrical time constant L/R; mechanical time constant J·R/(k_t·k_e); constant-resistance thermal rise P/G; the current step response of the battery, an immediate drop I·R₀ followed by two exponentials with time constants R₁·C₁ and R₂·C₂; discharge time Q/I at constant current; and the hover of the rotor port, where thrust equals weight and the ideal induced power is T^(3/2)/√(2·ρ·A).

15.14 Foundations, gates, kill gates, open questions

FACT: FrankenSim has fs-em (about 255k lines), fs-thermal, fs-tribo (Stribeck, LuGre, rolling loss), fs-control (motor current and speed loops) and a lumped dc_motor system example. frob-actuate reuses their laws on the referee tier through the airlock and re-derives the L1 and L2 arithmetic as kernels for the batched tiers. Also FACT: fs-control has thermal derating bands and voltage-hexagon limiting; fs-phs has the battery and the interconnection used here; fs-tribo has a set-valued friction step.

Gate Threshold (TARGET)
GATE-SINEW-01 Known answers within 1%: stall torque, no-load speed, electrical and mechanical time constants of a DC motor step, thermal steady-state rise ΔT = P·R_th.
GATE-SINEW-02 Port energy balance closes to 10⁻⁹ relative on the referee and 10⁻⁴ relative per episode on single-precision tiers.
GATE-SINEW-03 Batched L1 and L2 kernels agree with the referee components within 10⁻⁴ relative on a 10⁴-case battery.
GATE-SINEW-04 The six cases of §15.6: breakaway within one step of τ_s/r; amplitude loss per cycle within 2% of 4·τ_c/k and rest inside the band; drift at most ε·t; zero output motion inside the gap; loop width within 1% of β; closure speed and energy loss within 1%. Referee exact; batched tiers within their stated regularization.
GATE-SINEW-05 Thermal: equilibrium, time constant, critical current and time to limit within 0.5% of the closed forms of §15.7; the two-node condition; the tangency under torque holding within 1%; the worked card's 20 A point admitted by the constant-resistance check and refused by the corrected one.
GATE-SINEW-06 The five closed forms of §15.8 within 0.5%; over 10⁴ random operating points the inscribed-circle envelope never exceeds the hexagon envelope.
GATE-SINEW-07 Battery and bus: the step response's drop and both time constants within 1%; the ceiling E²/(4·R) and the voltage at a given power within 0.1%; a demand above the ceiling produces a brownout event in 100 of 100 trials and never a completed step; exhaustion refuses.
GATE-SINEW-08 Passivity and second law: over 10⁶ random operating points in all four quadrants every loss and every entropy production is nonnegative; the single-multiplier gear fixture refuses; every card in the catalog passes actuator.check.
GATE-SINEW-09 PO-SINEW-02 holds; with twelve backlash joints the dense factorization has the size it has with none.
✖ KILL-SINEW-ROWS Trigger: with stiction rows enabled the fast-tier solve needs more than 1.5 times the Newton iterations of the smooth-friction model on the contact battery, or throughput falls by more than 20%, after one repair cycle. Fallback: throughput tiers apply regularized friction as a force; the rows stay on the referee and the strict batch-cpu profile; results from the smooth model carry a flag and the fidelity ledger measures the gap.
✖ KILL-SINEW-AGE Trigger: the ageing law fails its pilot, or no card with ageing coefficients better than assumed exists when §31's lifecycle work is funded. Fallback: f_Q and f_R are user-set constants per scenario, with no evolution law.
✖ KILL-SINEW-ROTOR Trigger: the hover known answer or the port balance fails, or the hybrid variant has no consumer at the milestone that funds frontier physics. Fallback: the rotor port and the variant are withdrawn.

Frontier and Moonshot items in this chapter, with what must precede funding:

Item Ceiling of the benefit, stated before any measurement Paper-scale pilot and its falsifier Kill gate
Battery ageing F Answers one class of question, design margins at end of life; no effect on a new robot's verdicts Reproduce one published capacity-fade curve from that paper's own coefficients, by spreadsheet. Falsifier: error above 10% of the fade. KILL-SINEW-AGE
Series elasticity, belt and cable compliance F Fidelity where a resonance lies inside the control bandwidth; nil for stiff drives A two-mass resonance by hand: frequency √(k·(J₁ + J₂)/(J₁·J₂)). Falsifier: the stepped model's resonance off by more than 1% at the referee step. Not built until a card with a measured stiffness exists
Hydraulic actuation M Opens one actuator class; no benefit to electric designs A single cylinder through an orifice: steady speed against the closed form. Falsifier: port balance does not close. Not built until a consumer exists
Rotor port M Opens the hybrid variant; no speed benefit Hover by hand: thrust equals weight and ideal induced power T^(3/2)/√(2·ρ·A). Falsifier: the energy ledger does not close for a hovering body. KILL-SINEW-ROTOR
  • OPEN-SINEW-1. Which real actuator parts ship in the catalog, and under what data license. Default: generic classes only. Owner: project lead. Blocks nothing before M4.
  • OPEN-SINEW-2. The default Stribeck shape and stiction velocity ε on batched tiers. Default: the rational shape and ε = 10⁻³ rad/s, both card-overridable. Owner: Sinew lead. Decide at GATE-SINEW-04.
  • OPEN-SINEW-3. Whether iron loss is on by default at L2. Default: on when the card gives coefficients; otherwise zero with the flag iron loss not modelled on every result. Owner: Sinew lead. Decide at GATE-SINEW-05.
  • OPEN-SINEW-4. Whether the second polarization pair on the referee is composed from existing FrankenSim circuit elements or needs an upstream change. Default: open the upstream work item (FD-FSIM-21) and use an in-house f64 reference until it lands. Owner: airlock lead. Decide at the admission gate for fs-phs.

15.15 Coupled transmissions: the torque set, the rotor energy and the direction witness

What it is. S Three rules that extend the coupling transmissions of §15.9 to couplings that are not square, and one rule for the sign of any transformer. Owner: frob-actuate; consumers frob-dyn, frob-control, frob-analyze, frob-mission. Verbs: actuator.check, actuator.envelope.

One map, written once. A coupling is a matrix C(q) with motor rates θ̇ = C·q̇. Virtual work gives joint efforts τ_joint = Cᵀ·τ_motor. Where the square matrix T of §15.9 is invertible, C = T⁻¹. C need not be square: one motor may drive several joints through a differential or a tendon.

  1. The feasible joint-torque set is an image. With motor limits abs(τ_motor,k) ≤ τ_max,k it is the zonotope Cᵀ·B, where B is the box of motor torques. It is not the box of per-joint limits. actuator.envelope returns its generators, the cone solver of §22.5 carries τ_motor as variables with τ_joint = Cᵀ·τ_motor, and the static analyses and mission queries (A-08, A-24, §25) read the same generators.
  2. Rotor inertia is pulled back once. The rotors add Cᵀ·diag(J_r)·C to the joint-space mass matrix, with its off-diagonal entries. It is added in one place, the lowering, and never again in a controller's model.
  3. A coupling that varies with configuration has an inertial bias. The rotor kinetic energy ½·q̇ᵀ·Cᵀ·J_r·C·q̇ then contributes velocity-product terms, which are derived with the mass matrix from the same expression. A linkage transmission is a closure in the design term (§14.3) and receives them by construction; a constant-ratio shortcut for it omits them.

Known answer. One base-mounted rotor with θ = 10·(q₁ + q₂), torque limit 0.1 N·m and inertia 0.01 kg·m².

Quantity Coupled map Shortcut Shortcut's error
Deliverable joint torques (t, t) with abs(t) ≤ 1 N·m Per-joint limits of 1 N·m Admits (1, −1) N·m, which no motor torque produces
Reflected inertia [[1, 1], [1, 1]] kg·m² diag(1, 1) kg·m² —
Rotor energy at joint rates (1, −1) rad/s 0 J 1 J The rotor does not turn
Rotor energy at joint rates (1, 1) rad/s 2 J 1 J Half the energy is missing

The direction witness. A lossless transformer conserves power under either sign of its modulus, so a power balance cannot detect a reversed gear. FACT (frankensim/crates/fs-phs/src/interconnection.rs:91 at 483d09c682f2, read 2026-11-21): the suite's legacy transformer carries the comment "The legacy transformer has the opposite sign to the canonical map", the canonical map being interconnect_mapped. FACT (reported, not re-run): with two unit scalar stores, efforts (2, 3) and coefficient 4, one gives rates (12, −8) and the other (−12, 8); both satisfy 2·12 + 3·(−8) = 0, and a coefficient of −4 in one convention reproduces the other.

DESIGN. Every transformer, gear and coupling joins two labelled ports with an authored direction: positive rotation of the driving port corresponds to a stated sign of rotation at the driven port. actuator.check runs a signed motion witness when a card is bound to a joint: a unit positive effort on the driving port, with the driven port free and at rest, must produce a rate of the authored sign at the driven port. A reversed witness is refused under the port-sign refusal of §14.6. frob-fsim reaches only interconnect_mapped and passes the authored sign explicitly.

GATE-SINEW-10 Known answer. The one-rotor table is exact: the envelope has one generator (1, 1) N·m, the command (1, −1) N·m is refused as outside the image, the reflected inertia is [[1, 1], [1, 1]] and the two energies are 0 J and 2 J; the diagonal mutant reports 1 J twice and fails. For 10³ random couplings with up to four motors and six joints the power τ_jointᵀ·q̇ equals τ_motorᵀ·θ̇ to 10⁻¹², and the mass matrix with pulled-back rotors equals the mass matrix of the model with explicit rotor coordinates to 10⁻¹⁰. The signed motion witness passes on every card of the catalog and fails on each card with its ratio negated. M1.