]>
git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blob - drivers/w1/w1_netlink.h
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * Copyright (c) 2003 Evgeniy Polyakov <zbr@ioremap.net>
10 #include <linux/connector.h>
12 #include "w1_internal.h"
15 * enum w1_cn_msg_flags - bitfield flags for struct cn_msg.flags
17 * @W1_CN_BUNDLE: Request bundling replies into fewer messagse. Be prepared
18 * to handle multiple struct cn_msg, struct w1_netlink_msg, and
19 * struct w1_netlink_cmd in one packet.
21 enum w1_cn_msg_flags
{
26 * enum w1_netlink_message_types - message type
28 * @W1_SLAVE_ADD: notification that a slave device was added
29 * @W1_SLAVE_REMOVE: notification that a slave device was removed
30 * @W1_MASTER_ADD: notification that a new bus master was added
31 * @W1_MASTER_REMOVE: notification that a bus masterwas removed
32 * @W1_MASTER_CMD: initiate operations on a specific master
33 * @W1_SLAVE_CMD: sends reset, selects the slave, then does a read/write/touch
35 * @W1_LIST_MASTERS: used to determine the bus master identifiers
37 enum w1_netlink_message_types
{
48 * struct w1_netlink_msg - holds w1 message type, id, and result
50 * @type: one of enum w1_netlink_message_types
51 * @status: kernel feedback for success 0 or errno failure value
52 * @len: length of data following w1_netlink_msg
53 * @id: union holding bus master id (msg.id) and slave device id (id[8]).
54 * @id.id: Slave ID (8 bytes)
55 * @id.mst: bus master identification
56 * @id.mst.id: bus master ID
57 * @id.mst.res: bus master reserved
58 * @data: start address of any following data
60 * The base message structure for w1 messages over netlink.
61 * The netlink connector data sequence is, struct nlmsghdr, struct cn_msg,
62 * then one or more struct w1_netlink_msg (each with optional data).
80 * enum w1_commands - commands available for master or slave operations
82 * @W1_CMD_READ: read len bytes
83 * @W1_CMD_WRITE: write len bytes
84 * @W1_CMD_SEARCH: initiate a standard search, returns only the slave
85 * devices found during that search
86 * @W1_CMD_ALARM_SEARCH: search for devices that are currently alarming
87 * @W1_CMD_TOUCH: Touches a series of bytes.
88 * @W1_CMD_RESET: sends a bus reset on the given master
89 * @W1_CMD_SLAVE_ADD: adds a slave to the given master,
90 * 8 byte slave id at data[0]
91 * @W1_CMD_SLAVE_REMOVE: removes a slave to the given master,
92 * 8 byte slave id at data[0]
93 * @W1_CMD_LIST_SLAVES: list of slaves registered on this master
94 * @W1_CMD_MAX: number of available commands
110 * struct w1_netlink_cmd - holds the command and data
112 * @cmd: one of enum w1_commands
114 * @len: length of data following w1_netlink_cmd
115 * @data: start address of any following data
117 * One or more struct w1_netlink_cmd is placed starting at w1_netlink_msg.data
118 * each with optional data.
120 struct w1_netlink_cmd
130 void w1_netlink_send(struct w1_master
*, struct w1_netlink_msg
*);
131 int w1_init_netlink(void);
132 void w1_fini_netlink(void);
134 #endif /* __KERNEL__ */
135 #endif /* __W1_NETLINK_H */