Support several firmware versions. Flip or read bits instead of whole bytes for some parameters. Some new parameters.

Makefile

@@ -18,6 +18,8 @@ load:
 unload:
 	-rmmod msi-ec
 
+reload: unload load
+
 install:
 	mkdir -p /lib/modules/$(shell uname -r)/extra
 	cp msi-ec.ko /lib/modules/$(shell uname -r)/extra
@@ -37,7 +39,7 @@ dkms-install:
 	cp $(CURDIR)/dkms.conf $(DKMS_ROOT_PATH)
 	cp $(CURDIR)/Makefile $(DKMS_ROOT_PATH)
 	cp $(CURDIR)/msi-ec.c $(DKMS_ROOT_PATH)
-	cp $(CURDIR)/constants.h $(DKMS_ROOT_PATH)
+	cp $(CURDIR)/registers_configuration.h $(DKMS_ROOT_PATH)
 
 	sed -e "s/@CFLGS@/${MCFLAGS}/" \
 	    -e "s/@VERSION@/$(VERSION)/" \

README.md

@@ -28,12 +28,19 @@ Also, and until future enhancements, no DMI data is used to identify your laptop
 This driver exports a few files in its own platform device, msi-ec, and is available to userspace under:
 
 - `/sys/devices/platform/msi-ec/webcam`
-  - Description: This entry allows enabling the integrated webcam.
+  - Description: This entry allows enabling the integrated webcam (as if it was done by a keyboard button).
   - Access: Read, Write
   - Valid values:
     - on: integrated webcam is enabled
     - off: integrated webcam is disabled
 
+- `/sys/devices/platform/msi-ec/webcam_block`
+  - Description: This entry allows blocking the integrated webcam. Being blocked by this entry, webcam can't be enabled by a keyboard button or by writing into the webcam file.
+  - Access: Read, Write
+  - Valid values:
+    - on: integrated webcam is blocked
+    - off: integrated webcam is not blocked
+
 - `/sys/devices/platform/msi-ec/fn_key`
   - Description: This entry allows switching the position between the function key and the windows key.
   - Access: Read, Write
@@ -63,23 +70,43 @@ This driver exports a few files in its own platform device, msi-ec, and is avail
     - on: cooler boost function is enabled
     - off: cooler boost function is disabled
 
+- `/sys/devices/platform/msi-ec/available_shift_modes`
+  - Description: This entry reports all supported shift modes.
+  - Access: Read
+  - Valid values: Newline separated list of strings.
+
 - `/sys/devices/platform/msi-ec/shift_mode`
   - Description: This entry allows switching the shift mode. It provides a set of profiles for gaining CPU & GPU overclock/underclock.
   - Access: Read, Write
   - Valid values:
-    - turbo: over-voltage and over-clock for the CPU & GPU, aka overcloking mode
-    - sport: full clock frequency for the CPU & GPU, aka default desktop mode
-    - comfort: dynamic clock frequency for the CPU & GPU, aka power balanced mode
-    - eco: low clock frequency for the CPU & GPU, aka power saving mode
-    - off: operating system decides
+    - unspecified (read-only)
+    - Values reported by `/sys/devices/platform/msi-ec/available_shift_modes`. Some of the possible values:
+      - eco: low clock frequency and voltage for the CPU & GPU, aka power saving mode
+      - comfort: dynamic clock frequency and voltage for the CPU & GPU, aka power balanced mode
+      - sport: full clock frequency and voltage for the CPU & GPU, aka default desktop mode
+      - turbo: over-voltage and over-clock for the CPU & GPU, aka overclocking mode
+
+- `/sys/devices/platform/msi-ec/super_battery`
+  - Description: This entry allows switching the super battery function.
+  - Access: Read, Write
+  - Valid values:
+    - on: super battery function is enabled
+    - off: super battery function is disabled
+
+- `/sys/devices/platform/msi-ec/available_fan_modes`
+  - Description: This entry reports all supported fan modes.
+  - Access: Read
+  - Valid values: Newline separated list of strings.
 
 - `/sys/devices/platform/msi-ec/fan_mode`
   - Description: This entry allows switching the fan mode. It provides a set of profiles for adjusting the fan speed under specific criteria.
   - Access: Read, Write
   - Valid values:
