Settings

Description

To configure the board, edit the settings.ini file on the microSD card. settings.ini is a plain text file, which can be edited and viewed with any text editor. Change the values ​​of the parameters - strings like "key = value". For example, the value:

control_enable_toggle = false

Can be changed to:

control_enable_toggle = true

If the parameter is absent or is set incorrectly, the default value is taken, see the table below.

No need to edit the following lines:

  • comments - from the ";" (semicolon) at the beginning of the line to the end of the line;
  • section headers - lines consisting of a section name enclosed in square brackets "[]";

The current version of the settings.ini file can be downloaded here: DK App.

Settings

RC receiver

Name Description Values Default
rc_receiver_shot_through_stick

Shot and machine gun through the stick

When turned on, a shot from the main gun and from a machine gun can be made with the barrel elevate stick - quick movement of the stick up or down. But this reduces the convenience of controlling of the barrel.
true
false
true
rc_receiver_stick_stop

Stopping the engine with a stick

If this option is enabled, you can turn off the engine with the motion stick - move the stick down three times. It makes sense to turn off this parameter to prevent accidental stopping, for example at competitions.
true
false
true
rc_receiver_volume_through_pots

Volume adjustment through potentiometer

Support for volume adjustment potentiometer with continuously adjustable volume. By default, the volume is adjusted in steps via a 3 position switch.
true
false
false
rc_receiver_actions_sensitivity

The sensitivity of the sticks for performing combinations

The parameter determines the positioning accuracy of the stick for performing stick combinations.Recommended values: 0.1 - 0.5. Try increasing the parameter value, if there are problems with executing combinations.
0.0 - 1.0 0.2
rc_receiver_tamiya_stick_position

Support for stick combinations when connected like Tamiya

By default, stick combinations for activating additional actions work for the stick on CH3 and CH4. Enable this option if you have CH1 tank turning channels and CH3 barrel elevation on the same stick. Then stick combinations will work for the stick on CH1 and CH3.
true
false
false
rc_receiver_move_deadband

Move channel dead zone

Dead zone ratio for motion stick.
0.0 - 1.0 0.05
rc_receiver_turn_deadband

Turn channel dead zone

Dead zone ratio for turning stick.
0.0 - 1.0 0.05
rc_receiver_rotate_deadband

Rotate channel dead zone

Dead zone ratio for rotation stick.
0.0 - 1.0 0.1
rc_receiver_elevate_deadband

Elevate channel dead zone

Dead zone ratio for elevation stick.
0.0 - 1.0 0.1

Light

Name Description Values Default
light_massively_indicate

Indication by all illumination LEDs

If enabled, to indicate events such as hit, destruction, low battery, etc. additional LEDs for front and rear lighting are used. If the parameter is disabled, the indication is carried out only by the one LED indicator.
true
false
true

Sounds

Name Description Values Default
sound_amplifier_enable

Turn on / off audio amplifier

Use this parameter if you don't need sounds or you are using an external audio amplifier.
true
false
true
sound_volume

Sound volume

Limiting the maximum volume of sounds.
0.0 - 1.0 1.0
sound_volume_engine

Engine volume

Changing engine volume in the background of other sounds.
0.0 - 1.0 0.8
sound_volume_roar

Roar volume

Changing roar volume in the background of other sounds.
0.0 - 1.0 0.8
sound_volume_turret

Turret sounds volume

Changing turret sounds volume in the background of other sounds.
0.0 - 1.0 0.8
sound_volume_battle

Battle sounds volume

Changing battle sounds volume in the background of other sounds.
0.0 - 1.0 1.0
sound_volume_interior

Volume of interior sounds

Changing the volume of sounds inside the tank: the sound of reloading, the sound of toggle switches, etc.
0.0 - 1.0 0.8
sound_engine_volume_raising

Increase engine sound volume when driving

How much the engine volume will increase from the minimum speed to the maximum. Set the value to 0.0 to remove this effect.
0.0 - 1.0 0.3
sound_engine_stretch

Engine pitch stretching

How much to stretch the sound of the engine in proportion to the movement. 0.0 - no stretching. 1.0 - stretches 2.5 times.
0.0 - 1.0 0.8
sound_play_load_previously

Projectile loading sound length

For how many milliseconds before the end of the reloading of the gun, the sound of the shell will be played.
0 - 30000 2500
sound_cold_start_in_first_start

Cold start sound on first start

Play a cold start sound on startup. In any case, the sound of a cold start will be after the tank is idle with the engine off.
true
false
true

IR Battle

Name Description Values Default
battle_class

Vehicle class

light - Light tank. Durability 3, recharge 3 seconds.
medium - Medium tank. Durability 5, recharge 5 seconds.
mbt - MBT. Durability 7, recharge 7 seconds.
heavy - Heavy tank. Durability 9, recharge 9 seconds.
super_heavy - Super Heavy tank. Durability 12, recharge 12 seconds.
light
medium
mbt
heavy
super_heavy
heavy
battle_damage_type

