xref: /OK3568_Linux_fs/kernel/drivers/net/ethernet/realtek/r8169_firmware.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /* r8169_firmware.h: RealTek 8169/8168/8101 ethernet driver.
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * Copyright (c) 2002 ShuChen <shuchen@realtek.com.tw>
5*4882a593Smuzhiyun  * Copyright (c) 2003 - 2007 Francois Romieu <romieu@fr.zoreil.com>
6*4882a593Smuzhiyun  * Copyright (c) a lot of people too. Please respect their work.
7*4882a593Smuzhiyun  *
8*4882a593Smuzhiyun  * See MAINTAINERS file for support contact information.
9*4882a593Smuzhiyun  */
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun #include <linux/device.h>
12*4882a593Smuzhiyun #include <linux/firmware.h>
13*4882a593Smuzhiyun 
14*4882a593Smuzhiyun struct rtl8169_private;
15*4882a593Smuzhiyun typedef void (*rtl_fw_write_t)(struct rtl8169_private *tp, int reg, int val);
16*4882a593Smuzhiyun typedef int (*rtl_fw_read_t)(struct rtl8169_private *tp, int reg);
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun #define RTL_VER_SIZE		32
19*4882a593Smuzhiyun 
20*4882a593Smuzhiyun struct rtl_fw {
21*4882a593Smuzhiyun 	rtl_fw_write_t phy_write;
22*4882a593Smuzhiyun 	rtl_fw_read_t phy_read;
23*4882a593Smuzhiyun 	rtl_fw_write_t mac_mcu_write;
24*4882a593Smuzhiyun 	rtl_fw_read_t mac_mcu_read;
25*4882a593Smuzhiyun 	const struct firmware *fw;
26*4882a593Smuzhiyun 	const char *fw_name;
27*4882a593Smuzhiyun 	struct device *dev;
28*4882a593Smuzhiyun 
29*4882a593Smuzhiyun 	char version[RTL_VER_SIZE];
30*4882a593Smuzhiyun 
31*4882a593Smuzhiyun 	struct rtl_fw_phy_action {
32*4882a593Smuzhiyun 		__le32 *code;
33*4882a593Smuzhiyun 		size_t size;
34*4882a593Smuzhiyun 	} phy_action;
35*4882a593Smuzhiyun };
36*4882a593Smuzhiyun 
37*4882a593Smuzhiyun int rtl_fw_request_firmware(struct rtl_fw *rtl_fw);
38*4882a593Smuzhiyun void rtl_fw_release_firmware(struct rtl_fw *rtl_fw);
39*4882a593Smuzhiyun void rtl_fw_write_firmware(struct rtl8169_private *tp, struct rtl_fw *rtl_fw);
40