/* SPDX-License-Identifier: GPL-2.0+ */
/*!
 * Copyright (c) 2021-2024 TUXEDO Computers GmbH <tux@tuxedocomputers.com>
 *
 * This file is part of tuxedo-drivers.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program 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.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, see <https://www.gnu.org/licenses/>.
 */

#ifndef UNIWILL_INTERFACES_H
#define UNIWILL_INTERFACES_H

#include <linux/types.h>

#define UNIWILL_WMI_MGMT_GUID_BA	"ABBC0F6D-8EA1-11D1-00A0-C90629100000"
#define UNIWILL_WMI_MGMT_GUID_BB	"ABBC0F6E-8EA1-11D1-00A0-C90629100000"
#define UNIWILL_WMI_MGMT_GUID_BC	"ABBC0F6F-8EA1-11D1-00A0-C90629100000"

#define UNIWILL_WMI_EVENT_GUID_0	"ABBC0F70-8EA1-11D1-00A0-C90629100000"
#define UNIWILL_WMI_EVENT_GUID_1	"ABBC0F71-8EA1-11D1-00A0-C90629100000"
#define UNIWILL_WMI_EVENT_GUID_2	"ABBC0F72-8EA1-11D1-00A0-C90629100000"

#define UNIWILL_WMI_FUNCTION_WRITE			0
#define UNIWILL_WMI_FUNCTION_READ			1
#define UNIWILL_WMI_FUNCTION_FEATURE_TOGGLE		5

#define UNIWILL_WMI_LOCAL_DIMMING_ON			0x0E
#define UNIWILL_WMI_LOCAL_DIMMING_OFF			0x0D

#define MODULE_ALIAS_UNIWILL_WMI() \
	MODULE_ALIAS("wmi:" UNIWILL_WMI_EVENT_GUID_2); \
	MODULE_ALIAS("wmi:" UNIWILL_WMI_MGMT_GUID_BC);

#define UNIWILL_INTERFACE_WMI_STRID "uniwill_wmi"

typedef int (uniwill_read_ec_ram_t)(u16, u8*);
typedef int (uniwill_read_ec_ram_with_retry_t)(u16, u8*, int);
typedef int (uniwill_write_ec_ram_t)(u16, u8);
typedef int (uniwill_wmi_evaluate_t)(u8 function, u32 arg, u32 *return_buffer);
typedef int (uniwill_write_ec_ram_with_retry_t)(u16, u8, int);
typedef void (uniwill_event_callb_t)(u32);

// UW_EC_REG_* known relevant EC address exposing some information or function
// UW_EC_REG_*_BIT_* single bit from byte holding information, should be handled with bit-wise operations
// UW_EC_REG_*_VALUE_* discrete value of the whole byte with special meaning
// UW_EC_REG_*_SUBCMD_* writing this discrete value triggers special behaviour

#define UW_EC_REG_KBD_BL_STATUS				0x078c
#define UW_EC_REG_KBD_BL_STATUS_BIT_WHITE_ONLY_KB	0x01
#define UW_EC_REG_KBD_BL_STATUS_SUBCMD_RESET		0x10

#define UW_EC_REG_KBD_BL_MAX_BRIGHTNESS_IMMEDIATE	0x1801
#define UW_EC_REG_KBD_BL_WHITE_BRIGHTNESS_IMMEDIATE	0x1802
#define UW_EC_REG_KBD_BL_RGB_RED_BRIGHTNESS_IMMEDIATE	0x1803
#define UW_EC_REG_KBD_BL_RGB_GREEN_BRIGHTNESS_IMMEDIATE	0x1805
#define UW_EC_REG_KBD_BL_RGB_BLUE_BRIGHTNESS_IMMEDIATE	0x1808

#define UW_EC_REG_KBD_BL_RGB_MODE			0x0767
#define UW_EC_REG_KBD_BL_RGB_MODE_BIT_APPLY_COLOR	0x20
#define UW_EC_REG_KBD_BL_RGB_MODE_BIT_RAINBOW		0x80
#define UW_EC_REG_KBD_BL_RGB_RED_BRIGHTNESS		0x0769
#define UW_EC_REG_KBD_BL_RGB_GREEN_BRIGHTNESS		0x076a
#define UW_EC_REG_KBD_BL_RGB_BLUE_BRIGHTNESS		0x076b

#define UW_EC_REG_KBD_FN_LOCK_STATUS_BIT		0x074e

#define UW_EC_REG_CUSTOM_PROFILE			0x0727
#define UW_EC_REG_AC_AUTO_BOOT_STATUS			0x0726
#define UW_EC_REG_USB_POWERSHARE_STATUS			0x0767
#define UW_EC_REG_MINI_LED_LOCAL_DIMMING_SUPPORT	0x0D4F

#define UW_EC_REG_BATTERY_CYCN_LO	0x04A6
#define UW_EC_REG_BATTERY_CYCN_HI	0x04A7
#define UW_EC_REG_BATTERY_XIF1_LO	0x0402
#define UW_EC_REG_BATTERY_XIF1_HI	0x0403
#define UW_EC_REG_BATTERY_XIF2_LO	0x0404
#define UW_EC_REG_BATTERY_XIF2_HI	0x0405

