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