f3524ec8ed
this provides early access to device capability flags required by bhnd(4) bus and bhndb(4) bridge drivers.
92 lines
3.2 KiB
C
92 lines
3.2 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
|
|
*
|
|
* Copyright (c) 2017 The FreeBSD Foundation
|
|
* All rights reserved.
|
|
*
|
|
* This software was developed by Landon Fuller under sponsorship from
|
|
* the FreeBSD Foundation.
|
|
*
|
|
* 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.
|
|
*
|
|
* 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_EROM_BHND_EROMVAR_H_
|
|
#define _BHND_EROM_BHND_EROMVAR_H_
|
|
|
|
#include <sys/param.h>
|
|
|
|
#include "bhnd_erom.h"
|
|
|
|
/* forward declarations */
|
|
struct bhnd_erom_io;
|
|
struct bhnd_erom_iobus;
|
|
|
|
/** @see bhnd_erom_io_map() */
|
|
typedef int (bhnd_erom_io_map_t)(struct bhnd_erom_io *eio,
|
|
bhnd_addr_t addr, bhnd_size_t size);
|
|
|
|
/** @see bhnd_erom_io_tell() */
|
|
typedef int (bhnd_erom_io_tell_t)(struct bhnd_erom_io *eio,
|
|
bhnd_addr_t *addr, bhnd_size_t *size);
|
|
|
|
/** @see bhnd_erom_io_read() */
|
|
typedef uint32_t (bhnd_erom_io_read_t)(struct bhnd_erom_io *eio,
|
|
bhnd_size_t offset, u_int width);
|
|
|
|
/** @see bhnd_erom_io_fini() */
|
|
typedef void (bhnd_erom_io_fini_t)(struct bhnd_erom_io *eio);
|
|
|
|
|
|
int bhnd_erom_read_chipid(struct bhnd_erom_io *eio,
|
|
struct bhnd_chipid *cid);
|
|
|
|
|
|
/**
|
|
* Abstract EROM bus I/O support.
|
|
*/
|
|
struct bhnd_erom_io {
|
|
bhnd_erom_io_map_t *map; /**< @see bhnd_erom_io_map() */
|
|
bhnd_erom_io_tell_t *tell; /**< @see bhnd_erom_io_tell() */
|
|
bhnd_erom_io_read_t *read; /**< @see bhnd_erom_io_read() */
|
|
bhnd_erom_io_fini_t *fini; /**< @see bhnd_erom_io_fini(). May be NULL */
|
|
};
|
|
|
|
/**
|
|
* EROM bus handle/tag I/O instance state.
|
|
*/
|
|
struct bhnd_erom_iobus {
|
|
struct bhnd_erom_io eio;
|
|
bhnd_addr_t addr; /**< the address of @p bsh */
|
|
bhnd_size_t size; /**< the size of @p bsh */
|
|
bus_space_tag_t bst; /**< bus space tag */
|
|
bus_space_handle_t bsh; /**< bus space handle mapping the full enumeration space */
|
|
bool mapped; /**< if a mapping is active */
|
|
bus_size_t offset; /**< the current mapped offset within bsh */
|
|
bus_size_t limit; /**< the current mapped size relative to offset */
|
|
};
|
|
|
|
#endif /* _BHND_EROM_BHND_EROMVAR_H_ */
|