2 * Copyright (c) 2015 Landon Fuller <landon@landonf.org>
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer,
10 * without modification.
11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13 * redistribution must be conditioned upon including a substantially
14 * similar Disclaimer requirement for further binary redistribution.
17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27 * THE POSSIBILITY OF SUCH DAMAGES.
32 #ifndef _SIBA_SIBAVAR_H_
33 #define _SIBA_SIBAVAR_H_
35 #include <sys/param.h>
37 #include <sys/limits.h>
39 #include <machine/bus.h>
45 * Internal definitions shared by siba(4) driver implementations.
48 struct siba_addrspace;
52 int siba_probe(device_t dev);
53 int siba_attach(device_t dev);
54 int siba_detach(device_t dev);
55 int siba_resume(device_t dev);
56 int siba_suspend(device_t dev);
58 uint16_t siba_get_bhnd_mfgid(uint16_t ocp_vendor);
60 struct siba_core_id siba_parse_core_id(uint32_t idhigh, uint32_t idlow,
61 u_int core_idx, int unit);
63 int siba_add_children(device_t bus,
64 const struct bhnd_chipid *chipid);
66 struct siba_devinfo *siba_alloc_dinfo(device_t dev);
67 int siba_init_dinfo(device_t dev,
68 struct siba_devinfo *dinfo,
69 const struct siba_core_id *core_id);
70 void siba_free_dinfo(device_t dev,
71 struct siba_devinfo *dinfo);
73 u_int siba_addrspace_port_count(struct siba_devinfo *dinfo);
74 u_int siba_addrspace_region_count(struct siba_devinfo *dinfo,
77 u_int siba_addrspace_port(u_int addrspace);
78 u_int siba_addrspace_region(u_int addrspace);
80 bool siba_is_port_valid(struct siba_devinfo *dinfo,
81 bhnd_port_type type, u_int port);
83 struct siba_addrspace *siba_find_addrspace(struct siba_devinfo *dinfo,
84 bhnd_port_type type, u_int port, u_int region);
86 int siba_append_dinfo_region(struct siba_devinfo *dinfo,
87 uint8_t sid, uint32_t base, uint32_t size,
88 uint32_t bus_reserved);
90 u_int siba_admatch_offset(uint8_t addrspace);
91 int siba_parse_admatch(uint32_t am, uint32_t *addr,
95 /* Sonics configuration register blocks */
96 #define SIBA_CFG_NUM_2_2 1 /**< sonics <= 2.2 maps SIBA_CFG0. */
97 #define SIBA_CFG_NUM_2_3 2 /**< sonics <= 2.3 maps SIBA_CFG0 and SIBA_CFG1 */
98 #define SIBA_MAX_CFG SIBA_CFG_NUM_2_3 /**< maximum number of supported config
101 /* Sonics/OCP address space mappings */
102 #define SIBA_CORE_ADDRSPACE 0 /**< Address space mapping the primary
105 #define SIBA_MAX_ADDRSPACE 4 /**< Maximum number of Sonics/OCP
106 * address space mappings for a
109 /* bhnd(4) (port,region) representation of siba address space mappings */
110 #define SIBA_MAX_PORT 2 /**< maximum number of advertised
113 /** siba(4) address space descriptor */
114 struct siba_addrspace {
115 uint32_t sa_base; /**< base address */
116 uint32_t sa_size; /**< size */
117 int sa_rid; /**< bus resource id */
118 uint32_t sa_bus_reserved;/**< number of bytes at high end of
119 * address space reserved for the bus */
123 * siba(4) per-core identification info.
125 struct siba_core_id {
126 struct bhnd_core_info core_info; /**< standard bhnd(4) core info */
127 uint16_t sonics_vendor; /**< OCP vendor identifier used to generate
128 * the JEDEC-106 bhnd(4) vendor identifier. */
129 uint8_t sonics_rev; /**< sonics backplane revision code */
130 uint8_t num_addrspace; /**< number of address ranges mapped to
132 uint8_t num_cfg_blocks; /**< number of Sonics configuration register
133 blocks mapped to the core's enumeration
138 * siba(4) per-device info
140 struct siba_devinfo {
141 struct bhnd_devinfo bhnd_dinfo; /**< superclass device info. */
143 struct resource_list resources; /**< per-core memory regions. */
144 struct siba_core_id core_id; /**< core identification info */
145 struct siba_addrspace addrspace[SIBA_MAX_ADDRSPACE]; /**< memory map descriptors */
147 struct bhnd_resource *cfg[SIBA_MAX_CFG]; /**< SIBA_CFG_* registers */
148 int cfg_rid[SIBA_MAX_CFG]; /**< SIBA_CFG_* resource IDs */
152 /** siba(4) per-instance state */
154 struct bhnd_softc bhnd_sc; /**< bhnd state */
155 device_t dev; /**< siba device */
156 device_t hostb_dev; /**< host bridge core, or NULL */
159 #endif /* _SIBA_SIBAVAR_H_ */