mirror of
https://github.com/torvalds/linux.git
synced 2024-11-12 07:01:57 +00:00
6737231ead
Replace occurrences of the magic value ~(u64)0 for invalid CSR address spaces by a named constant for better readability. Signed-off-by: Stefan Richter <stefanr@s5r6.in-berlin.de> Signed-off-by: Ben Collins <bcollins@ubuntu.com>
728 lines
28 KiB
C
728 lines
28 KiB
C
/*
|
|
* csr1212.h -- IEEE 1212 Control and Status Register support for Linux
|
|
*
|
|
* Copyright (C) 2003 Francois Retief <fgretief@sun.ac.za>
|
|
* Steve Kinneberg <kinnebergsteve@acmsystems.com>
|
|
*
|
|
* 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.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. The name of the author may not be used to endorse or promote products
|
|
* derived from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
|
|
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
|
* EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* 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 DAMAGE.
|
|
*/
|
|
|
|
#ifndef __CSR1212_H__
|
|
#define __CSR1212_H__
|
|
|
|
|
|
/* Compatibility layer */
|
|
#ifdef __KERNEL__
|
|
|
|
#include <linux/types.h>
|
|
#include <linux/slab.h>
|
|
#include <linux/interrupt.h>
|
|
#include <linux/vmalloc.h>
|
|
#include <asm/pgalloc.h>
|
|
|
|
#define CSR1212_MALLOC(size) vmalloc((size))
|
|
#define CSR1212_FREE(ptr) vfree(ptr)
|
|
#define CSR1212_BE16_TO_CPU(quad) be16_to_cpu(quad)
|
|
#define CSR1212_CPU_TO_BE16(quad) cpu_to_be16(quad)
|
|
#define CSR1212_BE32_TO_CPU(quad) be32_to_cpu(quad)
|
|
#define CSR1212_CPU_TO_BE32(quad) cpu_to_be32(quad)
|
|
#define CSR1212_BE64_TO_CPU(quad) be64_to_cpu(quad)
|
|
#define CSR1212_CPU_TO_BE64(quad) cpu_to_be64(quad)
|
|
|
|
#define CSR1212_LE16_TO_CPU(quad) le16_to_cpu(quad)
|
|
#define CSR1212_CPU_TO_LE16(quad) cpu_to_le16(quad)
|
|
#define CSR1212_LE32_TO_CPU(quad) le32_to_cpu(quad)
|
|
#define CSR1212_CPU_TO_LE32(quad) cpu_to_le32(quad)
|
|
#define CSR1212_LE64_TO_CPU(quad) le64_to_cpu(quad)
|
|
#define CSR1212_CPU_TO_LE64(quad) cpu_to_le64(quad)
|
|
|
|
#include <linux/errno.h>
|
|
#define CSR1212_SUCCESS (0)
|
|
#define CSR1212_EINVAL (-EINVAL)
|
|
#define CSR1212_ENOMEM (-ENOMEM)
|
|
#define CSR1212_ENOENT (-ENOENT)
|
|
#define CSR1212_EIO (-EIO)
|
|
#define CSR1212_EBUSY (-EBUSY)
|
|
|
|
#else /* Userspace */
|
|
|
|
#include <sys/types.h>
|
|
#include <malloc.h>
|
|
#define CSR1212_MALLOC(size) malloc(size)
|
|
#define CSR1212_FREE(ptr) free(ptr)
|
|
#include <endian.h>
|
|
#if __BYTE_ORDER == __LITTLE_ENDIAN
|
|
#include <byteswap.h>
|
|
#define CSR1212_BE16_TO_CPU(quad) bswap_16(quad)
|
|
#define CSR1212_CPU_TO_BE16(quad) bswap_16(quad)
|
|
#define CSR1212_BE32_TO_CPU(quad) bswap_32(quad)
|
|
#define CSR1212_CPU_TO_BE32(quad) bswap_32(quad)
|
|
#define CSR1212_BE64_TO_CPU(quad) bswap_64(quad)
|
|
#define CSR1212_CPU_TO_BE64(quad) bswap_64(quad)
|
|
|
|
#define CSR1212_LE16_TO_CPU(quad) (quad)
|
|
#define CSR1212_CPU_TO_LE16(quad) (quad)
|
|
#define CSR1212_LE32_TO_CPU(quad) (quad)
|
|
#define CSR1212_CPU_TO_LE32(quad) (quad)
|
|
#define CSR1212_LE64_TO_CPU(quad) (quad)
|
|
#define CSR1212_CPU_TO_LE64(quad) (quad)
|
|
#else
|
|
#define CSR1212_BE16_TO_CPU(quad) (quad)
|
|
#define CSR1212_CPU_TO_BE16(quad) (quad)
|
|
#define CSR1212_BE32_TO_CPU(quad) (quad)
|
|
#define CSR1212_CPU_TO_BE32(quad) (quad)
|
|
#define CSR1212_BE64_TO_CPU(quad) (quad)
|
|
#define CSR1212_CPU_TO_BE64(quad) (quad)
|
|
|
|
#define CSR1212_LE16_TO_CPU(quad) bswap_16(quad)
|
|
#define CSR1212_CPU_TO_LE16(quad) bswap_16(quad)
|
|
#define CSR1212_LE32_TO_CPU(quad) bswap_32(quad)
|
|
#define CSR1212_CPU_TO_LE32(quad) bswap_32(quad)
|
|
#define CSR1212_LE64_TO_CPU(quad) bswap_64(quad)
|
|
#define CSR1212_CPU_TO_LE64(quad) bswap_64(quad)
|
|
#endif
|
|
|
|
#include <errno.h>
|
|
#define CSR1212_SUCCESS (0)
|
|
#define CSR1212_EINVAL (EINVAL)
|
|
#define CSR1212_ENOMEM (ENOMEM)
|
|
#define CSR1212_ENOENT (ENOENT)
|
|
#define CSR1212_EIO (EIO)
|
|
#define CSR1212_EBUSY (EBUSY)
|
|
|
|
#endif
|
|
|
|
|
|
#define CSR1212_KV_VAL_MASK 0xffffff
|
|
#define CSR1212_KV_KEY_SHIFT 24
|
|
#define CSR1212_KV_KEY_TYPE_SHIFT 6
|
|
#define CSR1212_KV_KEY_ID_MASK 0x3f
|
|
#define CSR1212_KV_KEY_TYPE_MASK 0x3 /* After shift */
|
|
|
|
|
|
/* CSR 1212 key types */
|
|
#define CSR1212_KV_TYPE_IMMEDIATE 0
|
|
#define CSR1212_KV_TYPE_CSR_OFFSET 1
|
|
#define CSR1212_KV_TYPE_LEAF 2
|
|
#define CSR1212_KV_TYPE_DIRECTORY 3
|
|
|
|
|
|
/* CSR 1212 key ids */
|
|
#define CSR1212_KV_ID_DESCRIPTOR 0x01
|
|
#define CSR1212_KV_ID_BUS_DEPENDENT_INFO 0x02
|
|
#define CSR1212_KV_ID_VENDOR 0x03
|
|
#define CSR1212_KV_ID_HARDWARE_VERSION 0x04
|
|
#define CSR1212_KV_ID_MODULE 0x07
|
|
#define CSR1212_KV_ID_NODE_CAPABILITIES 0x0C
|
|
#define CSR1212_KV_ID_EUI_64 0x0D
|
|
#define CSR1212_KV_ID_UNIT 0x11
|
|
#define CSR1212_KV_ID_SPECIFIER_ID 0x12
|
|
#define CSR1212_KV_ID_VERSION 0x13
|
|
#define CSR1212_KV_ID_DEPENDENT_INFO 0x14
|
|
#define CSR1212_KV_ID_UNIT_LOCATION 0x15
|
|
#define CSR1212_KV_ID_MODEL 0x17
|
|
#define CSR1212_KV_ID_INSTANCE 0x18
|
|
#define CSR1212_KV_ID_KEYWORD 0x19
|
|
#define CSR1212_KV_ID_FEATURE 0x1A
|
|
#define CSR1212_KV_ID_EXTENDED_ROM 0x1B
|
|
#define CSR1212_KV_ID_EXTENDED_KEY_SPECIFIER_ID 0x1C
|
|
#define CSR1212_KV_ID_EXTENDED_KEY 0x1D
|
|
#define CSR1212_KV_ID_EXTENDED_DATA 0x1E
|
|
#define CSR1212_KV_ID_MODIFIABLE_DESCRIPTOR 0x1F
|
|
#define CSR1212_KV_ID_DIRECTORY_ID 0x20
|
|
#define CSR1212_KV_ID_REVISION 0x21
|
|
|
|
|
|
/* IEEE 1212 Address space map */
|
|
#define CSR1212_ALL_SPACE_BASE (0x000000000000ULL)
|
|
#define CSR1212_ALL_SPACE_SIZE (1ULL << 48)
|
|
#define CSR1212_ALL_SPACE_END (CSR1212_ALL_SPACE_BASE + CSR1212_ALL_SPACE_SIZE)
|
|
|
|
#define CSR1212_MEMORY_SPACE_BASE (0x000000000000ULL)
|
|
#define CSR1212_MEMORY_SPACE_SIZE ((256ULL * (1ULL << 40)) - (512ULL * (1ULL << 20)))
|
|
#define CSR1212_MEMORY_SPACE_END (CSR1212_MEMORY_SPACE_BASE + CSR1212_MEMORY_SPACE_SIZE)
|
|
|
|
#define CSR1212_PRIVATE_SPACE_BASE (0xffffe0000000ULL)
|
|
#define CSR1212_PRIVATE_SPACE_SIZE (256ULL * (1ULL << 20))
|
|
#define CSR1212_PRIVATE_SPACE_END (CSR1212_PRIVATE_SPACE_BASE + CSR1212_PRIVATE_SPACE_SIZE)
|
|
|
|
#define CSR1212_REGISTER_SPACE_BASE (0xfffff0000000ULL)
|
|
#define CSR1212_REGISTER_SPACE_SIZE (256ULL * (1ULL << 20))
|
|
#define CSR1212_REGISTER_SPACE_END (CSR1212_REGISTER_SPACE_BASE + CSR1212_REGISTER_SPACE_SIZE)
|
|
|
|
#define CSR1212_CSR_ARCH_REG_SPACE_BASE (0xfffff0000000ULL)
|
|
#define CSR1212_CSR_ARCH_REG_SPACE_SIZE (512)
|
|
#define CSR1212_CSR_ARCH_REG_SPACE_END (CSR1212_CSR_ARCH_REG_SPACE_BASE + CSR1212_CSR_ARCH_REG_SPACE_SIZE)
|
|
#define CSR1212_CSR_ARCH_REG_SPACE_OFFSET (CSR1212_CSR_ARCH_REG_SPACE_BASE - CSR1212_REGISTER_SPACE_BASE)
|
|
|
|
#define CSR1212_CSR_BUS_DEP_REG_SPACE_BASE (0xfffff0000200ULL)
|
|
#define CSR1212_CSR_BUS_DEP_REG_SPACE_SIZE (512)
|
|
#define CSR1212_CSR_BUS_DEP_REG_SPACE_END (CSR1212_CSR_BUS_DEP_REG_SPACE_BASE + CSR1212_CSR_BUS_DEP_REG_SPACE_SIZE)
|
|
#define CSR1212_CSR_BUS_DEP_REG_SPACE_OFFSET (CSR1212_CSR_BUS_DEP_REG_SPACE_BASE - CSR1212_REGISTER_SPACE_BASE)
|
|
|
|
#define CSR1212_CONFIG_ROM_SPACE_BASE (0xfffff0000400ULL)
|
|
#define CSR1212_CONFIG_ROM_SPACE_SIZE (1024)
|
|
#define CSR1212_CONFIG_ROM_SPACE_END (CSR1212_CONFIG_ROM_SPACE_BASE + CSR1212_CONFIG_ROM_SPACE_SIZE)
|
|
#define CSR1212_CONFIG_ROM_SPACE_OFFSET (CSR1212_CONFIG_ROM_SPACE_BASE - CSR1212_REGISTER_SPACE_BASE)
|
|
|
|
#define CSR1212_UNITS_SPACE_BASE (0xfffff0000800ULL)
|
|
#define CSR1212_UNITS_SPACE_SIZE ((256ULL * (1ULL << 20)) - 2048)
|
|
#define CSR1212_UNITS_SPACE_END (CSR1212_UNITS_SPACE_BASE + CSR1212_UNITS_SPACE_SIZE)
|
|
#define CSR1212_UNITS_SPACE_OFFSET (CSR1212_UNITS_SPACE_BASE - CSR1212_REGISTER_SPACE_BASE)
|
|
|
|
#define CSR1212_EXTENDED_ROM_SIZE (0x10000 * sizeof(u_int32_t))
|
|
|
|
#define CSR1212_INVALID_ADDR_SPACE -1
|
|
|
|
/* Config ROM image structures */
|
|
struct csr1212_bus_info_block_img {
|
|
u_int8_t length;
|
|
u_int8_t crc_length;
|
|
u_int16_t crc;
|
|
|
|
/* Must be last */
|
|
u_int32_t data[0]; /* older gcc can't handle [] which is standard */
|
|
};
|
|
|
|
#define CSR1212_KV_KEY(quad) (CSR1212_BE32_TO_CPU(quad) >> CSR1212_KV_KEY_SHIFT)
|
|
#define CSR1212_KV_KEY_TYPE(quad) (CSR1212_KV_KEY(quad) >> CSR1212_KV_KEY_TYPE_SHIFT)
|
|
#define CSR1212_KV_KEY_ID(quad) (CSR1212_KV_KEY(quad) & CSR1212_KV_KEY_ID_MASK)
|
|
#define CSR1212_KV_VAL(quad) (CSR1212_BE32_TO_CPU(quad) & CSR1212_KV_VAL_MASK)
|
|
|
|
#define CSR1212_SET_KV_KEY(quad, key) ((quad) = \
|
|
CSR1212_CPU_TO_BE32(CSR1212_KV_VAL(quad) | ((key) << CSR1212_KV_KEY_SHIFT)))
|
|
#define CSR1212_SET_KV_VAL(quad, val) ((quad) = \
|
|
CSR1212_CPU_TO_BE32((CSR1212_KV_KEY(quad) << CSR1212_KV_KEY_SHIFT) | (val)))
|
|
#define CSR1212_SET_KV_TYPEID(quad, type, id) ((quad) = \
|
|
CSR1212_CPU_TO_BE32(CSR1212_KV_VAL(quad) | \
|
|
(((((type) & CSR1212_KV_KEY_TYPE_MASK) << CSR1212_KV_KEY_TYPE_SHIFT) | \
|
|
((id) & CSR1212_KV_KEY_ID_MASK)) << CSR1212_KV_KEY_SHIFT)))
|
|
|
|
typedef u_int32_t csr1212_quad_t;
|
|
|
|
|
|
struct csr1212_keyval_img {
|
|
u_int16_t length;
|
|
u_int16_t crc;
|
|
|
|
/* Must be last */
|
|
csr1212_quad_t data[0]; /* older gcc can't handle [] which is standard */
|
|
};
|
|
|
|
struct csr1212_leaf {
|
|
int len;
|
|
u_int32_t *data;
|
|
};
|
|
|
|
struct csr1212_dentry {
|
|
struct csr1212_dentry *next, *prev;
|
|
struct csr1212_keyval *kv;
|
|
};
|
|
|
|
struct csr1212_directory {
|
|
int len;
|
|
struct csr1212_dentry *dentries_head, *dentries_tail;
|
|
};
|
|
|
|
struct csr1212_keyval {
|
|
struct {
|
|
u_int8_t type;
|
|
u_int8_t id;
|
|
} key;
|
|
union {
|
|
u_int32_t immediate;
|
|
u_int32_t csr_offset;
|
|
struct csr1212_leaf leaf;
|
|
struct csr1212_directory directory;
|
|
} value;
|
|
struct csr1212_keyval *associate;
|
|
int refcnt;
|
|
|
|
/* used in generating and/or parsing CSR image */
|
|
struct csr1212_keyval *next, *prev; /* flat list of CSR elements */
|
|
u_int32_t offset; /* position in CSR from 0xffff f000 0000 */
|
|
u_int8_t valid; /* flag indicating keyval has valid data*/
|
|
};
|
|
|
|
|
|
struct csr1212_cache_region {
|
|
struct csr1212_cache_region *next, *prev;
|
|
u_int32_t offset_start; /* inclusive */
|
|
u_int32_t offset_end; /* exclusive */
|
|
};
|
|
|
|
struct csr1212_csr_rom_cache {
|
|
struct csr1212_csr_rom_cache *next, *prev;
|
|
struct csr1212_cache_region *filled_head, *filled_tail;
|
|
struct csr1212_keyval *layout_head, *layout_tail;
|
|
size_t size;
|
|
u_int32_t offset;
|
|
struct csr1212_keyval *ext_rom;
|
|
size_t len;
|
|
|
|
/* Must be last */
|
|
u_int32_t data[0]; /* older gcc can't handle [] which is standard */
|
|
};
|
|
|
|
struct csr1212_csr {
|
|
size_t bus_info_len; /* bus info block length in bytes */
|
|
size_t crc_len; /* crc length in bytes */
|
|
u_int32_t *bus_info_data; /* bus info data incl bus name and EUI */
|
|
|
|
void *private; /* private, bus specific data */
|
|
struct csr1212_bus_ops *ops;
|
|
|
|
struct csr1212_keyval *root_kv;
|
|
|
|
int max_rom; /* max bytes readable in Config ROM region */
|
|
|
|
/* Items below used for image parsing and generation */
|
|
struct csr1212_csr_rom_cache *cache_head, *cache_tail;
|
|
};
|
|
|
|
struct csr1212_bus_ops {
|
|
/* This function is used by csr1212 to read additional information
|
|
* from remote nodes when parsing a Config ROM (i.e., read Config ROM
|
|
* entries located in the Units Space. Must return 0 on success
|
|
* anything else indicates an error. */
|
|
int (*bus_read) (struct csr1212_csr *csr, u_int64_t addr,
|
|
u_int16_t length, void *buffer, void *private);
|
|
|
|
/* This function is used by csr1212 to allocate a region in units space
|
|
* in the event that Config ROM entries don't all fit in the predefined
|
|
* 1K region. The void *private parameter is private member of struct
|
|
* csr1212_csr. */
|
|
u_int64_t (*allocate_addr_range) (u_int64_t size, u_int32_t alignment,
|
|
void *private);
|
|
|
|
|
|
/* This function is used by csr1212 to release a region in units space
|
|
* that is no longer needed. */
|
|
void (*release_addr) (u_int64_t addr, void *private);
|
|
|
|
/* This function is used by csr1212 to determine the max read request
|
|
* supported by a remote node when reading the ConfigROM space. Must
|
|
* return 0, 1, or 2 per IEEE 1212. */
|
|
int (*get_max_rom) (u_int32_t *bus_info, void *private);
|
|
};
|
|
|
|
|
|
|
|
|
|
/* Descriptor Leaf manipulation macros */
|
|
#define CSR1212_DESCRIPTOR_LEAF_TYPE_SHIFT 24
|
|
#define CSR1212_DESCRIPTOR_LEAF_SPECIFIER_ID_MASK 0xffffff
|
|
#define CSR1212_DESCRIPTOR_LEAF_OVERHEAD (1 * sizeof(u_int32_t))
|
|
|
|
#define CSR1212_DESCRIPTOR_LEAF_TYPE(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[0]) >> CSR1212_DESCRIPTOR_LEAF_TYPE_SHIFT)
|
|
#define CSR1212_DESCRIPTOR_LEAF_SPECIFIER_ID(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[0]) & \
|
|
CSR1212_DESCRIPTOR_LEAF_SPECIFIER_ID_MASK)
|
|
#define CSR1212_DESCRIPTOR_LEAF_DATA(kv) \
|
|
(&((kv)->value.leaf.data[1]))
|
|
|
|
#define CSR1212_DESCRIPTOR_LEAF_SET_TYPE(kv, type) \
|
|
((kv)->value.leaf.data[0] = \
|
|
CSR1212_CPU_TO_BE32(CSR1212_DESCRIPTOR_LEAF_SPECIFIER_ID(kv) | \
|
|
((type) << CSR1212_DESCRIPTOR_LEAF_TYPE_SHIFT)))
|
|
#define CSR1212_DESCRIPTOR_LEAF_SET_SPECIFIER_ID(kv, spec_id) \
|
|
((kv)->value.leaf.data[0] = \
|
|
CSR1212_CPU_TO_BE32((CSR1212_DESCRIPTOR_LEAF_TYPE(kv) << \
|
|
CSR1212_DESCRIPTOR_LEAF_TYPE_SHIFT) | \
|
|
((spec_id) & CSR1212_DESCRIPTOR_LEAF_SPECIFIER_ID_MASK)))
|
|
|
|
/* Text Descriptor Leaf manipulation macros */
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH_SHIFT 28
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH_MASK 0xf /* after shift */
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_SHIFT 16
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_MASK 0xfff /* after shift */
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_LANGUAGE_MASK 0xffff
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_OVERHEAD (1 * sizeof(u_int32_t))
|
|
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[1]) >> \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH_SHIFT)
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET(kv) \
|
|
((CSR1212_BE32_TO_CPU((kv)->value.leaf.data[1]) >> \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_SHIFT) & \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_MASK)
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_LANGUAGE(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[1]) & \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_LANGUAGE_MASK)
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_DATA(kv) \
|
|
(&((kv)->value.leaf.data[2]))
|
|
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_SET_WIDTH(kv, width) \
|
|
((kv)->value.leaf.data[1] = \
|
|
((kv)->value.leaf.data[1] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH_MASK << \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH_SHIFT))) | \
|
|
CSR1212_CPU_TO_BE32(((width) & \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH_MASK) << \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_WIDTH_SHIFT))
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_SET_CHAR_SET(kv, char_set) \
|
|
((kv)->value.leaf.data[1] = \
|
|
((kv)->value.leaf.data[1] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_MASK << \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_SHIFT))) | \
|
|
CSR1212_CPU_TO_BE32(((char_set) & \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_MASK) << \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_CHAR_SET_SHIFT))
|
|
#define CSR1212_TEXTUAL_DESCRIPTOR_LEAF_SET_LANGUAGE(kv, language) \
|
|
((kv)->value.leaf.data[1] = \
|
|
((kv)->value.leaf.data[1] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_TEXTUAL_DESCRIPTOR_LEAF_LANGUAGE_MASK))) | \
|
|
CSR1212_CPU_TO_BE32(((language) & \
|
|
CSR1212_TEXTUAL_DESCRIPTOR_LEAF_LANGUAGE_MASK)))
|
|
|
|
|
|
/* Icon Descriptor Leaf manipulation macros */
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_VERSION_MASK 0xffffff
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH_SHIFT 30
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH_MASK 0x3 /* after shift */
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_SHIFT 16
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_MASK 0xf /* after shift */
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_LANGUAGE_MASK 0xffff
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_HSCAN_SHIFT 16
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_HSCAN_MASK 0xffff /* after shift */
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_VSCAN_MASK 0xffff
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_OVERHEAD (3 * sizeof(u_int32_t))
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_VERSION(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[2]) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_VERSION_MASK)
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[3]) >> \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH_SHIFT)
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE(kv) \
|
|
((CSR1212_BE32_TO_CPU((kv)->value.leaf.data[3]) >> \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_SHIFT) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_MASK)
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_LANGUAGE(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[3]) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_LANGUAGE_MASK)
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_HSCAN(kv) \
|
|
((CSR1212_BE32_TO_CPU((kv)->value.leaf.data[4]) >> \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_HSCAN_SHIFT) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_HSCAN_MASK)
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_VSCAN(kv) \
|
|
(CSR1212_BE32_TO_CPU((kv)->value.leaf.data[4]) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_VSCAN_MASK)
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE(kv) \
|
|
(&((kv)->value.leaf.data[5]))
|
|
|
|
static inline u_int32_t *CSR1212_ICON_DESCRIPTOR_LEAF_PIXELS(struct csr1212_keyval *kv)
|
|
{
|
|
static const int pd[4] = { 0, 4, 16, 256 };
|
|
static const int cs[16] = { 4, 2 };
|
|
int ps = pd[CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH(kv)];
|
|
|
|
return &kv->value.leaf.data[5 +
|
|
(ps * cs[CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE(kv)]) /
|
|
sizeof(u_int32_t)];
|
|
}
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_SET_VERSION(kv, version) \
|
|
((kv)->value.leaf.data[2] = \
|
|
((kv)->value.leaf.data[2] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_ICON_DESCRIPTOR_LEAF_VERSION_MASK))) | \
|
|
CSR1212_CPU_TO_BE32(((version) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_VERSION_MASK)))
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_SET_PALETTE_DEPTH(kv, palette_depth) \
|
|
((kv)->value.leaf.data[3] = \
|
|
((kv)->value.leaf.data[3] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH_MASK << \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH_SHIFT))) | \
|
|
CSR1212_CPU_TO_BE32(((palette_depth) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH_MASK) << \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_PALETTE_DEPTH_SHIFT))
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_SET_COLOR_SPACE(kv, color_space) \
|
|
((kv)->value.leaf.data[3] = \
|
|
((kv)->value.leaf.data[3] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_MASK << \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_SHIFT))) | \
|
|
CSR1212_CPU_TO_BE32(((color_space) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_MASK) << \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_COLOR_SPACE_SHIFT))
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_SET_LANGUAGE(kv, language) \
|
|
((kv)->value.leaf.data[3] = \
|
|
((kv)->value.leaf.data[3] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_ICON_DESCRIPTOR_LEAF_LANGUAGE_MASK))) | \
|
|
CSR1212_CPU_TO_BE32(((language) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_LANGUAGE_MASK)))
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_SET_HSCAN(kv, hscan) \
|
|
((kv)->value.leaf.data[4] = \
|
|
((kv)->value.leaf.data[4] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_ICON_DESCRIPTOR_LEAF_HSCAN_MASK << \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_HSCAN_SHIFT))) | \
|
|
CSR1212_CPU_TO_BE32(((hscan) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_HSCAN_MASK) << \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_HSCAN_SHIFT))
|
|
|
|
#define CSR1212_ICON_DESCRIPTOR_LEAF_SET_VSCAN(kv, vscan) \
|
|
((kv)->value.leaf.data[4] = \
|
|
(((kv)->value.leaf.data[4] & \
|
|
CSR1212_CPU_TO_BE32(~CSR1212_ICON_DESCRIPTOR_LEAF_VSCAN_MASK))) | \
|
|
CSR1212_CPU_TO_BE32(((vscan) & \
|
|
CSR1212_ICON_DESCRIPTOR_LEAF_VSCAN_MASK)))
|
|
|
|
|
|
/* Modifiable Descriptor Leaf manipulation macros */
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_MAX_SIZE_SHIFT 16
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_MAX_SIZE_MASK 0xffff
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_ADDR_HI_SHIFT 32
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_ADDR_HI_MASK 0xffff
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_ADDR_LO_MASK 0xffffffffULL
|
|
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_MAX_SIZE(kv) \
|
|
CSR1212_BE16_TO_CPU((kv)->value.leaf.data[0] >> CSR1212_MODIFIABLE_DESCRIPTOR_MAX_SIZE_SHIFT)
|
|
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_ADDRESS(kv) \
|
|
(CSR1212_BE16_TO_CPU(((u_int64_t)((kv)->value.leaf.data[0])) << \
|
|
CSR1212_MODIFIABLE_DESCRIPTOR_ADDR_HI_SHIFT) | \
|
|
CSR1212_BE32_TO_CPU((kv)->value.leaf.data[1]))
|
|
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_SET_MAX_SIZE(kv, size) \
|
|
((kv)->value.leaf.data[0] = \
|
|
((kv)->value.leaf.data[0] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_MAX_SIZE_MASK << \
|
|
CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_MAX_SIZE_SHIFT))) | \
|
|
CSR1212_CPU_TO_BE32(((size) & \
|
|
CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_MAX_SIZE_MASK) << \
|
|
CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_MAX_SIZE_SHIFT))
|
|
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_SET_ADDRESS_HI(kv, addr) \
|
|
((kv)->value.leaf.data[0] = \
|
|
((kv)->value.leaf.data[0] & \
|
|
CSR1212_CPU_TO_BE32(~(CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_ADDR_HI_MASK))) | \
|
|
CSR1212_CPU_TO_BE32(((addr) & \
|
|
CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_ADDR_HI_MASK)))
|
|
|
|
#define CSR1212_MODIFIABLE_DESCRIPTOR_SET_ADDRESS_LO(kv, addr) \
|
|
((kv)->value.leaf.data[1] = \
|
|
CSR1212_CPU_TO_BE32(addr & CSR1212_MODIFIABLE_DESCRIPTOR_LEAF_ADDR_LO_MASK))
|
|
|
|
|
|
|
|
/* The following 2 function are for creating new Configuration ROM trees. The
|
|
* first function is used for both creating local trees and parsing remote
|
|
* trees. The second function adds pertinent information to local Configuration
|
|
* ROM trees - namely data for the bus information block. */
|
|
extern struct csr1212_csr *csr1212_create_csr(struct csr1212_bus_ops *ops,
|
|
size_t bus_info_size,
|
|
void *private);
|
|
extern void csr1212_init_local_csr(struct csr1212_csr *csr,
|
|
const u_int32_t *bus_info_data, int max_rom);
|
|
|
|
|
|
/* The following function destroys a Configuration ROM tree and release all
|
|
* memory taken by the tree. */
|
|
extern void csr1212_destroy_csr(struct csr1212_csr *csr);
|
|
|
|
|
|
/* The following set of functions are fore creating new keyvals for placement in
|
|
* a Configuration ROM tree. Code that creates new keyvals with these functions
|
|
* must release those keyvals with csr1212_release_keyval() when they are no
|
|
* longer needed. */
|
|
extern struct csr1212_keyval *csr1212_new_immediate(u_int8_t key, u_int32_t value);
|
|
extern struct csr1212_keyval *csr1212_new_leaf(u_int8_t key, const void *data,
|
|
size_t data_len);
|
|
extern struct csr1212_keyval *csr1212_new_csr_offset(u_int8_t key,
|
|
u_int32_t csr_offset);
|
|
extern struct csr1212_keyval *csr1212_new_directory(u_int8_t key);
|
|
extern struct csr1212_keyval *csr1212_new_extended_immediate(u_int32_t spec,
|
|
u_int32_t key,
|
|
u_int32_t value);
|
|
extern struct csr1212_keyval *csr1212_new_extended_leaf(u_int32_t spec,
|
|
u_int32_t key,
|
|
const void *data,
|
|
size_t data_len);
|
|
extern struct csr1212_keyval *csr1212_new_descriptor_leaf(u_int8_t dtype,
|
|
u_int32_t specifier_id,
|
|
const void *data,
|
|
size_t data_len);
|
|
extern struct csr1212_keyval *csr1212_new_textual_descriptor_leaf(u_int8_t cwidth,
|
|
u_int16_t cset,
|
|
u_int16_t language,
|
|
const void *data,
|
|
size_t data_len);
|
|
extern struct csr1212_keyval *csr1212_new_string_descriptor_leaf(const char *s);
|
|
extern struct csr1212_keyval *csr1212_new_icon_descriptor_leaf(u_int32_t version,
|
|
u_int8_t palette_depth,
|
|
u_int8_t color_space,
|
|
u_int16_t language,
|
|
u_int16_t hscan,
|
|
u_int16_t vscan,
|
|
u_int32_t *palette,
|
|
u_int32_t *pixels);
|
|
extern struct csr1212_keyval *csr1212_new_modifiable_descriptor_leaf(u_int16_t max_size,
|
|
u_int64_t address);
|
|
extern struct csr1212_keyval *csr1212_new_keyword_leaf(int strc,
|
|
const char *strv[]);
|
|
|
|
|
|
/* The following functions manage association between keyvals. Typically,
|
|
* Descriptor Leaves and Directories will be associated with another keyval and
|
|
* it is desirable for the Descriptor keyval to be place immediately after the
|
|
* keyval that it is associated with.*/
|
|
extern int csr1212_associate_keyval(struct csr1212_keyval *kv,
|
|
struct csr1212_keyval *associate);
|
|
extern void csr1212_disassociate_keyval(struct csr1212_keyval *kv);
|
|
|
|
|
|
/* The following functions manage the association of a keyval and directories.
|
|
* A keyval may be attached to more than one directory. */
|
|
extern int csr1212_attach_keyval_to_directory(struct csr1212_keyval *dir,
|
|
struct csr1212_keyval *kv);
|
|
extern void csr1212_detach_keyval_from_directory(struct csr1212_keyval *dir,
|
|
struct csr1212_keyval *kv);
|
|
|
|
|
|
/* The following functions create a Configuration ROM image from the tree of
|
|
* keyvals provided. csr1212_generate_csr_image() creates a complete image in
|
|
* the list of caches available via csr->cache_head. The other functions are
|
|
* provided should there be a need to create a flat image without restrictions
|
|
* placed by IEEE 1212. */
|
|
extern struct csr1212_keyval *csr1212_generate_positions(struct csr1212_csr_rom_cache *cache,
|
|
struct csr1212_keyval *start_kv,
|
|
int start_pos);
|
|
extern size_t csr1212_generate_layout_order(struct csr1212_keyval *kv);
|
|
extern void csr1212_fill_cache(struct csr1212_csr_rom_cache *cache);
|
|
extern int csr1212_generate_csr_image(struct csr1212_csr *csr);
|
|
|
|
|
|
/* This is a convience function for reading a block of data out of one of the
|
|
* caches in the csr->cache_head list. */
|
|
extern int csr1212_read(struct csr1212_csr *csr, u_int32_t offset, void *buffer,
|
|
u_int32_t len);
|
|
|
|
|
|
/* The following functions are in place for parsing Configuration ROM images.
|
|
* csr1212_parse_keyval() is used should there be a need to directly parse a
|
|
* Configuration ROM directly. */
|
|
extern int csr1212_parse_keyval(struct csr1212_keyval *kv,
|
|
struct csr1212_csr_rom_cache *cache);
|
|
extern int csr1212_parse_csr(struct csr1212_csr *csr);
|
|
|
|
/* These are internal functions referenced by inline functions below. */
|
|
extern int _csr1212_read_keyval(struct csr1212_csr *csr, struct csr1212_keyval *kv);
|
|
extern void _csr1212_destroy_keyval(struct csr1212_keyval *kv);
|
|
|
|
|
|
/* This function allocates a new cache which may be used for either parsing or
|
|
* generating sub-sets of Configuration ROM images. */
|
|
static inline struct csr1212_csr_rom_cache *csr1212_rom_cache_malloc(u_int32_t offset,
|
|
size_t size)
|
|
{
|
|
struct csr1212_csr_rom_cache *cache;
|
|
|
|
cache = CSR1212_MALLOC(sizeof(*cache) + size);
|
|
if (!cache)
|
|
return NULL;
|
|
|
|
cache->next = NULL;
|
|
cache->prev = NULL;
|
|
cache->filled_head = NULL;
|
|
cache->filled_tail = NULL;
|
|
cache->layout_head = NULL;
|
|
cache->layout_tail = NULL;
|
|
cache->offset = offset;
|
|
cache->size = size;
|
|
cache->ext_rom = NULL;
|
|
|
|
return cache;
|
|
}
|
|
|
|
|
|
/* This function ensures that a keyval contains data when referencing a keyval
|
|
* created by parsing a Configuration ROM. */
|
|
static inline struct csr1212_keyval *csr1212_get_keyval(struct csr1212_csr *csr,
|
|
struct csr1212_keyval *kv)
|
|
{
|
|
if (!kv)
|
|
return NULL;
|
|
if (!kv->valid)
|
|
if (_csr1212_read_keyval(csr, kv) != CSR1212_SUCCESS)
|
|
return NULL;
|
|
return kv;
|
|
}
|
|
|
|
|
|
/* This function increments the reference count for a keyval should there be a
|
|
* need for code to retain a keyval that has been parsed. */
|
|
static inline void csr1212_keep_keyval(struct csr1212_keyval *kv)
|
|
{
|
|
kv->refcnt++;
|
|
}
|
|
|
|
|
|
/* This function decrements a keyval's reference count and will destroy the
|
|
* keyval when there are no more users of the keyval. This should be called by
|
|
* any code that calls csr1212_keep_keyval() or any of the keyval creation
|
|
* routines csr1212_new_*(). */
|
|
static inline void csr1212_release_keyval(struct csr1212_keyval *kv)
|
|
{
|
|
if (kv->refcnt > 1)
|
|
kv->refcnt--;
|
|
else
|
|
_csr1212_destroy_keyval(kv);
|
|
}
|
|
|
|
|
|
/*
|
|
* This macro allows for looping over the keyval entries in a directory and it
|
|
* ensures that keyvals from remote ConfigROMs are parsed properly.
|
|
*
|
|
* _csr is a struct csr1212_csr * that points to CSR associated with dir.
|
|
* _kv is a struct csr1212_keyval * that'll point to the current keyval (loop index).
|
|
* _dir is a struct csr1212_keyval * that points to the directory to be looped.
|
|
* _pos is a struct csr1212_dentry * that is used internally for indexing.
|
|
*
|
|
* kv will be NULL upon exit of the loop.
|
|
*/
|
|
#define csr1212_for_each_dir_entry(_csr, _kv, _dir, _pos) \
|
|
for (csr1212_get_keyval((_csr), (_dir)), \
|
|
_pos = (_dir)->value.directory.dentries_head, \
|
|
_kv = (_pos) ? csr1212_get_keyval((_csr), _pos->kv) : NULL; \
|
|
(_kv) && (_pos); \
|
|
(_kv->associate == NULL) ? \
|
|
((_pos = _pos->next), \
|
|
(_kv = (_pos) ? csr1212_get_keyval((_csr), _pos->kv) : \
|
|
NULL)) : \
|
|
(_kv = csr1212_get_keyval((_csr), _kv->associate)))
|
|
|
|
|
|
|
|
#endif /* __CSR1212_H__ */
|