-    - auto: fan speed adjusts automatically
-    - basic: fixed 1-level fan speed for CPU/GPU (percent)
-    - advanced: fixed 6-levels fan speed for CPU/GPU (percent)
+    - Values reported by `/sys/devices/platform/msi-ec/available_fan_modes`. Some of the possible values:
+      - auto: fan speed adjusts automatically
+      - silent: fan is disabled
+      - basic: fixed 1-level fan speed for CPU/GPU (percent)
+      - advanced: fixed 6-levels fan speed for CPU/GPU (percent)
 
 - `/sys/devices/platform/msi-ec/fw_version`
   - Description: This entry reports the firmware version of the motherboard.

ec_memory_configuration.h

@@ -0,0 +1,112 @@
+#ifndef __MSI_EC_REGISTERS_CONFIG__
+#define __MSI_EC_REGISTERS_CONFIG__
+
+#include <linux/types.h>
+
+#define MSI_EC_DRIVER_NAME "msi-ec"
+
+#define MSI_EC_ADDR_UNKNOWN 0xff00 // unknown address
+
+// Firmware info addresses are universal
+#define MSI_EC_FW_VERSION_ADDRESS 0xa0
+#define MSI_EC_FW_DATE_ADDRESS    0xac
+#define MSI_EC_FW_TIME_ADDRESS    0xb4
+#define MSI_EC_FW_VERSION_LENGTH  12
+#define MSI_EC_FW_DATE_LENGTH     8
+#define MSI_EC_FW_TIME_LENGTH     8
+
+struct msi_ec_charge_control_conf {
+	int address;
+	int offset_start;
+	int offset_end;
+	int range_min;
+	int range_max;
+};
+
+struct msi_ec_webcam_conf {
+	int address;
+	int block_address;
+	int bit;
+};
+
+struct msi_ec_fn_win_swap_conf {
+	int address;
+	int bit;
+};
+
+struct msi_ec_cooler_boost_conf {
+	int address;
+	int bit;
+};
+
+#define MSI_EC_MODE_NULL { NULL, 0 }
+struct msi_ec_mode {
+	const char *name;
+	int value;
+};
+
+#define MSI_EC_SHIFT_MODE_NAME_LIMIT 20
+struct msi_ec_shift_mode_conf {
+	int address;
+	struct msi_ec_mode modes[5]; // fixed size for easier hard coding
+};
+
+struct msi_ec_super_battery_conf {
+	int address;
+	int mask;
+};
+
+struct msi_ec_fan_mode_conf {
+	int address;
+	struct msi_ec_mode modes[5]; // fixed size for easier hard coding
+};
+
+struct msi_ec_cpu_conf {
+	int rt_temp_address;
+	int rt_fan_speed_address; // realtime
+	int rt_fan_speed_base_min;
+	int rt_fan_speed_base_max;
+	int bs_fan_speed_address; // basic
+	int bs_fan_speed_base_min;
+	int bs_fan_speed_base_max;
+};
+
+struct msi_ec_gpu_conf {
+	int rt_temp_address;
+	int rt_fan_speed_address; // realtime
+};
+
+struct msi_ec_led_conf {
+	int micmute_led_address;
+	int mute_led_address;
+	int bit;
+};
+
+#define MSI_EC_KBD_BL_STATE_MASK 0x3
+struct msi_ec_kbd_bl_conf {
+	int bl_mode_address;
+	int bl_modes[2];
+	int max_mode;
+
+	int bl_state_address;
+	int state_base_value;
+	int max_state;
+};
+
+struct msi_ec_conf {
+	const char **allowed_fw;
+
+	struct msi_ec_charge_control_conf charge_control;
+	struct msi_ec_webcam_conf         webcam;
+	struct msi_ec_fn_win_swap_conf    fn_win_swap;
+	struct msi_ec_cooler_boost_conf   cooler_boost;
+	struct msi_ec_shift_mode_conf     shift_mode;
+	struct msi_ec_super_battery_conf  super_battery;
+	struct msi_ec_fan_mode_conf       fan_mode;
+	struct msi_ec_cpu_conf            cpu;
+	struct msi_ec_gpu_conf            gpu;
+	struct msi_ec_led_conf            leds;
+	struct msi_ec_kbd_bl_conf         kbd_bl;
+};
+
+#endif // __MSI_EC_REGISTERS_CONFIG__