Generated reference › Multirotor — Robotics/Rotorcraft
kind: generated#block#robotics-rotorcraft

Multirotor — Robotics/Rotorcraft

Robotics/Rotorcraft/Multirotor · 0 input / 0 output port(s) at insert · exports to Python, MATLAB, Java, Rust, C, C++, VHDL, Verilog, SystemVerilog, PLC Structured Text

Description#

The block's own DESCRIPTION_HTML, rendered verbatim — the same text the config dialog's info panel and the library navigator show. Fix a wrong sentence in the block's .cpp (R-D9), never here.

Multirotor

Robotics / Rotorcraft

A four-rotor machine as one block: each rotor's thrust and torque, summed into one force and one moment about the vehicle's centre, with the arm of every rotor carried in the moment.

One rotor's thrust and torque, with kT = CT·R²·π·R² and kQ = −CQ·R³·π·R²:

  • T = (kT·Ω²)·ρ, so thrust does not care which way the rotor turns
  • Mz = ρ·(kQ·Ω·|Ω|), which does – a rotor spun backwards reverses its torque, and that is how a quadcopter's counter-rotating pairs cancel

Without flap effects each rotor's force is Fi = [0; 0; −Ti], and the block answers F = ΣFi, M = Σ([0; 0; Mz,i] + armi × Fi).

Ports

  • Omega – the four rotational speeds in rad/s, a [4,1] column in the arm order below. Each sign is that rotor's sense of rotation, and it is what makes a quadcopter's yaw torque cancel in the hover.
  • rho – ρ, the air density, [1,1], in kg/m³ or slug/ft³.
  • Fxyz – the summed force in body axes, a [3,1] column in N or lbf.
  • Mxyz – the summed moment about the centre, a [3,1] column in N·m or lbf·ft.