Damage type of modules upon impact

speed - slows down the speed by 50% and 75% under the Tamiya protocol.
modules - extended system for damaging modules.
speed
modules
speed
battle_without_turret

Fighting vehicle without a rotating turret

Activate this option if the vehicle does not have a rotating turret and the extended damage system mode is enabled. In this case, turret rotation damage will not work.
true
false
false
battle_ammunition

Ammunition

The maximum number of shots for the IR combat system. Once destroyed, ammo is restored. Set 0 for infinite ammo.
0 - 30000 60
battle_shot_in_motion

Stop when shot

force_stop - forced stop of the tank before firing.
forbidden - no shot while moving.
miss - a shot occurs while moving, but no IR signal is transmitted.
allowed - the tank can shoot on the move.
force_stop
forbidden
miss
allowed
force_stop
battle_hit_freeze

Stop on hit

Time, in milliseconds, for which the tank stops when hit (crew concussion).
0 - 30000 500
battle_half_speed_damages_power

Motor power at 50% speed reduction

How much to limit the power of the motors, when the speed of movement is halved from hits.
0.0 - 1.0 0.6
battle_fourth_speed_damages_power

Motor power at 75% speed reduction

How much to limit the power of the motors, when the speed of movement is reduced by four times from hits.
0.0 - 1.0 0.4
battle_class_custom

Manual setting of vehicle class

If the option is enabled, the vehicle class setting stops working.Durability, reload and speed reduction are controlled by separate parameters.
true
false
false
battle_custom_hp

Прочность

Vehicle durability (HP). Used when manually setting the vehicle class.
0 - 30000 9
battle_custom_reload_time

Reload

Reload time in seconds. Used when manually setting the vehicle class.
0 - 30000 9
battle_custom_half_speed_damages

Slow 2x on hit

The number of hits at which the movement speed is halved.If 0, then deceleration is disabled. Used when manually setting vehicle class.
0 - 30000 1
battle_custom_fourth_speed_damages

Slow 4x on hit

The number of hits at which the movement speed is reduced by four times.If 0, then deceleration is disabled. Used when manually setting the vehicle class.
0 - 30000 5

IR signals

Name Description Values Default
ir_support_several_protocols

Support for multiple battle protocols

Send and receive other protocols besides Tamiya: Heng Long, Taigen.
true
false
true
ir_accept_any_signal

Accept all protocols

Recognize any incoming signals as a hit.Attention! This mode is not immune to interference, there is a high probability of triggers from background light.
true
false
false
ir_hit_invulnerability

Invincible on hit

Time in milliseconds for which we do not receive new hits when receiving an IR signal.For most combat systems, the value should not be less than a second.
0 - 30000 1100
ir_tamiya_accuracy

Tamiya signal reception accuracy

0 - 30000 1000
ir_henglong_accuracy

Tamiya signal reception accuracy

0 - 30000 500
ir_taigen_accuracy

Tamiya signal reception accuracy

0 - 30000 30

Steer

Name Description Values Default
steer_mode

Control mode

default - classic mode.
pilotage - Turn in place is only activated with the motion stick.
expert - back turns are inverted. There are no dead zones on the stick, smooth speed change when changing direction of movement.
tankoman - direct control of the sticks of each track. The channel for elevate the barrel will become responsible for the rotation of the left track, the channel for movement will become responsible for the right track, and the channel for turning will be for elevate the barrel. Combinations with sticks are preserved. Smooth acceleration settings will not work in this mode.
default
pilotage
expert
tankoman
default
steer_enable_spin

Spin in place

When this parameter is enabled, the tank turns in place due to the multidirectional movement of the tracks.When the parameter is disabled, turning in place is performed by rotating only one track.
true
false
true
steer_spin_power

Turning speed in place

Limiting the power of the motors when turning the tank in place.
0.0 - 1.0 0.5
steer_enable_acceleration

Gradual acceleration

Emulation of a gradual acceleration.
true
false
true
steer_acceleration_full_time

Time to reach full speed

Time in milliseconds for which the tank attains a maximum speed.The parameter works if gradual acceleration is enabled.
0 - 30000 3000
steer_acceleration_start_speed

Lower Threshold for gradual acceleration

The speed of the tank, at which the emulation of the gradual acceleration begins.For example, if the parameter is 0.5, the gradual acceleration will work when the tank speed is above 50%.The parameter works if gradual acceleration is enabled.
0.0 - 1.0 0.5
steer_starting_delay

Delay when starting to move

Delay in milliseconds when starting to move. The delay is necessary in order to be able to roar the engine without moving. Set to 0 if you want to start without delay.
0 - 30000 500
steer_redirect_delay