#define UW_EC_REG_FAN_CTRL_STATUS			0x078e
#define UW_EC_REG_FAN_CTRL_STATUS_BIT_HAS_UW_FAN_CTRL	0x40

#define UW_EC_REG_CTGP_DB_ENABLE			0x0743
#define UW_EC_REG_CTGP_DB_ENABLE_BIT_GENERAL_ENABLE	0x01
#define UW_EC_REG_CTGP_DB_ENABLE_BIT_DB_ENABLE		0x02
#define UW_EC_REG_CTGP_DB_ENABLE_BIT_CTGP_ENABLE	0x04
#define UW_EC_REG_CTGP_DB_CTGP_OFFSET			0x0744
#define UW_EC_REG_CTGP_DB_TPP_OFFSET			0x0745
#define UW_EC_REG_CTGP_DB_DB_OFFSET			0x0746

#define UW_EC_REG_BAREBONE_ID				0x0740
#define UW_EC_REG_BAREBONE_ID_VALUE_PFxxxxx		0x09
#define UW_EC_REG_BAREBONE_ID_VALUE_PFxMxxx		0x0e
#define UW_EC_REG_BAREBONE_ID_VALUE_PH4TRX1		0x12
#define UW_EC_REG_BAREBONE_ID_VALUE_PH4TUX1		0x13
#define UW_EC_REG_BAREBONE_ID_VALUE_PH4TQx1		0x14
#define UW_EC_REG_BAREBONE_ID_VALUE_PH6TRX1		0x15
#define UW_EC_REG_BAREBONE_ID_VALUE_PH6TQxx		0x16
#define UW_EC_REG_BAREBONE_ID_VALUE_PH4Axxx		0x17
#define UW_EC_REG_BAREBONE_ID_VALUE_PH4Pxxx		0x18

#define UW_EC_REG_FEATURES_0				0x0765
#define UW_EC_REG_FEATURES_1				0x0766
#define UW_EC_REG_FEATURES_1_BIT_1_ZONE_RGB_KB		BIT(2)
#define UW_EC_REG_FEATURES_1_BIT_FIXED_COLOR_5_ENABLE	BIT(5)

#define UW_EC_REG_ROMID_START				0x0770
#define UW_EC_REG_ROMID_SPECIAL_1			0x077e
#define UW_EC_REG_ROMID_SPECIAL_2			0x077f

struct uniwill_interface_t {
	char *string_id;
	uniwill_event_callb_t *event_callb;
	uniwill_read_ec_ram_t *read_ec_ram;
	uniwill_write_ec_ram_t *write_ec_ram;
	uniwill_wmi_evaluate_t *wmi_evaluate;
};

int uniwill_add_interface(struct uniwill_interface_t *new_interface);
int uniwill_remove_interface(struct uniwill_interface_t *interface);
uniwill_read_ec_ram_t uniwill_read_ec_ram;
uniwill_write_ec_ram_t uniwill_write_ec_ram;
uniwill_wmi_evaluate_t uniwill_wmi_evaluate;
uniwill_write_ec_ram_with_retry_t uniwill_write_ec_ram_with_retry;
uniwill_read_ec_ram_with_retry_t uniwill_read_ec_ram_with_retry;
int uniwill_get_active_interface_id(char **id_str);

#define UW_MODEL_PF5LUXG	0x09
#define UW_MODEL_PH4TUX		0x13
#define UW_MODEL_PH4TRX		0x12
#define UW_MODEL_PH4TQF		0x14
#define UW_MODEL_PH4AQF_ARX	0x17

struct uniwill_device_features_t {
	u8 model;
	/**
	 * Identification for uniwill_power_profile_v1
	 *
	 * - Two profiles present in low power devices often called
	 *   "power save" and "balanced".
	 * - Three profiles present mainly in devices with discrete
	 *   graphics card often called "power save", "balanced"
	 *   and "enthusiast"
	 */
	bool uniwill_profile_v1;
	bool uniwill_profile_v1_two_profs;
	bool uniwill_profile_v1_three_profs;
	bool uniwill_profile_v1_three_profs_leds_only;
	/*
	 * Identifies devices where mode need to be chosen
	 * for custom TDP values (and sometimes fan control) to have effect
	 */
	bool uniwill_custom_profile_mode_needed;
	bool uniwill_has_charging_prio;
	bool uniwill_has_charging_profile;
	bool uniwill_has_universal_ec_fan_control;
	bool uniwill_has_double_pl4;
	bool uniwill_has_ac_auto_boot;
	bool uniwill_has_usb_powershare;
	bool uniwill_has_mini_led_local_dimming;
	bool uniwill_has_hidden_bios_options;
};

struct uniwill_device_features_t *uniwill_get_device_features(void);

union uw_ec_read_return {
	u32 dword;
	struct {
		u8 data_low;
		u8 data_high;
	} bytes;
};

union uw_ec_write_return {
	u32 dword;
	struct {
		u8 addr_low;
		u8 addr_high;
		u8 data_low;
		u8 data_high;
	} bytes;
};

#endif
