Index: arch/arm/mach-tegra/nv/include/nvrm_pinmux.h |
diff --git a/arch/arm/mach-tegra/nv/include/nvrm_pinmux.h b/arch/arm/mach-tegra/nv/include/nvrm_pinmux.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..bafe6a2655b47a2109463484970ef7b5b140801c |
--- /dev/null |
+++ b/arch/arm/mach-tegra/nv/include/nvrm_pinmux.h |
@@ -0,0 +1,222 @@ |
+/* |
+ * Copyright (c) 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. |
+ * |
+ */ |
+ |
+#ifndef INCLUDED_nvrm_pinmux_H |
+#define INCLUDED_nvrm_pinmux_H |
+ |
+ |
+#if defined(__cplusplus) |
+extern "C" |
+{ |
+#endif |
+ |
+#include "nvrm_module.h" |
+#include "nvrm_init.h" |
+ |
+#include "nvodm_modules.h" |
+ |
+/** |
+ * For each module that has pins (an I/O module), there may be several muxing |
+ * configurations. This allows a driver to select or query a particular |
+ * configuration per I/O module. I/O modules may be instantiated on the |
+ * chip multiple times. |
+ * |
+ * Certain combinations of modules configurations may not be physically |
+ * possible; say that a hypothetical SPI controller configuration 3 uses pins |
+ * that are shared by a hypothectial UART configuration 2. Presently, these |
+ * conflicting configurations are managed via an external tool provided by |
+ * SysEng, which identifies the configurations for the ODM pin-mux tables |
+ * depending upon choices made by the ODM. |
+ */ |
+ |
+/** |
+ * Sets the module to tristate configuration. |
+ * Use enable to release the pinmux. The pins will be |
+ * tri-stated when not in use to save power. |
+ * |
+ * @param hDevice The RM instance |
+ * @param RmModule The module to set |
+ * @param EnableTristate NV_TRUE will tristate the specified pins, NV_FALSE will un-tristate |
+ */ |
+ |
+ NvError NvRmSetModuleTristate( |
+ NvRmDeviceHandle hDevice, |
+ NvRmModuleID RmModule, |
+ NvBool EnableTristate ); |
+ |
+/** |
+ * Sets an ODM module ID to tristate configuration. Analagous to @see NvRmSetModuleTristate, |
+ * but indexed based on the ODM module ID, rather than the controller ID. |
+ * |
+ * @param hDevice The RM instance |
+ * @param OdmModule The module to set (should be of type NvOdmIoModule) |
+ * @param OdmInstance The instance of the module to set |
+ * @param EnableTristate NV_TRUE will tristate the specified pins, NV_FALSE will un-tristate |
+ */ |
+ |
+ NvError NvRmSetOdmModuleTristate( |
+ NvRmDeviceHandle hDevice, |
+ NvU32 OdmModule, |
+ NvU32 OdmInstance, |
+ NvBool EnableTristate ); |
+ |
+/** |
+ * Configures modules which can provide clock sources to peripherals. |
+ * If a Tegra application processor is expected to provide a clock source |
+ * to an external peripheral, this API should be called to configure the |
+ * clock source and to ensure that its pins are driven prior to attempting |
+ * to program the peripheral through a command interface (e.g., SPI). |
+ * |
+ * @param hDevice The RM instance |
+ * @param IoModule The module to set, must be NvOdmIoModule_ExternalClock |
+ * @param Instance The instance of the I/O module to be set. |
+ * @param Config The pin map configuration for the I/O module. |
+ * @param EnableTristate NV_TRUE will tristate the specified clock source, |
+ * NV_FALSE will drive it. |
+ * |
+ * @retval Returns the clock frequency, in KHz, that is output on the |
+ * designated pin (or '0' if no clock frequency is specified or found). |
+ */ |
+ |
+ NvU32 NvRmExternalClockConfig( |
+ NvRmDeviceHandle hDevice, |
+ NvU32 IoModule, |
+ NvU32 Instance, |
+ NvU32 Config, |
+ NvBool EnableTristate ); |
+ |
+typedef struct NvRmModuleSdmmcInterfaceCapsRec |
+{ |
+ |
+ /// Maximum bus width supported by the physical interface |
+ /// Will be 2, 4 or 8 depending on the selected pin mux |
+ NvU32 MmcInterfaceWidth; |
+} NvRmModuleSdmmcInterfaceCaps; |
+ |
+typedef struct NvRmModulePcieInterfaceCapsRec |
+{ |
+ |
+ /// Maximum bus type supported by the physical interface |
+ /// Will be 4X1 or 2X2 depending on the selected pin mux |
+ NvU32 PcieNumEndPoints; |
+ NvU32 PcieLanesPerEp; |
+} NvRmModulePcieInterfaceCaps; |
+ |
+typedef struct NvRmModulePwmInterfaceCapsRec |
+{ |
+ |
+ /// The OR bits value of PWM Output IDs supported by the |
+ /// physical interface depending on the selected pin mux. |
+ /// Hence, PwmOutputId_PWM0 = bit 0, PwmOutputId_PWM1 = bit 1, |
+ /// PwmOutputId_PWM2 = bit 2, PwmOutputId_PWM3 = bit 3 |
+ NvU32 PwmOutputIdSupported; |
+} NvRmModulePwmInterfaceCaps; |
+ |
+typedef struct NvRmModuleNandInterfaceCapsRec |
+{ |
+ |
+ /// Maximum bus width supported by the physical interface |
+ /// Will be 8 or 16 depending on the selected pin mux |
+ NvU8 NandInterfaceWidth; |
+ NvBool IsCombRbsyMode; |
+} NvRmModuleNandInterfaceCaps; |
+ |
+typedef struct NvRmModuleUartInterfaceCapsRec |
+{ |
+ |
+ /// Maximum number of the interface lines supported by the physical interface. |
+ /// Will be 0, 2, 4 or 8 depending on the selected pin mux. |
+ /// 0 means there is no physical interface for the uart. |
+ /// 2 means only rx/tx lines are supported. |
+ /// 4 means only rx/tx/rtx/cts lines are supported. |
+ /// 8 means full modem lines are supported. |
+ NvU32 NumberOfInterfaceLines; |
+} NvRmModuleUartInterfaceCaps; |
+ |
+/** |
+ * @brief Query the board-defined capabilities of an I/O controller |
+ * |
+ * This API will return capabilities for controller modules based on |
+ * interface properties defined by ODM query interfaces, such as the |
+ * pin mux query. |
+ * |
+ * pCap should be a pointer to the matching NvRmxxxInterfaceCaps structure |
+ * (defined above) for the ModuleId, and CapStructSize should be |
+ * the sizeof(structure type). and also should be word aligned. |
+ * |
+ * @retval NvError_NotSupported if the specified ModuleID does not |
+ * exist on the current platform. |
+ */ |
+ |
+ NvError NvRmGetModuleInterfaceCapabilities( |
+ NvRmDeviceHandle hRm, |
+ NvRmModuleID ModuleId, |
+ NvU32 CapStructSize, |
+ void* pCaps ); |
+ |
+/** |
+ * Defines SoC strap groups. |
+ */ |
+ |
+typedef enum |
+{ |
+ |
+ /// ram_code strap group |
+ NvRmStrapGroup_RamCode = 1, |
+ NvRmStrapGroup_Num, |
+ NvRmStrapGroup_Force32 = 0x7FFFFFFF |
+} NvRmStrapGroup; |
+ |
+/** |
+ * Gets SoC strap value for the given strap group. |
+ * |
+ * @param hDevice The RM instance |
+ * @param StrapGroup Strap group to be read. |
+ * @pStrapValue A pointer to the returned strap group value. |
+ * |
+ * @retval NvSuccess if strap value is read successfully |
+ * @retval NvError_NotSupported if the specified strap group does not |
+ * exist on the current SoC. |
+ */ |
+ |
+ NvError NvRmGetStraps( |
+ NvRmDeviceHandle hDevice, |
+ NvRmStrapGroup StrapGroup, |
+ NvU32 * pStrapValue ); |
+ |
+/** @} */ |
+ |
+#if defined(__cplusplus) |
+} |
+#endif |
+ |
+#endif |