11-Openwrt hotplug system
hotplug为linux的一个热拔插系统,在很多应用都有用到,如网口的拔插,USB的拔插,按键的触发...非常广泛的应用,下面举几个例子来进行理解这个过程
1.gpio-button-hotplug(内核层发送hotplug到procd)
gpio-button-hotplug为kernel的一个package,位于package/kernel/gpio-button-hotplug/
要把CONFIG_PACKAGE_kmod-gpio-button-hotplug=y
选项打开
1.1驱动
"gpio-keys"和"gpio-keys-polled"就是两个platform设备,如下:
static struct platform_driver gpio_keys_driver = {
.probe = gpio_keys_probe,
.remove = gpio_keys_remove,
.driver = {
.name = "gpio-keys",
.owner = THIS_MODULE,
.of_match_table = of_match_ptr(gpio_keys_of_match),
},
};
static struct platform_driver gpio_keys_polled_driver = {
.probe = gpio_keys_polled_probe,
.remove = gpio_keys_remove,
.driver = {
.name = "gpio-keys-polled",
.owner = THIS_MODULE,
.of_match_table = of_match_ptr(gpio_keys_polled_of_match),
},
};
static int __init gpio_button_init(void)
{
int ret;
ret = platform_driver_register(&gpio_keys_driver);
if (ret)
return ret;
ret = platform_driver_register(&gpio_keys_polled_driver);
if (ret)
platform_driver_unregister(&gpio_keys_driver);
return ret;
}
static void __exit gpio_button_exit(void)
{
platform_driver_unregister(&gpio_keys_driver);
platform_driver_unregister(&gpio_keys_polled_driver);
}
module_init(gpio_button_init);
module_exit(gpio_button_exit);
与以前的做法一样,device和driver,driver这边有了,device要么arch里面要么dts里面。
看下DTS里面的配置
gpio-keys-polled {
compatible = "gpio-keys-polled";
#address-cells = <1>;
#size-cells = <0>;
poll-interval = <20>;
power {
label = "power";
gpios = <&gpio0 24 1>; //GPIO24 line is low, key is pressed
linux,code = <116>; //KEY_POWER
};
reset {
label = "reset";
gpios = <&gpio1 11 1>; //GPIO43 line is low, key is pressed
linux,code = <0x198>; //KEY_RESTART
};
};
上面的这些参数,在gpio_keys_get_devtree_pdata
函数里面都会进行解析判断格式是否正确,错误在启动注册时就会直接提示错误信息。
另一种就是在arch里面注册,
在zkernel/3.10.49/arch/mips/mtk/dev-gpio-buttons.c里面提供了注册接口,调用即可。
#define ZRMT7621_KEYS_POLL_INTERVAL 20
#define ZRMT7621_KEYS_DEBOUNCE_INTERVAL (3 * ZRMT7621_KEYS_POLL_INTERVAL)
static struct gpio_keys_button zrmt7621_gpio_buttons[] __initdata = {
{
.desc = "reset",
.type = EV_KEY,
.code = KEY_RESTART,
.debounce_interval = ZRMT7621_KEYS_DEBOUNCE_INTERVAL,
.gpio = ZRMT7621_GPIO_BUTTON_RESET,
.active_low = 1,
},
};
ramips_register_gpio_buttons(-1, ZRMT7621_KEYS_POLL_INTERVAL,
ARRAY_SIZE(zrmt7621_gpio_buttons),
zrmt7621_gpio_buttons);
在上面的button结构体里面要定义好对应的type和code,
这边故意将linux,code里面的数值写成数值,是为了让我们看到更底层的定义,在gpio-button-hotplug.c
里面有如下定义,
static struct bh_map button_map[] = {
BH_MAP(BTN_0, "BTN_0"),
BH_MAP(BTN_1, "BTN_1"),
BH_MAP(BTN_2, "BTN_2"),
BH_MAP(BTN_3, "BTN_3"),
BH_MAP(BTN_4, "BTN_4"),
BH_MAP(BTN_5, "BTN_5"),
BH_MAP(BTN_6, "BTN_6"),
BH_MAP(BTN_7, "BTN_7"),
BH_MAP(BTN_8, "BTN_8"),
BH_MAP(BTN_9, "BTN_9"),
BH_MAP(KEY_BRIGHTNESS_ZERO, "brightness_zero"),
BH_MAP(KEY_CONFIG, "config"),
BH_MAP(KEY_COPY, "copy"),
BH_MAP(KEY_EJECTCD, "eject"),
BH_MAP(KEY_HELP, "help"),
BH_MAP(KEY_LIGHTS_TOGGLE, "lights_toggle"),
BH_MAP(KEY_PHONE, "phone"),
BH_MAP(KEY_POWER, "power"),
BH_MAP(KEY_RESTART, "reset"),
BH_MAP(KEY_RFKILL, "rfkill"),
BH_MAP(KEY_VIDEO, "video"),
BH_MAP(KEY_WIMAX, "wwan"),
BH_MAP(KEY_WLAN, "wlan"),
BH_MAP(KEY_WPS_BUTTON, "wps"),
};
在include/dt-bindings/input/linux-event-codes.h
里面有如下定义,所以就知道最终的数值了。
#define KEY_RESTART 0x198
#define KEY_INSERT 110
#define KEY_DELETE 111
#define KEY_MACRO 112
#define KEY_MUTE 113
#define KEY_VOLUMEDOWN 114
#define KEY_VOLUMEUP 115
#define KEY_POWER 116 /* SC System Power Down */
#define KEY_KPEQUAL 117
#define KEY_KPPLUSMINUS 118
#define KEY_PAUSE 119
#define KEY_SCALE 120 /* AL Compiz Scale (Expose) */
驱动加载成功则会有如下信息:
root@zihome:/sys/devices/platform/gpio-keys-polled# ls
driver modalias subsystem uevent
1.2 key的应用层处理
当按键时,则触发button_hotplug_event
函数(gpio-button-hotplug.c):调用button_hotplug_create_event
产生uevent事件,调用button_hotplug_fill_even
填充事件(JSON格式),并最终调用broadcast_uevent
发出uevent广播信息,后由内核netlink_broadcast
函数(linux-3.10.49/net/netlink/af_netlink.c)
netlink的实现原理可以看下面这篇文件的介绍,为socket通信,内核发出socket广播,上层应用(procd)只需要监听这个socket事件即可。
https://blog.csdn.net/Swallow_he/article/details/84073545
上述广播,被procd进程中的hotplug_handler (procd/plug/hotplug.c) 收到,并根据etc/hotplug.json中预先定义的JSON内容匹配条件,定位到对应的执行函数,具体为:
[ "if",
[ "and",
[ "has", "BUTTON" ],
[ "eq", "SUBSYSTEM", "button" ],
],
[ "exec", "/etc/rc.button/%BUTTON%" ]
],
最终会执行/etc/rc.button/里面的对应的脚本,如reset/power,脚本的名字要跟button_map结构里面的一致。
root@LEDE:/# cat etc/rc.button/power
#!/bin/sh
[ "${ACTION}" = "released" ] || exit 0
exec /sbin/poweroff
return 0
root@LEDE:/# cat etc/rc.button/reset
#!/bin/sh
. /lib/functions.sh
OVERLAY="$( grep ' /overlay ' /proc/mounts )"
case "$ACTION" in
pressed)
[ -z "$OVERLAY" ] && return 0
return 5
;;
timeout)
. /etc/diag.sh
set_state failsafe
;;
released)
if [ "$SEEN" -lt 1 ]
then
echo "REBOOT" > /dev/console
sync
reboot
elif [ "$SEEN" -gt 5 -a -n "$OVERLAY" ]
then
echo "FACTORY RESET" > /dev/console
jffs2reset -y && reboot &
fi
;;
esac
return 0
2.WAN口网线是否插入检测(phy内核发出)
内核检测到WAN口变化后会创建hotplug消息(broadcast_uevent),发送给procd,再转发到对应的模块
static void phy_hotplug_work(struct work_struct *work)
{
struct bh_event *event = container_of(work, struct bh_event, work);
int ret = 0;
event->skb = alloc_skb(BH_SKB_SIZE, GFP_KERNEL);
if (!event->skb)
goto out_free_event;
ret = bh_event_add_var(event, 0, "%s@", event->action);
if (ret)
goto out_free_skb;
ret = phy_hotplug_fill_event(event);
if (ret)
goto out_free_skb;
if (event->type) {
printk(KERN_NOTICE "phy: port%u %s(irq)\n", event->port_num, event->action);
} else {
printk(KERN_NOTICE "phy: port%u %s(dev)\n", event->port_num, event->action);
}
NETLINK_CB(event->skb).dst_group = 1;
broadcast_uevent(event->skb, 0, 1, GFP_KERNEL);
out_free_skb:
if (ret) {
kfree_skb(event->skb);
}
out_free_event:
kfree(event);
}
发出后就会触发以下脚本,在脚本里面添加我们需要的内容
vim /etc/hotplug.d/phy/00-wan
case "$wan_ifname" in
"eth"*)
if [ "$wan_port" = "$PORTNUM" ]; then
logger -t "phy" "$PORTNUM $ACTION"
mkdir -p /tmp/status >/dev/null 2>&1
case "$ACTION" in
"linkup")
echo "1" >/tmp/status/wan_port_status
ubus call zboard set_wan "{\"status\":1,\"port\":$wan_port}"
dhcp_handle_up "wan" "$wan_ifname"
;;
"linkdown")
echo "0" >/tmp/status/wan_port_status
ubus call zboard set_wan "{\"status\":0,\"port\":$wan_port}"
dhcp_handle_down "wan" "$wan_ifname"
;;
esac
phy_hotplug "wan" $ACTION
fi
;;
*)
if [ "$wan_port" = "$PORTNUM" ]; then
logger -t "phy" "$PORTNUM $ACTION for wisp"
mkdir -p /tmp/status >/dev/null 2>&1
case "$ACTION" in
"linkup")
echo "1" >/tmp/status/wan_port_status
ubus call zboard set_wan "{\"status\":1,\"port\":$wan_port}"
;;
"linkdown")
echo "0" >/tmp/status/wan_port_status
ubus call zboard set_wan "{\"status\":0,\"port\":$wan_port}"
;;
esac
fi
;;
esac
3.网络检测添加LED闪烁(/sbin/hotplug-call)
3.1 zdetect网络检测模块
在zrouter/zpackages/zihome/utils/zdetect/src/zdetect.c里面会发送hotplug event当网络变化的时候:
static void inet_hotplug(const char* action)
{
char *argv[3];
int pid;
pid = fork();
if (pid < 0) {
dbg_printf(MSG_INFO, "hotplug_event fork failed!");
return;
} else if (pid == 0) {
setenv("ACTION", action, 1);
argv[0] = HOTPLUG_PATH;
argv[1] = "inet";
argv[2] = NULL;
execvp(argv[0], argv);
exit(127);
}
}
3.2 收到inet模块hotplug消息后
14.07/package/base-files/files/etc/hotplug.d/inet/00-inet
#!/bin/sh
case "$ACTION" in
"online")
logger -t "inet" "detect online"
zihome_led yellow on
;;
"offline")
logger -t "inet" "detect offline"
zihome_led yellow 1000 1000
;;
*) ;;
esac
3.3 调用led执行脚本
14.07/package/base-files/files/sbin/zihome_led
#!/bin/sh
. /lib/functions/leds.sh
led_path="zihome:""$1"
led
4.iface(netifd)
每次网络接口启动(up)或者关闭(down)的时候,所有在/etc/hotplug.d/iface/目录中的脚本都会以字母顺序执行。根据一个不成文的规则,会在每个脚本的前面加上一个数字前缀来设置正确的运行顺序。这就是为什么脚本名称都像:/etc/hotplug.d/iface/<nn>-<scriptname>的原因。
变量名称 | 描述 |
---|---|
ACTION | "ifup" 或者 "ifdown" |
INTERFACE | 网络接口的名称,如"wan" |
DEVICE | 物理设备的名称,如"br-lan" |
https://blog.csdn.net/vivianliulu/article/details/79629836
static void call_hotplug(void)
{
const char *device = NULL;
if (list_empty(&pending))
return;
current = list_first_entry(&pending, struct interface, hotplug_list);
current_ev = current->hotplug_ev;
list_del_init(¤t->hotplug_list);
if ((current_ev == IFEV_UP || current_ev == IFEV_UPDATE) && current->l3_dev.dev)
device = current->l3_dev.dev->ifname;
D(SYSTEM, "Call hotplug handler for interface '%s', event '%s' (%s)\n",
current->name, eventnames[current_ev], device ? device : "none");
run_cmd(current->name, device, current_ev, current->updated);
}
static void run_cmd(const char *ifname, const char *device, enum interface_event event,
enum interface_update_flags updated)
{
char *argv[3];
int pid;
pid = fork();
if (pid < 0)
return task_complete(NULL, -1);
if (pid > 0) {
task.pid = pid;
uloop_process_add(&task);
return;
}
setenv("ACTION", eventnames[event], 1);
setenv("INTERFACE", ifname, 1);
if (device)
setenv("DEVICE", device, 1);
if (event == IFEV_UPDATE) {
if (updated & IUF_ADDRESS)
setenv("IFUPDATE_ADDRESSES", "1", 1);
if (updated & IUF_ROUTE)
setenv("IFUPDATE_ROUTES", "1", 1);
if (updated & IUF_PREFIX)
setenv("IFUPDATE_PREFIXES", "1", 1);
if (updated & IUF_DATA)
setenv("IFUPDATE_DATA", "1", 1);
}
argv[0] = hotplug_cmd_path;
argv[1] = "iface";
argv[2] = NULL;
execvp(argv[0], argv);
exit(127);
}