-
Notifications
You must be signed in to change notification settings - Fork 37
Settings
This page corresponds to the latest firmware revision. Previous versions can be found here.
Wait for 250ms zero throttle on startup:
-
0
: off -
1
: on
Damped mode (complementary PWM, active freewheeling):
-
0
: off -
1
: on
Reversed motor direction:
-
0
: off -
1
: on
Brushed mode:
-
0
: off -
1
: on
In this mode, the ESC can be used with brushed motors connected to phases A and B (or C and B). The following settings have no effect: timing
, sine_range
, sine_power
, freq_min
, duty_spup
, duty_ramp
, duty_lock
, prot_stall
.
Motor timing (15˚/16) [1..31].
Sine startup range (%) [0 - off, 5..25]. This value sets the portion of throttle range dedicated to sine startup mode (crawler mode). Damped mode must be enabled before this setting can be activated. Stall protection can be used for seamless transition between sine startup and normal drive.
Sine startup power (%) [1..15]. Use caution because high values may lead to overheating.
Minimum PWM frequency (kHz) [16..48].
Maximum PWM frequency (kHz) [16..96]. Smooth transition from minimum to maximum PWM frequency happens across [30..60] kERPM range.
Minimum duty cycle (%) [1..100]. This value sets power level at minimum throttle.
Maximum duty cycle (%) [1..100]. This value sets power level at maximum throttle.
Maximum duty cycle during spin-up (%) [1..100]. Higher values give more power to the motor until the first sync'ed revolution, yet may increase the risk of overheating and frying things should the motor get jammed during a full throttle punch. Do not exceed the default value unless you know what you are doing!!!
Maximum duty cycle ramp (kERPM) [0..100]. This value enables maximum power limit to linearly change from duty_spup
(at zero RPM) to 100% (at duty_ramp
kERPM) depending on RPM. It is most useful for taming a full throttle punch at lower RPM.
Duty cycle slew rate (0.1%/ms) [1..100]. This value controls the speed of power change. Should the motor stutter on a full throttle punch, try decreasing this value or enable duty_ramp
instead if higher values are required for maximum agility. Alternatively, you can try increasing timing
albeit at the cost of efficiency and torque.
Drag brake amount when the motor is stopped (%) [0..100]. This value is also a starting brake amount in proportional brake mode.
Active drag brake:
-
0
: off -
1
: on
Damped mode must be enabled before this setting can be activated. Active drag brake amount is defined by duty_drag
. Use caution because high values may lead to overheating.
Throttle mode:
-
0
: forward -
1
: forward/reverse -
2
: forward/brake/reverse -
3
: forward/brake
Modes 2 and 3 are proportional brake modes. They are unavailable when active drag brake is enabled.
Preset throttle (%) [0..100]. This value also serves as power level at minimum throttle in analog mode. Arming must be disabled before a non-zero value can be set. For example:
set arm 0
set volume 0
set throt_set 10
Automatic throttle calibration for standard servo PWM frequencies, e.g. 50Hz, 100Hz, 125Hz, 200Hz, 250Hz, 333Hz:
-
0
: off -
1
: on
This mode works by aligning the internal clock with servo PWM period that is a multiple of 1000µs, i.e. for servo PWM frequency F=1000/n where n=2..20. It must be disabled should a non-standard servo PWM signal be used.
Minimum throttle setpoint (µs).
Middle throttle setpoint (µs).
Maximum throttle setpoint (µs).
Minimum analog throttle setpoint (mV).
Maximum analog throttle setpoint (mV).
Input mode:
-
0
: servo/Oneshot125/DSHOT -
1
: analog -
2
: serial -
3
: iBUS -
4
: SBUS/SBUS2 -
5
: CRSF
Analog mode:
- Available on ESCs with PA2/PA6 input pin.
- Throttle is unidirectional.
- Minimum throttle is
analog_min
(anything below is zero throttle). - Maximum throttle is
analog_max
and above.
Serial mode:
- Available on ESCs with PA2 input pin.
- See Serial Protocol for more information.
SBUS/SBUS2 is uninverted on AT32F421 MCU. To enable SBUS2 telemetry, telem_mode
must be set to 0 (KISS), and a non-zero physical ID must be assigned using telem_phid
to define telemetry slot range:
ID | Slots |
---|---|
1 | 2..7 |
2 | 10..15 |
3 | 18..23 |
4 | 26..31 |
Four sensors are exposed on the bus by the firmware (ID=1 as an example):
- SBS-01T - slot 2 (ESC temperature)
- SBS-01T - slot 3 (motor temperature)
- SBS-01C - slot 4 (current), slot 5 (voltage), slot 6 (consumption)
- SBS-01R - slot 7 (RPM)
Serial channel ID [0 - off, 1..14 - iBUS, 1..16 - SBUS/SBUS2/CRSF].
Telemetry mode:
-
0
: KISS -
1
: KISS auto -
2
: iBUS -
3
: S.Port -
4
: CRSF
In KISS auto and CRSF mode, telemetry data is sent every 32ms.
S.Port is uninverted on AT32F421 MCU.
Telemetry physical ID [0 - off, 1..2 - iBUS, 1..28 - S.Port, 1..4 - SBUS2].
Number of motor poles for RPM telemetry [2..100].
Stall protection (ERPM) [0 - off, 1500..3500]. If enabled, up to 8% power boost is applied to prevent the motor from slowing down below the threshold. This value also overrides the default maximum RPM in sine startup mode (2300 ERPM).
Temperature threshold (˚C) [0 - off, 60..140]. If enabled, maximum power is reduced when temperature is above this value. The maximum power reduction is 75% for trap mode, 50% for sine startup and 60% for active drag brake at 15˚C above the theshold.
Temperature sensor:
-
0
: ESC -
1
: motor -
2
: both
This setting selects temperature source for prot_temp
.
Low voltage cutoff per battery cell (V/10) [0 - off, 28..38].
Number of battery cells [0 - auto, 1..24].
Maximum current (A) [0..500].
Startup music. A sequence of characters is translated into music in the following way:
- An optional number in the beginning defines tempo (BPM);
-
_
(underscore) is a pause; -
cdefgab
are low notes; -
CDEFGAB
are high notes; -
#
(pound) after a note makes it a sharp note; -
n
(number) after a note or pause is a duration: 1 - 1/16 (default), 2 - 1/8, 3 - 3/16, 4 - 1/4, etc. -
+
(plus) enables octave shift; -
-
(minus) disables octave shift;
Sound volume (%) [0..100].
Beacon volume (%) [0..100].
BEC voltage control:
-
0
: 5.5V -
1
: 6.5V -
2
: 7.4V -
3
: 8.4V
LED on/off bits [0..15].
This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY, without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. NOT FOR MILITARY USE. May all beings be happy.