1 #ifndef _DISCOVER_CLIENT_H
2 #define _DISCOVER_CLIENT_H
4 #include <types/types.h>
5 #include <waiter/waiter.h>
7 struct discover_client;
17 * struct discover_client_ops - Application supplied client info.
18 * @device_add: PB_PROTOCOL_ACTION_ADD event callback.
19 * @device_remove: PB_PROTOCOL_ACTION_REMOVE event callback.
20 * @cb_arg: Client managed convenience variable passed to callbacks.
23 struct discover_client_ops {
24 int (*device_add)(struct device *device, void *arg);
25 int (*boot_option_add)(struct device *dev, struct boot_option *option,
27 void (*device_remove)(struct device *device, void *arg);
28 void (*update_status)(struct boot_status *status, void *arg);
29 void (*update_sysinfo)(struct system_info *sysinfo, void *arg);
30 void (*update_config)(struct config *sysinfo, void *arg);
34 struct discover_client *discover_client_init(struct waitset *waitset,
35 const struct discover_client_ops *ops, void *cb_arg);
37 void discover_client_destroy(struct discover_client *client);
40 * Get the number of devices that the discover client has stored. This
41 * is the set of devices that have been added and not removed
43 * @param client The discover client
44 * @return The number of devices that have been added.
46 int discover_client_device_count(struct discover_client *client);
49 * Get the device at a specific index.
50 * @param client A pointer to the discover client
51 * @param index The index of the device to retrieve
52 * @return The device at the specified index, or NULL if none exists
54 struct device *discover_client_get_device(struct discover_client *client,
57 /* Tell the discover server to boot an image
58 * @param client A pointer to the discover client
59 * @param boot_command The command to boot
61 int discover_client_boot(struct discover_client *client,
62 const struct device *device,
63 const struct boot_option *boot_option,
64 const struct pb_boot_data *data);
66 /* Tell the discover server to cancel the default boot option, if any
68 int discover_client_cancel_default(struct discover_client *client);