Parameters

  • Units – Metric (MKS), English (velocity in ft/s) or English (velocity in kts). The arithmetic is unit-consistent in both systems, so the first two run the same numbers; kts is the only one that converts anything – the body velocity, by 1852/3600/0.3048 ≈ 1.68781 ft/s per knot.
  • Configuration – where the four arms point, with l the arm length and h the rotor height:
    • Quadcopter X – the diagonals: [l/√2, −l/√2, h], [l/√2, l/√2, h], [−l/√2, l/√2, h], [−l/√2, −l/√2, h]
    • Quadcopter + – the axes: [l, 0, h], [0, l, h], [−l, 0, h], [0, −l, h]
  • Arm Length – l, the distance from the centre to a rotor hub, in the length unit.
  • Rotor Height – h, the rotors' common z in body axes (negative is above the centre), in the length unit.
  • Coefficient Source – where the two coefficients come from:
    • Dialog – the two values below, used as given
    • Compute using BEMT – blade element momentum theory over the blade geometry below, solved once when the configuration is loaded, so the export carries the resulting pair as constants
  • Thrust Coefficient – CT, used when the source is Dialog: one number for all four rotors, or a four-element vector, one per rotor.
  • Torque Coefficient – CQ, the same two shapes.
  • Number Of Blades – Nb, used by the momentum solver (through the solidity σ = Nb·c/(π·R) and Prandtl's tip loss) and by nothing else when the source is Dialog.
  • Blade Radius – R, in the length unit; it sets the whole scale of the block, thrust going as R⁴ and torque as R⁵.
  • Blade Chord – c, in the length unit.
  • Hinge Offset – e, the flapping hinge's distance from the shaft, in the length unit; at least zero and less than the radius, and read only by the momentum solver here.
  • Lift Curve Slope – the blade section's lift slope per radian.
  • Mean Drag Coefficient – cd0, the profile drag the momentum solver adds to the torque coefficient as σ·cd0/8. It reaches nothing else.
  • Twist Distribution – Linear or Ideal, which decides the one blade pitch the block uses: (2/3)·θroot + (1/2)·θtwist on a Linear blade, θtip on an Ideal one.
  • Blade Root Angle – θroot, in radians (Linear twist).
  • Blade Twist Angle – θtwist, in radians (Linear twist).
  • Blade Tip Angle – θtip, in radians (Ideal twist).
  • Sampling Time (s) – zero or less inherits the solver's rate; a positive value runs the block at that period.

Code export

All ten targets: Python, MATLAB, Java, Rust, C, C++, VHDL, Verilog, SystemVerilog and PLC Structured Text. Every parameter is baked into the arithmetic at export, the two coefficients included – so a core exported with Compute using BEMT carries the pair the solver found and does not re-solve anything at run time.

The three HDL targets are simulation-only: a division and a signed square does not belong in a Q16.16 datapath, so they compute in real and quantize only at the ports – which also bounds what can cross one, ±32768. PLC Structured Text has no ATAN2 in IEC 61131-3, so where one is needed it is rebuilt from ATAN(y/x) with the quadrant reconstruction.

The four rotors are written out one after another rather than looped, so every arm and every coefficient is a constant in the emitted core.

Simulink bridge

Import and export, mapped to Aerospace Blockset's aerolibrotordyn/Multirotor. Units → units, Configuration → config, Arm Length → armLength, Rotor Height → rotorHeight, Coefficient Source → CTCQMode, Thrust Coefficient → CT, Torque Coefficient → CQ, Number Of Blades → Nb, Blade Radius → radius, Blade Chord → chord, Hinge Offset → hingeOffset, Lift Curve Slope → clalpha, Mean Drag Coefficient → cd0, Twist Distribution → twistType, Blade Root Angle → thetaRoot, Blade Twist Angle → thetaTwist and Blade Tip Angle → thetaTip; every combo is Simulink's own list, so the mapping is lossless. modelMode = Without flap effects (that is the Multirotor With Flap Effects block), controlInput = off and CTout = off are written fixed, because each of the three MOVES A PORT on the Simulink block and a fixed port list cannot follow one; Simulink's Ports coefficient source is not offered for the same reason. The Simulink block has no SampleTime (measured), so the rate stays on the ICore side.

Notes

  • Algebraic and stateless; nonlinear, so no state space.
  • Measured, not derived. Every rule above was read off Aerospace Blockset R2026a's own block, which is a built-in block type whose source does not ship, and the transcription agrees with it to 1e-16 on about 1600 random states.
  • Four rotors, always. Both Simulink configurations are quadcopters; the rotor count is not a parameter on either side.
  • A negative density is not refused here. The Simulink block stops the run on one.

Code facts#

FactValue
registered typeRobotics/Rotorcraft/Multirotor
familyRobotics/Rotorcraft
solver environment classICoreBlock_0_Robotics_1_Rotorcraft_2_Multirotor
sourcesrc/ICoreBlocks/ICoreBlockLibrary/Blocks/Robotics/Rotorcraft/Multirotor/ICoreBlock_0_Robotics_1_Rotorcraft_2_Multirotor.cpp
headersrc/ICoreBlocks/ICoreBlockLibrary/Blocks/Robotics/Rotorcraft/Multirotor/ICoreBlock_0_Robotics_1_Rotorcraft_2_Multirotor.h
default size on canvas170 × 120 px
ports at insert? in, ? out
code generators implementedPython, MATLAB, Java, Rust, C, C++, VHDL, Verilog, SystemVerilog, PLC Structured Text

Ports#

#DirectionSignal typeDescription label
1inICoreDoubleOmega
2inICoreDoublerho
3outICoreDoubleFxyz
4outICoreDoubleMxyz

Ports the constructor creates. A block whose port list changes with its configuration adds or removes ports at load time; the count above is the one a freshly inserted block has.

Configuration variables#

Config variableDefaultSimulink parameter
UnitsRA::comboValue(RA::unitOptions(), "Metric (MKS)")units
ConfigurationRA::comboValue(RA::quadOptions(), "Quadcopter X")config
Arm Length0.0624armLength
Rotor Height-0.0159rotorHeight
Coefficient SourceRA::comboValue(RA::sourceOptions(), "Dialog")CTCQMode
Thrust Coefficient0.0107CT
Torque Coefficient7.8263e-4CQ
Number Of Blades2Nb
Blade Radius0.0330radius
Blade Chord0.0080chord
Hinge Offset0hingeOffset
Lift Curve Slope5.5clalpha
Mean Drag Coefficient0cd0
Twist DistributionRA::comboValue(RA::twistOptions(), "Linear")twistType
Blade Root Angle0.2548thetaRoot
Blade Twist Angle-0.1361thetaTwist
Blade Tip Angle0.1018thetaTip

Every block also carries Sampling Time (s) from ICoreBlockSolverEnvironment: zero or less inherits the solver's rate, a positive value runs the block at that period.

supportSupport::Both
Simulink pathaerolibrotordyn/Multirotor
port-count rulePortsParam::None
SampleTime parameterno — the counterpart defines none; the rate stays on the ICore side
always setmodelMode = Without flap effects, controlInput = off, CTout = off
ICore configSimulink parameterValue translation
UnitsunitsMetric (MKS) → Metric (MKS), English (velocity in ft/s) → English (velocity in ft/s), English (velocity in kts) → English (velocity in kts)
ConfigurationconfigQuadcopter X → Quadcopter X, Quadcopter + → Quadcopter +
Arm LengtharmLengthpasses through
Rotor HeightrotorHeightpasses through
Coefficient SourceCTCQModeDialog → Dialog, Compute using BEMT → Compute using BEMT
Thrust CoefficientCTpasses through
Torque CoefficientCQpasses through
Number Of BladesNbpasses through
Blade Radiusradiuspasses through
Blade Chordchordpasses through
Hinge OffsethingeOffsetpasses through
Lift Curve Slopeclalphapasses through
Mean Drag Coefficientcd0passes through
Twist DistributiontwistTypeLinear → Linear, Ideal → Ideal
Blade Root AnglethetaRootpasses through
Blade Twist AnglethetaTwistpasses through
Blade Tip AnglethetaTippasses through

Caveat (shown to the user): modelMode, controlInput and CTout are always written fixed: each of the three MOVES A PORT on the Simulink block (flap effects add a body velocity and a body angular rate input, pitch angle inputs add a collective, and the computed-coefficient outputs add two), and a fixed port list cannot follow a parameter that does. The third CT and CQ source, Ports, is not offered for the same reason. The block has no SampleTime, so the rate stays on the ICore side

Catalog contract: src/ICoreBlocks/ICoreCoder/ICoreCommandSystem/SimulinkBridge/ICoreSimulinkBlockCatalog.h

Description vs code#

The checker has a blind spot here — it could not resolve something (a grouped port bullet, a computed config name), which is reported and never counted as a pass. A reader has to settle it:

  • B0 every stimulus in the sample errored — cross-checks skipped

The verdict above is tools/docs/check_block_descriptions.py (P7.1), which compares LISTS. It cannot read a sentence: "stateless" on a block with a state, an initial-value semantic the recursion does not implement, a "not synthesizable" caveat the HDL banner contradicts. That is the agent audit (P7.3) on BLOCK_DESCRIPTION_AUDIT.md, and this tool's green is not a substitute for one.

File banner (developer view)#

The top comment of the block's .cpp — the maths, the realization and the export strategy, addressed to whoever changes it. It must not contradict the description above (P7.5).

Multirotor -- four rotors as one block Each rotor's thrust and torque, summed with its arm: F = sum F_i, M = sum ([0; 0; Mz_i] + arm_i x F_i) with the four arms from the Quadcopter X or + configuration, the arm length and the rotor height. The coefficients are dialled in (one value, or one per rotor) or found by blade element momentum theory once per configuration load.

MEASURED against R2026a's aerolibrotordyn/Multirotor, a built-in block type whose source does not ship; the rules are in ICoreRotorAeroSupport.h.

ALGEBRAIC and STATELESS; nonlinear, so no state space. The three HDL targets are simulation-only real arithmetic, quantized only at the ports.

Sample results#

No stimulus produced a sampled output in this rig — Invalid input size at Multirotor block: ICore Blocks/Home/Multirotor. That is a fact about the single-block rig, not a verdict on the block: an offline batch fit, a block whose output only appears at onSolverFinish, or one that needs a driven environment cannot be exercised alone.

Category unsampled · sample time 0.1 · 60 steps · commit 23d8841c6561ca4bb64cd9b5b64da9638de12629 · produced by docsSample --out <folder> --blocks Fixed_Wing_Point_Mass Kernel_Classifier_Predictor Kernel_Regression_Predictor Rotor Rotor_With_Flap_Effects Multirotor Multirotor_With_Flap_Effects Dynamic_Inflow_3_State Kurtogram Empirical_Mode_Decomposition Modal_FRF Order_Spectrum --steps 60

Sample data: docs/generated/samples/Robotics__Rotorcraft__Multirotor.json