863dbc52e7
Now that the SPDX tag is in all greybus files, that identifies the license in a specific and legally-defined manner. So the extra GPL text wording can be removed as it is no longer needed at all. This is done on a quest to remove the 700+ different ways that files in the kernel describe the GPL license text. And there's unneeded stuff like the address (sometimes incorrect) for the FSF which is never needed. No copyright headers or other non-license-description text was removed. Cc: Vaibhav Hiremath <hvaibhav.linux@gmail.com> Reviewed-by: Alex Elder <elder@linaro.org> Acked-by: Vaibhav Agarwal <vaibhav.sr@gmail.com> Acked-by: David Lin <dtwlin@gmail.com> Acked-by: Johan Hovold <johan@kernel.org> Acked-by: Viresh Kumar <viresh.kumar@linaro.org> Acked-by: Mark Greer <mgreer@animalcreek.com> Acked-by: Rui Miguel Silva <rmfrfs@gmail.com> Acked-by: "Bryan O'Donoghue" <pure.logic@nexus-software.ie> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
153 lines
4 KiB
C
153 lines
4 KiB
C
// SPDX-License-Identifier: GPL-2.0
|
|
/*
|
|
* Greybus driver and device API
|
|
*
|
|
* Copyright 2014-2015 Google Inc.
|
|
* Copyright 2014-2015 Linaro Ltd.
|
|
*/
|
|
|
|
#ifndef __LINUX_GREYBUS_H
|
|
#define __LINUX_GREYBUS_H
|
|
|
|
#ifdef __KERNEL__
|
|
|
|
#include <linux/kernel.h>
|
|
#include <linux/types.h>
|
|
#include <linux/list.h>
|
|
#include <linux/slab.h>
|
|
#include <linux/device.h>
|
|
#include <linux/module.h>
|
|
#include <linux/pm_runtime.h>
|
|
#include <linux/idr.h>
|
|
|
|
#include "greybus_id.h"
|
|
#include "greybus_manifest.h"
|
|
#include "greybus_protocols.h"
|
|
#include "manifest.h"
|
|
#include "hd.h"
|
|
#include "svc.h"
|
|
#include "control.h"
|
|
#include "module.h"
|
|
#include "interface.h"
|
|
#include "bundle.h"
|
|
#include "connection.h"
|
|
#include "operation.h"
|
|
|
|
/* Matches up with the Greybus Protocol specification document */
|
|
#define GREYBUS_VERSION_MAJOR 0x00
|
|
#define GREYBUS_VERSION_MINOR 0x01
|
|
|
|
#define GREYBUS_ID_MATCH_DEVICE \
|
|
(GREYBUS_ID_MATCH_VENDOR | GREYBUS_ID_MATCH_PRODUCT)
|
|
|
|
#define GREYBUS_DEVICE(v, p) \
|
|
.match_flags = GREYBUS_ID_MATCH_DEVICE, \
|
|
.vendor = (v), \
|
|
.product = (p),
|
|
|
|
#define GREYBUS_DEVICE_CLASS(c) \
|
|
.match_flags = GREYBUS_ID_MATCH_CLASS, \
|
|
.class = (c),
|
|
|
|
/* Maximum number of CPorts */
|
|
#define CPORT_ID_MAX 4095 /* UniPro max id is 4095 */
|
|
#define CPORT_ID_BAD U16_MAX
|
|
|
|
struct greybus_driver {
|
|
const char *name;
|
|
|
|
int (*probe)(struct gb_bundle *bundle,
|
|
const struct greybus_bundle_id *id);
|
|
void (*disconnect)(struct gb_bundle *bundle);
|
|
|
|
const struct greybus_bundle_id *id_table;
|
|
|
|
struct device_driver driver;
|
|
};
|
|
#define to_greybus_driver(d) container_of(d, struct greybus_driver, driver)
|
|
|
|
static inline void greybus_set_drvdata(struct gb_bundle *bundle, void *data)
|
|
{
|
|
dev_set_drvdata(&bundle->dev, data);
|
|
}
|
|
|
|
static inline void *greybus_get_drvdata(struct gb_bundle *bundle)
|
|
{
|
|
return dev_get_drvdata(&bundle->dev);
|
|
}
|
|
|
|
/* Don't call these directly, use the module_greybus_driver() macro instead */
|
|
int greybus_register_driver(struct greybus_driver *driver,
|
|
struct module *module, const char *mod_name);
|
|
void greybus_deregister_driver(struct greybus_driver *driver);
|
|
|
|
/* define to get proper THIS_MODULE and KBUILD_MODNAME values */
|
|
#define greybus_register(driver) \
|
|
greybus_register_driver(driver, THIS_MODULE, KBUILD_MODNAME)
|
|
#define greybus_deregister(driver) \
|
|
greybus_deregister_driver(driver)
|
|
|
|
/**
|
|
* module_greybus_driver() - Helper macro for registering a Greybus driver
|
|
* @__greybus_driver: greybus_driver structure
|
|
*
|
|
* Helper macro for Greybus drivers to set up proper module init / exit
|
|
* functions. Replaces module_init() and module_exit() and keeps people from
|
|
* printing pointless things to the kernel log when their driver is loaded.
|
|
*/
|
|
#define module_greybus_driver(__greybus_driver) \
|
|
module_driver(__greybus_driver, greybus_register, greybus_deregister)
|
|
|
|
int greybus_disabled(void);
|
|
|
|
void gb_debugfs_init(void);
|
|
void gb_debugfs_cleanup(void);
|
|
struct dentry *gb_debugfs_get(void);
|
|
|
|
extern struct bus_type greybus_bus_type;
|
|
|
|
extern struct device_type greybus_hd_type;
|
|
extern struct device_type greybus_module_type;
|
|
extern struct device_type greybus_interface_type;
|
|
extern struct device_type greybus_control_type;
|
|
extern struct device_type greybus_bundle_type;
|
|
extern struct device_type greybus_svc_type;
|
|
|
|
static inline int is_gb_host_device(const struct device *dev)
|
|
{
|
|
return dev->type == &greybus_hd_type;
|
|
}
|
|
|
|
static inline int is_gb_module(const struct device *dev)
|
|
{
|
|
return dev->type == &greybus_module_type;
|
|
}
|
|
|
|
static inline int is_gb_interface(const struct device *dev)
|
|
{
|
|
return dev->type == &greybus_interface_type;
|
|
}
|
|
|
|
static inline int is_gb_control(const struct device *dev)
|
|
{
|
|
return dev->type == &greybus_control_type;
|
|
}
|
|
|
|
static inline int is_gb_bundle(const struct device *dev)
|
|
{
|
|
return dev->type == &greybus_bundle_type;
|
|
}
|
|
|
|
static inline int is_gb_svc(const struct device *dev)
|
|
{
|
|
return dev->type == &greybus_svc_type;
|
|
}
|
|
|
|
static inline bool cport_id_valid(struct gb_host_device *hd, u16 cport_id)
|
|
{
|
|
return cport_id != CPORT_ID_BAD && cport_id < hd->num_cports;
|
|
}
|
|
|
|
#endif /* __KERNEL__ */
|
|
#endif /* __LINUX_GREYBUS_H */
|