Skip to content
teackot edited this page Sep 18, 2023 · 10 revisions

List of parameters

EC firmware version

Location /sys/devices/platform/msi-ec/fw_version
Access Read
Valid values a 12 character long string
EC address [0xa0..0xac) (12 bytes)

This entry reports the version of the EC firmware. Not to be confused with the BIOS firmware version.

EC firmware release date

Location /sys/devices/platform/msi-ec/fw_version
Access Read
Valid values a 19 character long string
EC address [0xac..0xbc) (16 bytes)

This entry reports the release date and time of the EC firmware.

Webcam

Location /sys/devices/platform/msi-ec/webcam
Access Read, Write
Valid values on, off
Possible EC addresses 0x2e

This entry enables/disables the integrated webcam (same way the keyboard button does it)

Webcam Block

Location /sys/devices/platform/msi-ec/webcam_block
Access Read, Write
Valid values on, off
Possible EC addresses 0x2f

This parameter disables the integrated webcam and blocks it from being enabled by a keyboard button. on means the webcam is blocked

Fn-Win swap

Location /sys/devices/platform/msi-ec/fn_key
/sys/devices/platform/msi-ec/win_key
Access Read, Write
Valid values left, right
Possible EC addresses 0xbf, 0xe8

This entry allows swapping the function key and the windows key

Cooler Boost

Location /sys/devices/platform/msi-ec/cooler_boost
Access Read, Write
Valid values on, off
Possible EC addresses 0x98

This entry enables the cooler boost function. It improves the laptop cooling by boosting the fan speed.

The EC address seems to be universal ([0x98], bit 7), at least across the models supported by this driver.

Shift Mode

Location (1) /sys/devices/platform/msi-ec/shift_mode
(2) /sys/devices/platform/msi-ec/available_shift_modes
Access (1) Read, Write
(2) Read
Valid values unspecified (read-only), eco, comfort, sport, turbo
Possible EC addresses 0xf2, 0xd2

This parameter represents the performance modes. available_shift_modes reports the available modes.

Originally this was the only parameter known to be related to the "Shift Mode" parameter of the MSI Dragon Center, thus the name. Now we know another one (see Super Battery) but don't have enough info to properly rename it.

Reference EC values:

mode value
unspecified 0x80
eco 0xc2
comfort 0xc1
sport 0xc0
turbo 0xc4

Super Battery

Location /sys/devices/platform/msi-ec/super_battery
Access Read, Write
Valid values -
Possible EC addresses 0xd5, 0xeb, 0xe5

Warning: this parameter is WIP

This entry represents the performance modes (different from the Shift Mode).

The parameter changes with the Shift Mode of the MSI Dragon Center. Originally we associated it only with the "super battery" shift mode, thus the name.

Fan Mode

Location (1) /sys/devices/platform/msi-ec/fan_mode
(2) /sys/devices/platform/msi-ec/available_fan_modes
Access (1) Read, Write
(2) Read
Valid values auto, silent, basic, advanced
Possible EC addresses 0xf4, 0xd4

The fan_mode parameter controls the fan mode. It provides a set of profiles for adjusting the fan speed under specific criteria. available_fan_modes reports the available modes.

Supported modes are:

  • auto: the fan speed is controlled automatically
  • silent: very low fan speed to keep the fan quiet
  • basic: custom constant fan speed
  • advanced: custom fan curve

Reference EC values:

mode values
auto 0x0d, 0x0f
silent 0x1d, 0x1f
basic 0x4d, 0x4f
advanced 0x8d, 0x8f

Battery thresholds

Location (1) /sys/class/power_supply/<supply_name>/charge_control_start_threshold
(2) /sys/class/power_supply/<supply_name>/charge_control_end_threshold
Access Read, Write
Valid values 0 - 100 (percent)
Possible EC addresses 0xef, 0xd7

These parameters control charging thresholds. Battery stops charging when it reaches the end threshold and starts charging when it reaches the start threshold. Thresholds are always 10% apart