Delay when changing direction

Delay in milliseconds when changing direction of movement.A gear change sound is played during the delay.Set the value to 0 if you want to change the direction of movement without delay.
0 - 30000 1000

Motor regulators

Name Description Values Default
driver_gear_type

Gearbox type

equivalent_motors - classic gearboxes with two motors for each track
clutch_gearbox - single drive motor gearbox (clutch gearbox). In this case, the MOTOR A LEFT jack is responsible for movement, and the MOTOR B RIGHT jack is responsible for turning.
equivalent_motors
clutch_gearbox
equivalent_motors
driver_power

Motor power

Power factor of motors. Global Power Limiter.
0.0 - 1.0 1.0
driver_backward_power

Reverse motor power

Power factor of the motors when driving backward.
0.0 - 1.0 0.5
driver_invert_left

Invert right motor

Invert the direction of movement of the right motor.
true
false
false
driver_invert_right

Invert left motor

Invert the direction of movement of the left motor.
true
false
false
driver_left_power

Correction of left motor power

Left motor power factor. Use the alignment movement.
0.0 - 1.0 1.0
driver_right_power

Correction of right motor power

Right motor power factor. Use the alignment movement.
0.0 - 1.0 1.0
driver_safe_motor_inertia

Inertia to protect the motor

Time in milliseconds for which the tank attains a maximum speed. Used to protect against sudden polarity reversal and sudden current surges.At high values, the parameter can be used to emulate the inertia of heavy vehicles.
Attention! It is not recommended to set values below 500.
0 - 30000 500
driver_cutoff_start_power

Initial power cutoff

In most cases, low power on the engines does not lead to the start of the movement of the tank, therefore, it makes sense to start moving from a certain power threshold. This will result in more responsive control and remove stick dead space.
The optimal value of the parameter depends on the power of the motor, the gear ratio of the gearbox and personal preference. Ideally, the cutoff should be such that the tank starts moving smoothly and from the very beginning of accelerating with the stick. Recommended values ​​are 0.1 - 0.3. If the value is 1.0, the control of the tank will become discrete - moving at maximum speed and stopping.
Parameter has a global meaning, and other power limitations (forward, backward, turn, etc.) are recalculated with cutoff.
0.0 - 1.0 0.2
driver_turn_brake_power

Activating the brake when turning

Power for the brake motor when turning in place with one track. During a turn, the inactive motor is reversed. The brake is applied when enabled the turn in place. Protects against unnecessary track rotation on certain surfaces. The initial brake power cutoff is not used.
0.0 - 1.0 0.1
driver_max_current

Current limiting in regulators

The current in the regulators of the motors in Amperes, when exceeded, the cutoff is triggered.
0.0 - 30.0 20.0
driver_max_current_limit_type

Overcurrent cutoff type in regulators

Options for actions when the current limit is exceeded:
delay - stop motion for a while.
limit - reducing the power of motors for a while.
stop - the event of turning off the tank's engine is activated, as if the tank had stalled.
delay
limit
stop
delay
driver_frequency

Regulator frequency

Operating frequency in Hertz, which motor regulators are working.
1000 - 20000 20000

Turret rotation

Name Description Values Default
turret_invert

Invert turret rotation

true
false
false
turret_driver_power

Turret rotation speed

Motor power factor for turret rotation.
0.0 - 1.0 1.0

Turret rotation by servomotor

Name Description Values Default
turret_servo_invert

Invert turret rotation by servomotor

true
false
false
turret_servo_speed

Turret rotation speed

Servomotor power factor for turret rotation.
0.0 - 1.0 1.0

Barrel elevation

Name Description Values Default
barrel_invert

Invert barrel elevation

true
false
false

Barrel elevation by servomotor

Name Description Values Default
barrel_servo_invert

Invert barrel elevation

true
false
false
barrel_servo_hold

Holding barrel elevation

If enabled, the servo will try to align position all the time.
true
false
false
barrel_servo_max_pulse

Maximum servo value of elevation

The maximum value of the servo position impulse for barrel elevation.Typical values for the servos are in the range from 1000 to 2000.
0 - 30000 2000
barrel_servo_min_pulse

Minimum servo value of elevation

The minimum value of the servo position impulse for barrel elevation.Typical values for the servos are in the range from 1000 to 2000.
0 - 30000 1000
barrel_servo_mid_pulse

Neutral servo value of elevation

The neutral value of the servo position impulse for barrel elevation.Typical values for the servos are in the range from 1000 to 2000.
0 - 30000 1500
barrel_servo_rise_time

Time of full barrel movement

Time in milliseconds for which the servo motor will rise from one extreme positionto the other extreme position at maximum speed. The lower the value, the faster the barrel moves.
0 - 30000 2000

Airsoft shot and mechanical recoil

Name Description Values Default
tension_type

Tension type - airsoft or mechanical recoil

