From e4002c08c75a6c7abb3feda23e5b8ef7e03b54a0 Mon Sep 17 00:00:00 2001 From: Rebecca Schultz Zavin Date: Thu, 7 Oct 2010 11:03:24 -0700 Subject: [PATCH] [ARM] tegra: nv: remove unused header -- it's stale anyway Change-Id: Ia95b8a5ae34c338b681bd42335dc324a3014628b Signed-off-by: Rebecca Schultz Zavin --- .../nv/include/nvodm_query_discovery.h | 371 ------------------ 1 file changed, 371 deletions(-) delete mode 100644 arch/arm/mach-tegra/nv/include/nvodm_query_discovery.h diff --git a/arch/arm/mach-tegra/nv/include/nvodm_query_discovery.h b/arch/arm/mach-tegra/nv/include/nvodm_query_discovery.h deleted file mode 100644 index 1a109fd8381e..000000000000 --- a/arch/arm/mach-tegra/nv/include/nvodm_query_discovery.h +++ /dev/null @@ -1,371 +0,0 @@ -/* - * Copyright (c) 2007-2009 NVIDIA Corporation. - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions are met: - * - * Redistributions of source code must retain the above copyright notice, - * this list of conditions and the following disclaimer. - * - * 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. - * - * Neither the name of the NVIDIA Corporation nor the names of its contributors - * may be used to endorse or promote products derived from this software - * without specific prior written permission. - * - * 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 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE - * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS 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. - * - */ - -/** - * @file - * NVIDIA Tegra ODM Kit: - * ODM Peripheral Discovery API - * - * @b Description: Defines a query interface for enumerating peripherals - * and the board-specific topology that may be called during - * boot and at run-time. - */ - -#ifndef INCLUDED_NVODM_QUERY_DISCOVERY_H -#define INCLUDED_NVODM_QUERY_DISCOVERY_H - -/** - * @defgroup nvodm_discovery ODM Peripheral Discovery Interface - * - * This is the ODM query interface allowing ODMs to specify the connectivity - * of peripherals on their boards to I/Os on an NVIDIA® Application Processor - * without modifying the driver libraries. - * - * All peripherals connected to the application processor are referenced by - * their Global Unique Identifier code, or GUID. The GUID is an ODM-defined - * 64-bit value (8-character code) that uniquely identifies each peripheral, - * i.e., each peripheral will have exactly one GUID, and each GUID will refer - * to exactly one peripheral. - * - * The implementation of this API is similar to a simple database: tables are - * provided by the ODMs that, for every peripheral, define the peripheral's - * GUID, and specify the bus, or set of buses, to which the peripheral is - * connected. As an example, an audio codec peripheral with GUID 0 could be - * connected to the application processor by DAP instance 0, I2C instance 1 - * (address 0x80), and voltage rail 3. The functions provided by this API - * provide facilities enabling the boot process and driver libraries to - * enumerate the set of peripherals attached to a specific bus, the set of - * peripherals with specific functionality (such as display outputs), and the - * set of buses connected to a specific peripheral. - * @ingroup nvodm_query - * @{ - */ - -#include "nvodm_modules.h" -#include "nvodm_services.h" - -#if defined(__cplusplus) -extern "C" -{ -#endif - -/** - * The NV_ODM_GUID macro is used to convert ASCII 8-character codes into the - * 64-bit globally-unique identifiers that identify each peripheral. - * - * @note GUIDs beginning with the characters nv, Nv, nV, - * and NV are reserved for use by NVIDIA; all other values may be - * assigned by the ODM as desired. - */ -#define NV_ODM_GUID(a,b,c,d,e,f,g,h) \ - ((NvU64) ((((a)&0xffULL)<<56ULL) | (((b)&0xffULL)<<48ULL) | \ - (((c)&0xffULL)<<40ULL) | (((d)&0xffULL)<<32ULL) | \ - (((e)&0xffULL)<<24ULL) | (((f)&0xffULL)<<16ULL) | \ - (((g)&0xffULL)<< 8ULL) | (((h)&0xffULL)))) - -/** - * Reserved GUIDs. - */ -#define NV_VDD_RTC_ODM_ID (NV_ODM_GUID('N','V','D','D','_','R','T','C')) -#define NV_VDD_CORE_ODM_ID (NV_ODM_GUID('N','V','D','D','C','O','R','E')) -#define NV_VDD_CPU_ODM_ID (NV_ODM_GUID('N','V','D','D','_','C','P','U')) - -#define NV_VDD_PLLA_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','A')) -#define NV_VDD_PLLM_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','M')) -#define NV_VDD_PLLP_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','P')) -#define NV_VDD_PLLC_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','C')) -#define NV_VDD_PLLD_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','D')) -#define NV_VDD_PLLE_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','E')) -#define NV_VDD_PLLU_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','U')) -#define NV_VDD_PLLU1_ODM_ID (NV_ODM_GUID('N','V','D','P','L','L','U','1')) -#define NV_VDD_PLLHDMI_ODM_ID (NV_ODM_GUID('N','V','D','P','L','L','H','D')) -#define NV_VDD_OSC_ODM_ID (NV_ODM_GUID('N','V','D','D','_','O','S','C')) -#define NV_VDD_PLLS_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','S')) -#define NV_VDD_PLLX_ODM_ID (NV_ODM_GUID('N','V','D','D','P','L','L','X')) -#define NV_VDD_PLL_USB_ODM_ID (NV_ODM_GUID('N','V','D','P','L','L','U','S')) -#define NV_VDD_PLL_PEX_ODM_ID (NV_ODM_GUID('N','V','D','P','L','L','P','X')) - -#define NV_VDD_SYS_ODM_ID (NV_ODM_GUID('N','V','D','D','_','S','Y','S')) -#define NV_VDD_USB_ODM_ID (NV_ODM_GUID('N','V','D','D','_','U','S','B')) -#define NV_VDD_HDMI_ODM_ID (NV_ODM_GUID('N','V','D','D','H','D','M','I')) -#define NV_VDD_MIPI_ODM_ID (NV_ODM_GUID('N','V','D','D','M','I','P','I')) -#define NV_VDD_LCD_ODM_ID (NV_ODM_GUID('N','V','D','D','_','L','C','D')) -#define NV_VDD_AUD_ODM_ID (NV_ODM_GUID('N','V','D','D','_','A','U','D')) -#define NV_VDD_DDR_ODM_ID (NV_ODM_GUID('N','V','D','D','_','D','D','R')) -#define NV_VDD_DDR_RX_ODM_ID (NV_ODM_GUID('N','V','D','D','D','R','R','X')) -#define NV_VDD_NAND_ODM_ID (NV_ODM_GUID('N','V','D','D','N','A','N','D')) -#define NV_VDD_UART_ODM_ID (NV_ODM_GUID('N','V','D','D','U','A','R','T')) -#define NV_VDD_SDIO_ODM_ID (NV_ODM_GUID('N','V','D','D','S','D','I','O')) -#define NV_VDD_VDAC_ODM_ID (NV_ODM_GUID('N','V','D','D','V','D','A','C')) -#define NV_VDD_VI_ODM_ID (NV_ODM_GUID('N','V','D','D','_','_','V','I')) -#define NV_VDD_BB_ODM_ID (NV_ODM_GUID('N','V','D','D','_','_','B','B')) -#define NV_VDD_VBUS_ODM_ID (NV_ODM_GUID('N','V','D','D','V','B','U','S')) -#define NV_VDD_USB2_VBUS_ODM_ID (NV_ODM_GUID('N','V','D','V','B','U','S','2')) -#define NV_VDD_USB3_VBUS_ODM_ID (NV_ODM_GUID('N','V','D','V','B','U','S','3')) - -#define NV_VDD_HSIC_ODM_ID (NV_ODM_GUID('N','V','D','D','H','S','I','C')) -#define NV_VDD_USB_IC_ODM_ID (NV_ODM_GUID('N','V','D','D','U','S','B','I')) -#define NV_VDD_PEX_ODM_ID (NV_ODM_GUID('N','V','D','D','_','P','E','X')) -#define NV_VDD_PEX_CLK_ODM_ID (NV_ODM_GUID('N','V','D','D','P','E','X','C')) -#define NV_VDD_SoC_ODM_ID (NV_ODM_GUID('N','V','D','D','_','S','O','C')) - -#define NV_PMU_TRANSPORT_ODM_ID (NV_ODM_GUID('N','V','P','M','U','T','R','N')) - -/** - * Some of the NVIDIA driver libraries enumerate peripherals based on the - * logical functionality that the peripheral performs, rather than by the - * bus that connects it. An example of this is the camera driver, which - * enumerates all peripherals supporting camera functionality on an ODM's - * system (depending on the target market, 0, 1, or multiple cameras may - * be present). To support this abstract functionality-based query, each - * peripheral is assigned a class based on the user-level functionality it - * provides. - */ -typedef enum -{ - /// Specifies a display output peripheral, such as an LCD or attached TV. - NvOdmPeripheralClass_Display = 1, - - /// Specifies a camera (imager) input peripheral. - NvOdmPeripheralClass_Imager, - - /// Specifies a mass-storage device, such as a NAND flash controller. - NvOdmPeripheralClass_Storage, - - /// Specifies a human-computer input, such as a keypad or touch panel. - NvOdmPeripheralClass_HCI, - - /// Specifies a peripheral that does not fall into the other classes. - NvOdmPeripheralClass_Other, - - NvOdmPeripheralClass_Num, - /// Ignore -- Forces compilers to make 32-bit enums. - NvOdmPeripheralClass_Force32 = 0x7fffffffUL -} NvOdmPeripheralClass; - -/** - * Defines the unique address on a bus where a peripheral is connected. - */ -typedef struct -{ - /// Specifies the type of bus or I/O (I2C, DAP, GPIO) for this connection. - NvOdmIoModule Interface; - - /** - * Some buses or I/Os on an application processor have multiple instances, - * such as the 3 SPI controllers on AP15, or multiple GPIO ports. This - * value specifies to which instance of a multi-instance bus is the - * peripheral connected. The instance value should be the same value - * passed to the instance parameter in the ODM service APIs (e.g., - * NvOdmI2cOpen()). - * - * @note For GPIOs, this value refers to the GPIO port. - */ - NvU32 Instance; - - /** - * Some buses, such as I2C and SPI, support multiple slave devices on - * a single bus, through the use of peripheral addresses and/or chip - * select signals. This value specifies the appropriate address or chip - * select required to communicate with the peripheral. - * - * @note This value differs depending on usage: - * - For GPIOs, this value specifies the GPIO pin. - * - For VDDs, this value is ODM-defined PMU rail ID. - * - For board designs where the LCD bus is connected to a main - * display and sub-display (e.g., a clam-shell cellular phone), - * address 0 should refer to the main panel, and 1 to the sub-panel. - */ - NvU32 Address; -} NvOdmIoAddress; - -/** - * Defines the full bus connectivity for peripherals connected to the - * application processor. - */ -typedef struct -{ - /// The ODM-defined 64-bit GUID that identifies this peripheral. - NvU64 Guid; - - /** - * The list of all I/Os and buses connecting this peripheral to the AP. - * @see NvOdmIoAddress - */ - const NvOdmIoAddress *AddressList; - - /// The number of entries in the \a addressList array. - NvU32 NumAddress; - - /// The functionality class of this peripheral. - NvOdmPeripheralClass Class; -} NvOdmPeripheralConnectivity; - - -/// Defines different criteria for searching through the peripheral database. -typedef enum -{ - /// Searches for peripherals that are members of the specified class. - NvOdmPeripheralSearch_PeripheralClass, - - /// Searches for peripherals connected to the specified I/O module. - NvOdmPeripheralSearch_IoModule, - - /** - * Searches for peripherals connected to the specified bus instance. - * - * @note This value will be compared against all entries in \a addressList. - */ - NvOdmPeripheralSearch_Instance, - - /** - * Searches for peripherals matching the specified address or chip select. - * - * @note This value will be compared against all entries in \a addressList. - */ - NvOdmPeripheralSearch_Address, - - NvOdmPeripheralSearch_Num, - /** Ignore -- Forces compilers to make 32-bit enums. */ - NvOdmPeripheralSearch_Force32 = 0x7fffffffUL -} NvOdmPeripheralSearch; - -/** - * Defines the data structure that describes each sub-assembly of the - * development platform. This data is read from EEPROMs on each of the sub- - * assemblies, which is saved with the following format: - * 
- *      E-xxxx-yyyy-0zz XN
- *
- * - * Where: - * - * - xxxx is the board ID number 0-9999 (2 byte number) - * - yyyy is the SKU number 0-9999 (2 byte number) - * - zz is the FAB number 0-99 (1 byte number) - * - X is the major revision, (1 byte ASCII character), e.g., 'A', 'B', etc. - * - N is the minor revision, (1 byte number, 0 - 9) - */ -typedef struct -{ - /// Specifies the board number. - NvU16 BoardID; - - /// Specifies the SKU number. - NvU16 SKU; - - /// Specifies the FAB number. - NvU8 Fab; - - /// Specifies the part revision. - NvU8 Revision; - - /// Specifies the minor revision level - NvU8 MinorRevision; -} NvOdmBoardInfo; - -/** - * Searches through the database of connected peripherals for peripherals - * matching the specified search criteria. - * - * Search criteria are supplied by paired attribute-value lists; if multiple - * criteria are specified, the returned peripherals represent the intersection - * (boolean AND) of the supplied search criteria. - * - * This function is expected to be called twice with the same search criteria. - * In the first call, \a guidList should be NULL. The number of peripherals - * matching the search criteria will be returned. - * - * In the second call, \a guidList should point to an array of NvU64s; the GUIDs - * of up to \a numGuids peripherals matching the search critiera will be written - * to \a guidList. The number of stored GUIDs will be returned. - * - * @param searchAttrs The array of search attributes (::NvOdmPeripheralSearch). - * @param searchVals The array of values for each search attribute. - * @param numCriteria The number of entries in the attribute-value lists. - * @param guidList The array of output GUIDs. If NULL, no GUIDs are returned. - * @param numGuids The number of entries in \a guidList. - * @return The number of GUIDs written to \a guidList, or the total number of - * peripherals matching the search criteria if \a guidList is NULL. - */ -NvU32 -NvOdmPeripheralEnumerate( - const NvOdmPeripheralSearch *searchAttrs, - const NvU32 *searchVals, - NvU32 numCriteria, - NvU64 *guidList, - NvU32 numGuids); - -/** - * Searches through the database of connected peripherals for the peripheral - * matching the specified GUID and returns that peripheral's connectivity - * structure. - * - * @note If the ODM system supports hot-pluggable peripherals (e.g., an - * external TV-out display), the connectivity structure should only be returned - * when the peripheral is useable by the NVIDIA driver libraries. If hot-plug - * detection is not supported, the peripheral's connectivity structure may - * always be returned. - * - * @see NvOdmPeripheralConnectivity - * - * @param searchGuid The GUID value of the queried peripheral. - * - * @return A pointer to the peripheral's bus connectivity structure if a - * peripheral matching \a searchGuid is found, or NULL if no peripheral is found. - */ -const NvOdmPeripheralConnectivity * -NvOdmPeripheralGetGuid(NvU64 searchGuid); - -/** - * Gets the ::NvOdmBoardInfo data structure values for the given board ID. - * - * @param BoardId Identifies the board for which the BoardInfo data is to be retrieved. - * @note The \a BoardId is in Binary Encoded Decimal (BCD) format. For example, - * E920 is identified by a \a BoardId of 0x0920 and E9820 would be 0x9820. - * @param pBoardInfo A pointer to the location where the requested \a BoardInfo data - * shall be saved. - * - * @return NV_TRUE if successful, or NV_FALSE otherwise. - */ -NvBool -NvOdmPeripheralGetBoardInfo( - NvU16 BoardId, - NvOdmBoardInfo* pBoardInfo); - -#if defined(__cplusplus) -} -#endif - -/** @} */ - -#endif // INCLUDED_NVODM_QUERY_DISCOVERY_H -- 2.34.1