1 /*- 2 * Copyright (c) 2015-2016 Landon Fuller <landon@landonf.org> 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 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. 15 * 16 * NO WARRANTY 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. 28 * 29 * $FreeBSD$ 30 */ 31 32 #ifndef _BHND_NVRAM_BHND_NVRAM_H_ 33 #define _BHND_NVRAM_BHND_NVRAM_H_ 34 35 #ifdef _KERNEL 36 #include <sys/types.h> 37 #else /* !_KERNEL */ 38 #include <stdbool.h> 39 #include <stdint.h> 40 #endif /* _KERNEL */ 41 42 /** 43 * NVRAM data sources supported by bhnd(4) devices. 44 */ 45 typedef enum { 46 BHND_NVRAM_SRC_OTP, /**< On-chip one-time-programmable 47 * memory. */ 48 49 BHND_NVRAM_SRC_FLASH, /**< External flash */ 50 BHND_NVRAM_SRC_SPROM, /**< External serial EEPROM. */ 51 52 BHND_NVRAM_SRC_UNKNOWN /**< No NVRAM source is directly 53 * attached. 54 * 55 * This will be returned by ChipCommon 56 * revisions (rev <= 31) used in early 57 * chipsets that vend SPROM/OTP via the 58 * native host bridge interface. 59 * 60 * For example, PCMCIA cards may vend 61 * Broadcom NVRAM data via their standard CIS 62 * table, and earlier PCI(e) devices map 63 * SPROM statically into PCI BARs, and the 64 * control registers into PCI config space. 65 66 * This will also be returned on later 67 * devices that are attached via PCI(e) to 68 * BHND SoCs, but do not include an attached 69 * SPROM, or programmed OTP. On such SoCs, 70 * NVRAM configuration for individual devices 71 * is provided by a common platform NVRAM 72 * device. 73 */ 74 } bhnd_nvram_src; 75 76 /** 77 * NVRAM data types. 78 * 79 * @internal 80 * 81 * All primitive (non-array) constants should be representable as a 4-bit 82 * integer (e.g. 0-15) to support SPROM_OPCODE_TYPE_IMM encoding as used by 83 * nvram_map_gen.awk. 84 */ 85 typedef enum { 86 BHND_NVRAM_TYPE_UINT8 = 0, /**< unsigned 8-bit integer */ 87 BHND_NVRAM_TYPE_UINT16 = 1, /**< unsigned 16-bit integer */ 88 BHND_NVRAM_TYPE_UINT32 = 2, /**< unsigned 32-bit integer */ 89 BHND_NVRAM_TYPE_UINT64 = 3, /**< signed 64-bit integer */ 90 BHND_NVRAM_TYPE_INT8 = 4, /**< signed 8-bit integer */ 91 BHND_NVRAM_TYPE_INT16 = 5, /**< signed 16-bit integer */ 92 BHND_NVRAM_TYPE_INT32 = 6, /**< signed 32-bit integer */ 93 BHND_NVRAM_TYPE_INT64 = 7, /**< signed 64-bit integer */ 94 BHND_NVRAM_TYPE_CHAR = 8, /**< ASCII/UTF-8 character */ 95 BHND_NVRAM_TYPE_STRING = 9, /**< ASCII/UTF-8 NUL-terminated 96 string */ 97 98 /* 10-15 reserved for primitive (non-array) types */ 99 100 BHND_NVRAM_TYPE_UINT8_ARRAY = 16, /**< array of uint8 integers */ 101 BHND_NVRAM_TYPE_UINT16_ARRAY = 17, /**< array of uint16 integers */ 102 BHND_NVRAM_TYPE_UINT32_ARRAY = 18, /**< array of uint32 integers */ 103 BHND_NVRAM_TYPE_UINT64_ARRAY = 19, /**< array of uint64 integers */ 104 BHND_NVRAM_TYPE_INT8_ARRAY = 20, /**< array of int8 integers */ 105 BHND_NVRAM_TYPE_INT16_ARRAY = 21, /**< array of int16 integers */ 106 BHND_NVRAM_TYPE_INT32_ARRAY = 22, /**< array of int32 integers */ 107 BHND_NVRAM_TYPE_INT64_ARRAY = 23, /**< array of int64 integers */ 108 BHND_NVRAM_TYPE_CHAR_ARRAY = 24, /**< array of ASCII/UTF-8 109 characters */ 110 BHND_NVRAM_TYPE_STRING_ARRAY = 25, /**< array of ASCII/UTF-8 111 NUL-terminated strings */ 112 } bhnd_nvram_type; 113 114 const char *bhnd_nvram_string_array_next(const char *inp, size_t ilen, 115 const char *prev); 116 117 bool bhnd_nvram_is_signed_type(bhnd_nvram_type type); 118 bool bhnd_nvram_is_unsigned_type(bhnd_nvram_type type); 119 bool bhnd_nvram_is_int_type(bhnd_nvram_type type); 120 bool bhnd_nvram_is_array_type(bhnd_nvram_type type); 121 bhnd_nvram_type bhnd_nvram_base_type(bhnd_nvram_type type); 122 const char *bhnd_nvram_type_name(bhnd_nvram_type type); 123 124 #endif /* _BHND_NVRAM_BHND_NVRAM_H_ */ 125