d094c9b381
This adds support for specifying the address space used by a bridge child; this will either be the bridged SoC address space, or the host address space required by children that map non SoC-address ranges from the PCI BAR. This is necessary to support SROM/OTP child devices that live directly beneath the bhndb device and require access to host resources, instead of the standard behavior of delegating access to the bridged SoC address space. Submitted by: Landon Fuller <landonf@landonf.org> Differential Revision: https://reviews.freebsd.org/D5757
104 lines
3.5 KiB
C
104 lines
3.5 KiB
C
/*-
|
|
* Copyright (c) 2015 Landon Fuller <landon@landonf.org>
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer,
|
|
* without modification.
|
|
* 2. Redistributions in binary form must reproduce at minimum a disclaimer
|
|
* similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
|
|
* redistribution must be conditioned upon including a substantially
|
|
* similar Disclaimer requirement for further binary redistribution.
|
|
*
|
|
* NO WARRANTY
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
|
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
|
* THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
|
|
* OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
|
|
* IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
|
|
* THE POSSIBILITY OF SUCH DAMAGES.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
#ifndef _BHND_BHNDBVAR_H_
|
|
#define _BHND_BHNDBVAR_H_
|
|
|
|
#include <sys/param.h>
|
|
#include <sys/bus.h>
|
|
#include <sys/kernel.h>
|
|
#include <sys/lock.h>
|
|
#include <sys/malloc.h>
|
|
#include <sys/mutex.h>
|
|
#include <sys/rman.h>
|
|
|
|
#include <dev/bhnd/bhndvar.h>
|
|
#include "bhndb.h"
|
|
|
|
#include "bhndb_if.h"
|
|
|
|
/*
|
|
* Definitions shared by bhndb(4) driver implementations.
|
|
*/
|
|
|
|
DECLARE_CLASS(bhndb_driver);
|
|
|
|
struct bhndb_resources;
|
|
|
|
int bhndb_attach(device_t dev, bhnd_devclass_t bridge_devclass);
|
|
|
|
int bhndb_generic_probe(device_t dev);
|
|
int bhndb_generic_detach(device_t dev);
|
|
int bhndb_generic_suspend(device_t dev);
|
|
int bhndb_generic_resume(device_t dev);
|
|
int bhndb_generic_init_full_config(device_t dev, device_t child,
|
|
const struct bhndb_hw_priority *hw_prio_table);
|
|
|
|
int bhnd_generic_br_suspend_child(device_t dev, device_t child);
|
|
int bhnd_generic_br_resume_child(device_t dev, device_t child);
|
|
|
|
/**
|
|
* bhndb child address space. Children either operate in the bridged
|
|
* SoC address space, or within the address space mapped to the host
|
|
* device (e.g. the PCI BAR(s)).
|
|
*/
|
|
typedef enum {
|
|
BHNDB_ADDRSPACE_BRIDGED, /**< bridged (SoC) address space */
|
|
BHNDB_ADDRSPACE_NATIVE /**< host address space */
|
|
} bhndb_addrspace;
|
|
|
|
/** bhndb child instance state */
|
|
struct bhndb_devinfo {
|
|
bhndb_addrspace addrspace; /**< child address space. */
|
|
struct resource_list resources; /**< child resources. */
|
|
};
|
|
|
|
/**
|
|
* bhndb driver instance state. Must be first member of all subclass
|
|
* softc structures.
|
|
*/
|
|
struct bhndb_softc {
|
|
device_t dev; /**< bridge device */
|
|
struct bhnd_chipid chipid; /**< chip identification */
|
|
bhnd_devclass_t bridge_class; /**< bridge core type */
|
|
|
|
device_t parent_dev; /**< parent device */
|
|
device_t bus_dev; /**< child bhnd(4) bus */
|
|
device_t hostb_dev; /**< child host bridge device, or NULL
|
|
if the @p bus_dev has not yet
|
|
called BHNDB_INIT_FULL_CONFIG() */
|
|
|
|
struct mtx sc_mtx; /**< resource lock. */
|
|
struct bhndb_resources *bus_res; /**< bus resource state */
|
|
};
|
|
|
|
#endif /* _BHND_BHNDBVAR_H_ */
|