188 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2/*3 * Copyright (C) 2008 Hewlett-Packard Development Company, L.P.4 * Bjorn Helgaas <bjorn.helgaas@hp.com>5 */6 7extern struct mutex pnp_lock;8extern const struct attribute_group *pnp_dev_groups[];9extern const struct bus_type pnp_bus_type;10 11int pnp_register_protocol(struct pnp_protocol *protocol);12void pnp_unregister_protocol(struct pnp_protocol *protocol);13 14#define PNP_EISA_ID_MASK 0x7fffffff15void pnp_eisa_id_to_string(u32 id, char *str);16struct pnp_dev *pnp_alloc_dev(struct pnp_protocol *, int id,17 const char *pnpid);18struct pnp_card *pnp_alloc_card(struct pnp_protocol *, int id, char *pnpid);19 20int pnp_add_device(struct pnp_dev *dev);21struct pnp_id *pnp_add_id(struct pnp_dev *dev, const char *id);22 23int pnp_add_card(struct pnp_card *card);24void pnp_remove_card(struct pnp_card *card);25int pnp_add_card_device(struct pnp_card *card, struct pnp_dev *dev);26void pnp_remove_card_device(struct pnp_dev *dev);27 28struct pnp_port {29 resource_size_t min; /* min base number */30 resource_size_t max; /* max base number */31 resource_size_t align; /* align boundary */32 resource_size_t size; /* size of range */33 unsigned char flags; /* port flags */34};35 36#define PNP_IRQ_NR 25637typedef struct { DECLARE_BITMAP(bits, PNP_IRQ_NR); } pnp_irq_mask_t;38 39struct pnp_irq {40 pnp_irq_mask_t map; /* bitmap for IRQ lines */41 unsigned char flags; /* IRQ flags */42};43 44struct pnp_dma {45 unsigned char map; /* bitmask for DMA channels */46 unsigned char flags; /* DMA flags */47};48 49struct pnp_mem {50 resource_size_t min; /* min base number */51 resource_size_t max; /* max base number */52 resource_size_t align; /* align boundary */53 resource_size_t size; /* size of range */54 unsigned char flags; /* memory flags */55};56 57#define PNP_OPTION_DEPENDENT 0x8000000058#define PNP_OPTION_SET_MASK 0xffff59#define PNP_OPTION_SET_SHIFT 1260#define PNP_OPTION_PRIORITY_MASK 0xfff61#define PNP_OPTION_PRIORITY_SHIFT 062 63#define PNP_RES_PRIORITY_PREFERRED 064#define PNP_RES_PRIORITY_ACCEPTABLE 165#define PNP_RES_PRIORITY_FUNCTIONAL 266#define PNP_RES_PRIORITY_INVALID PNP_OPTION_PRIORITY_MASK67 68struct pnp_option {69 struct list_head list;70 unsigned int flags; /* independent/dependent, set, priority */71 72 unsigned long type; /* IORESOURCE_{IO,MEM,IRQ,DMA} */73 union {74 struct pnp_port port;75 struct pnp_irq irq;76 struct pnp_dma dma;77 struct pnp_mem mem;78 } u;79};80 81int pnp_register_irq_resource(struct pnp_dev *dev, unsigned int option_flags,82 pnp_irq_mask_t *map, unsigned char flags);83int pnp_register_dma_resource(struct pnp_dev *dev, unsigned int option_flags,84 unsigned char map, unsigned char flags);85int pnp_register_port_resource(struct pnp_dev *dev, unsigned int option_flags,86 resource_size_t min, resource_size_t max,87 resource_size_t align, resource_size_t size,88 unsigned char flags);89int pnp_register_mem_resource(struct pnp_dev *dev, unsigned int option_flags,90 resource_size_t min, resource_size_t max,91 resource_size_t align, resource_size_t size,92 unsigned char flags);93 94static inline int pnp_option_is_dependent(struct pnp_option *option)95{96 return option->flags & PNP_OPTION_DEPENDENT ? 1 : 0;97}98 99static inline unsigned int pnp_option_set(struct pnp_option *option)100{101 return (option->flags >> PNP_OPTION_SET_SHIFT) & PNP_OPTION_SET_MASK;102}103 104static inline unsigned int pnp_option_priority(struct pnp_option *option)105{106 return (option->flags >> PNP_OPTION_PRIORITY_SHIFT) &107 PNP_OPTION_PRIORITY_MASK;108}109 110static inline unsigned int pnp_new_dependent_set(struct pnp_dev *dev,111 int priority)112{113 unsigned int flags;114 115 if (priority > PNP_RES_PRIORITY_FUNCTIONAL) {116 dev_warn(&dev->dev, "invalid dependent option priority %d "117 "clipped to %d", priority,118 PNP_RES_PRIORITY_INVALID);119 priority = PNP_RES_PRIORITY_INVALID;120 }121 122 flags = PNP_OPTION_DEPENDENT |123 ((dev->num_dependent_sets & PNP_OPTION_SET_MASK) <<124 PNP_OPTION_SET_SHIFT) |125 ((priority & PNP_OPTION_PRIORITY_MASK) <<126 PNP_OPTION_PRIORITY_SHIFT);127 128 dev->num_dependent_sets++;129 130 return flags;131}132 133char *pnp_option_priority_name(struct pnp_option *option);134void dbg_pnp_show_option(struct pnp_dev *dev, struct pnp_option *option);135 136void pnp_init_resources(struct pnp_dev *dev);137 138void pnp_fixup_device(struct pnp_dev *dev);139void pnp_free_options(struct pnp_dev *dev);140int __pnp_add_device(struct pnp_dev *dev);141void __pnp_remove_device(struct pnp_dev *dev);142 143int pnp_check_port(struct pnp_dev *dev, struct resource *res);144int pnp_check_mem(struct pnp_dev *dev, struct resource *res);145int pnp_check_irq(struct pnp_dev *dev, struct resource *res);146#ifdef CONFIG_ISA_DMA_API147int pnp_check_dma(struct pnp_dev *dev, struct resource *res);148#endif149 150char *pnp_resource_type_name(struct resource *res);151void dbg_pnp_show_resources(struct pnp_dev *dev, char *desc);152 153void pnp_free_resources(struct pnp_dev *dev);154unsigned long pnp_resource_type(struct resource *res);155 156struct pnp_resource {157 struct list_head list;158 struct resource res;159};160 161void pnp_free_resource(struct pnp_resource *pnp_res);162 163struct pnp_resource *pnp_add_resource(struct pnp_dev *dev,164 struct resource *res);165struct pnp_resource *pnp_add_irq_resource(struct pnp_dev *dev, int irq,166 int flags);167struct pnp_resource *pnp_add_dma_resource(struct pnp_dev *dev, int dma,168 int flags);169struct pnp_resource *pnp_add_io_resource(struct pnp_dev *dev,170 resource_size_t start,171 resource_size_t end, int flags);172struct pnp_resource *pnp_add_mem_resource(struct pnp_dev *dev,173 resource_size_t start,174 resource_size_t end, int flags);175struct pnp_resource *pnp_add_bus_resource(struct pnp_dev *dev,176 resource_size_t start,177 resource_size_t end);178 179extern int pnp_debug;180 181#if defined(CONFIG_PNP_DEBUG_MESSAGES)182#define pnp_dbg(dev, format, arg...) \183 ({ if (pnp_debug) dev_printk(KERN_DEBUG, dev, format, ## arg); 0; })184#else185#define pnp_dbg(dev, format, arg...) \186 ({ if (0) dev_printk(KERN_DEBUG, dev, format, ## arg); 0; })187#endif188