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 automaticallysilent: very low fan speed to keep the fan quietbasic: custom constant fan speedadvanced: 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