default - first the shot (sound, light, IR), then the tension of the airsoft spring. Suitable for both airsoft and mechanical rollback. Mandatory for IR combat.
airsoft_manual - tension the airsoft spring until the switch is triggered, then shot. Manual spring tension.
airsoft_auto - tension the airsoft spring until the switch is triggered, then shot. Automatic spring tension
default
airsoft_manual
airsoft_auto
default
tension_trigger_delay

Delay in triggering at the start of the shot

Time in milliseconds, at which the trigger is inactive at the start of the shot. It is necessary to unlock the trigger if it was closed after the previous shot.
0 - 30000 200
tension_tightening

Tightening the motor after triggering

Time in milliseconds. Tightening the motor after triggering, to be ready for the next shot.
0 - 30000 500
tension_timeout

Time limit for tension

Time in milliseconds. How long does it take to stop the tension, if the trigger fails for some reason. You can try to guess the value if you don't have a trigger.
0 - 30000 5000

Hull rollback

Name Description Values Default
rollback_enable

Enable hull rollback

true
false
true
rollback_time_back

Rollback time back

Time in milliseconds during which the tank will rollback.
0 - 30000 200
rollback_time_forward

Rollback time forward

Time in milliseconds during which the tank will rollback forward.
0 - 30000 200
rollback_power

Rollback motor power

Motor power factor at rollback.
0.0 - 1.0 0.3
rollback_left_power

Correction of left motor power at rollback

The power factor of the left motor at recoil to equalize the power of the motors.
0.0 - 1.0 1.0
rollback_right_power

Correction of right motor power at rollback

The power factor of the right motor at recoil to equalize the power of the motors.
0.0 - 1.0 1.0

Barrel rollback through a servo motor

Name Description Values Default
recoil_servo_invert

Invert servo recoil

true
false
false
recoil_servo_time

Barrel recoil inward duration

Duration in milliseconds during which the servo will move to the position of the barrel inward andstay in this position. The servo will move at maximum speed.
0 - 30000 500
recoil_servo_return_time

Barrel return duration

Duration in milliseconds during which the servomotor will return to its original state.Barrel return will be smooth.
0 - 30000 1000
recoil_servo_pulse

Servo value for barrel inside turret

The value of the servo position pulse for the barrel inside the turret.Typical values for the servos are in the range from 1000 to 2000.
0 - 30000 2000
recoil_servo_return_pulse

Servo value for barrel outside turret

The value of the servo position pulse for the barrel outside the tower.Typical values for the servos are in the range from 1000 to 2000.
0 - 30000 1000

Smoke module

Name Description Values Default
smoke_mode

Smoke unit operating mode

engine - the work of the smoke dash corresponds to the work of the engine.
shot - the smoke machine works for a while when fired.
destroy - the smoke machine works for a while when a tank is destroyed.
shot_and_destroy - shot and destruction.
engine_and_destroy - engine and destruction.
engine
shot
destroy
shot_and_destroy
engine_and_destroy
engine
smoke_move_max_power

Maximum power of the smoke unit in motion

Maximum power factor of the smoke machine in motion.
0.0 - 1.0 1.0
smoke_idle_power

Power smoke unit at idle

The power factor of the smoke unit at idle.
0.0 - 1.0 0.5
smoke_destroy_power

Power smoke unit when destroyed

The power factor of the smoke unit when destroyed.
0.0 - 1.0 1.0
smoke_destroy_time

Working time after destruction

Time in seconds of the first stage of the smoke unit operation after the destruction of the tank.
0 - 30000 30
smoke_destroy_fading_time

Gradual decrease time after destruction

Time in seconds of the second stage of gradual decrease of the power of the smoke unit.
0 - 30000 30
smoke_shot_power

Power smoke unit with shot

Power factor operation smoke unit at a shot.
0.0 - 1.0 1.0
smoke_shot_duration

Operating time with shot

Time in milliseconds of the smoke machine after a shot.
0 - 30000 3000

External ESC

Name Description Values Default
esc_anti_brake_hack

Bypassing the brake function on the ESC

Bypassing the brake function on ESCs that do not support the setting to disable this function.
true
false
false

TOGGLE connector

Name Description Values Default
toggle_enable

Enable TOGGLE connector

Activation of the TOGGLE connector to manually turn on / off third-party 5 volt equipment.
Caution! The TOGGLE connector on the board shares the function with the barrel elevate in the HL connector. If you need a TOGGLE connector, use the barrel elevate function in HL 5.3 or ELEVATE connectors.
true
false
false

Battery settings

Name Description Values Default
battery_warning_volt

Low battery warning

Voltage at which a low battery indication occurs.
0.0 - 7.0 6.5
battery_critical_volt

Low battery shutdown

Voltage at which the movement of the tank is turned off.
0.0 - 7.0 6.0

Prev