//############################################################################# // // FILE: empty_sysconfig_main.c // // TITLE: Empty Pinmux Example // // Empty SysCfg & Driverlib Example // // This example is an empty project setup for SysConfig and Driverlib // development. // //############################################################################# // // // $Copyright: // Copyright (C) 2013-2024 Texas Instruments Incorporated - http://www.ti.com/ // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //############################################################################# // // Included Files // //############################################################################# // // FILE: driverlib.h // // TITLE: C28x Driverlib Header File // //############################################################################# // // $Release Date: $ // $Copyright: // Copyright (C) 2013-2024 Texas Instruments Incorporated - http://www.ti.com/ // // 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 Texas Instruments Incorporated 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 // OWNER 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: hw_memmap.h // // TITLE: Macros defining the memory map of the C28x. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // The following are defines for the base address of the memories and // peripherals. // //***************************************************************************** //########################################################################### // // FILE: adc.h // // TITLE: C28x ADC driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup adc_api ADC //! @{ // //***************************************************************************** /* * Copyright (c) 2000 Jeroen Ruigrok van der Werven * All rights reserved. * * Copyright (c) 2014-2014 Texas Instruments Incorporated * * 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. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. * * $FreeBSD: release/10.0.0/include/stdbool.h 228878 2011-12-25 20:15:41Z ed $ */ /* If this file is included in C99 mode, _Bool is a builtin, so no definition. */ /* If this is C89 mode and this file is included, _Bool is pre-defined in C89 */ /* relaxed mode by the EDG parser, so it needs to be defined in strict mode. */ /*****************************************************************************/ /* _ti_config.h */ /* */ /* Copyright (c) 2017 Texas Instruments Incorporated */ /* http://www.ti.com/ */ /* */ /* 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 Texas Instruments Incorporated 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 */ /* OWNER 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. */ /* */ /*****************************************************************************/ /*Unsupported pragmas are omitted */ # pragma diag_push # pragma CHECK_MISRA("-19.7") # pragma CHECK_MISRA("-19.4") # pragma CHECK_MISRA("-19.1") # pragma CHECK_MISRA("-19.15") # pragma diag_pop _Pragma("diag_push") _Pragma("CHECK_MISRA(\"-19.4\")") _Pragma("CHECK_MISRA(\"-19.1\")") _Pragma("CHECK_MISRA(\"-19.6\")") /* Hide uses of the TI proprietary macros behind other macros. Implementations that don't implement these features should leave these macros undefined. */ /* Common definitions */ /* C */ /* C89/C99 */ /* _TI_NOEXCEPT_CPP14 is defined to noexcept only when compiling for C++14. It is intended to be used for functions like abort and atexit that are supposed to be declared noexcept only in C++14 mode. */ /* Target-specific definitions */ /*****************************************************************************/ /* linkage.h */ /* */ /* Copyright (c) 1998 Texas Instruments Incorporated */ /* http://www.ti.com/ */ /* */ /* 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 Texas Instruments Incorporated 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 */ /* OWNER 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. */ /* */ /*****************************************************************************/ #pragma diag_push #pragma CHECK_MISRA("-19.4") /* macros required for implementation */ /* No modifiers needed to access code */ /*--------------------------------------------------------------------------*/ /* Define _DATA_ACCESS ==> how to access RTS global or static data */ /*--------------------------------------------------------------------------*/ /*--------------------------------------------------------------------------*/ /* Define _OPTIMIZE_FOR_SPACE ==> Always optimize for space. */ /*--------------------------------------------------------------------------*/ /*--------------------------------------------------------------------------*/ /* Define _IDECL ==> how inline functions are declared */ /*--------------------------------------------------------------------------*/ #pragma diag_pop _Pragma("diag_pop") _Pragma("diag_push") _Pragma("CHECK_MISRA(\"-19.4\")") _Pragma("CHECK_MISRA(\"-19.11\")") _Pragma("diag_pop") /*****************************************************************************/ /* STDINT.H */ /* */ /* Copyright (c) 2002 Texas Instruments Incorporated */ /* http://www.ti.com/ */ /* */ /* 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 Texas Instruments Incorporated 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 */ /* OWNER 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. */ /* */ /*****************************************************************************/ _Pragma("diag_push") _Pragma("CHECK_MISRA(\"-19.1\")") /* no code before #include */ _Pragma("CHECK_MISRA(\"-19.7\")") /* prefer functions to macros */ /*****************************************************************************/ /* _STDINT40.H */ /* */ /* Copyright (c) 2018 Texas Instruments Incorporated */ /* http://www.ti.com/ */ /* */ /* 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 Texas Instruments Incorporated 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 */ /* OWNER 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. */ /* */ /*****************************************************************************/ _Pragma("diag_push") _Pragma("CHECK_MISRA(\"-19.7\")") /* prefer functions to macros */ /* According to footnotes in the 1999 C standard, "C++ implementations should define these macros only when __STDC_LIMIT_MACROS is defined before is included." */ _Pragma("diag_pop") /*- * SPDX-License-Identifier: BSD-2-Clause-FreeBSD * * Copyright (c) 2001 Mike Barcroft * All rights reserved. * * 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. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. * * $FreeBSD$ */ /*- * SPDX-License-Identifier: BSD-3-Clause * * Copyright (c) 1991, 1993 * The Regents of the University of California. All rights reserved. * * This code is derived from software contributed to Berkeley by * Berkeley Software Design, Inc. * * 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. Neither the name of the University 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 REGENTS 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 REGENTS 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. * * @(#)cdefs.h 8.8 (Berkeley) 1/9/95 * $FreeBSD$ */ _Pragma("diag_push") _Pragma("CHECK_MISRA(\"none\")") /* * Testing against Clang-specific extensions. */ /* * This code has been put in place to help reduce the addition of * compiler specific defines in FreeBSD code. It helps to aid in * having a compiler-agnostic source tree. */ /* * Macro to test if we're using a specific version of gcc or later. */ /* * The __CONCAT macro is used to concatenate parts of symbol names, e.g. * with "#define OLD(foo) __CONCAT(old,foo)", OLD(foo) produces oldfoo. * The __CONCAT macro is a bit tricky to use if it must work in non-ANSI * mode -- there must be no spaces between its arguments, and for nested * __CONCAT's, all the __CONCAT's must be at the left. __CONCAT can also * concatenate double-quoted strings produced by the __STRING macro, but * this only works with ANSI C. * * __XSTRING is like __STRING, but it expands any macros in its argument * first. It is only available with ANSI C. */ /* * Compiler-dependent macros to help declare dead (non-returning) and * pure (no side effects) functions, and unused variables. They are * null except for versions of gcc that are known to support the features * properly (old versions of gcc-2 supported the dead and pure features * in a different (wrong) way). If we do not provide an implementation * for a given compiler, let the compile fail if it is told to use * a feature that we cannot live without. */ /* * TI ADD - check that __GNUC__ is defined before referencing it to avoid * generating an error when __GNUC__ treated as zero warning is * promoted to an error via -pdse195 option. */ /* * Keywords added in C11. */ /* * No native support for _Atomic(). Place object in structure to prevent * most forms of direct non-atomic access. */ /* * XXX: Some compilers (Clang 3.3, GCC 4.7) falsely announce C++11 mode * without actually supporting the thread_local keyword. Don't check for * the presence of C++11 when defining _Thread_local. */ /* * Emulation of C11 _Generic(). Unlike the previously defined C11 * keywords, it is not possible to implement this using exactly the same * syntax. Therefore implement something similar under the name * __generic(). Unlike _Generic(), this macro can only distinguish * between a single type, so it requires nested invocations to * distinguish multiple cases. */ /* * C99 Static array indices in function parameter declarations. Syntax such as: * void bar(int myArray[static 10]); * is allowed in C99 but not in C++. Define __min_size appropriately so * headers using it can be compiled in either language. Use like this: * void bar(int myArray[__min_size(10)]); */ /* XXX: should use `#if __STDC_VERSION__ < 199901'. */ /* C++11 exposes a load of C99 stuff */ /* * GCC 2.95 provides `__restrict' as an extension to C90 to support the * C99-specific `restrict' type qualifier. We happen to use `__restrict' as * a way to define the `restrict' type qualifier without disturbing older * software that is unaware of C99 keywords. * The TI compiler supports __restrict in all compilation modes. */ /* * GNU C version 2.96 adds explicit branch prediction so that * the CPU back-end can hint the processor and also so that * code blocks can be reordered such that the predicted path * sees a more linear flow, thus improving cache behavior, etc. * * The following two macros provide us with a way to utilize this * compiler feature. Use __predict_true() if you expect the expression * to evaluate to true, and __predict_false() if you expect the * expression to evaluate to false. * * A few notes about usage: * * * Generally, __predict_false() error condition checks (unless * you have some _strong_ reason to do otherwise, in which case * document it), and/or __predict_true() `no-error' condition * checks, assuming you want to optimize for the no-error case. * * * Other than that, if you don't know the likelihood of a test * succeeding from empirical or other `hard' evidence, don't * make predictions. * * * These are meant to be used in places that are run `a lot'. * It is wasteful to make predictions in code that is run * seldomly (e.g. at subsystem initialization time) as the * basic block reordering that this affects can often generate * larger code. */ /* * We define this here since , , and * require it. */ /* * Given the pointer x to the member m of the struct s, return * a pointer to the containing structure. When using GCC, we first * assign pointer x to a local variable, to check that its type is * compatible with member m. */ /* * Compiler-dependent macros to declare that functions take printf-like * or scanf-like arguments. They are null except for versions of gcc * that are known to support the features properly (old versions of gcc-2 * didn't permit keeping the keywords out of the application namespace). */ /* Compiler-dependent macros that rely on FreeBSD-specific extensions. */ /* * The following definition might not work well if used in header files, * but it should be better than nothing. If you want a "do nothing" * version, then it should generate some harmless declaration, such as: * #define __IDSTRING(name,string) struct __hack */ /* * Embed the rcs id of a source file in the resulting library. Note that in * more recent ELF binutils, we use .ident allowing the ID to be stripped. * Usage: * __FBSDID("$FreeBSD$"); */ /*- * The following definitions are an extension of the behavior originally * implemented in , but with a different level of granularity. * POSIX.1 requires that the macros we test be defined before any standard * header file is included. * * Here's a quick run-down of the versions: * defined(_POSIX_SOURCE) 1003.1-1988 * _POSIX_C_SOURCE == 1 1003.1-1990 * _POSIX_C_SOURCE == 2 1003.2-1992 C Language Binding Option * _POSIX_C_SOURCE == 199309 1003.1b-1993 * _POSIX_C_SOURCE == 199506 1003.1c-1995, 1003.1i-1995, * and the omnibus ISO/IEC 9945-1: 1996 * _POSIX_C_SOURCE == 200112 1003.1-2001 * _POSIX_C_SOURCE == 200809 1003.1-2008 * * In addition, the X/Open Portability Guide, which is now the Single UNIX * Specification, defines a feature-test macro which indicates the version of * that specification, and which subsumes _POSIX_C_SOURCE. * * Our macros begin with two underscores to avoid namespace screwage. */ /* Deal with IEEE Std. 1003.1-1990, in which _POSIX_C_SOURCE == 1. */ /* Deal with IEEE Std. 1003.2-1992, in which _POSIX_C_SOURCE == 2. */ /* Deal with various X/Open Portability Guides and Single UNIX Spec. */ /* * Deal with all versions of POSIX. The ordering relative to the tests above is * important. */ /*- * Deal with _ANSI_SOURCE: * If it is defined, and no other compilation environment is explicitly * requested, then define our internal feature-test macros to zero. This * makes no difference to the preprocessor (undefined symbols in preprocessing * expressions are defined to have value zero), but makes it more convenient for * a test program to print out the values. * * If a program mistakenly defines _ANSI_SOURCE and some other macro such as * _POSIX_C_SOURCE, we will assume that it wants the broader compilation * environment (and in fact we will never get here). */ /* User override __EXT1_VISIBLE */ /* * Old versions of GCC use non-standard ARM arch symbols; acle-compat.h * translates them to __ARM_ARCH and the modern feature symbols defined by ARM. */ /* * Nullability qualifiers: currently only supported by Clang. */ /* * Type Safety Checking * * Clang provides additional attributes to enable checking type safety * properties that cannot be enforced by the C type system. */ /* * Lock annotations. * * Clang provides support for doing basic thread-safety tests at * compile-time, by marking which locks will/should be held when * entering/leaving a functions. * * Furthermore, it is also possible to annotate variables and structure * members to enforce that they are only accessed when certain locks are * held. */ /* Structure implements a lock. */ /* Function acquires an exclusive or shared lock. */ /* Function attempts to acquire an exclusive or shared lock. */ /* Function releases a lock. */ /* Function asserts that an exclusive or shared lock is held. */ /* Function requires that an exclusive or shared lock is or is not held. */ /* Function should not be analyzed. */ /* Guard variables and structure members by lock. */ _Pragma("diag_pop") /*- * SPDX-License-Identifier: BSD-2-Clause-FreeBSD * * Copyright (c) 2002 Mike Barcroft * All rights reserved. * * 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. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. * * $FreeBSD$ */ /*****************************************************************************/ /* _TYPES.H */ /* */ /* Copyright (c) 2017 Texas Instruments Incorporated */ /* http://www.ti.com/ */ /* */ /* 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 Texas Instruments Incorporated 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 */ /* OWNER 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. */ /* */ /*****************************************************************************/ #pragma diag_push /* This file is required to use base types */ #pragma CHECK_MISRA("-6.3") /* * Basic types upon which most other types are built. */ typedef int __int16_t; typedef unsigned int __uint16_t; typedef long __int32_t; typedef unsigned long __uint32_t; /* LONGLONG */ typedef long long __int64_t; /* LONGLONG */ typedef unsigned long long __uint64_t; /* * Standard type definitions. */ typedef __uint32_t __clock_t; /* clock()... */ typedef __int32_t __critical_t; typedef double __double_t; typedef float __float_t; typedef __int32_t __intfptr_t; typedef __int64_t __intmax_t; typedef __int32_t __intptr_t; typedef __int16_t __int_fast8_t; typedef __int16_t __int_fast16_t; typedef __int32_t __int_fast32_t; typedef __int64_t __int_fast64_t; typedef __int16_t __int_least8_t; typedef __int16_t __int_least16_t; typedef __int32_t __int_least32_t; typedef __int64_t __int_least64_t; typedef long __ptrdiff_t; /* ptr1 - ptr2 */ typedef __int16_t __register_t; typedef __int32_t __segsz_t; /* segment size (in pages) */ typedef unsigned long __size_t; /* sizeof() */ typedef __int32_t __ssize_t; /* byte count or error */ typedef __int64_t __time_t; /* time()... */ typedef __uint32_t __uintfptr_t; typedef __uint64_t __uintmax_t; typedef __uint32_t __uintptr_t; typedef __uint16_t __uint_fast8_t; typedef __uint16_t __uint_fast16_t; typedef __uint32_t __uint_fast32_t; typedef __uint64_t __uint_fast64_t; typedef __uint16_t __uint_least8_t; typedef __uint16_t __uint_least16_t; typedef __uint32_t __uint_least32_t; typedef __uint64_t __uint_least64_t; typedef __uint16_t __u_register_t; typedef __uint32_t __vm_offset_t; typedef __uint32_t __vm_paddr_t; typedef __uint32_t __vm_size_t; typedef unsigned long ___wchar_t; /* * POSIX target specific _off_t type definition */ typedef long int _off_t; /* * Unusual type definitions. */ typedef char* __va_list; #pragma diag_pop _Pragma("diag_push") /* This file is required to use types without size and signedness */ _Pragma("CHECK_MISRA(\"-6.3\")") /* * Standard type definitions. */ typedef __int32_t __blksize_t; /* file block size */ typedef __int64_t __blkcnt_t; /* file block count */ typedef __int32_t __clockid_t; /* clock_gettime()... */ typedef __uint32_t __fflags_t; /* file flags */ typedef __uint64_t __fsblkcnt_t; typedef __uint64_t __fsfilcnt_t; typedef __uint32_t __gid_t; typedef __int64_t __id_t; /* can hold a gid_t, pid_t, or uid_t */ typedef __uint64_t __ino_t; /* inode number */ typedef long __key_t; /* IPC key (for Sys V IPC) */ typedef __int32_t __lwpid_t; /* Thread ID (a.k.a. LWP) */ typedef __uint16_t __mode_t; /* permissions */ typedef int __accmode_t; /* access permissions */ typedef int __nl_item; typedef __uint64_t __nlink_t; /* link count */ typedef _off_t __off_t; /* file offset (target-specific) */ typedef __int64_t __off64_t; /* file offset (always 64-bit) */ typedef __int32_t __pid_t; /* process [group] */ typedef __int64_t __rlim_t; /* resource limit - intentionally */ /* signed, because of legacy code */ /* that uses -1 for RLIM_INFINITY */ typedef __uint16_t __sa_family_t; typedef __uint32_t __socklen_t; typedef long __suseconds_t; /* microseconds (signed) */ typedef struct __timer *__timer_t; /* timer_gettime()... */ typedef struct __mq *__mqd_t; /* mq_open()... */ typedef __uint32_t __uid_t; typedef unsigned int __useconds_t; /* microseconds (unsigned) */ typedef int __cpuwhich_t; /* which parameter for cpuset. */ typedef int __cpulevel_t; /* level parameter for cpuset. */ typedef int __cpusetid_t; /* cpuset identifier. */ /* * Unusual type definitions. */ /* * rune_t is declared to be an ``int'' instead of the more natural * ``unsigned long'' or ``long''. Two things are happening here. It is not * unsigned so that EOF (-1) can be naturally assigned to it and used. Also, * it looks like 10646 will be a 31 bit standard. This means that if your * ints cannot hold 32 bits, you will be in trouble. The reason an int was * chosen over a long is that the is*() and to*() routines take ints (says * ANSI C), but they use __ct_rune_t instead of int. * * NOTE: rune_t is not covered by ANSI nor other standards, and should not * be instantiated outside of lib/libc/locale. Use wchar_t. wint_t and * rune_t must be the same type. Also, wint_t should be able to hold all * members of the largest character set plus one extra value (WEOF), and * must be at least 16 bits. */ typedef unsigned long __ct_rune_t; /* arg type for ctype funcs */ typedef __ct_rune_t __rune_t; /* rune_t (see above) */ typedef __ct_rune_t __wint_t; /* wint_t (see above) */ /* Clang already provides these types as built-ins, but only in C++ mode. */ typedef __uint_least16_t __char16_t; typedef __uint_least32_t __char32_t; /* In C++11, char16_t and char32_t are built-in types. */ typedef struct { long long __max_align1 __attribute__((aligned(__alignof__(long long)))); long double __max_align2 __attribute__((aligned(__alignof__(long double)))); } __max_align_t; typedef __uint64_t __dev_t; /* device number */ typedef __uint32_t __fixpt_t; /* fixed point number */ /* * mbstate_t is an opaque object to keep conversion state during multibyte * stream conversions. */ typedef int _Mbstatet; typedef _Mbstatet __mbstate_t; typedef __uintmax_t __rman_res_t; /* * When the following macro is defined, the system uses 64-bit inode numbers. * Programs can use this to avoid including , with its associated * namespace pollution. */ _Pragma("diag_pop") /*****************************************************************************/ /* _STDINT.H */ /* */ /* Copyright (c) 2019 Texas Instruments Incorporated */ /* http://www.ti.com/ */ /* */ /* 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 Texas Instruments Incorporated 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 */ /* OWNER 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. */ /* */ /*****************************************************************************/ /*- * SPDX-License-Identifier: BSD-2-Clause-NetBSD * * Copyright (c) 2001, 2002 Mike Barcroft * Copyright (c) 2001 The NetBSD Foundation, Inc. * All rights reserved. * * This code is derived from software contributed to The NetBSD Foundation * by Klaus Klein. * * 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. * * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. 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 FOUNDATION 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. * * $FreeBSD$ */ #pragma diag_push /* 19.4 is issued for macros that are defined in terms of other macros. */ #pragma CHECK_MISRA("-19.4") #pragma CHECK_MISRA("-19.7") #pragma CHECK_MISRA("-19.13") /* * ISO/IEC 9899:1999 * 7.18.2.1 Limits of exact-width integer types */ /* Minimum values of exact-width signed integer types. */ /* Maximum values of exact-width signed integer types. */ /* Maximum values of exact-width unsigned integer types. */ /* * ISO/IEC 9899:1999 * 7.18.2.2 Limits of minimum-width integer types */ /* Minimum values of minimum-width signed integer types. */ /* Maximum values of minimum-width signed integer types. */ /* Maximum values of minimum-width unsigned integer types. */ /* * ISO/IEC 9899:1999 * 7.18.2.3 Limits of fastest minimum-width integer types */ /* Minimum values of fastest minimum-width signed integer types. */ /* Maximum values of fastest minimum-width signed integer types. */ /* Maximum values of fastest minimum-width unsigned integer types. */ /* * ISO/IEC 9899:1999 * 7.18.2.4 Limits of integer types capable of holding object pointers */ /* * ISO/IEC 9899:1999 * 7.18.2.5 Limits of greatest-width integer types */ /* * ISO/IEC 9899:1999 * 7.18.3 Limits of other integer types */ /* Limits of ptrdiff_t. */ /* Limits of sig_atomic_t. */ /* Limit of size_t. */ /* Limits of wint_t. */ #pragma diag_pop /*- * SPDX-License-Identifier: BSD-2-Clause-FreeBSD * * Copyright (c) 2011 David E. O'Brien * Copyright (c) 2001 Mike Barcroft * All rights reserved. * * 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. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. * * $FreeBSD$ */ typedef __int16_t int16_t; typedef __int32_t int32_t; typedef __int64_t int64_t; typedef __uint16_t uint16_t; typedef __uint32_t uint32_t; typedef __uint64_t uint64_t; typedef __intptr_t intptr_t; typedef __uintptr_t uintptr_t; typedef __intmax_t intmax_t; typedef __uintmax_t uintmax_t; typedef __int_least8_t int_least8_t; typedef __int_least16_t int_least16_t; typedef __int_least32_t int_least32_t; typedef __int_least64_t int_least64_t; typedef __uint_least8_t uint_least8_t; typedef __uint_least16_t uint_least16_t; typedef __uint_least32_t uint_least32_t; typedef __uint_least64_t uint_least64_t; typedef __int_fast8_t int_fast8_t; typedef __int_fast16_t int_fast16_t; typedef __int_fast32_t int_fast32_t; typedef __int_fast64_t int_fast64_t; typedef __uint_fast8_t uint_fast8_t; typedef __uint_fast16_t uint_fast16_t; typedef __uint_fast32_t uint_fast32_t; typedef __uint_fast64_t uint_fast64_t; _Pragma("diag_push") _Pragma("CHECK_MISRA(\"-10.1\")") /* GNU and Darwin define this and people seem to think it's portable */ _Pragma("diag_pop") _Pragma("diag_push") _Pragma("CHECK_MISRA(\"-19.4\")") /* Limits of wchar_t. */ _Pragma("diag_pop") /* ISO/IEC 9899:2011 K.3.4.4 */ _Pragma("diag_pop") //########################################################################### // // FILE: hw_adc.h // // TITLE: Definitions for the ADC registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the ADC register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCCTL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCBURSTCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTFLGCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTOVF register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTOVFCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTSEL1N2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTSEL3N4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOCPRICTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTSOCSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCINTSOCSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOCFLG1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOCFRC1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOCOVF1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOCOVFCLR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC0CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC1CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC2CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC3CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC4CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC5CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC6CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC7CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC8CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC9CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC10CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC11CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC12CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC13CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC14CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOC15CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCEVTSTAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCEVTCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCEVTSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCEVTINTSEL register // //************************************************************************************************* // Enable // Enable // Enable // Enable //************************************************************************************************* // // The following are defines for the bit fields in the ADCOSDETECT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCCOUNTER register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCREV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCOFFTRIM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB1CONFIG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB1STAMP register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB1OFFCAL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB1TRIPHI register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB1TRIPLO register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB2CONFIG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB2STAMP register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB2OFFCAL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB2TRIPHI register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB2TRIPLO register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB3CONFIG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB3STAMP register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB3OFFCAL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB3TRIPHI register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB3TRIPLO register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB4CONFIG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB4STAMP register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB4OFFCAL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB4TRIPHI register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB4TRIPLO register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB1RESULT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB2RESULT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB3RESULT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCPPB4RESULT register // //************************************************************************************************* //########################################################################### // // FILE: hw_sysctl.h // // TITLE: Definitions for the SYSCTL registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the SYSCTL register offsets // //************************************************************************************************* // peripherals: Selects between CLA & DMA //************************************************************************************************* // // The following are defines for the bit fields in the DEVCFGLOCK1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PARTIDL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PARTIDH register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC5 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC6 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC7 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC8 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC9 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC10 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC11 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC12 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC13 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC14 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC15 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC17 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC18 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC19 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DC20 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PERCNF1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FUSEERR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES6 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES7 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES8 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES9 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES11 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES13 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES14 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SOFTPRES16 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL5 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL6 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL7 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL8 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL9 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL11 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL12 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSEL14 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPU2RESCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RSTSTAT register // //************************************************************************************************* // to CPU2 // CPU2 // CPU2 //************************************************************************************************* // // The following are defines for the bit fields in the LPMSTAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SYSDBGCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLKSEM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLKCFGLOCK1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLKSRCCTL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLKSRCCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLKSRCCTL3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SYSPLLCTL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SYSPLLMULT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SYSPLLSTS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXPLLCTL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXPLLMULT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXPLLSTS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SYSCLKDIVSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXCLKDIVSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PERCLKDIVSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XCLKOUTDIVSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LOSPCP register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MCDCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the X1CNT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CPUSYSLOCK1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the IORESTOREADDR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEVERRADDR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR6 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR7 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR8 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR9 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR10 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR11 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR12 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR13 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR14 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCLKCR16 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SECMSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LPMCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPIOLPMSEL0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPIOLPMSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TMR2CLKCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RESC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCSR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the WDCNTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the WDKEY register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the WDCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the WDWCR register // //************************************************************************************************* // functionality //************************************************************************************************* // // The following are defines for the bit fields in the CLA1TASKSRCSELLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DMACHSRCSELLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLA1TASKSRCSEL1 register // //************************************************************************************************* // CLA1 // CLA1 // CLA1 // CLA1 //************************************************************************************************* // // The following are defines for the bit fields in the CLA1TASKSRCSEL2 register // //************************************************************************************************* // CLA1 // CLA1 // CLA1 // CLA1 //************************************************************************************************* // // The following are defines for the bit fields in the DMACHSRCSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DMACHSRCSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SYNCSELECT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ADCSOCOUTSELECT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SYNCSOCLOCK register // //************************************************************************************************* //########################################################################### // // FILE: hw_types.h // // TITLE: Type definitions used in driverlib functions. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // Macros for hardware access // //***************************************************************************** //***************************************************************************** // // SUCCESS and FAILURE for API return value // //***************************************************************************** //***************************************************************************** // // Definition of 8 bit types for USB Driver code to maintain portability // between byte and word addressable cores of C2000 Devices. // //***************************************************************************** typedef uint16_t uint8_t; typedef int16_t int8_t; //**************************************************************************** // // For checking NULL pointers // //**************************************************************************** //***************************************************************************** // // 32-bit & 64-bit float type // //***************************************************************************** typedef float float32_t; typedef double float64_t; //***************************************************************************** // // Emulated Bitbanded write // //***************************************************************************** //***************************************************************************** // // Emulated Bitbanded read // //***************************************************************************** //***************************************************************************** // // Extern compiler intrinsic prototypes. See compiler User's Guide for details. // These are provided to satisfy static analysis tools. The #ifndef is required // because the '&' is for a C++-style reference, and although it is the correct // prototype, it will not build in C code. // //***************************************************************************** // // C++ Bool Compatibility // /* To fix Misra-C errors */ //########################################################################### // // FILE: cpu.h // // TITLE: Useful C28x CPU defines. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** // // External reference to the interrupt flag register (IFR) register // extern __cregister volatile uint16_t IFR; // // External reference to the interrupt enable register (IER) register // extern __cregister volatile uint16_t IER; // // Define to enable interrupts // // // Define to disable interrupts // // // Define to enable debug events // // // Define to disable debug events // // // Define to allow writes to protected registers // // // Define to disable writes to protected registers // // // Define for emulation stop // // // Define for emulation stop // // // Define for no operation // // // Define for putting processor into a low-power mode // //***************************************************************************** // // Extern compiler intrinsic prototypes. See compiler User's Guide for details. // //***************************************************************************** extern void __eallow(void); extern void __edis(void); //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: debug.h // // TITLE: Assert definition macro for debug. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // Prototype for the function that is called when an invalid argument is passed // to an API. This is only used when doing a DEBUG build. It is the // application's responsibility to define the __error__ function. // //***************************************************************************** extern void __error__(const char *filename, uint32_t line); //***************************************************************************** // // The ASSERT macro, which does the actual assertion checking. Typically, this // will be for procedure arguments. // //***************************************************************************** // // When called from C28x application // //***************************************************************************** // // Useful defines used within the driver functions. Not intended for use by // application code. // //***************************************************************************** // // Slope of the temperature sensor based in degrees C in fixed point Q15 format // // // Offset of the temp sensor output at 0 degrees C // //***************************************************************************** // // Values that can be passed to ADC_enablePPBEvent(), ADC_disablePPBEvent(), // ADC_enablePPBEventInterrupt(), ADC_disablePPBEventInterrupt(), and // ADC_clearPPBEventStatus() as the intFlags and evtFlags parameters. They also // make up the enumerated bit field returned by ADC_getPPBEventStatus(). // //***************************************************************************** //***************************************************************************** // // Values that can be passed to ADC_forceMultipleSOC() as socMask parameter. // These values can be OR'd together to trigger multiple SOCs at a time. // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to ADC_setPrescaler() as the \e clkPrescale //! parameter. // //***************************************************************************** typedef enum { ADC_CLK_DIV_1_0 = 0U, //!< ADCCLK = (input clock) / 1.0 ADC_CLK_DIV_2_0 = 2U, //!< ADCCLK = (input clock) / 2.0 ADC_CLK_DIV_2_5 = 3U, //!< ADCCLK = (input clock) / 2.5 ADC_CLK_DIV_3_0 = 4U, //!< ADCCLK = (input clock) / 3.0 ADC_CLK_DIV_3_5 = 5U, //!< ADCCLK = (input clock) / 3.5 ADC_CLK_DIV_4_0 = 6U, //!< ADCCLK = (input clock) / 4.0 ADC_CLK_DIV_4_5 = 7U, //!< ADCCLK = (input clock) / 4.5 ADC_CLK_DIV_5_0 = 8U, //!< ADCCLK = (input clock) / 5.0 ADC_CLK_DIV_5_5 = 9U, //!< ADCCLK = (input clock) / 5.5 ADC_CLK_DIV_6_0 = 10U, //!< ADCCLK = (input clock) / 6.0 ADC_CLK_DIV_6_5 = 11U, //!< ADCCLK = (input clock) / 6.5 ADC_CLK_DIV_7_0 = 12U, //!< ADCCLK = (input clock) / 7.0 ADC_CLK_DIV_7_5 = 13U, //!< ADCCLK = (input clock) / 7.5 ADC_CLK_DIV_8_0 = 14U, //!< ADCCLK = (input clock) / 8.0 ADC_CLK_DIV_8_5 = 15U //!< ADCCLK = (input clock) / 8.5 } ADC_ClkPrescale; //***************************************************************************** // //! Values that can be passed to ADC_setMode() as the \e resolution //! parameter. // //***************************************************************************** typedef enum { ADC_RESOLUTION_12BIT = 0x00U, //!< 12-bit conversion resolution ADC_RESOLUTION_16BIT = 0x40U //!< 16-bit conversion resolution } ADC_Resolution; //***************************************************************************** // //! Values that can be passed to ADC_setMode() as the \e signalMode //! parameter. // //***************************************************************************** typedef enum { ADC_MODE_SINGLE_ENDED = 0x00U, //!< Sample on single pin with VREFLO ADC_MODE_DIFFERENTIAL = 0x80U //!< Sample on pair of pins } ADC_SignalMode; //***************************************************************************** // //! Values that can be passed to ADC_setupSOC() as the \e trigger //! parameter to specify the event that will trigger a conversion to start. //! It is also used with ADC_setBurstModeConfig() and //! ADC_triggerRepeaterSelect(). // //***************************************************************************** typedef enum { ADC_TRIGGER_SW_ONLY = 0U, //!< Software only ADC_TRIGGER_CPU1_TINT0 = 1U, //!< CPU1 Timer 0, TINT0 ADC_TRIGGER_CPU1_TINT1 = 2U, //!< CPU1 Timer 1, TINT1 ADC_TRIGGER_CPU1_TINT2 = 3U, //!< CPU1 Timer 2, TINT2 ADC_TRIGGER_GPIO = 4U, //!< GPIO, ADCEXTSOC ADC_TRIGGER_EPWM1_SOCA = 5U, //!< ePWM1, ADCSOCA ADC_TRIGGER_EPWM1_SOCB = 6U, //!< ePWM1, ADCSOCB ADC_TRIGGER_EPWM2_SOCA = 7U, //!< ePWM2, ADCSOCA ADC_TRIGGER_EPWM2_SOCB = 8U, //!< ePWM2, ADCSOCB ADC_TRIGGER_EPWM3_SOCA = 9U, //!< ePWM3, ADCSOCA ADC_TRIGGER_EPWM3_SOCB = 10U, //!< ePWM3, ADCSOCB ADC_TRIGGER_EPWM4_SOCA = 11U, //!< ePWM4, ADCSOCA ADC_TRIGGER_EPWM4_SOCB = 12U, //!< ePWM4, ADCSOCB ADC_TRIGGER_EPWM5_SOCA = 13U, //!< ePWM5, ADCSOCA ADC_TRIGGER_EPWM5_SOCB = 14U, //!< ePWM5, ADCSOCB ADC_TRIGGER_EPWM6_SOCA = 15U, //!< ePWM6, ADCSOCA ADC_TRIGGER_EPWM6_SOCB = 16U, //!< ePWM6, ADCSOCB ADC_TRIGGER_EPWM7_SOCA = 17U, //!< ePWM7, ADCSOCA ADC_TRIGGER_EPWM7_SOCB = 18U, //!< ePWM7, ADCSOCB ADC_TRIGGER_EPWM8_SOCA = 19U, //!< ePWM8, ADCSOCA ADC_TRIGGER_EPWM8_SOCB = 20U, //!< ePWM8, ADCSOCB ADC_TRIGGER_EPWM9_SOCA = 21U, //!< ePWM9, ADCSOCA ADC_TRIGGER_EPWM9_SOCB = 22U, //!< ePWM9, ADCSOCB ADC_TRIGGER_EPWM10_SOCA = 23U, //!< ePWM10, ADCSOCA ADC_TRIGGER_EPWM10_SOCB = 24U, //!< ePWM10, ADCSOCB ADC_TRIGGER_EPWM11_SOCA = 25U, //!< ePWM11, ADCSOCA ADC_TRIGGER_EPWM11_SOCB = 26U, //!< ePWM11, ADCSOCB ADC_TRIGGER_EPWM12_SOCA = 27U, //!< ePWM12, ADCSOCA ADC_TRIGGER_EPWM12_SOCB = 28U, //!< ePWM12, ADCSOCB ADC_TRIGGER_CPU2_TINT0 = 29U, //!< CPU2 Timer 0, TINT0 ADC_TRIGGER_CPU2_TINT1 = 30U, //!< CPU2 Timer 1, TINT1 ADC_TRIGGER_CPU2_TINT2 = 31U //!< CPU2 Timer 2, TINT2 } ADC_Trigger; //***************************************************************************** // //! Values that can be passed to ADC_setupSOC() as the \e channel //! parameter. This is the input pin on which the signal to be converted is //! located. // //***************************************************************************** typedef enum { ADC_CH_ADCIN0 = 0U, //!< single-ended, ADCIN0 ADC_CH_ADCIN1 = 1U, //!< single-ended, ADCIN1 ADC_CH_ADCIN2 = 2U, //!< single-ended, ADCIN2 ADC_CH_ADCIN3 = 3U, //!< single-ended, ADCIN3 ADC_CH_ADCIN4 = 4U, //!< single-ended, ADCIN4 ADC_CH_ADCIN5 = 5U, //!< single-ended, ADCIN5 ADC_CH_ADCIN6 = 6U, //!< single-ended, ADCIN6 ADC_CH_ADCIN7 = 7U, //!< single-ended, ADCIN7 ADC_CH_ADCIN8 = 8U, //!< single-ended, ADCIN8 ADC_CH_ADCIN9 = 9U, //!< single-ended, ADCIN9 ADC_CH_ADCIN10 = 10U, //!< single-ended, ADCIN10 ADC_CH_ADCIN11 = 11U, //!< single-ended, ADCIN11 ADC_CH_ADCIN12 = 12U, //!< single-ended, ADCIN12 ADC_CH_ADCIN13 = 13U, //!< single-ended, ADCIN13 ADC_CH_ADCIN14 = 14U, //!< single-ended, ADCIN14 ADC_CH_ADCIN15 = 15U, //!< single-ended, ADCIN15 ADC_CH_ADCIN0_ADCIN1 = 0U, //!< differential, ADCIN0 and ADCIN1 ADC_CH_ADCIN2_ADCIN3 = 2U, //!< differential, ADCIN2 and ADCIN3 ADC_CH_ADCIN4_ADCIN5 = 4U, //!< differential, ADCIN4 and ADCIN5 ADC_CH_ADCIN6_ADCIN7 = 6U, //!< differential, ADCIN6 and ADCIN7 ADC_CH_ADCIN8_ADCIN9 = 8U, //!< differential, ADCIN8 and ADCIN9 ADC_CH_ADCIN10_ADCIN11 = 10U, //!< differential, ADCIN10 and ADCIN11 ADC_CH_ADCIN12_ADCIN13 = 12U, //!< differential, ADCIN12 and ADCIN13 ADC_CH_ADCIN14_ADCIN15 = 14U //!< differential, ADCIN14 and ADCIN15 } ADC_Channel; //***************************************************************************** // //! Values that can be passed to ADC_setInterruptPulseMode() as the //! \e pulseMode parameter. // //***************************************************************************** typedef enum { //! Occurs at the end of the acquisition window ADC_PULSE_END_OF_ACQ_WIN = 0x00U, //! Occurs at the end of the conversion ADC_PULSE_END_OF_CONV = 0x04U } ADC_PulseMode; //***************************************************************************** // //! Values that can be passed to ADC_enableInterrupt(), ADC_disableInterrupt(), //! and ADC_getInterruptStatus() as the \e adcIntNum parameter. // //***************************************************************************** typedef enum { ADC_INT_NUMBER1 = 0U, //!< ADCINT1 Interrupt ADC_INT_NUMBER2 = 1U, //!< ADCINT2 Interrupt ADC_INT_NUMBER3 = 2U, //!< ADCINT3 Interrupt ADC_INT_NUMBER4 = 3U //!< ADCINT4 Interrupt } ADC_IntNumber; //***************************************************************************** // //! Values that can be passed in as the \e ppbNumber parameter for several //! functions. // //***************************************************************************** typedef enum { ADC_PPB_NUMBER1 = 0U, //!< Post-processing block 1 ADC_PPB_NUMBER2 = 1U, //!< Post-processing block 2 ADC_PPB_NUMBER3 = 2U, //!< Post-processing block 3 ADC_PPB_NUMBER4 = 3U //!< Post-processing block 4 } ADC_PPBNumber; //***************************************************************************** // //! Values that can be passed in as the \e socNumber parameter for several //! functions. This value identifies the start-of-conversion (SOC) that a //! function is configuring or accessing. Note that in some cases (for example, //! ADC_setInterruptSource()) \e socNumber is used to refer to the //! corresponding end-of-conversion (EOC). // //***************************************************************************** typedef enum { ADC_SOC_NUMBER0 = 0U, //!< SOC/EOC number 0 ADC_SOC_NUMBER1 = 1U, //!< SOC/EOC number 1 ADC_SOC_NUMBER2 = 2U, //!< SOC/EOC number 2 ADC_SOC_NUMBER3 = 3U, //!< SOC/EOC number 3 ADC_SOC_NUMBER4 = 4U, //!< SOC/EOC number 4 ADC_SOC_NUMBER5 = 5U, //!< SOC/EOC number 5 ADC_SOC_NUMBER6 = 6U, //!< SOC/EOC number 6 ADC_SOC_NUMBER7 = 7U, //!< SOC/EOC number 7 ADC_SOC_NUMBER8 = 8U, //!< SOC/EOC number 8 ADC_SOC_NUMBER9 = 9U, //!< SOC/EOC number 9 ADC_SOC_NUMBER10 = 10U, //!< SOC/EOC number 10 ADC_SOC_NUMBER11 = 11U, //!< SOC/EOC number 11 ADC_SOC_NUMBER12 = 12U, //!< SOC/EOC number 12 ADC_SOC_NUMBER13 = 13U, //!< SOC/EOC number 13 ADC_SOC_NUMBER14 = 14U, //!< SOC/EOC number 14 ADC_SOC_NUMBER15 = 15U //!< SOC/EOC number 15 } ADC_SOCNumber; //***************************************************************************** // //! Values that can be passed in as the \e trigger parameter for the //! ADC_setInterruptSOCTrigger() function. // //***************************************************************************** typedef enum { ADC_INT_SOC_TRIGGER_NONE = 0U, //!< No ADCINT will trigger the SOC ADC_INT_SOC_TRIGGER_ADCINT1 = 1U, //!< ADCINT1 will trigger the SOC ADC_INT_SOC_TRIGGER_ADCINT2 = 2U //!< ADCINT2 will trigger the SOC } ADC_IntSOCTrigger; //***************************************************************************** // //! Values that can be passed to ADC_setSOCPriority() as the \e priMode //! parameter. // //***************************************************************************** typedef enum { ADC_PRI_ALL_ROUND_ROBIN = 0U, //!< Round robin mode is used for all ADC_PRI_SOC0_HIPRI = 1U, //!< SOC 0 hi pri, others in round robin ADC_PRI_THRU_SOC1_HIPRI = 2U, //!< SOC 0-1 hi pri, others in round robin ADC_PRI_THRU_SOC2_HIPRI = 3U, //!< SOC 0-2 hi pri, others in round robin ADC_PRI_THRU_SOC3_HIPRI = 4U, //!< SOC 0-3 hi pri, others in round robin ADC_PRI_THRU_SOC4_HIPRI = 5U, //!< SOC 0-4 hi pri, others in round robin ADC_PRI_THRU_SOC5_HIPRI = 6U, //!< SOC 0-5 hi pri, others in round robin ADC_PRI_THRU_SOC6_HIPRI = 7U, //!< SOC 0-6 hi pri, others in round robin ADC_PRI_THRU_SOC7_HIPRI = 8U, //!< SOC 0-7 hi pri, others in round robin ADC_PRI_THRU_SOC8_HIPRI = 9U, //!< SOC 0-8 hi pri, others in round robin ADC_PRI_THRU_SOC9_HIPRI = 10U, //!< SOC 0-9 hi pri, others in round robin ADC_PRI_THRU_SOC10_HIPRI = 11U, //!< SOC 0-10 hi pri, others in round robin ADC_PRI_THRU_SOC11_HIPRI = 12U, //!< SOC 0-11 hi pri, others in round robin ADC_PRI_THRU_SOC12_HIPRI = 13U, //!< SOC 0-12 hi pri, others in round robin ADC_PRI_THRU_SOC13_HIPRI = 14U, //!< SOC 0-13 hi pri, others in round robin ADC_PRI_THRU_SOC14_HIPRI = 15U, //!< SOC 0-14 hi pri, SOC15 in round robin ADC_PRI_ALL_HIPRI = 16U //!< All priorities based on SOC number } ADC_PriorityMode; //***************************************************************************** // //! Values that can be passed to ADC_configOSDetectMode() as the \e modeVal //! parameter. // //***************************************************************************** typedef enum { ADC_OSDETECT_MODE_DISABLED = 0x0U,//!< Open/Shorts detection cir- //!< cuit(O/S DC) is disabled ADC_OSDETECT_MODE_VSSA = 0x1U,//!< O/S DC is enabled at zero //!< scale ADC_OSDETECT_MODE_VDDA = 0x2U,//!< O/S DC is enabled at full //!< scale ADC_OSDETECT_MODE_5BY12_VDDA = 0x3U,//!< O/S DC is enabled at 5/12 //!< scale ADC_OSDETECT_MODE_7BY12_VDDA = 0x4U,//!< O/S DC is enabled at 7/12 //!< scale ADC_OSDETECT_MODE_5K_PULLDOWN_TO_VSSA = 0x5U,//!< O/S DC is enabled at 5K //!< pulldown to VSSA ADC_OSDETECT_MODE_5K_PULLUP_TO_VDDA = 0x6U,//!< O/S DC is enabled at 5K //!< pullup to VDDA ADC_OSDETECT_MODE_7K_PULLDOWN_TO_VSSA = 0x7U //!< O/S DC is enabled at 7K //!< pulldown to VSSA } ADC_OSDetectMode; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks an ADC base address. //! //! \param base specifies the ADC module base address. //! //! This function determines if a ADC module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool ADC_isBaseValid(uint32_t base) { return( (base == 0x00007400U) || (base == 0x00007480U) || (base == 0x00007500U) || (base == 0x00007580U) ); } //***************************************************************************** // //! Configures the analog-to-digital converter module prescaler. //! //! \param base is the base address of the ADC module. //! \param clkPrescale is the ADC clock prescaler. //! //! This function configures the ADC module's ADCCLK. //! //! The \e clkPrescale parameter specifies the value by which the input clock //! is divided to make the ADCCLK. The clkPrescale value can be specified with //! any of the following enum values: //! \b ADC_CLK_DIV_1_0, \b ADC_CLK_DIV_2_0, \b ADC_CLK_DIV_2_5, ..., //! \b ADC_CLK_DIV_7_5, \b ADC_CLK_DIV_8_0, or \b ADC_CLK_DIV_8_5. //! //! \return None. // //***************************************************************************** static inline void ADC_setPrescaler(uint32_t base, ADC_ClkPrescale clkPrescale) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 463); } } while((_Bool)0); // // Set the configuration of the ADC module prescaler. // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) = ((*((volatile uint16_t *)(base + 0x1U))) & ~0xFU) | (uint16_t)clkPrescale; __edis(); } //***************************************************************************** // //! Configures a start-of-conversion (SOC) in the ADC. //! //! \param base is the base address of the ADC module. //! \param socNumber is the number of the start-of-conversion. //! \param trigger the source that will cause the SOC. //! \param channel is the number associated with the input signal. //! \param sampleWindow is the acquisition window duration. //! //! This function configures the a start-of-conversion (SOC) in the ADC module. //! //! The \e socNumber number is a value \b ADC_SOC_NUMBERX where X is a number //! from 0 to 15 specifying which SOC is to be configured on the ADC module //! specified by \e base. //! //! The \e trigger specifies the event that causes the SOC such as software, a //! timer interrupt, an ePWM event, or an ADC interrupt. It should be a value //! in the format of \b ADC_TRIGGER_XXXX where XXXX is the event such as //! \b ADC_TRIGGER_SW_ONLY, \b ADC_TRIGGER_CPU1_TINT0, \b ADC_TRIGGER_GPIO, //! \b ADC_TRIGGER_EPWM1_SOCA, and so on. //! //! The \e channel parameter specifies the channel to be converted. In //! single-ended mode this is a single pin given by \b ADC_CH_ADCINx where x is //! the number identifying the pin between 0 and 15 inclusive. In differential //! mode, two pins are used as inputs and are passed in the \e channel //! parameter as \b ADC_CH_ADCIN0_ADCIN1, \b ADC_CH_ADCIN2_ADCIN3, ..., or //! \b ADC_CH_ADCIN14_ADCIN15. //! //! The \e sampleWindow parameter is the acquisition window duration in SYSCLK //! cycles. It should be a value between 1 and 512 cycles inclusive. The //! selected duration must be at least as long as one ADCCLK cycle. Also, the //! datasheet will specify a minimum window duration requirement in //! nanoseconds. //! //! \return None. // //***************************************************************************** static inline void ADC_setupSOC(uint32_t base, ADC_SOCNumber socNumber, ADC_Trigger trigger, ADC_Channel channel, uint32_t sampleWindow) { uint32_t ctlRegAddr, mask; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 521); } } while((_Bool)0); do { if(!((sampleWindow >= 1U) && (sampleWindow <= 512U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 522); } } while((_Bool)0); mask = (0x78000U | 0x1F00000U | 0x1FFU); // // Calculate address for the SOC control register. // ctlRegAddr = base + 0x10U + ((uint32_t)socNumber * 2U); // // Set the configuration of the specified SOC. // __eallow(); (*((volatile uint32_t *)(ctlRegAddr))) = ((*((volatile uint32_t *)(ctlRegAddr))) & ~(mask)) | ((uint32_t)channel << 15U) | ((uint32_t)trigger << 20U) | (sampleWindow - 1U); __edis(); } //***************************************************************************** // //! Configures the interrupt SOC trigger of an SOC. //! //! \param base is the base address of the ADC module. //! \param socNumber is the number of the start-of-conversion. //! \param trigger the interrupt source that will cause the SOC. //! //! This function configures the interrupt start-of-conversion trigger in //! the ADC module. //! //! The \e socNumber number is a value \b ADC_SOC_NUMBERX where X is a number //! from 0 to 15 specifying which SOC is to be configured on the ADC module //! specified by \e base. //! //! The \e trigger specifies the interrupt that causes a start of conversion or //! none. It should be one of the following values. //! //! - \b ADC_INT_SOC_TRIGGER_NONE //! - \b ADC_INT_SOC_TRIGGER_ADCINT1 //! - \b ADC_INT_SOC_TRIGGER_ADCINT2 //! //! This functionality is useful for creating continuous conversions. //! //! \return None. // //***************************************************************************** static inline void ADC_setInterruptSOCTrigger(uint32_t base, ADC_SOCNumber socNumber, ADC_IntSOCTrigger trigger) { uint16_t shiftVal; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 580); } } while((_Bool)0); // // Each SOC has a 2-bit field in this register. // shiftVal = (uint16_t)socNumber << 1U; // // Set the configuration of the specified SOC. Not that we're treating // ADCINTSOCSEL1 and ADCINTSOCSEL2 as one 32-bit register here. // __eallow(); (*((volatile uint32_t *)(base + 0xAU))) = ((*((volatile uint32_t *)(base + 0xAU))) & ~((uint32_t)0x3U << shiftVal)) | ((uint32_t)trigger << shiftVal); __edis(); } //***************************************************************************** // //! Sets the timing of the end-of-conversion pulse //! //! \param base is the base address of the ADC module. //! \param pulseMode is the generation mode of the EOC pulse. //! //! This function configures the end-of-conversion (EOC) pulse generated by ADC. //! This pulse will be generated either at the end of the acquisition window //!(pass \b ADC_PULSE_END_OF_ACQ_WIN into \e pulseMode) or at the end of the //! voltage conversion, one cycle prior to the ADC result latching into it's //! result register (pass \b ADC_PULSE_END_OF_CONV into \e pulseMode). //! //! \return None. // //***************************************************************************** static inline void ADC_setInterruptPulseMode(uint32_t base, ADC_PulseMode pulseMode) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 621); } } while((_Bool)0); // // Set the position of the pulse. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) = ((*((volatile uint16_t *)(base + 0x0U))) & ~0x4U) | (uint16_t)pulseMode; __edis(); } //***************************************************************************** // //! Powers up the analog-to-digital converter core. //! //! \param base is the base address of the ADC module. //! //! This function powers up the analog circuitry inside the analog core. //! //! \note Allow at least a 500us delay before sampling after calling this API. //! If you enable multiple ADCs, you can delay after they all have begun //! powering up. //! //! \return None. // //***************************************************************************** static inline void ADC_enableConverter(uint32_t base) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 656); } } while((_Bool)0); // // Set the bit that powers up the analog circuitry. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) |= 0x80U; __edis(); } //***************************************************************************** // //! Powers down the analog-to-digital converter module. //! //! \param base is the base address of the ADC module. //! //! This function powers down the analog circuitry inside the analog core. //! //! \return None. // //***************************************************************************** static inline void ADC_disableConverter(uint32_t base) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 683); } } while((_Bool)0); // // Clear the bit that powers down the analog circuitry. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) &= ~0x80U; __edis(); } //***************************************************************************** // //! Forces a SOC flag to a 1 in the analog-to-digital converter. //! //! \param base is the base address of the ADC module. //! \param socNumber is the number of the start-of-conversion. //! //! This function forces the SOC flag associated with the SOC specified by //! \e socNumber. This initiates a conversion once that SOC is given //! priority. This software trigger can be used whether or not the SOC has been //! configured to accept some other specific trigger. //! //! \return None. // //***************************************************************************** static inline void ADC_forceSOC(uint32_t base, ADC_SOCNumber socNumber) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 714); } } while((_Bool)0); // // Write to the register that will force a 1 to the corresponding SOC flag // (*((volatile uint16_t *)(base + 0xDU))) = ((uint16_t)1U << (uint16_t)socNumber); } //***************************************************************************** // //! Forces multiple SOC flags to 1 in the analog-to-digital converter. //! //! \param base is the base address of the ADC module. //! \param socMask is the SOCs to be forced through software //! //! This function forces the SOCFRC1 flags associated with the SOCs specified //! by \e socMask. This initiates a conversion once the desired SOCs are given //! priority. This software trigger can be used whether or not the SOC has been //! configured to accept some other specific trigger. //! Valid values for \e socMask parameter can be any of the individual //! ADC_FORCE_SOCx values or any of their OR'd combination to trigger multiple //! SOCs. //! //! \note To trigger SOC0, SOC1 and SOC2, value (ADC_FORCE_SOC0 | //! ADC_FORCE_SOC1 | ADC_FORCE_SOC2) should be passed as socMask. //! //! \return None. // //***************************************************************************** static inline void ADC_forceMultipleSOC(uint32_t base, uint16_t socMask) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 749); } } while((_Bool)0); // // Write to the register that will force a 1 to desired SOCs // (*((volatile uint16_t *)(base + 0xDU))) = socMask; } //***************************************************************************** // //! Gets the current ADC interrupt status. //! //! \param base is the base address of the ADC module. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function returns the interrupt status for the analog-to-digital //! converter. //! //! \e adcIntNum takes a one of the values \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to get //! the interrupt status for the given interrupt number of the ADC module. //! //! \return \b true if the interrupt flag for the specified interrupt number is //! set and \b false if it is not. // //***************************************************************************** static inline _Bool ADC_getInterruptStatus(uint32_t base, ADC_IntNumber adcIntNum) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 781); } } while((_Bool)0); // // Get the specified ADC interrupt status. // return(((*((volatile uint16_t *)(base + 0x3U))) & (1U << (uint16_t)adcIntNum)) != 0U); } //***************************************************************************** // //! Clears ADC interrupt sources. //! //! \param base is the base address of the ADC module. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function clears the specified ADC interrupt sources so that they no //! longer assert. If not in continuous mode, this function must be called //! before any further interrupt pulses may occur. //! //! \e adcIntNum takes a one of the values \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to express //! which of the four interrupts of the ADC module should be cleared. //! //! \return None. // //***************************************************************************** static inline void ADC_clearInterruptStatus(uint32_t base, ADC_IntNumber adcIntNum) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 812); } } while((_Bool)0); // // Clear the specified interrupt. // (*((volatile uint16_t *)(base + 0x4U))) = (uint16_t)1U << (uint16_t)adcIntNum; } //***************************************************************************** // //! Gets the current ADC interrupt overflow status. //! //! \param base is the base address of the ADC module. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function returns the interrupt overflow status for the //! analog-to-digital converter. An overflow condition is generated //! irrespective of the continuous mode. //! //! \e adcIntNum takes a one of the values \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to get //! the interrupt overflow status for the given interrupt number. //! //! \return \b true if the interrupt overflow flag for the specified interrupt //! number is set and \b false if it is not. // //***************************************************************************** static inline _Bool ADC_getInterruptOverflowStatus(uint32_t base, ADC_IntNumber adcIntNum) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 846); } } while((_Bool)0); // // Get the specified ADC interrupt status. // return(((*((volatile uint16_t *)(base + 0x5U))) & (1U << (uint16_t)adcIntNum)) != 0U); } //***************************************************************************** // //! Clears ADC interrupt overflow sources. //! //! \param base is the base address of the ADC module. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function clears the specified ADC interrupt overflow sources so that //! they no longer assert. If software tries to clear the overflow in the same //! cycle that hardware tries to set the overflow, then hardware has priority. //! //! \e adcIntNum takes a one of the values \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to express //! which of the four interrupt overflow status of the ADC module //! should be cleared. //! //! \return None. // //***************************************************************************** static inline void ADC_clearInterruptOverflowStatus(uint32_t base, ADC_IntNumber adcIntNum) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 879); } } while((_Bool)0); // // Clear the specified interrupt overflow bit. // (*((volatile uint16_t *)(base + 0x6U))) = (uint16_t)1U << (uint16_t)adcIntNum; } //***************************************************************************** // //! Reads the conversion result. //! //! \param resultBase is the base address of the ADC results. //! \param socNumber is the number of the start-of-conversion. //! //! This function returns the conversion result that corresponds to the base //! address passed into \e resultBase and the SOC passed into \e socNumber. //! //! The \e socNumber number is a value \b ADC_SOC_NUMBERX where X is a number //! from 0 to 15 specifying which SOC's result is to be read. //! //! \note Take care that you are using a base address for the result registers //! (ADCxRESULT_BASE) and not a base address for the control registers. //! //! \return Returns the conversion result. // //***************************************************************************** static inline uint16_t ADC_readResult(uint32_t resultBase, ADC_SOCNumber socNumber) { // // Check the arguments. // do { if(!((resultBase == 0x00000B00U) || (resultBase == 0x00000B20U) || (resultBase == 0x00000B40U) || (resultBase == 0x00000B60U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 917); } } while((_Bool)0); // // Return the ADC result for the selected SOC. // return((*((volatile uint16_t *)(resultBase + (uint32_t)0x0U + (uint32_t)socNumber)))); } //***************************************************************************** // //! Determines whether the ADC is busy or not. //! //! \param base is the base address of the ADC. //! //! This function allows the caller to determine whether or not the ADC is //! busy and can sample another channel. //! //! \return Returns \b true if the ADC is sampling or \b false if all //! samples are complete. // //***************************************************************************** static inline _Bool ADC_isBusy(uint32_t base) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 944); } } while((_Bool)0); // // Determine if the ADC is busy. // return(((*((volatile uint16_t *)(base + 0x0U))) & 0x2000U) != 0U); } //***************************************************************************** // //! Set SOC burst mode. //! //! \param base is the base address of the ADC. //! \param trigger the source that will cause the burst conversion sequence. //! \param burstSize is the number of SOCs converted during a burst sequence. //! //! This function configures the burst trigger and burstSize of an ADC module. //! Burst mode allows a single trigger to walk through the round-robin SOCs one //! or more at a time. When burst mode is enabled, the trigger selected by the //! ADC_setupSOC() API will no longer have an effect on the SOCs in round-robin //! mode. Instead, the source specified through the \e trigger parameter will //! cause a burst of \e burstSize conversions to occur. //! //! The \e trigger parameter takes the same values as the ADC_setupSOC() API //! The \e burstSize parameter should be a value between 1 and 16 inclusive. //! //! \return None. // //***************************************************************************** static inline void ADC_setBurstModeConfig(uint32_t base, ADC_Trigger trigger, uint16_t burstSize) { uint16_t regValue; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 981); } } while((_Bool)0); do { if(!(((uint16_t)trigger & ~((uint16_t)0x1FU)) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 982); } } while((_Bool)0); do { if(!((burstSize >= 1U) && (burstSize <= 16U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 983); } } while((_Bool)0); // // Write the burst mode configuration to the register. // __eallow(); regValue = (uint16_t)trigger | ((burstSize - 1U) << 8U); (*((volatile uint16_t *)(base + 0x2U))) = ((*((volatile uint16_t *)(base + 0x2U))) & ~((uint16_t)0x3FU | 0xF00U)) | regValue; __edis(); } //***************************************************************************** // //! Enables SOC burst mode. //! //! \param base is the base address of the ADC. //! //! This function enables SOC burst mode operation of the ADC. Burst mode //! allows a single trigger to walk through the round-robin SOCs one or more at //! a time. When burst mode is enabled, the trigger selected by the //! ADC_setupSOC() API will no longer have an effect on the SOCs in round-robin //! mode. Use ADC_setBurstMode() to configure the burst trigger and size. //! //! \return None. // //***************************************************************************** static inline void ADC_enableBurstMode(uint32_t base) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1021); } } while((_Bool)0); // // Enable burst mode. // __eallow(); (*((volatile uint16_t *)(base + 0x2U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Disables SOC burst mode. //! //! \param base is the base address of the ADC. //! //! This function disables SOC burst mode operation of the ADC. SOCs in //! round-robin mode will be triggered by the trigger configured using the //! ADC_setupSOC() API. //! //! \return None. // //***************************************************************************** static inline void ADC_disableBurstMode(uint32_t base) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1050); } } while((_Bool)0); // // Disable burst mode. // __eallow(); (*((volatile uint16_t *)(base + 0x2U))) &= ~0x8000U; __edis(); } //***************************************************************************** // //! Sets the priority mode of the SOCs. //! //! \param base is the base address of the ADC. //! \param priMode is the priority mode of the SOCs. //! //! This function sets the priority mode of the SOCs. There are three main //! modes that can be passed in the \e priMode parameter //! //! - All SOCs are in round-robin mode. This means no SOC has an inherent //! higher priority over another. This is selected by passing in the value //! \b ADC_PRI_ALL_ROUND_ROBIN. //! - All priorities are in high priority mode. This means that the priority of //! the SOC is determined by its SOC number. This option is selected by passing //! in the value \b ADC_PRI_ALL_HIPRI. //! - A range of SOCs are assigned high priority, with all others in round //! robin mode. High priority mode means that an SOC with high priority will //! interrupt the round robin wheel and insert itself as the next conversion. //! Passing in the value \b ADC_PRI_SOC0_HIPRI will make SOC0 highest priority, //! \b ADC_PRI_THRU_SOC1_HIPRI will put SOC0 and SOC 1 in high priority, and so //! on up to \b ADC_PRI_THRU_SOC14_HIPRI where SOCs 0 through 14 are in high //! priority. //! //! \return None. // //***************************************************************************** static inline void ADC_setSOCPriority(uint32_t base, ADC_PriorityMode priMode) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1093); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(base + 0x9U))) = ((*((volatile uint16_t *)(base + 0x9U))) & ~0x1FU) | (uint16_t)priMode; __edis(); } //***************************************************************************** // //! Configures Open/Shorts Detection Circuit Mode. //! //! \param base is the base address of the ADC. //! \param modeVal is the desired open/shorts detection circuit mode. //! //! This function configures the open/shorts detection circuit mode of the ADC. //! //! \return None. // //***************************************************************************** static inline void ADC_configOSDetectMode(uint32_t base, ADC_OSDetectMode modeVal) { // // Configure open/shorts detection circuit mode. // __eallow(); (*((volatile uint16_t *)(base + 0x38U))) = (((*((volatile uint16_t *)(base + 0x38U))) & (~0x7U)) | (uint16_t)modeVal); __edis(); } //***************************************************************************** // //! Configures a post-processing block (PPB) in the ADC. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param socNumber is the number of the start-of-conversion. //! //! This function associates a post-processing block with a SOC. //! //! The \e ppbNumber is a value \b ADC_PPB_NUMBERX where X is a value from 1 to //! 4 inclusive that identifies a PPB to be configured. The \e socNumber //! number is a value \b ADC_SOC_NUMBERX where X is a number from 0 to 15 //! specifying which SOC is to be configured on the ADC module specified by //! \e base. //! //! \note You can have more that one PPB associated with the same SOC, but a //! PPB can only be configured to correspond to one SOC at a time. Also note //! that when you have multiple PPBs for the same SOC, the calibration offset //! that actually gets applied will be that of the PPB with the highest number. //! Since SOC0 is the default for all PPBs, look out for unintentional //! overwriting of a lower numbered PPB's offset. //! //! \return None. // //***************************************************************************** static inline void ADC_setupPPB(uint32_t base, ADC_PPBNumber ppbNumber, ADC_SOCNumber socNumber) { uint32_t ppbOffset; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1163); } } while((_Bool)0); // // Get the offset to the appropriate PPB configuration register. // ppbOffset = ((0x48U - 0x40U) * (uint32_t)ppbNumber) + 0x40U; // // Write the configuration to the register. // __eallow(); (*((volatile uint16_t *)(base + ppbOffset))) = ((*((volatile uint16_t *)(base + ppbOffset))) & ~0xFU) | ((uint16_t)socNumber & 0xFU); __edis(); } //***************************************************************************** // //! Enables individual ADC PPB event sources. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param evtFlags is a bit mask of the event sources to be enabled. //! //! This function enables the indicated ADC PPB event sources. This will allow //! the specified events to propagate through the X-BAR to a pin or to an ePWM //! module. The \e evtFlags parameter can be any of the \b ADC_EVT_TRIPHI, //! \b ADC_EVT_TRIPLO, or \b ADC_EVT_ZERO values. //! //! \return None. // //***************************************************************************** static inline void ADC_enablePPBEvent(uint32_t base, ADC_PPBNumber ppbNumber, uint16_t evtFlags) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1202); } } while((_Bool)0); do { if(!((evtFlags & ~0x7U) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1203); } } while((_Bool)0); // // Enable the specified event. // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) |= evtFlags << ((uint16_t)ppbNumber * 4U); __edis(); } //***************************************************************************** // //! Disables individual ADC PPB event sources. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param evtFlags is a bit mask of the event sources to be enabled. //! //! This function disables the indicated ADC PPB event sources. This will stop //! the specified events from propagating through the X-BAR to other modules. //! The \e evtFlags parameter can be any of the \b ADC_EVT_TRIPHI, //! \b ADC_EVT_TRIPLO, or \b ADC_EVT_ZERO values. //! //! \return None. // //***************************************************************************** static inline void ADC_disablePPBEvent(uint32_t base, ADC_PPBNumber ppbNumber, uint16_t evtFlags) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1235); } } while((_Bool)0); do { if(!((evtFlags & ~0x7U) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1236); } } while((_Bool)0); // // Disable the specified event. // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) &= ~(evtFlags << ((uint16_t)ppbNumber * 4U)); __edis(); } //***************************************************************************** // //! Enables individual ADC PPB event interrupt sources. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param intFlags is a bit mask of the interrupt sources to be enabled. //! //! This function enables the indicated ADC PPB interrupt sources. Only the //! sources that are enabled can be reflected to the processor interrupt. //! Disabled sources have no effect on the processor. The \e intFlags //! parameter can be any of the \b ADC_EVT_TRIPHI, \b ADC_EVT_TRIPLO, or //! \b ADC_EVT_ZERO values. //! //! \return None. // //***************************************************************************** static inline void ADC_enablePPBEventInterrupt(uint32_t base, ADC_PPBNumber ppbNumber, uint16_t intFlags) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1270); } } while((_Bool)0); do { if(!((intFlags & ~0x7U) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1271); } } while((_Bool)0); // // Enable the specified event interrupts. // __eallow(); (*((volatile uint16_t *)(base + 0x36U))) |= intFlags << ((uint16_t)ppbNumber * 4U); __edis(); } //***************************************************************************** // //! Disables individual ADC PPB event interrupt sources. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param intFlags is a bit mask of the interrupt source to be disabled. //! //! This function disables the indicated ADC PPB interrupt sources. Only the //! sources that are enabled can be reflected to the processor interrupt. //! Disabled sources have no effect on the processor. The \e intFlags //! parameter can be any of the \b ADC_EVT_TRIPHI, \b ADC_EVT_TRIPLO, or //! \b ADC_EVT_ZERO values. //! //! \return None. // //***************************************************************************** static inline void ADC_disablePPBEventInterrupt(uint32_t base, ADC_PPBNumber ppbNumber, uint16_t intFlags) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1305); } } while((_Bool)0); do { if(!((intFlags & ~0x7U) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1306); } } while((_Bool)0); // // Disable the specified event interrupts. // __eallow(); (*((volatile uint16_t *)(base + 0x36U))) &= ~(intFlags << ((uint16_t)ppbNumber * 4U)); __edis(); } //***************************************************************************** // //! Gets the current ADC event status. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! //! This function returns the event status for the analog-to-digital converter. //! //! \return Returns the current event status, enumerated as a bit field of //! \b ADC_EVT_TRIPHI, \b ADC_EVT_TRIPLO, and \b ADC_EVT_ZERO. // //***************************************************************************** static inline uint16_t ADC_getPPBEventStatus(uint32_t base, ADC_PPBNumber ppbNumber) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1336); } } while((_Bool)0); // // Get the event status for the specified post-processing block. // return(((*((volatile uint16_t *)(base + 0x30U))) >> ((uint16_t)ppbNumber * 4U)) & 0x7U); } //***************************************************************************** // //! Clears ADC event flags. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param evtFlags is a bit mask of the event source to be cleared. //! //! This function clears the indicated ADC PPB event flags. After an event //! occurs this function must be called to allow additional events to be //! produced. The \e evtFlags parameter can be any of the \b ADC_EVT_TRIPHI, //! \b ADC_EVT_TRIPLO, or \b ADC_EVT_ZERO values. //! //! \return None. // //***************************************************************************** static inline void ADC_clearPPBEventStatus(uint32_t base, ADC_PPBNumber ppbNumber, uint16_t evtFlags) { // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1368); } } while((_Bool)0); do { if(!((evtFlags & ~0x7U) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1369); } } while((_Bool)0); // // Clear the specified event interrupts. // (*((volatile uint16_t *)(base + 0x32U))) |= evtFlags << ((uint16_t)ppbNumber * 4U); } //***************************************************************************** // //! Reads the processed conversion result from the PPB. //! //! \param resultBase is the base address of the ADC results. //! \param ppbNumber is the number of the post-processing block. //! //! This function returns the processed conversion result that corresponds to //! the base address passed into \e resultBase and the PPB passed into //! \e ppbNumber. //! //! \note Take care that you are using a base address for the result registers //! (ADCxRESULT_BASE) and not a base address for the control registers. //! //! \return Returns the signed 32-bit conversion result. // //***************************************************************************** static inline int32_t ADC_readPPBResult(uint32_t resultBase, ADC_PPBNumber ppbNumber) { // // Check the arguments. // do { if(!((resultBase == 0x00000B00U) || (resultBase == 0x00000B20U) || (resultBase == 0x00000B40U) || (resultBase == 0x00000B60U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1406); } } while((_Bool)0); // // Return the result of selected PPB. // return((int32_t)(*((volatile uint32_t *)(resultBase + (uint32_t)0x10U + ((uint32_t)ppbNumber * 2UL))))); } //***************************************************************************** // //! Reads sample delay time stamp from a PPB. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! //! This function returns the sample delay time stamp. This delay is the number //! of system clock cycles between the SOC being triggered and when it began //! converting. //! //! \return Returns the delay time stamp. // //***************************************************************************** static inline uint16_t ADC_getPPBDelayTimeStamp(uint32_t base, ADC_PPBNumber ppbNumber) { uint32_t ppbOffset; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1436); } } while((_Bool)0); // // Get the offset to the appropriate delay. // ppbOffset = ((0x49U - 0x41U) * (uint32_t)ppbNumber) + 0x41U; // // Return the delay time stamp. // return((*((volatile uint16_t *)(base + ppbOffset))) & 0xFFFU); } //***************************************************************************** // //! Sets the post processing block offset correction. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param offset is the 10-bit signed value subtracted from ADC the output. //! //! This function sets the PPB offset correction value. This value can be used //! to digitally remove any system-level offset inherent in the ADCIN circuit //! before it is stored in the appropriate result register. The \e offset //! parameter is \b subtracted from the ADC output and is a signed value from //! -512 to 511 inclusive. For example, when \e offset = 1, ADCRESULT = ADC //! output - 1. When \e offset = -512, ADCRESULT = ADC output - (-512) or ADC //! output + 512. //! //! Passing a zero in to the \e offset parameter will effectively disable the //! calculation, allowing the raw ADC result to be passed unchanged into the //! result register. //! //! \note If multiple PPBs are applied to the same SOC, the offset that will be //! applied will be that of the PPB with the highest number. //! //! \return None // //***************************************************************************** static inline void ADC_setPPBCalibrationOffset(uint32_t base, ADC_PPBNumber ppbNumber, int16_t offset) { uint32_t ppbOffset; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1484); } } while((_Bool)0); // // Get the offset to the appropriate offset register. // ppbOffset = ((0x4AU - 0x42U) * (uint32_t)ppbNumber) + 0x42U; // // Write the offset amount. // __eallow(); (*((volatile uint16_t *)(base + ppbOffset))) = ((*((volatile uint16_t *)(base + ppbOffset))) & ~0x3FFU) | ((uint16_t)offset & 0x3FFU); __edis(); } //***************************************************************************** // //! Sets the post processing block reference offset. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param offset is the 16-bit unsigned value subtracted from ADC the output. //! //! This function sets the PPB reference offset value. This can be used to //! either calculate the feedback error or convert a unipolar signal to bipolar //! by subtracting a reference value. The result will be stored in the //! appropriate PPB result register which can be read using ADC_readPPBResult(). //! //! Passing a zero in to the \e offset parameter will effectively disable the //! calculation and will pass the ADC result to the PPB result register //! unchanged. //! //! \note If in 12-bit mode, you may only pass a 12-bit value into the \e offset //! parameter. //! //! \return None // //***************************************************************************** static inline void ADC_setPPBReferenceOffset(uint32_t base, ADC_PPBNumber ppbNumber, uint16_t offset) { uint32_t ppbOffset; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1533); } } while((_Bool)0); // // Get the offset to the appropriate offset register. // ppbOffset = ((0x4BU - 0x43U) * (uint32_t)ppbNumber) + 0x43U; // // Write the offset amount. // (*((volatile uint16_t *)(base + ppbOffset))) = offset; } //***************************************************************************** // //! Enables two's complement capability in the PPB. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! //! This function enables two's complement in the post-processing block //! specified by the \e ppbNumber parameter. When enabled, a two's complement //! will be performed on the output of the offset subtraction before it is //! stored in the appropriate PPB result register. In other words, the PPB //! result will be the reference offset value minus the the ADC result value //! (ADCPPBxRESULT = ADCSOCxOFFREF - ADCRESULTx). //! //! \return None // //***************************************************************************** static inline void ADC_enablePPBTwosComplement(uint32_t base, ADC_PPBNumber ppbNumber) { uint32_t ppbOffset; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1571); } } while((_Bool)0); // // Get the offset to the appropriate PPB configuration register. // ppbOffset = ((0x48U - 0x40U) * (uint32_t)ppbNumber) + 0x40U; // // Enable PPB two's complement. // __eallow(); (*((volatile uint16_t *)(base + ppbOffset))) |= 0x10U; __edis(); } //***************************************************************************** // //! Disables two's complement capability in the PPB. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! //! This function disables two's complement in the post-processing block //! specified by the \e ppbNumber parameter. When disabled, a two's complement //! will \b NOT be performed on the output of the offset subtraction before it //! is stored in the appropriate PPB result register. In other words, the PPB //! result will be the ADC result value minus the reference offset value //! (ADCPPBxRESULT = ADCRESULTx - ADCSOCxOFFREF). //! //! \return None // //***************************************************************************** static inline void ADC_disablePPBTwosComplement(uint32_t base, ADC_PPBNumber ppbNumber) { uint32_t ppbOffset; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1611); } } while((_Bool)0); // // Get the offset to the appropriate PPB configuration register. // ppbOffset = ((0x48U - 0x40U) * (uint32_t)ppbNumber) + 0x40U; // // Disable PPB two's complement. // __eallow(); (*((volatile uint16_t *)(base + ppbOffset))) &= ~0x10U; __edis(); } //***************************************************************************** // //! Enables an ADC interrupt source. //! //! \param base is the base address of the ADC module. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function enables the indicated ADC interrupt source. Only the //! sources that are enabled can be reflected to the processor interrupt. //! Disabled sources have no effect on the processor. //! //! \e adcIntNum can take the value \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to express //! which of the four interrupts of the ADC module should be enabled. //! //! \return None. // //***************************************************************************** static inline void ADC_enableInterrupt(uint32_t base, ADC_IntNumber adcIntNum) { uint32_t intRegAddr; uint16_t shiftVal; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1653); } } while((_Bool)0); // // Each INTSEL register manages two interrupts. If the interrupt number is // even, we'll be accessing the upper byte and will need to shift. // intRegAddr = base + 0x7U + ((uint32_t)adcIntNum >> 1); shiftVal = ((uint16_t)adcIntNum & 0x1U) << 3U; // // Enable the specified ADC interrupt. // __eallow(); (*((volatile uint16_t *)(intRegAddr))) |= 0x20U << shiftVal; __edis(); } //***************************************************************************** // //! Disables an ADC interrupt source. //! //! \param base is the base address of the ADC module. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function disables the indicated ADC interrupt source. //! Only the sources that are enabled can be reflected to the processor //! interrupt. Disabled sources have no effect on the processor. //! //! \e adcIntNum can take the value \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to express //! which of the four interrupts of the ADC module should be disabled. //! //! \return None. // //***************************************************************************** static inline void ADC_disableInterrupt(uint32_t base, ADC_IntNumber adcIntNum) { uint32_t intRegAddr; uint16_t shiftVal; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1699); } } while((_Bool)0); // // Each INTSEL register manages two interrupts. If the interrupt number is // even, we'll be accessing the upper byte and will need to shift. // intRegAddr = base + 0x7U + ((uint32_t)adcIntNum >> 1); shiftVal = ((uint16_t)adcIntNum & 0x1U) << 3U; // // Disable the specified ADC interrupt. // __eallow(); (*((volatile uint16_t *)(intRegAddr))) &= ~(0x20U << shiftVal); __edis(); } //***************************************************************************** // //! Sets the source EOC for an analog-to-digital converter interrupt. //! //! \param base is the base address of the ADC module. //! \param adcIntNum is interrupt number within the ADC wrapper. //! \param socNumber is the number of the start-of-conversion. //! //! This function sets which conversion is the source of an ADC interrupt. //! //! The \e intTrigger number is a value \b ADC_SOC_NUMBERX where X is a number //! from 0 to 15 specifying which EOC is to be configured on the ADC module //! specified by \e base. Refer \b ADC_SOCNumber enum for valid values for //! this input. //! //! \e adcIntNum can take the value \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to express //! which of the four interrupts of the ADC module is being configured. //! //! \return None. // //***************************************************************************** static inline void ADC_setInterruptSource(uint32_t base, ADC_IntNumber adcIntNum, uint16_t intTrigger) { uint32_t intRegAddr; uint16_t shiftVal; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1750); } } while((_Bool)0); do { if(!(intTrigger < 16U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1751); } } while((_Bool)0); // // Each INTSEL register manages two interrupts. If the interrupt number is // even, we'll be accessing the upper byte and will need to shift. // intRegAddr = base + 0x7U + ((uint32_t)adcIntNum >> 1); shiftVal = ((uint16_t)adcIntNum & 0x1U) << 3U; // // Set the specified ADC interrupt source. // __eallow(); (*((volatile uint16_t *)(intRegAddr))) = ((*((volatile uint16_t *)(intRegAddr))) & ~(0xFU << shiftVal)) | ((uint16_t)intTrigger << shiftVal); __edis(); } //***************************************************************************** // //! Enables continuous mode for an ADC interrupt. //! //! \param base is the base address of the ADC. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function enables continuous mode for the ADC interrupt passed into //! \e adcIntNum. This means that pulses will be generated for the specified //! ADC interrupt whenever an EOC pulse is generated irrespective of whether or //! not the flag bit is set. //! //! \e adcIntNum can take the value \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to express //! which of the four interrupts of the ADC module is being configured. //! //! \return None. // //***************************************************************************** static inline void ADC_enableContinuousMode(uint32_t base, ADC_IntNumber adcIntNum) { uint32_t intRegAddr; uint16_t shiftVal; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1800); } } while((_Bool)0); // // Each INTSEL register manages two interrupts. If the interrupt number is // even, we'll be accessing the upper byte and will need to shift. // intRegAddr = base + 0x7U + ((uint32_t)adcIntNum >> 1); shiftVal = ((uint16_t)adcIntNum & 0x1U) << 3U; // // Enable continuous mode for the specified ADC interrupt. // __eallow(); (*((volatile uint16_t *)(intRegAddr))) |= 0x40U << shiftVal; __edis(); } //***************************************************************************** // //! Disables continuous mode for an ADC interrupt. //! //! \param base is the base address of the ADC. //! \param adcIntNum is interrupt number within the ADC wrapper. //! //! This function disables continuous mode for the ADC interrupt passed into //! \e adcIntNum. This means that pulses will not be generated for the //! specified ADC interrupt until the corresponding interrupt flag for the //! previous interrupt occurrence has been cleared using //! ADC_clearInterruptStatus(). //! //! \e adcIntNum can take the value \b ADC_INT_NUMBER1, //! \b ADC_INT_NUMBER2, \b ADC_INT_NUMBER3 or \b ADC_INT_NUMBER4 to express //! which of the four interrupts of the ADC module is being configured. //! //! \return None. // //***************************************************************************** static inline void ADC_disableContinuousMode(uint32_t base, ADC_IntNumber adcIntNum) { uint32_t intRegAddr; uint16_t shiftVal; // // Check the arguments. // do { if(!(ADC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/adc.h", 1848); } } while((_Bool)0); // // Each INTSEL register manages two interrupts. If the interrupt number is // even, we'll be accessing the upper byte and will need to shift. // intRegAddr = base + 0x7U + ((uint32_t)adcIntNum >> 1); shiftVal = ((uint16_t)adcIntNum & 0x1U) << 3U; // // Disable continuous mode for the specified ADC interrupt. // __eallow(); (*((volatile uint16_t *)(intRegAddr))) &= ~(0x40U << shiftVal); __edis(); } //***************************************************************************** // //! Converts temperature from sensor reading to degrees C //! //! \param tempResult is the raw ADC A conversion result from the temp sensor. //! \param vref is the reference voltage being used (for example 3.3 for 3.3V). //! //! This function converts temperature from temp sensor reading to degrees C. //! Temp sensor values in production test are derived with 2.5V reference. //! The \b vref argument in the function is used to scale the temp sensor //! reading accordingly if temp sensor value is read at a different VREF //! setting. //! //! \return Returns the temperature sensor reading converted to degrees C. // //***************************************************************************** static inline int16_t ADC_getTemperatureC(uint16_t tempResult, float32_t vref) { int16_t tsOffset, tsSlope; float32_t temp; // // Check the device revision // if((*((volatile uint16_t *)(0x0005D000U + 0xCU))) >= 3) { // // For production devices (Rev. C), pull the slope and offset from OTP // // // Only accessible from the CPU. // tsSlope = (int16_t)(*(int16_t (*)(void))0x7036E)(); tsOffset = (int16_t)(*(int16_t (*)(void))0x70372)(); } else { // // For pre-production devices, use these static values for slope // and offset // tsSlope = 5196; tsOffset = 1788; } // // The slope is stored as a Q15 fixed point number hence the need to // to an integer. // temp = (((float32_t)tempResult * (vref / 2.5F)) - (float32_t)tsOffset) * (float32_t)tsSlope; return((int16_t)((((int32_t)temp + (int32_t)0x4000 + ((int32_t)273 * (int32_t)0x8000)) / (int32_t)0x8000) - (int32_t)273)); } //***************************************************************************** // //! Converts temperature from sensor reading to degrees K //! //! \param tempResult is the raw ADC A conversion result from the temp sensor. //! \param vref is the reference voltage being used (for example 3.3 for 3.3V). //! //! This function converts temperature from temp sensor reading to degrees K. //! Temp sensor values in production test are derived with 2.5V reference. //! The \b vref argument in the function is used to scale the temp sensor //! reading accordingly if temp sensor value is read at a different VREF //! setting. //! //! \return Returns the temperature sensor reading converted to degrees K. // //***************************************************************************** static inline int16_t ADC_getTemperatureK(uint16_t tempResult, float32_t vref) { int16_t tsOffset, tsSlope; float32_t temp; // // Check the device revision // if((*((volatile uint16_t *)(0x0005D000U + 0xCU))) >= 3) { // // For production devices (Rev. C), pull the slope and offset from OTP // // // Only accessible from the CPU. // tsSlope = (int16_t)(*(int16_t (*)(void))0x7036E)(); tsOffset = (int16_t)(*(int16_t (*)(void))0x70372)(); } else { // // For pre-production devices, use these static values for slope // and offset // tsSlope = 5196; tsOffset = 1788; } // // The slope is stored as a Q15 fixed point number hence the need to // to an integer. // temp = (((float32_t)tempResult * (vref / 2.5F)) - (float32_t)tsOffset) * (float32_t)tsSlope; return((int16_t)(((int32_t)temp + (int32_t)0x4000 + ((int32_t)273 * (int32_t)0x8000)) / (int32_t)0x8000)); } //***************************************************************************** // //! Configures the analog-to-digital converter resolution and signal mode. //! //! \param base is the base address of the ADC module. //! \param resolution is the resolution of the converter (12 or 16 bits). //! \param signalMode is the input signal mode of the converter. //! //! This function configures the ADC module's conversion resolution and input //! signal mode and ensures that the corresponding trims are loaded. //! //! The \e resolution parameter specifies the resolution of the conversion. //! It can be 12-bit or 16-bit specified by \b ADC_RESOLUTION_12BIT //! or \b ADC_RESOLUTION_16BIT. //! //! The \e signalMode parameter specifies the signal mode. In single-ended //! mode, which is indicated by \b ADC_MODE_SINGLE_ENDED, the input voltage is //! sampled on a single pin referenced to VREFLO. In differential mode, which //! is indicated by \b ADC_MODE_DIFFERENTIAL, the input voltage to the //! converter is sampled on a pair of input pins, a positive and a negative. //! //! \b Note: In this device, single-ended signal conversions are supported //! only in 12-bit resolution mode and differential signal //! conversions are supported only in 16-bit resolution mode. //! //! \return None. // //***************************************************************************** extern void ADC_setMode(uint32_t base, ADC_Resolution resolution, ADC_SignalMode signalMode); //***************************************************************************** // //! Configures the offset trim for the desired ADC instance //! //! \param base is the base address of the ADC module. //! //! This function loads the offset trims for the desired ADC instance. //! //! \return None. // //***************************************************************************** extern void ADC_setOffsetTrim(uint32_t base); //***************************************************************************** // //! Configures the INL trim for the desired ADC instance //! //! \param base is the base address of the ADC module. //! //! This function loads the INL trims for the desired ADC instance. //! //! \return None. // //***************************************************************************** extern void ADC_setINLTrim(uint32_t base); //***************************************************************************** // //! Sets the windowed trip limits for a PPB. //! //! \param base is the base address of the ADC module. //! \param ppbNumber is the number of the post-processing block. //! \param tripHiLimit is the value is the digital comparator trip high limit. //! \param tripLoLimit is the value is the digital comparator trip low limit. //! //! This function sets the windowed trip limits for a PPB. These values set //! the digital comparator so that when one of the values is exceeded, either a //! high or low trip event will occur. //! //! The \e ppbNumber is a value \b ADC_PPB_NUMBERX where X is a value from 1 to //! 4 inclusive that identifies a PPB to be configured. //! //! If using 16-bit mode, you may pass a 17-bit number into the \e tripHiLimit //! and \e tripLoLimit parameters where the 17th bit is the sign bit (that is //! a value from -65536 and 65535). In 12-bit mode, only bits 12:0 will be //! compared against bits 12:0 of the PPB result. //! //! \note On some devices, signed trip values do not work properly. See the //! silicon errata for details. //! //! \return None. // //***************************************************************************** extern void ADC_setPPBTripLimits(uint32_t base, ADC_PPBNumber ppbNumber, int32_t tripHiLimit, int32_t tripLoLimit); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: asysctl.h // // TITLE: C28x driver for Analog System Control. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup asysctl_api ASysCtl //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_asysctl.h // // TITLE: Definitions for the ASYSCTL registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the ASYSCTL register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INTOSC1TRIM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INTOSC2TRIM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TSNSCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ANAREFTRIMA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ANAREFTRIMB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ANAREFTRIMC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ANAREFTRIMD register // //************************************************************************************************* //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! Enable temperature sensor. //! //! This function enables the temperature sensor output to the ADC. //! //! \return None. // //***************************************************************************** static inline void ASysCtl_enableTemperatureSensor(void) { __eallow(); // // Set the temperature sensor enable bit. // (*((volatile uint16_t *)(0x0005D180U + 0x26U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disable temperature sensor. //! //! This function disables the temperature sensor output to the ADC. //! //! \return None. // //***************************************************************************** static inline void ASysCtl_disableTemperatureSensor(void) { __eallow(); // // Clear the temperature sensor enable bit. // (*((volatile uint16_t *)(0x0005D180U + 0x26U))) &= ~(0x1U); __edis(); } //***************************************************************************** // //! Locks the temperature sensor control register. //! //! \return None. // //***************************************************************************** static inline void ASysCtl_lockTemperatureSensor(void) { __eallow(); // // Write a 1 to the lock bit in the LOCK register. // (*((volatile uint16_t *)(0x0005D180U + 0x2EU))) |= 0x8U; __edis(); } //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: can.h // // TITLE: C28x CAN driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup can_api CAN //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_can.h // // TITLE: Definitions for the CAN registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the CAN register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_CTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_ES register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_ERRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_BTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_INT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_TEST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_PERR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_RAM_INIT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_GLB_INT_EN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_GLB_INT_FLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_GLB_INT_CLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_TXRQ_X register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_NDAT_X register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IPEN_X register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_MVAL_X register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF1CMD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF1MSK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF1ARB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF1MCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF1DATA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF1DATB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF2CMD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF2MSK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF2ARB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF2MCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF2DATA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF2DATB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF3OBS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF3MSK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF3ARB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF3MCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF3DATA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CAN_IF3DATB register // //************************************************************************************************* //########################################################################### // // FILE: sysctl.h // // TITLE: C28x system control driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup sysctl_api SysCtl //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_nmi.h // // TITLE: Definitions for the NMI registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the NMI register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMICFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMIFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMIFLGCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMIFLGFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMISHDFLG register // //************************************************************************************************* //########################################################################### // // FILE: hw_otp.h // // TITLE: Definitions for the OTP registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the OTP register offsets // //************************************************************************************************* //########################################################################### // // FILE: interrupt.h // // TITLE: C28x Interrupt (PIE) driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup interrupt_api Interrupt //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_ints.h // // TITLE: Definitions of interrupt numbers for use with interrupt.c. // //########################################################################### // // //########################################################################### //***************************************************************************** // // PIE Interrupt Numbers // // 0x00FF = PIE Table Row # // 0xFF00 = PIE Table Column # // 0xFFFF0000 = PIE Vector ID // //***************************************************************************** // Lower PIE Group 1 // Lower PIE Group 2 // Lower PIE Group 3 // Lower PIE Group 4 // Lower PIE Group 5 // Lower PIE Group 6 // Lower PIE Group 7 // Lower PIE Group 8 // Lower PIE Group 9 // Lower PIE Group 10 // Lower PIE Group 11 // Lower PIE Group 12 // Upper PIE Group 1 // Upper PIE Group 2 // Upper PIE Group 3 // Upper PIE Group 5 // Upper PIE Group 6 // Upper PIE Group 8 // Upper PIE Group 9 // Upper PIE Group 10 // Upper PIE Group 12 // Other interrupts //########################################################################### // // FILE: hw_pie.h // // TITLE: Definitions for the PIE registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the PIE register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIECTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEACK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER5 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR5 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER6 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR6 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER7 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR7 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER8 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR8 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER9 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR9 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER10 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR10 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER11 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR11 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIER12 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PIEIFR12 register // //************************************************************************************************* //***************************************************************************** // // The following are values that can be passed to the Interrupt_enableInCPU() // and Interrupt_disableInCPU() functions as the cpuInterrupt parameter. // //***************************************************************************** //***************************************************************************** // // The following are values that can be passed to the Interrupt_clearACKGroup() // function as the group parameter. // //***************************************************************************** //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! The default interrupt handler. //! //! This is the default interrupt handler. The Interrupt_initVectorTable() //! function sets all vectors to this function. Also, when an interrupt is //! unregistered using the Interrupt_unregister() function, this handler takes //! its place. This should never be called during normal operation. //! //! The ESTOP0 statement is for debug purposes only. Remove and replace with an //! appropriate error handling routine for your program. //! //! \return None. // //***************************************************************************** extern void Interrupt_defaultHandler(void); //***************************************************************************** // //! \internal //! The default illegal instruction trap interrupt handler. //! //! This is the default interrupt handler for an illegal instruction trap //! (ITRAP). The Interrupt_initVectorTable() function sets the appropriate //! vector to this function. This should never be called during normal //! operation. //! //! The ESTOP0 statement is for debug purposes only. Remove and replace with //! an appropriate error handling routine for your program. //! //! \return None. // //***************************************************************************** extern void Interrupt_illegalOperationHandler(void); //***************************************************************************** // //! \internal //! The default non-maskable interrupt handler. //! //! This is the default interrupt handler for a non-maskable interrupt (NMI). //! The Interrupt_initVectorTable() function sets the appropriate vector to //! this function. This should never be called during normal operation. //! //! The ESTOP0 statement is for debug purposes only. Remove and replace with an //! appropriate error handling routine for your program. //! //! \return None. // //***************************************************************************** extern void Interrupt_nmiHandler(void); //***************************************************************************** // //! Allows the CPU to process interrupts. //! //! This function clears the global interrupt mask bit (INTM) in the CPU, //! allowing the processor to respond to interrupts. //! //! \return Returns \b true if interrupts were disabled when the function was //! called or \b false if they were initially enabled. // //***************************************************************************** static inline _Bool Interrupt_enableGlobal(void) { // // Enable processor interrupts. // return(((__enable_interrupts() & 0x1U) != 0U) ? 1 : 0); } //***************************************************************************** // //! Stops the CPU from processing interrupts. //! //! This function sets the global interrupt mask bit (INTM) in the CPU, //! preventing the processor from receiving maskable interrupts. //! //! \return Returns \b true if interrupts were already disabled when the //! function was called or \b false if they were initially enabled. // //***************************************************************************** static inline _Bool Interrupt_disableGlobal(void) { // // Disable processor interrupts. // return(((__disable_interrupts() & 0x1U) != 0U) ? 1 : 0); } //***************************************************************************** // //! Registers a function to be called when an interrupt occurs. //! //! \param interruptNumber specifies the interrupt in question. //! \param handler is a pointer to the function to be called. //! //! This function is used to specify the handler function to be called when the //! given interrupt is asserted to the processor. When the interrupt occurs, //! if it is enabled (via Interrupt_enable()), the handler function will be //! called in interrupt context. Since the handler function can preempt other //! code, care must be taken to protect memory or peripherals that are accessed //! by the handler and other non-handler code. //! //! The available \e interruptNumber values are supplied in //! inc/hw_ints.h. //! //! \note This function assumes that the PIE has been enabled. See //! Interrupt_initModule(). //! //! \return None. // //***************************************************************************** static inline void Interrupt_register(uint32_t interruptNumber, void (*handler)(void)) { uint32_t address; // // Calculate appropriate address for the interrupt number // address = (uint32_t)0x00000D00U + (((interruptNumber & 0xFFFF0000U) >> 16U) * 2U); // // Copy ISR address into PIE table // __eallow(); (*((volatile uint32_t *)(address))) = (uint32_t)handler; __edis(); } //***************************************************************************** // //! Unregisters the function to be called when an interrupt occurs. //! //! \param interruptNumber specifies the interrupt in question. //! //! This function is used to indicate that a default handler //! Interrupt_defaultHandler() should be called when the given interrupt is //! asserted to the processor. Call Interrupt_disable() to disable //! the interrupt before calling this function. //! //! The available \e interruptNumber values are supplied in //! inc/hw_ints.h. //! //! \sa Interrupt_register() for important information about registering //! interrupt handlers. //! //! \return None. // //***************************************************************************** static inline void Interrupt_unregister(uint32_t interruptNumber) { uint32_t address; // // Calculate appropriate address for the interrupt number // address = (uint32_t)0x00000D00U + (((interruptNumber & 0xFFFF0000U) >> 16U) * 2U); // // Copy default ISR address into PIE table // __eallow(); (*((volatile uint32_t *)(address))) = (uint32_t)Interrupt_defaultHandler; __edis(); } //***************************************************************************** // //! Enables CPU interrupt channels //! //! \param cpuInterrupt specifies the CPU interrupts to be enabled. //! //! This function enables the specified interrupts in the CPU. The //! \e cpuInterrupt parameter is a logical OR of the values //! \b INTERRUPT_CPU_INTx where x is the interrupt number between 1 and 14, //! \b INTERRUPT_CPU_DLOGINT, and \b INTERRUPT_CPU_RTOSINT. //! //! \note Note that interrupts 1-12 correspond to the PIE groups with those //! same numbers. //! //! \return None. // //***************************************************************************** static inline void Interrupt_enableInCPU(uint16_t cpuInterrupt) { // // Set the interrupt bits in the CPU. // IER |= cpuInterrupt; } //***************************************************************************** // //! Disables CPU interrupt channels //! //! \param cpuInterrupt specifies the CPU interrupts to be disabled. //! //! This function disables the specified interrupts in the CPU. The //! \e cpuInterrupt parameter is a logical OR of the values //! \b INTERRUPT_CPU_INTx where x is the interrupt number between 1 and 14, //! \b INTERRUPT_CPU_DLOGINT, and \b INTERRUPT_CPU_RTOSINT. //! //! \note Note that interrupts 1-12 correspond to the PIE groups with those //! same numbers. //! //! \return None. // //***************************************************************************** static inline void Interrupt_disableInCPU(uint16_t cpuInterrupt) { // // Clear the interrupt bits in the CPU. // IER &= ~cpuInterrupt; } //***************************************************************************** // //! Acknowledges PIE Interrupt Group //! //! \param group specifies the interrupt group to be acknowledged. //! //! The specified interrupt group is acknowledged and clears any interrupt //! flag within that respective group. //! //! The \e group parameter must be a logical OR of the following: //! \b INTERRUPT_ACK_GROUP1, \b INTERRUPT_ACK_GROUP2, \b INTERRUPT_ACK_GROUP3 //! \b INTERRUPT_ACK_GROUP4, \b INTERRUPT_ACK_GROUP5, \b INTERRUPT_ACK_GROUP6 //! \b INTERRUPT_ACK_GROUP7, \b INTERRUPT_ACK_GROUP8, \b INTERRUPT_ACK_GROUP9 //! \b INTERRUPT_ACK_GROUP10, \b INTERRUPT_ACK_GROUP11, //! \b INTERRUPT_ACK_GROUP12. //! //! \return None. // //***************************************************************************** static inline void Interrupt_clearACKGroup(uint16_t group) { // // Set interrupt group acknowledge bits // (*((volatile uint16_t *)(0x00000CE0U + 0x1U))) = group; } //***************************************************************************** // //! Enables the PIE block. //! //! This function enables the vector fetching for the peripheral interrupts by //! enabling the PIE block. //! //! \return None. // //***************************************************************************** static inline void Interrupt_enablePIE(void) { (*((volatile uint16_t *)(0x00000CE0U + 0x0U))) |= 0x1U; } //***************************************************************************** // //! Disables the PIE block. //! //! This function disables the vector fetching for the peripheral interrupts by //! disabling the PIE block. PIEACK, PIEIFR, and PIEIER registers can be //! accessed even when the PIE block is disabled. //! //! \return None. // //***************************************************************************** static inline void Interrupt_disablePIE(void) { (*((volatile uint16_t *)(0x00000CE0U + 0x0U))) &= ~0x1U; } //***************************************************************************** // //! Initializes the PIE control registers by setting them to a known state. //! //! This function initializes the PIE control registers. After globally //! disabling interrupts and enabling the PIE, it clears all of the PIE //! interrupt enable bits and interrupt flags. //! //! \return None. // //***************************************************************************** extern void Interrupt_initModule(void); //***************************************************************************** // //! Initializes the PIE vector table by setting all vectors to a default //! handler function. //! //! \return None. // //***************************************************************************** extern void Interrupt_initVectorTable(void); //***************************************************************************** // //! Enables an interrupt. //! //! \param interruptNumber specifies the interrupt to be enabled. //! //! The specified interrupt is enabled in the interrupt controller. Other //! enables for the interrupt (such as at the peripheral level) are unaffected //! by this function. //! //! The available \e interruptNumber values are supplied in //! inc/hw_ints.h. //! //! \return None. // //***************************************************************************** extern void Interrupt_enable(uint32_t interruptNumber); //***************************************************************************** // //! Disables an interrupt. //! //! \param interruptNumber specifies the interrupt to be disabled. //! //! The specified interrupt is disabled in the interrupt controller. Other //! enables for the interrupt (such as at the peripheral level) are unaffected //! by this function. //! //! The available \e interruptNumber values are supplied in //! inc/hw_ints.h. //! //! \return None. // //***************************************************************************** extern void Interrupt_disable(uint32_t interruptNumber); //***************************************************************************** // // Extern compiler intrinsic prototypes. See compiler User's Guide for details. // //***************************************************************************** extern uint16_t __disable_interrupts(void); extern uint16_t __enable_interrupts(void); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** // // Macro used for adding delay between 2 consecutive writes to CLKSRCCTL1 // register. // Delay = 300 NOPs // // // Macro used for adding delay between 2 consecutive writes to memory mapped // register in System control // Total delay = 3 * (DEVICE_SYSCLK_FREQ / INTOSC1 Freq) + 9 // //***************************************************************************** // // Defines for system control functions. Not intended for use by application // code. // //***************************************************************************** // // Shifted pattern for WDCR register's WDCHK field. // // // Keys for WDKEY field. The first enables resets and the second resets. // // // Values to help decode peripheral parameter // // //Keys for the System control registers write protection // // //Values to help access shifting of bits // // // LPM defines for LPMCR.LPM // // // Bit shift for DAC to configure the CPUSEL register // // // Default internal oscillator frequency, 10 MHz // // // Mask for SYNCSELECT.SYNCIN // // // Boot ROM Booting and Reset Status // // // Device_cal function which is available in OTP memory // This function is called in SysCtl_resetPeripheral after resetting // analog peripherals // //***************************************************************************** // // The following are values that can be passed to the SysCtl_setClock() API as // the config parameter. // //***************************************************************************** // // System clock divider (SYSDIV) // //! Macro to format system clock divider value. x must be 1 or even values up //! to 126. // // Integer multiplier (IMULT) // //! Macro to format integer multiplier value. x is a number from 1 to 127. //! // // Fractional multiplier (FMULT) // // // Oscillator source // // Also used with the SysCtl_selectOscSource(), SysCtl_turnOnOsc(), // and SysCtl_turnOffOsc() functions as the oscSource parameter. // //! Internal oscillator INTOSC2 //! External oscillator (XTAL) in crystal mode //! Internal oscillator INTOSC1 // // Enable/disable PLL // //***************************************************************************** // // The following are values that can be passed to the SysCtl_setAuxClock() API // as the config parameter. // //***************************************************************************** // // Auxiliary clock divider (AUXCLKDIV) // // // Integer multiplier (IMULT) // //! Macro to format integer multiplier value. x is a number from 1 to 127. //! // // Fractional multiplier (FMULT) // // // Oscillator source // //! Internal oscillator INTOSC2 as auxiliary clock input //! External oscillator (XTAL) as auxiliary clock input //! AUXCLKIN (from GPIO) as auxiliary clock input // // Enable/disable PLL // //***************************************************************************** // // Values that can be passed to SysCtl_selectSecController() as the // periFrame1Config and periFrame2Config parameters. // //***************************************************************************** //! Configure CLA as the secondary controller //! Configure DMA a secondary controller //***************************************************************************** // // Values that can be passed to SysCtl_clearNMIStatus(), // SysCtl_forceNMIFlags(), SysCtl_isNMIFlagSet(), and // SysCtl_isNMIShadowFlagSet() as the nmiFlags parameter and returned by // SysCtl_getNMIFlagStatus() and SysCtl_getNMIShadowFlagStatus(). // //***************************************************************************** //***************************************************************************** // // The following are values that can be passed to the SysCtl_clearResetCause() // API as rstCauses or returned by the SysCtl_getResetCause() API. // //***************************************************************************** //***************************************************************************** // //! The following are values that can be passed to SysCtl_enablePeripheral() //! and SysCtl_disablePeripheral() as the \e peripheral parameter. //! The EPWM Clock enable bit is also used to enable clocking for CLB. //! The EPWM and CLB clock enable bits are mapped to same value, // //***************************************************************************** //***************************************************************************** // // The following values define the adcsocSrc parameter for // SysCtl_enableExtADCSOCSource() and SysCtl_disableExtADCSOCSource(). // //***************************************************************************** //***************************************************************************** // //! The following are values that can be passed to SysCtl_enablePeripheral() //! and SysCtl_disablePeripheral() as the \e peripheral parameter. // //***************************************************************************** typedef enum { SYSCTL_PERIPH_CLK_CLA1 = 0x0000, //!< CLA1 clock SYSCTL_PERIPH_CLK_DMA = 0x0200, //!< DMA clock SYSCTL_PERIPH_CLK_TIMER0 = 0x0300, //!< CPUTIMER0 clock SYSCTL_PERIPH_CLK_TIMER1 = 0x0400, //!< CPUTIMER1 clock SYSCTL_PERIPH_CLK_TIMER2 = 0x0500, //!< CPUTIMER2 clock SYSCTL_PERIPH_CLK_HRPWM = 0x1000, //!< HRPWM clock SYSCTL_PERIPH_CLK_TBCLKSYNC = 0x1200, //!< TBCLKSYNC clock SYSCTL_PERIPH_CLK_GTBCLKSYNC = 0x1300, //!< GTBCLKSYNC clock SYSCTL_PERIPH_CLK_EMIF1 = 0x0001, //!< EMIF1 clock SYSCTL_PERIPH_CLK_EMIF2 = 0x0101, //!< EMIF2 clock SYSCTL_PERIPH_CLK_EPWM1 = 0x0002, //!< EPWM1 clock SYSCTL_PERIPH_CLK_EPWM2 = 0x0102, //!< EPWM2 clock SYSCTL_PERIPH_CLK_EPWM3 = 0x0202, //!< EPWM3 clock SYSCTL_PERIPH_CLK_EPWM4 = 0x0302, //!< EPWM4 clock SYSCTL_PERIPH_CLK_EPWM5 = 0x0402, //!< EPWM5 clock SYSCTL_PERIPH_CLK_EPWM6 = 0x0502, //!< EPWM6 clock SYSCTL_PERIPH_CLK_EPWM7 = 0x0602, //!< EPWM7 clock SYSCTL_PERIPH_CLK_EPWM8 = 0x0702, //!< EPWM8 clock SYSCTL_PERIPH_CLK_EPWM9 = 0x0802, //!< EPWM9 clock SYSCTL_PERIPH_CLK_EPWM10 = 0x0902, //!< EPWM10 clock SYSCTL_PERIPH_CLK_EPWM11 = 0x0A02, //!< EPWM11 clock SYSCTL_PERIPH_CLK_EPWM12 = 0x0B02, //!< EPWM12 clock SYSCTL_PERIPH_CLK_ECAP1 = 0x0003, //!< ECAP1 clock SYSCTL_PERIPH_CLK_ECAP2 = 0x0103, //!< ECAP2 clock SYSCTL_PERIPH_CLK_ECAP3 = 0x0203, //!< ECAP3 clock SYSCTL_PERIPH_CLK_ECAP4 = 0x0303, //!< ECAP4 clock SYSCTL_PERIPH_CLK_ECAP5 = 0x0403, //!< ECAP5 clock SYSCTL_PERIPH_CLK_ECAP6 = 0x0503, //!< ECAP6 clock SYSCTL_PERIPH_CLK_EQEP1 = 0x0004, //!< EQEP1 clock SYSCTL_PERIPH_CLK_EQEP2 = 0x0104, //!< EQEP2 clock SYSCTL_PERIPH_CLK_EQEP3 = 0x0204, //!< EQEP3 clock SYSCTL_PERIPH_CLK_SD1 = 0x0006, //!< SD1 clock SYSCTL_PERIPH_CLK_SD2 = 0x0106, //!< SD2 clock SYSCTL_PERIPH_CLK_SCIA = 0x0007, //!< SCI_A clock SYSCTL_PERIPH_CLK_SCIB = 0x0107, //!< SCI_B clock SYSCTL_PERIPH_CLK_SCIC = 0x0207, //!< SCI_C clock SYSCTL_PERIPH_CLK_SCID = 0x0307, //!< SCI_D clock SYSCTL_PERIPH_CLK_SPIA = 0x0008, //!< SPI_A clock SYSCTL_PERIPH_CLK_SPIB = 0x0108, //!< SPI_B clock SYSCTL_PERIPH_CLK_SPIC = 0x0208, //!< SPI_C clock SYSCTL_PERIPH_CLK_I2CA = 0x0009, //!< I2C_A clock SYSCTL_PERIPH_CLK_I2CB = 0x0109, //!< I2C_B clock SYSCTL_PERIPH_CLK_CANA = 0x000A, //!< CAN_A clock SYSCTL_PERIPH_CLK_CANB = 0x010A, //!< CAN_B clock SYSCTL_PERIPH_CLK_MCBSPA = 0x000B, //!< MCBSP_A clock SYSCTL_PERIPH_CLK_MCBSPB = 0x010B, //!< MCBSP_B clock SYSCTL_PERIPH_CLK_USBA = 0x100B, //!< USB_A clock SYSCTL_PERIPH_CLK_UPPA = 0x000C, //!< UPP_A clock SYSCTL_PERIPH_CLK_ADCA = 0x000D, //!< ADC_A clock SYSCTL_PERIPH_CLK_ADCB = 0x010D, //!< ADC_B clock SYSCTL_PERIPH_CLK_ADCC = 0x020D, //!< ADC_C clock SYSCTL_PERIPH_CLK_ADCD = 0x030D, //!< ADC_D clock SYSCTL_PERIPH_CLK_CMPSS1 = 0x000E, //!< CMPSS1 clock SYSCTL_PERIPH_CLK_CMPSS2 = 0x010E, //!< CMPSS2 clock SYSCTL_PERIPH_CLK_CMPSS3 = 0x020E, //!< CMPSS3 clock SYSCTL_PERIPH_CLK_CMPSS4 = 0x030E, //!< CMPSS4 clock SYSCTL_PERIPH_CLK_CMPSS5 = 0x040E, //!< CMPSS5 clock SYSCTL_PERIPH_CLK_CMPSS6 = 0x050E, //!< CMPSS6 clock SYSCTL_PERIPH_CLK_CMPSS7 = 0x060E, //!< CMPSS7 clock SYSCTL_PERIPH_CLK_CMPSS8 = 0x070E, //!< CMPSS8 clock SYSCTL_PERIPH_CLK_DACA = 0x1010, //!< DAC_A clock SYSCTL_PERIPH_CLK_DACB = 0x1110, //!< DAC_B clock SYSCTL_PERIPH_CLK_DACC = 0x1210 //!< DAC_C clock } SysCtl_PeripheralPCLOCKCR; //***************************************************************************** // //! The following are values that can be passed to SysCtl_resetPeripheral() as //! the \e peripheral parameter. // //***************************************************************************** typedef enum { SYSCTL_PERIPH_RES_CPU1CLA1 = 0x0000, //!< Reset CPU1_CLA1 clock SYSCTL_PERIPH_RES_CPU2CLA1 = 0x0200, //!< Reset CPU2_CLA1 clock SYSCTL_PERIPH_RES_EMIF1 = 0x0001, //!< Reset EMIF1 clock SYSCTL_PERIPH_RES_EMIF2 = 0x0101, //!< Reset EMIF2 clock SYSCTL_PERIPH_RES_EPWM1 = 0x0002, //!< Reset EPWM1 clock SYSCTL_PERIPH_RES_EPWM2 = 0x0102, //!< Reset EPWM2 clock SYSCTL_PERIPH_RES_EPWM3 = 0x0202, //!< Reset EPWM3 clock SYSCTL_PERIPH_RES_EPWM4 = 0x0302, //!< Reset EPWM4 clock SYSCTL_PERIPH_RES_EPWM5 = 0x0402, //!< Reset EPWM5 clock SYSCTL_PERIPH_RES_EPWM6 = 0x0502, //!< Reset EPWM6 clock SYSCTL_PERIPH_RES_EPWM7 = 0x0602, //!< Reset EPWM7 clock SYSCTL_PERIPH_RES_EPWM8 = 0x0702, //!< Reset EPWM8 clock SYSCTL_PERIPH_RES_EPWM9 = 0x0802, //!< Reset EPWM9 clock SYSCTL_PERIPH_RES_EPWM10 = 0x0902, //!< Reset EPWM10 clock SYSCTL_PERIPH_RES_EPWM11 = 0x0A02, //!< Reset EPWM11 clock SYSCTL_PERIPH_RES_EPWM12 = 0x0B02, //!< Reset EPWM12 clock SYSCTL_PERIPH_RES_ECAP1 = 0x0003, //!< Reset ECAP1 clock SYSCTL_PERIPH_RES_ECAP2 = 0x0103, //!< Reset ECAP2 clock SYSCTL_PERIPH_RES_ECAP3 = 0x0203, //!< Reset ECAP3 clock SYSCTL_PERIPH_RES_ECAP4 = 0x0303, //!< Reset ECAP4 clock SYSCTL_PERIPH_RES_ECAP5 = 0x0403, //!< Reset ECAP5 clock SYSCTL_PERIPH_RES_ECAP6 = 0x0503, //!< Reset ECAP6 clock SYSCTL_PERIPH_RES_EQEP1 = 0x0004, //!< Reset EQEP1 clock SYSCTL_PERIPH_RES_EQEP2 = 0x0104, //!< Reset EQEP2 clock SYSCTL_PERIPH_RES_EQEP3 = 0x0204, //!< Reset EQEP3 clock SYSCTL_PERIPH_RES_SD1 = 0x0006, //!< Reset SD1 clock SYSCTL_PERIPH_RES_SD2 = 0x0106, //!< Reset SD2 clock SYSCTL_PERIPH_RES_SCIA = 0x0007, //!< Reset SCI_A clock SYSCTL_PERIPH_RES_SCIB = 0x0107, //!< Reset SCI_B clock SYSCTL_PERIPH_RES_SCIC = 0x0207, //!< Reset SCI_C clock SYSCTL_PERIPH_RES_SCID = 0x0307, //!< Reset SCI_D clock SYSCTL_PERIPH_RES_SPIA = 0x0008, //!< Reset SPI_A clock SYSCTL_PERIPH_RES_SPIB = 0x0108, //!< Reset SPI_B clock SYSCTL_PERIPH_RES_SPIC = 0x0208, //!< Reset SPI_C clock SYSCTL_PERIPH_RES_I2CA = 0x0009, //!< Reset I2C_A clock SYSCTL_PERIPH_RES_I2CB = 0x0109, //!< Reset I2C_B clock SYSCTL_PERIPH_RES_MCBSPA = 0x000B, //!< Reset MCBSP_A clock SYSCTL_PERIPH_RES_MCBSPB = 0x010B, //!< Reset MCBSP_B clock SYSCTL_PERIPH_RES_USBA = 0x100B, //!< Reset USB_A clock SYSCTL_PERIPH_RES_ADCA = 0x000D, //!< Reset ADC_A clock SYSCTL_PERIPH_RES_ADCB = 0x010D, //!< Reset ADC_B clock SYSCTL_PERIPH_RES_ADCC = 0x020D, //!< Reset ADC_C clock SYSCTL_PERIPH_RES_ADCD = 0x030D, //!< Reset ADC_D clock SYSCTL_PERIPH_RES_CMPSS1 = 0x000E, //!< Reset CMPSS1 clock SYSCTL_PERIPH_RES_CMPSS2 = 0x010E, //!< Reset CMPSS2 clock SYSCTL_PERIPH_RES_CMPSS3 = 0x020E, //!< Reset CMPSS3 clock SYSCTL_PERIPH_RES_CMPSS4 = 0x030E, //!< Reset CMPSS4 clock SYSCTL_PERIPH_RES_CMPSS5 = 0x040E, //!< Reset CMPSS5 clock SYSCTL_PERIPH_RES_CMPSS6 = 0x050E, //!< Reset CMPSS6 clock SYSCTL_PERIPH_RES_CMPSS7 = 0x060E, //!< Reset CMPSS7 clock SYSCTL_PERIPH_RES_CMPSS8 = 0x070E, //!< Reset CMPSS8 clock SYSCTL_PERIPH_RES_DACA = 0x1010, //!< Reset DAC_A clock SYSCTL_PERIPH_RES_DACB = 0x1110, //!< Reset DAC_B clock SYSCTL_PERIPH_RES_DACC = 0x1210 //!< Reset DAC_C clock } SysCtl_PeripheralSOFTPRES; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_lockCPUSelectRegs() as the \e peripheral parameter. // //***************************************************************************** typedef enum { //! Configure CPU Select for EPWM SYSCTL_CPUSEL0_EPWM = 0x0U, //! Configure CPU Select for ECAP SYSCTL_CPUSEL1_ECAP = 0x1U, //! Configure CPU Select for EQEP SYSCTL_CPUSEL2_EQEP = 0x2U, //! Configure CPU Select for SD SYSCTL_CPUSEL4_SD = 0x4U, //! Configure CPU Select for SCI SYSCTL_CPUSEL5_SCI = 0x5U, //! Configure CPU Select for SPI SYSCTL_CPUSEL6_SPI = 0x6U, //! Configure CPU Select for I2C SYSCTL_CPUSEL7_I2C = 0x7U, //! Configure CPU Select for CAN SYSCTL_CPUSEL8_CAN = 0x8U, //! Configure CPU Select for MCBSP SYSCTL_CPUSEL9_MCBSP = 0x9U, //! Configure CPU Select for ADC SYSCTL_CPUSEL11_ADC = 0xBU, //! Configure CPU Select for CMPSS SYSCTL_CPUSEL12_CMPSS = 0xCU, //! Configure CPU Select for DAC SYSCTL_CPUSEL14_DAC = 0xEU } SysCtl_CPUSelPeripheral; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_selectCPUForPeripheralInstance() as the \e peripheral parameter. // //***************************************************************************** typedef enum { SYSCTL_CPUSEL_EPWM1 = 0x0000, SYSCTL_CPUSEL_EPWM2 = 0x0100, SYSCTL_CPUSEL_EPWM3 = 0x0200, SYSCTL_CPUSEL_EPWM4 = 0x0300, SYSCTL_CPUSEL_EPWM5 = 0x0400, SYSCTL_CPUSEL_EPWM6 = 0x0500, SYSCTL_CPUSEL_EPWM7 = 0x0600, SYSCTL_CPUSEL_EPWM8 = 0x0700, SYSCTL_CPUSEL_EPWM9 = 0x0800, SYSCTL_CPUSEL_EPWM10 = 0x0900, SYSCTL_CPUSEL_EPWM11 = 0x0A00, SYSCTL_CPUSEL_EPWM12 = 0x0B00, SYSCTL_CPUSEL_ECAP1 = 0x0001, SYSCTL_CPUSEL_ECAP2 = 0x0101, SYSCTL_CPUSEL_ECAP3 = 0x0201, SYSCTL_CPUSEL_ECAP4 = 0x0301, SYSCTL_CPUSEL_ECAP5 = 0x0401, SYSCTL_CPUSEL_ECAP6 = 0x0501, SYSCTL_CPUSEL_EQEP1 = 0x0002, SYSCTL_CPUSEL_EQEP2 = 0x0102, SYSCTL_CPUSEL_EQEP3 = 0x0202, SYSCTL_CPUSEL_SD1 = 0x0004, SYSCTL_CPUSEL_SD2 = 0x0104, SYSCTL_CPUSEL_SCIA = 0x0005, SYSCTL_CPUSEL_SCIB = 0x0105, SYSCTL_CPUSEL_SCIC = 0x0205, SYSCTL_CPUSEL_SCID = 0x0305, SYSCTL_CPUSEL_SPIA = 0x0006, SYSCTL_CPUSEL_SPIB = 0x0106, SYSCTL_CPUSEL_SPIC = 0x0206, SYSCTL_CPUSEL_I2CA = 0x0007, SYSCTL_CPUSEL_I2CB = 0x0107, SYSCTL_CPUSEL_CANA = 0x0008, SYSCTL_CPUSEL_CANB = 0x0108, SYSCTL_CPUSEL_MCBSPA = 0x0009, SYSCTL_CPUSEL_MCBSPB = 0x0109, SYSCTL_CPUSEL_ADCA = 0x000B, SYSCTL_CPUSEL_ADCB = 0x010B, SYSCTL_CPUSEL_ADCC = 0x020B, SYSCTL_CPUSEL_ADCD = 0x030B, SYSCTL_CPUSEL_CMPSS1 = 0x000C, SYSCTL_CPUSEL_CMPSS2 = 0x010C, SYSCTL_CPUSEL_CMPSS3 = 0x020C, SYSCTL_CPUSEL_CMPSS4 = 0x030C, SYSCTL_CPUSEL_CMPSS5 = 0x040C, SYSCTL_CPUSEL_CMPSS6 = 0x050C, SYSCTL_CPUSEL_CMPSS7 = 0x060C, SYSCTL_CPUSEL_CMPSS8 = 0x070C, SYSCTL_CPUSEL_DACA = 0x100E, SYSCTL_CPUSEL_DACB = 0x110E, SYSCTL_CPUSEL_DACC = 0x120E } SysCtl_CPUSelPeriphInstance; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_selectCPUForPeripheral() as \e cpuInst parameter. // //***************************************************************************** typedef enum { //! Connect the peripheral (indicated by SysCtl_CPUSelPeripheral) to CPU1 SYSCTL_CPUSEL_CPU1 = 0x0U, //! Connect the peripheral (indicated by SysCtl_CPUSelPeripheral) to CPU2 SYSCTL_CPUSEL_CPU2 = 0x1U } SysCtl_CPUSel; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_setWatchdogPrescaler() as the \e prescaler parameter. // //***************************************************************************** typedef enum { SYSCTL_WD_PRESCALE_1 = 1, //!< WDCLK = PREDIVCLK / 1 SYSCTL_WD_PRESCALE_2 = 2, //!< WDCLK = PREDIVCLK / 2 SYSCTL_WD_PRESCALE_4 = 3, //!< WDCLK = PREDIVCLK / 4 SYSCTL_WD_PRESCALE_8 = 4, //!< WDCLK = PREDIVCLK / 8 SYSCTL_WD_PRESCALE_16 = 5, //!< WDCLK = PREDIVCLK / 16 SYSCTL_WD_PRESCALE_32 = 6, //!< WDCLK = PREDIVCLK / 32 SYSCTL_WD_PRESCALE_64 = 7 //!< WDCLK = PREDIVCLK / 64 } SysCtl_WDPrescaler; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_setWatchdogMode() as the \e prescaler parameter. // //***************************************************************************** typedef enum { //! Watchdog can generate a reset signal SYSCTL_WD_MODE_RESET, //! Watchdog can generate an interrupt signal; reset signal is disabled SYSCTL_WD_MODE_INTERRUPT } SysCtl_WDMode; //***************************************************************************** // //! The following are values that can be passed to SysCtl_setLowSpeedClock() as //! the \e prescaler parameter. // //***************************************************************************** typedef enum { SYSCTL_LSPCLK_PRESCALE_1 = 0, //!< LSPCLK = SYSCLK / 1 SYSCTL_LSPCLK_PRESCALE_2 = 1, //!< LSPCLK = SYSCLK / 2 SYSCTL_LSPCLK_PRESCALE_4 = 2, //!< LSPCLK = SYSCLK / 4 (default) SYSCTL_LSPCLK_PRESCALE_6 = 3, //!< LSPCLK = SYSCLK / 6 SYSCTL_LSPCLK_PRESCALE_8 = 4, //!< LSPCLK = SYSCLK / 8 SYSCTL_LSPCLK_PRESCALE_10 = 5, //!< LSPCLK = SYSCLK / 10 SYSCTL_LSPCLK_PRESCALE_12 = 6, //!< LSPCLK = SYSCLK / 12 SYSCTL_LSPCLK_PRESCALE_14 = 7 //!< LSPCLK = SYSCLK / 14 } SysCtl_LSPCLKPrescaler; //***************************************************************************** // //! The following are values that can be passed to SysCtl_setEPWMClockDivider() //! as the \e divider parameter. // //***************************************************************************** typedef enum { SYSCTL_EPWMCLK_DIV_1, //!< EPWMCLK = PLLSYSCLK / 1 SYSCTL_EPWMCLK_DIV_2 //!< EPWMCLK = PLLSYSCLK / 2 } SysCtl_EPWMCLKDivider; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_setEMIF1ClockDivider() as the \e divider parameter. // //***************************************************************************** typedef enum { SYSCTL_EMIF1CLK_DIV_1, //!< EMIF1CLK = PLLSYSCLK / 1 SYSCTL_EMIF1CLK_DIV_2 //!< EMIF1CLK = PLLSYSCLK / 2 } SysCtl_EMIF1CLKDivider; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_setEMIF2ClockDivider() as the \e divider parameter. // //***************************************************************************** typedef enum { SYSCTL_EMIF2CLK_DIV_1, //!< EMIF2CLK = PLLSYSCLK / 1 SYSCTL_EMIF2CLK_DIV_2 //!< EMIF2CLK = PLLSYSCLK / 2 } SysCtl_EMIF2CLKDivider; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_selectClockOutSource() as the \e source parameter. // //***************************************************************************** typedef enum { SYSCTL_CLOCKOUT_PLLSYS = 0U, //!< PLL System Clock post SYSCLKDIV SYSCTL_CLOCKOUT_PLLRAW = 1U, //!< PLL Raw Clock SYSCTL_CLOCKOUT_SYSCLK = 2U, //!< CPU System Clock SYSCTL_CLOCKOUT_INTOSC1 = 5U, //!< Internal Oscillator 1 SYSCTL_CLOCKOUT_INTOSC2 = 6U, //!< Internal Oscillator 2 SYSCTL_CLOCKOUT_XTALOSC = 7U, //!< External Oscillator } SysCtl_ClockOut; //***************************************************************************** // //! The following values define the \e syncInput parameter for //! SysCtl_setSyncInputConfig(). // //***************************************************************************** typedef enum { SYSCTL_SYNC_IN_EPWM4 = 0, //!< Sync input to EPWM4 SYSCTL_SYNC_IN_EPWM7 = 3, //!< Sync input to EPWM7 SYSCTL_SYNC_IN_EPWM10 = 6, //!< Sync input to EPWM10 SYSCTL_SYNC_IN_ECAP1 = 9, //!< Sync input to ECAP1 SYSCTL_SYNC_IN_ECAP4 = 12 //!< Sync input to ECAP4 } SysCtl_SyncInput; //***************************************************************************** // //! The following values define the \e syncSrc parameter for //! SysCtl_setSyncInputConfig(). Note that some of these are only valid for //! certain values of \e syncInput. See device technical reference manual for //! info on time-base counter synchronization for details. // //***************************************************************************** typedef enum { //! EPWM1SYNCOUT SYSCTL_SYNC_IN_SRC_EPWM1SYNCOUT = 0, //! EPWM4SYNCOUT SYSCTL_SYNC_IN_SRC_EPWM4SYNCOUT = 1, //! EPWM7SYNCOUT SYSCTL_SYNC_IN_SRC_EPWM7SYNCOUT = 2, //! EPWM10SYNCOUT SYSCTL_SYNC_IN_SRC_EPWM10SYNCOUT = 3, //! ECAP1SYNCOUT SYSCTL_SYNC_IN_SRC_ECAP1SYNCOUT = 4, //! EXTSYNCIN1--Valid for all values of syncInput SYSCTL_SYNC_IN_SRC_EXTSYNCIN1 = 5, //! EXTSYNCIN2--Valid for all values of syncInput SYSCTL_SYNC_IN_SRC_EXTSYNCIN2 = 6, } SysCtl_SyncInputSource; //***************************************************************************** // //! The following values define the \e syncSrc parameter for //! SysCtl_setSyncOutputConfig(). // //***************************************************************************** typedef enum { SYSCTL_SYNC_OUT_SRC_EPWM1SYNCOUT, //!< EPWM1SYNCOUT --> EXTSYNCOUT SYSCTL_SYNC_OUT_SRC_EPWM4SYNCOUT, //!< EPWM4SYNCOUT --> EXTSYNCOUT SYSCTL_SYNC_OUT_SRC_EPWM7SYNCOUT, //!< EPWM7SYNCOUT --> EXTSYNCOUT SYSCTL_SYNC_OUT_SRC_EPWM10SYNCOUT //!< EPWM10SYNCOUT --> EXTSYNCOUT } SysCtl_SyncOutputSource; //***************************************************************************** // //! The following values define the \e parametric parameter for //! SysCtl_getDeviceParametric(). // //***************************************************************************** typedef enum { SYSCTL_DEVICE_QUAL, //!< Device Qualification Status SYSCTL_DEVICE_PINCOUNT, //!< Device Pin Count SYSCTL_DEVICE_INSTASPIN, //!< Device InstaSPIN Feature Set SYSCTL_DEVICE_FLASH, //!< Device Flash size (KB) SYSCTL_DEVICE_PARTID, //!< Device Part ID Format Revision SYSCTL_DEVICE_FAMILY, //!< Device Family SYSCTL_DEVICE_PARTNO, //!< Device Part Number SYSCTL_DEVICE_CLASSID //!< Device Class ID } SysCtl_DeviceParametric; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_setXClk() as \e divider parameter. // //***************************************************************************** typedef enum { SYSCTL_XCLKOUT_DIV_1 = 0, //!< XCLKOUT = XCLKOUT / 1 SYSCTL_XCLKOUT_DIV_2 = 1, //!< XCLKOUT = XCLKOUT / 2 SYSCTL_XCLKOUT_DIV_4 = 2, //!< XCLKOUT = XCLKOUT / 4 SYSCTL_XCLKOUT_DIV_8 = 3 //!< XCLKOUT = XCLKOUT / 8 }SysCtl_XClkDivider; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_setAuxPLLClk() as \e divider parameter. // //***************************************************************************** typedef enum { SYSCTL_AUXPLLCLK_DIV_1, //!< AUXPLL clock = AUXPLL clock / 1 SYSCTL_AUXPLLCLK_DIV_2, //!< AUXPLL clock = AUXPLL clock / 2 SYSCTL_AUXPLLCLK_DIV_4, //!< AUXPLL clock = AUXPLL clock / 4 SYSCTL_AUXPLLCLK_DIV_8, //!< AUXPLL clock = AUXPLL clock / 8 SYSCTL_AUXPLLCLK_DIV_3, //!< AUXPLL clock = AUXPLL clock / 3 SYSCTL_AUXPLLCLK_DIV_5, //!< AUXPLL clock = AUXPLL clock / 5 SYSCTL_AUXPLLCLK_DIV_6, //!< AUXPLL clock = AUXPLL clock / 6 SYSCTL_AUXPLLCLK_DIV_7 //!< AUXPLL clock = AUXPLL clock / 7 }SysCtl_AuxPLLClkDivider; //***************************************************************************** // //! The following are values that can be passed to //! SysCtl_setCputimer2Clk() as \e divider parameter. // //***************************************************************************** typedef enum { SYSCTL_TMR2CLKPRESCALE_1, //!< Cputimer2 clock = Cputimer2 clock / 1 SYSCTL_TMR2CLKPRESCALE_2, //!< Cputimer2 clock = Cputimer2 clock / 2 SYSCTL_TMR2CLKPRESCALE_4, //!< Cputimer2 clock = Cputimer2 clock / 4 SYSCTL_TMR2CLKPRESCALE_8, //!< Cputimer2 clock = Cputimer2 clock / 8 SYSCTL_TMR2CLKPRESCALE_16 //!< Cputimer2 clock = Cputimer2 clock / 16 }SysCtl_Cputimer2ClkDivider; //***************************************************************************** // //! The following are values that can be passed to SysCtl_setCputimer2Clk() //! as \e source parameter. // //***************************************************************************** typedef enum { SYSCTL_TMR2CLKSRCSEL_SYSCLK = 0U, //!< System Clock SYSCTL_TMR2CLKSRCSEL_INTOSC1 = 1U, //!< Internal Oscillator 1 SYSCTL_TMR2CLKSRCSEL_INTOSC2 = 2U, //!< Internal Oscillator 2 SYSCTL_TMR2CLKSRCSEL_XTAL = 3U, //!< Crystal oscillator SYSCTL_TMR2CLKSRCSEL_AUXPLLCLK = 6U //!< Aux PLL CLock }SysCtl_Cputimer2ClkSource; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! Wrapper function for Device_cal function //! //! \param None //! //! This is a wrapper function for the Device_cal function available in the OTP //! memory. //! The function saves and restores the core registers which are being //! used by the Device_cal function //! //! \return None. // //***************************************************************************** static inline void SysCtl_deviceCal(void) { // // Save the core registers used by Device_cal function in the stack // asm(" PUSH ACC \n PUSH DP \n PUSH XAR0 \n PUSH XAR2 \n PUSH XAR3 \n PUSH XAR4 \n PUSH XAR5 \n "); // // Call the Device_cal function // ((void (*)(void))((uintptr_t)0x070282))(); // // Restore the core registers // asm(" POP XAR5 \n POP XAR4 \n POP XAR3 \n POP XAR2 \n POP XAR0 \n POP DP \n POP ACC \n "); } //***************************************************************************** // //! Resets a peripheral //! //! \param peripheral is the peripheral to reset. //! //! This function uses the SOFTPRESx registers to reset a specified peripheral. //! Module registers will be returned to their reset states. //! //! \note This includes registers containing trim values.The peripheral //! software reset needed by CPU2 can be communicated to CPU1 via //! IPC for all shared peripherals. //! //! \return None. // //***************************************************************************** static inline void SysCtl_resetPeripheral(SysCtl_PeripheralSOFTPRES peripheral) { uint16_t regIndex; uint16_t bitIndex; // // Decode the peripheral variable. // regIndex = (uint16_t)2U * ((uint16_t)peripheral & (uint16_t)0x001FU); bitIndex = ((uint16_t)peripheral & 0x1F00U) >> 0x0008U; __eallow(); // // Sets the appropriate reset bit and then clears it. // (*((volatile uint32_t *)(0x0005D000U + 0x82U + regIndex))) |= (1UL << bitIndex); (*((volatile uint32_t *)(0x0005D000U + 0x82U + regIndex))) &= ~(1UL << bitIndex); // // Call Device_cal function // if((((uint16_t)peripheral & 0x001FU) == 0xDU) || // ADCx (((uint16_t)peripheral & 0x001FU) == 0x10U) // DACx ) { SysCtl_deviceCal(); } __edis(); } //***************************************************************************** // //! Enables a peripheral. //! //! \param peripheral is the peripheral to enable. //! //! Peripherals are enabled with this function. At power-up, all peripherals //! are disabled; they must be enabled in order to operate or respond to //! register reads/writes. //! //! \note Note that there should be atleast 5 cycles delay between enabling the //! peripheral clock and accessing the peripheral registers. The delay should be //! added by the user if the peripheral is accessed immediately after this //! function call. //! Use asm(" RPT #5 || NOP"); to add 5 cycle delay post this function call. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enablePeripheral(SysCtl_PeripheralPCLOCKCR peripheral) { uint16_t regIndex; uint16_t bitIndex; // // Decode the peripheral variable. // regIndex = (uint16_t)2U * ((uint16_t)peripheral & (uint16_t)0x001FU); bitIndex = ((uint16_t)peripheral & 0x1F00U) >> 0x0008U; __eallow(); // // Turn on the module clock. // (*((volatile uint32_t *)(0x0005D300U + 0x22U + regIndex))) |= (1UL << bitIndex); __edis(); } //***************************************************************************** // //! Disables a peripheral. //! //! \param peripheral is the peripheral to disable. //! //! Peripherals are disabled with this function. Once disabled, they will not //! operate or respond to register reads/writes. //! //! \return None. // //***************************************************************************** static inline void SysCtl_disablePeripheral(SysCtl_PeripheralPCLOCKCR peripheral) { uint16_t regIndex; uint16_t bitIndex; // // Decode the peripheral variable. // regIndex = (uint16_t)2U * ((uint16_t)peripheral & (uint16_t)0x001FU); bitIndex = ((uint16_t)peripheral & 0x1F00U) >> 0x0008U; __eallow(); // // Turn off the module clock. // (*((volatile uint32_t *)(0x0005D300U + 0x22U + regIndex))) &= ~(1UL << bitIndex); __edis(); } //***************************************************************************** // //! Resets the device. //! //! This function performs a watchdog reset of the device. //! //! \return This function does not return. // //***************************************************************************** static inline void SysCtl_resetDevice(void) { // // Write an incorrect check value to the watchdog control register // This will cause a device reset // __eallow(); // // Enable the watchdog // (*((volatile uint16_t *)(0x00007000U + 0x29U))) = 0x0028U; asm(" RPT #69 || NOP"); // // Write a bad check value // (*((volatile uint16_t *)(0x00007000U + 0x29U))) = 0U; asm(" RPT #69 || NOP"); __edis(); // // The device should have reset, so this should never be reached. Just in // case, loop forever. // while((_Bool)1) { } } //***************************************************************************** // //! Gets the reason for a reset. //! //! This function will return the reason(s) for a reset. Since the reset //! reasons are sticky until either cleared by software or an external reset, //! multiple reset reasons may be returned if multiple resets have occurred. //! The reset reason will be a logical OR of //! - \b SYSCTL_CAUSE_POR - Power-on reset //! - \b SYSCTL_CAUSE_XRS - External reset pin //! - \b SYSCTL_CAUSE_WDRS - Watchdog reset //! - \b SYSCTL_CAUSE_NMIWDRS - NMI watchdog reset //! - \b SYSCTL_CAUSE_SCCRESET - SCCRESETn reset from DCSM //! //! \note If you re-purpose the reserved boot ROM RAM, the POR and XRS reset //! statuses won't be accurate. //! //! \return Returns the reason(s) for a reset. // //***************************************************************************** static inline uint32_t SysCtl_getResetCause(void) { uint32_t resetCauses; // // Read CPU reset register // resetCauses = (*((volatile uint32_t *)(0x0005D300U + 0x80U))) & ((uint32_t)0x1U | (uint32_t)0x2U | (uint32_t)0x4U | (uint32_t)0x8U | (uint32_t)0x100U ); // // Set POR and XRS Causes from boot ROM Status // if(((*((volatile uint32_t *)(0x002CU))) & (uint32_t)0x8000U) == (uint32_t)0x8000U) { resetCauses |= 0x1U; } if(((*((volatile uint32_t *)(0x002CU))) & (uint32_t)0x4000U) == (uint32_t)0x4000U) { resetCauses |= 0x2U; } // // Return the reset reasons. // return(resetCauses); } //***************************************************************************** // //! Clears reset reasons. //! //! \param rstCauses are the reset causes to be cleared; must be a logical //! OR of //! - \b SYSCTL_CAUSE_POR - Power-on reset //! - \b SYSCTL_CAUSE_XRS - External reset pin //! - \b SYSCTL_CAUSE_WDRS - Watchdog reset //! - \b SYSCTL_CAUSE_NMIWDRS - NMI watchdog reset //! - \b SYSCTL_CAUSE_SCCRESET - SCCRESETn reset from DCSM //! //! This function clears the specified sticky reset reasons. Once cleared, //! another reset for the same reason can be detected, and a reset for a //! different reason can be distinguished (instead of having two reset causes //! set). If the reset reason is used by an application, all reset causes //! should be cleared after they are retrieved with SysCtl_getResetCause(). //! //! \note Some reset causes are cleared by the boot ROM. //! //! \return None. // //***************************************************************************** static inline void SysCtl_clearResetCause(uint32_t rstCauses) { // // Clear the given reset reasons. // (*((volatile uint32_t *)(0x0005D300U + 0x80U))) = rstCauses; } //***************************************************************************** // //! Sets the low speed peripheral clock rate prescaler. //! //! \param prescaler is the LSPCLK rate relative to SYSCLK //! //! This function configures the clock rate of the low speed peripherals. The //! \e prescaler parameter is the value by which the SYSCLK rate is divided to //! get the LSPCLK rate. For example, a \e prescaler of //! \b SYSCTL_LSPCLK_PRESCALE_4 will result in a LSPCLK rate that is a quarter //! of the SYSCLK rate. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setLowSpeedClock(SysCtl_LSPCLKPrescaler prescaler) { // // Write the divider selection to the appropriate register. // __eallow(); (*((volatile uint32_t *)(0x0005D200U + 0x2CU))) = ((*((volatile uint32_t *)(0x0005D200U + 0x2CU))) & ~(uint32_t)0x7U) | (uint32_t)prescaler; __edis(); } //***************************************************************************** // //! Sets the ePWM clock divider. //! //! \param divider is the value by which PLLSYSCLK is divided //! //! This function configures the clock rate of the EPWMCLK. The //! \e divider parameter is the value by which the SYSCLK rate is divided to //! get the EPWMCLK rate. For example, \b SYSCTL_EPWMCLK_DIV_2 will select an //! EPWMCLK rate that is half the PLLSYSCLK rate. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setEPWMClockDivider(SysCtl_EPWMCLKDivider divider) { // // Write the divider selection to the appropriate register. // __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x26U))) = ((*((volatile uint16_t *)(0x0005D200U + 0x26U))) & ~0x3U) | (uint16_t)divider; asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Sets the EMIF1 clock divider. //! //! \param divider is the value by which PLLSYSCLK (or CPU1.SYSCLK on a dual //! core device) is divided //! //! This function configures the clock rate of the EMIF1CLK. The //! \e divider parameter is the value by which the SYSCLK rate is divided to //! get the EMIF1CLK rate. For example, \b SYSCTL_EMIF1CLK_DIV_2 will select an //! EMIF1CLK rate that is half the PLLSYSCLK (or CPU1.SYSCLK on a dual //! core device) rate. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setEMIF1ClockDivider(SysCtl_EMIF1CLKDivider divider) { // // Write the divider selection to the appropriate register. // __eallow(); if(divider == SYSCTL_EMIF1CLK_DIV_2) { (*((volatile uint16_t *)(0x0005D200U + 0x26U))) |= 0x10U; asm(" RPT #69 || NOP"); } else { (*((volatile uint16_t *)(0x0005D200U + 0x26U))) &= ~0x10U; asm(" RPT #69 || NOP"); } __edis(); } //***************************************************************************** // //! Sets the EMIF2 clock divider. //! //! \param divider is the value by which PLLSYSCLK (or CPU1.SYSCLK on a dual //! core device) is divided //! //! This function configures the clock rate of the EMIF2CLK. The //! \e divider parameter is the value by which the SYSCLK rate is divided to //! get the EMIF2CLK rate. For example, \b SYSCTL_EMIF2CLK_DIV_2 will select an //! EMIF2CLK rate that is half the PLLSYSCLK (or CPU1.SYSCLK on a dual //! core device) rate. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setEMIF2ClockDivider(SysCtl_EMIF2CLKDivider divider) { // // Write the divider selection to the appropriate register. // __eallow(); if(divider == SYSCTL_EMIF2CLK_DIV_2) { (*((volatile uint16_t *)(0x0005D200U + 0x26U))) |= 0x40U; asm(" RPT #69 || NOP"); } else { (*((volatile uint16_t *)(0x0005D200U + 0x26U))) &= ~0x40U; asm(" RPT #69 || NOP"); } __edis(); } //***************************************************************************** // //! Selects a clock source to mux to an external GPIO pin (XCLKOUT). //! //! \param source is the internal clock source to be configured. //! //! This function configures the specified clock source to be muxed to an //! external clock out (XCLKOUT) GPIO pin. The \e source parameter may take a //! value of one of the following values: //! - \b SYSCTL_CLOCKOUT_PLLSYS //! - \b SYSCTL_CLOCKOUT_PLLRAW //! - \b SYSCTL_CLOCKOUT_SYSCLK //! - \b SYSCTL_CLOCKOUT_INTOSC1 //! - \b SYSCTL_CLOCKOUT_INTOSC2 //! - \b SYSCTL_CLOCKOUT_XTALOSC //! //! \return None. // //***************************************************************************** static inline void SysCtl_selectClockOutSource(SysCtl_ClockOut source) { __eallow(); // // Clear clock out source // (*((volatile uint16_t *)(0x0005D200U + 0xCU))) &= ~0x7U; asm(" RPT #250 || NOP \n RPT #50 || NOP"); // // Set clock out source // (*((volatile uint16_t *)(0x0005D200U + 0xCU))) |= (uint16_t)source; __edis(); } //***************************************************************************** // //! Gets the external oscillator counter value. //! //! This function returns the X1 clock counter value. When the return value //! reaches 0x3FF, it freezes. Before switching from INTOSC2 to an external //! oscillator (XTAL), an application should call this function to make sure //! the counter is saturated. //! //! \return Returns the value of the 10-bit X1 clock counter. // //***************************************************************************** static inline uint16_t SysCtl_getExternalOscCounterValue(void) { return((*((volatile uint16_t *)(0x0005D200U + 0x30U))) & 0x3FFU); } //***************************************************************************** // //! Turns on the specified oscillator sources. //! //! \param oscSource is the oscillator source to be configured. //! //! This function turns on the oscillator specified by the \e oscSource //! parameter which may take a value of \b SYSCTL_OSCSRC_XTAL //! or \b SYSCTL_OSCSRC_OSC2. //! //! \note \b SYSCTL_OSCSRC_OSC1 is not a valid value for \e oscSource. //! //! \return None. // //***************************************************************************** static inline void SysCtl_turnOnOsc(uint32_t oscSource) { do { if(!((oscSource == 0x00000000UL) || (oscSource == 0x00010000U))) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 1370); } } while((_Bool)0); __eallow(); switch(oscSource) { case 0x00000000UL: // // Turn on INTOSC2 // (*((volatile uint16_t *)(0x0005D200U + 0x8U))) &= ~0x8U; asm(" RPT #250 || NOP \n RPT #50 || NOP"); break; case 0x00010000U: // // Turn on XTALOSC // (*((volatile uint16_t *)(0x0005D200U + 0x8U))) &= ~0x10U; break; default: // // Do nothing. Not a valid oscSource value. // break; } __edis(); } //***************************************************************************** // //! Turns off the specified oscillator sources. //! //! \param oscSource is the oscillator source to be configured. //! //! This function turns off the oscillator specified by the \e oscSource //! parameter which may take a value of \b SYSCTL_OSCSRC_XTAL //! or \b SYSCTL_OSCSRC_OSC2. //! //! \note \b SYSCTL_OSCSRC_OSC1 is not a valid value for \e oscSource. //! //! \return None. // //***************************************************************************** static inline void SysCtl_turnOffOsc(uint32_t oscSource) { do { if(!((oscSource == 0x00000000UL) || (oscSource == 0x00010000U))) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 1425); } } while((_Bool)0); __eallow(); switch(oscSource) { case 0x00000000UL: // // Turn off INTOSC2 // (*((volatile uint16_t *)(0x0005D200U + 0x8U))) |= 0x8U; asm(" RPT #250 || NOP \n RPT #50 || NOP"); break; case 0x00010000U: // // Turn off XTALOSC // (*((volatile uint16_t *)(0x0005D200U + 0x8U))) |= 0x10U; break; default: // // Do nothing. Not a valid oscSource value. // break; } __edis(); } //***************************************************************************** // //! Enters IDLE mode. //! //! This function puts the device into IDLE mode. The CPU clock is gated while //! all peripheral clocks are left running. Any enabled interrupt will wake the //! CPU up from IDLE mode. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enterIdleMode(void) { __eallow(); // // Configure the device to go into IDLE mode when IDLE is executed. // (*((volatile uint32_t *)(0x0005D300U + 0x76U))) = ((*((volatile uint32_t *)(0x0005D300U + 0x76U))) & ~(uint32_t)0x3U) | 0x0000U; __edis(); __asm(" IDLE"); } //***************************************************************************** // //! Enters STANDBY mode. //! //! This function puts the device into STANDBY mode. This will gate both the //! CPU clock and any peripheral clocks derived from SYSCLK. The watchdog is //! left active, and an NMI or an optional watchdog interrupt will wake the //! CPU subsystem from STANDBY mode. //! //! GPIOs may be configured to wake the CPU subsystem. See //! SysCtl_enableLPMWakeupPin(). //! //! The CPU will receive an interrupt (WAKEINT) on wakeup. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enterStandbyMode(void) { __eallow(); // // Configure the device to go into STANDBY mode when IDLE is executed. // (*((volatile uint32_t *)(0x0005D300U + 0x76U))) = ((*((volatile uint32_t *)(0x0005D300U + 0x76U))) & ~(uint32_t)0x3U) | 0x0001U; __edis(); __asm(" IDLE"); } //***************************************************************************** // //! Enters HALT mode. //! //! This function puts the device into HALT mode. This will gate almost all //! systems and clocks and allows for the power-down of oscillators and analog //! blocks. The watchdog may be left clocked to produce a reset. See //! SysCtl_enableWatchdogInHalt() to enable this. GPIOs should be //! configured to wake the CPU subsystem. See SysCtl_enableLPMWakeupPin(). //! //! Enter HALT mode (dual CPU). Puts CPU2 in IDLE mode first. //! //! The CPU will receive an interrupt (WAKEINT) on wakeup. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enterHaltMode(void) { __eallow(); // // Configure the device to go into HALT mode when IDLE is executed. // (*((volatile uint32_t *)(0x0005D300U + 0x76U))) = ((*((volatile uint32_t *)(0x0005D300U + 0x76U))) & ~(uint32_t)0x3U) | 0x0002U; (*((volatile uint16_t *)(0x0005D200U + 0xEU))) &= ~(0x2U | 0x1U); asm(" RPT #69 || NOP"); __edis(); __asm(" IDLE"); } //***************************************************************************** // //! Enters Hibernate mode. //! //! This function puts the device into Hibernate mode. Hibernate (HIB) is a //! global low-power mode that gates the supply voltages to most of the system. //! This mode affects both CPU subsystems. HIB is essentially a controlled //! power-down with remote wakeup capability, and can be used to save power //! during long periods of inactivity. //! //! To wake the device from HIB mode: //! 1. Assert the dedicated GPIOHIBWAKE pin (GPIO41) low to enable the //! power-up of the device clock sources. //! 2. Assert GPIOHIBWAKE pin high again. This triggers the power-up of the //! rest of the device. //! //! To enter Hibernate mode in dual CPU put CPU2 in STANDBY mode first. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enterHibernateMode(void) { __eallow(); // // Configure the device to go into Hibernate mode when IDLE is executed // (*((volatile uint32_t *)(0x0005D300U + 0x76U))) = ((*((volatile uint32_t *)(0x0005D300U + 0x76U))) & ~(uint32_t)0x3U) | 0x0003U; (*((volatile uint16_t *)(0x0005D200U + 0xEU))) &= ~(0x2U | 0x1U); asm(" RPT #69 || NOP"); __edis(); __asm(" IDLE"); } //***************************************************************************** //! Enables a pin to wake up the device from the following mode(s): //! - STANDBY //! - HALT //! //! \param pin is the identifying number of the pin. //! //! This function connects a pin to the LPM circuit, allowing an event on the //! pin to wake up the device when when it is in following mode(s): //! - STANDBY //! - HALT //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. Only GPIOs 0 through 63 are capable of //! being connected to the LPM circuit. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableLPMWakeupPin(uint32_t pin) { uint32_t pinMask; // // Check the arguments. // do { if(!(pin <= 63U)) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 1670); } } while((_Bool)0); pinMask = 1UL << (pin % 32U); __eallow(); if(pin < 32U) { (*((volatile uint32_t *)(0x0005D300U + 0x78U))) |= pinMask; } else { (*((volatile uint32_t *)(0x0005D300U + 0x7AU))) |= pinMask; } __edis(); } //***************************************************************************** //! Disables a pin to wake up the device from the following mode(s): //! - STANDBY //! - HALT //! //! \param pin is the identifying number of the pin. //! //! This function disconnects a pin to the LPM circuit, disallowing an event on //! the pin to wake up the device when when it is in following mode(s): //! - STANDBY //! - HALT //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. Only GPIOs 0 through 63 are valid. //! //! \return None. // //***************************************************************************** static inline void SysCtl_disableLPMWakeupPin(uint32_t pin) { uint32_t pinMask; // // Check the arguments. // do { if(!(pin <= 63U)) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 1714); } } while((_Bool)0); pinMask = 1UL << (pin % 32U); __eallow(); if(pin < 32U) { (*((volatile uint32_t *)(0x0005D300U + 0x78U))) &= ~pinMask; } else { (*((volatile uint32_t *)(0x0005D300U + 0x7AU))) &= ~pinMask; } __edis(); } //***************************************************************************** // //! Sets the number of cycles to qualify an input on waking from STANDBY mode. //! //! \param cycles is the number of OSCCLK cycles. //! //! This function sets the number of OSCCLK clock cycles used to qualify the //! selected inputs when waking from STANDBY mode. The \e cycles parameter //! should be passed a cycle count between 2 and 65 cycles inclusive. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setStandbyQualificationPeriod(uint16_t cycles) { // // Check the arguments. // do { if(!((cycles >= 2U) && (cycles <= 65U))) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 1751); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(0x0005D300U + 0x76U))) = ((*((volatile uint16_t *)(0x0005D300U + 0x76U))) & ~(uint16_t)0xFCU) | ((cycles - 2U) << 2U); __edis(); } //***************************************************************************** // //! Enable the device to wake from STANDBY mode upon a watchdog interrupt. //! //! \note In order to use this option, you must configure the watchdog to //! generate an interrupt using SysCtl_setWatchdogMode(). //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableWatchdogStandbyWakeup(void) { __eallow(); // // Set the bit enables the watchdog to wake up the device from STANDBY. // (*((volatile uint16_t *)(0x0005D300U + 0x76U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Disable the device from waking from STANDBY mode upon a watchdog interrupt. //! //! \return None. // //***************************************************************************** static inline void SysCtl_disableWatchdogStandbyWakeup(void) { __eallow(); // // Clear the bit enables the watchdog to wake up the device from STANDBY. // (*((volatile uint16_t *)(0x0005D300U + 0x76U))) &= ~0x8000U; __edis(); } //***************************************************************************** // //! Enable the watchdog to run while in HALT mode. //! //! This function configures the watchdog to continue to run while in HALT //! mode. Additionally, INTOSC1 and INTOSC2 are not powered down when the //! system enters HALT mode. By default the watchdog is gated when the system //! enters HALT. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableWatchdogInHalt(void) { __eallow(); // // Set the watchdog HALT mode ignore bit. // (*((volatile uint16_t *)(0x0005D200U + 0x8U))) |= 0x20U; asm(" RPT #250 || NOP \n RPT #50 || NOP"); __edis(); } //***************************************************************************** // //! Disable the watchdog from running while in HALT mode. //! //! This function gates the watchdog when the system enters HALT mode. INTOSC1 //! and INTOSC2 will be powered down. This is the default behavior of the //! device. //! //! \return None. // //***************************************************************************** static inline void SysCtl_disableWatchdogInHalt(void) { __eallow(); // // Clear the watchdog HALT mode ignore bit. // (*((volatile uint16_t *)(0x0005D200U + 0x8U))) &= ~0x20U; asm(" RPT #250 || NOP \n RPT #50 || NOP"); __edis(); } //***************************************************************************** // //! Configures whether the watchdog generates a reset or an interrupt signal. //! //! \param mode is a flag to select the watchdog mode. //! //! This function configures the action taken when the watchdog counter reaches //! its maximum value. When the \e mode parameter is //! \b SYSCTL_WD_MODE_INTERRUPT, the watchdog is enabled to generate a watchdog //! interrupt signal and disables the generation of a reset signal. This will //! allow the watchdog module to wake up the device from IDLE //! or STANDBY if desired (see SysCtl_enableWatchdogStandbyWakeup()). //! //! When the \e mode parameter is \b SYSCTL_WD_MODE_RESET, the watchdog will //! be put into reset mode and generation of a watchdog interrupt signal will //! be disabled. This is how the watchdog is configured by default. //! //! \note Check the status of the watchdog interrupt using //! SysCtl_isWatchdogInterruptActive() before calling this function. If the //! interrupt is still active, switching from interrupt mode to reset mode will //! immediately reset the device. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setWatchdogMode(SysCtl_WDMode mode) { __eallow(); // // Either set or clear the WDENINT bit to that will determine whether the // watchdog will generate a reset signal or an interrupt signal. Take care // not to write a 1 to WDOVERRIDE. // if(mode == SYSCTL_WD_MODE_INTERRUPT) { (*((volatile uint16_t *)(0x00007000U + 0x22U))) = ((*((volatile uint16_t *)(0x00007000U + 0x22U))) & ~0x1U) | 0x2U; } else { (*((volatile uint16_t *)(0x00007000U + 0x22U))) &= ~(0x2U | 0x1U); } __edis(); } //***************************************************************************** // //! Gets the status of the watchdog interrupt signal. //! //! This function returns the status of the watchdog interrupt signal. If the //! interrupt is active, this function will return \b true. If \b false, the //! interrupt is NOT active. //! //! \note Make sure to call this function to ensure that the interrupt is not //! active before making any changes to the configuration of the watchdog to //! prevent any unexpected behavior. For instance, switching from interrupt //! mode to reset mode while the interrupt is active will immediately reset the //! device. //! //! \return \b true if the interrupt is active and \b false if it is not. // //***************************************************************************** static inline _Bool SysCtl_isWatchdogInterruptActive(void) { // // If the status bit is cleared, the WDINTn signal is active. // return(((*((volatile uint16_t *)(0x00007000U + 0x22U))) & 0x4U) == 0U); } //***************************************************************************** // //! Disables the watchdog. //! //! This function disables the watchdog timer. Note that the watchdog timer is //! enabled on reset. //! //! \return None. // //***************************************************************************** static inline void SysCtl_disableWatchdog(void) { __eallow(); // // Set the disable bit. // (*((volatile uint16_t *)(0x00007000U + 0x29U))) |= 0x0028U | 0x40U; asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Enables the watchdog. //! //! This function enables the watchdog timer. Note that the watchdog timer is //! enabled on reset. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableWatchdog(void) { __eallow(); // // Clear the disable bit. // (*((volatile uint16_t *)(0x00007000U + 0x29U))) = ((*((volatile uint16_t *)(0x00007000U + 0x29U))) & ~0x40U) | 0x0028U; asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Checks if the watchdog is enabled or not //! //! This function returns the watchdog status whether it is enabled or disabled //! //! \return \b true if the watchdog is enabled & \b false if the watchdog is //! disabled // //***************************************************************************** static inline _Bool SysCtl_isWatchdogEnabled(void) { // // Get the watchdog enable status // return (((*((volatile uint16_t *)(0x00007000U + 0x29U))) & 0x40U) == 0U); } //***************************************************************************** // //! Services the watchdog. //! //! This function resets the watchdog. //! //! \return None. // //***************************************************************************** static inline void SysCtl_serviceWatchdog(void) { __eallow(); // // Enable the counter to be reset and then reset it. // (*((volatile uint16_t *)(0x00007000U + 0x25U))) = 0x0055U; (*((volatile uint16_t *)(0x00007000U + 0x25U))) = 0x00AAU; __edis(); } //***************************************************************************** // //! Writes the first key to enter the watchdog reset. //! //! This function writes the first key to enter the watchdog reset. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableWatchdogReset(void) { __eallow(); // // Enable the counter to be reset // (*((volatile uint16_t *)(0x00007000U + 0x25U))) = 0x0055U; __edis(); } //***************************************************************************** // //! Writes the second key to reset the watchdog. //! //! This function writes the second key to reset the watchdog. //! //! \return None. // //***************************************************************************** static inline void SysCtl_resetWatchdog(void) { __eallow(); // // Reset the watchdog counter // (*((volatile uint16_t *)(0x00007000U + 0x25U))) = 0x00AAU; __edis(); } //***************************************************************************** // //! Sets up watchdog clock (WDCLK) prescaler. //! //! \param prescaler is the value that configures the watchdog clock relative //! to the value from the pre-divider. //! //! This function sets up the watchdog clock (WDCLK) prescaler. The //! \e prescaler parameter divides INTOSC1 down to WDCLK. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setWatchdogPrescaler(SysCtl_WDPrescaler prescaler) { uint16_t regVal; regVal = (uint16_t)prescaler | (uint16_t)0x0028U; __eallow(); // // Write the prescaler to the appropriate register. // (*((volatile uint16_t *)(0x00007000U + 0x29U))) = ((*((volatile uint16_t *)(0x00007000U + 0x29U))) & ~(0x7U)) | regVal; asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Gets the watchdog counter value. //! //! \return Returns the current value of the 8-bit watchdog counter. If this //! count value overflows, a watchdog output pulse is generated. // //***************************************************************************** static inline uint16_t SysCtl_getWatchdogCounterValue(void) { // // Read and return the value of the watchdog counter. // return((*((volatile uint16_t *)(0x00007000U + 0x23U)))); } //***************************************************************************** // //! Gets the watchdog reset status. //! //! This function returns the watchdog reset status. If this function returns //! \b true, that indicates that a watchdog reset generated the last reset //! condition. Otherwise, it was an external device or power-up reset //! condition. //! //! \return Returns \b true if the watchdog generated the last reset condition. // //***************************************************************************** static inline _Bool SysCtl_getWatchdogResetStatus(void) { // // Read and return the status of the watchdog reset status flag. // return(((*((volatile uint16_t *)(0x0005D300U + 0x80U))) & 0x4U) != 0U); } //***************************************************************************** // //! Clears the watchdog reset status. //! //! This function clears the watchdog reset status. To check if it was set //! first, see SysCtl_getWatchdogResetStatus(). //! //! \return None. // //***************************************************************************** static inline void SysCtl_clearWatchdogResetStatus(void) { __eallow(); // // Read and return the status of the watchdog reset status flag. // (*((volatile uint16_t *)(0x0005D300U + 0x80U))) = 0x4U; __edis(); } //***************************************************************************** // //! Set the minimum threshold value for windowed watchdog //! //! \param value is the value to set the window threshold //! //! This function sets the minimum threshold value used to define the lower //! limit of the windowed watchdog functionality. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setWatchdogWindowValue(uint16_t value) { __eallow(); // // Clear the windowed value // (*((volatile uint16_t *)(0x00007000U + 0x2AU))) &= ~0xFFU; // // Set the windowed value // (*((volatile uint16_t *)(0x00007000U + 0x2AU))) |= (value & 0xFFU); __edis(); } //***************************************************************************** // //! Clears the watchdog override. //! //! This function clears the watchdog override and locks the watchdog timer //! module to remain in its prior state which could be either enable /disable. //! The watchdog timer will remain in this state until the next system reset. //! //! \return None. // //***************************************************************************** static inline void SysCtl_clearWatchdogOverride(void) { __eallow(); (*((volatile uint16_t *)(0x00007000U + 0x22U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Enable the NMI Global interrupt bit //! //! \b Note: This bit should be set after the device security related //! initialization is complete. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableNMIGlobalInterrupt(void) { __eallow(); (*((volatile uint16_t *)(0x00007060U + 0x0U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Read NMI interrupts. //! //! Read the current state of NMI interrupt. //! //! \return \b true if NMI interrupt is triggered, \b false if not. // //***************************************************************************** static inline _Bool SysCtl_getNMIStatus(void) { // // Read and return the current value of the NMI flag register, masking out // all but the NMI bit. // return(((*((volatile uint16_t *)(0x00007060U + 0x1U))) & 0x1U) != 0U); } //***************************************************************************** // //! Read NMI Flags. //! //! Read the current state of individual NMI interrupts //! //! \return Value of NMIFLG register. These defines are provided to decode //! the value: //! - \b SYSCTL_NMI_NMIINT - NMI Interrupt Flag //! - \b SYSCTL_NMI_CLOCKFAIL - Clock Fail Interrupt Flag //! - \b SYSCTL_NMI_RAMUNCERR - RAM Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_FLUNCERR - Flash Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_CPU1HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_CPU2HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_PIEVECTERR - PIE Vector Fetch Error Flag //! - \b SYSCTL_NMI_CLBNMI - Configurable Logic Block NMI Flag //! - \b SYSCTL_NMI_CPU2WDRSN - CPU2 WDRSn Reset Indication Flag //! - \b SYSCTL_NMI_CPU2NMIWDRSN - CPU2 NMIWDRSn Reset Indication Flag // //***************************************************************************** static inline uint16_t SysCtl_getNMIFlagStatus(void) { // // Read and return the current value of the NMI flag register. // return((*((volatile uint16_t *)(0x00007060U + 0x1U)))); } //***************************************************************************** // //! Check if the individual NMI interrupts are set. //! //! \param nmiFlags Bit mask of the NMI interrupts that user wants to clear. //! The bit format of this parameter is same as of the NMIFLG register. These //! defines are provided: //! - \b SYSCTL_NMI_NMIINT - NMI Interrupt Flag //! - \b SYSCTL_NMI_CLOCKFAIL - Clock Fail Interrupt Flag //! - \b SYSCTL_NMI_RAMUNCERR - RAM Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_FLUNCERR - Flash Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_CPU1HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_CPU2HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_PIEVECTERR - PIE Vector Fetch Error Flag //! - \b SYSCTL_NMI_CLBNMI - Configurable Logic Block NMI Flag //! - \b SYSCTL_NMI_CPU2WDRSN - CPU2 WDRSn Reset Indication Flag //! - \b SYSCTL_NMI_CPU2NMIWDRSN - CPU2 NMIWDRSn Reset Indication Flag //! //! Check if interrupt flags corresponding to the passed in bit mask are //! asserted. //! //! \return \b true if any of the NMI asked for in the parameter bit mask //! is set. \b false if none of the NMI requested in the parameter bit mask are //! set. // //***************************************************************************** static inline _Bool SysCtl_isNMIFlagSet(uint16_t nmiFlags) { // // Check the arguments. // Make sure if reserved bits are not set in nmiFlags. // do { if(!((nmiFlags & ~( 0x1U | 0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x100U | 0x200U | 0x400U )) == 0U)) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 2324); } } while((_Bool)0); // // Read the flag register and return true if any of them are set. // return(((*((volatile uint16_t *)(0x00007060U + 0x1U))) & nmiFlags) != 0U); } //***************************************************************************** // //! Function to clear individual NMI interrupts. //! //! \param nmiFlags Bit mask of the NMI interrupts that user wants to clear. //! The bit format of this parameter is same as of the NMIFLG register. These //! defines are provided: //! - \b SYSCTL_NMI_NMIINT - NMI Interrupt Flag //! - \b SYSCTL_NMI_CLOCKFAIL - Clock Fail Interrupt Flag //! - \b SYSCTL_NMI_RAMUNCERR - RAM Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_FLUNCERR - Flash Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_CPU1HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_CPU2HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_PIEVECTERR - PIE Vector Fetch Error Flag //! - \b SYSCTL_NMI_CLBNMI - Configurable Logic Block NMI Flag //! - \b SYSCTL_NMI_CPU2WDRSN - CPU2 WDRSn Reset Indication Flag //! - \b SYSCTL_NMI_CPU2NMIWDRSN - CPU2 NMIWDRSn Reset Indication Flag //! //! Clear NMI interrupt flags that correspond with the passed in bit mask. //! //! \b Note: The NMI Interrupt flag is always cleared by default and //! therefore doesn't have to be included in the bit mask. //! //! \return None. // //***************************************************************************** static inline void SysCtl_clearNMIStatus(uint16_t nmiFlags) { // // Check the arguments. // Make sure if reserved bits are not set in nmiFlags. // do { if(!((nmiFlags & ~( 0x1U | 0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x100U | 0x200U | 0x400U )) == 0U)) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 2376); } } while((_Bool)0); __eallow(); // // Clear the individual flags as well as NMI Interrupt flag // (*((volatile uint16_t *)(0x00007060U + 0x2U))) = nmiFlags; (*((volatile uint16_t *)(0x00007060U + 0x2U))) = 0x1U; __edis(); } //***************************************************************************** // //! Clear all the NMI Flags that are currently set. //! //! \return None. // //***************************************************************************** static inline void SysCtl_clearAllNMIFlags(void) { uint16_t nmiFlags; // // Read the flag status register and then write to the clear register, // clearing all the flags that were returned plus the NMI flag. // __eallow(); nmiFlags = SysCtl_getNMIFlagStatus(); (*((volatile uint16_t *)(0x00007060U + 0x2U))) = nmiFlags; (*((volatile uint16_t *)(0x00007060U + 0x2U))) = 0x1U; __edis(); } //***************************************************************************** // //! Function to force individual NMI interrupt fail flags //! //! \param nmiFlags Bit mask of the NMI interrupts that user wants to clear. //! The bit format of this parameter is same as of the NMIFLG register. These //! defines are provided: //! - \b SYSCTL_NMI_NMIINT - NMI Interrupt Flag //! - \b SYSCTL_NMI_CLOCKFAIL - Clock Fail Interrupt Flag //! - \b SYSCTL_NMI_RAMUNCERR - RAM Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_FLUNCERR - Flash Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_CPU1HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_CPU2HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_PIEVECTERR - PIE Vector Fetch Error Flag //! - \b SYSCTL_NMI_CLBNMI - Configurable Logic Block NMI Flag //! - \b SYSCTL_NMI_CPU2WDRSN - CPU2 WDRSn Reset Indication Flag //! - \b SYSCTL_NMI_CPU2NMIWDRSN - CPU2 NMIWDRSn Reset Indication Flag //! //! \return None. // //***************************************************************************** static inline void SysCtl_forceNMIFlags(uint16_t nmiFlags) { // // Check the arguments. // Make sure if reserved bits are not set in nmiFlags. // do { if(!((nmiFlags & ~( 0x1U | 0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x100U | 0x200U | 0x400U )) == 0U)) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 2453); } } while((_Bool)0); __eallow(); // // Set the Flags for the individual interrupts in the NMI flag // force register // (*((volatile uint16_t *)(0x00007060U + 0x3U))) |= nmiFlags; __edis(); } //***************************************************************************** // //! Gets the NMI watchdog counter value. //! //! \b Note: The counter is clocked at the SYSCLKOUT rate. //! //! \return Returns the NMI watchdog counter register's current value. // //***************************************************************************** static inline uint16_t SysCtl_getNMIWatchdogCounter(void) { // // Read and return the NMI watchdog counter register's value. // return((*((volatile uint16_t *)(0x00007060U + 0x4U)))); } //***************************************************************************** // //! Sets the NMI watchdog period value. //! //! \param wdPeriod is the 16-bit value at which a reset is generated. //! //! This function writes to the NMI watchdog period register that holds the //! value to which the NMI watchdog counter is compared. When the two registers //! match, a reset is generated. By default, the period is 0xFFFF. //! //! \note If a value smaller than the current counter value is passed into the //! \e wdPeriod parameter, a NMIRSn will be forced. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setNMIWatchdogPeriod(uint16_t wdPeriod) { __eallow(); // // Write to the period register. // (*((volatile uint16_t *)(0x00007060U + 0x5U))) = wdPeriod; __edis(); } //***************************************************************************** // //! Gets the NMI watchdog period value. //! //! \return Returns the NMI watchdog period register's current value. // //***************************************************************************** static inline uint16_t SysCtl_getNMIWatchdogPeriod(void) { // // Read and return the NMI watchdog period register's value. // return((*((volatile uint16_t *)(0x00007060U + 0x5U)))); } //***************************************************************************** // //! Read NMI Shadow Flags. //! //! Read the current state of individual NMI interrupts //! //! \return Value of NMISHDFLG register. These defines are provided to decode //! the value: //! - \b SYSCTL_NMI_NMIINT - NMI Interrupt Flag //! - \b SYSCTL_NMI_CLOCKFAIL - Clock Fail Interrupt Flag //! - \b SYSCTL_NMI_RAMUNCERR - RAM Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_FLUNCERR - Flash Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_CPU1HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_CPU2HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_PIEVECTERR - PIE Vector Fetch Error Flag //! - \b SYSCTL_NMI_CLBNMI - Configurable Logic Block NMI Flag //! - \b SYSCTL_NMI_CPU2WDRSN - CPU2 WDRSn Reset Indication Flag //! - \b SYSCTL_NMI_CPU2NMIWDRSN - CPU2 NMIWDRSn Reset Indication Flag // //***************************************************************************** static inline uint32_t SysCtl_getNMIShadowFlagStatus(void) { // // Read and return the current value of the NMI shadow flag register. // return((*((volatile uint16_t *)(0x00007060U + 0x6U)))); } //***************************************************************************** // //! Check if the individual NMI shadow flags are set. //! //! \param nmiFlags Bit mask of the NMI interrupts that user wants to clear. //! The bit format of this parameter is same as of the NMIFLG register. These //! defines are provided: //! - \b SYSCTL_NMI_NMIINT - NMI Interrupt Flag //! - \b SYSCTL_NMI_CLOCKFAIL - Clock Fail Interrupt Flag //! - \b SYSCTL_NMI_RAMUNCERR - RAM Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_FLUNCERR - Flash Uncorrectable Error NMI Flag //! - \b SYSCTL_NMI_CPU1HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_CPU2HWBISTERR - HW BIST Error NMI Flag //! - \b SYSCTL_NMI_PIEVECTERR - PIE Vector Fetch Error Flag //! - \b SYSCTL_NMI_CLBNMI - Configurable Logic Block NMI Flag //! - \b SYSCTL_NMI_CPU2WDRSN - CPU2 WDRSn Reset Indication Flag //! - \b SYSCTL_NMI_CPU2NMIWDRSN - CPU2 NMIWDRSn Reset Indication Flag //! //! Check if interrupt flags corresponding to the passed in bit mask are //! asserted. //! //! \return \b true if any of the NMI asked for in the parameter bit mask //! is set. \b false if none of the NMI requested in the parameter bit mask are //! set. // //***************************************************************************** static inline _Bool SysCtl_isNMIShadowFlagSet(uint16_t nmiFlags) { // // Check the arguments. // Make sure if reserved bits are not set in nmiFlags. // do { if(!((nmiFlags & ~( 0x1U | 0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x100U | 0x200U | 0x400U )) == 0U)) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\sysctl.h", 2602); } } while((_Bool)0); // // Read the flag register and return true if any of them are set. // return(((*((volatile uint16_t *)(0x00007060U + 0x6U))) & nmiFlags) != 0U); } //***************************************************************************** // //! Enable the missing clock detection (MCD) Logic //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableMCD(void) { __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x2EU))) &= ~(0x4U); __edis(); } //***************************************************************************** // //! Disable the missing clock detection (MCD) Logic //! //! \return None. // //***************************************************************************** static inline void SysCtl_disableMCD(void) { __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x2EU))) |= 0x4U; __edis(); } //***************************************************************************** // //! Get the missing clock detection Failure Status //! //! \note A failure means the oscillator clock is missing //! //! \return Returns \b true if a failure is detected or \b false if a //! failure isn't detected // //***************************************************************************** static inline _Bool SysCtl_isMCDClockFailureDetected(void) { // // Check the status bit to determine failure // return(((*((volatile uint16_t *)(0x0005D200U + 0x2EU))) & 0x1U) != 0U); } //***************************************************************************** // //! Reset the missing clock detection logic after clock failure //! //! \return None. // //***************************************************************************** static inline void SysCtl_resetMCD(void) { __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x2EU))) |= 0x2U; __edis(); } //***************************************************************************** // //! Re-connect missing clock detection clock source to stop simulating clock //! failure //! //! \return None. // //***************************************************************************** static inline void SysCtl_connectMCDClockSource(void) { __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x2EU))) &= ~(0x8U); __edis(); } //***************************************************************************** // //! Disconnect missing clock detection clock source to simulate clock failure. //! This is for testing the MCD functionality. //! //! \return None. // //***************************************************************************** static inline void SysCtl_disconnectMCDClockSource(void) { __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x2EU))) |= 0x8U; __edis(); } //***************************************************************************** // //! Configures the sync input source for the ePWM and eCAP signals. //! //! \param syncInput is the sync input being configured //! \param syncSrc is sync input source selection. //! //! This function configures the sync input source for the ePWM and eCAP //! modules. The \e syncInput parameter is the sync input being configured. It //! should be passed a value of \b SYSCTL_SYNC_IN_XXXX, where XXXX is the ePWM //! or eCAP instance the sync signal is entering. //! //! The \e syncSrc parameter is the sync signal selected as the source of the //! sync input. It should be passed a value of \b SYSCTL_SYNC_IN_SRC_XXXX, //! XXXX is a sync signal coming from an ePWM, eCAP or external sync output. //! where For example, a \e syncInput value of \b SYSCTL_SYNC_IN_ECAP1 and a //! \e syncSrc value of \b SYSCTL_SYNC_IN_SRC_EPWM1SYNCOUT will make the //! EPWM1SYNCOUT signal drive eCAP1's SYNCIN signal. //! //! Note that some \e syncSrc values are only valid for certain values of //! \e syncInput. See device technical reference manual for details on //! time-base counter synchronization. //! //! \return None. // //***************************************************************************** static inline void SysCtl_setSyncInputConfig(SysCtl_SyncInput syncInput, SysCtl_SyncInputSource syncSrc) { uint32_t clearMask; // // Write the input sync source selection to the appropriate register. // __eallow(); clearMask = (uint32_t)0x7U << (uint32_t)syncInput; (*((volatile uint32_t *)(0x00007940U + 0x0U))) = ((*((volatile uint32_t *)(0x00007940U + 0x0U))) & ~clearMask) | ((uint32_t)syncSrc << (uint32_t)syncInput); __edis(); } //***************************************************************************** // //! Configures the sync output source. //! //! \param syncSrc is sync output source selection. //! //! This function configures the sync output source from the ePWM modules. The //! \e syncSrc parameter is a value \b SYSCTL_SYNC_OUT_SRC_XXXX, where XXXX is //! a sync signal coming from an ePWM such as SYSCTL_SYNC_OUT_SRC_EPWM1SYNCOUT //! //! \return None. // //***************************************************************************** static inline void SysCtl_setSyncOutputConfig(SysCtl_SyncOutputSource syncSrc) { // // Write the sync output source selection to the appropriate register. // __eallow(); (*((volatile uint32_t *)(0x00007940U + 0x0U))) = ((*((volatile uint32_t *)(0x00007940U + 0x0U))) & ~((uint32_t)0x18000000U)) | ((uint32_t)syncSrc << 27U); __edis(); } //***************************************************************************** // //! Enables ePWM SOC signals to drive an external (off-chip) ADCSOC signal. //! //! \param adcsocSrc is a bit field of the selected signals to be enabled //! //! This function configures which ePWM SOC signals are enabled as a source for //! either ADCSOCAO or ADCSOCBO. The \e adcsocSrc parameter takes a logical OR //! of \b SYSCTL_ADCSOC_SRC_PWMxSOCA/B values that correspond to different //! signals. //! //! \return None. // //***************************************************************************** static inline void SysCtl_enableExtADCSOCSource(uint32_t adcsocSrc) { // // Set the bits that correspond to signal to be enabled. // __eallow(); (*((volatile uint32_t *)(0x00007940U + 0x2U))) |= adcsocSrc; __edis(); } //***************************************************************************** // //! Disables ePWM SOC signals from driving an external ADCSOC signal. //! //! \param adcsocSrc is a bit field of the selected signals to be disabled //! //! This function configures which ePWM SOC signals are disabled as a source //! for either ADCSOCAO or ADCSOCBO. The \e adcsocSrc parameter takes a logical //! OR of \b SYSCTL_ADCSOC_SRC_PWMxSOCA/B values that correspond to different //! signals. //! //! \return None. // //***************************************************************************** static inline void SysCtl_disableExtADCSOCSource(uint32_t adcsocSrc) { // // Clear the bits that correspond to signal to be disabled. // __eallow(); (*((volatile uint32_t *)(0x00007940U + 0x2U))) &= ~adcsocSrc; __edis(); } //***************************************************************************** // //! Locks the SOC Select of the Trig X-BAR. //! //! This function locks the external ADC SOC select of the Trig X-BAR. //! //! \return None. // //***************************************************************************** static inline void SysCtl_lockExtADCSOCSelect(void) { // // Lock the ADCSOCOUTSELECT bit of the SYNCSOCLOCK register. // __eallow(); (*((volatile uint32_t *)(0x00007940U + 0x4U))) = 0x2U; __edis(); } //***************************************************************************** // //! Configures whether the dual ported bridge is connected with DMA or //! CLA as the secondary controller. //! //! \param periFrame1Config indicates whether CLA or DMA is configured as //! secondary controller on peripheral frame 1. //! \param periFrame2Config indicates whether CLA or DMA is configured as //! secondary controller on peripheral frame 2. //! //! One of the following values can be passed as parameter. //! \b SYSCTL_SEC_CONTROLLER_CLA //! \b SYSCTL_SEC_CONTROLLER_DMA //! //! \return None. // //***************************************************************************** static inline void SysCtl_selectSecController(uint16_t periFrame1Config, uint16_t periFrame2Config) { __eallow(); (*((volatile uint32_t *)(0x0005D300U + 0x74U))) = (((periFrame1Config << 0U) & 0x3U) | ((periFrame2Config << 2U) & 0xCU)); __edis(); } //***************************************************************************** // //! Locks the Sync Select of the Trig X-BAR. //! //! This function locks Sync Input and Output Select of the Trig X-BAR. //! //! \return None. // //***************************************************************************** static inline void SysCtl_lockSyncSelect(void) { // // Lock the SYNCSELECT register. // __eallow(); (*((volatile uint32_t *)(0x00007940U + 0x4U))) = 0x1U; __edis(); } //***************************************************************************** // //! Configures whether a peripheral is connected to CPU1 or CPU2. //! //! \param peripheral is the peripheral for which CPU needs to be configured. //! \param cpuInst is the CPU to which the peripheral instance need to be //! connected. //! //! The \e peripheral parameter can have one enumerated value from //! SysCtl_CPUSelPeriphInstance //! //! The \e cpuInst parameter can have one the following values: //! - \b SYSCTL_CPUSEL_CPU1 - to connect to CPU1 //! - \b SYSCTL_CPUSEL_CPU2 - to connect to CPU2 //! //! \note This API is applicable only for the CPU1 subsystem. //! //! \return None. // //***************************************************************************** static inline void SysCtl_selectCPUForPeripheralInstance(SysCtl_CPUSelPeriphInstance peripheral, SysCtl_CPUSel cpuInst) { uint16_t regIndex; uint16_t bitIndex; // // Identify the register index and bit position // regIndex = 2U * ((uint16_t)peripheral & 0x001FU); bitIndex = ((uint16_t)peripheral & 0x1F00U) >> 0x0008U; __eallow(); // // Configure the CPU owner for the specified peripheral instance // (*((volatile uint32_t *)(0x0005D000U + 0xD6U + regIndex))) = ((*((volatile uint32_t *)(0x0005D000U + 0xD6U + regIndex))) & ~(1UL << bitIndex)) | ((uint32_t)cpuInst << bitIndex); __edis(); } //***************************************************************************** // //! Configures whether a peripheral is connected to CPU1 or CPU2. //! //! \param peripheral is the peripheral for which CPU needs to be configured. //! \param peripheralInst is the instance for which CPU needs to be configured. //! \param cpuInst is the CPU to which the peripheral instance need to be //! connected. //! //! The \e peripheral parameter can have one enumerated value from //! SysCtl_CPUSelPeripheral //! //! The \e peripheralInst parameter is the instance number for example //! 1 for EPWM1, 2 for EPWM2 so on.For instances which are named with alphabets //! (instead of numbers) the following convention needs to be followed. //! 1 for A (SPI_A), 2 for B (SPI_B), 3 for C (SPI_C) so on... //! //! The \e cpuInst parameter can have one the following values: //! - \b SYSCTL_CPUSEL_CPU1 - to connect to CPU1 //! - \b SYSCTL_CPUSEL_CPU2 - to connect to CPU2 //! //! \note This API is applicable only for the CPU1 subsystem. //! //! \note This function is retained for compatibility puposes. Recommended to //! to use the function \e SysCtl_selectCPUForPeripheralInstance() //! //! \return None. // //***************************************************************************** static inline void SysCtl_selectCPUForPeripheral(SysCtl_CPUSelPeripheral peripheral, uint16_t peripheralInst, SysCtl_CPUSel cpuInst) { uint32_t tempValue; uint16_t shift; if(SYSCTL_CPUSEL14_DAC == peripheral) { shift = peripheralInst + 0x10U - 1U; } else { shift = peripheralInst - 1U; } tempValue = (*((volatile uint32_t *)(0x0005D000U + 0xD6U + ((uint32_t)peripheral * 2U)))) & (~(1UL << shift)); __eallow(); (*((volatile uint32_t *)(0x0005D000U + 0xD6U + ((uint32_t)peripheral * 2U)))) = tempValue | ((uint32_t)cpuInst << shift); __edis(); } //***************************************************************************** // //! Get the Device Silicon Revision ID //! //! This function returns the silicon revision ID for the device. //! //! \note This API is applicable only for the CPU1 subsystem. //! //! \return Returns the silicon revision ID value. // //***************************************************************************** static inline uint32_t SysCtl_getDeviceRevision(void) { // // Returns the device silicon revision ID // return((*((volatile uint32_t *)(0x0005D000U + 0xCU)))); } //***************************************************************************** // //! Locks the CPU select registers for the peripherals //! //! \param peripheral is the peripheral for which CPU needs to be selected. //! //! The \e peripheral parameter can have one enumerated value from //! SysCtl_CPUSelPeripheral //! //! \note This API is applicable only for the CPU1 subsystem. //! //! \return None. // //***************************************************************************** static inline void SysCtl_lockCPUSelectRegs(SysCtl_CPUSelPeripheral peripheral) { __eallow(); (*((volatile uint32_t *)(0x0005D000U + 0x0U))) |= (1UL << (uint32_t)peripheral); __edis(); } //***************************************************************************** // //! Gets the error status of the Efuse //! //! The function provides both the Efuse Autoload & the Efuse Self Test //! Error Status. //! //! \note This API is applicable only for the CPU1 subsystem. //! //! \return Fuse Error status. // //***************************************************************************** static inline uint16_t SysCtl_getEfuseError(void) { return((*((volatile uint16_t *)(0x0005D000U + 0x74U)))); } //***************************************************************************** // //! Sets up XCLK divider. //! //! \param divider is the value that configures the divider. //! //! This function sets up the XCLK divider. There is only one //! divider that scales INTOSC1 to XCLK. //! //! The \e divider parameter can have one enumerated value from //! SysCtl_XClkDivider //! //! \return None. // //***************************************************************************** static inline void SysCtl_setXClk(SysCtl_XClkDivider divider) { // // Clears the divider then configures it. // __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x28U))) = ((*((volatile uint16_t *)(0x0005D200U + 0x28U))) & ~(0x3U)) | (uint16_t)divider; asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Sets up PLLSYSCLK divider. //! //! \param divider is the value that configures the divider. //! //! This function sets up the PLLSYSCLK divider. There is only one //! divider that scales PLLSYSCLK to generate the system clock. //! //! The \e divider parameter can have one value from the set below: //! 0x0 = /1 //! 0x1 = /2 //! 0x2 = /4 (default on reset) //! 0x3 = /6 //! 0x4 = /8 //! ...... //! 0x3F =/126 //! //! \return None. //! //! \note Please make sure to check if the PLL is locked and valid using the //! SysCtl_isPLLValid() before setting the divider. // //***************************************************************************** static inline void SysCtl_setPLLSysClk(uint16_t divider) { // // Clears the divider then configures it. // __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x22U))) = ((*((volatile uint16_t *)(0x0005D200U + 0x22U))) & ~(0x3FU)) | divider; asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Sets up AUXPLLCLK divider. //! //! \param divider is the value that configures the divider. //! //! This function sets up the AUXPLLCLK divider. There is only one //! divider that scales AUXPLLCLK to generate the system clock. //! //! The \e divider parameter can have one enumerated value from //! SysCtl_AuxPLLClkDivider //! //! \return None. //! //! \note Please make sure to check if the PLL is locked and valid using the //! SysCtl_isPLLValid() before setting the divider. // //***************************************************************************** static inline void SysCtl_setAuxPLLClk(SysCtl_AuxPLLClkDivider divider) { // // Clears the divider then configures it. // __eallow(); (*((volatile uint16_t *)(0x0005D200U + 0x24U))) = ((*((volatile uint16_t *)(0x0005D200U + 0x24U))) & ~(0x3U)) | (uint16_t)divider; asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Sets up CPU Timer 2 CLK source & divider. //! //! \param divider is the value that configures the divider. //! \param source is the source for the clock divider //! //! This function sets up the CPU Timer 2 CLK divider based on the source that //! is selected. There is only one divider that scales the "source" to //! CPU Timer 2 CLK. //! //! The \e divider parameter can have one enumerated value from //! SysCtl_Cputimer2ClkDivider //! The \e source parameter can have one enumerated value from //! SysCtl_Cputimer2ClkSource //! //! \return None. // //***************************************************************************** static inline void SysCtl_setCputimer2Clk(SysCtl_Cputimer2ClkDivider divider, SysCtl_Cputimer2ClkSource source) { // // Clears the divider & the source, then configures it. // __eallow(); (*((volatile uint16_t *)(0x0005D300U + 0x7CU))) = ((*((volatile uint16_t *)(0x0005D300U + 0x7CU))) & ~(0x7U | 0x38U)); asm(" RPT #69 || NOP"); (*((volatile uint16_t *)(0x0005D300U + 0x7CU))) |= ((uint16_t)divider << 3U) | ((uint16_t)source << 0U); asm(" RPT #69 || NOP"); __edis(); } //***************************************************************************** // //! Gets the PIE Vector Fetch Error Handler Routine Address. //! //! The function indicates the address of the PIE Vector Fetch Error //! handler routine. //! //! \return Error Handler Address. //! //! \note Its the responsibility of user to initialize this register. If this //! register is not initialized, a default error handler at address //! 0x3fffbe will get executed. // //***************************************************************************** static inline uint32_t SysCtl_getPIEVErrAddr(void) { return((*((volatile uint32_t *)(0x0005D300U + 0xAU)))); } //***************************************************************************** // //! Check if the Internal PHY is present or not for the USB module //! //! Provides the USB module Internal PHY presence //! //! \note This API is applicable only for the CPU1 subsystem. //! //! \return \b true if Internal USB PHY Module is present \b false if //! Internal USB PHY Module is not present // //***************************************************************************** static inline _Bool SysCtl_isPresentUSBPHY(void) { return(((*((volatile uint32_t *)(0x0005D000U + 0x60U))) & 0x10000U) != 0U); } //***************************************************************************** // //! Get the device UID_UNIQUE value //! //! This function returns the device UID_UNIQUE value //! //! \return Returns the device UID_UNIQUE value // //***************************************************************************** static inline uint32_t SysCtl_getDeviceUID(void) { // // Returns the device UID_UNIQUE value // return((*((volatile uint32_t *)(0x000703C0U + 0xCU)))); } //***************************************************************************** // //! Delays for a fixed number of cycles. //! //! \param count is the number of delay loop iterations to perform. //! //! This function generates a constant length delay using assembly code. The //! loop takes 5 cycles per iteration plus 9 cycles of overhead. //! //! \note If count is equal to zero, the loop will underflow and run for a //! very long time. //! //! \note Refer to the macro DEVICE_DELAY_US(x) in device.h which can be used to //! insert a delay in microseconds. //! //! \return None. // //***************************************************************************** extern void SysCtl_delay(uint32_t count); //***************************************************************************** // //! Calculates the system clock frequency (SYSCLK). //! //! \param clockInHz is the frequency of the oscillator clock source (OSCCLK). //! //! This function determines the frequency of the system clock based on the //! frequency of the oscillator clock source (from \e clockInHz) and the PLL //! and clock divider configuration registers. //! //! \return Returns the system clock frequency. If a missing clock is detected, //! the function will return the INTOSC1 frequency. This needs to be //! corrected and cleared (see SysCtl_resetMCD()) before trying to call this //! function again. // //***************************************************************************** extern uint32_t SysCtl_getClock(uint32_t clockInHz); //***************************************************************************** // //! Calculates the system auxiliary clock frequency (AUXPLLCLK). //! //! \param clockInHz is the frequency of the oscillator clock source //! (AUXOSCCLK). //! //! This function determines the frequency of the auxiliary clock based on the //! frequency of the oscillator clock source (from \e clockInHz) and the AUXPLL //! and clock divider configuration registers. //! //! \return Returns the auxiliary clock frequency. // //***************************************************************************** extern uint32_t SysCtl_getAuxClock(uint32_t clockInHz); //***************************************************************************** // //! Configures the clocking of the device. //! //! \param config is the required configuration of the device clocking. //! //! This function configures the clocking of the device. The input crystal //! frequency, oscillator to be used, use of the PLL, and the system clock //! divider are all configured with this function. //! //! The \e config parameter is the OR of several different values, many of //! which are grouped into sets where only one can be chosen. //! //! - The system clock divider is chosen with the macro \b SYSCTL_SYSDIV(x) //! where x is either 1 or an even value up to 126. //! //! - The use of the PLL is chosen with either \b SYSCTL_PLL_ENABLE or //! \b SYSCTL_PLL_DISABLE. //! //! - The integer multiplier is chosen \b SYSCTL_IMULT(x) where x is a value //! from 1 to 127. //! //! - The fractional multiplier is chosen with either \b SYSCTL_FMULT_0, //! \b SYSCTL_FMULT_1_4, \b SYSCTL_FMULT_1_2, or \b SYSCTL_FMULT_3_4. //! //! - The oscillator source chosen with \b SYSCTL_OSCSRC_OSC2, //! \b SYSCTL_OSCSRC_XTAL, or \b SYSCTL_OSCSRC_OSC1. //! //! This function uses the watchdog as a monitor for the PLL. The user //! watchdog settings will be modified and restored upon completion. Make sure //! that the WDOVERRIDE bit isn't set before calling this function. Re-lock //! attempt is carried out if either SLIP condition occurs or SYSCLK to input //! clock ratio is off by 10%. //! //! This function uses the following resources to support PLL initialization: //! - Watchdog //! - CPU Timer 1 //! - CPU Timer 2 //! //! //! \note See your device errata for more details about locking the PLL. //! //! \return Returns \b false if a missing clock error is detected. This needs //! to be cleared (see SysCtl_resetMCD()) before trying to call this function //! again. Otherwise, returns \b true. // //***************************************************************************** extern _Bool SysCtl_setClock(uint32_t config); //***************************************************************************** // //! Configures the external oscillator for the clocking of the device. //! //! This function configures the external oscillator (XTAL) to be used for the //! clocking of the device in crystal mode. It follows the procedure to turn on //! the oscillator, wait for it to power up, and select it as the source of the //! system clock. //! //! Please note that this function blocks while it waits for the XTAL to power //! up. If the XTAL does not manage to power up properly, the function will //! loop for a long time. It is recommended that you modify this function to //! add an appropriate timeout and error-handling procedure. //! //! \return None. // //***************************************************************************** extern void SysCtl_selectXTAL(void); //***************************************************************************** // //! Selects the oscillator to be used for the clocking of the device. //! //! \param oscSource is the oscillator source to be configured. //! //! This function configures the oscillator to be used in the clocking of the //! device. The \e oscSource parameter may take a value of //! \b SYSCTL_OSCSRC_OSC2, \b SYSCTL_OSCSRC_XTAL, or \b SYSCTL_OSCSRC_OSC1. //! //! \sa SysCtl_turnOnOsc() //! //! \return None. // //***************************************************************************** extern void SysCtl_selectOscSource(uint32_t oscSource); //***************************************************************************** // //! Selects the oscillator to be used for the AUXPLL. //! //! \param oscSource is the oscillator source to be configured. //! //! This function configures the oscillator to be used in the clocking of the //! AUXPLL. The \e oscSource parameter may take a value of //! \b SYSCTL_OSCSRC_OSC2, \b SYSCTL_OSCSRC_XTAL, or \b SYSCTL_OSCSRC_OSC1. //! //! \sa SysCtl_turnOnOsc() //! //! \return None. // //***************************************************************************** extern void SysCtl_selectOscSourceAuxPLL(uint32_t oscSource); //***************************************************************************** // //! Calculates the low-speed peripheral clock frequency (LSPCLK). //! //! \param clockInHz is the frequency of the oscillator clock source (OSCCLK). //! //! This function determines the frequency of the low-speed peripheral clock //! based on the frequency of the oscillator clock source (from \e clockInHz) //! and the PLL and clock divider configuration registers. //! //! \return Returns the low-speed peripheral clock frequency. // //***************************************************************************** extern uint32_t SysCtl_getLowSpeedClock(uint32_t clockInHz); //***************************************************************************** // //! Get the device part parametric value //! //! \param parametric is the requested device parametric value //! //! This function gets the device part parametric value. //! //! The \e parametric parameter can have one the following enumerated values: //! - \b SYSCTL_DEVICE_QUAL - Device Qualification Status //! - \b SYSCTL_DEVICE_PINCOUNT - Device Pin Count //! - \b SYSCTL_DEVICE_INSTASPIN - Device InstaSPIN Feature Set //! - \b SYSCTL_DEVICE_FLASH - Device Flash size (KB) //! - \b SYSCTL_DEVICE_PARTID - Device Part ID Format Revision //! - \b SYSCTL_DEVICE_FAMILY - Device Family //! - \b SYSCTL_DEVICE_PARTNO - Device Part Number //! - \b SYSCTL_DEVICE_CLASSID - Device Class ID //! //! \note This API is applicable only for the CPU1 subsystem. //! //! \return Returns the specified parametric value. // //***************************************************************************** extern uint16_t SysCtl_getDeviceParametric(SysCtl_DeviceParametric parametric); //***************************************************************************** // //! Configures the auxiliary PLL for clocking USB. //! //! \param config is the required configuration of the device clocking. //! //! This function configures the clock source for auxiliary PLL, the integer //! multiplier, fractional multiplier and divider. //! //! The \e config parameter is the OR of several different values, many of //! which are grouped into sets where only one can be chosen. //! //! - The system clock divider is chosen with one of the following macros: //! \b SYSCTL_AUXPLL_DIV_1, //! \b SYSCTL_AUXPLL_DIV_2, //! \b SYSCTL_AUXPLL_DIV_4, //! \b SYSCTL_AUXPLL_DIV_8 //! //! - The use of the PLL is chosen with either \b SYSCTL_AUXPLL_ENABLE or //! \b SYSCTL_AUXPLL_DISABLE. //! //! - The integer multiplier is chosen with \b SYSCTL_AUXPLL_IMULT(x) where x //! is a value from 1 to 127. //! //! - The oscillator source chosen with one of //! \b SYSCTL_AUXPLL_OSCSRC_OSC2, //! \b SYSCTL_AUXPLL_OSCSRC_XTAL, //! \b SYSCTL_AUXPLL_OSCSRC_AUXCLKIN, //! //! \note This function uses CPU Timer 2 to monitor a successful lock of the //! AUXPLL. For this function to properly detect the PLL startup //! SYSCLK >= 2*AUXPLLCLK after the AUXPLL is selected as the clocking source. //! User configuration of CPU Timer 2 will be backed up and restored. //! \note See your device errata for more details about locking the PLL. //! //! \return None. // //***************************************************************************** extern void SysCtl_setAuxClock(uint32_t config); //***************************************************************************** // // Close the Doxygen group. //! @} // //**************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** // // The key value for RAM initialization // // // RAM Initialization Register Mask // // // The Parity disable key value // //***************************************************************************** // // Miscellaneous defines for Message ID Types // //***************************************************************************** //***************************************************************************** // // These are the flags used by the flags parameter when calling // the CAN_setupMessageObject() function. // //***************************************************************************** //! This indicates that transmit interrupts should be enabled, or are enabled. //! This indicates that receive interrupts should be enabled, or are //! enabled. //! This indicates that a message object will use or is using filtering //! based on the object's message identifier. //! This indicates that a message object will use or is using filtering //! based on the direction of the transfer. //! This indicates that a message object will use or is using message //! identifier filtering based on the extended identifier. //! This indicates that this message object is part of a FIFO structure and //! not the final message object in a FIFO. //! This indicates that a message object has no flags set. //***************************************************************************** // // These definitions are used to specify interrupt sources to // CAN_enableInterrupt() and CAN_disableInterrupt(). // //***************************************************************************** //! This flag is used to allow a CAN controller to generate error //! interrupts. //! This flag is used to allow a CAN controller to generate status //! interrupts. //! This flag is used to allow a CAN controller to generate interrupts //! on interrupt line 0 //! This flag is used to allow a CAN controller to generate interrupts //! on interrupt line 1 //***************************************************************************** // // The following definitions contain all error or status indicators that can // be returned when calling the CAN_getStatus() function. // //***************************************************************************** //! CAN controller has detected a parity error. //! CAN controller has entered a Bus Off state. //! CAN controller error level has reached warning level. //! CAN controller error level has reached error passive level. //! A message was received successfully since the last read of this status. //! A message was transmitted successfully since the last read of this //! status. //! This is the mask for the last error code field. //! There was no error. //! A bit stuffing error has occurred. //! A formatting error has occurred. //! An acknowledge error has occurred. //! The bus remained a bit level of 1 for longer than is allowed. //! The bus remained a bit level of 0 for longer than is allowed. //! A CRC error has occurred. //***************************************************************************** // // The following macros are added for the Global Interrupt EN/FLG/CLR // register // //***************************************************************************** //! CANINT0 global interrupt bit //! CANINT1 global interrupt bit //***************************************************************************** // // The following macros are added for accessing the interrupt register and // the standard arbitration ID in the interface registers. // //***************************************************************************** //! Status of INT0ID //! IF1 Arbitration Standard ID Shift Offset //! IF1 Arbitration Standard ID Mask //! IF2 Arbitration Standard ID Shift Offset //! IF2 Arbitration Standard ID Mask //***************************************************************************** // //! This data type is used to decide between STD_ID or EXT_ID for a mailbox. //! This is used when calling the CAN_setupMessageObject() function. // //***************************************************************************** typedef enum { //! Set the message ID frame to standard. CAN_MSG_FRAME_STD, //! Set the message ID frame to extended. CAN_MSG_FRAME_EXT } CAN_MsgFrameType; //***************************************************************************** // //! This definition is used to determine the type of message object that will //! be set up via a call to the CAN_setupMessageObject() API. // //***************************************************************************** typedef enum { //! Transmit message object. CAN_MSG_OBJ_TYPE_TX, //! Transmit remote request message object CAN_MSG_OBJ_TYPE_TX_REMOTE, //! Receive message object. CAN_MSG_OBJ_TYPE_RX, //! Remote frame receive remote, with auto-transmit message object. CAN_MSG_OBJ_TYPE_RXTX_REMOTE } CAN_MsgObjType; //***************************************************************************** // //! This definition is used to determine the clock source that will //! be set up via a call to the CAN_selectClockSource() API. // //***************************************************************************** typedef enum { //! Peripheral System Clock Source CAN_CLOCK_SOURCE_SYS = 0x0, //! External Oscillator Clock Source CAN_CLOCK_SOURCE_XTAL = 0x1, //! Auxiliary Clock Input Source CAN_CLOCK_SOURCE_AUX = 0x2 } CAN_ClockSource; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! //! Checks a CAN base address. //! //! \param base is the base address of the CAN controller. //! //! This function determines if a CAN controller base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool CAN_isBaseValid(uint32_t base) { return( (base == 0x00048000U) || (base == 0x0004A000U) ); } //***************************************************************************** // //! \internal //! //! Copies data from a buffer to the CAN Data registers. //! //! \param data is a pointer to the data to be written out to the CAN //! controller's data registers. //! \param address is a uint32_t value for the first register of the //! CAN controller's data registers. For example, in order to use the IF1 //! register set on CAN controller 0, the value would be: \b CANA_BASE \b + //! \b CAN_O_IF1DATA. //! \param size is the number of bytes to copy into the CAN controller. //! //! This function takes the steps necessary to copy data from a contiguous //! buffer in memory into the non-contiguous data registers used by the CAN //! controller. //! //! \return None. // //***************************************************************************** static inline void CAN_writeDataReg(const uint16_t *const data, uint32_t address, uint32_t size) { uint32_t idx; uint32_t dataReg = address; // // Check the dataReg. // do { if(!(dataReg != 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 350); } } while((_Bool)0); // // Loop always copies 1 byte per iteration. // for(idx = 0U; idx < size; idx++) { // // Write out the data 8 bits at a time. // __byte((int16_t *)(dataReg),0) = data[idx]; dataReg++; } } //***************************************************************************** // //! \internal //! //! Copies data (all 16bits) from a buffer to the CAN Data registers. //! //! \param data is a pointer to the data to be written out to the CAN //! controller's data registers. //! \param address is a uint32_t value for the first register of the //! CAN controller's data registers. For example, in order to use the IF1 //! register set on CAN controller 0, the value would be: \b CANA_BASE \b + //! \b CAN_O_IF1DATA. //! \param size is the number of bytes to copy into the CAN controller. //! //! This function takes the steps necessary to copy data from a contiguous //! buffer in memory into the non-contiguous data registers used by the CAN //! controller. //! //! \return None. // //***************************************************************************** static inline void CAN_writeDataReg_16bit(const uint16_t *const data, uint32_t address, uint32_t size) { uint32_t idx; uint32_t dataReg = address; // // Check the dataReg. // do { if(!(dataReg != 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 398); } } while((_Bool)0); // // Loop always copies 1 byte per iteration. // for(idx = 0U; idx < size; idx++) { // // Write out the data 8 bits at a time. // __byte((int16_t *)(dataReg),0) = (uint32_t)((data[idx / 2UL]) >> ((idx % 2UL) * 8UL)); dataReg++; } } //***************************************************************************** // //! \internal //! //! Copies data (all 32bits) from a buffer to the CAN Data registers. //! //! \param data is a pointer to the data to be written out to the CAN //! controller's data registers. //! \param address is a uint32_t value for the first register of the //! CAN controller's data registers. For example, in order to use the IF1 //! register set on CAN controller 0, the value would be: \b CANA_BASE \b + //! \b CAN_O_IF1DATA. //! \param size is the number of bytes to copy into the CAN controller. //! //! This function takes the steps necessary to copy data from a contiguous //! buffer in memory into the non-contiguous data registers used by the CAN //! controller. //! //! \return None. // //***************************************************************************** static inline void CAN_writeDataReg_32bit(const uint32_t *const data, uint32_t address, uint32_t size) { uint32_t idx; uint32_t dataReg = address; // // Check the dataReg. // do { if(!(dataReg != 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 447); } } while((_Bool)0); // // Loop always copies 1 byte per iteration. // for(idx = 0U; idx < size; idx++) { // // Write out the data 8 bits at a time. // __byte((int16_t *)(dataReg),0) = ((data[idx / 4UL]) >> ((idx % 4UL) * 8UL)); dataReg++; } } //***************************************************************************** // //! \internal //! //! Copies data from the CAN Data registers to a buffer. //! //! \param data is a pointer to the location to store the data read from the //! CAN controller's data registers. //! \param address is a uint32_t value for the first register of the //! CAN controller's data registers. For example, in order to use the IF1 //! register set on CAN controller 1, the value would be: \b CANA_BASE \b + //! \b CAN_O_IF1DATA. //! \param size is the number of bytes to copy from the CAN controller. //! //! This function takes the steps necessary to copy data to a contiguous buffer //! in memory from the non-contiguous data registers used by the CAN //! controller. //! //! \return None. // //***************************************************************************** static inline void CAN_readDataReg(uint16_t *data, const uint32_t address, uint32_t size) { uint32_t idx; uint32_t dataReg = address; // // Loop always copies 1 byte per iteration. // for(idx = 0U; idx < size; idx++) { // // Read out the data // data[idx] = __byte((int16_t *)(dataReg),0); dataReg++; } } //***************************************************************************** // //! Initializes the CAN controller's RAM. //! //! \param base is the base address of the CAN controller. //! //! Performs the initialization of the RAM used for the CAN message objects. //! //! \return None. // //***************************************************************************** static inline void CAN_initRAM(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 521); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x40U))) = 0x10U | (0xAU); while(!(((*((volatile uint16_t *)(base + 0x40U))) & (0x003FU)) == (0x20U | 0x4U | 0x1U))) { // // Wait until RAM Init is complete // } } //***************************************************************************** // //! Select CAN Clock Source //! //! \param base is the base address of the CAN controller. //! \param source is the clock source to use for the CAN controller. //! //! This function selects the specified clock source for the CAN controller. //! //! The \e source parameter can be any one of the following: //! - \b CAN_CLOCK_SOURCE_SYS - Peripheral System Clock //! - \b CAN_CLOCK_SOURCE_XTAL - External Oscillator //! - \b CAN_CLOCK_SOURCE_AUX - Auxiliary Clock Input from GPIO //! //! \return None. // //***************************************************************************** static inline void CAN_selectClockSource(uint32_t base, CAN_ClockSource source) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 559); } } while((_Bool)0); // // Determine the CAN controller and set specified clock source // __eallow(); switch(base) { case 0x00048000U: (*((volatile uint16_t *)(0x0005D200U + 0xAU))) = ((*((volatile uint16_t *)(0x0005D200U + 0xAU))) & ~0xCU) | ((uint16_t)source << 2U); break; case 0x0004A000U: (*((volatile uint16_t *)(0x0005D200U + 0xAU))) = ((*((volatile uint16_t *)(0x0005D200U + 0xAU))) & ~0x30U) | ((uint16_t)source << 4U); break; default: // // Do nothing. Not a valid mode value. // break; } __edis(); asm(" RPT #250 || NOP \n RPT #50 || NOP"); } //***************************************************************************** // //! Starts the CAN Module's Operations //! //! \param base is the base address of the CAN controller. //! //! This function starts the CAN module's operations after initialization, //! which includes the CAN protocol controller state machine of the CAN core //! and the message handler state machine to begin controlling the CAN's //! internal data flow. //! //! \return None. // //***************************************************************************** static inline void CAN_startModule(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 614); } } while((_Bool)0); // // Clear Init and CCE bits // (*((volatile uint16_t *)(base + 0x0U))) &= ~(0x1U | 0x40U); } //***************************************************************************** // //! Enables the CAN controller. //! //! \param base is the base address of the CAN controller to enable. //! //! Enables the CAN controller for message processing. Once enabled, the //! controller will automatically transmit any pending frames, and process any //! received frames. The controller can be stopped by calling //! CAN_disableController(). //! //! \return None. // //***************************************************************************** static inline void CAN_enableController(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 642); } } while((_Bool)0); // // Clear the init bit in the control register. // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x1U; } //***************************************************************************** // //! Disables the CAN controller. //! //! \param base is the base address of the CAN controller to disable. //! //! Disables the CAN controller for message processing. When disabled, the //! controller will no longer automatically process data on the CAN bus. The //! controller can be restarted by calling CAN_enableController(). The state //! of the CAN controller and the message objects in the controller are left as //! they were before this call was made. //! //! \return None. // //***************************************************************************** static inline void CAN_disableController(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 671); } } while((_Bool)0); // // Set the init bit in the control register. // (*((volatile uint16_t *)(base + 0x0U))) |= 0x1U; } //***************************************************************************** // //! Enables the test modes of the CAN controller. //! //! \param base is the base address of the CAN controller. //! \param mode are the the test modes to enable. //! //! Enables test modes within the controller. The following valid options for //! \e mode can be OR'ed together: //! - \b CAN_TEST_SILENT - Silent Mode //! - \b CAN_TEST_LBACK - Loopback Mode //! - \b CAN_TEST_EXL - External Loopback Mode //! //! \note Loopback mode and external loopback mode \b can \b not be //! enabled at the same time. //! //! \return None. // //***************************************************************************** static inline void CAN_enableTestMode(uint32_t base, uint16_t mode) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 704); } } while((_Bool)0); do { if(!((mode & (0x10U | 0x100U)) != (0x10U | 0x100U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 706); } } while((_Bool)0); // // Clear the bits in the test register. // (*((volatile uint16_t *)(base + 0x14U))) &= ~((uint16_t)0x8U | (uint16_t)0x10U | (uint16_t)0x100U); // // Enable test mode and set the bits in the test register. // (*((volatile uint16_t *)(base + 0x0U))) |= 0x80U; (*((volatile uint16_t *)(base + 0x14U))) |= mode; } //***************************************************************************** // //! Disables the test modes of the CAN controller. //! //! \param base is the base address of the CAN controller. //! //! Disables test modes within the controller and clears the test bits. //! //! \return None. // //***************************************************************************** static inline void CAN_disableTestMode(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 739); } } while((_Bool)0); // // Clear the bits in the test register. // (*((volatile uint16_t *)(base + 0x14U))) &= ~((uint16_t)0x8U | (uint16_t)0x10U | (uint16_t)0x100U); // // Clear the test mode enable bit // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x80U; } //***************************************************************************** // //! Get the current settings for the CAN controller bit timing. //! //! \param base is the base address of the CAN controller. //! //! This function reads the current configuration of the CAN controller bit //! clock timing. //! //! \return Returns the value of the bit timing register. // //***************************************************************************** static inline uint32_t CAN_getBitTiming(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 772); } } while((_Bool)0); // // Read and return BTR register // return(__byte_peripheral_32((uint32_t *)(base + 0xCU))); } //***************************************************************************** // //! Enables direct access to the RAM. //! //! \param base is the base address of the CAN controller. //! //! Enables direct access to the RAM while in Test mode. //! //! \note Test Mode must first be enabled to use this function. //! //! \return None. // //***************************************************************************** static inline void CAN_enableMemoryAccessMode(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 799); } } while((_Bool)0); // // Set the RAM direct access bit // (*((volatile uint16_t *)(base + 0x14U))) |= 0x200U; } //***************************************************************************** // //! Disables direct access to the RAM. //! //! \param base is the base address of the CAN controller. //! //! Disables direct access to the RAM while in Test mode. //! //! \return None. // //***************************************************************************** static inline void CAN_disableMemoryAccessMode(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 824); } } while((_Bool)0); // // Clear the RAM direct access bit // (*((volatile uint16_t *)(base + 0x14U))) &= ~0x200U; } //***************************************************************************** // //! Sets the interruption debug mode of the CAN controller. //! //! \param base is the base address of the CAN controller. //! \param enable is a flag to enable or disable the interruption debug mode. //! //! This function sets the interruption debug mode of the CAN controller. When //! the \e enable parameter is \b true, CAN will be configured to interrupt any //! transmission or reception and enter debug mode immediately after it is //! requested. When \b false, CAN will wait for a started transmission or //! reception to be completed before entering debug mode. //! //! \return None. // //***************************************************************************** static inline void CAN_setInterruptionDebugMode(uint32_t base, _Bool enable) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 854); } } while((_Bool)0); if(enable) { // // Enable interrupt debug support // (*((volatile uint16_t *)(base + 0x0U))) |= 0x100U; } else { // // Disable interrupt debug support // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x100U; } } //***************************************************************************** // //! Disables Auto-Bus-On. //! //! \param base is the base address of the CAN controller. //! //! Disables the Auto-Bus-On feature of the CAN controller. //! //! \return None. // //***************************************************************************** static inline void CAN_disableAutoBusOn(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 890); } } while((_Bool)0); // // Clear the ABO bit in the control register. // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x200U; } //***************************************************************************** // //! Enables Auto-Bus-On. //! //! \param base is the base address of the CAN controller. //! //! Enables the Auto-Bus-On feature of the CAN controller. Be sure to also //! configure the Auto-Bus-On time using the CAN_setAutoBusOnTime function. //! //! \return None. // //***************************************************************************** static inline void CAN_enableAutoBusOn(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 916); } } while((_Bool)0); // // Set the ABO bit in the control register. // (*((volatile uint16_t *)(base + 0x0U))) |= 0x200U; } //***************************************************************************** // //! Sets the time before a Bus-Off recovery sequence is started. //! //! \param base is the base address of the CAN controller. //! \param onTime is number of clock cycles before a Bus-Off recovery sequence //! is started. //! //! This function sets the number of clock cycles before a Bus-Off recovery //! sequence is started by clearing the Init bit. //! //! \note To enable this functionality, use CAN_enableAutoBusOn(). //! //! \return None. // //***************************************************************************** static inline void CAN_setAutoBusOnTime(uint32_t base, uint32_t onTime) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 946); } } while((_Bool)0); // // Set bus-off timer value // __byte_peripheral_32((uint32_t *)(base + 0x80U)) = onTime; } //***************************************************************************** // //! Enables individual CAN controller interrupt sources. //! //! \param base is the base address of the CAN controller. //! \param intFlags is the bit mask of the interrupt sources to be enabled. //! //! Enables specific interrupt sources of the CAN controller. Only enabled //! sources will cause a processor interrupt. //! //! The \e intFlags parameter is the logical OR of any of the following: //! - \b CAN_INT_ERROR - a controller error condition has occurred //! - \b CAN_INT_STATUS - a message transfer has completed, or a bus error has //! been detected //! - \b CAN_INT_IE0 - allow CAN controller to generate interrupts on interrupt //! line 0 //! - \b CAN_INT_IE1 - allow CAN controller to generate interrupts on interrupt //! line 1 //! //! \return None. // //***************************************************************************** static inline void CAN_enableInterrupt(uint32_t base, uint32_t intFlags) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 982); } } while((_Bool)0); do { if(!((intFlags & ~((0x00000008UL) | (0x00000004UL) | (0x00000002UL) | (0x00020000UL))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 984); } } while((_Bool)0); // // Enable the specified interrupts. // __byte_peripheral_32((uint32_t *)(base + 0x0U)) |= intFlags; } //***************************************************************************** // //! Disables individual CAN controller interrupt sources. //! //! \param base is the base address of the CAN controller. //! \param intFlags is the bit mask of the interrupt sources to be disabled. //! //! Disables the specified CAN controller interrupt sources. Only enabled //! interrupt sources can cause a processor interrupt. //! //! The \e intFlags parameter has the same definition as in the //! CAN_enableInterrupt() function. //! //! \return None. // //***************************************************************************** static inline void CAN_disableInterrupt(uint32_t base, uint32_t intFlags) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1014); } } while((_Bool)0); do { if(!((intFlags & ~((0x00000008UL) | (0x00000004UL) | (0x00000002UL) | (0x00020000UL))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1016); } } while((_Bool)0); // // Disable the specified interrupts. // __byte_peripheral_32((uint32_t *)(base + 0x0U)) &= ~(intFlags); } //***************************************************************************** // //! Get the CAN controller Interrupt Line set for each mailbox //! //! \param base is the base address of the CAN controller. //! //! Gets which interrupt line each message object should assert when an //! interrupt occurs. Bit 0 corresponds to message object 32 and then bits //! 1 to 31 correspond to message object 1 through 31 respectively. Bits that //! are asserted indicate the message object should generate an interrupt on //! interrupt line 1, while bits that are not asserted indicate the message //! object should generate an interrupt on line 0. //! //! \return Returns the value of the interrupt muxing register. // //***************************************************************************** static inline uint32_t CAN_getInterruptMux(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1046); } } while((_Bool)0); // // Get the interrupt muxing for the CAN peripheral // return(__byte_peripheral_32((uint32_t *)(base + 0xD8U))); } //***************************************************************************** // //! Set the CAN controller Interrupt Line for each mailbox //! //! \param base is the base address of the CAN controller. //! \param mux bit packed representation of which message objects should //! generate an interrupt on a given interrupt line. //! //! Selects which interrupt line each message object should assert when an //! interrupt occurs. Bit 0 corresponds to message object 32 and then bits //! 1 to 31 correspond to message object 1 through 31 respectively. Bits that //! are asserted indicate the message object should generate an interrupt on //! interrupt line 1, while bits that are not asserted indicate the message //! object should generate an interrupt on line 0. //! //! \return None. // //***************************************************************************** static inline void CAN_setInterruptMux(uint32_t base, uint32_t mux) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1078); } } while((_Bool)0); // // Set the interrupt muxing for the CAN peripheral // __byte_peripheral_32((uint32_t *)(base + 0xD8U)) = mux; } //***************************************************************************** // //! Enables the CAN controller automatic retransmission behavior. //! //! \param base is the base address of the CAN controller. //! //! Enables the automatic retransmission of messages with detected errors. //! //! \return None. // //***************************************************************************** static inline void CAN_enableRetry(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1103); } } while((_Bool)0); // // Clearing the DAR bit tells the controller to not disable the // auto-retry of messages which were not transmitted or received // correctly. // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x20U; } //***************************************************************************** // //! Disables the CAN controller automatic retransmission behavior. //! //! \param base is the base address of the CAN controller. //! //! Disables the automatic retransmission of messages with detected errors. //! //! \return None. // //***************************************************************************** static inline void CAN_disableRetry(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1130); } } while((_Bool)0); // // Setting the DAR bit tells the controller to disable the auto-retry // of messages which were not transmitted or received correctly. // (*((volatile uint16_t *)(base + 0x0U))) |= 0x20U; } //***************************************************************************** // //! Returns the current setting for automatic retransmission. //! //! \param base is the base address of the CAN controller. //! //! Reads the current setting for the automatic retransmission in the CAN //! controller and returns it to the caller. //! //! \return Returns \b true if automatic retransmission is enabled, \b false //! otherwise. // //***************************************************************************** static inline _Bool CAN_isRetryEnabled(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1158); } } while((_Bool)0); // // Read the disable automatic retry setting from the CAN controller. // return((_Bool)(((*((volatile uint16_t *)(base + 0x0U))) & 0x20U) != 0x20U)); } //***************************************************************************** // //! Reads the CAN controller error counter register. //! //! \param base is the base address of the CAN controller. //! \param rxCount is a pointer to storage for the receive error counter. //! \param txCount is a pointer to storage for the transmit error counter. //! //! Reads the error counter register and returns the transmit and receive error //! counts to the caller along with a flag indicating if the controller receive //! counter has reached the error passive limit. The values of the receive and //! transmit error counters are returned through the pointers provided as //! parameters. //! //! After this call, \e rxCount will hold the current receive error count //! and \e txCount will hold the current transmit error count. //! //! \return Returns \b true if the receive error count has reached the error //! passive limit, and \b false if the error count is below the error passive //! limit. // //***************************************************************************** static inline _Bool CAN_getErrorCount(uint32_t base, uint32_t *rxCount, uint32_t *txCount) { uint32_t canError = 0U; // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1196); } } while((_Bool)0); // // Read the current count of transmit/receive errors. // canError = __byte_peripheral_32((uint32_t *)(base + 0x8U)); // // Extract the error numbers from the register value. // *rxCount = (canError & 0x7F00U) >> 8U; *txCount = (canError & 0xFFU) >> 0U; return((_Bool)((canError & 0x8000U) != 0U)); } //***************************************************************************** // //! Reads the CAN controller error and status register. //! //! \param base is the base address of the CAN controller. //! //! Reads the error and status register of the CAN controller. //! //! \return Returns the value of the register. // //***************************************************************************** static inline uint16_t CAN_getStatus(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1229); } } while((_Bool)0); // // Return error and status register value // return((*((volatile uint16_t *)(base + 0x4U)))); } //***************************************************************************** // //! Reads the CAN controller TX request register. //! //! \param base is the base address of the CAN controller. //! //! Reads the TX request register of the CAN controller. //! //! \return Returns the value of the register. // //***************************************************************************** static inline uint32_t CAN_getTxRequests(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1254); } } while((_Bool)0); // // Return Tx requests register value // return(__byte_peripheral_32((uint32_t *)(base + 0x88U))); } //***************************************************************************** // //! Reads the CAN controller new data status register. //! //! \param base is the base address of the CAN controller. //! //! Reads the new data status register of the CAN controller for all message //! objects. //! //! \return Returns the value of the register. // //***************************************************************************** static inline uint32_t CAN_getNewDataFlags(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1280); } } while((_Bool)0); // // Return new data register value // return(__byte_peripheral_32((uint32_t *)(base + 0x9CU))); } //***************************************************************************** // //! Reads the CAN controller valid message object register. //! //! \param base is the base address of the CAN controller. //! //! Reads the valid message object register of the CAN controller. //! //! \return Returns the value of the register. // //***************************************************************************** static inline uint32_t CAN_getValidMessageObjects(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1305); } } while((_Bool)0); // // Return the valid message register value // return(__byte_peripheral_32((uint32_t *)(base + 0xC4U))); } //***************************************************************************** // //! Get the CAN controller interrupt cause. //! //! \param base is the base address of the CAN controller. //! //! This function returns the value of the interrupt register that indicates //! the cause of the interrupt. //! //! \return Returns the value of the interrupt register. // //***************************************************************************** static inline uint32_t CAN_getInterruptCause(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1331); } } while((_Bool)0); // // Read interrupt identifier status // return(__byte_peripheral_32((uint32_t *)(base + 0x10U))); } //***************************************************************************** // //! Get the CAN controller pending interrupt message source. //! //! \param base is the base address of the CAN controller. //! //! Returns the value of the pending interrupts register that indicates //! which messages are the source of pending interrupts. //! //! \return Returns the value of the pending interrupts register. // //***************************************************************************** static inline uint32_t CAN_getInterruptMessageSource(uint32_t base) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1357); } } while((_Bool)0); // // Read message object interrupt status // return(__byte_peripheral_32((uint32_t *)(base + 0xB0U))); } //***************************************************************************** // //! CAN Global interrupt Enable function. //! //! \param base is the base address of the CAN controller. //! \param intFlags is the bit mask of the interrupt sources to be enabled. //! //! Enables specific CAN interrupt in the global interrupt enable register //! //! The \e intFlags parameter is the logical OR of any of the following: //! - \b CAN_GLOBAL_INT_CANINT0 - Global Interrupt Enable bit for CAN INT0 //! - \b CAN_GLOBAL_INT_CANINT1 - Global Interrupt Enable bit for CAN INT1 //! //! \return None. // //***************************************************************************** static inline void CAN_enableGlobalInterrupt(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1387); } } while((_Bool)0); do { if(!((intFlags & ~((0x00000001U) | (0x00000002U))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1389); } } while((_Bool)0); // // Enable the requested interrupts // (*((volatile uint16_t *)(base + 0x50U))) |= intFlags; } //***************************************************************************** // //! CAN Global interrupt Disable function. //! //! \param base is the base address of the CAN controller. //! \param intFlags is the bit mask of the interrupt sources to be disabled. //! //! Disables the specific CAN interrupt in the global interrupt enable register //! //! The \e intFlags parameter is the logical OR of any of the following: //! - \b CAN_GLOBAL_INT_CANINT0 - Global Interrupt bit for CAN INT0 //! - \b CAN_GLOBAL_INT_CANINT1 - Global Interrupt bit for CAN INT1 //! //! \return None. // //***************************************************************************** static inline void CAN_disableGlobalInterrupt(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1419); } } while((_Bool)0); do { if(!((intFlags & ~((0x00000001U) | (0x00000002U))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1421); } } while((_Bool)0); // // Disable the requested interrupts // (*((volatile uint16_t *)(base + 0x50U))) &= ~intFlags; } //***************************************************************************** // //! CAN Global interrupt Clear function. //! //! \param base is the base address of the CAN controller. //! \param intFlags is the bit mask of the interrupt sources to be cleared. //! //! Clear the specific CAN interrupt bit in the global interrupt flag register. //! //! The \e intFlags parameter is the logical OR of any of the following: //! - \b CAN_GLOBAL_INT_CANINT0 - Global Interrupt bit for CAN INT0 //! - \b CAN_GLOBAL_INT_CANINT1 - Global Interrupt bit for CAN INT1 //! //! \return None. // //***************************************************************************** static inline void CAN_clearGlobalInterruptStatus(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1451); } } while((_Bool)0); do { if(!((intFlags & ~((0x00000001U) | (0x00000002U))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1453); } } while((_Bool)0); // // Clear the requested interrupts // (*((volatile uint16_t *)(base + 0x58U))) |= intFlags; } //***************************************************************************** // //! Get the CAN Global Interrupt status. //! //! \param base is the base address of the CAN controller. //! \param intFlags is the bit mask of the interrupt sources to be enabled. //! //! Check if any interrupt bit is set in the global interrupt flag register. //! //! The \e intFlags parameter is the logical OR of any of the following: //! - \b CAN_GLOBAL_INT_CANINT0 - Global Interrupt bit for CAN INT0 //! - \b CAN_GLOBAL_INT_CANINT1 - Global Interrupt bit for CAN INT1 //! //! \return True if any of the requested interrupt bits are set. False, if //! none of the requested bits are set. // //***************************************************************************** static inline _Bool CAN_getGlobalInterruptStatus(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(CAN_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1484); } } while((_Bool)0); do { if(!((intFlags & ~((0x00000001U) | (0x00000002U))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/can.h", 1486); } } while((_Bool)0); // // Read and return the global interrupt flag register // return((_Bool)(((*((volatile uint16_t *)(base + 0x54U))) & intFlags) != 0U)); } //***************************************************************************** // //! Initializes the CAN controller //! //! \param base is the base address of the CAN controller. //! //! This function initializes the message RAM, which also clears all the //! message objects, and places the CAN controller in an init state. Write //! access to the configuration registers is available as a result, allowing //! the bit timing and message objects to be setup. //! //! \note To exit the initialization mode and start the CAN module, use the //! CAN_startModule() function. //! //! \return None. // //***************************************************************************** extern void CAN_initModule(uint32_t base); //***************************************************************************** // //! Sets the CAN Bit Timing based on requested Bit Rate. //! //! \param base is the base address of the CAN controller. //! \param clockFreq is the CAN module clock frequency before the bit rate //! prescaler (Hertz) //! \param bitRate is the desired bit rate (bits/sec) //! \param bitTime is the number of time quanta per bit required for desired //! bit time (Tq) and must be in the range from 8 to 25 //! //! This function sets the CAN bit timing values for the bit rate passed in the //! \e bitRate and \e bitTime parameters based on the \e clockFreq parameter. The //! CAN bit clock is calculated to be an average timing value that should work //! for most systems. If tighter timing requirements are needed, then the //! CAN_setBitTiming() function is available for full customization of all of //! the CAN bit timing values. //! //! \note Not all bit-rate and bit-time combinations are valid. //! For combinations that would yield the correct bit-rate, //! refer to the DCAN_CANBTR_values.xlsx file in the "docs" directory. //! The CANBTR register values calculated by the function CAN_setBitRate //! may not be suitable for your network parameters. If this is the case //! and you have computed the correct values for your network, you could //! directly write those parameters in CANBTR register using the //! function CAN_setBitTiming. //! //! \return None. // //***************************************************************************** extern void CAN_setBitRate(uint32_t base, uint32_t clockFreq, uint32_t bitRate, uint16_t bitTime); //***************************************************************************** // //! Manually set the CAN controller bit timing. //! //! \param base is the base address of the CAN controller. //! \param prescaler is the baud rate prescaler //! \param prescalerExtension is the baud rate prescaler extension //! \param tSeg1 is the time segment 1 //! \param tSeg2 is the time segment 2 //! \param sjw is the synchronization jump width //! //! This function sets the various timing parameters for the CAN bus bit //! timing: baud rate prescaler, prescaler extension, time segment 1, //! time segment 2, and the Synchronization Jump Width. //! //! \return None. // //***************************************************************************** extern void CAN_setBitTiming(uint32_t base, uint16_t prescaler, uint16_t prescalerExtension, uint16_t tSeg1, uint16_t tSeg2, uint16_t sjw); //***************************************************************************** // //! Clears a CAN interrupt source. //! //! \param base is the base address of the CAN controller. //! \param intClr is a value indicating which interrupt source to clear. //! //! This function can be used to clear a specific interrupt source. The //! \e intClr parameter should be either a number from 1 to 32 to clear a //! specific message object interrupt or can be the following: //! - \b CAN_INT_INT0ID_STATUS - Clears a status interrupt. //! //! It is not necessary to use this function to clear an interrupt. This //! should only be used if the application wants to clear an interrupt source //! without taking the normal interrupt action. //! //! \return None. // //***************************************************************************** extern void CAN_clearInterruptStatus(uint32_t base, uint32_t intClr); //***************************************************************************** // //! Setup a Message Object //! //! \param base is the base address of the CAN controller. //! \param objID is the message object number to configure (1-32). //! \param msgID is the CAN message identifier used for the 11 or 29 bit //! identifiers //! \param frame is the CAN ID frame type //! \param msgType is the message object type //! \param msgIDMask is the CAN message identifier mask used when identifier //! filtering is enabled //! \param flags is the various flags and settings to be set for the message //! object //! \param msgLen is the number of bytes of data in the message object (0-8) //! //! This function sets the various values required for a message object. //! //! The \e frame parameter can be one of the following values: //! - \b CAN_MSG_FRAME_STD - Standard 11 bit identifier //! - \b CAN_MSG_FRAME_EXT - Extended 29 bit identifier //! //! The \e msgType parameter can be one of the following values: //! - \b CAN_MSG_OBJ_TYPE_TX - Transmit Message //! - \b CAN_MSG_OBJ_TYPE_TX_REMOTE - Transmit Remote Message //! - \b CAN_MSG_OBJ_TYPE_RX - Receive Message //! - \b CAN_MSG_OBJ_TYPE_RXTX_REMOTE - Receive Remote message with //! auto-transmit //! //! The \e flags parameter can be set as \b CAN_MSG_OBJ_NO_FLAGS if no flags //! are required or the parameter can be a logical OR of any of the following //! values: //! - \b CAN_MSG_OBJ_TX_INT_ENABLE - Enable Transmit Interrupts //! - \b CAN_MSG_OBJ_RX_INT_ENABLE - Enable Receive Interrupts //! - \b CAN_MSG_OBJ_USE_ID_FILTER - Use filtering based on the Message ID //! (Standard or Extended) //! - \b CAN_MSG_OBJ_USE_EXT_FILTER - Use Extended Identifier Bit for filtering //! (Only among Extended IDs will be accepted) //! - \b CAN_MSG_OBJ_USE_DIR_FILTER - Use filtering based on the direction of //! the transfer //! - \b CAN_MSG_OBJ_FIFO - Message object is part of a FIFO //! structure and isn't the final message //! object in FIFO //! //! If filtering is based on message identifier (for Standard or Extended IDs) //! specified by the \e msgIDMask parameter, the value \b CAN_MSG_OBJ_USE_ID_FILTER //! has to be logically ORed with the \e flag parameter. //! If \b CAN_MSG_OBJ_USE_EXT_FILTER is ORed with the \e flag parameter, //! only extended identifier frames are accepted which can further be masked //! by using the flag above. //! //! \note The \b msgLen Parameter for the Receive Message Object is a "don't //! care" but its value should be between 0-8 due to the assert. //! //! \return None. // //***************************************************************************** extern void CAN_setupMessageObject(uint32_t base, uint32_t objID, uint32_t msgID, CAN_MsgFrameType frame, CAN_MsgObjType msgType, uint32_t msgIDMask, uint32_t flags, uint16_t msgLen); //***************************************************************************** // //! Sends a Message Object //! //! \param base is the base address of the CAN controller. //! \param objID is the object number to configure (1-32). //! \param msgLen is the number of bytes of data in the message object (0-8) //! \param msgData is a pointer to the message object's data //! //! This function is used to transmit a message object and the message data, //! if applicable. //! //! \note The message object requested by the \e objID must first be setup //! using the CAN_setupMessageObject() function. //! //! \return None. // //***************************************************************************** extern void CAN_sendMessage(uint32_t base, uint32_t objID, uint16_t msgLen, const uint16_t *msgData); //***************************************************************************** // //! Sends a Message Object //! //! \param base is the base address of the CAN controller. //! \param objID is the object number to configure (1-32). //! \param msgLen is the number of bytes of data in the message object (0-8) //! \param msgData is a pointer to the message object's data (all 16 bits are sent) //! //! This function is used to transmit a message object and the message data, //! if applicable. //! //! \note The message object requested by the \e objID must first be setup //! using the CAN_setupMessageObject() function. //! //! \return None. // //***************************************************************************** extern void CAN_sendMessage_16bit(uint32_t base, uint32_t objID, uint16_t msgLen, const uint16_t *msgData); //***************************************************************************** // //! Sends a Message Object //! //! \param base is the base address of the CAN controller. //! \param objID is the object number to configure (1-32). //! \param msgLen is the number of bytes of data in the message object (0-8) //! \param msgData is a pointer to the message object's data (all 32 bits are sent) //! //! This function is used to transmit a message object and the message data, //! if applicable. //! //! \note The message object requested by the \e objID must first be setup //! using the CAN_setupMessageObject() function. //! //! \return None. // //***************************************************************************** extern void CAN_sendMessage_32bit(uint32_t base, uint32_t objID, uint16_t msgLen, const uint32_t *msgData); //***************************************************************************** // //! Sends a Message Object while dynamically updating data length //! //! \param base is the base address of the CAN controller. //! \param objID is the object number to configure (1-32). //! \param msgLen is the number of bytes of data in the message object (0-8) //! \param msgData is a pointer to the message object's data //! //! This function is used to transmit a message object and the message data, //! if applicable and can be used to dynamically update the data length //! for every subsequent call of this function. //! //! \note The message object requested by the \e objID must first be setup //! using the CAN_setupMessageObject() function. //! //! \return None. // //***************************************************************************** extern void CAN_sendMessage_updateDLC(uint32_t base, uint32_t objID, uint16_t msgLen, const uint16_t *msgData); //***************************************************************************** // //! Sends a Remote Request Message Object //! //! \param base is the base address of the CAN controller. //! \param objID is the object number to configure (1-32). //! //! This function is used to transmit a remote request message object. //! //! \note The message object requested by the \e objID must first be setup //! using the CAN_setupMessageObject() function with CAN_MSG_OBJ_TYPE_TX_REMOTE //! as msgType flag. //! //! \return None. // //***************************************************************************** extern void CAN_sendRemoteRequestMessage(uint32_t base, uint32_t objID); //***************************************************************************** // //! Reads the data in a Message Object //! //! \param base is the base address of the CAN controller. //! \param objID is the object number to read (1-32). //! \param msgData is a pointer to the array to store the message data //! //! This function is used to read the data contents of the specified message //! object in the CAN controller. The data returned is stored in the //! \e msgData parameter. //! //! \note //! -# The message object requested by the \e objID must first be setup //! using the CAN_setupMessageObject() function. //! -# If the DLC of the received message is larger than the \e msgData //! buffer provided, then it is possible for a buffer overflow to occur. //! //! \return Returns \b true if new data was retrieved, else returns //! \b false to indicate no new data was retrieved. // //***************************************************************************** extern _Bool CAN_readMessage(uint32_t base, uint32_t objID, uint16_t *msgData); //***************************************************************************** // //! Reads the data and Message ID in a Message Object //! //! \param base is the base address of the CAN controller. //! \param objID is the object number to read (1-32). //! \param frameType is a pointer to the CAN_MsgFrameType to store the message //! type that has been received in the mailbox //! The \e frameType parameter shall be filled as of the following values: //! - \b CAN_MSG_FRAME_STD - Standard 11 bit identifier //! - \b CAN_MSG_FRAME_EXT - Extended 29 bit identifier //! This parameter is filled when return value is true for this function. //! \param msgID is a pointer to storage for the received Message ID //! Filled when the return value is true for this function. //! \param msgData is a pointer to the array to store the message data //! Filled with read Data when the return value is true for this function. //! //! This function is used to read the data contents and the Message ID //! of the specified message object in the CAN controller.The Message ID returned //! is stored in the \e msgID parameter and its type in \e frameType parameter. //! The data returned is stored in the \e msgData parameter. //! //! \note //! -# The message object requested by the \e objID must first be setup //! using the CAN_setupMessageObject() function. //! //! \return Returns \b true if new data was retrieved, else returns //! \b false to indicate no new data was retrieved. // //***************************************************************************** extern _Bool CAN_readMessageWithID(uint32_t base, uint32_t objID, CAN_MsgFrameType *frameType, uint32_t *msgID, uint16_t *msgData); //***************************************************************************** // //! Transfers a CAN message between the IF registers and Message RAM. //! //! \param base is the base address of the CAN controller. //! \param interface is the interface to use for the transfer. Valid value are //! 1 or 2. //! \param objID is the object number to transfer (1-32). //! \param direction is the direction of data transfer. False is Message RAM //! to IF, True is IF to Message RAM. //! //! This function transfers the contents of the interface registers to message //! RAM or vice versa depending on the value passed to direction. //! //! \return None. // //***************************************************************************** extern void CAN_transferMessage(uint32_t base, uint16_t interface, uint32_t objID, _Bool direction); //***************************************************************************** // //! Clears a message object so that it is no longer used. //! //! \param base is the base address of the CAN controller. //! \param objID is the message object number to disable (1-32). //! //! This function frees(disables) the specified message object from use. Once //! a message object has been cleared, it will no longer automatically send or //! receive messages, or generate interrupts. //! //! \return None. // //***************************************************************************** extern void CAN_clearMessage(uint32_t base, uint32_t objID); //***************************************************************************** // //! Disables specific message object //! //! \param base is the base address of the CAN controller. //! \param objID is the message object number to disable (1-32). //! //! This function disables the specific message object. Once the message object //! has been disabled it will be ignored by the message handler until it //! is configured again. //! //! \return None. // //***************************************************************************** extern void CAN_disableMessageObject(uint32_t base, uint32_t objID); //***************************************************************************** // //! Disables all message objects //! //! \param base is the base address of the CAN controller. //! //! This function disables all message objects. Once a message object //! has been disabled it will be ignored by the message handler until it //! is configured again. All message objects are disabled automatically on //! reset, however this function can be used to restart CAN operations //! without an external reset. //! //! \return None. // //***************************************************************************** extern void CAN_disableAllMessageObjects(uint32_t base); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: cla.h // // TITLE: CLA Driver Implementation File // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup cla_api CLA //! \brief This module is used for configurating CLA. //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_cla.h // // TITLE: Definitions for the CLA registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the CLA register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MIFR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MIOVF register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MIFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MICLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MICLROVF register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MIER register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MIRUN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the _MSTF register // //************************************************************************************************* //***************************************************************************** // // Useful defines used within the driver functions. Not intended for use by // application code. // //***************************************************************************** //***************************************************************************** // // Values that can be passed to CLA_clearTaskFlags(), CLA_forceTasks(), // and CLA_enableTasks(), CLA_disableTasks(), and CLA_enableSoftwareInterrupt() // as the taskFlags parameter. // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to CLA_getPendingTaskFlag(), //! CLA_getTaskOverflowFlag(), CLA_getTaskRunStatus(), CLA_setTriggerSource(), //! CLA_registerEndOfTaskInterrupt(), and CLA_unregisterEndOfTaskInterrupt() //! as the taskNumber parameter. // //***************************************************************************** typedef enum { CLA_TASK_1, //!< CLA Task 1 CLA_TASK_2, //!< CLA Task 2 CLA_TASK_3, //!< CLA Task 3 CLA_TASK_4, //!< CLA Task 4 CLA_TASK_5, //!< CLA Task 5 CLA_TASK_6, //!< CLA Task 6 CLA_TASK_7, //!< CLA Task 7 CLA_TASK_8 //!< CLA Task 8 } CLA_TaskNumber; //***************************************************************************** // //! Values that can be passed to CLA_mapTaskVector() as the \e claIntVect //! parameter. // //***************************************************************************** typedef enum { CLA_MVECT_1 = 0x0U, //!< Task Interrupt Vector 1 CLA_MVECT_2 = 0x1U, //!< Task Interrupt Vector 2 CLA_MVECT_3 = 0x2U, //!< Task Interrupt Vector 3 CLA_MVECT_4 = 0x3U, //!< Task Interrupt Vector 4 CLA_MVECT_5 = 0x4U, //!< Task Interrupt Vector 5 CLA_MVECT_6 = 0x5U, //!< Task Interrupt Vector 6 CLA_MVECT_7 = 0x6U, //!< Task Interrupt Vector 7 CLA_MVECT_8 = 0x7U //!< Task Interrupt Vector 8 } CLA_MVECTNumber; //***************************************************************************** // //! Values that can be passed to CLA_setTriggerSource() as the \e trigger //! parameter. // //***************************************************************************** typedef enum { CLA_TRIGGER_SOFTWARE = 0U, //!< CLA Task Trigger Source is Software CLA_TRIGGER_ADCA1 = 1U, //!< CLA Task Trigger Source is ADCA1 CLA_TRIGGER_ADCA2 = 2U, //!< CLA Task Trigger Source is ADCA2 CLA_TRIGGER_ADCA3 = 3U, //!< CLA Task Trigger Source is ADCA3 CLA_TRIGGER_ADCA4 = 4U, //!< CLA Task Trigger Source is ADCA4 CLA_TRIGGER_ADCAEVT = 5U, //!< CLA Task Trigger Source is ADCAEVT CLA_TRIGGER_ADCB1 = 6U, //!< CLA Task Trigger Source is ADCB1 CLA_TRIGGER_ADCB2 = 7U, //!< CLA Task Trigger Source is ADCB2 CLA_TRIGGER_ADCB3 = 8U, //!< CLA Task Trigger Source is ADCB3 CLA_TRIGGER_ADCB4 = 9U, //!< CLA Task Trigger Source is ADCB4 CLA_TRIGGER_ADCBEVT = 10U, //!< CLA Task Trigger Source is ADCBEVT CLA_TRIGGER_ADCC1 = 11U, //!< CLA Task Trigger Source is ADCC1 CLA_TRIGGER_ADCC2 = 12U, //!< CLA Task Trigger Source is ADCC2 CLA_TRIGGER_ADCC3 = 13U, //!< CLA Task Trigger Source is ADCC3 CLA_TRIGGER_ADCC4 = 14U, //!< CLA Task Trigger Source is ADCC4 CLA_TRIGGER_ADCCEVT = 15U, //!< CLA Task Trigger Source is ADCCEVT CLA_TRIGGER_ADCD1 = 16U, //!< CLA Task Trigger Source is ADCD1 CLA_TRIGGER_ADCD2 = 17U, //!< CLA Task Trigger Source is ADCD2 CLA_TRIGGER_ADCD3 = 18U, //!< CLA Task Trigger Source is ADCD3 CLA_TRIGGER_ADCD4 = 19U, //!< CLA Task Trigger Source is ADCD4 CLA_TRIGGER_ADCDEVT = 20U, //!< CLA Task Trigger Source is ADCDEVT CLA_TRIGGER_XINT1 = 29U, //!< CLA Task Trigger Source is XINT1 CLA_TRIGGER_XINT2 = 30U, //!< CLA Task Trigger Source is XINT2 CLA_TRIGGER_XINT3 = 31U, //!< CLA Task Trigger Source is XINT3 CLA_TRIGGER_XINT4 = 32U, //!< CLA Task Trigger Source is XINT4 CLA_TRIGGER_XINT5 = 33U, //!< CLA Task Trigger Source is XINT5 CLA_TRIGGER_EPWM1INT = 36U, //!< CLA Task Trigger Source is EPWM1INT CLA_TRIGGER_EPWM2INT = 37U, //!< CLA Task Trigger Source is EPWM2INT CLA_TRIGGER_EPWM3INT = 38U, //!< CLA Task Trigger Source is EPWM3INT CLA_TRIGGER_EPWM4INT = 39U, //!< CLA Task Trigger Source is EPWM4INT CLA_TRIGGER_EPWM5INT = 40U, //!< CLA Task Trigger Source is EPWM5INT CLA_TRIGGER_EPWM6INT = 41U, //!< CLA Task Trigger Source is EPWM6INT CLA_TRIGGER_EPWM7INT = 42U, //!< CLA Task Trigger Source is EPWM7INT CLA_TRIGGER_EPWM8INT = 43U, //!< CLA Task Trigger Source is EPWM8INT CLA_TRIGGER_EPWM9INT = 44U, //!< CLA Task Trigger Source is EPWM9INT CLA_TRIGGER_EPWM10INT = 45U, //!< CLA Task Trigger Source is EPWM10INT CLA_TRIGGER_EPWM11INT = 46U, //!< CLA Task Trigger Source is EPWM11INT CLA_TRIGGER_EPWM12INT = 47U, //!< CLA Task Trigger Source is EPWM12INT CLA_TRIGGER_TINT0 = 68U, //!< CLA Task Trigger Source is TINT0 CLA_TRIGGER_TINT1 = 69U, //!< CLA Task Trigger Source is TINT1 CLA_TRIGGER_TINT2 = 70U, //!< CLA Task Trigger Source is TINT2 CLA_TRIGGER_MXINTA = 71U, //!< CLA Task Trigger Source is MXINTA CLA_TRIGGER_MRINTA = 72U, //!< CLA Task Trigger Source is MRINTA CLA_TRIGGER_MXINTB = 73U, //!< CLA Task Trigger Source is MXINTB CLA_TRIGGER_MRINTB = 74U, //!< CLA Task Trigger Source is MRINTB CLA_TRIGGER_ECAP1INT = 75U, //!< CLA Task Trigger Source is ECAP1INT CLA_TRIGGER_ECAP2INT = 76U, //!< CLA Task Trigger Source is ECAP2INT CLA_TRIGGER_ECAP3INT = 77U, //!< CLA Task Trigger Source is ECAP3INT CLA_TRIGGER_ECAP4INT = 78U, //!< CLA Task Trigger Source is ECAP4INT CLA_TRIGGER_ECAP5INT = 79U, //!< CLA Task Trigger Source is ECAP5INT CLA_TRIGGER_ECAP6INT = 80U, //!< CLA Task Trigger Source is ECAP6INT CLA_TRIGGER_EQEP1INT = 83U, //!< CLA Task Trigger Source is EQEP1INT CLA_TRIGGER_EQEP2INT = 84U, //!< CLA Task Trigger Source is EQEP2INT CLA_TRIGGER_EQEP3INT = 85U, //!< CLA Task Trigger Source is EQEP3INT CLA_TRIGGER_SDFM1INT = 95U, //!< CLA Task Trigger Source is SDFM1INT CLA_TRIGGER_SDFM2INT = 96U, //!< CLA Task Trigger Source is SDFM2INT CLA_TRIGGER_UPP1INT = 107U, //!< CLA Task Trigger Source is UPP1INT CLA_TRIGGER_SPITXAINT = 109U, //!< CLA Task Trigger Source is SPITXAINT CLA_TRIGGER_SPIRXAINT = 110U, //!< CLA Task Trigger Source is SPIRXAINT CLA_TRIGGER_SPITXBINT = 111U, //!< CLA Task Trigger Source is SPITXBINT CLA_TRIGGER_SPIRXBINT = 112U, //!< CLA Task Trigger Source is SPIRXBINT CLA_TRIGGER_SPITXCINT = 113U, //!< CLA Task Trigger Source is SPITXCINT CLA_TRIGGER_SPIRXCINT = 114U, //!< CLA Task Trigger Source is SPIRXCINT CLA_TRIGGER_CLB1INT = 127, //!< CLA Task Trigger Source is CLB1INT CLA_TRIGGER_CLB2INT = 128, //!< CLA Task Trigger Source is CLB2INT CLA_TRIGGER_CLB3INT = 129, //!< CLA Task Trigger Source is CLB3INT CLA_TRIGGER_CLB4INT = 130, //!< CLA Task Trigger Source is CLB4INT } CLA_Trigger; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks a CLA base address. //! //! \param base is the base address of the CLA controller. //! //! This function determines if a CLA controller base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool CLA_isBaseValid(uint32_t base) { return(base == 0x00001400U); } //***************************************************************************** // //! Map CLA Task Interrupt Vector //! //! \param base is the base address of the CLA controller. //! \param claIntVect is CLA interrupt vector (MVECT1 to MVECT8) //! the value of claIntVect can be any of the following: //! - \b CLA_MVECT_1 - Task Interrupt Vector 1 //! - \b CLA_MVECT_2 - Task Interrupt Vector 2 //! - \b CLA_MVECT_3 - Task Interrupt Vector 3 //! - \b CLA_MVECT_4 - Task Interrupt Vector 4 //! - \b CLA_MVECT_5 - Task Interrupt Vector 5 //! - \b CLA_MVECT_6 - Task Interrupt Vector 6 //! - \b CLA_MVECT_7 - Task Interrupt Vector 7 //! - \b CLA_MVECT_8 - Task Interrupt Vector 8 //! \param claTaskAddr is the start address of the code for task //! //! Each CLA Task (1 to 8) has its own MVECTx register. When a task is //! triggered, the CLA loads the MVECTx register of the task in question //! to the MPC (CLA program counter) and begins execution from that point. //! The CLA has a 16-bit address bus, and can therefore, access the lower //! 64 KW space. The MVECTx registers take an address anywhere in this space. //! //! \return None. // //***************************************************************************** static inline void CLA_mapTaskVector(uint32_t base, CLA_MVECTNumber claIntVect, uint16_t claTaskAddr) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 295); } } while((_Bool)0); // // Modify protected register // __eallow(); (*((volatile uint16_t *)(base + (uint16_t)claIntVect))) = claTaskAddr; __edis(); } //***************************************************************************** // //! Hard Reset //! //! \param base is the base address of the CLA controller. //! //! This function will cause a hard reset of the CLA and set all CLA registers //! to their default state. //! //! \return None. // //***************************************************************************** static inline void CLA_performHardReset(uint32_t base) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 325); } } while((_Bool)0); // // Modify protected register // __eallow(); // // Hard reset of the CLA // (*((volatile uint16_t *)(base + 0x10U))) |= 0x1U; __edis(); // // Wait for few cycles till the reset is complete // __asm(" NOP"); __asm(" NOP"); __asm(" NOP"); } //***************************************************************************** // //! Soft Reset //! //! \param base is the base address of the CLA controller. //! //! This function will cause a soft reset of the CLA. This will stop the //! current task, clear the MIRUN flag and clear all bits in the MIER register. //! //! \return None. // //***************************************************************************** static inline void CLA_performSoftReset(uint32_t base) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 365); } } while((_Bool)0); // // Modify protected register // __eallow(); // // Soft reset of the CLA // (*((volatile uint16_t *)(base + 0x10U))) |= 0x2U; __edis(); // // Wait for few cycles till the reset is complete // __asm(" NOP"); __asm(" NOP"); __asm(" NOP"); } //***************************************************************************** // //! IACK enable //! //! \param base is the base address of the CLA controller. //! //! This function enables the main CPU to use the IACK #16bit instruction to //! set MIFR bits in the same manner as writing to the MIFRC register. //! //! \return None. // //***************************************************************************** static inline void CLA_enableIACK(uint32_t base) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 405); } } while((_Bool)0); // // Modify protected register // __eallow(); // // Enable the main CPU to use the IACK #16bit instruction // (*((volatile uint16_t *)(base + 0x10U))) |= 0x4U; __edis(); } //***************************************************************************** // //! IACK disable //! //! \param base is the base address of the CLA controller. //! //! This function disables the main CPU to use the IACK #16bit instruction to //! set MIFR bits in the same manner as writing to the MIFRC register. //! //! \return None. // //***************************************************************************** static inline void CLA_disableIACK(uint32_t base) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 438); } } while((_Bool)0); // // Modify protected register // __eallow(); // // Enable the main CPU to use the IACK #16bit instruction // (*((volatile uint16_t *)(base + 0x10U))) &= ~0x4U; __edis(); } //***************************************************************************** // //! Query task N to see if it is flagged and pending execution //! //! \param base is the base address of the CLA controller. //! \param taskNumber is the number of the task CLA_TASK_N where N is a number //! from 1 to 8. Do not use CLA_TASKFLAG_ALL. //! //! This function gets the status of each bit in the interrupt flag register //! corresponds to a CLA task. The corresponding bit is automatically set //! when the task is triggered (either from a peripheral, through software, or //! through the MIFRC register). The bit gets cleared when the CLA starts to //! execute the flagged task. //! //! \return \b True if the queried task has been triggered but pending //! execution. // //***************************************************************************** static inline _Bool CLA_getPendingTaskFlag(uint32_t base, CLA_TaskNumber taskNumber) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 477); } } while((_Bool)0); // // Read the run status register and return the appropriate value. // return((((*((volatile uint16_t *)(base + 0x20U))) >> (uint16_t)taskNumber) & 1U) != 0U); } //***************************************************************************** // //! Get status of All Task Interrupt Flag //! //! \param base is the base address of the CLA controller. //! //! This function gets the value of the interrupt flag register (MIFR) //! //! \return the value of Interrupt Flag Register (MIFR) // //***************************************************************************** static inline uint16_t CLA_getAllPendingTaskFlags(uint32_t base) { uint16_t status; // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 504); } } while((_Bool)0); // // Just return the Interrupt Flag Register (MIFR) since that is what was // requested. // status = (*((volatile uint16_t *)(base + 0x20U))); // // Return the Interrupt Flag Register value // return(status); } //***************************************************************************** // //! Get status of Task n Interrupt Overflow Flag //! //! \param base is the base address of the CLA controller. //! \param taskNumber is the number of the task CLA_TASK_N where N is a number //! from 1 to 8. Do not use CLA_TASKFLAG_ALL. //! //! This function gets the status of each bit in the overflow flag register //! corresponds to a CLA task, This bit is set when an interrupt overflow event //! has occurred for the specific task. //! //! \return True if any of task interrupt overflow has occurred. // //***************************************************************************** static inline _Bool CLA_getTaskOverflowFlag(uint32_t base, CLA_TaskNumber taskNumber) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 539); } } while((_Bool)0); // // Read the run status register and return the appropriate value. // return((((*((volatile uint16_t *)(base + 0x21U))) >> (uint16_t)taskNumber) & 1U) != 0U); } //***************************************************************************** // //! Get status of All Task Interrupt Overflow Flag //! //! \param base is the base address of the CLA controller. //! //! This function gets the value of the Interrupt Overflow Flag Register //! //! \return the value of Interrupt Overflow Flag Register(MIOVF) // //***************************************************************************** static inline uint16_t CLA_getAllTaskOverflowFlags(uint32_t base) { uint16_t status; // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 566); } } while((_Bool)0); // // Just return Interrupt Overflow Flag Register(MIOVF) since that is what // was requested. // status = (*((volatile uint16_t *)(base + 0x21U))); // // Return the Interrupt Overflow Flag Register // return(status); } //***************************************************************************** // //! Clear the task interrupt flag //! //! \param base is the base address of the CLA controller. //! \param taskFlags is the bitwise OR of the tasks' flags to be cleared //! CLA_TASKFLAG_N where N is the task number from 1 to 8, or CLA_TASKFLAG_ALL //! to clear all flags. //! //! This function is used to manually clear bits in the interrupt //! flag (MIFR) register //! //! \return None. // //***************************************************************************** static inline void CLA_clearTaskFlags(uint32_t base, uint16_t taskFlags) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 601); } } while((_Bool)0); // //Modify protected register // __eallow(); // // Clear the task interrupt flag // (*((volatile uint16_t *)(base + 0x23U))) |= taskFlags; __edis(); } //***************************************************************************** // //! Force a CLA Task //! //! \param base is the base address of the CLA controller. //! \param taskFlags is the bitwise OR of the tasks' flags to be forced //! CLA_TASKFLAG_N where N is the task number from 1 to 8, or CLA_TASKFLAG_ALL //! to force all tasks. //! //! This function forces a task through software. //! //! \return None. // //***************************************************************************** static inline void CLA_forceTasks(uint32_t base, uint16_t taskFlags) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 636); } } while((_Bool)0); // // Modify protected register // __eallow(); // // Force the task interrupt. // (*((volatile uint16_t *)(base + 0x22U))) |= taskFlags; __edis(); } //***************************************************************************** // //! Enable CLA task(s) //! //! \param base is the base address of the CLA controller. //! \param taskFlags is the bitwise OR of the tasks' flags to be enabled //! CLA_TASKFLAG_N where N is the task number from 1 to 8, or CLA_TASKFLAG_ALL //! to enable all tasks //! //! This function allows an incoming interrupt or main CPU software to //! start the corresponding CLA task. //! //! \return None. // //***************************************************************************** static inline void CLA_enableTasks(uint32_t base, uint16_t taskFlags) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 672); } } while((_Bool)0); // // Modify protected register // __eallow(); // // Enable CLA task // (*((volatile uint16_t *)(base + 0x25U))) |= taskFlags; __edis(); } //***************************************************************************** // //! Disable CLA task interrupt //! //! \param base is the base address of the CLA controller. //! \param taskFlags is the bitwise OR of the tasks' flags to be disabled //! CLA_TASKFLAG_N where N is the task number from 1 to 8, or CLA_TASKFLAG_ALL //! to disable all tasks //! //! This function disables CLA task interrupt by setting the MIER register bit //! to 0, while the corresponding task is executing this will have no effect //! on the task. The task will continue to run until it hits the MSTOP //! instruction. //! //! \return None. // //***************************************************************************** static inline void CLA_disableTasks(uint32_t base, uint16_t taskFlags) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 710); } } while((_Bool)0); // // Modify protected register // __eallow(); // // Disable CLA task interrupt // (*((volatile uint16_t *)(base + 0x25U))) &= ~taskFlags; __edis(); } //***************************************************************************** // //! Get the value of a task run status //! //! \param base is the base address of the CLA controller. //! \param taskNumber is the number of the task CLA_TASK_N where N is a number //! from 1 to 8. Do not use CLA_TASKFLAG_ALL. //! //! This function gets the status of each bit in the Interrupt Run Status //! Register which indicates whether the task is currently executing //! //! \return True if the task is executing. // //***************************************************************************** static inline _Bool CLA_getTaskRunStatus(uint32_t base, CLA_TaskNumber taskNumber) { // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 745); } } while((_Bool)0); // // Read the run status register and return the appropriate value. // return((((*((volatile uint16_t *)(base + 0x26U))) >> (uint16_t)taskNumber) & 1U) != 0U); } //***************************************************************************** // //! Get the value of all task run status //! //! \param base is the base address of the CLA controller. //! //! This function indicates which task is currently executing. //! //! \return the value of Interrupt Run Status Register (MIRUN) // //***************************************************************************** static inline uint16_t CLA_getAllTaskRunStatus(uint32_t base) { uint16_t status; // // Check the arguments. // do { if(!(CLA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cla.h", 772); } } while((_Bool)0); // // Just return the Interrupt Run Status Register since that is what was // requested. // status = (*((volatile uint16_t *)(base + 0x26U))); // // Return the Interrupt Run Status Register (MIRUN) // return(status); } // // These functions are accessible only from the CLA (Type - 1/2) // // // These functions can only be called from the C28x // //***************************************************************************** // //! Configures CLA task triggers. //! //! \param taskNumber is the number of the task CLA_TASK_N where N is a number //! from 1 to 8. //! \param trigger is the trigger source to be assigned to the selected task. //! //! This function configures the trigger source of a CLA task. The //! \e taskNumber parameter indicates which task is being configured, and the //! \e trigger parameter is the interrupt source from a specific peripheral //! interrupt (or software) that will trigger the task. //! //! \return None. // //***************************************************************************** extern void CLA_setTriggerSource(CLA_TaskNumber taskNumber, CLA_Trigger trigger); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: clb.h // // TITLE: C28x CLB driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup clb_api CLB //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_clb.h // // TITLE: Definitions for the CLB registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the CLB register offsets // //************************************************************************************************* // synchronizers // HLC) //************************************************************************************************* // // The following are defines for the bit fields in the CLB_COUNT_RESET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_COUNT_MODE_1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_COUNT_MODE_0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_COUNT_EVENT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_EXTRA_IN0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_EXTERNAL_IN0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_EXTERNAL_IN1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_EXTRA_IN1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LUT4_IN0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LUT4_IN1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LUT4_IN2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LUT4_IN3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_LUT_FN1_0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_LUT_FN2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LUT4_FN1_0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LUT4_FN2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_NEXT_STATE_0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_NEXT_STATE_1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_FSM_NEXT_STATE_2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_MISC_CONTROL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_5 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_6 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_OUTPUT_LUT_7 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_HLC_EVENT_SEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LOAD_EN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LOAD_ADDR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_INPUT_FILTER register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_IN_MUX_SEL_0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LCL_MUX_SEL_1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LCL_MUX_SEL_2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_BUF_PTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_GP_REG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_GLBL_MUX_SEL_1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_GLBL_MUX_SEL_2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_INTR_TAG_REG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_LOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CLB_DBG_OUT register // //************************************************************************************************* //***************************************************************************** // // Address offsets from LOGICCFG to LOGICCTL and DATAEXCH register memory maps // //***************************************************************************** //***************************************************************************** // // Address offsets for CLB-internal memory space // //***************************************************************************** //***************************************************************************** // // PUSH/PULL FIFO size (32-bit registers) // //***************************************************************************** //***************************************************************************** // // Key to enable writes to the CLB registers // //***************************************************************************** //***************************************************************************** // // Shift and masks needed by the API for Input selection // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to control the CLB output enable signal. It can //! be passed to CLB_setOutputMask() as the \e outputMask parameter. // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to select CLB input signal // //***************************************************************************** typedef enum { CLB_IN0 = 0, //!< Input 0 CLB_IN1 = 1, //!< Input 1 CLB_IN2 = 2, //!< Input 2 CLB_IN3 = 3, //!< Input 3 CLB_IN4 = 4, //!< Input 4 CLB_IN5 = 5, //!< Input 5 CLB_IN6 = 6, //!< Input 6 CLB_IN7 = 7 //!< Input 7 } CLB_Inputs; //***************************************************************************** // //! Values that can be passed to select CLB output signal. It can be passed to //! CLB_configOutputLUT() as the \e outID parameter. // //***************************************************************************** typedef enum { CLB_OUT0 = 0, //!< Output 0 CLB_OUT1 = 1, //!< Output 1 CLB_OUT2 = 2, //!< Output 2 CLB_OUT3 = 3, //!< Output 3 CLB_OUT4 = 4, //!< Output 4 CLB_OUT5 = 5, //!< Output 5 CLB_OUT6 = 6, //!< Output 6 CLB_OUT7 = 7 //!< Output 7 } CLB_Outputs; //***************************************************************************** // //! Values that can be passed to select CLB counter. It can be passed to //! CLB_configCounterLoadMatch() as the \e counterID parameter. // //***************************************************************************** typedef enum { CLB_CTR0 = 0, //!< Counter 0 CLB_CTR1 = 1, //!< Counter 1 CLB_CTR2 = 2 //!< Counter 2 } CLB_Counters; //***************************************************************************** // //! Values that can be passed to CLB_getRegister() as the \e registerID //! parameter. // //***************************************************************************** typedef enum { CLB_REG_HLC_R0 = 0x30U, //!< HLC R0 register CLB_REG_HLC_R1 = 0x32U, //!< HLC R1 register CLB_REG_HLC_R2 = 0x34U, //!< HLC R2 register CLB_REG_HLC_R3 = 0x36U, //!< HLC R3 register CLB_REG_CTR_C0 = 0x38U, //!< Counter 0 register CLB_REG_CTR_C1 = 0x3AU, //!< Counter 1 register CLB_REG_CTR_C2 = 0x3CU //!< Counter 2 register } CLB_Register; //***************************************************************************** // //! Values that can be passed to CLB_selectInputFilter() as the \e filterType //! parameter. // //***************************************************************************** typedef enum { CLB_FILTER_NONE = 0, //!< No filtering CLB_FILTER_RISING_EDGE = 1, //!< Rising edge detect CLB_FILTER_FALLING_EDGE = 2, //!< Falling edge detect CLB_FILTER_ANY_EDGE = 3 //!< Any edge detect } CLB_FilterType; //***************************************************************************** // //! Values that can be passed to CLB_configGPInputMux() as the \e gpMuxCfg //! parameter. // //***************************************************************************** typedef enum { CLB_GP_IN_MUX_EXTERNAL = 0, //!< Use external input path CLB_GP_IN_MUX_GP_REG = 1 //!< Use CLB_GP_REG bit value as input } CLB_GPInputMux; //***************************************************************************** // //! Values that can be passed to CLB_configLocalInputMux() as the //! \e localMuxCfg parameter. // //***************************************************************************** typedef enum { CLB_LOCAL_IN_MUX_GLOBAL_IN = 0, //!< Global input mux selection CLB_LOCAL_IN_MUX_EPWM_DCAEVT1 = 1, //!< EPWMx DCAEVT1 CLB_LOCAL_IN_MUX_EPWM_DCAEVT2 = 2, //!< EPWMx DCAEVT2 CLB_LOCAL_IN_MUX_EPWM_DCBEVT1 = 3, //!< EPWMx DCBEVT1 CLB_LOCAL_IN_MUX_EPWM_DCBEVT2 = 4, //!< EPWMx DCBEVT2 CLB_LOCAL_IN_MUX_EPWM_DCAH = 5, //!< EPWMx DCAH CLB_LOCAL_IN_MUX_EPWM_DCAL = 6, //!< EPWMx DCAL CLB_LOCAL_IN_MUX_EPWM_DCBH = 7, //!< EPWMx DCBH CLB_LOCAL_IN_MUX_EPWM_DCBL = 8, //!< EPWMx DCBL CLB_LOCAL_IN_MUX_EPWM_OST = 9, //!< EPWMx OST CLB_LOCAL_IN_MUX_EPWM_CBC = 10, //!< EPWMx CBC CLB_LOCAL_IN_MUX_ECAP_ECAPIN = 11, //!< ECAPx ECAPIN CLB_LOCAL_IN_MUX_ECAP_ECAP_OUT = 12, //!< ECAPx ECAP_OUT CLB_LOCAL_IN_MUX_ECAP_ECAP_OUT_EN = 13, //!< ECAPx ECAP_OUT_EN CLB_LOCAL_IN_MUX_ECAP_CEVT1 = 14, //!< ECAPx CEVT1 CLB_LOCAL_IN_MUX_ECAP_CEVT2 = 15, //!< ECAPx CEVT2 CLB_LOCAL_IN_MUX_ECAP_CEVT3 = 16, //!< ECAPx CEVT3 CLB_LOCAL_IN_MUX_ECAP_CEVT4 = 17, //!< ECAPx CEVT4 CLB_LOCAL_IN_MUX_EQEP_EQEPA = 18, //!< EQEPx EQEPA CLB_LOCAL_IN_MUX_EQEP_EQEPB = 19, //!< EQEPx EQEPB CLB_LOCAL_IN_MUX_EQEP_EQEPI = 20, //!< EQEPx EQEPI CLB_LOCAL_IN_MUX_EQEP_EQEPS = 21, //!< EQEPx EQEPS CLB_LOCAL_IN_MUX_CPU1_TBCLKSYNC = 22, //!< CPU1.TBCLKSYNC CLB_LOCAL_IN_MUX_CPU2_TBCLKSYNC = 23, //!< CPU2.TBCLKSYNC CLB_LOCAL_IN_MUX_CPU1_HALT = 24, //!< CPU1.HALT CLB_LOCAL_IN_MUX_CPU2_HALT = 25, //!< CPU2.HALT } CLB_LocalInputMux; //***************************************************************************** // //! Values that can be passed to CLB_configGlobalInputMux() as the //! \e globalMuxCfg parameter. // //***************************************************************************** typedef enum { CLB_GLOBAL_IN_MUX_EPWM1A = 0, //!< EPWM1A CLB_GLOBAL_IN_MUX_EPWM1A_OE = 1, //!< EPWM1A trip output CLB_GLOBAL_IN_MUX_EPWM1B = 2, //!< EPWM1B CLB_GLOBAL_IN_MUX_EPWM1B_OE = 3, //!< EPWM1B trip output CLB_GLOBAL_IN_MUX_EPWM1_CTR_ZERO = 4, //!< EPWM1 TBCTR = Zero CLB_GLOBAL_IN_MUX_EPWM1_CTR_PRD = 5, //!< EPWM1 TBCTR = TBPRD CLB_GLOBAL_IN_MUX_EPWM1_CTRDIR = 6, //!< EPWM1 CTRDIR CLB_GLOBAL_IN_MUX_EPWM1_TBCLK = 7, //!< EPWM1 TBCLK CLB_GLOBAL_IN_MUX_EPWM1_CTR_CMPA = 8, //!< EPWM1 TBCTR = CMPA CLB_GLOBAL_IN_MUX_EPWM1_CTR_CMPB = 9, //!< EPWM1 TBCTR = CMPB CLB_GLOBAL_IN_MUX_EPWM1_CTR_CMPC = 10, //!< EPWM1 TBCTR = CMPC CLB_GLOBAL_IN_MUX_EPWM1_CTR_CMPD = 11, //!< EPWM1 TBCTR = CMPD CLB_GLOBAL_IN_MUX_EPWM1A_AQ = 12, //!< EPWM1A AQ submodule output CLB_GLOBAL_IN_MUX_EPWM1B_AQ = 13, //!< EPWM1B AQ submodule output CLB_GLOBAL_IN_MUX_EPWM1A_DB = 14, //!< EPWM1A DB submodule output CLB_GLOBAL_IN_MUX_EPWM1B_DB = 15, //!< EPWM1B DB submodule output CLB_GLOBAL_IN_MUX_EPWM2A = 16, //!< EPWM2A CLB_GLOBAL_IN_MUX_EPWM2A_OE = 17, //!< EPWM2A trip output CLB_GLOBAL_IN_MUX_EPWM2B = 18, //!< EPWM2B CLB_GLOBAL_IN_MUX_EPWM2B_OE = 19, //!< EPWM2B trip output CLB_GLOBAL_IN_MUX_EPWM2_CTR_ZERO = 20, //!< EPWM2 TBCTR = Zero CLB_GLOBAL_IN_MUX_EPWM2_CTR_PRD = 21, //!< EPWM2 TBCTR = TBPRD CLB_GLOBAL_IN_MUX_EPWM2_CTRDIR = 22, //!< EPWM2 CTRDIR CLB_GLOBAL_IN_MUX_EPWM2_TBCLK = 23, //!< EPWM2 TBCLK CLB_GLOBAL_IN_MUX_EPWM2_CTR_CMPA = 24, //!< EPWM2 TBCTR = CMPA CLB_GLOBAL_IN_MUX_EPWM2_CTR_CMPB = 25, //!< EPWM2 TBCTR = CMPB CLB_GLOBAL_IN_MUX_EPWM2_CTR_CMPC = 26, //!< EPWM2 TBCTR = CMPC CLB_GLOBAL_IN_MUX_EPWM2_CTR_CMPD = 27, //!< EPWM2 TBCTR = CMPD CLB_GLOBAL_IN_MUX_EPWM2A_AQ = 28, //!< EPWM2A AQ submodule output CLB_GLOBAL_IN_MUX_EPWM2B_AQ = 29, //!< EPWM2B AQ submodule output CLB_GLOBAL_IN_MUX_EPWM2A_DB = 30, //!< EPWM2A DB submodule output CLB_GLOBAL_IN_MUX_EPWM2B_DB = 31, //!< EPWM2B DB submodule output CLB_GLOBAL_IN_MUX_EPWM3A = 32, //!< EPWM3A CLB_GLOBAL_IN_MUX_EPWM3A_OE = 33, //!< EPWM3A trip output CLB_GLOBAL_IN_MUX_EPWM3B = 34, //!< EPWM3B CLB_GLOBAL_IN_MUX_EPWM3B_OE = 35, //!< EPWM3B trip output CLB_GLOBAL_IN_MUX_EPWM3_CTR_ZERO = 36, //!< EPWM3 TBCTR = Zero CLB_GLOBAL_IN_MUX_EPWM3_CTR_PRD = 37, //!< EPWM3 TBCTR = TBPRD CLB_GLOBAL_IN_MUX_EPWM3_CTRDIR = 38, //!< EPWM3 CTRDIR CLB_GLOBAL_IN_MUX_EPWM3_TBCLK = 39, //!< EPWM3 TBCLK CLB_GLOBAL_IN_MUX_EPWM3_CTR_CMPA = 40, //!< EPWM3 TBCTR = CMPA CLB_GLOBAL_IN_MUX_EPWM3_CTR_CMPB = 41, //!< EPWM3 TBCTR = CMPB CLB_GLOBAL_IN_MUX_EPWM3_CTR_CMPC = 42, //!< EPWM3 TBCTR = CMPC CLB_GLOBAL_IN_MUX_EPWM3_CTR_CMPD = 43, //!< EPWM3 TBCTR = CMPD CLB_GLOBAL_IN_MUX_EPWM3A_AQ = 44, //!< EPWM3A AQ submodule output CLB_GLOBAL_IN_MUX_EPWM3B_AQ = 45, //!< EPWM3B AQ submodule output CLB_GLOBAL_IN_MUX_EPWM3A_DB = 46, //!< EPWM3A DB submodule output CLB_GLOBAL_IN_MUX_EPWM3B_DB = 47, //!< EPWM3B DB submodule output CLB_GLOBAL_IN_MUX_EPWM4A = 48, //!< EPWM4A CLB_GLOBAL_IN_MUX_EPWM4A_OE = 49, //!< EPWM4A trip output CLB_GLOBAL_IN_MUX_EPWM4B = 50, //!< EPWM4B CLB_GLOBAL_IN_MUX_EPWM4B_OE = 51, //!< EPWM4B trip output CLB_GLOBAL_IN_MUX_EPWM4_CTR_ZERO = 52, //!< EPWM4 TBCTR = Zero CLB_GLOBAL_IN_MUX_EPWM4_CTR_PRD = 53, //!< EPWM4 TBCTR = TBPRD CLB_GLOBAL_IN_MUX_EPWM4_CTRDIR = 54, //!< EPWM4 CTRDIR CLB_GLOBAL_IN_MUX_EPWM4_TBCLK = 55, //!< EPWM4 TBCLK CLB_GLOBAL_IN_MUX_EPWM4_CTR_CMPA = 56, //!< EPWM4 TBCTR = CMPA CLB_GLOBAL_IN_MUX_EPWM4_CTR_CMPB = 57, //!< EPWM4 TBCTR = CMPB CLB_GLOBAL_IN_MUX_EPWM4_CTR_CMPC = 58, //!< EPWM4 TBCTR = CMPC CLB_GLOBAL_IN_MUX_EPWM4_CTR_CMPD = 59, //!< EPWM4 TBCTR = CMPD CLB_GLOBAL_IN_MUX_EPWM4A_AQ = 60, //!< EPWM4A AQ submodule output CLB_GLOBAL_IN_MUX_EPWM4B_AQ = 61, //!< EPWM4B AQ submodule output CLB_GLOBAL_IN_MUX_EPWM4A_DB = 62, //!< EPWM4A DB submodule output CLB_GLOBAL_IN_MUX_EPWM4B_DB = 63, //!< EPWM4B DB submodule output CLB_GLOBAL_IN_MUX_CLB_AUXSIG0 = 64, //!< CLB X-BAR AUXSIG0 CLB_GLOBAL_IN_MUX_CLB_AUXSIG1 = 65, //!< CLB X-BAR AUXSIG1 CLB_GLOBAL_IN_MUX_CLB_AUXSIG2 = 66, //!< CLB X-BAR AUXSIG2 CLB_GLOBAL_IN_MUX_CLB_AUXSIG3 = 67, //!< CLB X-BAR AUXSIG3 CLB_GLOBAL_IN_MUX_CLB_AUXSIG4 = 68, //!< CLB X-BAR AUXSIG4 CLB_GLOBAL_IN_MUX_CLB_AUXSIG5 = 69, //!< CLB X-BAR AUXSIG5 CLB_GLOBAL_IN_MUX_CLB_AUXSIG6 = 70, //!< CLB X-BAR AUXSIG6 CLB_GLOBAL_IN_MUX_CLB_AUXSIG7 = 71, //!< CLB X-BAR AUXSIG7 } CLB_GlobalInputMux; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** // //! //! Checks the CLB base address. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function determines if a CLB base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool CLB_isBaseValid(uint32_t base) { return( (base == 0x00003000U) || (base == 0x00003400U) || (base == 0x00003800U) || (base == 0x00003C00U) ); } //***************************************************************************** // //! //! Checks the CLB internal memory address. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function determines if a CLB base address is valid. //! //! \return Returns \b true if the address is valid and \b false otherwise. // //***************************************************************************** static inline _Bool CLB_isAddressValid(uint32_t address) { return(address <= (0x20U + 31U)); } //***************************************************************************** // //! Set global enable. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function enables the CLB via global enable register. //! //! \return None. // //***************************************************************************** static inline void CLB_enableCLB(uint32_t base) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 438); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(base + 0x0100U + 0x0U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Clear global enable. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function disables the CLB via global enable register. //! //! \return None. // //***************************************************************************** static inline void CLB_disableCLB(uint32_t base) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 458); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(base + 0x0100U + 0x0U))) &= ~0x2U; __edis(); } //***************************************************************************** // //! Enable CLB lock. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function enables the lock bit of the lock register. The lock can only //! be set once and can only be cleared by a device reset. //! //! \return None. // //***************************************************************************** static inline void CLB_enableLock(uint32_t base) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 479); } } while((_Bool)0); // // Setting the lock bit requires key 0x5A5A to be written at the same time // __eallow(); (*((volatile uint32_t *)(base + 0x0100U + 0x22U))) = (uint32_t)0x1U | ((uint32_t)0x5A5AU << 16U); __edis(); } //***************************************************************************** // //! Write value to address. //! //! \param base is the base address of a CLB tile's logic config register. //! \param address is the address of CLB internal memory. //! \param value is the value to write to specified address. //! //! This function writes the specified value to CLB internal memory. //! //! \return None. // //***************************************************************************** static inline void CLB_writeInterface(uint32_t base, uint32_t address, uint32_t value) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 506); } } while((_Bool)0); do { if(!(CLB_isAddressValid(address))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 507); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x0100U + 0x2U))) = address; (*((volatile uint32_t *)(base + 0x0100U + 0x4U))) = value; (*((volatile uint32_t *)(base + 0x0100U + 0x0U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Select input filter type. //! //! \param base is the base address of a CLB tile's logic config register. //! \param inID is the specified CLB tile input signal. //! \param filterType is the selected type of filter applied to the input. //! //! This function configures the filter selection for the specified input. //! The \e inID parameter can have one enumeration value from CLB_Inputs. //! The \e filterType parameter can have one enumeration value from //! CLB_FilterType. //! //! \return None. // //***************************************************************************** static inline void CLB_selectInputFilter(uint32_t base, CLB_Inputs inID, CLB_FilterType filterType) { uint16_t shiftVal; do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 537); } } while((_Bool)0); // // Each input has a 2-bit field in this register so need to calculate // shift amount accordingly. // shiftVal = (uint16_t)inID << 1; (*((volatile uint16_t *)(base + 0x0100U + 0x6U))) = ((*((volatile uint16_t *)(base + 0x0100U + 0x6U))) & ~(0x3U << shiftVal)) | ((uint16_t)filterType << shiftVal); } //***************************************************************************** // //! Enables synchronization of an input signal. //! //! \param base is the base address of a CLB tile's logic config register. //! \param inID is the specified CLB tile input signal. //! //! This function enables synchronization on the specified input signal. //! The \e inID parameter can have one enumeration value from CLB_Inputs. //! //! \return None. // //***************************************************************************** static inline void CLB_enableSynchronization(uint32_t base, CLB_Inputs inID) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 566); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x0100U + 0x6U + 1U))) |= (1U << (uint16_t)inID); } //***************************************************************************** // //! Disables synchronization of an input signal. //! //! \param base is the base address of a CLB tile's logic config register. //! \param inID is the specified CLB tile input signal. //! //! This function disables synchronization on the specified input signal. //! The \e inID parameter can have one enumeration value from CLB_Inputs. //! //! \return None. // //***************************************************************************** static inline void CLB_disableSynchronization(uint32_t base, CLB_Inputs inID) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 587); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x0100U + 0x6U + 1U))) &= ~(1U << (uint16_t)inID); } //***************************************************************************** // //! Configures the general purpose input mux. //! //! \param base is the base address of a CLB tile's logic config register. //! \param inID is the specified CLB tile input signal. //! \param gpMuxCfg is the mux selection for the general purpose input mux. //! //! This function configures the general purpose input mux. The \e gpMuxCfg //! parameter can select either the use of an external input signal //! (\b CLB_GP_IN_MUX_EXTERNAL) or the use of the corresponding CLB_GP_REG bit //! as an input (\b CLB_GP_IN_MUX_GP_REG). //! The \e inID parameter can have one enumeration value from CLB_Inputs. //! //! \sa CLB_setGPREG() to write to the CLB_GP_REG. //! //! \return None. // //***************************************************************************** static inline void CLB_configGPInputMux(uint32_t base, CLB_Inputs inID, CLB_GPInputMux gpMuxCfg) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 615); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x0100U + 0x8U))) = ((*((volatile uint16_t *)(base + 0x0100U + 0x8U))) & ~(0x1U << (uint16_t)inID)) | ((uint16_t)gpMuxCfg << (uint16_t)inID); } //***************************************************************************** // //! Sets the CLB_GP_REG register value. //! //! \param base is the base address of a CLB tile's logic config register. //! \param gpRegVal is the value to be written to CLB_GP_REG. //! //! This function writes to the CLB_GP_REG register. When the general purpose //! input mux is configured to use CLB_GP_REG, each bit in \e gpRegVal //! corresponds to an input signal (bit 0 to Input 0, bit 1 to Input 1, and //! so on). //! //! \sa CLB_configGPInputMux() to select the CLB_GP_REG as the source for //! an input signal. //! //! \return None. // //***************************************************************************** static inline void CLB_setGPREG(uint32_t base, uint32_t gpRegVal) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 643); } } while((_Bool)0); (*((volatile uint32_t *)(base + 0x0100U + 0x10U))) = gpRegVal; } //***************************************************************************** // //! Gets the CLB_GP_REG register value. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function writes to the CLB_GP_REG register. When the general purpose //! input mux is configured to use CLB_GP_REG, each bit in \e gpRegVal //! corresponds to an input signal (bit 0 to Input 0, bit 1 to Input 1, and //! so on). //! //! \sa CLB_configGPInputMux() to select the CLB_GP_REG as the source for //! an input signal. //! //! \return CLB_GP_REG value. // //***************************************************************************** static inline uint32_t CLB_getGPREG(uint32_t base) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 667); } } while((_Bool)0); return((*((volatile uint32_t *)(base + 0x0100U + 0x10U)))); } //***************************************************************************** // //! Configures the local input mux. //! //! \param base is the base address of a CLB tile's logic config register. //! \param inID is the specified CLB tile input signal. //! \param localMuxCfg is the mux selection for the local input mux. //! //! This function configures the local input mux for the specified input //! signal. //! //! The \e inID parameter can have one enumeration value from CLB_Inputs. //! The \e localMuxCfg parameter can have one enumeration value from //! CLB_LocalInputMux. //! //! \note The local input mux options' peripheral sources depend on which //! instance of the CLB (\e base) you are using. For example, for CLB1 the //! EPWM signal selections come from EPWM1 but for CLB2 they come from EPWM2. //! See your technical reference manual for details. //! //! \return None. // //***************************************************************************** static inline void CLB_configLocalInputMux(uint32_t base, CLB_Inputs inID, CLB_LocalInputMux localMuxCfg) { uint16_t shiftVal; do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 700); } } while((_Bool)0); // // Each local input has a 5-bit field in this register so need to calculate // shift amount accordingly. // shiftVal = (uint16_t)inID * 5U; if(inID < CLB_IN4) { (*((volatile uint32_t *)(base + 0x0100U + 0xAU))) = ((*((volatile uint32_t *)(base + 0x0100U + 0xAU))) & ~((uint32_t)0x1FU << shiftVal)) | ((uint32_t)localMuxCfg << shiftVal); } else { // // Calculating shift amount for inputs > input3 // shiftVal -= 4U * 5U; (*((volatile uint32_t *)(base + 0x0100U + 0xCU))) = ((*((volatile uint32_t *)(base + 0x0100U + 0xCU))) & ~((uint32_t)0x1FU << shiftVal)) | ((uint32_t)localMuxCfg << shiftVal); } } //***************************************************************************** // //! Configures the global input mux. //! //! \param base is the base address of a CLB tile's logic config register. //! \param inID is the specified CLB tile input signal. //! \param globalMuxCfg is the mux selection for the global input mux. //! //! This function configures the global input mux for the specified input //! signal. //! The \e inID parameter can have one enumeration value from CLB_Inputs. //! The \e globalMuxCfg parameter can have one enumeration value from //! CLB_GlobalInputMux. //! //! \note The global input mux options' peripheral sources depend on which //! instance of the CLB (\e base) you are using. For example, for CLB1 the //! EPWM signal selections come from EPWM1 but for CLB2 they come from EPWM2. //! See your technical reference manual for details. //! //! \return None. // //***************************************************************************** static inline void CLB_configGlobalInputMux(uint32_t base, CLB_Inputs inID, CLB_GlobalInputMux globalMuxCfg) { uint16_t shiftVal; do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 755); } } while((_Bool)0); // // Each input has a 5-bit field in this register so need to calculate // shift amount accordingly. // shiftVal = (uint16_t)inID * 7U; if(inID < CLB_IN4) { (*((volatile uint32_t *)(base + 0x0100U + 0x14U))) = ((*((volatile uint32_t *)(base + 0x0100U + 0x14U))) & ~((uint32_t)0x7FU << shiftVal)) | ((uint32_t)globalMuxCfg << shiftVal); } else { shiftVal -= 4U * 7U; (*((volatile uint32_t *)(base + 0x0100U + 0x16U))) = ((*((volatile uint32_t *)(base + 0x0100U + 0x16U))) & ~((uint32_t)0x7FU << shiftVal)) | ((uint32_t)globalMuxCfg << shiftVal); } } //***************************************************************************** // //! Controls the output enable. //! //! \param base is the base address of a CLB tile's logic config register. //! \param outputMask is a mask of the outputs to be enabled. //! \param enable is a switch to decide if the CLB outputs need to be enabled //! or not. //! //! This function is used to enable and disable CLB outputs by writing a mask //! to CLB_OUT_EN. Each bit corresponds to a CLB output. When a bit is 1, the //! corresponding output is enabled; when a bit is 0, the output is disabled. //! //! The \e outputMask parameter takes a logical OR of any of the CLB_OUTPUT_0x //! values that correspond to the CLB OUTPUT ENABLE for the respective outputs. //! The \e enable parameter can have one of the values from: //! false: Disable the respective CLB outputs //! true: Enable the respective CLB outputs //! //! \return None. // //***************************************************************************** static inline void CLB_setOutputMask(uint32_t base, uint32_t outputMask , _Bool enable) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 805); } } while((_Bool)0); if(enable == 1) { (*((volatile uint32_t *)(base + 0x0100U + 0x12U))) |= outputMask; } else { (*((volatile uint32_t *)(base + 0x0100U + 0x12U))) &= ~outputMask; } } //***************************************************************************** // //! Reads the interrupt tag register. //! //! \param base is the base address of a CLB tile's logic config register. //! //! \return Returns the value in the interrupt tag register which is a 6-bit //! constant set by the HLC. // //***************************************************************************** static inline uint16_t CLB_getInterruptTag(uint32_t base) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 829); } } while((_Bool)0); return((*((volatile uint16_t *)(base + 0x0100U + 0x20U)))); } //***************************************************************************** // //! Clears the interrupt tag register. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function clears the interrupt tag register, setting it to 0. //! //! \return None. // //***************************************************************************** static inline void CLB_clearInterruptTag(uint32_t base) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 847); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x0100U + 0x20U))) = 0U; } //***************************************************************************** // //! Selects LUT4 inputs. //! //! \param base is the base address of a CLB tile's logic config register. //! \param lut4In0 is the value for LUT4 input signal 0. Generated by tool as //! \b TILEx_CFG_LUT4_IN0. //! \param lut4In1 is the value for LUT4 input signal 1. Generated by tool as //! \b TILEx_CFG_LUT4_IN1. //! \param lut4In2 is the value for LUT4 input signal 2. Generated by tool as //! \b TILEx_CFG_LUT4_IN2. //! \param lut4In3 is the value for LUT4 input signal 3. Generated by tool as //! \b TILEx_CFG_LUT4_IN3. //! //! This function configures the LUT4 block's input signals. //! //! \return None. // //***************************************************************************** static inline void CLB_selectLUT4Inputs(uint32_t base, uint32_t lut4In0, uint32_t lut4In1, uint32_t lut4In2, uint32_t lut4In3) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 875); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x12U))) = lut4In0; (*((volatile uint32_t *)(base + 0x14U))) = lut4In1; (*((volatile uint32_t *)(base + 0x16U))) = lut4In2; (*((volatile uint32_t *)(base + 0x18U))) = lut4In3; __edis(); } //***************************************************************************** // //! Configures LUT4 functions. //! //! \param base is the base address of a CLB tile's logic config register. //! \param lut4Fn10 is the equation value for LUT4 blocks 0 and 1. Generated by //! tool as \b TILEx_CFG_LUT4_FN10. //! \param lut4Fn2 is the equation value for LUT4 block2. Generated by tool as //! \b TILEx_CFG_LUT4_FN2. //! //! This function configures the LUT4 block's equations. //! //! \return None. // //***************************************************************************** static inline void CLB_configLUT4Function(uint32_t base, uint32_t lut4Fn10, uint32_t lut4Fn2) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 903); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x20U))) = lut4Fn10; (*((volatile uint32_t *)(base + 0x22U))) = lut4Fn2; __edis(); } //***************************************************************************** // //! Selects FSM inputs. //! //! \param base is the base address of a CLB tile's logic config register. //! \param external0 is the value for FSM external 0 input. Generated by tool //! as \b TILEx_CFG_FSM_EXT_IN0. //! \param external1 is the value for FSM external 1 input. Generated by tool //! as \b TILEx_CFG_FSM_EXT_IN1. //! \param extra0 is the value for FSM extra 0 input. Generated by tool //! as \b TILEx_CFG_FSM_EXTRA_IN0. //! \param extra1 is the value for FSM extra 1 input. Generated by tool //! as \b TILEx_CFG_FSM_EXTRA_IN1. //! //! This function configures the FSM block's external inputs and extra external //! inputs. //! //! \return None. // //***************************************************************************** static inline void CLB_selectFSMInputs(uint32_t base, uint32_t external0, uint32_t external1, uint32_t extra0, uint32_t extra1) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 935); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0xCU))) = external0; (*((volatile uint32_t *)(base + 0xEU))) = external1; (*((volatile uint32_t *)(base + 0xAU))) = extra0; (*((volatile uint32_t *)(base + 0x10U))) = extra1; __edis(); } //***************************************************************************** // //! Configures FSM LUT function. //! //! \param base is the base address of a CLB tile's logic config register. //! \param fsmLutFn10 is the value for FSM 0 & FSM 1 LUT function. Generated //! by tool as \b TILEx_CFG_FSM_LUT_FN10. //! \param fsmLutFn2 is the value for FSM 2 LUT function. Generated by tool as //! \b TILEx_CFG_FSM_LUT_FN2. //! //! This function configures the FSM block's LUT equations. //! //! \return None. // //***************************************************************************** static inline void CLB_configFSMLUTFunction(uint32_t base, uint32_t fsmLutFn10, uint32_t fsmLutFn2) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 963); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x1CU))) = fsmLutFn10; (*((volatile uint32_t *)(base + 0x1EU))) = fsmLutFn2; __edis(); } //***************************************************************************** // //! Configures FSM next state. //! //! \param base is the base address of a CLB tile's logic config register. //! \param nextState0 is the value for FSM 0's next state. Generated by tool as //! \b TILEx_CFG_FSM_NEXT_STATE_0. //! \param nextState1 is the value for FSM 1's next state. Generated by tool as //! \b TILEx_CFG_FSM_NEXT_STATE_1. //! \param nextState2 is the value for FSM 2's next state. Generated by tool as //! \b TILEx_CFG_FSM_NEXT_STATE_2. //! //! This function configures the FSM's next state equation. //! //! \return None. // //***************************************************************************** static inline void CLB_configFSMNextState(uint32_t base, uint32_t nextState0, uint32_t nextState1, uint32_t nextState2) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 992); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x24U))) = nextState0; (*((volatile uint32_t *)(base + 0x26U))) = nextState1; (*((volatile uint32_t *)(base + 0x28U))) = nextState2; __edis(); } //***************************************************************************** // //! Selects Counter inputs. //! //! \param base is the base address of a CLB tile's logic config register. //! \param reset is the value for counter's reset inputs. Generated by tool as //! \b TILEx_CFG_COUNTER_RESET. //! \param event is the value for counter's event inputs. Generated by tool as //! \b TILEx_CFG_COUNTER_EVENT. //! \param mode0 is the value for counter's mode 0 inputs. Generated by tool as //! \b TILEx_CFG_COUNTER_MODE_0. //! \param mode1 is the value for counter's mode 1 inputs. Generated by tool as //! \b TILEx_CFG_COUNTER_MODE_1. //! //! This function selects the input signals to the counter block. //! //! \return None. // //***************************************************************************** static inline void CLB_selectCounterInputs(uint32_t base, uint32_t reset, uint32_t event, uint32_t mode0, uint32_t mode1) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1024); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x2U))) = reset; (*((volatile uint32_t *)(base + 0x8U))) = event; (*((volatile uint32_t *)(base + 0x6U))) = mode0; (*((volatile uint32_t *)(base + 0x4U))) = mode1; __edis(); } //***************************************************************************** // //! Configures Counter and FSM modes. //! //! \param base is the base address of a CLB tile's logic config register. //! \param miscCtrl is the value to represent counter and FSM modes. //! Generated by tool as \b TILEx_CFG_MISC_CONTROL. //! //! This function configures the counter mode, particularly add/shift, load //! modes. The function also configures whether the FSM should use state inputs //! or an extra external input. //! //! \return None. // //***************************************************************************** static inline void CLB_configMiscCtrlModes(uint32_t base, uint32_t miscCtrl) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1051); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x2AU))) = miscCtrl; __edis(); } //***************************************************************************** // //! Configures Output LUT functions. //! //! \param base is the base address of a CLB tile's logic config register. //! \param outID is the specified CLB tile output signal. //! \param outputCfg is the value for the output LUT signal function and input //! signal selections. Generated by tool as \b TILEx_CFG_OUTLUT_n where //! n is the output number. //! //! This function configures the input signals and equations of the output LUT //! corresponding to the /e outID parameter. //! //! \return None. // //***************************************************************************** static inline void CLB_configOutputLUT(uint32_t base, CLB_Outputs outID, uint32_t outputCfg) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1077); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x2CU + (sizeof(uint32_t) * outID)))) = outputCfg; __edis(); } //***************************************************************************** // //! Configures HLC event selection. //! //! \param base is the base address of a CLB tile's logic config register. //! \param eventSel is the value for HLC event selection. Generated by tool as //! \b TILEx_HLC_EVENT_SEL. //! //! This function configures the event selection for the High Level Controller. //! //! \return None. // //***************************************************************************** static inline void CLB_configHLCEventSelect(uint32_t base, uint32_t eventSel) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1099); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(base + 0x3CU))) = eventSel; __edis(); } //***************************************************************************** // //! Program HLC instruction. //! //! \param base is the base address of a CLB tile's logic config register. //! \param instructionNum is the index into the HLC instruction memory. For //! example, a value of 0 corresponds to instruction 0 of event 0, //! a value of 1 corresponds to instruction 1 of event 0, and so on up //! to a value of 31 which corresponds to instruction 7 of event 3. //! \param instruction is the instruction to be programmed. Generated by tool //! as \b TILEx_HLCINSTR_n where n is the instruction number. //! //! This function configures the CLB internal memory corresponding to the //! specified HLC instruction number with the given instruction. //! //! \return None. // //***************************************************************************** static inline void CLB_programHLCInstruction(uint32_t base, uint32_t instructionNum, uint32_t instruction) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1128); } } while((_Bool)0); do { if(!(instructionNum < 32U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1129); } } while((_Bool)0); CLB_writeInterface(base, 0x20U + instructionNum, instruction); } //***************************************************************************** // //! Set HLC registers. //! //! \param base is the base address of a CLB tile's logic config register. //! \param r0Init is the value to write to HLC register R0. Generated by tool //! as \b TILEx_HLC_R0_INIT. //! \param r1Init is the value to write to HLC register R1. Generated by tool //! as \b TILEx_HLC_R1_INIT. //! \param r2Init is the value to write to HLC register R2. Generated by tool //! as \b TILEx_HLC_R2_INIT. //! \param r3Init is the value to write to HLC register R3. Generated by tool //! as \b TILEx_HLC_R3_INIT. //! //! This function configures the CLB internal memory corresponding to the HLC //! registers R0-R3 with the specified values. //! //! \return None. // //***************************************************************************** static inline void CLB_setHLCRegisters(uint32_t base, uint32_t r0Init, uint32_t r1Init, uint32_t r2Init, uint32_t r3Init) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1158); } } while((_Bool)0); CLB_writeInterface(base, 0xCU, r0Init); CLB_writeInterface(base, 0xDU, r1Init); CLB_writeInterface(base, 0xEU, r2Init); CLB_writeInterface(base, 0xFU, r3Init); } //***************************************************************************** // //! Get HLC or counter register values. //! //! \param base is the base address of a CLB tile's logic config register. //! \param registerID is the internal register from which to read. Can be //! either an HLC register (\b CLB_REG_HLC_Rn) or a counter value //! (\b CLB_REG_CTR_Cn). //! //! \return Returns the value in the specified HLC register or counter. // //***************************************************************************** static inline uint32_t CLB_getRegister(uint32_t base, CLB_Register registerID) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1180); } } while((_Bool)0); return((*((volatile uint32_t *)(base + 0x0100U + (uint32_t)registerID)))); } //***************************************************************************** // //! Get output status. //! //! \param base is the base address of a CLB tile's logic config register. //! //! \return Returns the output status of various components within the CLB tile //! such as a counter match or LUT output. Use the \b CLB_DBG_OUT_* //! masks from hw_clb.h to decode the bits. // //***************************************************************************** static inline uint32_t CLB_getOutputStatus(uint32_t base) { do { if(!(CLB_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/clb.h", 1198); } } while((_Bool)0); return((*((volatile uint32_t *)(base + 0x0100U + 0x3EU)))); } //***************************************************************************** // //! Configures Counter load and match. //! //! \param base is the base address of a CLB tile's logic config register. //! \param counterID is the specified counter unit. //! \param load is the value for counter's load mode. Generated by tool as //! \b TILEx_COUNTER_n_LOAD_VAL where n is the counter number. //! \param match1 is the value for counter's match 1. Generated by tool as //! \b TILEx_COUNTER_n_MATCH1_VAL where n is the counter number. //! \param match2 is the value for counter's match 2. Generated by tool as //! \b TILEx_COUNTER_n_MATCH2_VAL where n is the counter number. //! //! This function configures the CLB internal memory corresponding to the //! counter block's load and match values. //! //! \return None. // //***************************************************************************** extern void CLB_configCounterLoadMatch(uint32_t base, CLB_Counters counterID, uint32_t load, uint32_t match1, uint32_t match2); //***************************************************************************** // //! Clear FIFO registers. //! //! \param base is the base address of a CLB tile's logic config register. //! //! This function clears the PUSH/PULL FIFOs as well as its pointers. //! //! \return None. // //***************************************************************************** extern void CLB_clearFIFOs(uint32_t base); //***************************************************************************** // //! Configure the FIFO registers. //! //! \param base is the base address of a CLB tile's logic config register. //! \param pullData[] is a pointer to an array of bytes which needs to be //! written into the FIFO. The 0th FIFO data is in the 0th index. //! //! This function writes to the PULL FIFO. This also clears the FIFOs and //! its pointer using the CLB_clearFIFOs() API prior to writing to //! the FIFO. //! //! \return None. // //***************************************************************************** extern void CLB_writeFIFOs(uint32_t base, const uint32_t pullData[]); //***************************************************************************** // //! Read FIFO registers. //! //! \param base is the base address of a CLB tile's logic config register. //! \param pushData[] is a pointer to an array of bytes which needs to be //! read from the FIFO. //! //! This function reads from the PUSH FIFO. The 0th FIFO data would be in //! the 0th index. //! //! \return None. // //***************************************************************************** extern void CLB_readFIFOs(uint32_t base , uint32_t pushData[]); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: cmpss.h // // TITLE: C28x CMPSS driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup cmpss_api CMPSS //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_cmpss.h // // TITLE: Definitions for the CMPSS registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the CMPSS register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the COMPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the COMPHYSCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the COMPSTS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the COMPSTSCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the COMPDACCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACHVALS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACHVALA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACLVALS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACLVALA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RAMPDLYA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RAMPDLYS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CTRIPLFILCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CTRIPLFILCLKCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CTRIPHFILCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CTRIPHFILCLKCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the COMPLOCK register // //************************************************************************************************* //***************************************************************************** // // Useful defines used within the driver functions. Not intended for use by // application code. // //***************************************************************************** //***************************************************************************** // // Values that can be passed to CMPSS_configLowComparator() and // CMPSS_configHighComparator() as the config parameter. // //***************************************************************************** // // Comparator negative input source // //! Input driven by internal DAC //! Input driven by external pin // // Extra options // //! Comparator output is inverted //! Asynch comparator output feeds into OR with latched digital filter output //***************************************************************************** // // Values that can be passed to CMPSS_configOutputsLow() and // CMPSS_configOutputsHigh() as the config parameter. // //***************************************************************************** // // Signal driving CTRIPOUT // //! Asynchronous comparator output drives CTRIPOUT //! Synchronous comparator output drives CTRIPOUT //! Filter output drives CTRIPOUT //! Latched filter output drives CTRIPOUT // // Signal driving CTRIP // //! Asynchronous comparator output drives CTRIP //! Synchronous comparator output drives CTRIP //! Filter output drives CTRIP //! Latched filter output drives CTRIP //***************************************************************************** // // Values that can be returned by CMPSS_getStatus(). // //***************************************************************************** //! High digital filter output //! Latched value of high digital filter output //! Low digital filter output //! Latched value of low digital filter output //***************************************************************************** // // Values that can be passed to CMPSS_configDAC() the config parameter. // //***************************************************************************** // // When is DAC value loaded from shadow register // //! DAC value updated from SYSCLK //! DAC value updated from PWMSYNC // // DAC reference voltage // //! VDDA is the voltage reference //! VDAC is the voltage reference // // DAC value source // //! DAC value updated from shadow register //! DAC value is updated from the ramp register //***************************************************************************** // // Values that can be passed to CMPSS_configRamp() // as the pwmSyncSrc parameter. // //***************************************************************************** //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks the CMPSS base address. //! //! \param base is the base address of the CMPSS module. //! //! This function determines if a CMPSS base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool CMPSS_isBaseValid(uint32_t base) { return( (base == 0x00005C80U) || (base == 0x00005CA0U) || (base == 0x00005CC0U) || (base == 0x00005CE0U) || (base == 0x00005D00U) || (base == 0x00005D20U) || (base == 0x00005D40U) || (base == 0x00005D60U) ); } //***************************************************************************** // //! Enables the CMPSS module. //! //! \param base is the base address of the CMPSS module. //! //! This function enables the CMPSS module passed into the \e base parameter. //! //! \return None. // //***************************************************************************** static inline void CMPSS_enableModule(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 256); } } while((_Bool)0); // // Set the bit that enables the CMPSS module. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Disables the CMPSS module. //! //! \param base is the base address of the CMPSS module. //! //! This function disables the CMPSS module passed into the \e base parameter. //! //! \return None. // //***************************************************************************** static inline void CMPSS_disableModule(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 285); } } while((_Bool)0); // // Clear the bit that enables the CMPSS module. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) &= ~0x8000U; __edis(); } //***************************************************************************** // //! Sets the configuration for the high comparator. //! //! \param base is the base address of the CMPSS module. //! \param config is the configuration of the high comparator. //! //! This function configures a comparator. The \e config parameter is the //! result of a logical OR operation between a \b CMPSS_INSRC_xxx value and if //! desired, \b CMPSS_INV_INVERTED and \b CMPSS_OR_ASYNC_OUT_W_FILT values. //! //! The \b CMPSS_INSRC_xxx term can take on the following values to specify //! the high comparator negative input source: //! - \b CMPSS_INSRC_DAC - The internal DAC. //! - \b CMPSS_INSRC_PIN - An external pin. //! //! \b CMPSS_INV_INVERTED may be ORed into \e config if the comparator output //! should be inverted. //! //! \b CMPSS_OR_ASYNC_OUT_W_FILT may be ORed into \e config if the //! asynchronous comparator output should be fed into an OR gate with the //! latched digital filter output before it is made available for CTRIPH or //! CTRIPOUTH. //! //! \return None. // //***************************************************************************** static inline void CMPSS_configHighComparator(uint32_t base, uint16_t config) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 330); } } while((_Bool)0); // // Write the high comparator configuration to the appropriate register. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) = ((*((volatile uint16_t *)(base + 0x0U))) & ~(0x1U | 0x2U | 0x40U)) | config; __edis(); } //***************************************************************************** // //! Sets the configuration for the low comparator. //! //! \param base is the base address of the CMPSS module. //! \param config is the configuration of the low comparator. //! //! This function configures a comparator. The \e config parameter is the //! result of a logical OR operation between a \b CMPSS_INSRC_xxx value and if //! desired, \b CMPSS_INV_INVERTED and \b CMPSS_OR_ASYNC_OUT_W_FILT values. //! //! The \b CMPSS_INSRC_xxx term can take on the following values to specify //! the low comparator negative input source: //! - \b CMPSS_INSRC_DAC - The internal DAC. //! - \b CMPSS_INSRC_PIN - An external pin. //! //! \b CMPSS_INV_INVERTED may be ORed into \e config if the comparator output //! should be inverted. //! //! \b CMPSS_OR_ASYNC_OUT_W_FILT may be ORed into \e config if the //! asynchronous comparator output should be fed into an OR gate with the //! latched digital filter output before it is made available for CTRIPL or //! CTRIPOUTL. //! //! \return None. // //***************************************************************************** static inline void CMPSS_configLowComparator(uint32_t base, uint16_t config) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 376); } } while((_Bool)0); // // Write the low comparator configuration to the appropriate register. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) = ((*((volatile uint16_t *)(base + 0x0U))) & ~(0x100U | 0x200U | 0x4000U)) | (config << 8U); __edis(); } //***************************************************************************** // //! Sets the output signal configuration for the high comparator. //! //! \param base is the base address of the CMPSS module. //! \param config is the configuration of the high comparator output signals. //! //! This function configures a comparator's output signals CTRIP and CTRIPOUT. //! The \e config parameter is the result of a logical OR operation between the //! \b CMPSS_TRIPOUT_xxx and \b CMPSS_TRIP_xxx values. //! //! The \b CMPSS_TRIPOUT_xxx term can take on the following values to specify //! which signal drives CTRIPOUTH: //! - \b CMPSS_TRIPOUT_ASYNC_COMP - The asynchronous comparator output. //! - \b CMPSS_TRIPOUT_SYNC_COMP - The synchronous comparator output. //! - \b CMPSS_TRIPOUT_FILTER - The output of the digital filter. //! - \b CMPSS_TRIPOUT_LATCH - The latched output of the digital filter. //! //! The \b CMPSS_TRIP_xxx term can take on the following values to specify //! which signal drives CTRIPH: //! - \b CMPSS_TRIP_ASYNC_COMP - The asynchronous comparator output. //! - \b CMPSS_TRIP_SYNC_COMP - The synchronous comparator output. //! - \b CMPSS_TRIP_FILTER - The output of the digital filter. //! - \b CMPSS_TRIP_LATCH - The latched output of the digital filter. //! //! \return None. // //***************************************************************************** static inline void CMPSS_configOutputsHigh(uint32_t base, uint16_t config) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 423); } } while((_Bool)0); // // Write the high comparator output settings to the appropriate register. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) = ((*((volatile uint16_t *)(base + 0x0U))) & ~(0x30U | 0xCU)) | config; __edis(); } //***************************************************************************** // //! Sets the output signal configuration for the low comparator. //! //! \param base is the base address of the CMPSS module. //! \param config is the configuration of the low comparator output signals. //! //! This function configures a comparator's output signals CTRIP and CTRIPOUT. //! The \e config parameter is the result of a logical OR operation between the //! \b CMPSS_TRIPOUT_xxx and \b CMPSS_TRIP_xxx values. //! //! The \b CMPSS_TRIPOUT_xxx term can take on the following values to specify //! which signal drives CTRIPOUTL: //! - \b CMPSS_TRIPOUT_ASYNC_COMP - The asynchronous comparator output. //! - \b CMPSS_TRIPOUT_SYNC_COMP - The synchronous comparator output. //! - \b CMPSS_TRIPOUT_FILTER - The output of the digital filter. //! - \b CMPSS_TRIPOUT_LATCH - The latched output of the digital filter. //! //! The \b CMPSS_TRIP_xxx term can take on the following values to specify //! which signal drives CTRIPL: //! - \b CMPSS_TRIP_ASYNC_COMP - The asynchronous comparator output. //! - \b CMPSS_TRIP_SYNC_COMP - The synchronous comparator output. //! - \b CMPSS_TRIP_FILTER - The output of the digital filter. //! - \b CMPSS_TRIP_LATCH - The latched output of the digital filter. //! //! \return None. // //***************************************************************************** static inline void CMPSS_configOutputsLow(uint32_t base, uint16_t config) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 472); } } while((_Bool)0); // // Write the low comparator output settings to the appropriate register. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) = ((*((volatile uint16_t *)(base + 0x0U))) & ~(0x3000U | 0xC00U)) | (config << 8U); __edis(); } //***************************************************************************** // //! Gets the current comparator status. //! //! \param base is the base address of the comparator module. //! //! This function returns the current status for the comparator, specifically //! the digital filter output and latched digital filter output. //! //! \return Returns the current interrupt status, enumerated as a bit field of //! the following values: //! - \b CMPSS_STS_HI_FILTOUT - High digital filter output //! - \b CMPSS_STS_HI_LATCHFILTOUT - Latched value of high digital filter //! output //! - \b CMPSS_STS_LO_FILTOUT - Low digital filter output //! - \b CMPSS_STS_LO_LATCHFILTOUT - Latched value of low digital filter output // //***************************************************************************** static inline uint16_t CMPSS_getStatus(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 511); } } while((_Bool)0); // // Return contents of the status register. // return((*((volatile uint16_t *)(base + 0x2U)))); } //***************************************************************************** // //! Sets the configuration for the internal comparator DACs. //! //! \param base is the base address of the CMPSS module. //! \param config is the configuration of the internal DAC. //! //! This function configures the comparator's internal DAC. The \e config //! parameter is the result of a logical OR operation between the //! \b CMPSS_DACVAL_xxx, \b CMPSS_DACREF_xxx, and \b CMPSS_DACSRC_xxx. //! //! The \b CMPSS_DACVAL_xxx term can take on the following values to specify //! when the DAC value is loaded from its shadow register: //! - \b CMPSS_DACVAL_SYSCLK - Value register updated on system clock. //! - \b CMPSS_DACVAL_PWMSYNC - Value register updated on PWM sync. //! //! The \b CMPSS_DACREF_xxx term can take on the following values to specify //! which voltage supply is used as reference for the DACs: //! - \b CMPSS_DACREF_VDDA - VDDA is the voltage reference for the DAC. //! - \b CMPSS_DACREF_VDAC - VDAC is the voltage reference for the DAC. //! //! The \b CMPSS_DACSRC_xxx term can take on the following values to specify //! the DAC value source for the high comparator's internal DAC: //! - \b CMPSS_DACSRC_SHDW - The user-programmed DACVALS register. //! - \b CMPSS_DACSRC_RAMP - The ramp generator RAMPSTS register //! //! \note The \b CMPSS_DACVAL_xxx and \b CMPSS_DACREF_xxx terms apply to //! both the high and low comparators. \b CMPSS_DACSRC_xxx will only affect //! the high comparator's internal DAC. //! //! \return None. // //***************************************************************************** static inline void CMPSS_configDAC(uint32_t base, uint16_t config) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 558); } } while((_Bool)0); // // Write the DAC configuration to the appropriate register. // __eallow(); (*((volatile uint16_t *)(base + 0x4U))) = ((*((volatile uint16_t *)(base + 0x4U))) & ~(0x80U | 0x20U | 0x1U)) | config; __edis(); } //***************************************************************************** // //! Sets the value of the internal DAC of the high comparator. //! //! \param base is the base address of the comparator module. //! \param value is the value actively driven by the DAC. //! //! This function sets the 12-bit value driven by the internal DAC of the high //! comparator. This function will load the value into the shadow register from //! which the actual DAC value register will be loaded. To configure which //! event causes this shadow load to take place, use CMPSS_configDAC(). //! //! \return None. // //***************************************************************************** static inline void CMPSS_setDACValueHigh(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 593); } } while((_Bool)0); do { if(!(value < 4096U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 594); } } while((_Bool)0); // // Write the DAC value to the DAC value shadow register. // (*((volatile uint16_t *)(base + 0x6U))) = value; } //***************************************************************************** // //! Sets the value of the internal DAC of the low comparator. //! //! \param base is the base address of the comparator module. //! \param value is the value actively driven by the DAC. //! //! This function sets the 12-bit value driven by the internal DAC of the low //! comparator. This function will load the value into the shadow register from //! which the actual DAC value register will be loaded. To configure which //! event causes this shadow load to take place, use CMPSS_configDAC(). //! //! \return None. // //***************************************************************************** static inline void CMPSS_setDACValueLow(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 623); } } while((_Bool)0); do { if(!(value < 4096U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 624); } } while((_Bool)0); // // Write the DAC value to the DAC value shadow register. // (*((volatile uint16_t *)(base + 0x12U))) = value; } //***************************************************************************** // //! Initializes the digital filter of the high comparator. //! //! \param base is the base address of the comparator module. //! //! This function initializes all the samples in the high comparator digital //! filter to the filter input value. //! //! \note See CMPSS_configFilterHigh() for the proper initialization sequence //! to avoid glitches. //! //! \return None. // //***************************************************************************** static inline void CMPSS_initFilterHigh(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 653); } } while((_Bool)0); // // Set the high comparator filter initialization bit. // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Initializes the digital filter of the low comparator. //! //! \param base is the base address of the comparator module. //! //! This function initializes all the samples in the low comparator digital //! filter to the filter input value. //! //! \note See CMPSS_configFilterLow() for the proper initialization sequence //! to avoid glitches. //! //! \return None. // //***************************************************************************** static inline void CMPSS_initFilterLow(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 686); } } while((_Bool)0); // // Set the low comparator filter initialization bit. // __eallow(); (*((volatile uint16_t *)(base + 0x16U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Gets the value of the internal DAC of the high comparator. //! //! \param base is the base address of the comparator module. //! //! This function gets the value of the internal DAC of the high comparator. //! The value is read from the \e active register--not the shadow register to //! which CMPSS_setDACValueHigh() writes. //! //! \return Returns the value driven by the internal DAC of the high comparator. // //***************************************************************************** static inline uint16_t CMPSS_getDACValueHigh(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 717); } } while((_Bool)0); // // Write the DAC value to the DAC value shadow register. // return((*((volatile uint16_t *)(base + 0x7U)))); } //***************************************************************************** // //! Gets the value of the internal DAC of the low comparator. //! //! \param base is the base address of the comparator module. //! //! This function gets the value of the internal DAC of the low comparator. //! The value is read from the \e active register--not the shadow register to //! which CMPSS_setDACValueLow() writes. //! //! \return Returns the value driven by the internal DAC of the low comparator. // //***************************************************************************** static inline uint16_t CMPSS_getDACValueLow(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 744); } } while((_Bool)0); // // Write the DAC value to the DAC value shadow register. // return((*((volatile uint16_t *)(base + 0x13U)))); } //***************************************************************************** // //! Causes a software reset of the high comparator digital filter output latch. //! //! \param base is the base address of the comparator module. //! //! This function causes a software reset of the high comparator digital filter //! output latch. It will generate a single pulse of the latch reset signal. //! //! \return None. // //***************************************************************************** static inline void CMPSS_clearFilterLatchHigh(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 770); } } while((_Bool)0); // // Set the bit that generates a reset pulse to the digital filter latch. // __eallow(); (*((volatile uint16_t *)(base + 0x3U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Causes a software reset of the low comparator digital filter output latch. //! //! \param base is the base address of the comparator module. //! //! This function causes a software reset of the low comparator digital filter //! output latch. It will generate a single pulse of the latch reset signal. //! //! \return None. // //***************************************************************************** static inline void CMPSS_clearFilterLatchLow(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 800); } } while((_Bool)0); // // Set the bit that generates a reset pulse to the digital filter latch. // __eallow(); (*((volatile uint16_t *)(base + 0x3U))) |= 0x200U; __edis(); } //***************************************************************************** // //! Sets the ramp generator maximum reference value. //! //! \param base is the base address of the comparator module. //! \param value the ramp maximum reference value. //! //! This function sets the ramp maximum reference value that will be loaded //! into the ramp generator. //! //! \return None. // //***************************************************************************** static inline void CMPSS_setMaxRampValue(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 831); } } while((_Bool)0); // // Write the maximum ramp value to the shadow register. // (*((volatile uint16_t *)(base + 0xAU))) = value; } //***************************************************************************** // //! Gets the ramp generator maximum reference value. //! //! \param base is the base address of the comparator module. //! //! \return Returns the latched ramp maximum reference value that will be //! loaded into the ramp generator. // //***************************************************************************** static inline uint16_t CMPSS_getMaxRampValue(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 855); } } while((_Bool)0); // // Read the maximum ramp value from the register. // return((*((volatile uint16_t *)(base + 0x8U)))); } //***************************************************************************** // //! Sets the ramp generator decrement value. //! //! \param base is the base address of the comparator module. //! \param value is the ramp decrement value. //! //! This function sets the value that is subtracted from the ramp value on //! every system clock cycle. //! //! \return None. // //***************************************************************************** static inline void CMPSS_setRampDecValue(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 882); } } while((_Bool)0); // // Write the ramp decrement value to the shadow register. // (*((volatile uint16_t *)(base + 0xEU))) = value; } //***************************************************************************** // //! Gets the ramp generator decrement value. //! //! \param base is the base address of the comparator module. //! //! \return Returns the latched ramp decrement value that is subtracted from //! the ramp value on every system clock cycle. // //***************************************************************************** static inline uint16_t CMPSS_getRampDecValue(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 906); } } while((_Bool)0); // // Read the ramp decrement value from the register. // return((*((volatile uint16_t *)(base + 0xCU)))); } //***************************************************************************** // //! Sets the ramp generator delay value. //! //! \param base is the base address of the comparator module. //! \param value is the 13-bit ramp delay value. //! //! This function sets the value that configures the number of system clock //! cycles to delay the start of the ramp generator decrementer after a PWMSYNC //! event is received. Delay value can be no greater than 8191. //! //! \return None. // //***************************************************************************** static inline void CMPSS_setRampDelayValue(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 934); } } while((_Bool)0); do { if(!(value < 8192U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 935); } } while((_Bool)0); // // Write the ramp delay value to the shadow register. // (*((volatile uint16_t *)(base + 0x15U))) = value; } //***************************************************************************** // //! Gets the ramp generator delay value. //! //! \param base is the base address of the comparator module. //! //! \return Returns the latched ramp delay value that is subtracted from //! the ramp value on every system clock cycle. // //***************************************************************************** static inline uint16_t CMPSS_getRampDelayValue(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 959); } } while((_Bool)0); // // Read the ramp delay value from the register. // return((*((volatile uint16_t *)(base + 0x14U)))); } //***************************************************************************** // //! Configures sync source for comparator //! //! \param base is the base address of the comparator module. //! \param syncSource is the desired EPWMxSYNCPER source //! //! This function configures desired EPWMxSYNCPER source for comparator //! blocks. Configured EPWMxSYNCPER signal can be used to synchronize loading //! of DAC input value from shadow to active register. It can also be used to //! synchronize Ramp generator, if applicable. Refer to device manual to check //! if Ramp generator is available in the desired CMPSS instance. //! //! Valid values for \e syncSource parameter can be 1 to n, where n represents //! the maximum number of EPWMSYNCPER signals available on the device. For //! instance, passing 2 into \e syncSource will select EPWM2SYNCPER. //! //! \return None. // //***************************************************************************** static inline void CMPSS_configureSyncSource(uint32_t base, uint16_t syncSource) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 993); } } while((_Bool)0); // // Write the ramp delay value to the shadow register. // __eallow(); (*((volatile uint16_t *)(base + 0x4U))) = ((*((volatile uint16_t *)(base + 0x4U))) & ~0x1EU) | ((uint16_t)(syncSource - 1U) << 1U); __edis(); } //***************************************************************************** // //! Sets the comparator hysteresis settings. //! //! \param base is the base address of the comparator module. //! \param value is the amount of hysteresis on the comparator inputs. //! //! This function sets the amount of hysteresis on the comparator inputs. The //! \e value parameter indicates the amount of hysteresis desired. Passing in 0 //! results in none, passing in 1 results in typical hysteresis, passing in 2 //! results in 2x of typical hysteresis, and so on where \e value x of typical //! hysteresis is the amount configured. //! //! \return None. // //***************************************************************************** static inline void CMPSS_setHysteresis(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 1028); } } while((_Bool)0); do { if(!(value <= 4U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 1029); } } while((_Bool)0); // // Read the ramp delay value from the register. // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) = value; __edis(); } //***************************************************************************** // //! Enables reset of HIGH comparator digital filter output latch on PWMSYNC //! //! \param base is the base address of the comparator module. //! //! This function enables EPWMSYNCPER reset of High comparator digital filter //! output latch //! //! \return None. // //***************************************************************************** static inline void CMPSS_enableLatchResetOnPWMSYNCHigh(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 1059); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(base + 0x3U))) |= 0x4U; __edis(); } //***************************************************************************** // //! Disables reset of HIGH comparator digital filter output latch on PWMSYNC //! //! \param base is the base address of the comparator module. //! //! This function disables EPWMSYNCPER reset of High comparator digital filter //! output latch //! //! \return None. // //***************************************************************************** static inline void CMPSS_disableLatchResetOnPWMSYNCHigh(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 1086); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(base + 0x3U))) &= ~0x4U; __edis(); } //***************************************************************************** // //! Enables reset of LOW comparator digital filter output latch on PWMSYNC //! //! \param base is the base address of the comparator module. //! //! This function enables EPWMSYNCPER reset of Low comparator digital filter //! output latch //! //! \return None. // //***************************************************************************** static inline void CMPSS_enableLatchResetOnPWMSYNCLow(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 1113); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(base + 0x3U))) |= 0x400U; __edis(); } //***************************************************************************** // //! Disables reset of LOW comparator digital filter output latch on PWMSYNC //! //! \param base is the base address of the comparator module. //! //! This function disables EPWMSYNCPER reset of Low comparator digital filter //! output latch //! //! \return None. // //***************************************************************************** static inline void CMPSS_disableLatchResetOnPWMSYNCLow(uint32_t base) { // // Check the arguments. // do { if(!(CMPSS_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cmpss.h", 1140); } } while((_Bool)0); __eallow(); (*((volatile uint16_t *)(base + 0x3U))) &= ~0x400U; __edis(); } //***************************************************************************** // //! Configures the digital filter of the high comparator. //! //! \param base is the base address of the comparator module. //! \param samplePrescale is the number of system clock cycles between samples. //! \param sampleWindow is the number of FIFO samples to monitor. //! \param threshold is the majority threshold of samples to change state. //! //! This function configures the operation of the digital filter of the high //! comparator. //! //! The \e samplePrescale parameter specifies the number of system clock cycles //! not be passed as this parameter. The prescaler used by digital filter is 1 //! more than \e samplePrescale value. So, the input provided should be 1 less //! than the expected prescaler. //! //! The \e sampleWindow parameter configures the size of the window of FIFO //! samples taken from the input that will be monitored to determine when to //! change the filter output. This sample window may be no larger than 32 //! samples. //! //! The \e threshold parameter configures the threshold value to be used by //! the digital filter. //! //! The filter output resolves to the majority value of the sample window where //! majority is defined by the value passed into the \e threshold parameter. //! For proper operation, the value of \e threshold must be greater than //! sampleWindow / 2. //! //! To ensure proper operation of the filter, the following is the recommended //! function call sequence for initialization: //! //! -# Configure and enable the comparator using CMPSS_configHighComparator() //! and CMPSS_enableModule() //! -# Configure the digital filter using CMPSS_configFilterHigh() //! -# Initialize the sample values using CMPSS_initFilterHigh() //! -# Configure the module output signals CTRIP and CTRIPOUT using //! CMPSS_configOutputsHigh() //! //! \return None. // //***************************************************************************** extern void CMPSS_configFilterHigh(uint32_t base, uint16_t samplePrescale, uint16_t sampleWindow, uint16_t threshold); //***************************************************************************** // //! Configures the digital filter of the low comparator. //! //! \param base is the base address of the comparator module. //! \param samplePrescale is the number of system clock cycles between samples. //! \param sampleWindow is the number of FIFO samples to monitor. //! \param threshold is the majority threshold of samples to change state. //! //! This function configures the operation of the digital filter of the low //! comparator. //! //! The \e samplePrescale parameter specifies the number of system clock cycles //! not be passed as this parameter. The prescaler used by digital filter is 1 //! more than \e samplePrescale value. So, the input provided should be 1 less //! than the expected prescaler. //! //! The \e sampleWindow parameter configures the size of the window of FIFO //! samples taken from the input that will be monitored to determine when to //! change the filter output. This sample window may be no larger than 32 //! samples. //! //! The \e threshold parameter configures the threshold value to be used by //! the digital filter. //! //! The filter output resolves to the majority value of the sample window where //! majority is defined by the value passed into the \e threshold parameter. //! For proper operation, the value of \e threshold must be greater than //! sampleWindow / 2. //! //! To ensure proper operation of the filter, the following is the recommended //! function call sequence for initialization: //! //! -# Configure and enable the comparator using CMPSS_configLowComparator() //! and CMPSS_enableModule() //! -# Configure the digital filter using CMPSS_configFilterLow() //! -# Initialize the sample values using CMPSS_initFilterLow() //! -# Configure the module output signals CTRIP and CTRIPOUT using //! CMPSS_configOutputsLow() //! //! \return None. // //***************************************************************************** extern void CMPSS_configFilterLow(uint32_t base, uint16_t samplePrescale, uint16_t sampleWindow, uint16_t threshold); //***************************************************************************** // //! Configures whether or not the digital filter latches are reset by PWMSYNC //! //! \param base is the base address of the comparator module. //! \param highEnable indicates filter latch settings in the high comparator. //! \param lowEnable indicates filter latch settings in the low comparator. //! //! This function configures whether or not the digital filter latches in both //! the high and low comparators should be reset by PWMSYNC. If the //! \e highEnable parameter is \b true, the PWMSYNC will be allowed to reset //! the high comparator's digital filter latch. If it is false, the ability of //! the PWMSYNC to reset the latch will be disabled. The \e lowEnable parameter //! has the same effect on the low comparator's digital filter latch. //! //! \return None. // //***************************************************************************** extern void CMPSS_configLatchOnPWMSYNC(uint32_t base, _Bool highEnable, _Bool lowEnable); //***************************************************************************** // //! Configures the comparator subsystem's ramp generator. //! //! \param base is the base address of the comparator module. //! \param maxRampVal is the ramp maximum reference value. //! \param decrementVal value is the ramp decrement value. //! \param delayVal is the ramp delay value. //! \param pwmSyncSrc is the number of the PWMSYNC source. //! \param useRampValShdw indicates if the max ramp shadow should be used. //! //! This function configures many of the main settings of the comparator //! subsystem's ramp generator. The \e maxRampVal parameter should be passed //! the ramp maximum reference value that will be loaded into the ramp //! generator. The \e decrementVal parameter should be passed the decrement //! value that will be subtracted from the ramp generator on each system clock //! cycle. The \e delayVal parameter should be passed the 13-bit number of //! system clock cycles the ramp generator should delay before beginning to //! decrement the ramp generator after a PWMSYNC signal is received. //! //! These three values may be be set individually using the //! CMPSS_setMaxRampValue(), CMPSS_setRampDecValue(), and //! CMPSS_setRampDelayValue() APIs. //! //! The number of the PWMSYNC signal to be used to reset the ramp generator //! should be specified by passing it into the \e pwmSyncSrc parameter. For //! instance, passing a CMPSS_PWMSYNCx into \e pwmSyncSrc will select PWMSYNCx. //! //! To indicate whether the ramp generator should reset with the value from the //! ramp max reference value shadow register or with the latched ramp max //! reference value, use the \e useRampValShdw parameter. Passing it \b true //! will result in the latched value being bypassed. The ramp generator will be //! loaded right from the shadow register. A value of \b false will load the //! ramp generator from the latched value. //! //! \return None. // //***************************************************************************** extern void CMPSS_configRamp(uint32_t base, uint16_t maxRampVal, uint16_t decrementVal, uint16_t delayVal, uint16_t pwmSyncSrc, _Bool useRampValShdw); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //############################################################################# // // FILE: cputimer.h // // TITLE: C28x CPU timer Driver // //############################################################################# // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //############################################################################# //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup cputimer_api CPUTimer //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_cputimer.h // // TITLE: Definitions for the CPUTIMER registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the CPUTIMER register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TIM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PRD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TPR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TPRH register // //************************************************************************************************* //***************************************************************************** // // Defines for the API. // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to CPUTimer_setEmulationMode() as the //! \e mode parameter. // //**************************************************************************** typedef enum { //! Denotes that the timer will stop after the next decrement CPUTIMER_EMULATIONMODE_STOPAFTERNEXTDECREMENT = 0x0000, //! Denotes that the timer will stop when it reaches zero CPUTIMER_EMULATIONMODE_STOPATZERO = 0x0400, //! Denotes that the timer will run free CPUTIMER_EMULATIONMODE_RUNFREE = 0x0800 }CPUTimer_EmulationMode; //***************************************************************************** // //! The following are values that can be passed to //! CPUTimer_selectClockSource() as the \e source parameter. // //***************************************************************************** typedef enum { //! System Clock Source CPUTIMER_CLOCK_SOURCE_SYS = 0x0, //! Internal Oscillator 1 Clock Source CPUTIMER_CLOCK_SOURCE_INTOSC1 = 0x1, //! Internal Oscillator 2 Clock Source CPUTIMER_CLOCK_SOURCE_INTOSC2 = 0x2, //! External Clock Source CPUTIMER_CLOCK_SOURCE_XTAL = 0x3, //! Auxiliary PLL Clock Source CPUTIMER_CLOCK_SOURCE_AUX = 0x6 } CPUTimer_ClockSource; //***************************************************************************** // //! The following are values that can be passed to //! CPUTimer_selectClockSource() as the \e prescaler parameter. // //***************************************************************************** typedef enum { CPUTIMER_CLOCK_PRESCALER_1 = 0, //!< Prescaler value of / 1 CPUTIMER_CLOCK_PRESCALER_2 = 1, //!< Prescaler value of / 2 CPUTIMER_CLOCK_PRESCALER_4 = 2, //!< Prescaler value of / 4 CPUTIMER_CLOCK_PRESCALER_8 = 3, //!< Prescaler value of / 8 CPUTIMER_CLOCK_PRESCALER_16 = 4 //!< Prescaler value of / 16 } CPUTimer_Prescaler; //***************************************************************************** // //! \internal //! Checks CPU timer base address. //! //! \param base specifies the Timer module base address. //! //! This function determines if a CPU timer module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool CPUTimer_isBaseValid(uint32_t base) { return((base == 0x00000C00U) || (base == 0x00000C08U) || (base == 0x00000C10U)); } //***************************************************************************** // //! Clears CPU timer overflow flag. //! //! \param base is the base address of the timer module. //! //! This function clears the CPU timer overflow flag. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_clearOverflowFlag(uint32_t base) { do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 162); } } while((_Bool)0); // // Set TIF bit of TCR register // (*((volatile uint16_t *)(base + 0x4U))) |= 0x8000U; } //***************************************************************************** // //! Disables CPU timer interrupt. //! //! \param base is the base address of the timer module. //! //! This function disables the CPU timer interrupt. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_disableInterrupt(uint32_t base) { do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 183); } } while((_Bool)0); // // Clear TIE bit of TCR register // (*((volatile uint16_t *)(base + 0x4U))) &= ~0x4000U; } //***************************************************************************** // //! Enables CPU timer interrupt. //! //! \param base is the base address of the timer module. //! //! This function enables the CPU timer interrupt. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_enableInterrupt(uint32_t base) { uint16_t tcrValue = 0; do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 205); } } while((_Bool)0); // // Set TIE bit of TCR register // tcrValue = (*((volatile uint16_t *)(base + 0x4U))) & (~0x8000U); (*((volatile uint16_t *)(base + 0x4U))) = tcrValue | 0x4000U; } //***************************************************************************** // //! Reloads CPU timer counter. //! //! \param base is the base address of the timer module. //! //! This function reloads the CPU timer counter with the values contained in //! the CPU timer period register. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_reloadTimerCounter(uint32_t base) { uint16_t tcrValue = 0; do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 229); } } while((_Bool)0); // // Set TRB bit of register TCR // tcrValue = (*((volatile uint16_t *)(base + 0x4U))) & (~0x8000U); (*((volatile uint16_t *)(base + 0x4U))) = tcrValue | 0x20U; } //***************************************************************************** // //! Stops CPU timer. //! //! \param base is the base address of the timer module. //! //! This function stops the CPU timer. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_stopTimer(uint32_t base) { uint16_t tcrValue = 0; do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 252); } } while((_Bool)0); // // Set TSS bit of register TCR // tcrValue = (*((volatile uint16_t *)(base + 0x4U))) & (~0x8000U); (*((volatile uint16_t *)(base + 0x4U))) = tcrValue | 0x10U; } //***************************************************************************** // //! Starts(restarts) CPU timer. //! //! \param base is the base address of the timer module. //! //! This function starts (restarts) the CPU timer. //! //! \b Note: This function doesn't reset the timer counter. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_resumeTimer(uint32_t base) { do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 276); } } while((_Bool)0); // // Clear TSS bit of register TCR // (*((volatile uint16_t *)(base + 0x4U))) &= ~0x10U; } //***************************************************************************** // //! Starts(restarts) CPU timer. //! //! \param base is the base address of the timer module. //! //! This function starts (restarts) the CPU timer. //! //! \b Note: This function reloads the timer counter. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_startTimer(uint32_t base) { uint16_t tcrValue = 0; do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 300); } } while((_Bool)0); // // Reload the timer counter // tcrValue = (*((volatile uint16_t *)(base + 0x4U))) & (~0x8000U); (*((volatile uint16_t *)(base + 0x4U))) = tcrValue | 0x20U; // // Clear TSS bit of register TCR // (*((volatile uint16_t *)(base + 0x4U))) &= ~0x10U; } //***************************************************************************** // //! Sets CPU timer period. //! //! \param base is the base address of the timer module. //! \param periodCount is the CPU timer period count. //! //! This function sets the CPU timer period count. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_setPeriod(uint32_t base, uint32_t periodCount) { do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 328); } } while((_Bool)0); // // Load the MSB period Count // (*((volatile uint32_t *)(base + 0x2U))) = periodCount; } //***************************************************************************** // //! Returns the current CPU timer counter value. //! //! \param base is the base address of the timer module. //! //! This function returns the current CPU timer counter value. //! //! \return Returns the current CPU timer count value. // //***************************************************************************** static inline uint32_t CPUTimer_getTimerCount(uint32_t base) { do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 349); } } while((_Bool)0); // // Get the TIMH:TIM registers value // return((*((volatile uint32_t *)(base + 0x0U)))); } //***************************************************************************** // //! Set CPU timer pre-scaler value. //! //! \param base is the base address of the timer module. //! \param prescaler is the CPU timer pre-scaler value. //! //! This function sets the pre-scaler value for the CPU timer. For every value //! of (prescaler + 1), the CPU timer counter decrements by 1. //! //! \return None. // //***************************************************************************** static inline void CPUTimer_setPreScaler(uint32_t base, uint16_t prescaler) { do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 372); } } while((_Bool)0); // // Writes to TPR.TDDR and TPRH.TDDRH bits // (*((volatile uint16_t *)(base + 0x7U))) = prescaler >> 8U; (*((volatile uint16_t *)(base + 0x6U))) = (prescaler & 0xFFU) ; } //***************************************************************************** // //! Return the CPU timer overflow status. //! //! \param base is the base address of the timer module. //! //! This function returns the CPU timer overflow status. //! //! \return Returns true if the CPU timer has overflowed, false if not. // //***************************************************************************** static inline _Bool CPUTimer_getTimerOverflowStatus(uint32_t base) { do { if(!(CPUTimer_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 394); } } while((_Bool)0); // // Check if TIF bits of register TCR are set // return((((*((volatile uint16_t *)(base + 0x4U))) & 0x8000U) == 0x8000U) ? 1 : 0); } //***************************************************************************** // //! Select CPU Timer 2 Clock Source and Prescaler //! //! \param base is the base address of the timer module. //! \param source is the clock source to use for CPU Timer 2 //! \param prescaler is the value that configures the selected clock source //! relative to the system clock //! //! This function selects the specified clock source and prescaler value //! for the CPU timer (CPU timer 2 only). //! //! The \e source parameter can be any one of the following: //! - \b CPUTIMER_CLOCK_SOURCE_SYS - System Clock //! - \b CPUTIMER_CLOCK_SOURCE_INTOSC1 - Internal Oscillator 1 Clock //! - \b CPUTIMER_CLOCK_SOURCE_INTOSC2 - Internal Oscillator 2 Clock //! - \b CPUTIMER_CLOCK_SOURCE_XTAL - External Clock //! - \b CPUTIMER_CLOCK_SOURCE_AUX - Auxiliary PLL Clock //! //! The \e prescaler parameter can be any one of the following: //! - \b CPUTIMER_CLOCK_PRESCALER_1 - Prescaler value of / 1 //! - \b CPUTIMER_CLOCK_PRESCALER_2 - Prescaler value of / 2 //! - \b CPUTIMER_CLOCK_PRESCALER_4 - Prescaler value of / 4 //! - \b CPUTIMER_CLOCK_PRESCALER_8 - Prescaler value of / 8 //! - \b CPUTIMER_CLOCK_PRESCALER_16 - Prescaler value of / 16 //! //! \return None. // //***************************************************************************** static inline void CPUTimer_selectClockSource(uint32_t base, CPUTimer_ClockSource source, CPUTimer_Prescaler prescaler) { do { if(!(base == 0x00000C10U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/cputimer.h", 436); } } while((_Bool)0); // // Set source and prescaler for CPU Timer 2 // if(base == 0x00000C10U) { __eallow(); // // Set Clock Source // (*((volatile uint16_t *)(0x0005D300U + 0x7CU))) = ((*((volatile uint16_t *)(0x0005D300U + 0x7CU))) & ~0x7U) | (uint16_t)source; asm(" RPT #69 || NOP"); // // Set Clock Prescaler // (*((volatile uint16_t *)(0x0005D300U + 0x7CU))) = ((*((volatile uint16_t *)(0x0005D300U + 0x7CU))) & ~0x38U) | ((uint16_t)prescaler <<3U); __edis(); } asm(" RPT #69 || NOP"); } //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! Sets Emulation mode for CPU timer. //! //! \param base is the base address of the timer module. //! \param mode is the emulation mode of the timer. //! //! This function sets the behaviour of CPU timer during emulation. Valid //! values mode are: CPUTIMER_EMULATIONMODE_STOPAFTERNEXTDECREMENT, //! CPUTIMER_EMULATIONMODE_STOPATZERO and CPUTIMER_EMULATIONMODE_RUNFREE. //! //! \return None. // //***************************************************************************** extern void CPUTimer_setEmulationMode(uint32_t base, CPUTimer_EmulationMode mode); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: dac.h // // TITLE: C28x DAC driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup dac_api DAC //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_dac.h // // TITLE: Definitions for the DAC registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the DAC register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACREV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACVALA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACVALS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACOUTEN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DACTRIM register // //************************************************************************************************* // // A 8-bit register mask // // // Lock Key // //***************************************************************************** // // The following are defines for the reg parameter of the // DAC_lockRegister() and DAC_isRegisterLocked() functions. // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to DAC_setReferenceVoltage() as the \e source //! parameter. // //***************************************************************************** typedef enum { DAC_REF_VDAC = 0, //!< VDAC reference voltage DAC_REF_ADC_VREFHI = 1 //!< ADC VREFHI reference voltage }DAC_ReferenceVoltage; //***************************************************************************** // //! Values that can be passed to DAC_setLoadMode() as the \e mode parameter. // //***************************************************************************** typedef enum { DAC_LOAD_SYSCLK = 0, //!< Load on next SYSCLK DAC_LOAD_PWMSYNC = 4 //!< Load on next PWMSYNC specified by SYNCSEL }DAC_LoadMode; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks DAC base address. //! //! \param base specifies the DAC module base address. //! //! This function determines if an DAC module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool DAC_isBaseValid(uint32_t base) { return( (base == 0x00005C00U) || (base == 0x00005C10U) || (base == 0x00005C20U) ); } //***************************************************************************** // //! Get the DAC Revision value //! //! \param base is the DAC module base address //! //! This function gets the DAC revision value. //! //! \return Returns the DAC revision value. // //***************************************************************************** static inline uint16_t DAC_getRevision(uint32_t base) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 163); } } while((_Bool)0); // // Get the revision value. // return((*((volatile uint16_t *)(base + 0x0U))) & 0xFFU); } //***************************************************************************** // //! Sets the DAC Reference Voltage //! //! \param base is the DAC module base address //! \param source is the selected reference voltage //! //! This function sets the DAC reference voltage. //! //! The \e source parameter can have the following value: //! - \b DAC_REF_VDAC - The VDAC reference voltage //! - \b DAC_REF_ADC_VREFHI - The ADC VREFHI reference voltage //! //! \return None. // //***************************************************************************** static inline void DAC_setReferenceVoltage(uint32_t base, DAC_ReferenceVoltage source) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 193); } } while((_Bool)0); // // Set the reference voltage // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) = ((*((volatile uint16_t *)(base + 0x1U))) & ~0x1U) | (uint16_t)source; __edis(); } //***************************************************************************** // //! Sets the DAC Load Mode //! //! \param base is the DAC module base address //! \param mode is the selected load mode //! //! This function sets the DAC load mode. //! //! The \e mode parameter can have one of two values: //! - \b DAC_LOAD_SYSCLK - Load on next SYSCLK //! - \b DAC_LOAD_PWMSYNC - Load on next PWMSYNC specified by SYNCSEL //! //! \return None. // //***************************************************************************** static inline void DAC_setLoadMode(uint32_t base, DAC_LoadMode mode) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 228); } } while((_Bool)0); // // Set the load mode // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) = ((*((volatile uint16_t *)(base + 0x1U))) & ~0x4U) | (uint16_t)mode; __edis(); } //***************************************************************************** // //! Sets the DAC PWMSYNC Signal //! //! \param base is the DAC module base address //! \param signal is the selected PWM signal //! //! This function sets the DAC PWMSYNC signal. //! //! The \e signal parameter must be set to a number that represents the PWM //! signal that will be set. For instance, passing 2 into \e signal will //! select PWM sync signal 2. //! //! \return None. // //***************************************************************************** static inline void DAC_setPWMSyncSignal(uint32_t base, uint16_t pwmSignal) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 263); } } while((_Bool)0); do { if(!((pwmSignal > 0U) && (pwmSignal < 17U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 264); } } while((_Bool)0); // // Set the PWM sync signal // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) = ((*((volatile uint16_t *)(base + 0x1U))) & ~0xF0U) | ((uint16_t)(pwmSignal - 1U) << 4U); __edis(); } //***************************************************************************** // //! Get the DAC Active Output Value //! //! \param base is the DAC module base address //! //! This function gets the DAC active output value. //! //! \return Returns the DAC active output value. // //***************************************************************************** static inline uint16_t DAC_getActiveValue(uint32_t base) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 296); } } while((_Bool)0); // // Get the active value // return((*((volatile uint16_t *)(base + 0x2U))) & 0xFFFU); } //***************************************************************************** // //! Set the DAC Shadow Output Value //! //! \param base is the DAC module base address //! \param value is the 12-bit code to be loaded into the active value register //! //! This function sets the DAC shadow output value. //! //! \return None. // //***************************************************************************** static inline void DAC_setShadowValue(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 322); } } while((_Bool)0); do { if(!(value <= 0xFFFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 323); } } while((_Bool)0); // // Set the shadow value // (*((volatile uint16_t *)(base + 0x3U))) = ((*((volatile uint16_t *)(base + 0x3U))) & ~0xFFFU) | (uint16_t)(value & 0xFFFU); } //***************************************************************************** // //! Get the DAC Shadow Output Value //! //! \param base is the DAC module base address //! //! This function gets the DAC shadow output value. //! //! \return Returns the DAC shadow output value. // //***************************************************************************** static inline uint16_t DAC_getShadowValue(uint32_t base) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 350); } } while((_Bool)0); // // Get the shadow value // return((*((volatile uint16_t *)(base + 0x3U))) & 0xFFFU); } //***************************************************************************** // //! Enable the DAC Output //! //! \param base is the DAC module base address //! //! This function enables the DAC output. //! //! \note A delay is required after enabling the DAC. Further details //! regarding the exact delay time length can be found in the device datasheet. //! //! \return None. // //***************************************************************************** static inline void DAC_enableOutput(uint32_t base) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 378); } } while((_Bool)0); // // Enable the output // __eallow(); (*((volatile uint16_t *)(base + 0x4U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disable the DAC Output //! //! \param base is the DAC module base address //! //! This function disables the DAC output. //! //! \return None. // //***************************************************************************** static inline void DAC_disableOutput(uint32_t base) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 407); } } while((_Bool)0); // // Disable the output // __eallow(); (*((volatile uint16_t *)(base + 0x4U))) &= ~0x1U; __edis(); } //***************************************************************************** // //! Set DAC Offset Trim //! //! \param base is the DAC module base address //! \param offset is the specified value for the offset trim //! //! This function sets the DAC offset trim. The \e offset value should be a //! signed number in the range of -128 to 127. //! //! \note The offset should not be modified unless specifically indicated by //! TI Errata or other documentation. Modifying the offset value could cause //! this module to operate outside of the datasheet specifications. //! //! \return None. // //***************************************************************************** static inline void DAC_setOffsetTrim(uint32_t base, int16_t offset) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 442); } } while((_Bool)0); do { if(!((offset > -129) && (offset < 128))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 443); } } while((_Bool)0); // // Set the offset trim value // __eallow(); (*((volatile uint16_t *)(base + 0x6U))) = ((*((volatile uint16_t *)(base + 0x6U))) & ~0xFFU) | (int16_t)offset; __edis(); } //***************************************************************************** // //! Get DAC Offset Trim //! //! \param base is the DAC module base address //! //! This function gets the DAC offset trim value. //! //! \return None. // //***************************************************************************** static inline int16_t DAC_getOffsetTrim(uint32_t base) { uint16_t value; // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 475); } } while((_Bool)0); // // Get the sign-extended offset trim value // value = ((*((volatile uint16_t *)(base + 0x6U))) & 0xFFU); value = ((value & (uint16_t)(0xFFU)) ^ (uint16_t)0x80) - (uint16_t)0x80; return((int16_t)value); } //***************************************************************************** // //! Lock write-access to DAC Register //! //! \param base is the DAC module base address //! \param reg is the selected DAC registers //! //! This function locks the write-access to the specified DAC register. Only a //! system reset can unlock the register once locked. //! //! The \e reg parameter can be an ORed combination of any of the following //! values: //! - \b DAC_LOCK_CONTROL - Lock the DAC control register //! - \b DAC_LOCK_SHADOW - Lock the DAC shadow value register //! - \b DAC_LOCK_OUTPUT - Lock the DAC output enable/disable register //! //! \return None. // //***************************************************************************** static inline void DAC_lockRegister(uint32_t base, uint16_t reg) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 512); } } while((_Bool)0); do { if(!((reg & ~((0x1U) | (0x2U) | (0x4U))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 514); } } while((_Bool)0); // // Lock the specified registers // __eallow(); (*((volatile uint16_t *)(base + 0x5U))) |= ((0xA000U) | reg); __edis(); } //***************************************************************************** // //! Check if DAC Register is locked //! //! \param base is the DAC module base address //! \param reg is the selected DAC register locks to check //! //! This function checks if write-access has been locked on the specified DAC //! register. //! //! The \e reg parameter can be an ORed combination of any of the following //! values: //! - \b DAC_LOCK_CONTROL - Lock the DAC control register //! - \b DAC_LOCK_SHADOW - Lock the DAC shadow value register //! - \b DAC_LOCK_OUTPUT - Lock the DAC output enable/disable register //! //! \return Returns \b true if any of the registers specified are locked, and //! \b false if all specified registers aren't locked. // //***************************************************************************** static inline _Bool DAC_isRegisterLocked(uint32_t base, uint16_t reg) { // // Check the arguments. // do { if(!(DAC_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 552); } } while((_Bool)0); do { if(!((reg & ~((0x1U) | (0x2U) | (0x4U))) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dac.h", 554); } } while((_Bool)0); // // Return the lock status on the specified registers // return((_Bool)(((*((volatile uint16_t *)(base + 0x5U))) & reg) != 0U)); } //***************************************************************************** // //! Tune DAC Offset Trim //! //! \param base is the DAC module base address //! \param referenceVoltage is the reference voltage the DAC //! module is operating at. //! //! This function adjusts/tunes the DAC offset trim. The \e referenceVoltage //! value should be a floating point number in the range specified in the //! device data manual. //! //! \note Use this function to adjust the DAC offset trim if operating //! at a reference voltage other than 2.5v. Since this function modifies //! the DAC offset trim register, it should only be called once after //! Device_cal. If it is called multiple times after Device_cal, the offset //! value scaled would be the wrong value. //! //! \return None. // //***************************************************************************** extern void DAC_tuneOffsetTrim(uint32_t base, float32_t referenceVoltage); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //############################################################################# // // FILE: dcsm.h // // TITLE: C28x Driver for the DCSM security module. // //############################################################################# // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //############################################################################# //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup dcsm_api DCSM //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_dcsm.h // // TITLE: Definitions for the DCSM registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the DCSM register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_LINKPOINTER register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_OTPSECLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_BOOTCTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_GRABSECTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_GRABRAMR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_EXEONLYSECTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z1_EXEONLYRAMR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_LINKPOINTER register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_OTPSECLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_BOOTCTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_GRABSECTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_GRABRAMR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_EXEONLYSECTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the Z2_EXEONLYRAMR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FLSEM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SECTSTAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RAMSTAT register // //************************************************************************************************* //***************************************************************************** // // Defines for the unlockZone1CSM() and unlockZone2CSM(). // These are not parameters for any function. // These are not intended for application code. // //***************************************************************************** //***************************************************************************** // // Register key defines. // //***************************************************************************** //***************************************************************************** // //! Data structures to hold password keys. // //***************************************************************************** typedef struct { uint32_t csmKey0; uint32_t csmKey1; uint32_t csmKey2; uint32_t csmKey3; } DCSM_CSMPasswordKey; //***************************************************************************** // //! Values to distinguish the status of RAM or FLASH sectors. These values //! describe which zone the memory location belongs too. //! These values can be returned from DCSM_getRAMZone(), //! DCSM_getFlashSectorZone(). // //***************************************************************************** typedef enum { DCSM_MEMORY_INACCESSIBLE, //!< Inaccessible DCSM_MEMORY_ZONE1, //!< Zone 1 DCSM_MEMORY_ZONE2, //!< Zone 2 DCSM_MEMORY_FULL_ACCESS //!< Full access } DCSM_MemoryStatus; //***************************************************************************** // //! Values to pass to DCSM_claimZoneSemaphore(). These values are used //! to describe the zone that can write to Flash Wrapper registers. // //***************************************************************************** typedef enum { DCSM_FLSEM_ZONE1 = 0x01U, //!< Flash semaphore Zone 1 DCSM_FLSEM_ZONE2 = 0x02U //!< Flash semaphore Zone 2 } DCSM_SemaphoreZone; //***************************************************************************** // //! Values to distinguish the security status of the zones. //! These values can be returned from DCSM_getZone1CSMSecurityStatus(), //! DCSM_getZone2CSMSecurityStatus(). // //***************************************************************************** typedef enum { DCSM_STATUS_SECURE, //!< Secure DCSM_STATUS_UNSECURE, //!< Unsecure DCSM_STATUS_LOCKED, //!< Locked } DCSM_SecurityStatus; //***************************************************************************** // // Values to distinguish the status of the Control Registers. These values // describe can be used with the return values of // DCSM_getZone1ControlStatus(), and DCSM_getZone2ControlStatus(). // //***************************************************************************** //***************************************************************************** // //! Values to decribe the EXEONLY Status. //! These values are returned from to DCSM_getZone1RAMEXEStatus(), //! DCSM_getZone2RAMEXEStatus(), DCSM_getZone1FlashEXEStatus(), //! DCSM_getZone2FlashEXEStatus(). // //***************************************************************************** typedef enum { DCSM_PROTECTED, //!< Protected DCSM_UNPROTECTED, //!< Unprotected DCSM_INCORRECT_ZONE //!< Incorrect Zone }DCSM_EXEOnlyStatus; //***************************************************************************** // //! Values to distinguish RAM Module. //! These values can be passed to DCSM_getZone1RAMEXEStatus() //! DCSM_getZone2RAMEXEStatus(), DCSM_getRAMZone(). // //***************************************************************************** typedef enum { // //C28x RAMs // DCSM_RAMLS0, //!< RAMLS0 DCSM_RAMLS1, //!< RAMLS1 DCSM_RAMLS2, //!< RAMLS2 DCSM_RAMLS3, //!< RAMLS3 DCSM_RAMLS4, //!< RAMLS4 DCSM_RAMLS5, //!< RAMLS5 DCSM_RAMD0, //!< RAMD0 DCSM_RAMD1, //!< RAMD1 DCSM_CLA = 14U //!> shift) & 0x03U); return((DCSM_MemoryStatus)ramStatus); } //***************************************************************************** // //! Returns the security zone a flash sector belongs to //! //! \param sector is the flash sector value. Use DCSM_Sector type. //! //! This function returns the security zone a flash sector belongs to. //! //! \return Returns DCSM_MEMORY_INACCESSIBLE if the section is inaccessible , //! DCSM_MEMORY_ZONE1 if the section belongs to zone 1, DCSM_MEMORY_ZONE2 if //! the section belongs to zone 2 and DCSM_MEMORY_FULL_ACCESS if the section //! doesn't belong to any zone (or if the section is unsecure).. // //***************************************************************************** static inline DCSM_MemoryStatus DCSM_getFlashSectorZone(DCSM_Sector sector) { uint32_t sectStat; uint16_t shift; // // Get the Sector status register for the specific bank // sectStat = (*((volatile uint32_t *)(0x0005F070U + 0x2U))); shift = (uint16_t)sector * 2U; // //Read the SECTSTAT register for the specific Flash Sector. // return((DCSM_MemoryStatus)((uint16_t)((sectStat >> shift) & 0x3U))); } //***************************************************************************** // //! Read Zone 1 Link Pointer Error //! //! A non-zero value indicates an error on the bit position that is set to 1. //! //! \return Returns the value of the Zone 1 Link Pointer error. // //***************************************************************************** static inline uint32_t DCSM_getZone1LinkPointerError(void) { // // Return the LinkPointer Error for specific bank // return((*((volatile uint32_t *)(0x0005F000U + 0x6U)))); } //***************************************************************************** // //! Read Zone 2 Link Pointer Error //! //! A non-zero value indicates an error on the bit position that is set to 1. //! //! \return Returns the value of the Zone 2 Link Pointer error. // //***************************************************************************** static inline uint32_t DCSM_getZone2LinkPointerError(void) { // // Return the LinkPointer Error for specific bank // return((*((volatile uint32_t *)(0x0005F040U + 0x6U)))); } //***************************************************************************** // //! Unlocks Zone 1 CSM. //! //! \param psCMDKey is a pointer to the DCSM_CSMPasswordKey struct that has the //! CSM password for zone 1. //! //! This function unlocks the CSM password. It first reads the //! four password locations in the User OTP. If any of the password values is //! different from 0xFFFFFFFF, it unlocks the device by writing the provided //! passwords into CSM Key registers //! //! \return None. //! //! \note This function should not be called in an actual application, //! should only be used for once to program the OTP memory. Ensure flash data //! cache is disabled before calling this function(Flash_disableCache). // //***************************************************************************** extern void DCSM_unlockZone1CSM(const DCSM_CSMPasswordKey * const psCMDKey); //***************************************************************************** // //! Unlocks Zone 2 CSM. //! //! \param psCMDKey is a pointer to the CSMPSWDKEY that has the CSM //! password for zone 2. //! //! This function unlocks the CSM password. It first reads //! the four password locations in the User OTP. If any of the password values //! is different from 0xFFFFFFFF, it unlocks the device by writing the //! provided passwords into CSM Key registers //! //! \return None. //! //! \note This function should not be called in an actual application, //! should only be used for once to program the OTP memory. Ensure flash data //! cache is disabled before calling this function(Flash_disableCache). // //***************************************************************************** extern void DCSM_unlockZone2CSM(const DCSM_CSMPasswordKey * const psCMDKey); //***************************************************************************** // //! Returns the EXE-ONLY status of zone 1 for a flash sector //! //! \param sector is the flash sector value. Use DCSM_Sector type. //! //! This function takes in a valid sector value and returns the status of EXE //! ONLY security protection for the sector. //! //! \return Returns DCSM_PROTECTED if the sector is EXE-ONLY protected, //! DCSM_UNPROTECTED if the sector is not EXE-ONLY protected, //! DCSM_INCORRECT_ZONE if sector does not belong to this zone. // //***************************************************************************** extern DCSM_EXEOnlyStatus DCSM_getZone1FlashEXEStatus(DCSM_Sector sector); //***************************************************************************** // //! Returns the EXE-ONLY status of zone 1 for a RAM module //! //! \param module is the RAM module value. Valid values are type DCSM_RAMModule //! C28x RAMs : //! - \b DCSM_RAMLS0 //! - \b DCSM_RAMLS1 //! - \b DCSM_RAMLS2 //! - \b DCSM_RAMLS3 //! - \b DCSM_RAMLS4 //! - \b DCSM_RAMLS5 //! - \b DCSM_RAMD0 //! - \b DCSM_RAMD1 //! //! This function takes in a valid module value and returns the status of EXE //! ONLY security protection for that module. DCSM_CLA is an invalid module //! value. There is no EXE-ONLY available for DCSM_CLA. //! //! \return Returns DCSM_PROTECTED if the module is EXE-ONLY protected, //! DCSM_UNPROTECTED if the module is not EXE-ONLY protected, //! DCSM_INCORRECT_ZONE if module does not belong to this zone. // //***************************************************************************** extern DCSM_EXEOnlyStatus DCSM_getZone1RAMEXEStatus(DCSM_RAMModule module); //***************************************************************************** // //! Returns the EXE-ONLY status of zone 2 for a flash sector //! //! \param sector is the flash sector value. Use DCSM_Sector type. //! //! This function takes in a valid sector value and returns the status of EXE //! ONLY security protection for the sector. //! //! \return Returns DCSM_PROTECTED if the sector is EXE-ONLY protected, //! DCSM_UNPROTECTED if the sector is not EXE-ONLY protected, //! DCSM_INCORRECT_ZONE if sector does not belong to this zone. // //***************************************************************************** extern DCSM_EXEOnlyStatus DCSM_getZone2FlashEXEStatus(DCSM_Sector sector); //***************************************************************************** // //! Returns the EXE-ONLY status of zone 2 for a RAM module //! //! \param module is the RAM module value. Valid values are type DCSM_RAMModule //! C28x RAMs : //! - \b DCSM_RAMLS0 //! - \b DCSM_RAMLS1 //! - \b DCSM_RAMLS2 //! - \b DCSM_RAMLS3 //! - \b DCSM_RAMLS4 //! - \b DCSM_RAMLS5 //! - \b DCSM_RAMD0 //! - \b DCSM_RAMD1 //! //! This function takes in a valid module value and returns the status of EXE //! ONLY security protection for that module. DCSM_CLA is an invalid module //! value. There is no EXE-ONLY available for DCSM_CLA. //! //! \return Returns DCSM_PROTECTED if the module is EXE-ONLY protected, //! DCSM_UNPROTECTED if the module is not EXE-ONLY protected, //! DCSM_INCORRECT_ZONE if module does not belong to this zone. // //***************************************************************************** extern DCSM_EXEOnlyStatus DCSM_getZone2RAMEXEStatus(DCSM_RAMModule module); //***************************************************************************** // //! Claims the zone semaphore which allows access to the Flash Wrapper register //! for that zone. //! //! \param zone is the zone which is trying to claim the semaphore which allows //! access to the Flash Wrapper registers. //! //! \return Returns true for a successful semaphore capture, false if it was //! unable to capture the semaphore. // //***************************************************************************** extern _Bool DCSM_claimZoneSemaphore(DCSM_SemaphoreZone zone); //***************************************************************************** // //! Releases the zone semaphore. //! //! \return Returns true if it was successful in releasing the zone semaphore //! and false if it was unsuccessful in releasing the zone semaphore. //! //! \note If the calling function is not in the right zone to be able //! to access this register, it will return a false. // //***************************************************************************** extern _Bool DCSM_releaseZoneSemaphore(void); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: dma.h // // TITLE: C28x DMA driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup dma_api DMA //! \brief This module is used for DMA configurations. //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_dma.h // // TITLE: Definitions for the DMA registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the DMA register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DMACTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DEBUGCTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PRIORITYCTRL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PRIORITYSTAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MODE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CONTROL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the BURST_SIZE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the BURST_COUNT register // //************************************************************************************************* //***************************************************************************** // // Values that can be passed to DMA_configMode() as the config parameter. // //***************************************************************************** //! Only one burst transfer performed per trigger. //! Burst transfers occur without additional event triggers after the first. //! DMA channel will be disabled at the end of a transfer. //! DMA reinitializes when the transfer count is zero and waits for a trigger. //! DMA transfers 16 bits at a time. //! DMA transfers 32 bits at a time. //***************************************************************************** // //! Values that can be passed to DMA_configMode() as the \e trigger parameter. // //***************************************************************************** typedef enum { DMA_TRIGGER_SOFTWARE = 0, DMA_TRIGGER_ADCA1 = 1, DMA_TRIGGER_ADCA2 = 2, DMA_TRIGGER_ADCA3 = 3, DMA_TRIGGER_ADCA4 = 4, DMA_TRIGGER_ADCAEVT = 5, DMA_TRIGGER_ADCB1 = 6, DMA_TRIGGER_ADCB2 = 7, DMA_TRIGGER_ADCB3 = 8, DMA_TRIGGER_ADCB4 = 9, DMA_TRIGGER_ADCBEVT = 10, DMA_TRIGGER_ADCC1 = 11, DMA_TRIGGER_ADCC2 = 12, DMA_TRIGGER_ADCC3 = 13, DMA_TRIGGER_ADCC4 = 14, DMA_TRIGGER_ADCCEVT = 15, DMA_TRIGGER_ADCD1 = 16, DMA_TRIGGER_ADCD2 = 17, DMA_TRIGGER_ADCD3 = 18, DMA_TRIGGER_ADCD4 = 19, DMA_TRIGGER_ADCDEVT = 20, DMA_TRIGGER_XINT1 = 29, DMA_TRIGGER_XINT2 = 30, DMA_TRIGGER_XINT3 = 31, DMA_TRIGGER_XINT4 = 32, DMA_TRIGGER_XINT5 = 33, DMA_TRIGGER_EPWM1SOCA = 36, DMA_TRIGGER_EPWM1SOCB = 37, DMA_TRIGGER_EPWM2SOCA = 38, DMA_TRIGGER_EPWM2SOCB = 39, DMA_TRIGGER_EPWM3SOCA = 40, DMA_TRIGGER_EPWM3SOCB = 41, DMA_TRIGGER_EPWM4SOCA = 42, DMA_TRIGGER_EPWM4SOCB = 43, DMA_TRIGGER_EPWM5SOCA = 44, DMA_TRIGGER_EPWM5SOCB = 45, DMA_TRIGGER_EPWM6SOCA = 46, DMA_TRIGGER_EPWM6SOCB = 47, DMA_TRIGGER_EPWM7SOCA = 48, DMA_TRIGGER_EPWM7SOCB = 49, DMA_TRIGGER_EPWM8SOCA = 50, DMA_TRIGGER_EPWM8SOCB = 51, DMA_TRIGGER_EPWM9SOCA = 52, DMA_TRIGGER_EPWM9SOCB = 53, DMA_TRIGGER_EPWM10SOCA = 54, DMA_TRIGGER_EPWM10SOCB = 55, DMA_TRIGGER_EPWM11SOCA = 56, DMA_TRIGGER_EPWM11SOCB = 57, DMA_TRIGGER_EPWM12SOCA = 58, DMA_TRIGGER_EPWM12SOCB = 59, DMA_TRIGGER_TINT0 = 68, DMA_TRIGGER_TINT1 = 69, DMA_TRIGGER_TINT2 = 70, DMA_TRIGGER_MCBSPAMXEVT = 71, DMA_TRIGGER_MCBSPAMREVT = 72, DMA_TRIGGER_MCBSPBMXEVT = 73, DMA_TRIGGER_MCBSPBMREVT = 74, DMA_TRIGGER_SDFM1FLT1 = 95, DMA_TRIGGER_SDFM1FLT2 = 96, DMA_TRIGGER_SDFM1FLT3 = 97, DMA_TRIGGER_SDFM1FLT4 = 98, DMA_TRIGGER_SDFM2FLT1 = 99, DMA_TRIGGER_SDFM2FLT2 = 100, DMA_TRIGGER_SDFM2FLT3 = 101, DMA_TRIGGER_SDFM2FLT4 = 102, DMA_TRIGGER_SPIATX = 109, DMA_TRIGGER_SPIARX = 110, DMA_TRIGGER_SPIBTX = 111, DMA_TRIGGER_SPIBRX = 112, DMA_TRIGGER_SPICTX = 113, DMA_TRIGGER_SPICRX = 114, DMA_TRIGGER_CLB1INT = 127, DMA_TRIGGER_CLB2INT = 128, DMA_TRIGGER_CLB3INT = 129, DMA_TRIGGER_CLB4INT = 130, } DMA_Trigger; //***************************************************************************** // //! Values that can be passed to DMA_setInterruptMode() as the \e mode //! parameter. // //***************************************************************************** typedef enum { //! DMA interrupt is generated at the beginning of a transfer DMA_INT_AT_BEGINNING, //! DMA interrupt is generated at the end of a transfer DMA_INT_AT_END } DMA_InterruptMode; //***************************************************************************** // //! Values that can be passed to DMA_setEmulationMode() as the \e mode //! parameter. // //***************************************************************************** typedef enum { //! Transmission stops after current read-write access is completed DMA_EMULATION_STOP, //! Continue DMA operation regardless of emulation suspend DMA_EMULATION_FREE_RUN } DMA_EmulationMode; //***************************************************************************** // //! Values that can be passed to DMA_configChannel() as the //! configure parameter. // //***************************************************************************** typedef struct { DMA_Trigger transferTrigger; //DMA transfer triggers DMA_InterruptMode interruptMode; //Channel interrupt mode //! enableInterrupt can have a value 1(Enable) or 0(Disable) _Bool enableInterrupt; //Enable/Disable interrupt mode //! configSize can have a value DMA_CFG_SIZE_16BIT/32BIT uint32_t configSize; //Data bus width (16 or 32 bits) //! transferMode can have a value DMA_CFG_ONESHOT_DISABLE/ENABLE uint32_t transferMode; //Burst transfer mode //! reinitMode can have a value DMA_CFG_CONTINUOUS_DISABLE/ENABLE uint32_t reinitMode; //DMA reinitialization mode //! burstSize value range from 1 word to 32 sixteen-bit words. uint32_t burstSize; //Number of words transferred per burst //! transferSize value range from 1 to 65536 uint32_t transferSize; //Number of bursts per transfer //! Number of bursts to be transferred before a wrap of the source address //! occurs. srcWrapSize value range from 1 to 65536 uint32_t srcWrapSize; //! Number of bursts to be transferred before a wrap of the destination //! address occurs. destWrapSize value range from 1 to 65536 uint32_t destWrapSize; uint32_t destAddr; //destination address uint32_t srcAddr; //source address //! Amount to inc or dec the source address after each word of a burst. //! srcBurstStep can have only signed values from -4096 to 4095 int16_t srcBurstStep; //! Amount to inc or dec the destination address after each word of a burst. //! destBurstStep can have only signed values from -4096 to 4095 int16_t destBurstStep; //! Amount to inc or dec the source address after each burst of a transfer. //! srcTransferStep can have only signed values from -4096 to 4095 int16_t srcTransferStep; //! Amount to inc or dec the destination address after each burst of a //! transfer. destTransferStep can have only signed values from -4096 to 4095 int16_t destTransferStep; //! Amount to inc or dec the source address when the wrap occurs. //! srcWrapStep can have only signed values from -4096 to 4095 int16_t srcWrapStep; //! Amount to inc or dec the destination address when the wrap occurs. //! destWrapStep can have only signed values from -4096 to 4095 int16_t destWrapStep; } DMA_ConfigParams; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks an DMA channel base address. //! //! \param base specifies the DMA channel base address. //! //! This function determines if a DMA channel base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool DMA_isBaseValid(uint32_t base) { return((base == 0x00001020U) || (base == 0x00001040U) || (base == 0x00001060U) || (base == 0x00001080U) || (base == 0x000010A0U) || (base == 0x000010C0U)); } //***************************************************************************** // //! Initializes the DMA controller to a known state. //! //! This function configures does a hard reset of the DMA controller in order //! to put it into a known state. The function also sets the DMA to run free //! during an emulation suspend (see the field DEBUGCTRL.FREE for more info). //! //! \return None. // //***************************************************************************** static inline void DMA_initController(void) { __eallow(); // // Set the hard reset bit. One NOP is required after HARDRESET. // (*((volatile uint16_t *)(0x00001000U + 0x0U))) |= 0x1U; __asm(" NOP"); __edis(); } //***************************************************************************** // //! Channel Soft Reset //! //! \param base is the base address of the DMA channel control registers. //! //! This function does a soft reset to place the channel into its default state //! //! \return None. // //***************************************************************************** static inline void DMA_triggerSoftReset(uint32_t base) { __eallow(); // // Set the soft reset bit. One NOP is required after SOFTRESET. // (*((volatile uint16_t *)(base + 0x1U))) |= 0x4U; __asm(" NOP"); __edis(); } //***************************************************************************** // //! Sets DMA emulation mode. //! //! \param mode is the emulation mode to be selected. //! //! This function sets the behavior of the DMA operation when an emulation //! suspend occurs. The \e mode parameter can be one of the following: //! //! - \b DMA_EMULATION_STOP - DMA runs until the current read-write access is //! completed. //! - \b DMA_EMULATION_FREE_RUN - DMA operation continues regardless of a //! the suspend. //! //! \return None. // //***************************************************************************** static inline void DMA_setEmulationMode(DMA_EmulationMode mode) { __eallow(); // // Set emulation mode // if(mode == DMA_EMULATION_STOP) { (*((volatile uint16_t *)(0x00001000U + 0x1U))) &= ~0x8000U; } else { (*((volatile uint16_t *)(0x00001000U + 0x1U))) |= 0x8000U; } __edis(); } //***************************************************************************** // //! Enables peripherals to trigger a DMA transfer. //! //! \param base is the base address of the DMA channel control registers. //! //! This function enables the selected peripheral trigger to start a DMA //! transfer on the specified channel. //! //! \return None. // //***************************************************************************** static inline void DMA_enableTrigger(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 400); } } while((_Bool)0); // // Set the peripheral interrupt trigger enable bit. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) |= 0x100U; __edis(); } //***************************************************************************** // //! Disables peripherals from triggering a DMA transfer. //! //! \param base is the base address of the DMA channel control registers. //! //! This function disables the selected peripheral trigger from starting a DMA //! transfer on the specified channel. This also disables the use of the //! software force using the DMA_forceTrigger() API. //! //! \return None. // //***************************************************************************** static inline void DMA_disableTrigger(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 429); } } while((_Bool)0); // // Clear the peripheral interrupt trigger enable bit. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) &= ~0x100U; __edis(); } //***************************************************************************** // //! Force a peripheral trigger to a DMA channel. //! //! \param base is the base address of the DMA channel control registers. //! //! This function sets the peripheral trigger flag and if triggering a DMA //! burst is enabled (see DMA_enableTrigger()), a DMA burst transfer will be //! forced. //! //! \return None. // //***************************************************************************** static inline void DMA_forceTrigger(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 458); } } while((_Bool)0); // // Set the peripheral interrupt trigger force bit. // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) |= 0x8U; __edis(); } //***************************************************************************** // //! Clears a DMA channel's peripheral trigger flag. //! //! \param base is the base address of the DMA channel control registers. //! //! This function clears the peripheral trigger flag. Normally, you would use //! this function when initializing the DMA for the first time. The flag is //! cleared automatically when the DMA starts the first burst of a transfer. //! //! \return None. // //***************************************************************************** static inline void DMA_clearTriggerFlag(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 487); } } while((_Bool)0); // // Write a one to the clear bit to clear the peripheral trigger flag. // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) |= 0x10U; __edis(); } //***************************************************************************** // //! Gets the status of a DMA channel's Transfer Status Flag. //! //! \param base is the base address of the DMA channel control registers. //! //! This function returns \b true if the Transfer Status Flag is set, which //! means a DMA transfer has begun. //! This flag is cleared when TRANSFER_COUNT reaches zero, or when the //! HARDRESET or SOFTRESET bit is set. //! //! \return Returns \b true if the Transfer Status Flag is set. Returns \b false //! otherwise. // //***************************************************************************** static inline _Bool DMA_getTransferStatusFlag(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 518); } } while((_Bool)0); // // Read the Transfer Status Flag and return appropriately. // return(((*((volatile uint16_t *)(base + 0x1U))) & 0x800U) != 0U); } //***************************************************************************** // //! Gets the status of a DMA channel's Burst Status Flag. //! //! \param base is the base address of the DMA channel control registers. //! //! This function returns \b true if the Burst Status Flag is set, which //! means a DMA burst has begun. //! This flag is cleared when BURST_COUNT reaches zero, or when the //! HARDRESET or SOFTRESET bit is set. //! //! \return Returns \b true if the Burst Status Flag is set. Returns \b false //! otherwise. // //***************************************************************************** static inline _Bool DMA_getBurstStatusFlag(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 547); } } while((_Bool)0); // // Read the Burst Status Flag and return appropriately. // return(((*((volatile uint16_t *)(base + 0x1U))) & 0x1000U) != 0U); } //***************************************************************************** // //! Gets the status of a DMA channel's Run Status Flag. //! //! \param base is the base address of the DMA channel control registers. //! //! This function returns \b true if the Run Status Flag is set, which //! means the DMA channel is enabled. //! This flag is cleared when a transfer completes (TRANSFER_COUNT = 0) and //! continuous mode is disabled, or when the HARDRESET, SOFTRESET, or HALT bit //! is set. //! //! \return Returns \b true if the channel is enabled. Returns \b false //! otherwise. // //***************************************************************************** static inline _Bool DMA_getRunStatusFlag(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 577); } } while((_Bool)0); // // Read the Run Status Flag and return appropriately. // return(((*((volatile uint16_t *)(base + 0x1U))) & 0x2000U) != 0U); } //***************************************************************************** // //! Gets the status of a DMA channel's Overflow Flag. //! //! \param base is the base address of the DMA channel control registers. //! //! This function returns \b true if the Overflow Flag is set, which //! means peripheral event trigger was received while Peripheral Event Trigger //! Flag was already set. //! This flag can be cleared by writing to ERRCLR bit, using the function //! DMA_clearErrorFlag(). //! //! \return Returns \b true if the channel is enabled. Returns \b false //! otherwise. // //***************************************************************************** static inline _Bool DMA_getOverflowFlag(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 607); } } while((_Bool)0); // // Read the Overflow Flag and return appropriately. // return(((*((volatile uint16_t *)(base + 0x1U))) & 0x4000U) != 0U); } //***************************************************************************** // //! Gets the status of a DMA channel's peripheral trigger flag. //! //! \param base is the base address of the DMA channel control registers. //! //! This function returns \b true if a peripheral trigger event has occurred //! The flag is automatically cleared when the first burst transfer begins, but //! if needed, it can be cleared using DMA_clearTriggerFlag(). //! //! \return Returns \b true if a peripheral trigger event has occurred and its //! flag is set. Returns \b false otherwise. // //***************************************************************************** static inline _Bool DMA_getTriggerFlagStatus(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 635); } } while((_Bool)0); // // Read the peripheral trigger flag and return appropriately. // return(((*((volatile uint16_t *)(base + 0x1U))) & 0x100U) != 0U); } //***************************************************************************** // //! Starts a DMA channel. //! //! \param base is the base address of the DMA channel control registers. //! //! This function starts the DMA running, typically after you have configured //! it. It will wait for the first trigger event to start operation. To halt //! the channel use DMA_stopChannel(). //! //! \return None. // //***************************************************************************** static inline void DMA_startChannel(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 662); } } while((_Bool)0); // // Set the run bit. // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Halts a DMA channel. //! //! \param base is the base address of the DMA channel control registers. //! //! This function halts the DMA at its current state and any current read-write //! access is completed. To start the channel again use DMA_startChannel(). //! //! \return None. // //***************************************************************************** static inline void DMA_stopChannel(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 690); } } while((_Bool)0); // // Set the halt bit. // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Enables a DMA channel interrupt source. //! //! \param base is the base address of the DMA channel control registers. //! //! This function enables the indicated DMA channel interrupt source. //! //! \return None. // //***************************************************************************** static inline void DMA_enableInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 717); } } while((_Bool)0); // // Enable the specified DMA channel interrupt. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Disables a DMA channel interrupt source. //! //! \param base is the base address of the DMA channel control registers. //! //! This function disables the indicated DMA channel interrupt source. //! //! \return None. // //***************************************************************************** static inline void DMA_disableInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 744); } } while((_Bool)0); // // Disable the specified DMA channel interrupt. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) &= ~0x8000U; __edis(); } //***************************************************************************** // //! Enables the DMA channel overrun interrupt. //! //! \param base is the base address of the DMA channel control registers. //! //! This function enables the indicated DMA channel's ability to generate an //! interrupt upon the detection of an overrun. An overrun is when a peripheral //! event trigger is received by the DMA before a previous trigger on that //! channel had been serviced and its flag had been cleared. //! //! Note that this is the same interrupt signal as the interrupt that gets //! generated at the beginning/end of a transfer. That interrupt must first be //! enabled using DMA_enableInterrupt() in order for the overrun interrupt to //! be generated. //! //! \return None. // //***************************************************************************** static inline void DMA_enableOverrunInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 779); } } while((_Bool)0); // // Enable the specified DMA channel interrupt. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) |= 0x80U; __edis(); } //***************************************************************************** // //! Disables the DMA channel overrun interrupt. //! //! \param base is the base address of the DMA channel control registers. //! //! This function disables the indicated DMA channel's ability to generate an //! interrupt upon the detection of an overrun. //! //! \return None. // //***************************************************************************** static inline void DMA_disableOverrunInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 807); } } while((_Bool)0); // // Disable the specified DMA channel interrupt. // __eallow(); (*((volatile uint16_t *)(base + 0x0U))) &= ~0x80U; __edis(); } //***************************************************************************** // //! Clears the DMA channel error flags. //! //! \param base is the base address of the DMA channel control registers. //! //! This function clears both the DMA channel's sync error flag and its //! overrun error flag. //! //! \return None. // //***************************************************************************** static inline void DMA_clearErrorFlag(uint32_t base) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 835); } } while((_Bool)0); // // Write to the error clear bit. // __eallow(); (*((volatile uint16_t *)(base + 0x1U))) |= 0x80U; __edis(); } //***************************************************************************** // //! Sets the interrupt generation mode of a DMA channel interrupt. //! //! \param base is the base address of the DMA channel control registers. //! \param mode is a flag to indicate the channel interrupt mode. //! //! This function sets the channel interrupt mode. When the \e mode parameter //! is \b DMA_INT_AT_END, the DMA channel interrupt will be generated at the //! end of the transfer. If \b DMA_INT_AT_BEGINNING, the interrupt will be //! generated at the beginning of a new transfer. Generating at the beginning //! of a new transfer is the default behavior. //! //! \return None. // //***************************************************************************** static inline void DMA_setInterruptMode(uint32_t base, DMA_InterruptMode mode) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 867); } } while((_Bool)0); __eallow(); // // Write the selected interrupt generation mode to the register. // if(mode == DMA_INT_AT_END) { (*((volatile uint16_t *)(base + 0x0U))) |= 0x200U; } else { (*((volatile uint16_t *)(base + 0x0U))) &= ~0x200U; } __edis(); } //***************************************************************************** // //! Sets the DMA channel priority mode. //! //! \param ch1IsHighPri is a flag to indicate the channel interrupt mode. //! //! This function sets the channel interrupt mode. When the \e ch1IsHighPri //! parameter is \b false, the DMA channels are serviced in round-robin mode. //! This is the default behavior. //! //! If \b true, channel 1 will be given higher priority than the other //! channels. This means that if a channel 1 trigger occurs, the current word //! transfer on any other channel is completed and channel 1 is serviced for //! the complete burst count. The lower-priority channel's interrupted transfer //! will then resume. //! //! \return None. // //***************************************************************************** static inline void DMA_setPriorityMode(_Bool ch1IsHighPri) { __eallow(); // // Write the selected priority mode to the register. // if(ch1IsHighPri) { (*((volatile uint16_t *)(0x00001000U + 0x4U))) |= 0x1U; } else { (*((volatile uint16_t *)(0x00001000U + 0x4U))) &= ~0x1U; } __edis(); } //***************************************************************************** // //! Configures the source address for the DMA channel //! //! \param base is the base address of the DMA channel control registers. //! \param *srcAddr is a source address. //! //! This function configures the source address of a DMA //! channel. //! //! \return None. // //***************************************************************************** static inline void DMA_configSourceAddress(uint32_t base, const void *srcAddr) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 946); } } while((_Bool)0); __eallow(); // // Set up SOURCE address. // (*((volatile uint32_t *)(base + 0x10U))) = (uint32_t)srcAddr; (*((volatile uint32_t *)(base + 0x12U))) = (uint32_t)srcAddr; __edis(); } //***************************************************************************** // //! Configures the destination address for the DMA channel //! //! \param base is the base address of the DMA channel control registers. //! \param *destAddr is the destination address. //! //! This function configures the destinaton address of a DMA //! channel. //! //! \return None. // //***************************************************************************** static inline void DMA_configDestAddress(uint32_t base, const void *destAddr) { // // Check the arguments. // do { if(!(DMA_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/dma.h", 978); } } while((_Bool)0); __eallow(); // // Set up DESTINATION address. // (*((volatile uint32_t *)(base + 0x18U))) = (uint32_t)destAddr; (*((volatile uint32_t *)(base + 0x1AU))) = (uint32_t)destAddr; __edis(); } //***************************************************************************** // //! Setup DMA to transfer data on the specified channel. //! //! \param base is Base address of the DMA channel control register //! \param *transfParams configuration parameter //! Refer struct #DMA_ConfigParams //! //! This function configures the DMA transfer on the specified channel. //! //! \return None. // //***************************************************************************** extern void DMA_configChannel(uint32_t base, const DMA_ConfigParams *transfParams); //***************************************************************************** // //! Configures the DMA channel //! //! \param base is the base address of the DMA channel control registers. //! \param *destAddr is the destination address. //! \param *srcAddr is a source address. //! //! This function configures the source and destination addresses of a DMA //! channel. The parameters are pointers to the data to be transferred. //! //! \return None. // //***************************************************************************** extern void DMA_configAddresses(uint32_t base, const void *destAddr, const void *srcAddr); //***************************************************************************** // //! Configures the DMA channel's burst settings. //! //! \param base is the base address of the DMA channel control registers. //! \param size is the number of words transferred per burst. //! \param srcStep is the amount to increment or decrement the source address //! after each word of a burst. //! \param destStep is the amount to increment or decrement the destination //! address after each word of a burst. //! //! This function configures the size of each burst and the address step size. //! //! The \e size parameter is the number of words that will be transferred //! during a single burst. Possible amounts range from 1 word to 32 words. //! //! The \e srcStep and \e destStep parameters specify the address step that //! should be added to the source and destination addresses after each //! transferred word of a burst. Only signed values from -4096 to 4095 are //! valid. //! //! \note Note that regardless of what data size (configured by //! DMA_configMode()) is used, parameters are in terms of 16-bits words. //! //! \return None. // //***************************************************************************** extern void DMA_configBurst(uint32_t base, uint16_t size, int16_t srcStep, int16_t destStep); //***************************************************************************** // //! Configures the DMA channel's transfer settings. //! //! \param base is the base address of the DMA channel control registers. //! \param transferSize is the number of bursts per transfer. //! \param srcStep is the amount to increment or decrement the source address //! after each burst of a transfer unless a wrap occurs. //! \param destStep is the amount to increment or decrement the destination //! address after each burst of a transfer unless a wrap occurs. //! //! This function configures the transfer size and the address step that is //! made after each burst. //! //! The \e transferSize parameter is the number of bursts per transfer. If DMA //! channel interrupts are enabled, they will occur after this number of bursts //! have completed. The maximum number of bursts is 65536. //! //! The \e srcStep and \e destStep parameters specify the address step that //! should be added to the source and destination addresses after each //! transferred burst of a transfer. Only signed values from -4096 to 4095 are //! valid. If a wrap occurs, these step values will be ignored. Wrapping is //! configured with DMA_configWrap(). //! //! \note Note that regardless of what data size (configured by //! DMA_configMode()) is used, parameters are in terms of 16-bits words. //! //! \return None. // //***************************************************************************** extern void DMA_configTransfer(uint32_t base, uint32_t transferSize, int16_t srcStep, int16_t destStep); //***************************************************************************** // //! Configures the DMA channel's wrap settings. //! //! \param base is the base address of the DMA channel control registers. //! \param srcWrapSize is the number of bursts to be transferred before a wrap //! of the source address occurs. //! \param srcStep is the amount to increment or decrement the source address //! after each burst of a transfer unless a wrap occurs. //! \param destWrapSize is the number of bursts to be transferred before a wrap //! of the destination address occurs. //! \param destStep is the amount to increment or decrement the destination //! address after each burst of a transfer unless a wrap occurs. //! //! This function configures the DMA channel's wrap settings. //! //! The \e srcWrapSize and \e destWrapSize parameters are the number of bursts //! that are to be transferred before their respective addresses are wrapped. //! The maximum wrap size is 65536 bursts. //! //! The \e srcStep and \e destStep parameters specify the address step that //! should be added to the source and destination addresses when the wrap //! occurs. Only signed values from -4096 to 4095 are valid. //! //! \note Note that regardless of what data size (configured by //! DMA_configMode()) is used, parameters are in terms of 16-bits words. //! //! \return None. // //***************************************************************************** extern void DMA_configWrap(uint32_t base, uint32_t srcWrapSize, int16_t srcStep, uint32_t destWrapSize, int16_t destStep); //***************************************************************************** // //! Configures the DMA channel trigger and mode. //! //! \param base is the base address of the DMA channel control registers. //! \param trigger is the interrupt source that triggers a DMA transfer. //! \param config is a bit field of several configuration selections. //! //! This function configures the DMA channel's trigger and mode. //! //! The \e trigger parameter is the interrupt source that will trigger the //! start of a DMA transfer. //! //! The \e config parameter is the logical OR of the following values: //! - \b DMA_CFG_ONESHOT_DISABLE or \b DMA_CFG_ONESHOT_ENABLE. If enabled, //! the subsequent burst transfers occur without additional event triggers //! after the first event trigger. If disabled, only one burst transfer is //! performed per event trigger. //! - \b DMA_CFG_CONTINUOUS_DISABLE or \b DMA_CFG_CONTINUOUS_ENABLE. If enabled //! the DMA reinitializes when the transfer count is zero and waits for the //! next interrupt event trigger. If disabled, the DMA stops and clears the //! run status bit. //! - \b DMA_CFG_SIZE_16BIT or \b DMA_CFG_SIZE_32BIT. This setting selects //! whether the databus width is 16 or 32 bits. //! //! \return None. // //***************************************************************************** extern void DMA_configMode(uint32_t base, DMA_Trigger trigger, uint32_t config); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: ecap.h // // TITLE: C28x ECAP driver // //############################################################################# // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //############################################################################# //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup ecap_api eCAP //! @{ // //***************************************************************************** //***************************************************************************** // // Includes // //***************************************************************************** //########################################################################### // // FILE: hw_ecap.h // // TITLE: Definitions for the ECAP registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the ECAP register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ECCTL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ECCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ECEINT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ECFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ECCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ECFRC register // //************************************************************************************************* //***************************************************************************** // // eCAP minimum and maximum values // //***************************************************************************** //***************************************************************************** // // Values that can be passed to ECAP_enableInterrupt(), // ECAP_disableInterrupt(), ECAP_clearInterrupt() and ECAP_forceInterrupt() as // the intFlags parameter and returned by ECAP_getInterruptSource(). // //***************************************************************************** //! Event 1 ISR source //! //! Event 2 ISR source //! //! Event 3 ISR source //! //! Event 4 ISR source //! //! Counter overflow ISR source //! //! Counter equals period ISR source //! //! Counter equals compare ISR source //! //***************************************************************************** // //! Values that can be passed to ECAP_setEmulationMode() as the //! \e mode parameter. // //***************************************************************************** typedef enum { //! TSCTR is stopped on emulation suspension ECAP_EMULATION_STOP = 0x0U, //! TSCTR runs until 0 before stopping on emulation suspension ECAP_EMULATION_RUN_TO_ZERO = 0x1U, //! TSCTR is not affected by emulation suspension ECAP_EMULATION_FREE_RUN = 0x2U }ECAP_EmulationMode; //***************************************************************************** // //! Values that can be passed to ECAP_setCaptureMode() as the //! \e mode parameter. // //***************************************************************************** typedef enum { //! eCAP operates in continuous capture mode ECAP_CONTINUOUS_CAPTURE_MODE = 0U, //! eCAP operates in one shot capture mode ECAP_ONE_SHOT_CAPTURE_MODE = 1U }ECAP_CaptureMode; //***************************************************************************** // //! Values that can be passed to ECAP_setEventPolarity(),ECAP_setCaptureMode(), //! ECAP_enableCounterResetOnEvent(),ECAP_disableCounterResetOnEvent(), //! ECAP_getEventTimeStamp(),ECAP_setDMASource() as the \e event parameter. // //***************************************************************************** typedef enum { ECAP_EVENT_1 = 0U, //!< eCAP event 1 ECAP_EVENT_2 = 1U, //!< eCAP event 2 ECAP_EVENT_3 = 2U, //!< eCAP event 3 ECAP_EVENT_4 = 3U //!< eCAP event 4 }ECAP_Events; //***************************************************************************** // //! Values that can be passed to ECAP_setSyncOutMode() as the \e mode //! parameter. // //***************************************************************************** typedef enum { //! sync out on the sync in signal and software force ECAP_SYNC_OUT_SYNCI = 0x00U, //! sync out on counter equals period ECAP_SYNC_OUT_COUNTER_PRD = 0x40U, //! Disable sync out signal ECAP_SYNC_OUT_DISABLED = 0x80U }ECAP_SyncOutMode; //***************************************************************************** // //! Values that can be passed to ECAP_setAPWMPolarity() as the \e polarity //! parameter. // //***************************************************************************** typedef enum { ECAP_APWM_ACTIVE_HIGH = 0x000, //!< APWM is active high ECAP_APWM_ACTIVE_LOW = 0x400 //!< APWM is active low }ECAP_APWMPolarity; //***************************************************************************** // //! Values that can be passed to ECAP_setEventPolarity() as the \e polarity //! parameter. // //***************************************************************************** typedef enum { ECAP_EVNT_RISING_EDGE = 0U, //!< Rising edge polarity ECAP_EVNT_FALLING_EDGE = 1U //!< Falling edge polarity }ECAP_EventPolarity; //***************************************************************************** // //! \internal //! Checks eCAP base address. //! //! \param base specifies the eCAP module base address. //! //! This function determines if an eCAP module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool ECAP_isBaseValid(uint32_t base) { return( (base == 0x00005000U) || (base == 0x00005020U) || (base == 0x00005040U) || (base == 0x00005060U) || (base == 0x00005080U) || (base == 0x000050A0U) ); } //***************************************************************************** // //! Sets the input prescaler. //! //! \param base is the base address of the ECAP module. //! \param preScalerValue is the pre scaler value for ECAP input //! //! This function divides the ECAP input scaler. The pre scale value is //! doubled inside the module. For example a preScalerValue of 5 will divide //! the scaler by 10. Use a value of 1 to divide the pre scaler by 1. //! The \e preScalerValue should be less than \b ECAP_MAX_PRESCALER_VALUE. //! //! \return None. // //***************************************************************************** static inline void ECAP_setEventPrescaler(uint32_t base, uint16_t preScalerValue) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 242); } } while((_Bool)0); do { if(!(preScalerValue < 32U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 244); } } while((_Bool)0); // // Write to PRESCALE bit // (*((volatile uint16_t *)(base + 0x14U))) = (((*((volatile uint16_t *)(base + 0x14U))) & (~0x3E00U)) | (preScalerValue << 9U)); } //***************************************************************************** // //! Sets the Capture event polarity. //! //! \param base is the base address of the ECAP module. //! \param event is the event number. //! \param polarity is the polarity of the event. //! //! This function sets the polarity of a given event. The value of event //! is between \b ECAP_EVENT_1 and \b ECAP_EVENT_4 inclusive corresponding to //! the four available events.For each event the polarity value determines the //! edge on which the capture is activated. For a rising edge use a polarity //! value of \b ECAP_EVNT_RISING_EDGE and for a falling edge use a polarity of //! \b ECAP_EVNT_FALLING_EDGE. //! //! \return None. // //***************************************************************************** static inline void ECAP_setEventPolarity(uint32_t base, ECAP_Events event, ECAP_EventPolarity polarity) { uint16_t shift; do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 280); } } while((_Bool)0); shift = ((uint16_t)event) << 1U; // // Write to CAP1POL, CAP2POL, CAP3POL or CAP4POL // (*((volatile uint16_t *)(base + 0x14U))) = ((*((volatile uint16_t *)(base + 0x14U))) & ~(1U << shift)) | ((uint16_t)polarity << shift); } //***************************************************************************** // //! Sets the capture mode. //! //! \param base is the base address of the ECAP module. //! \param mode is the capture mode. //! \param event is the event number at which the counter stops or wraps. //! //! This function sets the eCAP module to a continuous or one-shot mode. //! The value of mode should be either \b ECAP_CONTINUOUS_CAPTURE_MODE or //! \b ECAP_ONE_SHOT_CAPTURE_MODE corresponding to continuous or one-shot mode //! respectively. //! //! The value of event determines the event number at which the counter stops //! (in one-shot mode) or the counter wraps (in continuous mode). The value of //! event should be between \b ECAP_EVENT_1 and \b ECAP_EVENT_4 corresponding //! to the valid event numbers. //! //! \return None. // //***************************************************************************** static inline void ECAP_setCaptureMode(uint32_t base, ECAP_CaptureMode mode, ECAP_Events event) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 318); } } while((_Bool)0); // // Write to CONT/ONESHT // (*((volatile uint16_t *)(base + 0x15U))) = (((*((volatile uint16_t *)(base + 0x15U))) & (~0x1U)) | (uint16_t)mode); // // Write to STOP_WRAP // (*((volatile uint16_t *)(base + 0x15U))) = (((*((volatile uint16_t *)(base + 0x15U))) & (~0x6U)) | (((uint16_t)event) << 1U )); } //***************************************************************************** // //! Re-arms the eCAP module. //! //! \param base is the base address of the ECAP module. //! //! This function re-arms the eCAP module. //! //! \return None. // //***************************************************************************** static inline void ECAP_reArm(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 349); } } while((_Bool)0); // // Write to RE-ARM bit // (*((volatile uint16_t *)(base + 0x15U))) |= 0x8U; } //***************************************************************************** // //! Enables interrupt source. //! //! \param base is the base address of the ECAP module. //! \param intFlags is the interrupt source to be enabled. //! //! This function sets and enables eCAP interrupt source. The following are //! valid interrupt sources. //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_1 - Event 1 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_2 - Event 2 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_3 - Event 3 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_4 - Event 4 generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_OVERFLOW - Counter overflow generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_PERIOD - Counter equal period generates //! interrupt //! - ECAP_ISR_SOURCE_COUNTER_COMPARE - Counter equal compare generates //! interrupt //! //! \return None. // //***************************************************************************** static inline void ECAP_enableInterrupt(uint32_t base, uint16_t intFlags) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 383); } } while((_Bool)0); do { if(!((intFlags & ~(0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x80U)) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 390); } } while((_Bool)0); // // Set bits in ECEINT register // (*((volatile uint16_t *)(base + 0x16U))) |= intFlags; } //***************************************************************************** // //! Disables interrupt source. //! //! \param base is the base address of the ECAP module. //! \param intFlags is the interrupt source to be disabled. //! //! This function clears and disables eCAP interrupt source. The following are //! valid interrupt sources. //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_1 - Event 1 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_2 - Event 2 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_3 - Event 3 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_4 - Event 4 generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_OVERFLOW - Counter overflow generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_PERIOD - Counter equal period generates //! interrupt //! - ECAP_ISR_SOURCE_COUNTER_COMPARE - Counter equal compare generates //! interrupt //! //! \return None. // //***************************************************************************** static inline void ECAP_disableInterrupt(uint32_t base, uint16_t intFlags) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 426); } } while((_Bool)0); do { if(!((intFlags & ~(0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x80U)) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 433); } } while((_Bool)0); // // Clear bits in ECEINT register // (*((volatile uint16_t *)(base + 0x16U))) &= ~intFlags; } //***************************************************************************** // //! Returns the interrupt flag. //! //! \param base is the base address of the ECAP module. //! //! This function returns the eCAP interrupt flag. The following are valid //! interrupt sources corresponding to the eCAP interrupt flag. //! //! \return Returns the eCAP interrupt that has occurred. The following are //! valid return values. //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_1 - Event 1 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_2 - Event 2 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_3 - Event 3 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_4 - Event 4 generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_OVERFLOW - Counter overflow generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_PERIOD - Counter equal period generates //! interrupt //! - ECAP_ISR_SOURCE_COUNTER_COMPARE - Counter equal compare generates //! interrupt //! //! \note - User can check if a combination of various interrupts have occurred //! by ORing the above return values. // //***************************************************************************** static inline uint16_t ECAP_getInterruptSource(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 469); } } while((_Bool)0); // // Return contents of ECFLG register // return((*((volatile uint16_t *)(base + 0x17U))) & 0xFEU); } //***************************************************************************** // //! Returns the Global interrupt flag. //! //! \param base is the base address of the ECAP module. //! //! This function returns the eCAP Global interrupt flag. //! //! \return Returns true if there is a global eCAP interrupt, false otherwise. // //***************************************************************************** static inline _Bool ECAP_getGlobalInterruptStatus(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 490); } } while((_Bool)0); // // Return contents of Global interrupt bit // return(((*((volatile uint16_t *)(base + 0x17U))) & 0x1U) == 0x1U); } //***************************************************************************** // //! Clears interrupt flag. //! //! \param base is the base address of the ECAP module. //! \param intFlags is the interrupt source. //! //! This function clears eCAP interrupt flags. The following are valid //! interrupt sources. //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_1 - Event 1 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_2 - Event 2 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_3 - Event 3 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_4 - Event 4 generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_OVERFLOW - Counter overflow generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_PERIOD - Counter equal period generates //! interrupt //! - ECAP_ISR_SOURCE_COUNTER_COMPARE - Counter equal compare generates //! interrupt //! //! \return None. // //***************************************************************************** static inline void ECAP_clearInterrupt(uint32_t base, uint16_t intFlags) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 523); } } while((_Bool)0); do { if(!((intFlags & ~(0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x80U)) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 530); } } while((_Bool)0); // // Write to ECCLR register // (*((volatile uint16_t *)(base + 0x18U))) = intFlags; } //***************************************************************************** // //! Clears global interrupt flag //! //! \param base is the base address of the ECAP module. //! //! This function clears the global interrupt bit. //! //! \return None. // //***************************************************************************** static inline void ECAP_clearGlobalInterrupt(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 551); } } while((_Bool)0); // // Write to INT bit // (*((volatile uint16_t *)(base + 0x18U))) = 0x1U; } //***************************************************************************** // //! Forces interrupt source. //! //! \param base is the base address of the ECAP module. //! \param intFlags is the interrupt source. //! //! This function forces and enables eCAP interrupt source. The following are //! valid interrupt sources. //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_1 - Event 1 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_2 - Event 2 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_3 - Event 3 generates interrupt //! - ECAP_ISR_SOURCE_CAPTURE_EVENT_4 - Event 4 generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_OVERFLOW - Counter overflow generates interrupt //! - ECAP_ISR_SOURCE_COUNTER_PERIOD - Counter equal period generates //! interrupt //! - ECAP_ISR_SOURCE_COUNTER_COMPARE - Counter equal compare generates //! interrupt //! //! \return None. // //***************************************************************************** static inline void ECAP_forceInterrupt(uint32_t base, uint16_t intFlags) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 584); } } while((_Bool)0); do { if(!((intFlags & ~(0x2U | 0x4U | 0x8U | 0x10U | 0x20U | 0x40U | 0x80U)) == 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 591); } } while((_Bool)0); // // Write to ECFRC register // (*((volatile uint16_t *)(base + 0x19U))) = intFlags; } //***************************************************************************** // //! Sets eCAP in Capture mode. //! //! \param base is the base address of the ECAP module. //! //! This function sets the eCAP module to operate in Capture mode. //! //! \return None. // //***************************************************************************** static inline void ECAP_enableCaptureMode(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 613); } } while((_Bool)0); // // Clear CAP/APWM bit // (*((volatile uint16_t *)(base + 0x15U))) &= ~0x200U; } //***************************************************************************** // //! Sets eCAP in APWM mode. //! //! \param base is the base address of the ECAP module. //! //! This function sets the eCAP module to operate in APWM mode. //! //! \return None. // //***************************************************************************** static inline void ECAP_enableAPWMMode(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 635); } } while((_Bool)0); // // Set CAP/APWM bit // (*((volatile uint16_t *)(base + 0x15U))) |= 0x200U; } //***************************************************************************** // //! Enables counter reset on an event. //! //! \param base is the base address of the ECAP module. //! \param event is the event number the time base gets reset. //! //! This function enables the base timer, TSCTR, to be reset on capture //! event provided by the variable event. Valid inputs for event are //! \b ECAP_EVENT_1 to \b ECAP_EVENT_4. //! //! \return None. // //***************************************************************************** static inline void ECAP_enableCounterResetOnEvent(uint32_t base, ECAP_Events event) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 661); } } while((_Bool)0); // // Set CTRRST1,CTRRST2,CTRRST3 or CTRRST4 bits // (*((volatile uint16_t *)(base + 0x14U))) |= 1U << ((2U * (uint16_t)event) + 1U); } //***************************************************************************** // //! Disables counter reset on events. //! //! \param base is the base address of the ECAP module. //! \param event is the event number the time base gets reset. //! //! This function disables the base timer, TSCTR, from being reset on capture //! event provided by the variable event. Valid inputs for event are //! \b ECAP_EVENT_1 to \b ECAP_EVENT_4. //! //! \return None. // //***************************************************************************** static inline void ECAP_disableCounterResetOnEvent(uint32_t base, ECAP_Events event) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 687); } } while((_Bool)0); // // Clear CTRRST1,CTRRST2,CTRRST3 or CTRRST4 bits // (*((volatile uint16_t *)(base + 0x14U))) &= ~(1U << ((2U * (uint16_t)event) + 1U)); } //***************************************************************************** // //! Enables time stamp capture. //! //! \param base is the base address of the ECAP module. //! //! This function enables time stamp count to be captured //! //! \return None. // //***************************************************************************** static inline void ECAP_enableTimeStampCapture(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 709); } } while((_Bool)0); // // Set CAPLDEN bit // (*((volatile uint16_t *)(base + 0x14U))) |= 0x100U; } //***************************************************************************** // //! Disables time stamp capture. //! //! \param base is the base address of the ECAP module. //! //! This function disables time stamp count to be captured //! //! \return None. // //***************************************************************************** static inline void ECAP_disableTimeStampCapture(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 731); } } while((_Bool)0); // // Clear CAPLDEN bit // (*((volatile uint16_t *)(base + 0x14U))) &= ~0x100U; } //***************************************************************************** // //! Sets a phase shift value count. //! //! \param base is the base address of the ECAP module. //! \param shiftCount is the phase shift value. //! //! This function writes a phase shift value to be loaded into the main time //! stamp counter. //! //! \return None. // //***************************************************************************** static inline void ECAP_setPhaseShiftCount(uint32_t base, uint32_t shiftCount) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 755); } } while((_Bool)0); // // Write to CTRPHS // (*((volatile uint32_t *)(base + 0x2U))) = shiftCount; } //***************************************************************************** // //! Enable counter loading with phase shift value. //! //! \param base is the base address of the ECAP module. //! //! This function enables loading of the counter with the value present in the //! phase shift counter as defined by the ECAP_setPhaseShiftCount() function. //! //! \return None. // //***************************************************************************** static inline void ECAP_enableLoadCounter(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 778); } } while((_Bool)0); // // Write to SYNCI_EN // (*((volatile uint16_t *)(base + 0x15U))) |= 0x20U; } //***************************************************************************** // //! Disable counter loading with phase shift value. //! //! \param base is the base address of the ECAP module. //! //! This function disables loading of the counter with the value present in the //! phase shift counter as defined by the ECAP_setPhaseShiftCount() function. //! //! \return None. // //***************************************************************************** static inline void ECAP_disableLoadCounter(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 802); } } while((_Bool)0); // // Write to SYNCI_EN // (*((volatile uint16_t *)(base + 0x15U))) &= ~0x20U; } //***************************************************************************** // //! Load time stamp counter //! //! \param base is the base address of the ECAP module. //! //! This function forces the value in the phase shift counter register to be //! loaded into Time stamp counter register. //! Make sure to enable loading of Time stamp counter by calling //! ECAP_enableLoadCounter() function before calling this function. //! //! \return None. // //***************************************************************************** static inline void ECAP_loadCounter(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 827); } } while((_Bool)0); // // Write to SWSYNC // (*((volatile uint16_t *)(base + 0x15U))) |= 0x100U; } //***************************************************************************** // //! Configures Sync out signal mode. //! //! \param base is the base address of the ECAP module. //! \param mode is the sync out mode. //! //! This function sets the sync out mode. Valid parameters for mode are: //! - ECAP_SYNC_OUT_SYNCI - Trigger sync out on sync-in event. //! - ECAP_SYNC_OUT_COUNTER_PRD - Trigger sync out when counter equals period. //! - ECAP_SYNC_OUT_DISABLED - Disable sync out. //! //! \return None. // //***************************************************************************** static inline void ECAP_setSyncOutMode(uint32_t base, ECAP_SyncOutMode mode) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 854); } } while((_Bool)0); // // Write to SYNCO_SEL // (*((volatile uint16_t *)(base + 0x15U))) = (((*((volatile uint16_t *)(base + 0x15U))) & (~0xC0U)) | (uint16_t)mode); } //***************************************************************************** // //! Stops Time stamp counter. //! //! \param base is the base address of the ECAP module. //! //! This function stops the time stamp counter. //! //! \return None. // //***************************************************************************** static inline void ECAP_stopCounter(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 878); } } while((_Bool)0); // // Clear TSCTR // (*((volatile uint16_t *)(base + 0x15U))) &= ~0x10U; } //***************************************************************************** // //! Starts Time stamp counter. //! //! \param base is the base address of the ECAP module. //! //! This function starts the time stamp counter. //! //! \return None. // //***************************************************************************** static inline void ECAP_startCounter(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 900); } } while((_Bool)0); // // Set TSCTR // (*((volatile uint16_t *)(base + 0x15U))) |= 0x10U; } //***************************************************************************** // //! Set eCAP APWM polarity. //! //! \param base is the base address of the ECAP module. //! \param polarity is the polarity of APWM //! //! This function sets the polarity of the eCAP in APWM mode. Valid inputs for //! polarity are: //! - ECAP_APWM_ACTIVE_HIGH - For active high. //! - ECAP_APWM_ACTIVE_LOW - For active low. //! //! \return None. // //***************************************************************************** static inline void ECAP_setAPWMPolarity(uint32_t base, ECAP_APWMPolarity polarity) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 927); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x15U))) = (((*((volatile uint16_t *)(base + 0x15U))) & ~0x400U) | (uint16_t)polarity); } //***************************************************************************** // //! Set eCAP APWM period. //! //! \param base is the base address of the ECAP module. //! \param periodCount is the period count for APWM. //! //! This function sets the period count of the APWM waveform. //! periodCount takes the actual count which is written to the register. The //! user is responsible for converting the desired frequency or time into //! the period count. //! //! \return None. // //***************************************************************************** static inline void ECAP_setAPWMPeriod(uint32_t base, uint32_t periodCount) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 951); } } while((_Bool)0); // // Write to CAP1 // (*((volatile uint32_t *)(base + 0x4U))) = periodCount; } //***************************************************************************** // //! Set eCAP APWM on or off time count. //! //! \param base is the base address of the ECAP module. //! \param compareCount is the on or off count for APWM. //! //! This function sets the on or off time count of the APWM waveform depending //! on the polarity of the output. If the output , as set by //! ECAP_setAPWMPolarity(), is active high then compareCount determines the on //! time. If the output is active low then compareCount determines the off //! time. compareCount takes the actual count which is written to the register. //! The user is responsible for converting the desired frequency or time into //! the appropriate count value. //! //! \return None. // //***************************************************************************** static inline void ECAP_setAPWMCompare(uint32_t base, uint32_t compareCount) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 979); } } while((_Bool)0); // // Write to CAP2 // (*((volatile uint32_t *)(base + 0x6U))) = compareCount; } //***************************************************************************** // //! Load eCAP APWM shadow period. //! //! \param base is the base address of the ECAP module. //! \param periodCount is the shadow period count for APWM. //! //! This function sets the shadow period count of the APWM waveform. //! periodCount takes the actual count which is written to the register. The //! user is responsible for converting the desired frequency or time into //! the period count. //! //! \return None. // //***************************************************************************** static inline void ECAP_setAPWMShadowPeriod(uint32_t base, uint32_t periodCount) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 1005); } } while((_Bool)0); // // Write to CAP3 // (*((volatile uint32_t *)(base + 0x8U))) = periodCount; } //***************************************************************************** // //! Set eCAP APWM shadow on or off time count. //! //! \param base is the base address of the ECAP module. //! \param compareCount is the on or off count for APWM. //! //! This function sets the shadow on or off time count of the APWM waveform //! depending on the polarity of the output. If the output , as set by //! ECAP_setAPWMPolarity() , is active high then compareCount determines the //! on time. If the output is active low then compareCount determines the off //! time. compareCount takes the actual count which is written to the register. //! The user is responsible for converting the desired frequency or time into //! the appropriate count value. //! //! \return None. // //***************************************************************************** static inline void ECAP_setAPWMShadowCompare(uint32_t base, uint32_t compareCount) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 1034); } } while((_Bool)0); // // Write to CAP4 // (*((volatile uint32_t *)(base + 0xAU))) = compareCount; } //***************************************************************************** // //! Returns the time base counter value. //! //! \param base is the base address of the ECAP module. //! //! This function returns the time base counter value. //! //! \return Returns the time base counter value. // //***************************************************************************** static inline uint32_t ECAP_getTimeBaseCounter(uint32_t base) { do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 1055); } } while((_Bool)0); // // Read the Time base counter value // return((*((volatile uint32_t *)(base + 0x0U)))); } //***************************************************************************** // //! Returns event time stamp. //! //! \param base is the base address of the ECAP module. //! \param event is the event number. //! //! This function returns the current time stamp count of the given event. //! Valid values for event are \b ECAP_EVENT_1 to \b ECAP_EVENT_4. //! //! \return Event time stamp value or 0 if \e event is invalid. // //***************************************************************************** static inline uint32_t ECAP_getEventTimeStamp(uint32_t base, ECAP_Events event) { uint32_t count; do { if(!(ECAP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ecap.h", 1080); } } while((_Bool)0); switch(event) { case ECAP_EVENT_1: // // Read CAP1 register // count = (*((volatile uint32_t *)(base + 0x4U))); break; case ECAP_EVENT_2: // // Read CAP2 register // count = (*((volatile uint32_t *)(base + 0x6U))); break; case ECAP_EVENT_3: // // Read CAP3 register // count = (*((volatile uint32_t *)(base + 0x8U))); break; case ECAP_EVENT_4: // // Read CAP4 register // count = (*((volatile uint32_t *)(base + 0xAU))); break; default: // // Invalid event parameter // count = 0U; break; } return(count); } //***************************************************************************** // //! Configures emulation mode. //! //! \param base is the base address of the ECAP module. //! \param mode is the emulation mode. //! //! This function configures the eCAP counter, TSCTR, to the desired emulation //! mode when emulation suspension occurs. Valid inputs for mode are: //! - ECAP_EMULATION_STOP - Counter is stopped immediately. //! - ECAP_EMULATION_RUN_TO_ZERO - Counter runs till it reaches 0. //! - ECAP_EMULATION_FREE_RUN - Counter is not affected. //! //! \return None. // //***************************************************************************** extern void ECAP_setEmulationMode(uint32_t base, ECAP_EmulationMode mode); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: emif.h // // TITLE: C28x EMIF driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup emif_api EMIF //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_emif.h // // TITLE: Definitions for the EMIF registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the EMIF register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RCSR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ASYNC_WCCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDRAM_CR register // //************************************************************************************************* // is set. //************************************************************************************************* // // The following are defines for the bit fields in the SDRAM_RCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ASYNC_CS2_CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ASYNC_CS3_CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ASYNC_CS4_CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDRAM_TR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDR_EXT_TMNG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INT_RAW register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INT_MSK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INT_MSK_SET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INT_MSK_CLR register // //************************************************************************************************* //########################################################################### // // FILE: hw_memcfg.h // // TITLE: Definitions for the MEMCFG registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the MEMCFG register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DxLOCK register // //************************************************************************************************* // bit // bit //************************************************************************************************* // // The following are defines for the bit fields in the DxCOMMIT register // //************************************************************************************************* // lock // lock //************************************************************************************************* // // The following are defines for the bit fields in the DxACCPROT0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DxTEST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DxINIT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DxINITDONE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LSxLOCK register // //************************************************************************************************* // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit //************************************************************************************************* // // The following are defines for the bit fields in the LSxCOMMIT register // //************************************************************************************************* // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock //************************************************************************************************* // // The following are defines for the bit fields in the LSxMSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LSxCLAPGM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LSxACCPROT0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LSxACCPROT1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LSxTEST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LSxINIT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the LSxINITDONE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxLOCK register // //************************************************************************************************* // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit // lock bit //************************************************************************************************* // // The following are defines for the bit fields in the GSxCOMMIT register // //************************************************************************************************* // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock // permanent lock //************************************************************************************************* // // The following are defines for the bit fields in the GSxMSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxACCPROT0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxACCPROT1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxACCPROT2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxACCPROT3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxTEST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxINIT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GSxINITDONE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MSGxTEST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MSGxINIT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MSGxINITDONE register // //************************************************************************************************* // RAM // MSG RAM // MSG RAM //************************************************************************************************* // // The following are defines for the bit fields in the EMIF1LOCK register // //************************************************************************************************* // lock bit //************************************************************************************************* // // The following are defines for the bit fields in the EMIF1COMMIT register // //************************************************************************************************* // permanent lock //************************************************************************************************* // // The following are defines for the bit fields in the EMIF1MSEL register // //************************************************************************************************* // bits //************************************************************************************************* // // The following are defines for the bit fields in the EMIF1ACCPROT0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the EMIF2LOCK register // //************************************************************************************************* // lock //************************************************************************************************* // // The following are defines for the bit fields in the EMIF2COMMIT register // //************************************************************************************************* // permanent lock //************************************************************************************************* // // The following are defines for the bit fields in the EMIF2ACCPROT0 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMAVFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMAVSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMAVCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the NMAVINTEN register // //************************************************************************************************* // Enable // Enable // Enable // Enable // Enable // Enable // Enable //************************************************************************************************* // // The following are defines for the bit fields in the MAVFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MAVSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MAVCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MAVINTEN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the UCERRFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the UCERRSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the UCERRCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CERRFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CERRSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CERRCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CEINTFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CEINTCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CEINTSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CEINTEN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ROMWAITSTATE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ROMPREFETCH register // //************************************************************************************************* //***************************************************************************** // // Defines for the API. // //***************************************************************************** //***************************************************************************** // // Defines to specify access protection to EMIF_setAccessProtection(). // //***************************************************************************** //! This flag is used to specify whether CPU fetches are allowed/blocked //! for EMIF. //! This flag is used to specify whether CPU writes are allowed/blocked //! for EMIF. //! This flag is used to specify whether DMA writes are allowed/blocked //! for EMIF. It is valid only for EMIF1 instance. //***************************************************************************** // // Define to mask out the bits in the EMIF1ACCPROT0 register that aren't // associated with EMIF1 access protection. // //***************************************************************************** //***************************************************************************** // // Define to mask out the bits in the EMIF2ACCPROT0 register that aren't // associated with EMIF2 access protection. // //***************************************************************************** //***************************************************************************** // // Define to mask out the bits in the ASYNC_CSx_CR register that // aren't associated with async configuration. // //***************************************************************************** //***************************************************************************** // // Define to mask out the bits in the INT_MSK register that aren't associated // with interrupts. // //***************************************************************************** //***************************************************************************** // // Defines to specify interrupt sources to EMIF_enableAsyncInterrupt() and // EMIF_disableAsyncInterrupt().Three interrupts are available for asynchronous // memory interface: Masked Asyncronous Timeout(AT) to indicate EMxWAIT signal // remains active even after maximum wait cycles are reached. Masked Line Trap // (LT) to indicate illegal memory access or invalid cache line size. // Masked Wait Rise(WR) to indicate rising edge on EMxWAIT is detected. // //***************************************************************************** //! This flag is used to allow/block EMIF to generate Masked Asynchronous //! Timeout interrupt. //! This flag is used to allow/block EMIF to generate Masked Line Trap //! interrupt. //! This flag is used to allow/block EMIF to generate Masked Wait Rise //! interrupt. //***************************************************************************** // // Define for key for EMIF1MSEL register that enables the register write. // //***************************************************************************** //***************************************************************************** // // Define to mask out the bits in the SDRAM_CR register that aren't // associated with SDRAM configuration parameters. // //***************************************************************************** //***************************************************************************** // // Define to mask out the bits in the SDRAM_TR register that aren't // associated with SDRAM timings parameters. // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to EMIF_setAsyncMode(), //! EMIF_setAsyncTimingParams(), EMIF_setAsyncDataBusWidth(), //! EMIF_enableAsyncExtendedWait() and EMIF_disableAsyncExtendedWait() //! as the \e offset parameter. Three chip selects are available in //! asynchronous memory interface so there are three configuration registers //! available for each EMIF instance. All the three chip select offsets are //! valid for EMIF1 while only EMIF_ASYNC_CS2_OFFSET is valid for EMIF2. // //***************************************************************************** typedef enum { EMIF_ASYNC_CS2_OFFSET = 0x8U, //! It is valid only for EMIF1 instance and not for EMIF2 instance. //! Valid value for configBase parameter is EMIF1CONFIG_BASE. Valid //! values for select parameter can be \e EMIF_CONTROLLER_CPU1_NG, //! \e EMIF_CONTROLLER_CPU1_G, \e EMIF_CONTROLLER_CPU2_G or //! \e EMIF_CONTROLLER_CPU1_NG2. //! //! \return None. // //***************************************************************************** static inline void EMIF_selectController(uint32_t configBase, EMIF_ControllerSelect select) { // // Check the arguments. // do { if(!(EMIF_isEMIF1ConfigBaseValid(configBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 454); } } while((_Bool)0); // // Sets the bits that enables EMIF1 controller selection. // __eallow(); (*((volatile uint32_t *)(configBase + 0x4U))) = (0x93A5CE70U | (uint32_t)select); __edis(); } //***************************************************************************** // //! Sets the access protection. //! //! \param configBase is the configuration address of the EMIF instance used. //! //! \param access is the required access protection configuration. //! //! This function sets the access protection for an EMIF instance from CPU //! and DMA. The \e access parameter can be any of \b EMIF_ACCPROT0_FETCHPROT, //! \b EMIF_ACCPROT0_CPUWRPROT \b EMIF_ACCPROT0_DMAWRPROT values or their //! combination. EMIF_ACCPROT0_DMAWRPROT value is valid as access parameter //! for EMIF1 instance only . //! //! \return None. // //***************************************************************************** static inline void EMIF_setAccessProtection(uint32_t configBase, uint16_t access) { uint16_t temp; // // Check the arguments. // do { if(!(EMIF_isEMIF1ConfigBaseValid(configBase) || EMIF_isEMIF2ConfigBaseValid(configBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 490); } } while((_Bool)0); if(configBase == 0x0005F480U) { do { if(!(access <= ((uint16_t)0x1U | (uint16_t)0x2U | (uint16_t)0x4U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 493); } } while((_Bool)0); temp = ((uint16_t)0x1U | (uint16_t)0x2U | (uint16_t)0x4U); } else { do { if(!(access <= ((uint16_t)0x1U | (uint16_t)0x2U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 498); } } while((_Bool)0); temp = ((uint16_t)0x1U | (uint16_t)0x2U); } // // Sets the bits that enables access protection config. // __eallow(); (*((volatile uint16_t *)(configBase + 0x8U))) = ((*((volatile uint16_t *)(configBase + 0x8U))) & ~(temp)) | access; __edis(); } //***************************************************************************** // //! Commits the lock configuration. //! //! \param configBase is the configuration address of the EMIF instance used. //! //! This function commits the access protection for an EMIF instance from //! CPU & DMA. //! //! \return None. // //***************************************************************************** static inline void EMIF_commitAccessConfig(uint32_t configBase) { // // Check the arguments. // do { if(!(EMIF_isEMIF1ConfigBaseValid(configBase) || EMIF_isEMIF2ConfigBaseValid(configBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 530); } } while((_Bool)0); // // Sets the bits that commits access protection config. // __eallow(); (*((volatile uint16_t *)(configBase + 0x2U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Locks the write to access configuration fields. //! //! \param configBase is the configuration address of the EMIF instance used. //! //! This function locks the write to access configuration fields i.e //! ACCPROT0 & Mselect fields, for an EMIF instance. //! //! \return None. // //***************************************************************************** static inline void EMIF_lockAccessConfig(uint32_t configBase) { // // Check the arguments. // do { if(!(EMIF_isEMIF1ConfigBaseValid(configBase) || EMIF_isEMIF2ConfigBaseValid(configBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 560); } } while((_Bool)0); // // Sets the bits that locks access protection config. // __eallow(); (*((volatile uint16_t *)(configBase + 0x0U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Unlocks the write to access configuration fields. //! //! \param configBase is the configuration address of the EMIF instance used. //! //! This function unlocks the write to access configuration fields such as //! ACCPROT0 & Mselect fields, for an EMIF instance. //! //! \return None. // //***************************************************************************** static inline void EMIF_unlockAccessConfig(uint32_t configBase) { // // Check the arguments. // do { if(!(EMIF_isEMIF1ConfigBaseValid(configBase) || EMIF_isEMIF2ConfigBaseValid(configBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 589); } } while((_Bool)0); // // Sets the bits that unlocks access protection config. // __eallow(); (*((volatile uint16_t *)(configBase + 0x0U))) &= ~((uint16_t)0x1U); __edis(); } //***************************************************************************** // // Prototypes for Asynchronous Memory Interface // //***************************************************************************** //***************************************************************************** // //! Selects the asynchronous mode of operation. //! //! \param base is the base address of the EMIF instance used. //! //! \param offset is the offset of asynchronous chip select of EMIF instance. //! //! \param mode is the desired mode of operation for external memory. //! //! //! This function sets the mode of operation for asynchronous memory //! between Normal or Strobe mode. Valid values for param \e offset can be //! \e EMIF_ASYNC_CS2_OFFSET, \e EMIF_ASYNC_CS3_OFFSET & //! \e EMIF_ASYNC_C43_OFFSET for EMIF1 and \e EMIF_ASYNC_CS2_OFFSET for EMIF2. //! Valid values for param \e mode can be \e EMIF_ASYNC_STROBE_MODE or //! \e EMIF_ASYNC_NORMAL_MODE. //! //! \return None. // //***************************************************************************** static inline void EMIF_setAsyncMode(uint32_t base, EMIF_AsyncCSOffset offset, EMIF_AsyncMode mode) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 633); } } while((_Bool)0); if(base == 0x00047800U) { do { if(!(offset == EMIF_ASYNC_CS2_OFFSET)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 636); } } while((_Bool)0); } // // Sets the async mode of operation. // (*((volatile uint32_t *)(base + (uint32_t)offset))) = ((*((volatile uint32_t *)(base + (uint32_t)offset))) & ~((uint32_t)0x80000000U)) | (uint32_t)mode; } //***************************************************************************** // //! Enables the Extended Wait Mode. //! //! \param base is the base address of the EMIF instance used. //! //! \param offset is the offset of asynchronous chip select of the //! EMIF instance //! //! This function enables the extended wait mode for an asynchronous //! external memory.Valid values for param \e offset can be //! \e EMIF_ASYNC_CS2_OFFSET, \e EMIF_ASYNC_CS3_OFFSET & //! \e EMIF_ASYNC_C43_OFFSET for EMIF1 and \e EMIF_ASYNC_CS2_OFFSET for EMIF2. //! //! \return None. // //***************************************************************************** static inline void EMIF_enableAsyncExtendedWait(uint32_t base, EMIF_AsyncCSOffset offset) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 670); } } while((_Bool)0); if(base == 0x00047800U) { do { if(!(offset == EMIF_ASYNC_CS2_OFFSET)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 673); } } while((_Bool)0); } // // Sets the bit that enables extended wait mode. // (*((volatile uint32_t *)(base + (uint32_t)offset))) = (*((volatile uint32_t *)(base + (uint32_t)offset))) | 0x40000000U; } //***************************************************************************** // //! Disables the Extended Wait Mode. //! //! \param base is the base address of the EMIF instance used. //! //! \param offset is the offset of asynchronous chip select of EMIF instance. //! //! This function disables the extended wait mode for an asynchronous external //! memory.Valid values for param \e offset can be \e EMIF_ASYNC_CS2_OFFSET, //! \e EMIF_ASYNC_CS3_OFFSET & \e EMIF_ASYNC_C43_OFFSET for EMIF1 and //! \e EMIF_ASYNC_CS2_OFFSET for EMIF2. //! //! \return None. // //***************************************************************************** static inline void EMIF_disableAsyncExtendedWait(uint32_t base, EMIF_AsyncCSOffset offset) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 705); } } while((_Bool)0); if(base == 0x00047800U) { do { if(!(offset == EMIF_ASYNC_CS2_OFFSET)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 708); } } while((_Bool)0); } // // Sets the bit that disables extended wait mode. // (*((volatile uint32_t *)(base + (uint32_t)offset))) = (*((volatile uint32_t *)(base + (uint32_t)offset))) & ~((uint32_t)0x40000000U); } //***************************************************************************** // //! Sets the wait polarity. //! //! \param base is the base address of the EMIF instance used. //! //! \param polarity is desired wait polarity. //! //! This function sets the wait polarity for an asynchronous external memory. //! Valid values for param \e polarity can be \e EMIF_ASYNC_WAIT_POLARITY_LOW //! or \e EMIF_ASYNC_WAIT_POLARITY_HIGH. //! //! \return None. // //***************************************************************************** static inline void EMIF_setAsyncWaitPolarity(uint32_t base, EMIF_AsyncWaitPolarity polarity) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 739); } } while((_Bool)0); // // Sets the polarity for async extended wait mode. // (*((volatile uint32_t *)(base + 0x2U))) = ((*((volatile uint32_t *)(base + 0x2U))) & ~((uint32_t)0x10000000U)) | (uint32_t)polarity; } //***************************************************************************** // //! Sets the Maximum Wait Cycles. //! //! \param base is the base address of the EMIF instance used. //! //! \param value is the desired maximum wait cycles. //! //! This function sets the maximum wait cycles for extended asynchronous cycle. //! Valid values for parameter \e value lies b/w 0x0U-0xFFU or 0-255. //! //! \return None. // //***************************************************************************** static inline void EMIF_setAsyncMaximumWaitCycles(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 769); } } while((_Bool)0); do { if(!(value <= (0xFFU))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 770); } } while((_Bool)0); // // Sets the bit that enables extended wait mode. // (*((volatile uint16_t *)(base + 0x2U))) = ((*((volatile uint16_t *)(base + 0x2U))) & ~((uint16_t)0xFFU)) | value; } //***************************************************************************** // //! Sets the Asynchronous Memory Timing Characteristics. //! //! \param base is the base address of the EMIF instance used. //! //! \param offset is the offset of asynchronous chip select of EMIF instance. //! //! \param tParam is the desired timing parameters. //! //! This function sets timing characteristics for an external asynchronous //! memory to be interfaced. Valid values for param \e offset can be //! \e EMIF_ASYNC_CS2_OFFSET, \e EMIF_ASYNC_CS3_OFFSET and //! \e EMIF_ASYNC_C43_OFFSET for EMIF1 & EMIF_ASYNC_CS2_OFFSET for EMIF2. //! //! \return None. // //***************************************************************************** static inline void EMIF_setAsyncTimingParams(uint32_t base, EMIF_AsyncCSOffset offset, const EMIF_AsyncTimingParams *tParam) { uint32_t temp; // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 806); } } while((_Bool)0); if(base == 0x00047800U) { do { if(!(offset == EMIF_ASYNC_CS2_OFFSET)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 809); } } while((_Bool)0); } // // Sets the async memory timing parameters. // temp = (tParam->turnArnd << 2U) | (tParam->rHold << 4U) | (tParam->rStrobe << 7U) | (tParam->rSetup << 13U) | (tParam->wHold << 17U) | (tParam->wStrobe << 20U) | (tParam->wSetup << 26U); (*((volatile uint32_t *)(base + (uint32_t)offset))) = ((*((volatile uint32_t *)(base + (uint32_t)offset))) & ~((uint32_t)0x70U | (uint32_t)0x1F80U | (uint32_t)0x1E000U | (uint32_t)0xE0000U | (uint32_t)0x3F00000U | (uint32_t)0x3C000000U | (uint32_t)0xCU)) | temp; } //***************************************************************************** // //! Sets the Asynchronous Data Bus Width. //! //! \param base is the base address of the EMIF instance used. //! //! \param offset is the offset of asynchronous chip select of EMIF instance. //! //! \param width is the data bus width of the memory. //! //! This function sets the data bus size for an external asynchronous memory //! to be interfaced. Valid values for param \e offset can be //! \e EMIF_ASYNC_CS2_OFFSET, \e EMIF_ASYNC_CS3_OFFSET & //! \e EMIF_ASYNC_C43_OFFSET for EMIF1 and \e EMIF_ASYNC_CS2_OFFSET for EMIF2. //! Valid values of param \e width can be \e EMIF_ASYNC_DATA_WIDTH_8, //! \e EMIF_ASYNC_DATA_WIDTH_16 or \e EMIF_ASYNC_DATA_WIDTH_32. //! //! \return None. // //***************************************************************************** static inline void EMIF_setAsyncDataBusWidth(uint32_t base, EMIF_AsyncCSOffset offset, EMIF_AsyncDataWidth width) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 854); } } while((_Bool)0); if(base == 0x00047800U) { do { if(!(offset == EMIF_ASYNC_CS2_OFFSET)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 857); } } while((_Bool)0); } // // Sets the async memory data bus width. // (*((volatile uint16_t *)(base + (uint32_t)offset))) = ((*((volatile uint16_t *)(base + (uint32_t)offset))) & ~((uint16_t)0x3U)) | (uint32_t)width; } //***************************************************************************** // // Prototypes for Interrupt Handling // //***************************************************************************** //***************************************************************************** // //! Enables the Asynchronous Memory Interrupts. //! //! \param base is the base address of the EMIF instance used. //! //! \param intFlags is the mask for desired interrupts. //! //! This function enables the desired interrupts for an external asynchronous //! memory interface. Valid values for param \e intFlags can be //! \b EMIF_ASYNC_INT_AT, \b EMIF_ASYNC_INT_LT, \b EMIF_ASYNC_INT_WR or their //! combination. //! //! \return None. // //***************************************************************************** static inline void EMIF_enableAsyncInterrupt(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 895); } } while((_Bool)0); do { if(!(intFlags <= ((uint16_t)0x1U | (uint16_t)0x2U | (uint16_t)0x3CU))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 896); } } while((_Bool)0); // // Sets the bits that enables async memory interrupts. // (*((volatile uint16_t *)(base + 0x24U))) = intFlags; } //***************************************************************************** // //! Disables the Asynchronous Memory Interrupts. //! //! \param base is the base address of the EMIF instance used. //! //! \param intFlags is the mask for interrupts to be disabled. //! //! This function disables the desired interrupts for an external asynchronous //! memory interface. Valid values for param \e intFlags can be //! \b EMIF_ASYNC_INT_AT, \b EMIF_ASYNC_INT_LT, \b EMIF_ASYNC_INT_WR or //! their combination. //! //! \return None. // //***************************************************************************** static inline void EMIF_disableAsyncInterrupt(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 926); } } while((_Bool)0); do { if(!(intFlags <= ((uint16_t)0x1U | (uint16_t)0x2U | (uint16_t)0x3CU))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 927); } } while((_Bool)0); // // Sets the bits that disables async memory interrupts. // (*((volatile uint16_t *)(base + 0x26U))) = intFlags; } //***************************************************************************** // //! Gets the interrupt status. //! //! \param base is the base address of the EMIF instance used. //! //! This function gets the interrupt status for an EMIF instance. //! //! \return Returns the current interrupt status. // //***************************************************************************** static inline uint16_t EMIF_getAsyncInterruptStatus(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 953); } } while((_Bool)0); // // Gets the async memory interrupt status. // return((*((volatile uint16_t *)(base + 0x22U))) & ((uint16_t)0x1U | (uint16_t)0x2U | (uint16_t)0x3CU)); } //***************************************************************************** // //! Clears the interrupt status for an EMIF instance. //! //! \param base is the base address of the EMIF instance used. //! //! \param intFlags is the mask for the interrupt status to be cleared. //! //! This function clears the interrupt status for an EMIF instance. //! The \e intFlags parameter can be any of \b EMIF_INT_MSK_SET_AT_MASK_SET, //! \b EMIF_INT_MSK_SET_LT_MASK_SET, or \b EMIF_INT_MSK_SET_WR_MASK_SET_M //! values or their combination. //! //! \return None. // //***************************************************************************** static inline void EMIF_clearAsyncInterruptStatus(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 983); } } while((_Bool)0); do { if(!(intFlags <= ((uint16_t)0x1U | (uint16_t)0x2U | (uint16_t)0x3CU))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 984); } } while((_Bool)0); // // Sets the bit that clears desired async memory interrupts. // (*((volatile uint16_t *)(base + 0x22U))) = intFlags; } //***************************************************************************** // // Prototypes for Synchronous Memory Interface // //***************************************************************************** //***************************************************************************** // //! Sets the Synchronous Memory Timing Parameters. //! //! \param base is the base address of an EMIF instance. //! //! \param tParam is parameters from memory datasheet in \e ns. //! //! This function sets the timing characteristics for an external //! synchronous memory to be interfaced. //! //! \return None. // //***************************************************************************** static inline void EMIF_setSyncTimingParams(uint32_t base, const EMIF_SyncTimingParams *tParam) { uint32_t temp; // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1018); } } while((_Bool)0); // // Sets sync memory timing parameters. // temp = ((tParam->tRrd << 4U) & 0x70U) | ((tParam->tRc << 8U) & 0xF00U) | ((tParam->tRas << 12U) & 0xF000U) | ((tParam->tWr << 16U) & 0x70000U) | ((tParam->tRcd << 20U) & 0x700000U) | ((tParam->tRp << 24U) & 0x7000000U) | ((tParam->tRfc << 27U) & 0xF8000000U); (*((volatile uint32_t *)(base + 0x10U))) = ((*((volatile uint32_t *)(base + 0x10U))) & ~((uint32_t)0x70U | (uint32_t)0xF00U | (uint32_t)0xF000U | (uint32_t)0x70000U | (uint32_t)0x700000U | (uint32_t)0x7000000U | (uint32_t)0xF8000000U)) | temp; } //***************************************************************************** // //! Sets the SDRAM Self Refresh Exit Timing. //! //! \param base is the base address of an EMIF instance. //! //! \param tXs is the desired timing value. //! //! This function sets the self refresh exit timing for an external //! synchronous memory to be interfaced. tXs values must lie between //! 0x0U-0x1FU or 0-31. //! //! \return None. // //***************************************************************************** static inline void EMIF_setSyncSelfRefreshExitTmng(uint32_t base, uint16_t tXs) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1063); } } while((_Bool)0); do { if(!(tXs <= 0x1FU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1064); } } while((_Bool)0); // // Sets the self refresh exit timing for sync memory. // (*((volatile uint16_t *)(base + 0x1EU))) = ((*((volatile uint16_t *)(base + 0x1EU))) & ~((uint16_t)0x1FU)) | tXs; } //***************************************************************************** // //! Sets the SDR Refresh Rate. //! //! \param base is the base address of an EMIF instance. //! //! \param refRate is the refresh rate. //! //! This function sets the refresh rate for an external synchronous memory //! to be interfaced. Valid values for refRate lies b/w 0x0U-0x1FFFU or //! 0-8191. //! //! \return None. // //***************************************************************************** static inline void EMIF_setSyncRefreshRate(uint32_t base, uint16_t refRate) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1095); } } while((_Bool)0); do { if(!(refRate <= 0x1FFFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1096); } } while((_Bool)0); // // Sets the sync memory refresh rate. // (*((volatile uint16_t *)(base + 0x6U))) = ((*((volatile uint16_t *)(base + 0x6U))) & (~(uint16_t)0x1FFFU)) | refRate; } //***************************************************************************** // //! Sets the Synchronous Memory configuration parameters. //! //! \param base is the base address of the EMIF instance used. //! //! \param config is the desired configuration parameters. //! //! This function sets configuration parameters like CL, NM, IBANK //! and PAGESIZE for an external synchronous memory to be interfaced. //! //! \return None. // //***************************************************************************** static inline void EMIF_setSyncMemoryConfig(uint32_t base, const EMIF_SyncConfig *config) { uint32_t temp; // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1127); } } while((_Bool)0); // // Sets the sync memory configuration bits. // temp = ((uint32_t)config->casLatency | (uint32_t)config->iBank | (uint32_t)config->narrowMode | (uint32_t)config->pageSize); (*((volatile uint32_t *)(base + 0x4U))) = ((*((volatile uint32_t *)(base + 0x4U))) & ~((uint32_t)0x7U | (uint32_t)0x70U | (uint32_t)0x100U | (uint32_t)0xE00U | (uint32_t)0x4000U | (uint32_t)0x80000000U)) | temp; } //***************************************************************************** // // Prototypes for EMIF Low Power Modes // //***************************************************************************** //***************************************************************************** // //! Enables Self Refresh. //! //! \param base is the base address of the EMIF instance used. //! //! This function enables Self Refresh Mode for EMIF. //! //! \return None. // //***************************************************************************** static inline void EMIF_enableSyncSelfRefresh(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1161); } } while((_Bool)0); // // Sets the bits that enables sync memory self refresh mode. // (*((volatile uint32_t *)(base + 0x4U))) |= 0x80000000U; } //***************************************************************************** // //! Disables Self Refresh. //! //! \param base is the base address of the EMIF instance used. //! //! This function disables Self Refresh Mode for EMIF. //! //! \return None. // //***************************************************************************** static inline void EMIF_disableSyncSelfRefresh(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1186); } } while((_Bool)0); // // Sets the bits that disables sync memory self refresh mode. // (*((volatile uint32_t *)(base + 0x4U))) &= ~((uint32_t)0x80000000U); } //***************************************************************************** // //! Enables Power Down. //! //! \param base is the base address of the EMIF instance used. //! //! This function Enables Power Down Mode for synchronous memory //! to be interfaced. //! //! \return None. // //***************************************************************************** static inline void EMIF_enableSyncPowerDown(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1212); } } while((_Bool)0); // // Sets the bits that enables sync memory power down mode. // (*((volatile uint32_t *)(base + 0x4U))) |= 0x40000000U; } //***************************************************************************** // //! Disables Power Down. //! //! \param base is the base address of the EMIF instance used. //! //! This function disables Power Down Mode for synchronous memory //! to be interfaced. //! //! \return None. // //***************************************************************************** static inline void EMIF_disableSyncPowerDown(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1238); } } while((_Bool)0); // // Sets the bits that disables sync memory power down mode. // (*((volatile uint32_t *)(base + 0x4U))) &= ~((uint32_t)0x40000000U); } //***************************************************************************** // //! Enables Refresh in Power Down. //! //! \param base is the base address of the EMIF instance used. //! //! This function enables Refresh in Power Down Mode for synchronous memory //! to be interfaced. //! //! \return None. // //***************************************************************************** static inline void EMIF_enableSyncRefreshInPowerDown(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1264); } } while((_Bool)0); // // Sets the bits that enables refresh in power down mode. // (*((volatile uint32_t *)(base + 0x4U))) |= 0x20000000U; } //***************************************************************************** // //! Disables Refresh in Power Down. //! //! \param base is the base address of the EMIF instance used. //! //! This function disables Refresh in Power Down Mode for synchronous memory //! to be interfaced. //! //! \return None. // //***************************************************************************** static inline void EMIF_disableSyncRefreshInPowerDown(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1290); } } while((_Bool)0); // // Sets the bits that disables refresh in power down mode. // (*((volatile uint32_t *)(base + 0x4U))) &= ~((uint32_t)0x20000000U); } //***************************************************************************** // //! Gets total number of SDRAM accesses. //! //! \param base is the base address of the EMIF instance used. //! //! This function returns total number of SDRAM accesses //! from a controller(CPUx/CPUx.DMA). //! //! \return \e Returns total number of accesses to SDRAM. // //***************************************************************************** static inline uint32_t EMIF_getSyncTotalAccesses(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1316); } } while((_Bool)0); // // Gets total accesses to sync memory. // return((*((volatile uint32_t *)(base + 0x18U)))); } //***************************************************************************** // //! Gets total number of SDRAM accesses which require activate command. //! //! \param base is the base address of the EMIF instance used. //! //! This function returns total number of accesses to SDRAM which //! require activate command. //! //!\return \e Returns total number of accesses to SDRAM which require activate. // //***************************************************************************** static inline uint32_t EMIF_getSyncTotalActivateAccesses(uint32_t base) { // // Check the arguments. // do { if(!(EMIF_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/emif.h", 1343); } } while((_Bool)0); // // Gets total accesses to sync memory which requires activate command. // return((*((volatile uint32_t *)(base + 0x1AU)))); } //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //############################################################################# // // FILE: epwm.h // // TITLE: C28x EPWM Driver // //############################################################################# // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //############################################################################# //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup epwm_api ePWM //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_epwm.h // // TITLE: Definitions for the EPWM registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the EPWM register offsets // //************************************************************************************************* // Mirror Register // Mirror Register // Register //************************************************************************************************* // // The following are defines for the bit fields in the TBCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TBCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TBSTS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQTSRCSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the VCAPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the VCNTCFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRCNFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRPWR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRMSTEP register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRCNFG2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRREM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GLDCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GLDCFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the EPWMXLINK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLA2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLB2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQSFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCSFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBREDHR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBRED register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBFEDHR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBFED register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TBPHS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GLDCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZDCSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCTLDCA register // //************************************************************************************************* // DOWN // DOWN //************************************************************************************************* // // The following are defines for the bit fields in the TZCTLDCB register // //************************************************************************************************* // DOWN // DOWN //************************************************************************************************* // // The following are defines for the bit fields in the TZEINT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCBCFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZOSTFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCBCCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZOSTCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETPS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETINTPS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETSOCPS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETCNTINITCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETCNTINIT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCACTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCBCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCFCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCCAPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCAHTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCALTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCBHTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCBLTRIPSEL register // //************************************************************************************************* // // Time Base Module // //***************************************************************************** // //! Values that can be passed to EPWM_setEmulationMode() as the //! \e emulationMode parameter. // //***************************************************************************** typedef enum { //! Stop after next Time Base counter increment or decrement EPWM_EMULATION_STOP_AFTER_NEXT_TB = 0, //! Stop when counter completes whole cycle EPWM_EMULATION_STOP_AFTER_FULL_CYCLE = 1, //! Free run EPWM_EMULATION_FREE_RUN = 2 } EPWM_EmulationMode; //***************************************************************************** // //! Values that can be passed to EPWM_setCountModeAfterSync() as the //! \e mode parameter. // //***************************************************************************** typedef enum { EPWM_COUNT_MODE_DOWN_AFTER_SYNC = 0, //!< Count down after sync event EPWM_COUNT_MODE_UP_AFTER_SYNC = 1 //!< Count up after sync event } EPWM_SyncCountMode; //***************************************************************************** // //! Values that can be passed to EPWM_setClockPrescaler() as the //! \e prescaler parameter. // //***************************************************************************** typedef enum { EPWM_CLOCK_DIVIDER_1 = 0, //!< Divide clock by 1 EPWM_CLOCK_DIVIDER_2 = 1, //!< Divide clock by 2 EPWM_CLOCK_DIVIDER_4 = 2, //!< Divide clock by 4 EPWM_CLOCK_DIVIDER_8 = 3, //!< Divide clock by 8 EPWM_CLOCK_DIVIDER_16 = 4, //!< Divide clock by 16 EPWM_CLOCK_DIVIDER_32 = 5, //!< Divide clock by 32 EPWM_CLOCK_DIVIDER_64 = 6, //!< Divide clock by 64 EPWM_CLOCK_DIVIDER_128 = 7 //!< Divide clock by 128 } EPWM_ClockDivider; //***************************************************************************** // //! Values that can be passed to EPWM_setClockPrescaler() as the //! \e highSpeedPrescaler parameter. // //***************************************************************************** typedef enum { EPWM_HSCLOCK_DIVIDER_1 = 0, //!< Divide clock by 1 EPWM_HSCLOCK_DIVIDER_2 = 1, //!< Divide clock by 2 EPWM_HSCLOCK_DIVIDER_4 = 2, //!< Divide clock by 4 EPWM_HSCLOCK_DIVIDER_6 = 3, //!< Divide clock by 6 EPWM_HSCLOCK_DIVIDER_8 = 4, //!< Divide clock by 8 EPWM_HSCLOCK_DIVIDER_10 = 5, //!< Divide clock by 10 EPWM_HSCLOCK_DIVIDER_12 = 6, //!< Divide clock by 12 EPWM_HSCLOCK_DIVIDER_14 = 7 //!< Divide clock by 14 } EPWM_HSClockDivider; //***************************************************************************** // //! Values that can be passed to EPWM_setSyncOutPulseMode() as the \e mode //! parameter. // //***************************************************************************** typedef enum { //! Sync pulse is generated by software EPWM_SYNC_OUT_PULSE_ON_SOFTWARE = 0, //! Sync pulse is passed from EPWMxSYNCIN EPWM_SYNC_OUT_PULSE_ON_EPWMxSYNCIN = 0, //! Sync pulse is generated when time base counter equals zero EPWM_SYNC_OUT_PULSE_ON_COUNTER_ZERO = 1, //! Sync pulse is generated when time base counter equals compare B value EPWM_SYNC_OUT_PULSE_ON_COUNTER_COMPARE_B = 2, //! Sync pulse is disabled EPWM_SYNC_OUT_PULSE_DISABLED = 4, //! Sync pulse is generated when time base counter equals compare C value EPWM_SYNC_OUT_PULSE_ON_COUNTER_COMPARE_C = 5, //! Sync pulse is generated when time base counter equals compare D value EPWM_SYNC_OUT_PULSE_ON_COUNTER_COMPARE_D = 6 } EPWM_SyncOutPulseMode; //***************************************************************************** // //! Values that can be passed to EPWM_setPeriodLoadMode() as the //! \e loadMode parameter. // //***************************************************************************** typedef enum { //! PWM Period register access is through shadow register EPWM_PERIOD_SHADOW_LOAD = 0, //! PWM Period register access is directly EPWM_PERIOD_DIRECT_LOAD = 1 } EPWM_PeriodLoadMode; //***************************************************************************** // //! Values that can be passed to EPWM_setTimeBaseCounterMode() as the //! \e counterMode parameter. // //***************************************************************************** typedef enum { EPWM_COUNTER_MODE_UP = 0, //!< Up - count mode EPWM_COUNTER_MODE_DOWN = 1, //!< Down - count mode EPWM_COUNTER_MODE_UP_DOWN = 2, //!< Up - down - count mode EPWM_COUNTER_MODE_STOP_FREEZE = 3 //!< Stop - Freeze counter } EPWM_TimeBaseCountMode; //***************************************************************************** // //! Values that can be passed to EPWM_selectPeriodLoadEvent() as the //! \e shadowLoadMode parameter. // //***************************************************************************** typedef enum { //! Shadow to active load occurs when time base counter reaches 0 EPWM_SHADOW_LOAD_MODE_COUNTER_ZERO = 0, //! Shadow to active load occurs when time base counter reaches 0 and a //! SYNC occurs EPWM_SHADOW_LOAD_MODE_COUNTER_SYNC = 1, //! Shadow to active load occurs only when a SYNC occurs EPWM_SHADOW_LOAD_MODE_SYNC = 2 } EPWM_PeriodShadowLoadMode; //***************************************************************************** // // Values that can be returned by the EPWM_getTimeBaseCounterDirection() // //***************************************************************************** //! Time base counter is counting up //! //! Time base counter is counting down //! //***************************************************************************** // //! Values that can be passed to EPWM_setupEPWMLinks() as the \e epwmLink //! parameter. // //***************************************************************************** typedef enum { EPWM_LINK_WITH_EPWM_1 = 0, //!< link current ePWM with ePWM1 EPWM_LINK_WITH_EPWM_2 = 1, //!< link current ePWM with ePWM2 EPWM_LINK_WITH_EPWM_3 = 2, //!< link current ePWM with ePWM3 EPWM_LINK_WITH_EPWM_4 = 3, //!< link current ePWM with ePWM4 EPWM_LINK_WITH_EPWM_5 = 4, //!< link current ePWM with ePWM5 EPWM_LINK_WITH_EPWM_6 = 5, //!< link current ePWM with ePWM6 EPWM_LINK_WITH_EPWM_7 = 6, //!< link current ePWM with ePWM7 EPWM_LINK_WITH_EPWM_8 = 7, //!< link current ePWM with ePWM8 EPWM_LINK_WITH_EPWM_9 = 8, //!< link current ePWM with ePWM9 EPWM_LINK_WITH_EPWM_10 = 9, //!< link current ePWM with ePWM10 EPWM_LINK_WITH_EPWM_11 = 10, //!< link current ePWM with ePWM11 EPWM_LINK_WITH_EPWM_12 = 11 //!< link current ePWM with ePWM12 } EPWM_CurrentLink; //***************************************************************************** // //! Values that can be passed to EPWM_setupEPWMLinks() as the \e linkComp //! parameter. // //***************************************************************************** typedef enum { EPWM_LINK_TBPRD = 0U, //!< link TBPRD registers EPWM_LINK_COMP_A = 4U, //!< link COMPA registers EPWM_LINK_COMP_B = 8U, //!< link COMPB registers EPWM_LINK_COMP_C = 12U, //!< link COMPC registers EPWM_LINK_COMP_D = 16U, //!< link COMPD registers EPWM_LINK_GLDCTL2 = 28U //!< link GLDCTL2 registers } EPWM_LinkComponent; // // Counter Compare Module // //***************************************************************************** // //! Values that can be passed to the EPWM_getCounterCompareShadowStatus(), //! EPWM_setCounterCompareValue(), EPWM_setCounterCompareShadowLoadMode(), //! EPWM_disableCounterCompareShadowLoadMode() //! as the \e compModule parameter. // //***************************************************************************** typedef enum { EPWM_COUNTER_COMPARE_A = 0, //!< Counter compare A EPWM_COUNTER_COMPARE_B = 2, //!< Counter compare B EPWM_COUNTER_COMPARE_C = 5, //!< Counter compare C EPWM_COUNTER_COMPARE_D = 7 //!< Counter compare D } EPWM_CounterCompareModule; //***************************************************************************** // //! Values that can be passed to EPWM_setCounterCompareShadowLoadMode() as the //! \e loadMode parameter. // //***************************************************************************** typedef enum { //! Load when counter equals zero EPWM_COMP_LOAD_ON_CNTR_ZERO = 0, //! Load when counter equals period EPWM_COMP_LOAD_ON_CNTR_PERIOD = 1, //! Load when counter equals zero or period EPWM_COMP_LOAD_ON_CNTR_ZERO_PERIOD = 2, //! Freeze shadow to active load EPWM_COMP_LOAD_FREEZE = 3, //! Load on sync or when counter equals zero EPWM_COMP_LOAD_ON_SYNC_CNTR_ZERO = 4, //! Load on sync or when counter equals period EPWM_COMP_LOAD_ON_SYNC_CNTR_PERIOD = 5, //! Load on sync or when counter equals zero or period EPWM_COMP_LOAD_ON_SYNC_CNTR_ZERO_PERIOD = 6, //! Load on sync only EPWM_COMP_LOAD_ON_SYNC_ONLY = 8 } EPWM_CounterCompareLoadMode; // // Action Qualifier Module // //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierShadowLoadMode() and //! EPWM_disableActionQualifierShadowLoadMode() as the \e aqModule parameter. // //***************************************************************************** typedef enum { EPWM_ACTION_QUALIFIER_A = 0, //!< Action Qualifier A EPWM_ACTION_QUALIFIER_B = 2 //!< Action Qualifier B } EPWM_ActionQualifierModule; //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierShadowLoadMode() as the //! \e loadMode parameter. // //***************************************************************************** typedef enum { //! Load when counter equals zero EPWM_AQ_LOAD_ON_CNTR_ZERO = 0, //! Load when counter equals period EPWM_AQ_LOAD_ON_CNTR_PERIOD = 1, //! Load when counter equals zero or period EPWM_AQ_LOAD_ON_CNTR_ZERO_PERIOD = 2, //! Freeze shadow to active load EPWM_AQ_LOAD_FREEZE = 3, //! Load on sync or when counter equals zero EPWM_AQ_LOAD_ON_SYNC_CNTR_ZERO = 4, //! Load on sync or when counter equals period EPWM_AQ_LOAD_ON_SYNC_CNTR_PERIOD = 5, //! Load on sync or when counter equals zero or period EPWM_AQ_LOAD_ON_SYNC_CNTR_ZERO_PERIOD = 6, //! Load on sync only EPWM_AQ_LOAD_ON_SYNC_ONLY = 8 } EPWM_ActionQualifierLoadMode; //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierT1TriggerSource() and //! EPWM_setActionQualifierT2TriggerSource() as the \e trigger parameter. // //***************************************************************************** typedef enum { EPWM_AQ_TRIGGER_EVENT_TRIG_DCA_1 = 0, //!< Digital compare event A 1 EPWM_AQ_TRIGGER_EVENT_TRIG_DCA_2 = 1, //!< Digital compare event A 2 EPWM_AQ_TRIGGER_EVENT_TRIG_DCB_1 = 2, //!< Digital compare event B 1 EPWM_AQ_TRIGGER_EVENT_TRIG_DCB_2 = 3, //!< Digital compare event B 2 EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_1 = 4, //!< Trip zone 1 EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_2 = 5, //!< Trip zone 2 EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_3 = 6, //!< Trip zone 3 EPWM_AQ_TRIGGER_EVENT_TRIG_EPWM_SYNCIN = 7 //!< ePWM sync } EPWM_ActionQualifierTriggerSource; //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierAction() as the \e //! event parameter. // //***************************************************************************** typedef enum { //! Time base counter equals zero EPWM_AQ_OUTPUT_ON_TIMEBASE_ZERO = 0, //! Time base counter equals period EPWM_AQ_OUTPUT_ON_TIMEBASE_PERIOD = 2, //! Time base counter up equals COMPA EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA = 4, //! Time base counter down equals COMPA EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA = 6, //! Time base counter up equals COMPB EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPB = 8, //! Time base counter down equals COMPB EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPB = 10, //! T1 event on count up EPWM_AQ_OUTPUT_ON_T1_COUNT_UP = 1, //! T1 event on count down EPWM_AQ_OUTPUT_ON_T1_COUNT_DOWN = 3, //! T2 event on count up EPWM_AQ_OUTPUT_ON_T2_COUNT_UP = 5, //! T2 event on count down EPWM_AQ_OUTPUT_ON_T2_COUNT_DOWN = 7 } EPWM_ActionQualifierOutputEvent; //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierSWAction(), //! EPWM_setActionQualifierAction() as the \e outPut parameter. // //***************************************************************************** typedef enum { EPWM_AQ_OUTPUT_NO_CHANGE = 0, //!< No change in the output pins EPWM_AQ_OUTPUT_LOW = 1, //!< Set output pins to low EPWM_AQ_OUTPUT_HIGH = 2, //!< Set output pins to High EPWM_AQ_OUTPUT_TOGGLE = 3 //!< Toggle the output pins } EPWM_ActionQualifierOutput; //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierContSWForceAction() //! as the \e outPut parameter. // //***************************************************************************** typedef enum { EPWM_AQ_SW_DISABLED = 0, //!< Software forcing disabled EPWM_AQ_SW_OUTPUT_LOW = 1, //!< Set output pins to low EPWM_AQ_SW_OUTPUT_HIGH = 2 //!< Set output pins to High } EPWM_ActionQualifierSWOutput; //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierActionComplete() //! as the \e action parameter. // //***************************************************************************** typedef enum { //! Time base counter equals zero and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_ZERO = 0x0, //! Time base counter equals zero and set output pins to low EPWM_AQ_OUTPUT_LOW_ZERO = 0x1, //! Time base counter equals zero and set output pins to high EPWM_AQ_OUTPUT_HIGH_ZERO = 0x2, //! Time base counter equals zero and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_ZERO = 0x3, //! Time base counter equals period and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_PERIOD = 0x0, //! Time base counter equals period and set output pins to low EPWM_AQ_OUTPUT_LOW_PERIOD = 0x4, //! Time base counter equals period and set output pins to high EPWM_AQ_OUTPUT_HIGH_PERIOD = 0x8, //! Time base counter equals period and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_PERIOD = 0xC, //! Time base counter up equals COMPA and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_UP_CMPA = 0x00, //! Time base counter up equals COMPA and set output pins to low EPWM_AQ_OUTPUT_LOW_UP_CMPA = 0x10, //! Time base counter up equals COMPA and set output pins to high EPWM_AQ_OUTPUT_HIGH_UP_CMPA = 0x20, //! Time base counter up equals COMPA and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_UP_CMPA = 0x30, //! Time base counter down equals COMPA and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_CMPA = 0x00, //! Time base counter down equals COMPA and set output pins to low EPWM_AQ_OUTPUT_LOW_DOWN_CMPA = 0x40, //! Time base counter down equals COMPA and set output pins to high EPWM_AQ_OUTPUT_HIGH_DOWN_CMPA = 0x80, //! Time base counter down equals COMPA and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_DOWN_CMPA = 0xC0, //! Time base counter up equals COMPB and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_UP_CMPB = 0x000, //! Time base counter up equals COMPB and set output pins to low EPWM_AQ_OUTPUT_LOW_UP_CMPB = 0x100, //! Time base counter up equals COMPB and set output pins to high EPWM_AQ_OUTPUT_HIGH_UP_CMPB = 0x200, //! Time base counter up equals COMPB and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_UP_CMPB = 0x300, //! Time base counter down equals COMPB and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_CMPB = 0x000, //! Time base counter down equals COMPB and set output pins to low EPWM_AQ_OUTPUT_LOW_DOWN_CMPB = 0x400, //! Time base counter down equals COMPB and set output pins to high EPWM_AQ_OUTPUT_HIGH_DOWN_CMPB = 0x800, //! Time base counter down equals COMPB and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_DOWN_CMPB = 0xC00 } EPWM_ActionQualifierEventAction; //***************************************************************************** // //! Values that can be passed to //! EPWM_setAdditionalActionQualifierActionComplete() as the \e action //! parameter. // //***************************************************************************** typedef enum { //! T1 event on count up and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_UP_T1 = 0x0, //! T1 event on count up and set output pins to low EPWM_AQ_OUTPUT_LOW_UP_T1 = 0x1, //! T1 event on count up and set output pins to high EPWM_AQ_OUTPUT_HIGH_UP_T1 = 0x2, //! T1 event on count up and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_UP_T1 = 0x3, //! T1 event on count down and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_T1 = 0x0, //! T1 event on count down and set output pins to low EPWM_AQ_OUTPUT_LOW_DOWN_T1 = 0x4, //! T1 event on count down and set output pins to high EPWM_AQ_OUTPUT_HIGH_DOWN_T1 = 0x8, //! T1 event on count down and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_DOWN_T1 = 0xC, //! T2 event on count up and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_UP_T2 = 0x00, //! T2 event on count up and set output pins to low EPWM_AQ_OUTPUT_LOW_UP_T2 = 0x10, //! T2 event on count up and set output pins to high EPWM_AQ_OUTPUT_HIGH_UP_T2 = 0x20, //! T2 event on count up and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_UP_T2 = 0x30, //! T2 event on count down and no change in the output pins EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_T2 = 0x00, //! T2 event on count down and set output pins to low EPWM_AQ_OUTPUT_LOW_DOWN_T2 = 0x40, //! T2 event on count down and set output pins to high EPWM_AQ_OUTPUT_HIGH_DOWN_T2 = 0x80, //! T2 event on count down and toggle the output pins EPWM_AQ_OUTPUT_TOGGLE_DOWN_T2 = 0xC0 } EPWM_AdditionalActionQualifierEventAction; //***************************************************************************** // //! Values that can be passed to EPWM_forceActionQualifierSWAction(), //! EPWM_setActionQualifierSWAction(), EPWM_setActionQualifierAction() //! EPWM_setActionQualifierContSWForceAction() as the \e epwmOutput parameter. // //***************************************************************************** typedef enum { EPWM_AQ_OUTPUT_A = 0, //!< ePWMxA output EPWM_AQ_OUTPUT_B = 2 //!< ePWMxB output } EPWM_ActionQualifierOutputModule; //***************************************************************************** // //! Values that can be passed to EPWM_setActionQualifierContSWForceShadowMode() //! as the \e mode parameter. // //***************************************************************************** typedef enum { //! Shadow mode load when counter equals zero EPWM_AQ_SW_SH_LOAD_ON_CNTR_ZERO = 0, //! Shadow mode load when counter equals period EPWM_AQ_SW_SH_LOAD_ON_CNTR_PERIOD = 1, //! Shadow mode load when counter equals zero or period EPWM_AQ_SW_SH_LOAD_ON_CNTR_ZERO_PERIOD = 2, //! No shadow load mode. Immediate mode only. EPWM_AQ_SW_IMMEDIATE_LOAD = 3 } EPWM_ActionQualifierContForce; //***************************************************************************** // //! Values that can be passed to EPWM_setDeadBandOutputSwapMode() //! as the \e output parameter. // //***************************************************************************** typedef enum { EPWM_DB_OUTPUT_A = 1, //!< DB output is ePWMA EPWM_DB_OUTPUT_B = 0 //!< DB output is ePWMB } EPWM_DeadBandOutput; //***************************************************************************** // //! Values that can be passed to EPWM_setDeadBandDelayPolarity(), //! EPWM_setDeadBandDelayMode() as the \e delayMode parameter. // //***************************************************************************** typedef enum { EPWM_DB_RED = 1, //!< DB RED (Rising Edge Delay) mode EPWM_DB_FED = 0 //!< DB FED (Falling Edge Delay) mode } EPWM_DeadBandDelayMode; //***************************************************************************** // //! Values that can be passed to EPWM_setDeadBandDelayPolarity as the //! \e polarity parameter. // //***************************************************************************** typedef enum { EPWM_DB_POLARITY_ACTIVE_HIGH = 0, //!< DB polarity is not inverted EPWM_DB_POLARITY_ACTIVE_LOW = 1 //!< DB polarity is inverted } EPWM_DeadBandPolarity; //***************************************************************************** // // Values that can be passed to EPWM_setRisingEdgeDeadBandDelayInput(), // EPWM_setFallingEdgeDeadBandDelayInput() as the input parameter. // //***************************************************************************** //! Input signal is ePWMA //! //! Input signal is ePWMB //! //! Input signal is the output of Rising Edge delay //! //***************************************************************************** // //! Values that can be passed to EPWM_setDeadBandControlShadowLoadMode() as //! the \e loadMode parameter. // //***************************************************************************** typedef enum { //! Load when counter equals zero EPWM_DB_LOAD_ON_CNTR_ZERO = 0, //! Load when counter equals period EPWM_DB_LOAD_ON_CNTR_PERIOD = 1, //! Load when counter equals zero or period EPWM_DB_LOAD_ON_CNTR_ZERO_PERIOD = 2, //! Freeze shadow to active load EPWM_DB_LOAD_FREEZE = 3 } EPWM_DeadBandControlLoadMode; //***************************************************************************** // //! Values that can be passed to EPWM_setRisingEdgeDelayCountShadowLoadMode() //! as the \e loadMode parameter. // //***************************************************************************** typedef enum { //! Load when counter equals zero EPWM_RED_LOAD_ON_CNTR_ZERO = 0, //! Load when counter equals period EPWM_RED_LOAD_ON_CNTR_PERIOD = 1, //! Load when counter equals zero or period EPWM_RED_LOAD_ON_CNTR_ZERO_PERIOD = 2, //! Freeze shadow to active load EPWM_RED_LOAD_FREEZE = 3 } EPWM_RisingEdgeDelayLoadMode; //***************************************************************************** // //! Values that can be passed to EPWM_setFallingEdgeDelayCountShadowLoadMode() //! as the \e loadMode parameter. // //***************************************************************************** typedef enum { //! Load when counter equals zero EPWM_FED_LOAD_ON_CNTR_ZERO = 0, //! Load when counter equals period EPWM_FED_LOAD_ON_CNTR_PERIOD = 1, //! Load when counter equals zero or period EPWM_FED_LOAD_ON_CNTR_ZERO_PERIOD = 2, //! Freeze shadow to active load EPWM_FED_LOAD_FREEZE = 3 } EPWM_FallingEdgeDelayLoadMode; //***************************************************************************** // //! Values that can be passed to EPWM_setDeadBandCounterClock() as the //! \e clockMode parameter. // //***************************************************************************** typedef enum { //! Dead band counter runs at TBCLK rate EPWM_DB_COUNTER_CLOCK_FULL_CYCLE = 0, //! Dead band counter runs at 2*TBCLK rate EPWM_DB_COUNTER_CLOCK_HALF_CYCLE = 1 } EPWM_DeadBandClockMode; // // Trip Zone // //***************************************************************************** // // Values that can be passed to EPWM_enableTripZoneSignals() and // EPWM_disableTripZoneSignals() as the tzSignal parameter. // //***************************************************************************** //! TZ1 Cycle By Cycle //! //! TZ2 Cycle By Cycle //! //! TZ3 Cycle By Cycle //! //! TZ4 Cycle By Cycle //! //! TZ5 Cycle By Cycle //! //! TZ6 Cycle By Cycle //! //! DCAEVT2 Cycle By Cycle //! //! DCBEVT2 Cycle By Cycle //! //! One-shot TZ1 //! //! One-shot TZ2 //! //! One-shot TZ3 //! //! One-shot TZ4 //! //! One-shot TZ5 //! //! One-shot TZ6 //! //! One-shot DCAEVT1 //! //! One-shot DCBEVT1 //! //***************************************************************************** // //! Values that can be passed to EPWM_setTripZoneDigitalCompareEventCondition() //! as the \e dcType parameter. // //***************************************************************************** typedef enum { EPWM_TZ_DC_OUTPUT_A1 = 0, //!< Digital Compare output 1 A EPWM_TZ_DC_OUTPUT_A2 = 3, //!< Digital Compare output 2 A EPWM_TZ_DC_OUTPUT_B1 = 6, //!< Digital Compare output 1 B EPWM_TZ_DC_OUTPUT_B2 = 9 //!< Digital Compare output 2 B } EPWM_TripZoneDigitalCompareOutput; //***************************************************************************** // //! Values that can be passed to EPWM_setTripZoneDigitalCompareEventCondition() //! as the \e dcEvent parameter. // //***************************************************************************** typedef enum { EPWM_TZ_EVENT_DC_DISABLED = 0, //!< Event is disabled EPWM_TZ_EVENT_DCXH_LOW = 1, //!< Event when DCxH low EPWM_TZ_EVENT_DCXH_HIGH = 2, //!< Event when DCxH high EPWM_TZ_EVENT_DCXL_LOW = 3, //!< Event when DCxL low EPWM_TZ_EVENT_DCXL_HIGH = 4, //!< Event when DCxL high EPWM_TZ_EVENT_DCXL_HIGH_DCXH_LOW = 5 //!< Event when DCxL high DCxH low } EPWM_TripZoneDigitalCompareOutputEvent; //***************************************************************************** // //! Values that can be passed to EPWM_setTripZoneAction() as the \e tzEvent //! parameter. // //***************************************************************************** typedef enum { EPWM_TZ_ACTION_EVENT_TZA = 0, //!< TZ1 - TZ6, DCAEVT2, DCAEVT1 EPWM_TZ_ACTION_EVENT_TZB = 2, //!< TZ1 - TZ6, DCBEVT2, DCBEVT1 EPWM_TZ_ACTION_EVENT_DCAEVT1 = 4, //!< DCAEVT1 (Digital Compare A event 1) EPWM_TZ_ACTION_EVENT_DCAEVT2 = 6, //!< DCAEVT2 (Digital Compare A event 2) EPWM_TZ_ACTION_EVENT_DCBEVT1 = 8, //!< DCBEVT1 (Digital Compare B event 1) EPWM_TZ_ACTION_EVENT_DCBEVT2 = 10 //!< DCBEVT2 (Digital Compare B event 2) } EPWM_TripZoneEvent; //***************************************************************************** // //! Values that can be passed to EPWM_setTripZoneAction() as the //! \e tzAction parameter. // //***************************************************************************** typedef enum { EPWM_TZ_ACTION_HIGH_Z = 0, //!< High impedance output EPWM_TZ_ACTION_HIGH = 1, //!< High voltage state EPWM_TZ_ACTION_LOW = 2, //!< Low voltage state EPWM_TZ_ACTION_DISABLE = 3 //!< Disable action } EPWM_TripZoneAction; //***************************************************************************** // //! Values that can be passed to EPWM_setTripZoneAdvAction() as the //! \e tzAdvEvent parameter. // //***************************************************************************** typedef enum { //! TZ1 - TZ6, DCBEVT2, DCBEVT1 while counting down EPWM_TZ_ADV_ACTION_EVENT_TZB_D = 9, //! TZ1 - TZ6, DCBEVT2, DCBEVT1 while counting up EPWM_TZ_ADV_ACTION_EVENT_TZB_U = 6, //! TZ1 - TZ6, DCAEVT2, DCAEVT1 while counting down EPWM_TZ_ADV_ACTION_EVENT_TZA_D = 3, //! TZ1 - TZ6, DCAEVT2, DCAEVT1 while counting up EPWM_TZ_ADV_ACTION_EVENT_TZA_U = 0 } EPWM_TripZoneAdvancedEvent; //***************************************************************************** // //! Values that can be passed to EPWM_setTripZoneAdvDigitalCompareActionA(), //! EPWM_setTripZoneAdvDigitalCompareActionB(),EPWM_setTripZoneAdvAction() //! as the \e tzAdvDCAction parameter. // //***************************************************************************** typedef enum { EPWM_TZ_ADV_ACTION_HIGH_Z = 0, //!< High impedance output EPWM_TZ_ADV_ACTION_HIGH = 1, //!< High voltage state EPWM_TZ_ADV_ACTION_LOW = 2, //!< Low voltage state EPWM_TZ_ADV_ACTION_TOGGLE = 3, //!< Toggle the output EPWM_TZ_ADV_ACTION_DISABLE = 7 //!< Disable action } EPWM_TripZoneAdvancedAction; //***************************************************************************** // //! Values that can be passed to EPWM_setTripZoneAdvDigitalCompareActionA() and //! EPWM_setTripZoneAdvDigitalCompareActionB() as the \e tzAdvDCEvent //! parameter. // //***************************************************************************** typedef enum { //! Digital Compare event A/B 1 while counting up EPWM_TZ_ADV_ACTION_EVENT_DCxEVT1_U = 0, //! Digital Compare event A/B 1 while counting down EPWM_TZ_ADV_ACTION_EVENT_DCxEVT1_D = 3, //! Digital Compare event A/B 2 while counting up EPWM_TZ_ADV_ACTION_EVENT_DCxEVT2_U = 6, //! Digital Compare event A/B 2 while counting down EPWM_TZ_ADV_ACTION_EVENT_DCxEVT2_D = 9 } EPWM_TripZoneAdvDigitalCompareEvent; //***************************************************************************** // // Values that can be passed to EPWM_enableTripZoneInterrupt()and // EPWM_disableTripZoneInterrupt() as the tzInterrupt parameter . // //***************************************************************************** //! Trip Zones Cycle By Cycle interrupt //! //! Trip Zones One Shot interrupt //! //! Digital Compare A Event 1 interrupt //! //! Digital Compare A Event 2 interrupt //! //! Digital Compare B Event 1 interrupt //! //! Digital Compare B Event 2 interrupt //! //***************************************************************************** // // Values that can be returned by EPWM_getTripZoneFlagStatus() . // //***************************************************************************** //! Trip Zones Cycle By Cycle flag //! //! Trip Zones One Shot flag //! //! Digital Compare A Event 1 flag //! //! Digital Compare A Event 2 flag //! //! Digital Compare B Event 1 flag //! //! Digital Compare B Event 2 flag //! //***************************************************************************** // // Value can be passed to EPWM_clearTripZoneFlag() as the // tzInterrupt parameter and returned by EPWM_getTripZoneFlagStatus(). // //***************************************************************************** //! Trip Zone interrupt //! //***************************************************************************** // // Values that can be passed to EPWM_clearCycleByCycleTripZoneFlag() // as the tzCbcFlag parameter and returned by // EPWM_getCycleByCycleTripZoneFlagStatus(). // //***************************************************************************** //! CBC flag 1 //! //! CBC flag 2 //! //! CBC flag 3 //! //! CBC flag 4 //! //! CBC flag 5 //! //! CBC flag 6 //! //! CBC flag Digital compare event A2 //! //! CBC flag Digital compare event B2 //! //***************************************************************************** // // Values that can be passed to EPWM_clearOneShotTripZoneFlag() as // the tzCbcFlag parameter and returned by the // EPWM_getOneShotTripZoneFlagStatus() . // //***************************************************************************** //! OST flag OST1 //! //! OST flag OST2 //! //! OST flag OST3 //! //! OST flag OST4 //! //! OST flag OST5 //! //! OST flag OST6 //! //! OST flag Digital compare event A1 //! //! OST flag Digital compare event B1 //! //***************************************************************************** // //! Values that can be passed to EPWM_selectCycleByCycleTripZoneClearEvent() as //! the \e clearMode parameter. // //***************************************************************************** typedef enum { //! Clear CBC pulse when counter equals zero EPWM_TZ_CBC_PULSE_CLR_CNTR_ZERO = 0, //! Clear CBC pulse when counter equals period EPWM_TZ_CBC_PULSE_CLR_CNTR_PERIOD = 1, //! Clear CBC pulse when counter equals zero or period EPWM_TZ_CBC_PULSE_CLR_CNTR_ZERO_PERIOD = 2 } EPWM_CycleByCycleTripZoneClearMode; //***************************************************************************** // // Values that can be passed to EPWM_forceTripZoneEvent() as the // tzForceEvent parameter. // //***************************************************************************** //! Force Cycle By Cycle trip event //! //! Force a One-Shot Trip Event //! //! Force Digital Compare Output A Event 1 //! //! Force Digital Compare Output A Event 2 //! //! Force Digital Compare Output B Event 1 //! //! Force Digital Compare Output B Event 2 //! //***************************************************************************** // // Values that can be passed to EPWM_setInterruptSource() as the // interruptSource parameter. // //***************************************************************************** //! Time-base counter is disabled //! //! Time-base counter equal to zero //! //! Time-base counter equal to period //! //! Time-base counter equal to zero or period //! //! time-base counter equal to CMPA when the timer is incrementing //! //! time-base counter equal to CMPC when the timer is incrementing //! //! time-base counter equal to CMPA when the timer is decrementing //! //! time-base counter equal to CMPC when the timer is decrementing //! //! time-base counter equal to CMPB when the timer is incrementing //! //! time-base counter equal to CMPD when the timer is incrementing //! //! time-base counter equal to CMPB when the timer is decrementing //! //! time-base counter equal to CMPD when the timer is decrementing //! //***************************************************************************** // //! Values that can be passed to EPWM_enableADCTrigger(), //! EPWM_disableADCTrigger(),EPWM_setADCTriggerSource(), //! EPWM_setADCTriggerEventPrescale(),EPWM_getADCTriggerFlagStatus(), //! EPWM_clearADCTriggerFlag(),EPWM_enableADCTriggerEventCountInit(), //! EPWM_disableADCTriggerEventCountInit(),EPWM_forceADCTriggerEventCountInit(), //! EPWM_setADCTriggerEventCountInitValue(),EPWM_getADCTriggerEventCount(), //! EPWM_forceADCTrigger() as the \e adcSOCType parameter // //***************************************************************************** typedef enum { EPWM_SOC_A = 0, //!< SOC A EPWM_SOC_B = 1 //!< SOC B } EPWM_ADCStartOfConversionType; //***************************************************************************** // //! Values that can be passed to EPWM_setADCTriggerSource() as the //! \e socSource parameter. // //***************************************************************************** typedef enum { //! Event is based on DCxEVT1 EPWM_SOC_DCxEVT1 = 0, //! Time-base counter equal to zero EPWM_SOC_TBCTR_ZERO = 1, //! Time-base counter equal to period EPWM_SOC_TBCTR_PERIOD = 2, //! Time-base counter equal to zero or period EPWM_SOC_TBCTR_ZERO_OR_PERIOD = 3, //! Time-base counter equal to CMPA when the timer is incrementing EPWM_SOC_TBCTR_U_CMPA = 4, //! Time-base counter equal to CMPC when the timer is incrementing EPWM_SOC_TBCTR_U_CMPC = 8, //! Time-base counter equal to CMPA when the timer is decrementing EPWM_SOC_TBCTR_D_CMPA = 5, //! Time-base counter equal to CMPC when the timer is decrementing EPWM_SOC_TBCTR_D_CMPC = 10, //! Time-base counter equal to CMPB when the timer is incrementing EPWM_SOC_TBCTR_U_CMPB = 6, //! Time-base counter equal to CMPD when the timer is incrementing EPWM_SOC_TBCTR_U_CMPD = 12, //! Time-base counter equal to CMPB when the timer is decrementing EPWM_SOC_TBCTR_D_CMPB = 7, //! Time-base counter equal to CMPD when the timer is decrementing EPWM_SOC_TBCTR_D_CMPD = 14 } EPWM_ADCStartOfConversionSource; // // Digital Compare Module // //***************************************************************************** // //! Values that can be passed to EPWM_selectDigitalCompareTripInput(), //! EPWM_enableDigitalCompareTripCombinationInput(), //! EPWM_disableDigitalCompareTripCombinationInput() as the \e dcType //! parameter. // //***************************************************************************** typedef enum { EPWM_DC_TYPE_DCAH = 0, //!< Digital Compare A High EPWM_DC_TYPE_DCAL = 1, //!< Digital Compare A Low EPWM_DC_TYPE_DCBH = 2, //!< Digital Compare B High EPWM_DC_TYPE_DCBL = 3 //!< Digital Compare B Low } EPWM_DigitalCompareType; //***************************************************************************** // //! Values that can be passed to EPWM_selectDigitalCompareTripInput() //! as the \e tripSource parameter. // //***************************************************************************** typedef enum { EPWM_DC_TRIP_TRIPIN1 = 0, //!< Trip 1 EPWM_DC_TRIP_TRIPIN2 = 1, //!< Trip 2 EPWM_DC_TRIP_TRIPIN3 = 2, //!< Trip 3 EPWM_DC_TRIP_TRIPIN4 = 3, //!< Trip 4 EPWM_DC_TRIP_TRIPIN5 = 4, //!< Trip 5 EPWM_DC_TRIP_TRIPIN6 = 5, //!< Trip 6 EPWM_DC_TRIP_TRIPIN7 = 6, //!< Trip 7 EPWM_DC_TRIP_TRIPIN8 = 7, //!< Trip 8 EPWM_DC_TRIP_TRIPIN9 = 8, //!< Trip 9 EPWM_DC_TRIP_TRIPIN10 = 9, //!< Trip 10 EPWM_DC_TRIP_TRIPIN11 = 10, //!< Trip 11 EPWM_DC_TRIP_TRIPIN12 = 11, //!< Trip 12 EPWM_DC_TRIP_TRIPIN14 = 13, //!< Trip 14 EPWM_DC_TRIP_TRIPIN15 = 14, //!< Trip 15 EPWM_DC_TRIP_COMBINATION = 15 //!< All Trips (Trip1 - Trip 15) are selected } EPWM_DigitalCompareTripInput; //***************************************************************************** // // Values that can be passed to EPWM_enableDigitalCompareTripCombinationInput(), // EPWM_disableDigitalCompareTripCombinationInput() as the tripInput // parameter. // //***************************************************************************** //! Combinational Trip 1 input //! //! Combinational Trip 2 input //! //! Combinational Trip 3 input //! //! Combinational Trip 4 input //! //! Combinational Trip 5 input //! //! Combinational Trip 6 input //! //! Combinational Trip 7 input //! //! Combinational Trip 8 input //! //! Combinational Trip 9 input //! //! Combinational Trip 10 input //! //! Combinational Trip 11 input //! //! Combinational Trip 12 input //! //! Combinational Trip 14 input //! //! Combinational Trip 15 input //! //***************************************************************************** // //! Values that can be passed to EPWM_setDigitalCompareBlankingEvent() as the //! the \e blankingPulse parameter. // //***************************************************************************** typedef enum { //! Time base counter equals period EPWM_DC_WINDOW_START_TBCTR_PERIOD = 0, //! Time base counter equals zero EPWM_DC_WINDOW_START_TBCTR_ZERO = 1, //! Time base counter equals zero or period EPWM_DC_WINDOW_START_TBCTR_ZERO_PERIOD = 2 } EPWM_DigitalCompareBlankingPulse; //***************************************************************************** // //! Values that can be passed to EPWM_setDigitalCompareFilterInput() //! as the \e filterInput parameter. // //***************************************************************************** typedef enum { EPWM_DC_WINDOW_SOURCE_DCAEVT1 = 0, //!< DC filter signal source is DCAEVT1 EPWM_DC_WINDOW_SOURCE_DCAEVT2 = 1, //!< DC filter signal source is DCAEVT2 EPWM_DC_WINDOW_SOURCE_DCBEVT1 = 2, //!< DC filter signal source is DCBEVT1 EPWM_DC_WINDOW_SOURCE_DCBEVT2 = 3 //!< DC filter signal source is DCBEVT2 } EPWM_DigitalCompareFilterInput; //***************************************************************************** // //! Values that can be assigned to EPWM_setDigitalCompareEventSource(), //! EPWM_setDigitalCompareEventSyncMode(),EPWM_enableDigitalCompareSyncEvent() //! EPWM_enableDigitalCompareADCTrigger(),EPWM_disableDigitalCompareSyncEvent() //! EPWM_disableDigitalCompareADCTrigger() as the \e dcModule parameter. // //***************************************************************************** typedef enum { EPWM_DC_MODULE_A = 0, //!< Digital Compare Module A EPWM_DC_MODULE_B = 1 //!< Digital Compare Module B } EPWM_DigitalCompareModule; //***************************************************************************** // //! Values that can be passed to EPWM_setDigitalCompareEventSource(), //! EPWM_setDigitalCompareEventSyncMode as the \e dcEvent parameter. // //***************************************************************************** typedef enum { EPWM_DC_EVENT_1 = 0, //!< Digital Compare Event number 1 EPWM_DC_EVENT_2 = 1 //!< Digital Compare Event number 2 } EPWM_DigitalCompareEvent; //***************************************************************************** // //! Values that can be passed to EPWM_setDigitalCompareEventSource() as the //! \e dcEventSource parameter. // //***************************************************************************** typedef enum { //! Signal source is unfiltered (DCAEVT1/2) EPWM_DC_EVENT_SOURCE_ORIG_SIGNAL = 0, //! Signal source is filtered (DCEVTFILT) EPWM_DC_EVENT_SOURCE_FILT_SIGNAL = 1 } EPWM_DigitalCompareEventSource; //***************************************************************************** // //! Values that can be passed to EPWM_setDigitalCompareEventSyncMode() as the //! \e syncMode parameter. // //***************************************************************************** typedef enum { //! DC input signal is synced with TBCLK EPWM_DC_EVENT_INPUT_SYNCED = 0, //! DC input signal is not synced with TBCLK EPWM_DC_EVENT_INPUT_NOT_SYNCED = 1 } EPWM_DigitalCompareSyncMode; //***************************************************************************** // //! Values that can be passed to EPWM_setGlobalLoadTrigger() as the //! \e loadTrigger parameter. // //***************************************************************************** typedef enum { //! Load when counter is equal to zero EPWM_GL_LOAD_PULSE_CNTR_ZERO = 0x0, //! Load when counter is equal to period EPWM_GL_LOAD_PULSE_CNTR_PERIOD = 0x1, //! Load when counter is equal to zero or period EPWM_GL_LOAD_PULSE_CNTR_ZERO_PERIOD = 0x2, //! Load on sync event EPWM_GL_LOAD_PULSE_SYNC = 0x3, //! Load on sync event or when counter is equal to zero EPWM_GL_LOAD_PULSE_SYNC_OR_CNTR_ZERO = 0x4, //! Load on sync event or when counter is equal to period EPWM_GL_LOAD_PULSE_SYNC_OR_CNTR_PERIOD = 0x5, //! Load on sync event or when counter is equal to period or zero EPWM_GL_LOAD_PULSE_SYNC_CNTR_ZERO_PERIOD = 0x6, //! Load on global force EPWM_GL_LOAD_PULSE_GLOBAL_FORCE = 0xF } EPWM_GlobalLoadTrigger; //***************************************************************************** // // Values that can be passed to EPWM_enableGlobalLoadRegisters(), // EPWM_disableGlobalLoadRegisters() as theloadRegister parameter. // //***************************************************************************** //! Global load TBPRD:TBPRDHR //! //! Global load CMPA:CMPAHR //! //! Global load CMPB:CMPBHR //! //! Global load CMPC //! //! Global load CMPD //! //! Global load DBRED:DBREDHR //! //! Global load DBFED:DBFEDHR //! //! Global load DBCTL //! //! Global load AQCTLA/A2 //! //! Global load AQCTLB/B2 //! //! Global load AQCSFRC //! //***************************************************************************** // //! Values that can be passed to EPWM_setValleyTriggerSource() as the \e //! trigger parameter. // //***************************************************************************** typedef enum { //! Valley capture trigged by software EPWM_VALLEY_TRIGGER_EVENT_SOFTWARE = 0U, //! Valley capture trigged by when counter is equal to zero EPWM_VALLEY_TRIGGER_EVENT_CNTR_ZERO = 1U, //! Valley capture trigged by when counter is equal period EPWM_VALLEY_TRIGGER_EVENT_CNTR_PERIOD = 2U, //! Valley capture trigged when counter is equal to zero or period EPWM_VALLEY_TRIGGER_EVENT_CNTR_ZERO_PERIOD = 3U, //! Valley capture trigged by DCAEVT1 (Digital Compare A event 1) EPWM_VALLEY_TRIGGER_EVENT_DCAEVT1 = 4U, //! Valley capture trigged by DCAEVT2 (Digital Compare A event 2) EPWM_VALLEY_TRIGGER_EVENT_DCAEVT2 = 5U, //! Valley capture trigged by DCBEVT1 (Digital Compare B event 1) EPWM_VALLEY_TRIGGER_EVENT_DCBEVT1 = 6U, //! Valley capture trigged by DCBEVT2 (Digital Compare B event 2) EPWM_VALLEY_TRIGGER_EVENT_DCBEVT2 = 7U } EPWM_ValleyTriggerSource; //***************************************************************************** // //! Values that can be passed to EPWM_getValleyCountEdgeStatus() as the \e edge //! parameter. // //***************************************************************************** typedef enum { EPWM_VALLEY_COUNT_START_EDGE = 0, //!< Valley count start edge EPWM_VALLEY_COUNT_STOP_EDGE = 1 //!< Valley count stop edge } EPWM_ValleyCounterEdge; //***************************************************************************** // //! Values that can be passed to EPWM_setValleyDelayValue() as the \e delayMode //! parameter. // //***************************************************************************** typedef enum { //! Delay value equals the offset value defines by software EPWM_VALLEY_DELAY_MODE_SW_DELAY = 0U, //! Delay value equals the sum of the Hardware counter value and the offset //! value defines by software EPWM_VALLEY_DELAY_MODE_VCNT_DELAY_SW_DELAY = 1U, //! Delay value equals the the Hardware counter shifted by //! (1 + the offset value defines by software) EPWM_VALLEY_DELAY_MODE_VCNT_DELAY_SHIFT_1_SW_DELAY = 2U, //! Delay value equals the the Hardware counter shifted by //! (2 + the offset value defines by software) EPWM_VALLEY_DELAY_MODE_VCNT_DELAY_SHIFT_2_SW_DELAY = 3U, //! Delay value equals the the Hardware counter shifted by //! (4 + the offset value defines by software) EPWM_VALLEY_DELAY_MODE_VCNT_DELAY_SHIFT_4_SW_DELAY = 4U } EPWM_ValleyDelayMode; // // DC Edge Filter // //***************************************************************************** // //! Values that can be passed to EPWM_setDigitalCompareEdgeFilterMode() //! as the \e edgeMode parameter. // //***************************************************************************** typedef enum { EPWM_DC_EDGEFILT_MODE_RISING = 0, //!< Digital Compare Edge filter low //!< to high edge mode EPWM_DC_EDGEFILT_MODE_FALLING = 1, //!< Digital Compare Edge filter high //!< to low edge mode EPWM_DC_EDGEFILT_MODE_BOTH = 2 //!< Digital Compare Edge filter both //!< edges mode } EPWM_DigitalCompareEdgeFilterMode; //***************************************************************************** // //! Values that can be passed to EPWM_setDigitalCompareEdgeFilterEdgeCount() //! as the \e edgeCount parameter. // //***************************************************************************** typedef enum { EPWM_DC_EDGEFILT_EDGECNT_0 = 0, //!< Digital Compare Edge filter edge //!< count = 0 EPWM_DC_EDGEFILT_EDGECNT_1 = 1, //!< Digital Compare Edge filter edge //!< count = 1 EPWM_DC_EDGEFILT_EDGECNT_2 = 2, //!< Digital Compare Edge filter edge //!< count = 2 EPWM_DC_EDGEFILT_EDGECNT_3 = 3, //!< Digital Compare Edge filter edge //!< count = 3 EPWM_DC_EDGEFILT_EDGECNT_4 = 4, //!< Digital Compare Edge filter edge //!< count = 4 EPWM_DC_EDGEFILT_EDGECNT_5 = 5, //!< Digital Compare Edge filter edge //!< count = 5 EPWM_DC_EDGEFILT_EDGECNT_6 = 6, //!< Digital Compare Edge filter edge //!< count = 6 EPWM_DC_EDGEFILT_EDGECNT_7 = 7 //!< Digital Compare Edge filter edge //!< count = 7 } EPWM_DigitalCompareEdgeFilterEdgeCount; //***************************************************************************** // //! Values that can be passed to EPWM_configureSignal() as the //! \e signalParams parameter. // //***************************************************************************** typedef struct { float32_t freqInHz; //!< Desired Signal Frequency(in Hz) float32_t dutyValA; //!< Desired ePWMxA Signal Duty float32_t dutyValB; //!< Desired ePWMxB Signal Duty _Bool invertSignalB; //!< Invert ePWMxB Signal if true float32_t sysClkInHz; //!< SYSCLK Frequency(in Hz) SysCtl_EPWMCLKDivider epwmClkDiv; //!< EPWM Clock Divider EPWM_TimeBaseCountMode tbCtrMode; //!< Time Base Counter Mode EPWM_ClockDivider tbClkDiv; //!< Time Base Counter Clock Divider EPWM_HSClockDivider tbHSClkDiv; //!< Time Base Counter HS Clock Divider } EPWM_SignalParams; //***************************************************************************** // // Functions APIs shared with HRPWM module // //***************************************************************************** // // Period Control related API // //***************************************************************************** // // Prototypes for the API. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks ePWM base address. //! //! \param base specifies the ePWM module base address. //! //! This function determines if an ePWM module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool EPWM_isBaseValid(uint32_t base) { return( (base == 0x00004000U) || (base == 0x00004100U) || (base == 0x00004200U) || (base == 0x00004300U) || (base == 0x00004400U) || (base == 0x00004500U) || (base == 0x00004600U) || (base == 0x00004700U) || (base == 0x00004800U) || (base == 0x00004900U) || (base == 0x00004A00U) || (base == 0x00004B00U) ); } // // Time Base Sub Module related APIs // //***************************************************************************** // //! Set the time base count //! //! \param base is the base address of the EPWM module. //! \param count is the time base count value. //! //! This function sets the 16 bit counter value of the time base counter. //! //! \return None. // //***************************************************************************** static inline void EPWM_setTimeBaseCounter(uint32_t base, uint16_t count) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1542); } } while((_Bool)0); // // Write to TBCTR register // (*((volatile uint16_t *)(base + 0x4U))) = count; } //***************************************************************************** // //! Set count mode after phase shift sync //! //! \param base is the base address of the EPWM module. //! \param mode is the count mode. //! //! This function sets the time base count to count up or down after a new //! phase value set by the EPWM_setPhaseShift(). The count direction is //! determined by the variable mode. Valid inputs for mode are: //! - EPWM_COUNT_MODE_UP_AFTER_SYNC - Count up after sync //! - EPWM_COUNT_MODE_DOWN_AFTER_SYNC - Count down after sync //! //! \return None. // //***************************************************************************** static inline void EPWM_setCountModeAfterSync(uint32_t base, EPWM_SyncCountMode mode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1572); } } while((_Bool)0); if(mode == EPWM_COUNT_MODE_UP_AFTER_SYNC) { // // Set PHSDIR bit // (*((volatile uint16_t *)(base + 0x0U))) |= 0x2000U; } else { // // Clear PHSDIR bit // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x2000U; } } //***************************************************************************** // //! Set the time base clock and the high speed time base clock count pre-scaler //! //! \param base is the base address of the EPWM module. //! \param prescaler is the time base count pre scale value. //! \param highSpeedPrescaler is the high speed time base count pre scale //! value. //! //! This function sets the pre scaler(divider)value for the time base clock //! counter and the high speed time base clock counter. //! Valid values for pre-scaler and highSpeedPrescaler are EPWM_CLOCK_DIVIDER_X, //! where X is 1,2,4,8,16, 32,64 or 128. //! The actual numerical values for these macros represent values 0,1...7. //! The equation for the output clock is: //! TBCLK = EPWMCLK/(highSpeedPrescaler * pre-scaler) //! //! \b Note: EPWMCLK is a scaled version of SYSCLK. At reset EPWMCLK is half //! SYSCLK. //! //! \return None. // //***************************************************************************** static inline void EPWM_setClockPrescaler(uint32_t base, EPWM_ClockDivider prescaler, EPWM_HSClockDivider highSpeedPrescaler) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1620); } } while((_Bool)0); // // Write to CLKDIV and HSPCLKDIV bit // (*((volatile uint16_t *)(base + 0x0U))) = (((*((volatile uint16_t *)(base + 0x0U))) & ~(0x1C00U | 0x380U)) | (((uint16_t)prescaler << 10U) | ((uint16_t)highSpeedPrescaler << 7U))); } //***************************************************************************** // //! Force a software sync pulse //! //! \param base is the base address of the EPWM module. //! //! This function causes a single software initiated sync pulse. Make sure the //! appropriate mode is selected using EPWM_setupSyncOutputMode() before using //! this function. //! //! \return None. // //***************************************************************************** static inline void EPWM_forceSyncPulse(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1651); } } while((_Bool)0); // // Set SWFSYNC bit // (*((volatile uint16_t *)(base + 0x0U))) |= 0x40U; } //***************************************************************************** // //! Set up the sync out pulse event //! //! \param base is the base address of the EPWM module. //! \param mode is the sync out mode. //! //! This function set the sync out pulse mode. //! Valid values for mode are: //! - EPWM_SYNC_OUT_PULSE_ON_SOFTWARE - sync pulse is generated by software //! when EPWM_forceSyncPulse() //! function is called or by EPWMxSYNCI //! signal. //! - EPWM_SYNC_OUT_PULSE_ON_COUNTER_ZERO - sync pulse is generated when //! time base counter equals zero. //! - EPWM_SYNC_OUT_PULSE_ON_COUNTER_COMPARE_B - sync pulse is generated when //! time base counter equals compare //! B value. //! - EPWM_SYNC_OUT_PULSE_ON_COUNTER_COMPARE_C - sync pulse is generated when //! time base counter equals compare //! C value. //! - EPWM_SYNC_OUT_PULSE_ON_COUNTER_COMPARE_D - sync pulse is generated when //! time base counter equals compare //! D value. //! - EPWM_SYNC_OUT_PULSE_DISABLED - sync pulse is disabled. //! //! \return None. // //***************************************************************************** static inline void EPWM_setSyncOutPulseMode(uint32_t base, EPWM_SyncOutPulseMode mode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1694); } } while((_Bool)0); // // No extended mode support // if(mode < EPWM_SYNC_OUT_PULSE_DISABLED) { // // Write to SYNCOSEL bits // (*((volatile uint16_t *)(base + 0x0U))) = (((*((volatile uint16_t *)(base + 0x0U))) & ~(0x30U)) | ((uint16_t)mode << 4U)); } // // Extended modes and sync out disable mode // else { // // Write 0x3 to SYNCOSEL to enable selection from SYNCOSELX // (*((volatile uint16_t *)(base + 0x0U))) = (*((volatile uint16_t *)(base + 0x0U))) | 0x30U; // // Write to SYNCOSELX bit // (*((volatile uint16_t *)(base + 0x1U))) = (((*((volatile uint16_t *)(base + 0x1U))) & ~(0x3000U)) | (((uint16_t)mode & 0x3U) << 12U)); } } //***************************************************************************** // //! Set PWM period load mode. //! //! \param base is the base address of the EPWM module. //! \param loadMode is the PWM period load mode. //! //! This function sets the load mode for the PWM period. If loadMode is set to //! EPWM_PERIOD_SHADOW_LOAD, a write or read to the TBPRD (PWM Period count //! register) accesses the shadow register. If loadMode is set to //! EPWM_PERIOD_DIRECT_LOAD, a write or read to the TBPRD register accesses the //! register directly. //! //! \return None. // //***************************************************************************** static inline void EPWM_setPeriodLoadMode(uint32_t base, EPWM_PeriodLoadMode loadMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1750); } } while((_Bool)0); if(loadMode == EPWM_PERIOD_SHADOW_LOAD) { // // Clear PRDLD // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x8U; } else { // // Set PRDLD // (*((volatile uint16_t *)(base + 0x0U))) |= 0x8U; } } //***************************************************************************** // //! Enable phase shift load //! //! \param base is the base address of the EPWM module. //! //! This function enables loading of phase shift when the appropriate sync //! event occurs. //! //! \return None. // //***************************************************************************** static inline void EPWM_enablePhaseShiftLoad(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1786); } } while((_Bool)0); // // Set PHSEN bit // (*((volatile uint16_t *)(base + 0x0U))) |= 0x4U; } //***************************************************************************** // //! Disable phase shift load //! //! \param base is the base address of the EPWM module. //! //! This function disables loading of phase shift. //! //! \return None. // //***************************************************************************** static inline void EPWM_disablePhaseShiftLoad(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1811); } } while((_Bool)0); // // Clear PHSEN bit // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x4U; } //***************************************************************************** // //! Set time base counter mode //! //! \param base is the base address of the EPWM module. //! \param counterMode is the time base counter mode. //! //! This function sets up the time base counter mode. //! Valid values for counterMode are: //! - EPWM_COUNTER_MODE_UP - Up - count mode. //! - EPWM_COUNTER_MODE_DOWN - Down - count mode. //! - EPWM_COUNTER_MODE_UP_DOWN - Up - down - count mode. //! - EPWM_COUNTER_MODE_STOP_FREEZE - Stop - Freeze counter. //! //! \return None. // //***************************************************************************** static inline void EPWM_setTimeBaseCounterMode(uint32_t base, EPWM_TimeBaseCountMode counterMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1842); } } while((_Bool)0); // // Write to CTRMODE bit // (*((volatile uint16_t *)(base + 0x0U))) = (((*((volatile uint16_t *)(base + 0x0U))) & ~(0x3U)) | ((uint16_t)counterMode)); } //***************************************************************************** // //! Set shadow to active period load on sync mode //! //! \param base is the base address of the EPWM module. //! \param shadowLoadMode is the shadow to active load mode. //! //! This function sets up the shadow to active Period register load mode with //! respect to a sync event. Valid values for shadowLoadMode are: //! - EPWM_SHADOW_LOAD_MODE_COUNTER_ZERO - shadow to active load occurs when //! time base counter reaches 0. //! - EPWM_SHADOW_LOAD_MODE_COUNTER_SYNC - shadow to active load occurs when //! time base counter reaches 0 and a //! SYNC occurs. //! - EPWM_SHADOW_LOAD_MODE_SYNC - shadow to active load occurs only //! when a SYNC occurs. //! //! \return None. // //***************************************************************************** static inline void EPWM_selectPeriodLoadEvent(uint32_t base, EPWM_PeriodShadowLoadMode shadowLoadMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1879); } } while((_Bool)0); // // Write to PRDLDSYNC bit // (*((volatile uint16_t *)(base + 0x1U))) = (((*((volatile uint16_t *)(base + 0x1U))) & ~(0xC000U)) | ((uint16_t)shadowLoadMode << 14U)); } //***************************************************************************** // //! Enable one shot sync mode //! //! \param base is the base address of the EPWM module. //! //! This function enables one shot sync mode. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableOneShotSync(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1905); } } while((_Bool)0); // // Set OSHTSYNCMODE bit // (*((volatile uint16_t *)(base + 0x1U))) |= 0x40U; } //***************************************************************************** // //! Disable one shot sync mode //! //! \param base is the base address of the EPWM module. //! //! This function disables one shot sync mode. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableOneShotSync(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1930); } } while((_Bool)0); // // Clear OSHTSYNCMODE bit // (*((volatile uint16_t *)(base + 0x1U))) &= ~0x40U; } //***************************************************************************** // //! Start one shot sync mode //! //! \param base is the base address of the EPWM module. //! //! This function propagates a one shot sync pulse. //! //! \return None. // //***************************************************************************** static inline void EPWM_startOneShotSync(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1955); } } while((_Bool)0); // // Set OSHTSYNC bit // (*((volatile uint16_t *)(base + 0x1U))) |= 0x80U; } //***************************************************************************** // //! Returns time base counter value. //! //! \param base is the base address of the EPWM module. //! //! This function returns the current value of the time base counter. //! //! \return returns time base counter value // //***************************************************************************** static inline uint16_t EPWM_getTimeBaseCounterValue(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 1980); } } while((_Bool)0); // // Returns TBCTR value // return((*((volatile uint16_t *)(base + 0x4U)))); } //***************************************************************************** // //! Return time base counter maximum status. //! //! \param base is the base address of the EPWM module. //! //! This function returns the status of the time base max counter. //! //! \return Returns true if the counter has reached 0xFFFF. //! Returns false if the counter hasn't reached 0xFFFF. // //***************************************************************************** static inline _Bool EPWM_getTimeBaseCounterOverflowStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2006); } } while((_Bool)0); // // Return true if CTRMAX bit is set, false otherwise // return((((*((volatile uint16_t *)(base + 0x5U))) & 0x4U) == 0x4U) ? 1 : 0); } //***************************************************************************** // //! Clear max time base counter event. //! //! \param base is the base address of the EPWM module. //! //! This function clears the max time base counter latch event. The latch event //! occurs when the time base counter reaches its maximum value of 0xFFFF. //! //! \return None. // //***************************************************************************** static inline void EPWM_clearTimeBaseCounterOverflowEvent(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2033); } } while((_Bool)0); // // Set CTRMAX bit // (*((volatile uint16_t *)(base + 0x5U))) = 0x4U; } //***************************************************************************** // //! Return external sync signal status. //! //! \param base is the base address of the EPWM module. //! //! This function returns the external sync signal status. //! //! \return Returns true if if an external sync signal event //! Returns false if there is no event. // //***************************************************************************** static inline _Bool EPWM_getSyncStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2059); } } while((_Bool)0); // // Return true if SYNCI bit is set, false otherwise // return((((*((volatile uint16_t *)(base + 0x5U))) & 0x2U) == 0x2U) ? 1 : 0); } //***************************************************************************** // //! Clear external sync signal event. //! //! \param base is the base address of the EPWM module. //! //! This function clears the external sync signal latch event. //! //! \return None. // //***************************************************************************** static inline void EPWM_clearSyncEvent(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2085); } } while((_Bool)0); // // Set SYNCI bit // (*((volatile uint16_t *)(base + 0x5U))) = 0x2U; } //***************************************************************************** // //! Return time base counter direction. //! //! \param base is the base address of the EPWM module. //! //! This function returns the direction of the time base counter. //! //! \return returns EPWM_TIME_BASE_STATUS_COUNT_UP if the counter is counting //! up or EPWM_TIME_BASE_STATUS_COUNT_DOWN if the counter is //! counting down. // //***************************************************************************** static inline uint16_t EPWM_getTimeBaseCounterDirection(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2112); } } while((_Bool)0); // // Return CTRDIR bit // return((*((volatile uint16_t *)(base + 0x5U))) & 0x1U); } //***************************************************************************** // //! Sets the phase shift offset counter value. //! //! \param base is the base address of the EPWM module. //! \param phaseCount is the phase shift count value. //! //! This function sets the 16 bit time-base counter phase of the ePWM relative //! to the time-base that is supplying the synchronization input signal. Call //! the EPWM_enablePhaseShiftLoad() function to enable loading of the //! phaseCount phase shift value when a sync event occurs. //! //! \return None. // //***************************************************************************** static inline void EPWM_setPhaseShift(uint32_t base, uint16_t phaseCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2141); } } while((_Bool)0); // // Write to TBPHS bit // (*((volatile uint32_t *)(base + 0x60U))) = (((*((volatile uint32_t *)(base + 0x60U))) & ~((uint32_t)0xFFFF0000U)) | ((uint32_t)phaseCount << 16U)); } //***************************************************************************** // //! Sets the PWM period count. //! //! \param base is the base address of the EPWM module. //! \param periodCount is period count value. //! //! This function sets the period of the PWM count. The value of periodCount is //! the value written to the register. User should map the desired period or //! frequency of the waveform into the correct periodCount. //! Invoke the function EPWM_selectPeriodLoadEvent() with the appropriate //! parameter to set the load mode of the Period count. periodCount has a //! maximum valid value of 0xFFFF //! //! \return None. // //***************************************************************************** static inline void EPWM_setTimeBasePeriod(uint32_t base, uint16_t periodCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2175); } } while((_Bool)0); // // Write to TBPRD bit // (*((volatile uint16_t *)(base + 0x63U))) = periodCount; } //***************************************************************************** // //! Gets the PWM period count. //! //! \param base is the base address of the EPWM module. //! //! This function gets the period of the PWM count. //! //! \return The period count value. // //***************************************************************************** static inline uint16_t EPWM_getTimeBasePeriod(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2200); } } while((_Bool)0); // // Read from TBPRD bit // return((*((volatile uint16_t *)(base + 0x63U)))); } //***************************************************************************** // //! Sets the EPWM links. //! //! \param base is the base address of the EPWM module. //! \param epwmLink is the ePWM instance to link with. //! \param linkComp is the ePWM component to link. //! //! This function links the component defined in linkComp in the current ePWM //! instance with the linkComp component of the ePWM instance defined by //! epwmLink. A change (a write) in the value of linkComp component of epwmLink //! instance, causes a change in the current ePWM linkComp component. //! For example if the current ePWM is ePWM3 and the values of epwmLink and //! linkComp are EPWM_LINK_WITH_EPWM_1 and EPWM_LINK_COMP_C respectively, //! then a write to COMPC register in ePWM1, will result in a simultaneous //! write to COMPC register in ePWM3. //! Valid values for epwmLink are: //! - EPWM_LINK_WITH_EPWM_1 - link current ePWM with ePWM1 //! - EPWM_LINK_WITH_EPWM_2 - link current ePWM with ePWM2 //! - EPWM_LINK_WITH_EPWM_3 - link current ePWM with ePWM3 //! - EPWM_LINK_WITH_EPWM_4 - link current ePWM with ePWM4 //! - EPWM_LINK_WITH_EPWM_5 - link current ePWM with ePWM5 //! - EPWM_LINK_WITH_EPWM_6 - link current ePWM with ePWM6 //! - EPWM_LINK_WITH_EPWM_7 - link current ePWM with ePWM7 //! - EPWM_LINK_WITH_EPWM_8 - link current ePWM with ePWM8 //! - EPWM_LINK_WITH_EPWM_9 - link current ePWM with ePWM9 //! - EPWM_LINK_WITH_EPWM_10 - link current ePWM with ePWM10 //! - EPWM_LINK_WITH_EPWM_11 - link current ePWM with ePWM11 //! - EPWM_LINK_WITH_EPWM_12 - link current ePWM with ePWM12 //! //! Valid values for linkComp are: //! - EPWM_LINK_TBPRD - link TBPRD:TBPRDHR registers //! - EPWM_LINK_COMP_A - link COMPA registers //! - EPWM_LINK_COMP_B - link COMPB registers //! - EPWM_LINK_COMP_C - link COMPC registers //! - EPWM_LINK_COMP_D - link COMPD registers //! - EPWM_LINK_GLDCTL2 - link GLDCTL2 registers //! //! \return None. // //***************************************************************************** static inline void EPWM_setupEPWMLinks(uint32_t base, EPWM_CurrentLink epwmLink, EPWM_LinkComponent linkComp) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2256); } } while((_Bool)0); uint32_t registerOffset; registerOffset = base + 0x38U; // // Configure EPWM links // (*((volatile uint32_t *)(registerOffset))) = (((*((volatile uint32_t *)(registerOffset))) & ~((uint32_t)0xFU << (uint32_t)linkComp)) | ((uint32_t)epwmLink << (uint32_t)linkComp)); } //***************************************************************************** // //! Sets up the Counter Compare shadow load mode //! //! \param base is the base address of the EPWM module. //! \param compModule is the counter compare module. //! \param loadMode is the shadow to active load mode. //! //! This function enables and sets up the counter compare shadow load mode. //! Valid values for the variables are: //! - compModule //! - EPWM_COUNTER_COMPARE_A - counter compare A. //! - EPWM_COUNTER_COMPARE_B - counter compare B. //! - EPWM_COUNTER_COMPARE_C - counter compare C. //! - EPWM_COUNTER_COMPARE_D - counter compare D. //! - loadMode //! - EPWM_COMP_LOAD_ON_CNTR_ZERO - load when counter equals zero //! - EPWM_COMP_LOAD_ON_CNTR_PERIOD - load when counter equals period //! - EPWM_COMP_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals //! zero or period //! - EPWM_COMP_LOAD_FREEZE - Freeze shadow to active load //! - EPWM_COMP_LOAD_ON_SYNC_CNTR_ZERO - load when counter equals zero //! - EPWM_COMP_LOAD_ON_SYNC_CNTR_PERIOD -load when counter equals period //! - EPWM_COMP_LOAD_ON_SYNC_CNTR_ZERO_PERIOD - load when counter equals //! zero or period //! - EPWM_COMP_LOAD_ON_SYNC_ONLY - load on sync only //! //! \return None. // //***************************************************************************** static inline void EPWM_setCounterCompareShadowLoadMode(uint32_t base, EPWM_CounterCompareModule compModule, EPWM_CounterCompareLoadMode loadMode) { uint16_t syncModeOffset; uint16_t loadModeOffset; uint16_t shadowModeOffset; uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2313); } } while((_Bool)0); if((compModule == EPWM_COUNTER_COMPARE_A) || (compModule == EPWM_COUNTER_COMPARE_C)) { syncModeOffset = 10U; loadModeOffset = 0U; shadowModeOffset = 4U; } else { syncModeOffset = 12U; loadModeOffset = 2U; shadowModeOffset = 6U; } // // Get the register offset. EPWM_O_CMPCTL for A&B or // EPWM_O_CMPCTL2 for C&D // registerOffset = base + 0x8U + ((uint32_t)compModule & 0x1U); // // Set the appropriate sync and load mode bits and also enable shadow // load mode. Shadow to active load can also be frozen. // (*((volatile uint16_t *)(registerOffset))) = (((*((volatile uint16_t *)(registerOffset))) & ~((0x3U << syncModeOffset) | // Clear sync mode (0x3U << loadModeOffset) | // Clear load mode (0x1U << shadowModeOffset))) | // shadow mode ((((uint16_t)loadMode >> 2U) << syncModeOffset) | (((uint16_t)loadMode & 0x3U) << loadModeOffset))); } //***************************************************************************** // //! Disable Counter Compare shadow load mode //! //! \param base is the base address of the EPWM module. //! \param compModule is the counter compare module. //! //! This function disables counter compare shadow load mode. //! Valid values for the variables are: //! - compModule //! - EPWM_COUNTER_COMPARE_A - counter compare A. //! - EPWM_COUNTER_COMPARE_B - counter compare B. //! - EPWM_COUNTER_COMPARE_C - counter compare C. //! - EPWM_COUNTER_COMPARE_D - counter compare D. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableCounterCompareShadowLoadMode(uint32_t base, EPWM_CounterCompareModule compModule) { uint16_t shadowModeOffset; uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2375); } } while((_Bool)0); if((compModule == EPWM_COUNTER_COMPARE_A) || (compModule == EPWM_COUNTER_COMPARE_C)) { shadowModeOffset = 4U; } else { shadowModeOffset = 6U; } // // Get the register offset. EPWM_O_CMPCTL for A&B or // EPWM_O_CMPCTL2 for C&D // registerOffset = base + 0x8U + ((uint32_t)compModule & 0x1U); // // Disable shadow load mode. // (*((volatile uint16_t *)(registerOffset))) = ((*((volatile uint16_t *)(registerOffset))) | (0x1U << shadowModeOffset)); } //***************************************************************************** // //! Set counter compare values. //! //! \param base is the base address of the EPWM module. //! \param compModule is the Counter Compare value module. //! \param compCount is the counter compare count value. //! //! This function sets the counter compare value for counter compare registers. //! The maximum value for compCount is 0xFFFF. //! Valid values for compModule are: //! - EPWM_COUNTER_COMPARE_A - counter compare A. //! - EPWM_COUNTER_COMPARE_B - counter compare B. //! - EPWM_COUNTER_COMPARE_C - counter compare C. //! - EPWM_COUNTER_COMPARE_D - counter compare D. //! //! \return None. // //***************************************************************************** static inline void EPWM_setCounterCompareValue(uint32_t base, EPWM_CounterCompareModule compModule, uint16_t compCount) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2428); } } while((_Bool)0); // // Get the register offset for the Counter compare // registerOffset = 0x6AU + (uint32_t)compModule; // // Write to the counter compare registers. // if((compModule == EPWM_COUNTER_COMPARE_A) || (compModule == EPWM_COUNTER_COMPARE_B)) { // // Write to COMPA or COMPB bits // (*((volatile uint16_t *)(base + registerOffset + 0x1U))) = compCount; } else { // // Write to COMPC or COMPD bits // (*((volatile uint16_t *)(base + registerOffset))) = compCount; } } //***************************************************************************** // //! Get counter compare values. //! //! \param base is the base address of the EPWM module. //! \param compModule is the Counter Compare value module. //! //! This function gets the counter compare value for counter compare registers. //! Valid values for compModule are: //! - EPWM_COUNTER_COMPARE_A - counter compare A. //! - EPWM_COUNTER_COMPARE_B - counter compare B. //! - EPWM_COUNTER_COMPARE_C - counter compare C. //! - EPWM_COUNTER_COMPARE_D - counter compare D. //! //! \return The counter compare count value. // //***************************************************************************** static inline uint16_t EPWM_getCounterCompareValue(uint32_t base, EPWM_CounterCompareModule compModule) { uint32_t registerOffset; uint16_t compCount; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2481); } } while((_Bool)0); // // Get the register offset for the Counter compare // registerOffset = 0x6AU + (uint32_t)compModule; // // Read from the counter compare registers. // if((compModule == EPWM_COUNTER_COMPARE_A) || (compModule == EPWM_COUNTER_COMPARE_B)) { // // Read COMPA or COMPB bits // compCount = (uint16_t)(((*((volatile uint32_t *)(base + registerOffset))) & 0xFFFF0000UL) >> 16U); } else { // // Read COMPC or COMPD bits // compCount = (*((volatile uint16_t *)(base + registerOffset))); } return(compCount); } //***************************************************************************** // //! Return the counter compare shadow register full status. //! //! \param base is the base address of the EPWM module. //! \param compModule is the Counter Compare value module. //! //! This function returns the counter Compare shadow register full status flag. //! Valid values for compModule are: //! - EPWM_COUNTER_COMPARE_A - counter compare A. //! - EPWM_COUNTER_COMPARE_B - counter compare B. //! //! \return Returns true if the shadow register is full. //! Returns false if the shadow register is not full. // //***************************************************************************** static inline _Bool EPWM_getCounterCompareShadowStatus(uint32_t base, EPWM_CounterCompareModule compModule) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2533); } } while((_Bool)0); // // Check the validity of input. // COMPA and COMPB are valid input arguments. // do { if(!((compModule == EPWM_COUNTER_COMPARE_A) || (compModule == EPWM_COUNTER_COMPARE_B))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2540); } } while((_Bool)0); // // Read the value of SHDWAFULL or SHDWBFULL bit // return(((((*((volatile uint32_t *)(base + 0x8U))) >> ((((uint16_t)compModule >> 1U) & 0x1U) + 8U)) & 0x1U) == 0x1U) ? 1:0); } // // Action Qualifier module related APIs // //***************************************************************************** // //! Sets the Action Qualifier shadow load mode //! //! \param base is the base address of the EPWM module. //! \param aqModule is the Action Qualifier module value. //! \param loadMode is the shadow to active load mode. //! //! This function enables and sets the Action Qualifier shadow load mode. //! Valid values for the variables are: //! - aqModule //! - EPWM_ACTION_QUALIFIER_A - Action Qualifier A. //! - EPWM_ACTION_QUALIFIER_B - Action Qualifier B. //! - loadMode //! - EPWM_AQ_LOAD_ON_CNTR_ZERO - load when counter equals zero //! - EPWM_AQ_LOAD_ON_CNTR_PERIOD - load when counter equals period //! - EPWM_AQ_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals //! zero or period //! - EPWM_AQ_LOAD_FREEZE - Freeze shadow to active load //! - EPWM_AQ_LOAD_ON_SYNC_CNTR_ZERO - load on sync or when counter //! equals zero //! - EPWM_AQ_LOAD_ON_SYNC_CNTR_PERIOD - load on sync or when counter //! equals period //! - EPWM_AQ_LOAD_ON_SYNC_CNTR_ZERO_PERIOD - load on sync or when //! counter equals zero or period //! - EPWM_AQ_LOAD_ON_SYNC_ONLY - load on sync only //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierShadowLoadMode(uint32_t base, EPWM_ActionQualifierModule aqModule, EPWM_ActionQualifierLoadMode loadMode) { uint16_t syncModeOffset; uint16_t shadowModeOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2594); } } while((_Bool)0); syncModeOffset = 8U + (uint16_t)aqModule; shadowModeOffset = 4U + (uint16_t)aqModule; // // Set the appropriate sync and load mode bits and also enable shadow // load mode. Shadow to active load can also be frozen. // (*((volatile uint16_t *)(base + 0x10U))) = (((*((volatile uint16_t *)(base + 0x10U))) & (~((0x3U << (uint16_t)aqModule) | (0x3U << (uint16_t)syncModeOffset))) | (0x1U << shadowModeOffset)) | ((((uint16_t)loadMode >> 2U) << syncModeOffset) | (((uint16_t)loadMode & 0x3U) << (uint16_t)aqModule))); } //***************************************************************************** // //! Disable Action Qualifier shadow load mode //! //! \param base is the base address of the EPWM module. //! \param aqModule is the Action Qualifier module value. //! //! This function disables the Action Qualifier shadow load mode. //! Valid values for the variables are: //! - aqModule //! - EPWM_ACTION_QUALIFIER_A - Action Qualifier A. //! - EPWM_ACTION_QUALIFIER_B - Action Qualifier B. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableActionQualifierShadowLoadMode(uint32_t base, EPWM_ActionQualifierModule aqModule) { uint16_t shadowModeOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2637); } } while((_Bool)0); shadowModeOffset = 4U + (uint16_t)aqModule; // // Disable shadow load mode. Action qualifier is loaded on // immediate mode only. // (*((volatile uint16_t *)(base + 0x10U))) &= ~(1U << shadowModeOffset); } //***************************************************************************** // //! Set up Action qualifier trigger source for event T1 //! //! \param base is the base address of the EPWM module. //! \param trigger sources for Action Qualifier triggers. //! //! This function sets up the sources for Action Qualifier event T1. //! Valid values for trigger are: //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCA_1 - Digital compare event A 1 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCA_2 - Digital compare event A 2 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCB_1 - Digital compare event B 1 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCB_2 - Digital compare event B 2 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_1 - Trip zone 1 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_2 - Trip zone 2 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_3 - Trip zone 3 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_EPWM_SYNCIN - ePWM sync //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierT1TriggerSource(uint32_t base, EPWM_ActionQualifierTriggerSource trigger) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2676); } } while((_Bool)0); // // Set T1 trigger source // (*((volatile uint16_t *)(base + 0x11U))) = (((*((volatile uint16_t *)(base + 0x11U))) & (~0xFU)) | ((uint16_t)trigger)); } //***************************************************************************** // //! Set up Action qualifier trigger source for event T2 //! //! \param base is the base address of the EPWM module. //! \param trigger sources for Action Qualifier triggers. //! //! This function sets up the sources for Action Qualifier event T2. //! Valid values for trigger are: //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCA_1 - Digital compare event A 1 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCA_2 - Digital compare event A 2 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCB_1 - Digital compare event B 1 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_DCB_2 - Digital compare event B 2 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_1 - Trip zone 1 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_2 - Trip zone 2 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_TZ_3 - Trip zone 3 //! - EPWM_AQ_TRIGGER_EVENT_TRIG_EPWM_SYNCIN - ePWM sync //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierT2TriggerSource(uint32_t base, EPWM_ActionQualifierTriggerSource trigger) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2714); } } while((_Bool)0); // // Set T2 trigger source // (*((volatile uint16_t *)(base + 0x11U))) = (((*((volatile uint16_t *)(base + 0x11U))) & (~0xF0U)) | ((uint16_t)trigger << 4U)); } //***************************************************************************** // //! Set up Action qualifier outputs //! //! \param base is the base address of the EPWM module. //! \param epwmOutput is the ePWM pin type. //! \param output is the Action Qualifier output. //! \param event is the event that causes a change in output. //! //! This function sets up the Action Qualifier output on ePWM A or ePWMB, //! depending on the value of epwmOutput, to a value specified by outPut based //! on the input events - specified by event. //! The following are valid values for the parameters. //! - epwmOutput //! - EPWM_AQ_OUTPUT_A - ePWMxA output //! - EPWM_AQ_OUTPUT_B - ePWMxB output //! - output //! - EPWM_AQ_OUTPUT_NO_CHANGE - No change in the output pins //! - EPWM_AQ_OUTPUT_LOW - Set output pins to low //! - EPWM_AQ_OUTPUT_HIGH - Set output pins to High //! - EPWM_AQ_OUTPUT_TOGGLE - Toggle the output pins //! - event //! - EPWM_AQ_OUTPUT_ON_TIMEBASE_ZERO - Time base counter equals //! zero //! - EPWM_AQ_OUTPUT_ON_TIMEBASE_PERIOD - Time base counter equals //! period //! - EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA - Time base counter up equals //! COMPA //! - EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA - Time base counter down //! equals COMPA //! - EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPB - Time base counter up equals //! COMPB //! - EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPB - Time base counter down //! equals COMPB //! - EPWM_AQ_OUTPUT_ON_T1_COUNT_UP - T1 event on count up //! - EPWM_AQ_OUTPUT_ON_T1_COUNT_DOWN - T1 event on count down //! - EPWM_AQ_OUTPUT_ON_T2_COUNT_UP - T2 event on count up //! - EPWM_AQ_OUTPUT_ON_T2_COUNT_DOWN - T2 event on count down //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierAction(uint32_t base, EPWM_ActionQualifierOutputModule epwmOutput, EPWM_ActionQualifierOutput output, EPWM_ActionQualifierOutputEvent event) { uint32_t registerOffset; uint32_t registerTOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2778); } } while((_Bool)0); // // Get the register offset // registerOffset = 0x40U + (uint32_t)epwmOutput; registerTOffset = 0x41U + (uint32_t)epwmOutput; // // If the event occurs on T1 or T2 events // if(((uint16_t)event & 0x1U) == 1U) { // // Write to T1U,T1D,T2U or T2D of AQCTLA2 register // (*((volatile uint16_t *)(base + registerTOffset))) = (((*((volatile uint16_t *)(base + registerTOffset))) & ~(3U << ((uint16_t)event - 1U))) | ((uint16_t)output << ((uint16_t)event - 1U))); } else { // // Write to ZRO,PRD,CAU,CAD,CBU or CBD bits of AQCTLA register // (*((volatile uint16_t *)(base + registerOffset))) = (((*((volatile uint16_t *)(base + registerOffset))) & ~(3U << (uint16_t)event)) | ((uint16_t)output << (uint16_t)event)); } } //***************************************************************************** // //! Set up Action qualifier event outputs //! //! \param base is the base address of the EPWM module. //! \param epwmOutput is the ePWM pin type. //! \param action is the desired action when the specified event occurs //! //! This function sets up the Action Qualifier output on ePWMA or ePWMB, //! depending on the value of epwmOutput, to a value specified by action. //! Valid action param values from different time base counter scenarios //! should be OR'd together to configure complete action for a pwm output. //! The following are valid values for the parameters. //! - epwmOutput //! - EPWM_AQ_OUTPUT_A - ePWMxA output //! - EPWM_AQ_OUTPUT_B - ePWMxB output //! //! - action //! - When time base counter equals zero //! - EPWM_AQ_OUTPUT_NO_CHANGE_ZERO - Time base counter equals zero //! and no change in output pins //! - EPWM_AQ_OUTPUT_LOW_ZERO - Time base counter equals zero //! and set output pins to low //! - EPWM_AQ_OUTPUT_HIGH_ZERO - Time base counter equals zero //! and set output pins to high //! - EPWM_AQ_OUTPUT_TOGGLE_ZERO - Time base counter equals zero //! and toggle the output pins //! - When time base counter equals period //! - EPWM_AQ_OUTPUT_NO_CHANGE_PERIOD - Time base counter equals period //! and no change in output pins //! - EPWM_AQ_OUTPUT_LOW_PERIOD - Time base counter equals period //! and set output pins to low //! - EPWM_AQ_OUTPUT_HIGH_PERIOD - Time base counter equals period //! and set output pins to high //! - EPWM_AQ_OUTPUT_TOGGLE_PERIOD - Time base counter equals period //! and toggle the output pins //! - When time base counter equals CMPA during up-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_UP_CMPA - Time base counter up equals //! COMPA and no change in the //! output pins //! - EPWM_AQ_OUTPUT_LOW_UP_CMPA - Time base counter up equals //! COMPA and set output pins low //! - EPWM_AQ_OUTPUT_HIGH_UP_CMPA - Time base counter up equals //! COMPA and set output pins high //! - EPWM_AQ_OUTPUT_TOGGLE_UP_CMPA - Time base counter up equals //! COMPA and toggle output pins //! - When time base counter equals CMPA during down-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_CMPA - Time base counter down equals //! COMPA and no change in the //! output pins //! - EPWM_AQ_OUTPUT_LOW_DOWN_CMPA - Time base counter down equals //! COMPA and set output pins low //! - EPWM_AQ_OUTPUT_HIGH_DOWN_CMPA - Time base counter down equals //! COMPA and set output pins high //! - EPWM_AQ_OUTPUT_TOGGLE_DOWN_CMPA - Time base counter down equals //! COMPA and toggle output pins //! - When time base counter equals CMPB during up-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_UP_CMPB - Time base counter up equals //! COMPB and no change in the //! output pins //! - EPWM_AQ_OUTPUT_LOW_UP_CMPB - Time base counter up equals //! COMPB and set output pins low //! - EPWM_AQ_OUTPUT_HIGH_UP_CMPB - Time base counter up equals //! COMPB and set output pins high //! - EPWM_AQ_OUTPUT_TOGGLE_UP_CMPB - Time base counter up equals //! COMPB and toggle output pins //! - When time base counter equals CMPB during down-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_CMPB- Time base counter down equals //! COMPB and no change in the //! output pins //! - EPWM_AQ_OUTPUT_LOW_DOWN_CMPB - Time base counter down equals //! COMPB and set output pins low //! - EPWM_AQ_OUTPUT_HIGH_DOWN_CMPB - Time base counter down equals //! COMPB and set output pins high //! - EPWM_AQ_OUTPUT_TOGGLE_DOWN_CMPB - Time base counter down equals //! COMPB and toggle output pins //! //! \b note: A logical OR of the valid values should be passed as the action //! parameter. Single action should be configured for each time base //! counter scenario. //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierActionComplete(uint32_t base, EPWM_ActionQualifierOutputModule epwmOutput, uint16_t action) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2903); } } while((_Bool)0); // // Get the register offset // registerOffset = 0x40U + (uint32_t)epwmOutput; // // Write to ZRO, PRD, CAU, CAD, CBU or CBD bits of AQCTLA register // (*((volatile uint16_t *)(base + registerOffset))) = (uint16_t)action; } //***************************************************************************** // //! Set up Additional action qualifier event outputs //! //! \param base is the base address of the EPWM module. //! \param epwmOutput is the ePWM pin type. //! \param action is the desired action when the specified event occurs //! //! This function sets up the Additional Action Qualifier output on ePWMA or //! ePWMB depending on the value of epwmOutput, to a value specified by action. //! Valid action param values from different event scenarios should be OR'd //! together to configure complete action for a pwm output. //! The following are valid values for the parameters. //! - epwmOutput //! - EPWM_AQ_OUTPUT_A - ePWMxA output //! - EPWM_AQ_OUTPUT_B - ePWMxB output //! - action //! - When T1 event occurs during up-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_UP_T1 - T1 event on count up //! and no change in output pins //! - EPWM_AQ_OUTPUT_LOW_UP_T1 - T1 event on count up //! and set output pins to low //! - EPWM_AQ_OUTPUT_HIGH_UP_T1 - T1 event on count up //! and set output pins to high //! - EPWM_AQ_OUTPUT_TOGGLE_UP_T1 - T1 event on count up //! and toggle the output pins //! - When T1 event occurs during down-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_T1- T1 event on count down //! and no change in output pins //! - EPWM_AQ_OUTPUT_LOW_DOWN_T1 - T1 event on count down //! and set output pins to low //! - EPWM_AQ_OUTPUT_HIGH_DOWN_T1 - T1 event on count down //! and set output pins to high //! - EPWM_AQ_OUTPUT_TOGGLE_DOWN_T1 - T1 event on count down //! and toggle the output pins //! - When T2 event occurs during up-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_UP_T2 - T2 event on count up //! and no change in output pins //! - EPWM_AQ_OUTPUT_LOW_UP_T2 - T2 event on count up //! and set output pins to low //! - EPWM_AQ_OUTPUT_HIGH_UP_T2 - T2 event on count up //! and set output pins to high //! - EPWM_AQ_OUTPUT_TOGGLE_UP_T2 - T2 event on count up //! and toggle the output pins //! - When T2 event occurs during down-count //! - EPWM_AQ_OUTPUT_NO_CHANGE_DOWN_T2 - T2 event on count down //! and no change in output pins //! - EPWM_AQ_OUTPUT_LOW_DOWN_T2 - T2 event on count down //! and set output pins to low //! - EPWM_AQ_OUTPUT_HIGH_DOWN_T2 - T2 event on count down //! and set output pins to high //! - EPWM_AQ_OUTPUT_TOGGLE_DOWN_T2 - T2 event on count down //! and toggle the output pins //! //! \b note: A logical OR of the valid values should be passed as the action //! parameter. Single action should be configured for each event //! scenario. //! //! \return None. // //***************************************************************************** static inline void EPWM_setAdditionalActionQualifierActionComplete(uint32_t base, EPWM_ActionQualifierOutputModule epwmOutput, uint16_t action) { uint32_t registerTOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 2987); } } while((_Bool)0); // // Get the register offset // registerTOffset = 0x41U + (uint32_t)epwmOutput; // // Write to T1U, T1D, T2U or T2D of AQCTLA2 register // (*((volatile uint16_t *)(base + registerTOffset))) = (uint16_t)action; } //***************************************************************************** // //! Sets up Action qualifier continuous software load mode. //! //! \param base is the base address of the EPWM module. //! \param mode is the mode for shadow to active load mode. //! //! This function sets up the AQCFRSC register load mode for continuous //! software force reload mode. The software force actions are determined by //! the EPWM_setActionQualifierContSWForceAction() function. //! Valid values for mode are: //! - EPWM_AQ_SW_SH_LOAD_ON_CNTR_ZERO - shadow mode load when counter //! equals zero //! - EPWM_AQ_SW_SH_LOAD_ON_CNTR_PERIOD - shadow mode load when counter //! equals period //! - EPWM_AQ_SW_SH_LOAD_ON_CNTR_ZERO_PERIOD - shadow mode load when counter //! equals zero or period //! - EPWM_AQ_SW_IMMEDIATE_LOAD - immediate mode load only //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierContSWForceShadowMode(uint32_t base, EPWM_ActionQualifierContForce mode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3029); } } while((_Bool)0); // // Set the Action qualifier software action reload mode. // Write to RLDCSF bit // (*((volatile uint16_t *)(base + 0x47U))) = (((*((volatile uint16_t *)(base + 0x47U))) & ~0xC0U) | ((uint16_t)mode << 6U)); } //***************************************************************************** // //! Triggers a continuous software forced event. //! //! \param base is the base address of the EPWM module. //! \param epwmOutput is the ePWM pin type. //! \param output is the Action Qualifier output. //! //! This function triggers a continuous software forced Action Qualifier output //! on ePWM A or B based on the value of epwmOutput. //! Valid values for the parameters are: //! - epwmOutput //! - EPWM_AQ_OUTPUT_A - ePWMxA output //! - EPWM_AQ_OUTPUT_B - ePWMxB output //! - output //! - EPWM_AQ_SW_DISABLED - Software forcing disabled. //! - EPWM_AQ_SW_OUTPUT_LOW - Set output pins to low //! - EPWM_AQ_SW_OUTPUT_HIGH - Set output pins to High //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierContSWForceAction(uint32_t base, EPWM_ActionQualifierOutputModule epwmOutput, EPWM_ActionQualifierSWOutput output) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3070); } } while((_Bool)0); // // Initiate a continuous software forced output // if(epwmOutput == EPWM_AQ_OUTPUT_A) { (*((volatile uint16_t *)(base + 0x49U))) = (((*((volatile uint16_t *)(base + 0x49U))) & ~0x3U) | ((uint16_t)output)); } else { (*((volatile uint16_t *)(base + 0x49U))) = (((*((volatile uint16_t *)(base + 0x49U))) & ~0xCU) | ((uint16_t)output << 2U)) ; } } //***************************************************************************** // //! Set up one time software forced Action qualifier outputs //! //! \param base is the base address of the EPWM module. //! \param epwmOutput is the ePWM pin type. //! \param output is the Action Qualifier output. //! //! This function sets up the one time software forced Action Qualifier output //! on ePWM A or ePWMB, depending on the value of epwmOutput to a value //! specified by outPut. //! The following are valid values for the parameters. //! - epwmOutput //! - EPWM_AQ_OUTPUT_A - ePWMxA output //! - EPWM_AQ_OUTPUT_B - ePWMxB output //! - output //! - EPWM_AQ_OUTPUT_NO_CHANGE - No change in the output pins //! - EPWM_AQ_OUTPUT_LOW - Set output pins to low //! - EPWM_AQ_OUTPUT_HIGH - Set output pins to High //! - EPWM_AQ_OUTPUT_TOGGLE - Toggle the output pins //! //! \return None. // //***************************************************************************** static inline void EPWM_setActionQualifierSWAction(uint32_t base, EPWM_ActionQualifierOutputModule epwmOutput, EPWM_ActionQualifierOutput output) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3121); } } while((_Bool)0); // // Set the one time software forced action // if(epwmOutput == EPWM_AQ_OUTPUT_A) { (*((volatile uint16_t *)(base + 0x47U))) = (((*((volatile uint16_t *)(base + 0x47U))) & ~0x3U) | ((uint16_t)output)); } else { (*((volatile uint16_t *)(base + 0x47U))) = (((*((volatile uint16_t *)(base + 0x47U))) & ~0x18U) | ((uint16_t)output << 3U)); } } //***************************************************************************** // //! Triggers a one time software forced event on Action qualifier //! //! \param base is the base address of the EPWM module. //! \param epwmOutput is the ePWM pin type. //! //! This function triggers a one time software forced Action Qualifier event //! on ePWM A or B based on the value of epwmOutput. //! Valid values for epwmOutput are: //! - EPWM_AQ_OUTPUT_A - ePWMxA output //! - EPWM_AQ_OUTPUT_B - ePWMxB output //! //! \return None. // //***************************************************************************** static inline void EPWM_forceActionQualifierSWAction(uint32_t base, EPWM_ActionQualifierOutputModule epwmOutput) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3163); } } while((_Bool)0); // // Initiate a software forced event // if(epwmOutput == EPWM_AQ_OUTPUT_A) { (*((volatile uint16_t *)(base + 0x47U))) |= 0x4U; } else { (*((volatile uint16_t *)(base + 0x47U))) |= 0x20U; } } // // Dead Band Module related APIs // //***************************************************************************** // //! Sets Dead Band signal output swap mode. //! //! \param base is the base address of the EPWM module. //! \param output is the ePWM Dead Band output. //! \param enableSwapMode is the output swap mode. //! //! This function sets up the output signal swap mode. For example if the //! output variable is set to EPWM_DB_OUTPUT_A and enableSwapMode is true, then //! the ePWM A output gets its signal from the ePWM B signal path. Valid values //! for the input variables are: //! - output //! - EPWM_DB_OUTPUT_A - ePWM output A //! - EPWM_DB_OUTPUT_B - ePWM output B //! - enableSwapMode //! - true - the output is swapped //! - false - the output and the signal path are the same. //! //! \return None. // //***************************************************************************** static inline void EPWM_setDeadBandOutputSwapMode(uint32_t base, EPWM_DeadBandOutput output, _Bool enableSwapMode) { uint16_t mask; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3212); } } while((_Bool)0); mask = (uint16_t)1U << ((uint16_t)output + 12U); if(enableSwapMode) { // // Set the appropriate outswap bit to swap output // (*((volatile uint16_t *)(base + 0xCU))) = ((*((volatile uint16_t *)(base + 0xCU))) | mask); } else { // // Clear the appropriate outswap bit to disable output swap // (*((volatile uint16_t *)(base + 0xCU))) = ((*((volatile uint16_t *)(base + 0xCU))) & ~mask); } } //***************************************************************************** // //! Sets Dead Band signal output mode. //! //! \param base is the base address of the EPWM module. //! \param delayMode is the Dead Band delay type. //! \param enableDelayMode is the dead band delay mode. //! //! This function sets up the dead band delay mode. The delayMode variable //! determines if the applied delay is Rising Edge or Falling Edge. The //! enableDelayMode determines if a dead band delay should be applied. //! Valid values for the variables are: //! - delayMode //! - EPWM_DB_RED - Rising Edge delay //! - EPWM_DB_FED - Falling Edge delay //! - enableDelayMode //! - true - Falling edge or Rising edge delay is applied. //! - false - Dead Band delay is bypassed. //! //! \return None. // //***************************************************************************** static inline void EPWM_setDeadBandDelayMode(uint32_t base, EPWM_DeadBandDelayMode delayMode, _Bool enableDelayMode) { uint16_t mask; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3263); } } while((_Bool)0); mask = (uint16_t)1U << ((uint16_t)delayMode + 0U); if(enableDelayMode) { // // Set the appropriate outmode bit to enable Dead Band delay // (*((volatile uint16_t *)(base + 0xCU))) = ((*((volatile uint16_t *)(base + 0xCU))) | mask); } else { // // Clear the appropriate outswap bit to disable output swap // (*((volatile uint16_t *)(base + 0xCU))) = ((*((volatile uint16_t *)(base + 0xCU))) & ~ mask); } } //***************************************************************************** // //! Sets Dead Band delay polarity. //! //! \param base is the base address of the EPWM module. //! \param delayMode is the Dead Band delay type. //! \param polarity is the polarity of the delayed signal. //! //! This function sets up the polarity as determined by the variable polarity //! of the Falling Edge or Rising Edge delay depending on the value of //! delayMode. Valid values for the variables are: //! - delayMode //! - EPWM_DB_RED - Rising Edge delay //! - EPWM_DB_FED - Falling Edge delay //! - polarity //! - EPWM_DB_POLARITY_ACTIVE_HIGH - polarity is not inverted. //! - EPWM_DB_POLARITY_ACTIVE_LOW - polarity is inverted. //! //! \return None. // //***************************************************************************** static inline void EPWM_setDeadBandDelayPolarity(uint32_t base, EPWM_DeadBandDelayMode delayMode, EPWM_DeadBandPolarity polarity) { uint16_t shift; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3314); } } while((_Bool)0); shift = (((uint16_t)delayMode ^ 0x1U) + 2U); // // Set the appropriate polsel bits for dead band polarity // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~ (1U << shift)) | ((uint16_t)polarity << shift)); } //***************************************************************************** // //! Sets Rising Edge Dead Band delay input. //! //! \param base is the base address of the EPWM module. //! \param input is the input signal to the dead band. //! //! This function sets up the rising Edge delay input signal. //! Valid values for input are: //! - EPWM_DB_INPUT_EPWMA - Input signal is ePWMA( Valid for both Falling //! Edge and Rising Edge) //! - EPWM_DB_INPUT_EPWMB - Input signal is ePWMB( Valid for both Falling //! Edge and Rising Edge) //! //! \return None. // //***************************************************************************** static inline void EPWM_setRisingEdgeDeadBandDelayInput(uint32_t base, uint16_t input) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3349); } } while((_Bool)0); do { if(!((input == 0U) || (input == 1U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3351); } } while((_Bool)0); // // Set the Rising Edge Delay input // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~(1U << (4U))) | (input << 4U)); } //***************************************************************************** // //! Sets Dead Band delay input. //! //! \param base is the base address of the EPWM module. //! \param input is the input signal to the dead band. //! //! This function sets up the rising Edge delay input signal. //! Valid values for input are: //! - EPWM_DB_INPUT_EPWMA - Input signal is ePWMA(Valid for both Falling //! Edge and Rising Edge) //! - EPWM_DB_INPUT_EPWMB - Input signal is ePWMB(Valid for both Falling //! Edge and Rising Edge) //! - EPWM_DB_INPUT_DB_RED - Input signal is the output of Rising //! Edge delay. //! (Valid only for Falling Edge delay) //! //! \return None. // //***************************************************************************** static inline void EPWM_setFallingEdgeDeadBandDelayInput(uint32_t base, uint16_t input) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3387); } } while((_Bool)0); do { if(!((input == 0U) || (input == 1U) || (input == 2U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3390); } } while((_Bool)0); if(input == 2U) { // // Set the Falling Edge Delay input // (*((volatile uint16_t *)(base + 0xCU))) |= 0x4000U; } else { // // Set the Falling Edge Delay input // (*((volatile uint16_t *)(base + 0xCU))) &= ~0x4000U; // // Set the Rising Edge Delay input // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~(1U << (4U + 1U))) | (input << (4U + 1U))); } } //***************************************************************************** // //! Set the Dead Band control shadow load mode. //! //! \param base is the base address of the EPWM module. //! \param loadMode is the shadow to active load mode. //! //! This function enables and sets the Dead Band control register shadow //! load mode. //! Valid values for the \e loadMode parameter are: //! - EPWM_DB_LOAD_ON_CNTR_ZERO - load when counter equals zero. //! - EPWM_DB_LOAD_ON_CNTR_PERIOD - load when counter equals period. //! - EPWM_DB_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals zero or //! period. //! - EPWM_DB_LOAD_FREEZE - Freeze shadow to active load. //! //! \return None. // //***************************************************************************** static inline void EPWM_setDeadBandControlShadowLoadMode(uint32_t base, EPWM_DeadBandControlLoadMode loadMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3441); } } while((_Bool)0); // // Enable the shadow mode and setup the load event // (*((volatile uint16_t *)(base + 0xDU))) = (((*((volatile uint16_t *)(base + 0xDU))) & ~0x3U) | (0x4U | (uint16_t)loadMode)); } //***************************************************************************** // //! Disable Dead Band control shadow load mode. //! //! \param base is the base address of the EPWM module. //! //! This function disables the Dead Band control register shadow //! load mode. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableDeadBandControlShadowLoadMode(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3469); } } while((_Bool)0); // // Disable the shadow load mode. Only immediate load mode only. // (*((volatile uint16_t *)(base + 0xDU))) = ((*((volatile uint16_t *)(base + 0xDU))) & ~0x4U); } //***************************************************************************** // //! Set the RED (Rising Edge Delay) shadow load mode. //! //! \param base is the base address of the EPWM module. //! \param loadMode is the shadow to active load event. //! //! This function sets the Rising Edge Delay register shadow load mode. //! Valid values for the \e loadMode parameter are: //! - EPWM_RED_LOAD_ON_CNTR_ZERO - load when counter equals zero. //! - EPWM_RED_LOAD_ON_CNTR_PERIOD - load when counter equals period. //! - EPWM_RED_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals zero or //! period. //! - EPWM_RED_LOAD_FREEZE - Freeze shadow to active load. //! //! \return None. // //***************************************************************************** static inline void EPWM_setRisingEdgeDelayCountShadowLoadMode(uint32_t base, EPWM_RisingEdgeDelayLoadMode loadMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3503); } } while((_Bool)0); // // Enable the shadow mode. Set-up the load mode // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~0xC0U) | ((uint16_t)0x400U | ((uint16_t)loadMode << 6U))); } //***************************************************************************** // //! Disable the RED (Rising Edge Delay) shadow load mode. //! //! \param base is the base address of the EPWM module. //! //! This function disables the Rising Edge Delay register shadow load mode. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableRisingEdgeDelayCountShadowLoadMode(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3532); } } while((_Bool)0); // // Disable the shadow mode. // (*((volatile uint16_t *)(base + 0xCU))) = ((*((volatile uint16_t *)(base + 0xCU))) & ~0x400U); } //***************************************************************************** // //! Set the FED (Falling Edge Delay) shadow load mode. //! //! \param base is the base address of the EPWM module. //! \param loadMode is the shadow to active load event. //! //! This function enables and sets the Falling Edge Delay register shadow load //! mode. Valid values for the \e loadMode parameters are: //! - EPWM_FED_LOAD_ON_CNTR_ZERO - load when counter equals zero. //! - EPWM_FED_LOAD_ON_CNTR_PERIOD - load when counter equals period. //! - EPWM_FED_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals zero or //! period. //! - EPWM_FED_LOAD_FREEZE - Freeze shadow to active load. //! //! \return None. // //***************************************************************************** static inline void EPWM_setFallingEdgeDelayCountShadowLoadMode(uint32_t base, EPWM_FallingEdgeDelayLoadMode loadMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3567); } } while((_Bool)0); // // Enable the shadow mode. Setup the load mode. // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~0x300U) | (0x800U | ((uint16_t)loadMode << 8U))); } //***************************************************************************** // //! Disables the FED (Falling Edge Delay) shadow load mode. //! //! \param base is the base address of the EPWM module. //! //! This function disables the Falling Edge Delay register shadow load mode. //! Valid values for the parameters are: //! //! \return None. // //***************************************************************************** static inline void EPWM_disableFallingEdgeDelayCountShadowLoadMode(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3597); } } while((_Bool)0); // // Disable the shadow mode. // (*((volatile uint16_t *)(base + 0xCU))) = ((*((volatile uint16_t *)(base + 0xCU))) & ~0x800U); } //***************************************************************************** // //! Sets Dead Band Counter clock rate. //! //! \param base is the base address of the EPWM module. //! \param clockMode is the Dead Band counter clock mode. //! //! This function sets up the Dead Band counter clock rate with respect to //! TBCLK (ePWM time base counter). //! Valid values for clockMode are: //! - EPWM_DB_COUNTER_CLOCK_FULL_CYCLE -Dead band counter runs at TBCLK //! (ePWM Time Base Counter) rate. //! - EPWM_DB_COUNTER_CLOCK_HALF_CYCLE -Dead band counter runs at 2*TBCLK //! (twice ePWM Time Base Counter)rate. //! //! \return None. // //***************************************************************************** static inline void EPWM_setDeadBandCounterClock(uint32_t base, EPWM_DeadBandClockMode clockMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3631); } } while((_Bool)0); // // Set the DB clock mode // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~0x8000U) | ((uint16_t)clockMode << 15U)); } //***************************************************************************** // //! Set ePWM RED count //! //! \param base is the base address of the EPWM module. //! \param redCount is the RED(Rising Edge Delay) count. //! //! This function sets the RED (Rising Edge Delay) count value. //! The value of redCount should be less than 0x4000U. //! //! \return None. // //***************************************************************************** static inline void EPWM_setRisingEdgeDelayCount(uint32_t base, uint16_t redCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3660); } } while((_Bool)0); do { if(!(redCount < 0x4000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3661); } } while((_Bool)0); // // Set the RED (Rising Edge Delay) count // (*((volatile uint16_t *)(base + 0x51U))) = redCount; } //***************************************************************************** // //! Set ePWM FED count //! //! \param base is the base address of the EPWM module. //! \param fedCount is the FED(Falling Edge Delay) count. //! //! This function sets the FED (Falling Edge Delay) count value. //! The value of fedCount should be less than 0x4000U. //! //! \return None. // //***************************************************************************** static inline void EPWM_setFallingEdgeDelayCount(uint32_t base, uint16_t fedCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3688); } } while((_Bool)0); do { if(!(fedCount < 0x4000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3689); } } while((_Bool)0); // // Set the RED (Rising Edge Delay) count // (*((volatile uint16_t *)(base + 0x53U))) = fedCount; } // // Chopper module related APIs // //***************************************************************************** // //! Enable chopper mode //! //! \param base is the base address of the EPWM module. //! //! This function enables ePWM chopper module. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableChopper(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3717); } } while((_Bool)0); // // Set CHPEN bit. Enable Chopper // (*((volatile uint16_t *)(base + 0x14U))) |= 0x1U; } //***************************************************************************** // //! Disable chopper mode //! //! \param base is the base address of the EPWM module. //! //! This function disables ePWM chopper module. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableChopper(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3742); } } while((_Bool)0); // // Clear CHPEN bit. Disable Chopper // (*((volatile uint16_t *)(base + 0x14U))) &= ~0x1U; } //***************************************************************************** // //! Set chopper duty cycle. //! //! \param base is the base address of the EPWM module. //! \param dutyCycleCount is the chopping clock duty cycle count. //! //! This function sets the chopping clock duty cycle. The value of //! dutyCycleCount should be less than 7. The dutyCycleCount value is converted //! to the actual chopper duty cycle value base on the following equation: //! chopper duty cycle = (dutyCycleCount + 1) / 8 //! //! \return None. // //***************************************************************************** static inline void EPWM_setChopperDutyCycle(uint32_t base, uint16_t dutyCycleCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3771); } } while((_Bool)0); do { if(!(dutyCycleCount < 7U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3772); } } while((_Bool)0); // // Set the chopper duty cycle // (*((volatile uint16_t *)(base + 0x14U))) = (((*((volatile uint16_t *)(base + 0x14U))) & ~0x700U) | (dutyCycleCount << 8U)); } //***************************************************************************** // //! Set chopper clock frequency scaler. //! //! \param base is the base address of the EPWM module. //! \param freqDiv is the chopping clock frequency divider. //! //! This function sets the scaler for the chopping clock frequency. The value //! of freqDiv should be less than 8. The chopping clock frequency is altered //! based on the following equation. //! chopper clock frequency = SYSCLKOUT / ( 1 + freqDiv) //! //! \return None. // //***************************************************************************** static inline void EPWM_setChopperFreq(uint32_t base, uint16_t freqDiv) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3803); } } while((_Bool)0); do { if(!(freqDiv < 8U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3804); } } while((_Bool)0); // // Set the chopper clock // (*((volatile uint16_t *)(base + 0x14U))) = (((*((volatile uint16_t *)(base + 0x14U))) & ~(uint16_t)0xE0U) | (freqDiv << 5U)); } //***************************************************************************** // //! Set chopper clock frequency scaler. //! //! \param base is the base address of the EPWM module. //! \param firstPulseWidth is the width of the first pulse. //! //! This function sets the first pulse width of chopper output waveform. The //! value of firstPulseWidth should be less than 0x10. The value of the first //! pulse width in seconds is given using the following equation: //! first pulse width = 1 / (((firstPulseWidth + 1) * SYSCLKOUT)/8) //! //! \return None. // //***************************************************************************** static inline void EPWM_setChopperFirstPulseWidth(uint32_t base, uint16_t firstPulseWidth) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3836); } } while((_Bool)0); do { if(!(firstPulseWidth < 16U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3837); } } while((_Bool)0); // // Set the chopper clock // (*((volatile uint16_t *)(base + 0x14U))) = (((*((volatile uint16_t *)(base + 0x14U))) & ~(uint16_t)0x1EU) | (firstPulseWidth << 1U)); } // // Trip Zone module related APIs // //***************************************************************************** // //! Enables Trip Zone signal. //! //! \param base is the base address of the EPWM module. //! \param tzSignal is the Trip Zone signal. //! //! This function enables the Trip Zone signals specified by tzSignal as a //! source for the Trip Zone module. //! Valid values for tzSignal are: //! - EPWM_TZ_SIGNAL_CBC1 - TZ1 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC2 - TZ2 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC3 - TZ3 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC4 - TZ4 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC5 - TZ5 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC6 - TZ6 Cycle By Cycle //! - EPWM_TZ_SIGNAL_DCAEVT2 - DCAEVT2 Cycle By Cycle //! - EPWM_TZ_SIGNAL_DCBEVT2 - DCBEVT2 Cycle By Cycle //! - EPWM_TZ_SIGNAL_OSHT1 - One-shot TZ1 //! - EPWM_TZ_SIGNAL_OSHT2 - One-shot TZ2 //! - EPWM_TZ_SIGNAL_OSHT3 - One-shot TZ3 //! - EPWM_TZ_SIGNAL_OSHT4 - One-shot TZ4 //! - EPWM_TZ_SIGNAL_OSHT5 - One-shot TZ5 //! - EPWM_TZ_SIGNAL_OSHT6 - One-shot TZ6 //! - EPWM_TZ_SIGNAL_DCAEVT1 - One-shot DCAEVT1 //! - EPWM_TZ_SIGNAL_DCBEVT1 - One-shot DCBEVT1 //! //! \b note: A logical OR of the valid values can be passed as the tzSignal //! parameter. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableTripZoneSignals(uint32_t base, uint16_t tzSignal) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3890); } } while((_Bool)0); // // Set the trip zone bits // __eallow(); (*((volatile uint16_t *)(base + 0x80U))) |= tzSignal; __edis(); } //***************************************************************************** // //! Disables Trip Zone signal. //! //! \param base is the base address of the EPWM module. //! \param tzSignal is the Trip Zone signal. //! //! This function disables the Trip Zone signal specified by tzSignal as a //! source for the Trip Zone module. //! Valid values for tzSignal are: //! - EPWM_TZ_SIGNAL_CBC1 - TZ1 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC2 - TZ2 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC3 - TZ3 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC4 - TZ4 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC5 - TZ5 Cycle By Cycle //! - EPWM_TZ_SIGNAL_CBC6 - TZ6 Cycle By Cycle //! - EPWM_TZ_SIGNAL_DCAEVT2 - DCAEVT2 Cycle By Cycle //! - EPWM_TZ_SIGNAL_DCBEVT2 - DCBEVT2 Cycle By Cycle //! - EPWM_TZ_SIGNAL_OSHT1 - One-shot TZ1 //! - EPWM_TZ_SIGNAL_OSHT2 - One-shot TZ2 //! - EPWM_TZ_SIGNAL_OSHT3 - One-shot TZ3 //! - EPWM_TZ_SIGNAL_OSHT4 - One-shot TZ4 //! - EPWM_TZ_SIGNAL_OSHT5 - One-shot TZ5 //! - EPWM_TZ_SIGNAL_OSHT6 - One-shot TZ6 //! - EPWM_TZ_SIGNAL_DCAEVT1 - One-shot DCAEVT1 //! - EPWM_TZ_SIGNAL_DCBEVT1 - One-shot DCBEVT1 //! //! \b note: A logical OR of the valid values can be passed as the tzSignal //! parameter. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableTripZoneSignals(uint32_t base, uint16_t tzSignal) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3939); } } while((_Bool)0); // // Clear the trip zone bits // __eallow(); (*((volatile uint16_t *)(base + 0x80U))) &= ~tzSignal; __edis(); } //***************************************************************************** // //! Set Digital compare conditions that cause Trip Zone event. //! //! \param base is the base address of the EPWM module. //! \param dcType is the Digital compare output type. //! \param dcEvent is the Digital Compare output event. //! //! This function sets up the Digital Compare output Trip Zone event sources. //! The dcType variable specifies the event source to be whether Digital //! Compare output A or Digital Compare output B. The dcEvent parameter //! specifies the event that causes Trip Zone. //! Valid values for the parameters are: //! - dcType //! - EPWM_TZ_DC_OUTPUT_A1 - Digital Compare output 1 A //! - EPWM_TZ_DC_OUTPUT_A2 - Digital Compare output 2 A //! - EPWM_TZ_DC_OUTPUT_B1 - Digital Compare output 1 B //! - EPWM_TZ_DC_OUTPUT_B2 - Digital Compare output 2 B //! - dcEvent //! - EPWM_TZ_EVENT_DC_DISABLED - Event Trigger is disabled //! - EPWM_TZ_EVENT_DCXH_LOW - Trigger event when DCxH low //! - EPWM_TZ_EVENT_DCXH_HIGH - Trigger event when DCxH high //! - EPWM_TZ_EVENT_DCXL_LOW - Trigger event when DCxL low //! - EPWM_TZ_EVENT_DCXL_HIGH - Trigger event when DCxL high //! - EPWM_TZ_EVENT_DCXL_HIGH_DCXH_LOW - Trigger event when DCxL high //! DCxH low //! //! \note x in DCxH/DCxL represents DCAH/DCAL or DCBH/DCBL //! //! \return None. // //***************************************************************************** static inline void EPWM_setTripZoneDigitalCompareEventCondition(uint32_t base, EPWM_TripZoneDigitalCompareOutput dcType, EPWM_TripZoneDigitalCompareOutputEvent dcEvent) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 3989); } } while((_Bool)0); // // Set Digital Compare Events conditions that cause a Digital Compare trip // __eallow(); (*((volatile uint16_t *)(base + 0x82U))) = (((*((volatile uint16_t *)(base + 0x82U))) & ~(0x7U << (uint16_t)dcType)) | ((uint16_t)dcEvent << (uint16_t)dcType)); __edis(); } //***************************************************************************** // //! Enable advanced Trip Zone event Action. //! //! \param base is the base address of the EPWM module. //! //! This function enables the advanced actions of the Trip Zone events. The //! advanced features combine the trip zone events with the direction of the //! counter. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableTripZoneAdvAction(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4020); } } while((_Bool)0); // // Enable Advanced feature. Set ETZE bit // __eallow(); (*((volatile uint16_t *)(base + 0x85U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Disable advanced Trip Zone event Action. //! //! \param base is the base address of the EPWM module. //! //! This function disables the advanced actions of the Trip Zone events. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableTripZoneAdvAction(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4047); } } while((_Bool)0); // // Disable Advanced feature. clear ETZE bit // __eallow(); (*((volatile uint16_t *)(base + 0x85U))) &= ~0x8000U; __edis(); } //***************************************************************************** // //! Set Trip Zone Action. //! //! \param base is the base address of the EPWM module. //! \param tzEvent is the Trip Zone event type. //! \param tzAction is the Trip zone Action. //! //! This function sets the Trip Zone Action to be taken when a Trip Zone event //! occurs. //! Valid values for the parameters are: //! - tzEvent //! - EPWM_TZ_ACTION_EVENT_DCBEVT2 - DCBEVT2 (Digital Compare B event 2) //! - EPWM_TZ_ACTION_EVENT_DCBEVT1 - DCBEVT1 (Digital Compare B event 1) //! - EPWM_TZ_ACTION_EVENT_DCAEVT2 - DCAEVT2 (Digital Compare A event 2) //! - EPWM_TZ_ACTION_EVENT_DCAEVT1 - DCAEVT1 (Digital Compare A event 1) //! - EPWM_TZ_ACTION_EVENT_TZB - TZ1 - TZ6, DCBEVT2, DCBEVT1 //! - EPWM_TZ_ACTION_EVENT_TZA - TZ1 - TZ6, DCAEVT2, DCAEVT1 //! - tzAction //! - EPWM_TZ_ACTION_HIGH_Z - high impedance output //! - EPWM_TZ_ACTION_HIGH - high output //! - EPWM_TZ_ACTION_LOW - low low //! - EPWM_TZ_ACTION_DISABLE - disable action //! //! \note Disable the advanced Trip Zone event using //! EPWM_disableTripZoneAdvAction() before calling this function. //! \note This function operates on both ePWMA and ePWMB depending on the //! tzEvent parameter. //! //! \return None. // //***************************************************************************** static inline void EPWM_setTripZoneAction(uint32_t base, EPWM_TripZoneEvent tzEvent, EPWM_TripZoneAction tzAction) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4096); } } while((_Bool)0); // // Set the Action for Trip Zone events // __eallow(); (*((volatile uint16_t *)(base + 0x84U))) = (((*((volatile uint16_t *)(base + 0x84U))) & ~(0x3U << (uint16_t)tzEvent)) | ((uint16_t)tzAction << (uint16_t)tzEvent)) ; __edis(); } //***************************************************************************** // //! Set Advanced Trip Zone Action. //! //! \param base is the base address of the EPWM module. //! \param tzAdvEvent is the Trip Zone event type. //! \param tzAdvAction is the Trip zone Action. //! //! This function sets the Advanced Trip Zone Action to be taken when an //! advanced Trip Zone event occurs. //! //! Valid values for the parameters are: //! - tzAdvEvent //! - EPWM_TZ_ADV_ACTION_EVENT_TZB_D - TZ1 - TZ6, DCBEVT2, DCBEVT1 while //! counting down //! - EPWM_TZ_ADV_ACTION_EVENT_TZB_U - TZ1 - TZ6, DCBEVT2, DCBEVT1 while //! counting up //! - EPWM_TZ_ADV_ACTION_EVENT_TZA_D - TZ1 - TZ6, DCAEVT2, DCAEVT1 while //! counting down //! - EPWM_TZ_ADV_ACTION_EVENT_TZA_U - TZ1 - TZ6, DCAEVT2, DCAEVT1 while //! counting up //! - tzAdvAction //! - EPWM_TZ_ADV_ACTION_HIGH_Z - high impedance output //! - EPWM_TZ_ADV_ACTION_HIGH - high voltage state //! - EPWM_TZ_ADV_ACTION_LOW - low voltage state //! - EPWM_TZ_ADV_ACTION_TOGGLE - Toggle output //! - EPWM_TZ_ADV_ACTION_DISABLE - disable action //! //! \note This function enables the advanced Trip Zone event. //! //! \note This function operates on both ePWMA and ePWMB depending on the //! tzAdvEvent parameter. //! \note Advanced Trip Zone events take into consideration the direction of //! the counter in addition to Trip Zone events. //! //! \return None. // //***************************************************************************** static inline void EPWM_setTripZoneAdvAction(uint32_t base, EPWM_TripZoneAdvancedEvent tzAdvEvent, EPWM_TripZoneAdvancedAction tzAdvAction) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4153); } } while((_Bool)0); // // Set the Advanced Action for Trip Zone events // __eallow(); (*((volatile uint16_t *)(base + 0x85U))) = (((*((volatile uint16_t *)(base + 0x85U))) & ~(0x7U << (uint16_t)tzAdvEvent)) | ((uint16_t)tzAdvAction << (uint16_t)tzAdvEvent)); (*((volatile uint16_t *)(base + 0x85U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Set Advanced Digital Compare Trip Zone Action on ePWMA. //! //! \param base is the base address of the EPWM module. //! \param tzAdvDCEvent is the Digital Compare Trip Zone event type. //! \param tzAdvDCAction is the Digital Compare Trip zone Action. //! //! This function sets the Digital Compare (DC) Advanced Trip Zone Action to be //! taken on ePWMA when an advanced Digital Compare Trip Zone A event occurs. //! Valid values for the parameters are: //! - tzAdvDCEvent //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT2_D - Digital Compare event A2 while //! counting down //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT2_U - Digital Compare event A2 while //! counting up //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT1_D - Digital Compare event A1 while //! counting down //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT1_U - Digital Compare event A1 while //! counting up //! - tzAdvDCAction //! - EPWM_TZ_ADV_ACTION_HIGH_Z - high impedance output //! - EPWM_TZ_ADV_ACTION_HIGH - high voltage state //! - EPWM_TZ_ADV_ACTION_LOW - low voltage state //! - EPWM_TZ_ADV_ACTION_TOGGLE - Toggle output //! - EPWM_TZ_ADV_ACTION_DISABLE - disable action //! //! \note This function enables the advanced Trip Zone event. //! //! \note Advanced Trip Zone events take into consideration the direction of //! the counter in addition to Digital Compare Trip Zone events. //! //! \return None. // //***************************************************************************** static inline void EPWM_setTripZoneAdvDigitalCompareActionA(uint32_t base, EPWM_TripZoneAdvDigitalCompareEvent tzAdvDCEvent, EPWM_TripZoneAdvancedAction tzAdvDCAction) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4210); } } while((_Bool)0); // // Set the Advanced Action for Trip Zone events // __eallow(); (*((volatile uint16_t *)(base + 0x86U))) = (((*((volatile uint16_t *)(base + 0x86U))) & ~(0x7U << (uint16_t)tzAdvDCEvent)) | ((uint16_t)tzAdvDCAction << (uint16_t)tzAdvDCEvent)); (*((volatile uint16_t *)(base + 0x85U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Set Advanced Digital Compare Trip Zone Action on ePWMB. //! //! \param base is the base address of the EPWM module. //! \param tzAdvDCEvent is the Digital Compare Trip Zone event type. //! \param tzAdvDCAction is the Digital Compare Trip zone Action. //! //! This function sets the Digital Compare (DC) Advanced Trip Zone Action to be //! taken on ePWMB when an advanced Digital Compare Trip Zone B event occurs. //! Valid values for the parameters are: //! - tzAdvDCEvent //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT2_D - Digital Compare event B2 while //! counting down //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT2_U - Digital Compare event B2 while //! counting up //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT1_D - Digital Compare event B1 while //! counting down //! - EPWM_TZ_ADV_ACTION_EVENT_DCxEVT1_U - Digital Compare event B1 while //! counting up //! - tzAdvDCAction //! - EPWM_TZ_ADV_ACTION_HIGH_Z - high impedance output //! - EPWM_TZ_ADV_ACTION_HIGH - high voltage state //! - EPWM_TZ_ADV_ACTION_LOW - low voltage state //! - EPWM_TZ_ADV_ACTION_TOGGLE - Toggle output //! - EPWM_TZ_ADV_ACTION_DISABLE - disable action //! //! \note This function enables the advanced Trip Zone event. //! //! \note Advanced Trip Zone events take into consideration the direction of //! the counter in addition to Digital Compare Trip Zone events. //! //! \return None. // //***************************************************************************** static inline void EPWM_setTripZoneAdvDigitalCompareActionB(uint32_t base, EPWM_TripZoneAdvDigitalCompareEvent tzAdvDCEvent, EPWM_TripZoneAdvancedAction tzAdvDCAction) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4266); } } while((_Bool)0); // // Set the Advanced Action for Trip Zone events // __eallow(); (*((volatile uint16_t *)(base + 0x87U))) = (((*((volatile uint16_t *)(base + 0x87U))) & ~(0x7U << (uint16_t)tzAdvDCEvent)) | ((uint16_t)tzAdvDCAction << (uint16_t)tzAdvDCEvent)); (*((volatile uint16_t *)(base + 0x85U))) |= 0x8000U; __edis(); } //***************************************************************************** // //! Enable Trip Zone interrupts. //! //! \param base is the base address of the EPWM module. //! \param tzInterrupt is the Trip Zone interrupt. //! //! This function enables the Trip Zone interrupts. //! Valid values for tzInterrupt are: //! - EPWM_TZ_INTERRUPT_CBC - Trip Zones Cycle By Cycle interrupt //! - EPWM_TZ_INTERRUPT_OST - Trip Zones One Shot interrupt //! - EPWM_TZ_INTERRUPT_DCAEVT1 - Digital Compare A Event 1 interrupt //! - EPWM_TZ_INTERRUPT_DCAEVT2 - Digital Compare A Event 2 interrupt //! - EPWM_TZ_INTERRUPT_DCBEVT1 - Digital Compare B Event 1 interrupt //! - EPWM_TZ_INTERRUPT_DCBEVT2 - Digital Compare B Event 2 interrupt //! //! \b note: A logical OR of the valid values can be passed as the tzInterrupt //! parameter. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableTripZoneInterrupt(uint32_t base, uint16_t tzInterrupt) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4308); } } while((_Bool)0); do { if(!((tzInterrupt > 0U) && (tzInterrupt <= 0x80U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4309); } } while((_Bool)0); // // Enable Trip zone interrupts // __eallow(); (*((volatile uint16_t *)(base + 0x8DU))) |= tzInterrupt; __edis(); } //***************************************************************************** // //! Disable Trip Zone interrupts. //! //! \param base is the base address of the EPWM module. //! \param tzInterrupt is the Trip Zone interrupt. //! //! This function disables the Trip Zone interrupts. //! Valid values for tzInterrupt are: //! - EPWM_TZ_INTERRUPT_CBC - Trip Zones Cycle By Cycle interrupt //! - EPWM_TZ_INTERRUPT_OST - Trip Zones One Shot interrupt //! - EPWM_TZ_INTERRUPT_DCAEVT1 - Digital Compare A Event 1 interrupt //! - EPWM_TZ_INTERRUPT_DCAEVT2 - Digital Compare A Event 2 interrupt //! - EPWM_TZ_INTERRUPT_DCBEVT1 - Digital Compare B Event 1 interrupt //! - EPWM_TZ_INTERRUPT_DCBEVT2 - Digital Compare B Event 2 interrupt //! //! \b note: A logical OR of the valid values can be passed as the tzInterrupt //! parameter. //! //! \return None. // //*************************************************************************** static inline void EPWM_disableTripZoneInterrupt(uint32_t base, uint16_t tzInterrupt) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4347); } } while((_Bool)0); do { if(!((tzInterrupt > 0U) && (tzInterrupt <= 0x80U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4348); } } while((_Bool)0); // // Disable Trip zone interrupts // __eallow(); (*((volatile uint16_t *)(base + 0x8DU))) &= ~tzInterrupt; __edis(); } //***************************************************************************** // //! Gets the Trip Zone status flag //! //! \param base is the base address of the EPWM module. //! //! This function returns the Trip Zone status flag. //! //! \return The function returns the following or the bitwise OR value //! of the following values. //! - EPWM_TZ_INTERRUPT - Trip Zone interrupt was generated //! due to the following TZ events. //! - EPWM_TZ_FLAG_CBC - Trip Zones Cycle By Cycle event status flag //! - EPWM_TZ_FLAG_OST - Trip Zones One Shot event status flag //! - EPWM_TZ_FLAG_DCAEVT1 - Digital Compare A Event 1 status flag //! - EPWM_TZ_FLAG_DCAEVT2 - Digital Compare A Event 2 status flag //! - EPWM_TZ_FLAG_DCBEVT1 - Digital Compare B Event 1 status flag //! - EPWM_TZ_FLAG_DCBEVT2 - Digital Compare B Event 2 status flag // //*************************************************************************** static inline uint16_t EPWM_getTripZoneFlagStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4384); } } while((_Bool)0); // // Return the Trip zone flag status // return((*((volatile uint16_t *)(base + 0x93U))) & 0x7FU); } //***************************************************************************** // //! Gets the Trip Zone Cycle by Cycle flag status //! //! \param base is the base address of the EPWM module. //! //! This function returns the specific Cycle by Cycle Trip Zone flag //! status. //! //! \return The function returns the following values. //! - EPWM_TZ_CBC_FLAG_1 - CBC 1 status flag //! - EPWM_TZ_CBC_FLAG_2 - CBC 2 status flag //! - EPWM_TZ_CBC_FLAG_3 - CBC 3 status flag //! - EPWM_TZ_CBC_FLAG_4 - CBC 4 status flag //! - EPWM_TZ_CBC_FLAG_5 - CBC 5 status flag //! - EPWM_TZ_CBC_FLAG_6 - CBC 6 status flag //! - EPWM_TZ_CBC_FLAG_DCAEVT2 - CBC status flag for Digital compare //! event A2 //! - EPWM_TZ_CBC_FLAG_DCBEVT2 - CBC status flag for Digital compare //! event B2 // //*************************************************************************** static inline uint16_t EPWM_getCycleByCycleTripZoneFlagStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4420); } } while((_Bool)0); // // Return the Cycle By Cycle Trip zone flag status // return((*((volatile uint16_t *)(base + 0x94U))) & 0xFFU); } //***************************************************************************** // //! Gets the Trip Zone One Shot flag status //! //! \param base is the base address of the EPWM module. //! //! This function returns the specific One Shot Trip Zone flag status. //! //! \return The function returns the bitwise OR of the following flags. //! - EPWM_TZ_OST_FLAG_OST1 - OST status flag for OST1 //! - EPWM_TZ_OST_FLAG_OST2 - OST status flag for OST2 //! - EPWM_TZ_OST_FLAG_OST3 - OST status flag for OST3 //! - EPWM_TZ_OST_FLAG_OST4 - OST status flag for OST4 //! - EPWM_TZ_OST_FLAG_OST5 - OST status flag for OST5 //! - EPWM_TZ_OST_FLAG_OST6 - OST status flag for OST6 //! - EPWM_TZ_OST_FLAG_DCAEVT1 - OST status flag for Digital //! compare event A1 //! - EPWM_TZ_OST_FLAG_DCBEVT1 - OST status flag for Digital //! compare event B1 // //*************************************************************************** static inline uint16_t EPWM_getOneShotTripZoneFlagStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4455); } } while((_Bool)0); // // Return the One Shot Trip zone flag status // return((*((volatile uint16_t *)(base + 0x95U))) & 0xFFU); } //***************************************************************************** // //! Set the Trip Zone CBC pulse clear event. //! //! \param base is the base address of the EPWM module. //! \param clearEvent is the CBC trip zone clear event. //! //! This function set the event which automatically clears the //! CBC (Cycle by Cycle) latch. //! Valid values for clearEvent are: //! - EPWM_TZ_CBC_PULSE_CLR_CNTR_ZERO - Clear CBC pulse when counter //! equals zero //! - EPWM_TZ_CBC_PULSE_CLR_CNTR_PERIOD - Clear CBC pulse when counter //! equals period //! - EPWM_TZ_CBC_PULSE_CLR_CNTR_ZERO_PERIOD - Clear CBC pulse when counter //! equals zero or period //! //! \return None. // //************************************************************************** static inline void EPWM_selectCycleByCycleTripZoneClearEvent(uint32_t base, EPWM_CycleByCycleTripZoneClearMode clearEvent) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4490); } } while((_Bool)0); // // Set the Cycle by Cycle Trip Latch mode // __eallow(); (*((volatile uint16_t *)(base + 0x97U))) = (((*((volatile uint16_t *)(base + 0x97U))) & ~0xC000U) | ((uint16_t)clearEvent << 14U)); __edis(); } //***************************************************************************** // //! Clear Trip Zone flag //! //! \param base is the base address of the EPWM module. //! \param tzFlags is the Trip Zone flags. //! //! This function clears the Trip Zone flags //! Valid values for tzFlags are: //! - EPWM_TZ_INTERRUPT - Global Trip Zone interrupt flag //! - EPWM_TZ_FLAG_CBC - Trip Zones Cycle By Cycle flag //! - EPWM_TZ_FLAG_OST - Trip Zones One Shot flag //! - EPWM_TZ_FLAG_DCAEVT1 - Digital Compare A Event 1 flag //! - EPWM_TZ_FLAG_DCAEVT2 - Digital Compare A Event 2 flag //! - EPWM_TZ_FLAG_DCBEVT1 - Digital Compare B Event 1 flag //! - EPWM_TZ_FLAG_DCBEVT2 - Digital Compare B Event 2 flag //! //! \b note: A bitwise OR of the valid values can be passed as the tzFlags //! parameter. //! //! \return None. // //*************************************************************************** static inline void EPWM_clearTripZoneFlag(uint32_t base, uint16_t tzFlags) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4531); } } while((_Bool)0); do { if(!(tzFlags <= 0x80U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4532); } } while((_Bool)0); // // Clear Trip zone event flag // __eallow(); (*((volatile uint16_t *)(base + 0x97U))) |= tzFlags; __edis(); } //***************************************************************************** // //! Clear the Trip Zone Cycle by Cycle flag. //! //! \param base is the base address of the EPWM module. //! \param tzCBCFlags is the CBC flag to be cleared. //! //! This function clears the specific Cycle by Cycle Trip Zone flag. //! The following are valid values for tzCBCFlags. //! - EPWM_TZ_CBC_FLAG_1 - CBC 1 flag //! - EPWM_TZ_CBC_FLAG_2 - CBC 2 flag //! - EPWM_TZ_CBC_FLAG_3 - CBC 3 flag //! - EPWM_TZ_CBC_FLAG_4 - CBC 4 flag //! - EPWM_TZ_CBC_FLAG_5 - CBC 5 flag //! - EPWM_TZ_CBC_FLAG_6 - CBC 6 flag //! - EPWM_TZ_CBC_FLAG_DCAEVT2 - CBC flag Digital compare //! event A2 //! - EPWM_TZ_CBC_FLAG_DCBEVT2 - CBC flag Digital compare //! event B2 //! //! \return None. // //*************************************************************************** static inline void EPWM_clearCycleByCycleTripZoneFlag(uint32_t base, uint16_t tzCBCFlags) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4571); } } while((_Bool)0); do { if(!(tzCBCFlags < 0x800U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4572); } } while((_Bool)0); // // Clear the Cycle By Cycle Trip zone flag // __eallow(); (*((volatile uint16_t *)(base + 0x98U))) |= tzCBCFlags; __edis(); } //***************************************************************************** // //! Clear the Trip Zone One Shot flag. //! //! \param base is the base address of the EPWM module. //! \param tzOSTFlags is the OST flags to be cleared. //! //! This function clears the specific One Shot (OST) Trip Zone flag. //! The following are valid values for tzOSTFlags. //! - EPWM_TZ_OST_FLAG_OST1 - OST flag for OST1 //! - EPWM_TZ_OST_FLAG_OST2 - OST flag for OST2 //! - EPWM_TZ_OST_FLAG_OST3 - OST flag for OST3 //! - EPWM_TZ_OST_FLAG_OST4 - OST flag for OST4 //! - EPWM_TZ_OST_FLAG_OST5 - OST flag for OST5 //! - EPWM_TZ_OST_FLAG_OST6 - OST flag for OST6 //! - EPWM_TZ_OST_FLAG_DCAEVT1 - OST flag for Digital compare event A1 //! - EPWM_TZ_OST_FLAG_DCBEVT1 - OST flag for Digital compare event B1 //! //! \return None. // //*************************************************************************** static inline void EPWM_clearOneShotTripZoneFlag(uint32_t base, uint16_t tzOSTFlags) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4609); } } while((_Bool)0); do { if(!(tzOSTFlags < 0x800U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4610); } } while((_Bool)0); // // Clear the Cycle By Cycle Trip zone flag // __eallow(); (*((volatile uint16_t *)(base + 0x99U))) |= tzOSTFlags; __edis(); } //***************************************************************************** // //! Force Trip Zone events. //! //! \param base is the base address of the EPWM module. //! \param tzForceEvent is the forced Trip Zone event. //! //! This function forces a Trip Zone event. //! Valid values for tzForceEvent are: //! - EPWM_TZ_FORCE_EVENT_CBC - Force Trip Zones Cycle By Cycle event //! - EPWM_TZ_FORCE_EVENT_OST - Force Trip Zones One Shot Event //! - EPWM_TZ_FORCE_EVENT_DCAEVT1 - Force Digital Compare A Event 1 //! - EPWM_TZ_FORCE_EVENT_DCAEVT2 - Force Digital Compare A Event 2 //! - EPWM_TZ_FORCE_EVENT_DCBEVT1 - Force Digital Compare B Event 1 //! - EPWM_TZ_FORCE_EVENT_DCBEVT2 - Force Digital Compare B Event 2 //! //! \return None. // //*************************************************************************** static inline void EPWM_forceTripZoneEvent(uint32_t base, uint16_t tzForceEvent) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4645); } } while((_Bool)0); do { if(!((tzForceEvent & 0xFF81U)== 0U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4646); } } while((_Bool)0); // // Force a Trip Zone event // __eallow(); (*((volatile uint16_t *)(base + 0x9BU))) |= tzForceEvent; __edis(); } // // Event Trigger related APIs // //***************************************************************************** // //! Enable ePWM interrupt. //! //! \param base is the base address of the EPWM module. //! //! This function enables the ePWM interrupt. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableInterrupt(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4676); } } while((_Bool)0); // // Enable ePWM interrupt // (*((volatile uint16_t *)(base + 0xA4U))) |= 0x8U; } //***************************************************************************** // //! disable ePWM interrupt. //! //! \param base is the base address of the EPWM module. //! //! This function disables the ePWM interrupt. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableInterrupt(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4701); } } while((_Bool)0); // // Disable ePWM interrupt // (*((volatile uint16_t *)(base + 0xA4U))) &= ~0x8U; } //***************************************************************************** // //! Sets the ePWM interrupt source. //! //! \param base is the base address of the EPWM module. //! \param interruptSource is the ePWM interrupt source. //! //! This function sets the ePWM interrupt source. //! Valid values for interruptSource are: //! - EPWM_INT_TBCTR_DISABLED - Time-base counter is disabled //! - EPWM_INT_TBCTR_ZERO - Time-base counter equal to zero //! - EPWM_INT_TBCTR_PERIOD - Time-base counter equal to period //! - EPWM_INT_TBCTR_ZERO_OR_PERIOD - Time-base counter equal to zero or //! period //! - EPWM_INT_TBCTR_ZERO_OR_PERIOD - Time-base counter equal to zero or //! period //! - EPWM_INT_TBCTR_U_CMPx - Where x is A,B,C or D //! Time-base counter equal to CMPA, CMPB, //! CMPC or CMPD (depending the value of x) //! when the timer is incrementing //! - EPWM_INT_TBCTR_D_CMPx - Where x is A,B,C or D //! Time-base counter equal to CMPA, CMPB, //! CMPC or CMPD (depending the value of x) //! when the timer is decrementing //! //! \return None. // //***************************************************************************** static inline void EPWM_setInterruptSource(uint32_t base, uint16_t interruptSource) { uint16_t intSource; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4745); } } while((_Bool)0); do { if(!(((interruptSource > 0U) && (interruptSource < 9U)) || (interruptSource == 10U) || (interruptSource == 12U) || (interruptSource == 14U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4748); } } while((_Bool)0); if((interruptSource == 8U) || (interruptSource == 12U) || (interruptSource == 10U) || (interruptSource == 14U)) { // // Shift the interrupt source by 1 // intSource = interruptSource >> 1U; // // Enable events based on comp C or comp D // (*((volatile uint16_t *)(base + 0xA4U))) |= 0x40U; } else if((interruptSource == 4U) || (interruptSource == 6U) || (interruptSource == 5U) || (interruptSource == 7U)) { intSource = interruptSource; // // Enable events based on comp A or comp B // (*((volatile uint16_t *)(base + 0xA4U))) &= ~0x40U; } else { intSource = interruptSource; } // // Set the interrupt source // (*((volatile uint16_t *)(base + 0xA4U))) = (((*((volatile uint16_t *)(base + 0xA4U))) & ~0x7U) | intSource); } //***************************************************************************** // //! Sets the ePWM interrupt event counts. //! //! \param base is the base address of the EPWM module. //! \param eventCount is the event count for interrupt scale //! //! This function sets the interrupt event count that determines the number of //! events that have to occur before an interrupt is issued. //! Maximum value for eventCount is 15. //! //! \return None. // //***************************************************************************** static inline void EPWM_setInterruptEventCount(uint32_t base, uint16_t eventCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4809); } } while((_Bool)0); do { if(!(eventCount < 16U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4810); } } while((_Bool)0); // // Enable advanced feature of interrupt every up to 15 events // (*((volatile uint16_t *)(base + 0xA6U))) |= 0x10U; (*((volatile uint16_t *)(base + 0xAEU))) = (((*((volatile uint16_t *)(base + 0xAEU))) & ~0xFU) | eventCount); } //***************************************************************************** // //! Return the interrupt status. //! //! \param base is the base address of the EPWM module. //! //! This function returns the ePWM interrupt status. //! \b Note This function doesn't return the Trip Zone status. //! //! \return Returns true if ePWM interrupt was generated. //! Returns false if no interrupt was generated // //***************************************************************************** static inline _Bool EPWM_getEventTriggerInterruptStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4840); } } while((_Bool)0); // // Return INT bit of ETFLG register // return((((*((volatile uint16_t *)(base + 0xA8U))) & 0x1U) == 0x1U) ? 1 : 0); } //***************************************************************************** // //! Clear interrupt flag. //! //! \param base is the base address of the EPWM module. //! //! This function clears the ePWM interrupt flag. //! //! \return None // //***************************************************************************** static inline void EPWM_clearEventTriggerInterruptFlag(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4865); } } while((_Bool)0); // // Clear INT bit of ETCLR register // (*((volatile uint16_t *)(base + 0xAAU))) |= 0x1U; } //***************************************************************************** // //! Enable Pre-interrupt count load. //! //! \param base is the base address of the EPWM module. //! //! This function enables the ePWM interrupt counter to be pre-interrupt loaded //! with a count value. //! //! \note This is valid only for advanced/expanded interrupt mode //! //! \return None. // //***************************************************************************** static inline void EPWM_enableInterruptEventCountInit(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4893); } } while((_Bool)0); // // Enable interrupt event count initializing/loading // (*((volatile uint16_t *)(base + 0xB2U))) |= 0x2000U; } //***************************************************************************** // //! Disable interrupt count load. //! //! \param base is the base address of the EPWM module. //! //! This function disables the ePWM interrupt counter from being loaded with //! pre-interrupt count value. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableInterruptEventCountInit(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4919); } } while((_Bool)0); // // Disable interrupt event count initializing/loading // (*((volatile uint16_t *)(base + 0xB2U))) &= ~0x2000U; } //***************************************************************************** // //! Force a software pre interrupt event counter load. //! //! \param base is the base address of the EPWM module. //! //! This function forces the ePWM interrupt counter to be loaded with the //! contents set by EPWM_setPreInterruptEventCount(). //! //! \note make sure the EPWM_enablePreInterruptEventCountLoad() function is //! is called before invoking this function. //! //! \return None. // //***************************************************************************** static inline void EPWM_forceInterruptEventCountInit(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4948); } } while((_Bool)0); // // Load the Interrupt Event counter value // (*((volatile uint16_t *)(base + 0xB2U))) |= 0x400U; } //***************************************************************************** // //! Set interrupt count. //! //! \param base is the base address of the EPWM module. //! \param eventCount is the ePWM interrupt count value. //! //! This function sets the ePWM interrupt count. eventCount is the value of the //! pre-interrupt value that is to be loaded. The maximum value of eventCount //! is 15. //! //! \return None. // //***************************************************************************** static inline void EPWM_setInterruptEventCountInitValue(uint32_t base, uint16_t eventCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4976); } } while((_Bool)0); do { if(!(eventCount < 16U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 4977); } } while((_Bool)0); // // Set the Pre-interrupt event count // (*((volatile uint16_t *)(base + 0xB4U))) = (((*((volatile uint16_t *)(base + 0xB4U))) & ~0xFU) | (uint16_t)(eventCount & 0xFU)); } //***************************************************************************** // //! Get the interrupt count. //! //! \param base is the base address of the EPWM module. //! //! This function returns the ePWM interrupt event count. //! //! \return The interrupt event counts that have occurred. // //***************************************************************************** static inline uint16_t EPWM_getInterruptEventCount(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5004); } } while((_Bool)0); // // Return the interrupt event count // return((((*((volatile uint16_t *)(base + 0xAEU))) & 0xF0U) >> 4U)); } //***************************************************************************** // //! Force ePWM interrupt. //! //! \param base is the base address of the EPWM module. //! //! This function forces an ePWM interrupt. //! //! \return None // //***************************************************************************** static inline void EPWM_forceEventTriggerInterrupt(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5030); } } while((_Bool)0); // // Set INT bit of ETFRC register // (*((volatile uint16_t *)(base + 0xACU))) |= 0x1U; } // // ADC SOC configuration related APIs // //***************************************************************************** // //! Enable ADC SOC event. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function enables the ePWM module to trigger an ADC SOC event. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \return None. // //***************************************************************************** static inline void EPWM_enableADCTrigger(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5062); } } while((_Bool)0); // // Enable an SOC // if(adcSOCType == EPWM_SOC_A) { (*((volatile uint16_t *)(base + 0xA4U))) |= 0x800U; } else { (*((volatile uint16_t *)(base + 0xA4U))) |= 0x8000U; } } //***************************************************************************** // //! Disable ADC SOC event. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function disables the ePWM module from triggering an ADC SOC event. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \return None. // //***************************************************************************** static inline void EPWM_disableADCTrigger(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5098); } } while((_Bool)0); // // Disable an SOC // if(adcSOCType == EPWM_SOC_A) { (*((volatile uint16_t *)(base + 0xA4U))) &= ~0x800U; } else { (*((volatile uint16_t *)(base + 0xA4U))) &= ~0x8000U; } } //***************************************************************************** // //! Sets the ePWM SOC source. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! \param socSource is the SOC source. //! //! This function sets the ePWM ADC SOC source. //! Valid values for socSource are: //! - adcSOCType //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! - socSource //! - EPWM_SOC_DCxEVT1 - Event is based on DCxEVT1 //! - EPWM_SOC_TBCTR_ZERO - Time-base counter equal to zero //! - EPWM_SOC_TBCTR_PERIOD - Time-base counter equal to period //! - EPWM_SOC_TBCTR_ZERO_OR_PERIOD - Time-base counter equal to zero or //! period //! - EPWM_SOC_TBCTR_U_CMPx - Where x is A,B,C or D //! Time-base counter equal to CMPA, CMPB, //! CMPC or CMPD(depending the value of x) //! when the timer is incrementing //! - EPWM_SOC_TBCTR_D_CMPx - Where x is A,B,C or D //! Time-base counter equal to CMPA, CMPB, //! CMPC or CMPD(depending the value of x) //! when the timer is decrementing //! //! \return None. // //***************************************************************************** static inline void EPWM_setADCTriggerSource(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType, EPWM_ADCStartOfConversionSource socSource) { uint16_t source; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5154); } } while((_Bool)0); if((socSource == EPWM_SOC_TBCTR_U_CMPC) || (socSource == EPWM_SOC_TBCTR_U_CMPD) || (socSource == EPWM_SOC_TBCTR_D_CMPC) || (socSource == EPWM_SOC_TBCTR_D_CMPD)) { source = (uint16_t)socSource >> 1U; } else { source = (uint16_t)socSource; } if(adcSOCType == EPWM_SOC_A) { // // Set the SOC source // (*((volatile uint16_t *)(base + 0xA4U))) = (((*((volatile uint16_t *)(base + 0xA4U))) & ~0x700U) | (source << 8U)); // // Enable the comparator selection // if((socSource == EPWM_SOC_TBCTR_U_CMPA) || (socSource == EPWM_SOC_TBCTR_U_CMPB) || (socSource == EPWM_SOC_TBCTR_D_CMPA) || (socSource == EPWM_SOC_TBCTR_D_CMPB)) { // // Enable events based on comp A or comp B // (*((volatile uint16_t *)(base + 0xA4U))) &= ~0x10U; } else if((socSource == EPWM_SOC_TBCTR_U_CMPC) || (socSource == EPWM_SOC_TBCTR_U_CMPD) || (socSource == EPWM_SOC_TBCTR_D_CMPC) || (socSource == EPWM_SOC_TBCTR_D_CMPD)) { // // Enable events based on comp C or comp D // (*((volatile uint16_t *)(base + 0xA4U))) |= 0x10U; } else { // // No action required for the other socSource options // } } else { // // Enable the comparator selection // (*((volatile uint16_t *)(base + 0xA4U))) = (((*((volatile uint16_t *)(base + 0xA4U))) & ~0x7000U) | (source << 12U)); // // Enable the comparator selection // if((socSource == EPWM_SOC_TBCTR_U_CMPA) || (socSource == EPWM_SOC_TBCTR_U_CMPB) || (socSource == EPWM_SOC_TBCTR_D_CMPA) || (socSource == EPWM_SOC_TBCTR_D_CMPB)) { // // Enable events based on comp A or comp B // (*((volatile uint16_t *)(base + 0xA4U))) &= ~0x20U; } else if((socSource == EPWM_SOC_TBCTR_U_CMPC) || (socSource == EPWM_SOC_TBCTR_U_CMPD) || (socSource == EPWM_SOC_TBCTR_D_CMPC) || (socSource == EPWM_SOC_TBCTR_D_CMPD)) { // // Enable events based on comp C or comp D // (*((volatile uint16_t *)(base + 0xA4U))) |= 0x20U; } else { // // No action required for the other socSource options // } } } //***************************************************************************** // //! Sets the ePWM SOC event counts. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! \param preScaleCount is the event count number. //! //! This function sets the SOC event count that determines the number of //! events that have to occur before an SOC is issued. //! Valid values for the parameters are: //! - adcSOCType //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! - preScaleCount //! - [1 - 15] - Generate SOC pulse every preScaleCount //! up to 15 events. //! //! \note A preScaleCount value of 0 disables the prescale. //! //! \return None. // //***************************************************************************** static inline void EPWM_setADCTriggerEventPrescale(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType, uint16_t preScaleCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5279); } } while((_Bool)0); do { if(!(preScaleCount < 16U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5280); } } while((_Bool)0); // // Enable advanced feature of SOC every up to 15 events // (*((volatile uint16_t *)(base + 0xA6U))) |= 0x20U; if(adcSOCType == EPWM_SOC_A) { // // Set the count for SOC A // (*((volatile uint16_t *)(base + 0xB0U))) = (((*((volatile uint16_t *)(base + 0xB0U))) & ~0xFU) | preScaleCount); } else { // // Set the count for SOC B // (*((volatile uint16_t *)(base + 0xB0U))) = (((*((volatile uint16_t *)(base + 0xB0U))) & ~0xF00U) | (preScaleCount << 8U)); } } //***************************************************************************** // //! Return the SOC event status. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function returns the ePWM SOC status. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \return Returns true if the selected adcSOCType SOC was generated. //! Returns false if the selected adcSOCType SOC was not generated. // //***************************************************************************** static inline _Bool EPWM_getADCTriggerFlagStatus(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5329); } } while((_Bool)0); // // Return the SOC A/ B status // return(((((*((volatile uint16_t *)(base + 0xA8U))) >> ((uint16_t)adcSOCType + 2U)) & 0x1U) == 0x1U) ? 1 : 0); } //***************************************************************************** // //! Clear SOC flag. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function clears the ePWM SOC flag. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \return None // //***************************************************************************** static inline void EPWM_clearADCTriggerFlag(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5360); } } while((_Bool)0); // // Clear SOC A/B bit of ETCLR register // (*((volatile uint16_t *)(base + 0xAAU))) |= 1U << ((uint16_t)adcSOCType + 2U); } //***************************************************************************** // //! Enable Pre-SOC event count load. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function enables the ePWM SOC event counter which is set by the //! EPWM_setADCTriggerEventCountInitValue() function to be loaded before //! an SOC event. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \note This is valid only for advanced/expanded SOC mode //! //! \return None. // //***************************************************************************** static inline void EPWM_enableADCTriggerEventCountInit(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5394); } } while((_Bool)0); // // Enable SOC event count initializing/loading // (*((volatile uint16_t *)(base + 0xB2U))) |= 1U << ((uint16_t)adcSOCType + 14U); } //***************************************************************************** // //! Disable Pre-SOC event count load. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function disables the ePWM SOC event counter from being loaded before //! an SOC event (only an SOC event causes an increment of the counter value). //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \note This is valid only for advanced/expanded SOC mode //! //! \return None. // //***************************************************************************** static inline void EPWM_disableADCTriggerEventCountInit(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5427); } } while((_Bool)0); // // Disable SOC event count initializing/loading // (*((volatile uint16_t *)(base + 0xB2U))) &= ~(1U << ((uint16_t)adcSOCType + 14U)); } //***************************************************************************** // //! Force a software pre SOC event counter load. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type //! //! This function forces the ePWM SOC counter to be loaded with the //! contents set by EPWM_setPreADCStartOfConversionEventCount(). //! //! \note make sure the EPWM_enableADCTriggerEventCountInit() //! function is called before invoking this function. //! //! \return None. // //***************************************************************************** static inline void EPWM_forceADCTriggerEventCountInit(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5459); } } while((_Bool)0); // // Load the Interrupt Event counter value // (*((volatile uint16_t *)(base + 0xB2U))) |= 1U << ((uint16_t)adcSOCType + 11U); } //***************************************************************************** // //! Set ADC Trigger count values. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! \param eventCount is the ePWM interrupt count value. //! //! This function sets the ePWM ADC Trigger count values. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! The eventCount has a maximum value of 15. //! //! \return None. // //***************************************************************************** static inline void EPWM_setADCTriggerEventCountInitValue(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType, uint16_t eventCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5492); } } while((_Bool)0); do { if(!(eventCount < 16U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5493); } } while((_Bool)0); // // Set the ADC Trigger event count // if(adcSOCType == EPWM_SOC_A) { (*((volatile uint16_t *)(base + 0xB4U))) = (((*((volatile uint16_t *)(base + 0xB4U))) & ~0xF0U) | (uint16_t)(eventCount << 4U)); } else { (*((volatile uint16_t *)(base + 0xB4U))) = (((*((volatile uint16_t *)(base + 0xB4U))) & ~0xF00U) | (eventCount << 8U)); } } //***************************************************************************** // //! Get the SOC event count. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function returns the ePWM SOC event count. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \return The SOC event counts that have occurred. // //***************************************************************************** static inline uint16_t EPWM_getADCTriggerEventCount(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { uint16_t eventCount; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5536); } } while((_Bool)0); // // Return the SOC event count // if(adcSOCType == EPWM_SOC_A) { eventCount = ((*((volatile uint16_t *)(base + 0xB0U))) >> 4U) & 0xFU; } else { eventCount = ((*((volatile uint16_t *)(base + 0xB0U))) >> 12U) & 0xFU; } return(eventCount); } //***************************************************************************** // //! Force SOC event. //! //! \param base is the base address of the EPWM module. //! \param adcSOCType is the ADC SOC type. //! //! This function forces an ePWM SOC event. //! Valid values for adcSOCType are: //! - EPWM_SOC_A - SOC A //! - EPWM_SOC_B - SOC B //! //! \return None // //***************************************************************************** static inline void EPWM_forceADCTrigger(uint32_t base, EPWM_ADCStartOfConversionType adcSOCType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5575); } } while((_Bool)0); // // Set SOC A/B bit of ETFRC register // (*((volatile uint16_t *)(base + 0xACU))) |= 1U << ((uint16_t)adcSOCType + 2U); } // // Digital Compare module related APIs // //***************************************************************************** // //! Set the DC trip input. //! //! \param base is the base address of the EPWM module. //! \param tripSource is the tripSource. //! \param dcType is the Digital Compare type. //! //! This function sets the trip input to the Digital Compare (DC). For a given //! dcType the function sets the tripSource to be the input to the DC. //! Valid values for the parameter are: //! - tripSource //! - EPWM_DC_TRIP_TRIPINx - Trip x,where x ranges from 1 to 15 excluding 13 //! - EPWM_DC_TRIP_COMBINATION - selects all the Trip signals whose input //! is enabled by the following function //! EPWM_enableDigitalCompareTripCombinationInput() //! - dcType //! - EPWM_DC_TYPE_DCAH - Digital Compare A High //! - EPWM_DC_TYPE_DCAL - Digital Compare A Low //! - EPWM_DC_TYPE_DCBH - Digital Compare B High //! - EPWM_DC_TYPE_DCBL - Digital Compare B Low //! //! \return None // //***************************************************************************** static inline void EPWM_selectDigitalCompareTripInput(uint32_t base, EPWM_DigitalCompareTripInput tripSource, EPWM_DigitalCompareType dcType) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5619); } } while((_Bool)0); // // Set the DC trip input // __eallow(); (*((volatile uint16_t *)(base + 0xC0U))) = (((*((volatile uint16_t *)(base + 0xC0U))) & ~(0xFU << ((uint16_t)dcType << 2U))) | ((uint16_t)tripSource << ((uint16_t)dcType << 2U))); __edis(); } // // DCFILT // //***************************************************************************** // //! Enable DC filter blanking window. //! //! \param base is the base address of the EPWM module. //! //! This function enables the DC filter blanking window. //! //! \return None // //***************************************************************************** static inline void EPWM_enableDigitalCompareBlankingWindow(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5651); } } while((_Bool)0); // // Enable DC filter blanking window // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) |= 0x4U; __edis(); } //***************************************************************************** // //! Disable DC filter blanking window. //! //! \param base is the base address of the EPWM module. //! //! This function disables the DC filter blanking window. //! //! \return None // //***************************************************************************** static inline void EPWM_disableDigitalCompareBlankingWindow(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5678); } } while((_Bool)0); // // Disable DC filter blanking window // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) &= ~0x4U; __edis(); } //***************************************************************************** // //! Enable Digital Compare Window inverse mode. //! //! \param base is the base address of the EPWM module. //! //! This function enables the Digital Compare Window inverse mode. This will //! invert the blanking window. //! //! \return None // //***************************************************************************** static inline void EPWM_enableDigitalCompareWindowInverseMode(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5706); } } while((_Bool)0); // // Enable DC window inverse mode. // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) |= 0x8U; __edis(); } //***************************************************************************** // //! Disable Digital Compare Window inverse mode. //! //! \param base is the base address of the EPWM module. //! //! This function disables the Digital Compare Window inverse mode. //! //! \return None // //***************************************************************************** static inline void EPWM_disableDigitalCompareWindowInverseMode(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5733); } } while((_Bool)0); // // Disable DC window inverse mode. // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) &= ~0x8U; __edis(); } //***************************************************************************** // //! Set the Digital Compare filter blanking pulse. //! //! \param base is the base address of the EPWM module. //! \param blankingPulse is Pulse that starts blanking window. //! //! This function sets the input pulse that starts the Digital Compare blanking //! window. //! Valid values for blankingPulse are: //! - EPWM_DC_WINDOW_START_TBCTR_PERIOD - Time base counter equals period //! - EPWM_DC_WINDOW_START_TBCTR_ZERO - Time base counter equals zero //! - EPWM_DC_WINDOW_START_TBCTR_ZERO_PERIOD - Time base counter equals zero //! or period. //! //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareBlankingEvent(uint32_t base, EPWM_DigitalCompareBlankingPulse blankingPulse) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5768); } } while((_Bool)0); // // Set DC blanking event // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) = (((*((volatile uint16_t *)(base + 0xC7U))) & ~0x30U) | ((uint16_t)((uint32_t)blankingPulse << 4U))); __edis(); } //***************************************************************************** // //! Set up the Digital Compare filter input. //! //! \param base is the base address of the EPWM module. //! \param filterInput is Digital Compare signal source. //! //! This function sets the signal input source that will be filtered by the //! Digital Compare module. //! Valid values for filterInput are: //! - EPWM_DC_WINDOW_SOURCE_DCAEVT1 - DC filter signal source is DCAEVT1 //! - EPWM_DC_WINDOW_SOURCE_DCAEVT2 - DC filter signal source is DCAEVT2 //! - EPWM_DC_WINDOW_SOURCE_DCBEVT1 - DC filter signal source is DCBEVT1 //! - EPWM_DC_WINDOW_SOURCE_DCBEVT2 - DC filter signal source is DCBEVT2 //! //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareFilterInput(uint32_t base, EPWM_DigitalCompareFilterInput filterInput) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5805); } } while((_Bool)0); // // Set the signal source that will be filtered // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) = (((*((volatile uint16_t *)(base + 0xC7U))) & ~0x3U) | ((uint16_t)filterInput)); __edis(); } // // DC Edge Filter // //***************************************************************************** // //! Enable Digital Compare Edge Filter. //! //! \param base is the base address of the EPWM module. //! //! This function enables the Digital Compare Edge filter to generate event //! after configured number of edges. //! //! \return None // //***************************************************************************** static inline void EPWM_enableDigitalCompareEdgeFilter(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5838); } } while((_Bool)0); // // Enable DC Edge Filter // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) |= 0x40U; __edis(); } //***************************************************************************** // //! Disable Digital Compare Edge Filter. //! //! \param base is the base address of the EPWM module. //! //! This function disables the Digital Compare Edge filter. //! //! \return None // //***************************************************************************** static inline void EPWM_disableDigitalCompareEdgeFilter(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5865); } } while((_Bool)0); // // Disable DC Edge Filter // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) &= ~0x40U; __edis(); } //***************************************************************************** // //! Set the Digital Compare Edge Filter Mode. //! //! \param base is the base address of the EPWM module. //! \param edgeMode is Digital Compare Edge filter mode. //! //! This function sets the Digital Compare Event filter mode. Valid values //! for edgeMode are: //! - EPWM_DC_EDGEFILT_MODE_RISING - DC edge filter mode is rising edge //! - EPWM_DC_EDGEFILT_MODE_FALLING - DC edge filter mode is falling edge //! - EPWM_DC_EDGEFILT_MODE_BOTH - DC edge filter mode is both edges //! //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareEdgeFilterMode(uint32_t base, EPWM_DigitalCompareEdgeFilterMode edgeMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5898); } } while((_Bool)0); // // Set DC Edge filter mode // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) = ((*((volatile uint16_t *)(base + 0xC7U))) & ~0x300U) | ((uint16_t)edgeMode << 8U); __edis(); } //***************************************************************************** // //! Set the Digital Compare Edge Filter Edge Count. //! //! \param base is the base address of the EPWM module. //! \param edgeCount is Digital Compare event filter count //! //! This function sets the Digital Compare Event filter Edge Count to generate //! events. Valid values for edgeCount can be: //! - EPWM_DC_EDGEFILT_EDGECNT_0 - No edge is required to generate event //! - EPWM_DC_EDGEFILT_EDGECNT_1 - 1 edge is required for event generation //! - EPWM_DC_EDGEFILT_EDGECNT_2 - 2 edges are required for event generation //! - EPWM_DC_EDGEFILT_EDGECNT_3 - 3 edges are required for event generation //! - EPWM_DC_EDGEFILT_EDGECNT_4 - 4 edges are required for event generation //! - EPWM_DC_EDGEFILT_EDGECNT_5 - 5 edges are required for event generation //! - EPWM_DC_EDGEFILT_EDGECNT_6 - 6 edges are required for event generation //! - EPWM_DC_EDGEFILT_EDGECNT_7 - 7 edges are required for event generation //! //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareEdgeFilterEdgeCount(uint32_t base, uint16_t edgeCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5937); } } while((_Bool)0); // // Set DC Edge filter edge count // __eallow(); (*((volatile uint16_t *)(base + 0xC7U))) = ((*((volatile uint16_t *)(base + 0xC7U))) & ~0x1C00U) | (edgeCount << 10U); __edis(); } //***************************************************************************** // //! Returns the Digital Compare Edge Filter Edge Count. //! //! \param base is the base address of the EPWM module. //! //! This function returns the configured Digital Compare Edge filter edge //! count required to generate events. It can return values from 0-7. //! //! \return Returns the configured DigitalCompare Edge filter edge count. // //***************************************************************************** static inline uint16_t EPWM_getDigitalCompareEdgeFilterEdgeCount(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5967); } } while((_Bool)0); // // Return configured DC edge filter edge count // return(((*((volatile uint16_t *)(base + 0xC7U))) & 0x1C00U) >> 10U); } //***************************************************************************** // //! Returns the Digital Compare Edge filter captured edge count status. //! //! \param base is the base address of the EPWM module. //! //! This function returns the count of edges captured by Digital Compare Edge //! filter. It can return values from 0-7. //! //! \return Returns the count of captured edges // //***************************************************************************** static inline uint16_t EPWM_getDigitalCompareEdgeFilterEdgeStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 5994); } } while((_Bool)0); // // Return captured edge count by DC Edge filter // return(((*((volatile uint16_t *)(base + 0xC7U))) & 0xE000U) >> 13U); } //***************************************************************************** // //! Set up the Digital Compare filter window offset //! //! \param base is the base address of the EPWM module. //! \param windowOffsetCount is blanking window offset length. //! //! This function sets the offset between window start pulse and blanking //! window in TBCLK count. //! The function take a 16bit count value for the offset value. //! //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareWindowOffset(uint32_t base, uint16_t windowOffsetCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6023); } } while((_Bool)0); // // Set the blanking window offset in TBCLK counts // (*((volatile uint16_t *)(base + 0xC9U))) = windowOffsetCount; } //***************************************************************************** // //! Set up the Digital Compare filter window length //! //! \param base is the base address of the EPWM module. //! \param windowLengthCount is blanking window length. //! //! This function sets up the Digital Compare filter blanking window length in //! TBCLK count.The function takes a 16bit count value for the window length. //! //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareWindowLength(uint32_t base, uint16_t windowLengthCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6050); } } while((_Bool)0); // // Set the blanking window length in TBCLK counts // (*((volatile uint16_t *)(base + 0xCBU))) = windowLengthCount; } //***************************************************************************** // //! Return DC filter blanking window offset count. //! //! \param base is the base address of the EPWM module. //! //! This function returns DC filter blanking window offset count. //! //! \return None // //***************************************************************************** static inline uint16_t EPWM_getDigitalCompareBlankingWindowOffsetCount(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6075); } } while((_Bool)0); // // Return the Blanking Window Offset count // return((*((volatile uint16_t *)(base + 0xCAU)))); } //***************************************************************************** // //! Return DC filter blanking window length count. //! //! \param base is the base address of the EPWM module. //! //! This function returns DC filter blanking window length count. //! //! \return None // //***************************************************************************** static inline uint16_t EPWM_getDigitalCompareBlankingWindowLengthCount(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6100); } } while((_Bool)0); // // Return the Blanking Window Length count // return((*((volatile uint16_t *)(base + 0xCCU)))); } //***************************************************************************** // //! Set up the Digital Compare Event source. //! //! \param base is the base address of the EPWM module. //! \param dcModule is the Digital Compare module. //! \param dcEvent is the Digital Compare Event number. //! \param dcEventSource is the - Digital Compare Event source. //! //! This function sets up the Digital Compare module Event sources. //! The following are valid values for the parameters. //! - dcModule //! - EPWM_DC_MODULE_A - Digital Compare Module A //! - EPWM_DC_MODULE_B - Digital Compare Module B //! - dcEvent //! - EPWM_DC_EVENT_1 - Digital Compare Event number 1 //! - EPWM_DC_EVENT_2 - Digital Compare Event number 2 //! - dcEventSource //! - EPWM_DC_EVENT_SOURCE_FILT_SIGNAL - signal source is filtered //! \note The signal source for this option is DCxEVTy, where the //! value of x is dependent on dcModule and the value of y is //! dependent on dcEvent. Possible signal sources are DCAEVT1, //! DCBEVT1, DCAEVT2 or DCBEVT2 depending on the value of both //! dcModule and dcEvent. //! - EPWM_DC_EVENT_SOURCE_ORIG_SIGNAL - signal source is unfiltered //! The signal source for this option is DCxEVTy. //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareEventSource(uint32_t base, EPWM_DigitalCompareModule dcModule, EPWM_DigitalCompareEvent dcEvent, EPWM_DigitalCompareEventSource dcEventSource) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6148); } } while((_Bool)0); registerOffset = 0xC3U + (uint32_t)dcModule; // // Set the DC event 1 source source // __eallow(); if(dcEvent == EPWM_DC_EVENT_1) { (*((volatile uint16_t *)(base + registerOffset))) = (((*((volatile uint16_t *)(base + registerOffset))) & ~0x1U) | (uint16_t)dcEventSource); } else { (*((volatile uint16_t *)(base + registerOffset))) = (((*((volatile uint16_t *)(base + registerOffset))) & ~0x100U) | ((uint16_t)dcEventSource << 8U)); } __edis(); } //***************************************************************************** // //! Set up the Digital Compare input sync mode. //! //! \param base is the base address of the EPWM module. //! \param dcModule is the Digital Compare module. //! \param dcEvent is the Digital Compare Event number. //! \param syncMode is the Digital Compare Event sync mode. //! //! This function sets up the Digital Compare module Event sources. //! The following are valid values for the parameters. //! - dcModule //! - EPWM_DC_MODULE_A - Digital Compare Module A //! - EPWM_DC_MODULE_B - Digital Compare Module B //! - dcEvent //! - EPWM_DC_EVENT_1 - Digital Compare Event number 1 //! - EPWM_DC_EVENT_2 - Digital Compare Event number 2 //! - syncMode //! - EPWM_DC_EVENT_INPUT_SYNCED - DC input signal is synced with //! TBCLK //! - EPWM_DC_EVENT_INPUT_NOT SYNCED - DC input signal is not synced with //! TBCLK //! //! \return None // //***************************************************************************** static inline void EPWM_setDigitalCompareEventSyncMode(uint32_t base, EPWM_DigitalCompareModule dcModule, EPWM_DigitalCompareEvent dcEvent, EPWM_DigitalCompareSyncMode syncMode) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6208); } } while((_Bool)0); registerOffset = 0xC3U + (uint32_t)dcModule; // // Set the DC event sync mode // __eallow(); if(dcEvent == EPWM_DC_EVENT_1) { (*((volatile uint16_t *)(base + registerOffset))) = (((*((volatile uint16_t *)(base + registerOffset))) & ~0x2U) | ((uint16_t)syncMode << 1U)); } else { (*((volatile uint16_t *)(base + registerOffset))) = (((*((volatile uint16_t *)(base + registerOffset))) & ~0x200U) | ((uint16_t)syncMode << 9U)); } __edis(); } //***************************************************************************** // //! Enable Digital Compare to generate Start of Conversion. //! //! \param base is the base address of the EPWM module. //! \param dcModule is the Digital Compare module. //! //! This function enables the Digital Compare Event 1 to generate Start of //! Conversion. //! The following are valid values for the \e dcModule parameter. //! - EPWM_DC_MODULE_A - Digital Compare Module A //! - EPWM_DC_MODULE_B - Digital Compare Module B //! //! \return None // //***************************************************************************** static inline void EPWM_enableDigitalCompareADCTrigger(uint32_t base, EPWM_DigitalCompareModule dcModule) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6256); } } while((_Bool)0); registerOffset = 0xC3U + (uint32_t)dcModule; // // Enable Digital Compare start of conversion generation // __eallow(); (*((volatile uint16_t *)(base + registerOffset))) = ((*((volatile uint16_t *)(base + registerOffset))) | 0x4U); __edis(); } //***************************************************************************** // //! Disable Digital Compare from generating Start of Conversion. //! //! \param base is the base address of the EPWM module. //! \param dcModule is the Digital Compare module. //! //! This function disables the Digital Compare Event 1 from generating Start of //! Conversion. //! The following are valid values for the \e dcModule parameter. //! - EPWM_DC_MODULE_A - Digital Compare Module A //! - EPWM_DC_MODULE_B - Digital Compare Module B //! //! \return None // //***************************************************************************** static inline void EPWM_disableDigitalCompareADCTrigger(uint32_t base, EPWM_DigitalCompareModule dcModule) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6294); } } while((_Bool)0); registerOffset = 0xC3U + (uint32_t)dcModule; // // Disable Digital Compare start of conversion generation // __eallow(); (*((volatile uint16_t *)(base + registerOffset))) = ((*((volatile uint16_t *)(base + registerOffset))) & ~0x4U); __edis(); } //***************************************************************************** // //! Enable Digital Compare to generate sync out pulse. //! //! \param base is the base address of the EPWM module. //! \param dcModule is the Digital Compare module. //! //! This function enables the Digital Compare Event 1 to generate sync out //! pulse //! The following are valid values for the \e dcModule parameter. //! - EPWM_DC_MODULE_A - Digital Compare Module A //! - EPWM_DC_MODULE_B - Digital Compare Module B //! //! \return None // //***************************************************************************** static inline void EPWM_enableDigitalCompareSyncEvent(uint32_t base, EPWM_DigitalCompareModule dcModule) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6332); } } while((_Bool)0); registerOffset = 0xC3U + (uint32_t)dcModule; // // Enable Digital Compare sync out pulse generation // __eallow(); (*((volatile uint16_t *)(base + registerOffset))) = ((*((volatile uint16_t *)(base + registerOffset))) | 0x8U); __edis(); } //***************************************************************************** // //! Disable Digital Compare from generating Start of Conversion. //! //! \param base is the base address of the EPWM module. //! \param dcModule is the Digital Compare module. //! //! This function disables the Digital Compare Event 1 from generating synch //! out pulse. //! The following are valid values for the \e dcModule parameters. //! - EPWM_DC_MODULE_A - Digital Compare Module A //! - EPWM_DC_MODULE_B - Digital Compare Module B //! //! \return None // //***************************************************************************** static inline void EPWM_disableDigitalCompareSyncEvent(uint32_t base, EPWM_DigitalCompareModule dcModule) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6370); } } while((_Bool)0); registerOffset = 0xC3U + (uint32_t)dcModule; // // Disable Digital Compare sync out pulse generation // __eallow(); (*((volatile uint16_t *)(base + registerOffset))) = ((*((volatile uint16_t *)(base + registerOffset))) & ~0x8U); __edis(); } // // DC capture mode // //***************************************************************************** // //! Enables the Time Base Counter Capture controller. //! //! \param base is the base address of the EPWM module. //! //! This function enables the time Base Counter Capture. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableDigitalCompareCounterCapture(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6403); } } while((_Bool)0); // // Enable Time base counter capture // __eallow(); (*((volatile uint16_t *)(base + 0xC8U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disables the Time Base Counter Capture controller. //! //! \param base is the base address of the EPWM module. //! //! This function disable the time Base Counter Capture. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableDigitalCompareCounterCapture(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6430); } } while((_Bool)0); // // Disable Time base counter capture // __eallow(); (*((volatile uint16_t *)(base + 0xC8U))) &= ~0x1U; __edis(); } //***************************************************************************** // //! Set the Time Base Counter Capture mode. //! //! \param base is the base address of the EPWM module. //! \param enableShadowMode is the shadow read mode flag. //! //! This function sets the mode the Time Base Counter value is read from. If //! enableShadowMode is true, CPU reads of the DCCAP register will return the //! shadow register contents.If enableShadowMode is false, CPU reads of the //! DCCAP register will return the active register contents. //! //! \return None. // //***************************************************************************** static inline void EPWM_setDigitalCompareCounterShadowMode(uint32_t base, _Bool enableShadowMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6461); } } while((_Bool)0); __eallow(); if(enableShadowMode) { // // Enable DC counter shadow mode // (*((volatile uint16_t *)(base + 0xC8U))) &= ~0x2U; } else { // // Disable DC counter shadow mode // (*((volatile uint16_t *)(base + 0xC8U))) |= 0x2U; } __edis(); } //***************************************************************************** // //! Return the DC Capture event status. //! //! \param base is the base address of the EPWM module. //! //! This function returns the DC capture event status. //! //! \return Returns true if a DC capture event has occurs. //! Returns false if no DC Capture event has occurred. //! //! \return None. // //***************************************************************************** static inline _Bool EPWM_getDigitalCompareCaptureStatus(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6501); } } while((_Bool)0); // // Return the DC compare status // return(((*((volatile uint16_t *)(base + 0xC8U))) & 0x2000U) == 0x2000U); } //***************************************************************************** // //! Clears DC capture latched status flag //! //! \param base is the base address of the EPWM module. //! This function is used to clear the CAPSTS (set) condition. //! //! \return None. //***************************************************************************** static inline void EPWM_clearDigitalCompareCaptureStatusFlag(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6525); } } while((_Bool)0); // // Clear digital compare capture status flag // __eallow(); (*((volatile uint16_t *)(base + 0xC8U))) &= ~0x4000U; __edis(); } //***************************************************************************** // //! Configures DC capture operating mode //! //! \param base is the base address of the EPWM module. //! \param disableClearMode is the clear mode bit. //! //! This function is used to configure the DC capture operating mode. If //! \e disableClearMode is false, the TBCNT value is captured in active register //! on occurance of DCEVTFILT event. The trip events are ignored until next //! PRD or ZRO event re-triggers the capture mechanism. //! If \e disableClearMode is true, the TBCNT value is captured, CAPSTS flag is //! set and further trips are ignored until CAPSTS bit is cleared. //! //! \return None. //***************************************************************************** static inline void EPWM_configureDigitalCompareCounterCaptureMode(uint32_t base, _Bool disableClearMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6558); } } while((_Bool)0); __eallow(); if(disableClearMode) { // // Disable DC counter auto-clear on PULSESEL event // (*((volatile uint16_t *)(base + 0xC8U))) |= 0x8000U; } else { // // Enable DC counter clear on PULSESEL events // (*((volatile uint16_t *)(base + 0xC8U))) &= ~0x8000U; } __edis(); } //***************************************************************************** // //! Return the DC Time Base Counter capture value. //! //! \param base is the base address of the EPWM module. //! //! This function returns the DC Time Base Counter capture value. The value //! read is determined by the mode as set in the //! EPWM_setTimeBaseCounterReadMode() function. //! //! \return Returns the DC Time Base Counter Capture count value. // //***************************************************************************** static inline uint16_t EPWM_getDigitalCompareCaptureCount(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6597); } } while((_Bool)0); // // Return the DC Time Base Counter Capture count value // return((*((volatile uint16_t *)(base + 0xCFU)))); } //***************************************************************************** // //! Enable DC TRIP combinational input. //! //! \param base is the base address of the EPWM module. //! \param tripInput is the Trip number. //! \param dcType is the Digital Compare module. //! //! This function enables the specified Trip input. //! Valid values for the parameters are: //! - tripInput //! - EPWM_DC_COMBINATIONAL_TRIPINx, where x is 1,2,...12,14,15 //! - dcType //! - EPWM_DC_TYPE_DCAH - Digital Compare A High //! - EPWM_DC_TYPE_DCAL - Digital Compare A Low //! - EPWM_DC_TYPE_DCBH - Digital Compare B High //! - EPWM_DC_TYPE_DCBL - Digital Compare B Low //! //! \return None. // //***************************************************************************** static inline void EPWM_enableDigitalCompareTripCombinationInput(uint32_t base, uint16_t tripInput, EPWM_DigitalCompareType dcType) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6636); } } while((_Bool)0); // // Get the DCAHTRIPSEL, DCALTRIPSEL, DCBHTRIPSEL, DCBLTRIPSEL register // offset with respect to DCAHTRIPSEL // registerOffset = 0xD2U + (uint32_t)dcType; // // Set the DC trip input // __eallow(); (*((volatile uint16_t *)(base + registerOffset))) = ((*((volatile uint16_t *)(base + registerOffset))) | tripInput); // // Enable the combination input // (*((volatile uint16_t *)(base + 0xC0U))) = ((*((volatile uint16_t *)(base + 0xC0U))) | (0xFU << ((uint16_t)dcType << 2U))); __edis(); } //***************************************************************************** // //! Disable DC TRIP combinational input. //! //! \param base is the base address of the EPWM module. //! \param tripInput is the Trip number. //! \param dcType is the Digital Compare module. //! //! This function disables the specified Trip input. //! Valid values for the parameters are: //! - tripInput //! - EPWM_DC_COMBINATIONAL_TRIPINx, where x is 1,2,...12,14,15 //! - dcType //! - EPWM_DC_TYPE_DCAH - Digital Compare A High //! - EPWM_DC_TYPE_DCAL - Digital Compare A Low //! - EPWM_DC_TYPE_DCBH - Digital Compare B High //! - EPWM_DC_TYPE_DCBL - Digital Compare B Low //! //! \return None. // //***************************************************************************** static inline void EPWM_disableDigitalCompareTripCombinationInput(uint32_t base, uint16_t tripInput, EPWM_DigitalCompareType dcType) { uint32_t registerOffset; // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6690); } } while((_Bool)0); // // Get the DCAHTRIPSEL, DCALTRIPSEL, DCBHTRIPSEL, DCBLTRIPSEL register // offset with respect to DCAHTRIPSEL // registerOffset = 0xD2U + (uint32_t)dcType; // // Set the DC trip input // __eallow(); (*((volatile uint16_t *)(base + registerOffset))) = ((*((volatile uint16_t *)(base + registerOffset))) & ~tripInput); __edis(); } // // Valley switching // //***************************************************************************** // //! Enable valley capture mode. //! //! \param base is the base address of the EPWM module. //! //! This function enables Valley Capture mode. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableValleyCapture(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6727); } } while((_Bool)0); // // Set VCAPE bit // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disable valley capture mode. //! //! \param base is the base address of the EPWM module. //! //! This function disables Valley Capture mode. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableValleyCapture(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6754); } } while((_Bool)0); // // Clear VCAPE bit // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) &= ~0x1U; __edis(); } //***************************************************************************** // //! Start valley capture mode. //! //! \param base is the base address of the EPWM module. //! //! This function starts Valley Capture sequence. //! //! \b Make sure you invoke EPWM_setValleyTriggerSource with the trigger //! variable set to EPWM_VALLEY_TRIGGER_EVENT_SOFTWARE before calling this //! function. //! //! \return None. // //***************************************************************************** static inline void EPWM_startValleyCapture(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6785); } } while((_Bool)0); // // Set VCAPSTART bit // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Set valley capture trigger. //! //! \param base is the base address of the EPWM module. //! \param trigger is the Valley counter trigger. //! //! This function sets the trigger value that initiates Valley Capture sequence //! //! \b Set the number of Trigger source events for starting and stopping the //! valley capture using EPWM_setValleyTriggerEdgeCounts(). //! //! \return None. // //***************************************************************************** static inline void EPWM_setValleyTriggerSource(uint32_t base, EPWM_ValleyTriggerSource trigger) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6816); } } while((_Bool)0); // // Write to TRIGSEL bits // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) = (((*((volatile uint16_t *)(base + 0x18U))) & ~0x1CU) | ((uint16_t)trigger << 2U)); __edis(); } //***************************************************************************** // //! Set valley capture trigger source count. //! //! \param base is the base address of the EPWM module. //! \param startCount //! \param stopCount //! //! This function sets the number of trigger events required to start and stop //! the valley capture count. //! Maximum values for both startCount and stopCount is 15 corresponding to the //! 15th edge of the trigger event. //! //! \b Note: //! A startCount value of 0 prevents starting the valley counter. //! A stopCount value of 0 prevents the valley counter from stopping. //! //! \return None. // //***************************************************************************** static inline void EPWM_setValleyTriggerEdgeCounts(uint32_t base, uint16_t startCount, uint16_t stopCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6855); } } while((_Bool)0); do { if(!((startCount < 16U) && (stopCount < 16U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6856); } } while((_Bool)0); // // Write to STARTEDGE and STOPEDGE bits // __eallow(); (*((volatile uint16_t *)(base + 0x19U))) = (((*((volatile uint16_t *)(base + 0x19U))) & ~(0xFU | 0xF00U)) | (startCount | (stopCount << 8U))); __edis(); } //***************************************************************************** // //! Enable valley switching delay. //! //! \param base is the base address of the EPWM module. //! //! This function enables Valley switching delay. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableValleyHWDelay(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6886); } } while((_Bool)0); // // Set EDGEFILTDLYSEL bit // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) |= 0x400U; __edis(); } //***************************************************************************** // //! Disable valley switching delay. //! //! \param base is the base address of the EPWM module. //! //! This function disables Valley switching delay. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableValleyHWDelay(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6913); } } while((_Bool)0); // // Clear EDGEFILTDLYSEL bit // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) &= ~0x400U; __edis(); } //***************************************************************************** // //! Set Valley delay values. //! //! \param base is the base address of the EPWM module. //! \param delayOffsetValue is the software defined delay offset value. //! //! This function sets the Valley delay value. //! //! \return None. // //***************************************************************************** static inline void EPWM_setValleySWDelayValue(uint32_t base, uint16_t delayOffsetValue) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6941); } } while((_Bool)0); // // Write to SWVDELVAL bits // (*((volatile uint16_t *)(base + 0x77U))) = delayOffsetValue; } //***************************************************************************** // //! Set Valley delay mode. //! //! \param base is the base address of the EPWM module. //! \param delayMode is the Valley delay mode. //! //! This function sets the Valley delay mode values. //! //! \return None. // //***************************************************************************** static inline void EPWM_setValleyDelayDivider(uint32_t base, EPWM_ValleyDelayMode delayMode) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 6967); } } while((_Bool)0); // // Write to VDELAYDIV bits // __eallow(); (*((volatile uint16_t *)(base + 0x18U))) = (((*((volatile uint16_t *)(base + 0x18U))) & ~0x380U) | ((uint16_t)delayMode << 7U)); __edis(); } //***************************************************************************** // //! Get the valley edge status bit. //! //! \param base is the base address of the EPWM module. //! \param edge is the start or stop edge. //! //! This function returns the status of the start or stop valley status //! depending on the value of edge. //! If a start or stop edge has occurred, the function returns true, if not it //! returns false. //! //! \return Returns true if the specified edge has occurred, //! Returns false if the specified edge has not occurred. // //***************************************************************************** static inline _Bool EPWM_getValleyEdgeStatus(uint32_t base, EPWM_ValleyCounterEdge edge) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7001); } } while((_Bool)0); if(edge == EPWM_VALLEY_COUNT_START_EDGE) { // // Returns STARTEDGESTS status // return((((*((volatile uint16_t *)(base + 0x19U))) & 0x80U) == 0x80U ) ? 1 : 0); } else { // // Returns STOPEDGESTS status // return((((*((volatile uint16_t *)(base + 0x19U))) & 0x8000U) == 0x8000U) ? 1 : 0); } } //***************************************************************************** // //! Get the Valley Counter value. //! //! \param base is the base address of the EPWM module. //! //! This function returns the valley time base count value which is captured //! upon occurrence of the stop edge condition selected by //! EPWM_setValleyTriggerSource() and by the stopCount variable of the //! EPWM_setValleyTriggerEdgeCounts() function. //! //! \return Returns the valley base time count. // //***************************************************************************** static inline uint16_t EPWM_getValleyCount(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7041); } } while((_Bool)0); // // Read VCNTVAL register // return((*((volatile uint16_t *)(base + 0xFEU)))); } //***************************************************************************** // //! Get the Valley delay value. //! //! \param base is the base address of the EPWM module. //! //! This function returns the hardware valley delay count. //! //! \return Returns the valley delay count. // //***************************************************************************** static inline uint16_t EPWM_getValleyHWDelay(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7066); } } while((_Bool)0); // // Read HWVDELVAL register // return((*((volatile uint16_t *)(base + 0xFDU)))); } //***************************************************************************** // //! Enable Global shadow load mode. //! //! \param base is the base address of the EPWM module. //! //! This function enables Global shadow to active load mode of registers. //! The trigger source for loading shadow to active is determined by //! EPWM_setGlobalLoadTrigger() function. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableGlobalLoad(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7093); } } while((_Bool)0); // // Shadow to active load is controlled globally // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disable Global shadow load mode. //! //! \param base is the base address of the EPWM module. //! //! This function disables Global shadow to active load mode of registers. //! Loading shadow to active is determined individually. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableGlobalLoad(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7121); } } while((_Bool)0); // // Shadow to active load is controlled individually // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) &= ~0x1U; __edis(); } //***************************************************************************** // //! Set the Global shadow load pulse. //! //! \param base is the base address of the EPWM module. //! \param loadTrigger is the pulse that causes global shadow load. //! //! This function sets the pulse that causes Global shadow to active load. //! Valid values for the loadTrigger parameter are: //! //! - EPWM_GL_LOAD_PULSE_CNTR_ZERO - load when counter is equal //! to zero //! - EPWM_GL_LOAD_PULSE_CNTR_PERIOD - load when counter is equal //! to period //! - EPWM_GL_LOAD_PULSE_CNTR_ZERO_PERIOD - load when counter is equal //! to zero or period //! - EPWM_GL_LOAD_PULSE_SYNC - load on sync event //! - EPWM_GL_LOAD_PULSE_SYNC_OR_CNTR_ZERO - load on sync event or when //! counter is equal to zero //! - EPWM_GL_LOAD_PULSE_SYNC_OR_CNTR_PERIOD - load on sync event or when //! counter is equal to period //! - EPWM_GL_LOAD_PULSE_SYNC_CNTR_ZERO_PERIOD - load on sync event or when //! counter is equal to period //! or zero //! - EPWM_GL_LOAD_PULSE_GLOBAL_FORCE - load on global force //! //! \return None. // //***************************************************************************** static inline void EPWM_setGlobalLoadTrigger(uint32_t base, EPWM_GlobalLoadTrigger loadTrigger) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7166); } } while((_Bool)0); // // Set the Global shadow to active load pulse // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) = (((*((volatile uint16_t *)(base + 0x34U))) & ~0x1EU) | ((uint16_t)loadTrigger << 1U)); __edis(); } //***************************************************************************** // //! Set the number of Global load pulse event counts //! //! \param base is the base address of the EPWM module. //! \param prescalePulseCount is the pulse event counts. //! //! This function sets the number of Global Load pulse events that have to //! occurred before a global load pulse is issued. Valid values for //! prescaleCount range from 0 to 7. 0 being no event (disables counter), and 7 //! representing 7 events. //! //! \return None. // //***************************************************************************** static inline void EPWM_setGlobalLoadEventPrescale(uint32_t base, uint16_t prescalePulseCount) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7199); } } while((_Bool)0); do { if(!(prescalePulseCount < 8U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7200); } } while((_Bool)0); // // Set the number of counts that have to occur before // a load strobe is issued // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) = (((*((volatile uint16_t *)(base + 0x34U))) & ~0x380U) | (prescalePulseCount << 7U)); __edis(); } //***************************************************************************** // //! Return the number of Global load pulse event counts //! //! \param base is the base address of the EPWM module. //! //! This function returns the number of Global Load pulse events that have //! occurred. These pulse events are set by the EPWM_setGlobalLoadTrigger() //! function. //! //! \return None. // //***************************************************************************** static inline uint16_t EPWM_getGlobalLoadEventCount(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7232); } } while((_Bool)0); // // Return the number of events that have occurred // return(((*((volatile uint16_t *)(base + 0x34U))) >> 10U) & 0x7U); } //***************************************************************************** // //! Enable continuous global shadow to active load. //! //! \param base is the base address of the EPWM module. //! //! This function enables global continuous shadow to active load. Register //! load happens every time the event set by the //! EPWM_setGlobalLoadTrigger() occurs. //! //! \return None. // //***************************************************************************** static inline void EPWM_disableGlobalLoadOneShotMode(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7259); } } while((_Bool)0); // // Enable global continuous shadow to active load // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) &= ~0x20U; __edis(); } //***************************************************************************** // //! Enable One shot global shadow to active load. //! //! \param base is the base address of the EPWM module. //! //! This function enables a one time global shadow to active load. Register //! load happens every time the event set by the //! EPWM_setGlobalLoadTrigger() occurs. //! //! \return None. // //***************************************************************************** static inline void EPWM_enableGlobalLoadOneShotMode(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7288); } } while((_Bool)0); // // Enable global continuous shadow to active load // __eallow(); (*((volatile uint16_t *)(base + 0x34U))) |= 0x20U; __edis(); } //***************************************************************************** // //! Set One shot global shadow to active load pulse. //! //! \param base is the base address of the EPWM module. //! //! This function sets a one time global shadow to active load pulse. The pulse //! propagates to generate a load signal if any of the events set by //! EPWM_setGlobalLoadTrigger() occur. //! //! \return None. // //***************************************************************************** static inline void EPWM_setGlobalLoadOneShotLatch(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7317); } } while((_Bool)0); // // Set a one shot Global shadow load pulse. // __eallow(); (*((volatile uint16_t *)(base + 0x74U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Force a software One shot global shadow to active load pulse. //! //! \param base is the base address of the EPWM module. //! //! This function forces a software a one time global shadow to active load //! pulse. //! //! \return None. // //***************************************************************************** static inline void EPWM_forceGlobalLoadOneShotEvent(uint32_t base) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7345); } } while((_Bool)0); // // Force a Software Global shadow load pulse // __eallow(); (*((volatile uint16_t *)(base + 0x74U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Enable a register to be loaded Globally. //! //! \param base is the base address of the EPWM module. //! \param loadRegister is the register. //! //! This function enables the register specified by loadRegister to be globally //! loaded. //! Valid values for loadRegister are: //! - EPWM_GL_REGISTER_TBPRD_TBPRDHR - Register TBPRD:TBPRDHR //! - EPWM_GL_REGISTER_CMPA_CMPAHR - Register CMPA:CMPAHR //! - EPWM_GL_REGISTER_CMPB_CMPBHR - Register CMPB:CMPBHR //! - EPWM_GL_REGISTER_CMPC - Register CMPC //! - EPWM_GL_REGISTER_CMPD - Register CMPD //! - EPWM_GL_REGISTER_DBRED_DBREDHR - Register DBRED:DBREDHR //! - EPWM_GL_REGISTER_DBFED_DBFEDHR - Register DBFED:DBFEDHR //! - EPWM_GL_REGISTER_DBCTL - Register DBCTL //! - EPWM_GL_REGISTER_AQCTLA_AQCTLA2 - Register AQCTLA/A2 //! - EPWM_GL_REGISTER_AQCTLB_AQCTLB2 - Register AQCTLB/B2 //! - EPWM_GL_REGISTER_AQCSFRC - Register AQCSFRC //! //! \return None. // //***************************************************************************** static inline void EPWM_enableGlobalLoadRegisters(uint32_t base, uint16_t loadRegister) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7386); } } while((_Bool)0); do { if(!((loadRegister > 0x0000U) && (loadRegister < 0x0800U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7387); } } while((_Bool)0); // // The register specified by loadRegister is loaded globally // __eallow(); (*((volatile uint16_t *)(base + 0x35U))) |= loadRegister; __edis(); } //***************************************************************************** // //! Disable a register to be loaded Globally. //! //! \param base is the base address of the EPWM module. //! \param loadRegister is the register. //! //! This function disables the register specified by loadRegister from being //! loaded globally. The shadow to active load happens as specified by the //! register control //! Valid values for loadRegister are: //! - EPWM_GL_REGISTER_TBPRD_TBPRDHR - Register TBPRD:TBPRDHR //! - EPWM_GL_REGISTER_CMPA_CMPAHR - Register CMPA:CMPAHR //! - EPWM_GL_REGISTER_CMPB_CMPBHR - Register CMPB:CMPBHR //! - EPWM_GL_REGISTER_CMPC - Register CMPC //! - EPWM_GL_REGISTER_CMPD - Register CMPD //! - EPWM_GL_REGISTER_DBRED_DBREDHR - Register DBRED:DBREDHR //! - EPWM_GL_REGISTER_DBFED_DBFEDHR - Register DBFED:DBFEDHR //! - EPWM_GL_REGISTER_DBCTL - Register DBCTL //! - EPWM_GL_REGISTER_AQCTLA_AQCTLA2 - Register AQCTLA/A2 //! - EPWM_GL_REGISTER_AQCTLB_AQCTLB2 - Register AQCTLB/B2 //! - EPWM_GL_REGISTER_AQCSFRC - Register AQCSFRC //! //! \return None. // //***************************************************************************** static inline void EPWM_disableGlobalLoadRegisters(uint32_t base, uint16_t loadRegister) { // // Check the arguments // do { if(!(EPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7429); } } while((_Bool)0); do { if(!((loadRegister > 0x0000U) && (loadRegister < 0x0800U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/epwm.h", 7430); } } while((_Bool)0); // // The register specified by loadRegister is loaded by individual // register configuration setting // __eallow(); (*((volatile uint16_t *)(base + 0x35U))) &= ~loadRegister; __edis(); } //***************************************************************************** // //! Set emulation mode //! //! \param base is the base address of the EPWM module. //! \param emulationMode is the emulation mode. //! //! This function sets the emulation behaviours of the time base counter. Valid //! values for emulationMode are: //! - EPWM_EMULATION_STOP_AFTER_NEXT_TB - Stop after next Time Base counter //! increment or decrement. //! - EPWM_EMULATION_STOP_AFTER_FULL_CYCLE - Stop when counter completes whole //! cycle. //! - EPWM_EMULATION_FREE_RUN - Free run. //! //! \return None. // //***************************************************************************** extern void EPWM_setEmulationMode(uint32_t base, EPWM_EmulationMode emulationMode); //***************************************************************************** // //! Configures ePWM signal with desired frequency & duty //! //! \param base is the base address of the EPWM module. //! \param signalParams is the desired signal parameters. //! //! This function configures the ePWM module to generate a signal with //! desired frequency & duty. //! //! \return None. // //***************************************************************************** extern void EPWM_configureSignal(uint32_t base, const EPWM_SignalParams *signalParams); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: eqep.h // // TITLE: C28x eQEP driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup eqep_api eQEP //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_eqep.h // // TITLE: Definitions for the EQEP registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the EQEP register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QDECCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QEPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QCAPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QPOSCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QEINT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the QEPSTS register // //************************************************************************************************* //***************************************************************************** // // Values that can be passed to EQEP_setDecoderConfig() as the config // parameter. // //***************************************************************************** // // Operation Mode // // // Resolution // // // Swap QEPA and QEPB // // // Index pulse gating option // //***************************************************************************** // // Values that can be passed to EQEP_setCompareConfig() as the config // parameter. // //***************************************************************************** // // Sync pulse pin // // // Shadow register use // //***************************************************************************** // // Values that can be passed to EQEP_enableInterrupt(), // EQEP_disableInterrupt(), and EQEP_clearInterruptStatus() as the // intFlags parameter and returned by EQEP_clearInterruptStatus(). // //***************************************************************************** //***************************************************************************** // // Values that can be returned by EQEP_getStatus(). // //***************************************************************************** //! Unit position event detected //! Direction was clockwise on first index event //! Direction is CW (forward) //! Direction was CW on index //! Capture timer overflow //! Direction changed between position capture events //! First index pulse occurred //! Position counter error //***************************************************************************** // // Values that can be passed to EQEP_setLatchMode() as the latchMode parameter. // //***************************************************************************** // // Position counter latch event // // // Strobe position counter latch event // //! On rising edge of strobe //! On rising edge when clockwise, on falling when counter clockwise // // Index position counter latch event // //***************************************************************************** // // Values that can be passed to EQEP_setPositionInitMode() as the initMode // parameter. // //***************************************************************************** // // Strobe events // //! On rising edge of strobe //! On rising edge when clockwise, on falling when counter clockwise // // Index events // //***************************************************************************** // //! Values that can be passed to EQEP_setPositionCounterConfig() as the \e mode //! parameter. // //***************************************************************************** typedef enum { //! Reset position on index pulse EQEP_POSITION_RESET_IDX = 0x0000, //! Reset position on maximum position EQEP_POSITION_RESET_MAX_POS = 0x1000, //! Reset position on the first index pulse EQEP_POSITION_RESET_1ST_IDX = 0x2000, //! Reset position on a unit time event EQEP_POSITION_RESET_UNIT_TIME_OUT = 0x3000 } EQEP_PositionResetMode; //***************************************************************************** // //! Values that can be passed to EQEP_setCaptureConfig() as the \e capPrescale //! parameter. CAPCLK is the capture timer clock frequency. // //***************************************************************************** typedef enum { EQEP_CAPTURE_CLK_DIV_1 = 0x00, //!< CAPCLK = SYSCLKOUT/1 EQEP_CAPTURE_CLK_DIV_2 = 0x10, //!< CAPCLK = SYSCLKOUT/2 EQEP_CAPTURE_CLK_DIV_4 = 0x20, //!< CAPCLK = SYSCLKOUT/4 EQEP_CAPTURE_CLK_DIV_8 = 0x30, //!< CAPCLK = SYSCLKOUT/8 EQEP_CAPTURE_CLK_DIV_16 = 0x40, //!< CAPCLK = SYSCLKOUT/16 EQEP_CAPTURE_CLK_DIV_32 = 0x50, //!< CAPCLK = SYSCLKOUT/32 EQEP_CAPTURE_CLK_DIV_64 = 0x60, //!< CAPCLK = SYSCLKOUT/64 EQEP_CAPTURE_CLK_DIV_128 = 0x70 //!< CAPCLK = SYSCLKOUT/128 } EQEP_CAPCLKPrescale; //***************************************************************************** // //! Values that can be passed to EQEP_setCaptureConfig() as the \e evntPrescale //! parameter. UPEVNT is the unit position event frequency. // //***************************************************************************** typedef enum { EQEP_UNIT_POS_EVNT_DIV_1, //!< UPEVNT = QCLK/1 EQEP_UNIT_POS_EVNT_DIV_2, //!< UPEVNT = QCLK/2 EQEP_UNIT_POS_EVNT_DIV_4, //!< UPEVNT = QCLK/4 EQEP_UNIT_POS_EVNT_DIV_8, //!< UPEVNT = QCLK/8 EQEP_UNIT_POS_EVNT_DIV_16, //!< UPEVNT = QCLK/16 EQEP_UNIT_POS_EVNT_DIV_32, //!< UPEVNT = QCLK/32 EQEP_UNIT_POS_EVNT_DIV_64, //!< UPEVNT = QCLK/64 EQEP_UNIT_POS_EVNT_DIV_128, //!< UPEVNT = QCLK/128 EQEP_UNIT_POS_EVNT_DIV_256, //!< UPEVNT = QCLK/256 EQEP_UNIT_POS_EVNT_DIV_512, //!< UPEVNT = QCLK/512 EQEP_UNIT_POS_EVNT_DIV_1024, //!< UPEVNT = QCLK/1024 EQEP_UNIT_POS_EVNT_DIV_2048 //!< UPEVNT = QCLK/2048 } EQEP_UPEVNTPrescale; //***************************************************************************** // //! Values that can be passed to EQEP_setEmulationMode() as the \e emuMode //! parameter. // //***************************************************************************** typedef enum { EQEP_EMULATIONMODE_STOPIMMEDIATELY, //!< Counters stop immediately EQEP_EMULATIONMODE_STOPATROLLOVER, //!< Counters stop at period rollover EQEP_EMULATIONMODE_RUNFREE //!< Counter unaffected by suspend }EQEP_EmulationMode; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks an eQEP base address. //! //! \param base specifies the eQEP module base address. //! //! This function determines if a eQEP module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool EQEP_isBaseValid(uint32_t base) { return( (base == 0x00005100U) || (base == 0x00005140U) || (base == 0x00005180U) ); } //***************************************************************************** // //! Enables the eQEP module. //! //! \param base is the base address of the eQEP module. //! //! This function enables operation of the enhanced quadrature encoder pulse //! (eQEP) module. The module must be configured before it is enabled. //! //! \sa EQEP_setConfig() //! //! \return None. // //***************************************************************************** static inline void EQEP_enableModule(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 340); } } while((_Bool)0); // // Enable the eQEP module. // (*((volatile uint16_t *)(base + 0x15U))) |= 0x8U; } //***************************************************************************** // //! Disables the eQEP module. //! //! \param base is the base address of the enhanced quadrature encoder pulse //! (eQEP) module //! //! This function disables operation of the eQEP module. //! //! \return None. // //***************************************************************************** static inline void EQEP_disableModule(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 366); } } while((_Bool)0); // // Disable the eQEP module. // (*((volatile uint16_t *)(base + 0x15U))) &= ~(0x8U); } //***************************************************************************** // //! Configures eQEP module's quadrature decoder unit. //! //! \param base is the base address of the eQEP module. //! \param config is the configuration for the eQEP module decoder unit. //! //! This function configures the operation of the eQEP module's quadrature //! decoder unit. The \e config parameter provides the configuration //! of the decoder and is the logical OR of several values: //! //! - \b EQEP_CONFIG_2X_RESOLUTION or \b EQEP_CONFIG_1X_RESOLUTION specify //! if both rising and falling edges should be counted or just rising edges. //! - \b EQEP_CONFIG_QUADRATURE, \b EQEP_CONFIG_CLOCK_DIR, //! \b EQEP_CONFIG_UP_COUNT, or \b EQEP_CONFIG_DOWN_COUNT specify if //! quadrature signals are being provided on QEPA and QEPB, if a direction //! signal and a clock are being provided, or if the direction should be //! hard-wired for a single direction with QEPA used for input. //! - \b EQEP_CONFIG_NO_SWAP or \b EQEP_CONFIG_SWAP to specify if the //! signals provided on QEPA and QEPB should be swapped before being //! processed. //! - \b EQEP_CONFIG_IGATE_DISABLE or \b EQEP_CONFIG_IGATE_ENABLE to specify //! if the gating of the index pulse should be enabled or disabled //! //! \return None. // //***************************************************************************** static inline void EQEP_setDecoderConfig(uint32_t base, uint16_t config) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 407); } } while((_Bool)0); // // Write the new decoder configuration to the hardware. // (*((volatile uint16_t *)(base + 0x14U))) = ((*((volatile uint16_t *)(base + 0x14U))) & ~(0x400U | 0x800U | 0xC000U | 0x200U)) | config; } //***************************************************************************** // //! Configures eQEP module position counter unit. //! //! \param base is the base address of the eQEP module. //! \param mode is the configuration for the eQEP module position counter. //! \param maxPosition specifies the maximum position value. //! //! This function configures the operation of the eQEP module position //! counter. The \e mode parameter determines the event on which the position //! counter gets reset. It should be passed one of the following values: //! \b EQEP_POSITION_RESET_IDX, \b EQEP_POSITION_RESET_MAX_POS, //! \b EQEP_POSITION_RESET_1ST_IDX, or \b EQEP_POSITION_RESET_UNIT_TIME_OUT. //! //! \e maxPosition is the maximum value of the position counter and is //! the value used to reset the position capture when moving in the reverse //! (negative) direction. //! //! \return None. // //***************************************************************************** static inline void EQEP_setPositionCounterConfig(uint32_t base, EQEP_PositionResetMode mode, uint32_t maxPosition) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 447); } } while((_Bool)0); // // Write the position counter reset configuration to the hardware. // (*((volatile uint16_t *)(base + 0x15U))) = ((*((volatile uint16_t *)(base + 0x15U))) & ~0x3000U) | (uint16_t)mode; // // Set the maximum position. // (*((volatile uint32_t *)(base + 0x4U))) = maxPosition; } //***************************************************************************** // //! Gets the current encoder position. //! //! \param base is the base address of the eQEP module. //! //! This function returns the current position of the encoder. Depending upon //! the configuration of the encoder, and the incident of an index pulse, this //! value may or may not contain the expected data (that is, if in reset on //! index mode, if an index pulse has not been encountered, the position //! counter is not yet aligned with the index pulse). //! //! \return The current position of the encoder. // //***************************************************************************** static inline uint32_t EQEP_getPosition(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 482); } } while((_Bool)0); // // Return the current position counter. // return((*((volatile uint32_t *)(base + 0x0U)))); } //***************************************************************************** // //! Sets the current encoder position. //! //! \param base is the base address of the eQEP module. //! \param position is the new position for the encoder. //! //! This function sets the current position of the encoder; the encoder //! position is then measured relative to this value. //! //! \return None. // //***************************************************************************** static inline void EQEP_setPosition(uint32_t base, uint32_t position) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 509); } } while((_Bool)0); // // Set the position counter. // (*((volatile uint32_t *)(base + 0x0U))) = position; } //***************************************************************************** // //! Gets the current direction of rotation. //! //! \param base is the base address of the eQEP module. //! //! This function returns the current direction of rotation. In this case, //! current means the most recently detected direction of the encoder; it may //! not be presently moving but this is the direction it last moved before it //! stopped. //! //! \return Returns 1 if moving in the forward direction or -1 if moving in the //! reverse direction. // //***************************************************************************** static inline int16_t EQEP_getDirection(uint32_t base) { int16_t direction; // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 540); } } while((_Bool)0); // // Return the direction of rotation. // if(((*((volatile uint16_t *)(base + 0x1CU))) & 0x20U) != 0U) { direction = 1; } else { direction = -1; } return(direction); } //***************************************************************************** // //! Enables individual eQEP module interrupt sources. //! //! \param base is the base address of the eQEP module. //! \param intFlags is a bit mask of the interrupt sources to be enabled. //! //! This function enables eQEP module interrupt sources. The \e intFlags //! parameter can be any of the following values OR'd together: //! - \b EQEP_INT_POS_CNT_ERROR - Position counter error //! - \b EQEP_INT_PHASE_ERROR - Quadrature phase error //! - \b EQEP_INT_DIR_CHANGE - Quadrature direction change //! - \b EQEP_INT_WATCHDOG - Watchdog time-out //! - \b EQEP_INT_UNDERFLOW - Position counter underflow //! - \b EQEP_INT_OVERFLOW - Position counter overflow //! - \b EQEP_INT_POS_COMP_READY - Position-compare ready //! - \b EQEP_INT_POS_COMP_MATCH - Position-compare match //! - \b EQEP_INT_STROBE_EVNT_LATCH - Strobe event latch //! - \b EQEP_INT_INDEX_EVNT_LATCH - Index event latch //! - \b EQEP_INT_UNIT_TIME_OUT - Unit time-out //! //! \return None. // //***************************************************************************** static inline void EQEP_enableInterrupt(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 587); } } while((_Bool)0); // // Enable the specified interrupts. // (*((volatile uint16_t *)(base + 0x18U))) |= intFlags; } //***************************************************************************** // //! Disables individual eQEP module interrupt sources. //! //! \param base is the base address of the eQEP module. //! \param intFlags is a bit mask of the interrupt sources to be disabled. //! //! This function disables eQEP module interrupt sources. The \e intFlags //! parameter can be any of the following values OR'd together: //! - \b EQEP_INT_POS_CNT_ERROR - Position counter error //! - \b EQEP_INT_PHASE_ERROR - Quadrature phase error //! - \b EQEP_INT_DIR_CHANGE - Quadrature direction change //! - \b EQEP_INT_WATCHDOG - Watchdog time-out //! - \b EQEP_INT_UNDERFLOW - Position counter underflow //! - \b EQEP_INT_OVERFLOW - Position counter overflow //! - \b EQEP_INT_POS_COMP_READY - Position-compare ready //! - \b EQEP_INT_POS_COMP_MATCH - Position-compare match //! - \b EQEP_INT_STROBE_EVNT_LATCH - Strobe event latch //! - \b EQEP_INT_INDEX_EVNT_LATCH - Index event latch //! - \b EQEP_INT_UNIT_TIME_OUT - Unit time-out //! //! \return None. // //***************************************************************************** static inline void EQEP_disableInterrupt(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 625); } } while((_Bool)0); // // Disable the specified interrupts. // (*((volatile uint16_t *)(base + 0x18U))) &= ~(intFlags); } //***************************************************************************** // //! Gets the current interrupt status. //! //! \param base is the base address of the eQEP module. //! //! This function returns the interrupt status for the eQEP module //! module. //! //! \return Returns the current interrupt status, enumerated as a bit field of //! the following values: //! - \b EQEP_INT_GLOBAL - Global interrupt flag //! - \b EQEP_INT_POS_CNT_ERROR - Position counter error //! - \b EQEP_INT_PHASE_ERROR - Quadrature phase error //! - \b EQEP_INT_DIR_CHANGE - Quadrature direction change //! - \b EQEP_INT_WATCHDOG - Watchdog time-out //! - \b EQEP_INT_UNDERFLOW - Position counter underflow //! - \b EQEP_INT_OVERFLOW - Position counter overflow //! - \b EQEP_INT_POS_COMP_READY - Position-compare ready //! - \b EQEP_INT_POS_COMP_MATCH - Position-compare match //! - \b EQEP_INT_STROBE_EVNT_LATCH - Strobe event latch //! - \b EQEP_INT_INDEX_EVNT_LATCH - Index event latch //! - \b EQEP_INT_UNIT_TIME_OUT - Unit time-out // //***************************************************************************** static inline uint16_t EQEP_getInterruptStatus(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 664); } } while((_Bool)0); return((*((volatile uint16_t *)(base + 0x19U)))); } //***************************************************************************** // //! Clears eQEP module interrupt sources. //! //! \param base is the base address of the eQEP module. //! \param intFlags is a bit mask of the interrupt sources to be cleared. //! //! This function clears eQEP module interrupt flags. The \e intFlags //! parameter can be any of the following values OR'd together: //! - \b EQEP_INT_GLOBAL - Global interrupt flag //! - \b EQEP_INT_POS_CNT_ERROR - Position counter error //! - \b EQEP_INT_PHASE_ERROR - Quadrature phase error //! - \b EQEP_INT_DIR_CHANGE - Quadrature direction change //! - \b EQEP_INT_WATCHDOG - Watchdog time-out //! - \b EQEP_INT_UNDERFLOW - Position counter underflow //! - \b EQEP_INT_OVERFLOW - Position counter overflow //! - \b EQEP_INT_POS_COMP_READY - Position-compare ready //! - \b EQEP_INT_POS_COMP_MATCH - Position-compare match //! - \b EQEP_INT_STROBE_EVNT_LATCH - Strobe event latch //! - \b EQEP_INT_INDEX_EVNT_LATCH - Index event latch //! - \b EQEP_INT_UNIT_TIME_OUT - Unit time-out //! //! Note that the \b EQEP_INT_GLOBAL value is the global interrupt flag. In //! order to get any further eQEP interrupts, this flag must be cleared. //! //! \return None. // //***************************************************************************** static inline void EQEP_clearInterruptStatus(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 703); } } while((_Bool)0); // // Clear the requested interrupt sources. // (*((volatile uint16_t *)(base + 0x1AU))) = intFlags; } //***************************************************************************** // //! Forces individual eQEP module interrupts. //! //! \param base is the base address of the eQEP module. //! \param intFlags is a bit mask of the interrupt sources to be forced. //! //! This function forces eQEP module interrupt flags. The \e intFlags //! parameter can be any of the following values OR'd together: //! - \b EQEP_INT_POS_CNT_ERROR //! - \b EQEP_INT_PHASE_ERROR //! - \b EQEP_INT_DIR_CHANGE //! - \b EQEP_INT_WATCHDOG //! - \b EQEP_INT_UNDERFLOW //! - \b EQEP_INT_OVERFLOW //! - \b EQEP_INT_POS_COMP_READY //! - \b EQEP_INT_POS_COMP_MATCH //! - \b EQEP_INT_STROBE_EVNT_LATCH //! - \b EQEP_INT_INDEX_EVNT_LATCH //! - \b EQEP_INT_UNIT_TIME_OUT //! //! \return None. // //***************************************************************************** static inline void EQEP_forceInterrupt(uint32_t base, uint16_t intFlags) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 741); } } while((_Bool)0); // // Force the specified interrupts. // (*((volatile uint16_t *)(base + 0x1BU))) |= intFlags; } //***************************************************************************** // //! Gets the encoder error indicator. //! //! \param base is the base address of the eQEP module. //! //! This function returns the error indicator for the eQEP module. It is an //! error for both of the signals of the quadrature input to change at the same //! time. //! //! \return Returns \b true if an error has occurred and \b false otherwise. // //***************************************************************************** static inline _Bool EQEP_getError(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 768); } } while((_Bool)0); // // Return the error indicator. // return(((*((volatile uint16_t *)(base + 0x19U))) & 0x4U) != 0U); } //***************************************************************************** // //! Returns content of the eQEP module status register //! //! \param base is the base address of the eQEP module. //! //! This function returns the contents of the status register. The value it //! returns is an OR of the following values: //! //! - \b EQEP_STS_UNIT_POS_EVNT - Unit position event detected //! - \b EQEP_STS_DIR_ON_1ST_IDX - If set, clockwise rotation (forward //! movement) occurred on the first index event //! - \b EQEP_STS_DIR_FLAG - If set, movement is clockwise rotation //! - \b EQEP_STS_DIR_LATCH - If set, clockwise rotation occurred on last //! index event marker //! - \b EQEP_STS_CAP_OVRFLW_ERROR - Overflow occurred in eQEP capture timer //! - \b EQEP_STS_CAP_DIR_ERROR - Direction change occurred between position //! capture events //! - \b EQEP_STS_1ST_IDX_FLAG - Set by the occurrence of the first index //! pulse //! - \b EQEP_STS_POS_CNT_ERROR - Position counter error occurred //! //! \return Returns the value of the QEP status register. // //***************************************************************************** static inline uint16_t EQEP_getStatus(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 807); } } while((_Bool)0); // // Return the status register. // return((*((volatile uint16_t *)(base + 0x1CU))) & 0x00FFU); } //***************************************************************************** // //! Clears selected fields of the eQEP module status register //! //! \param base is the base address of the eQEP module. //! \param statusFlags is the bit mask of the status flags to be cleared. //! //! This function clears the status register fields indicated by //! \e statusFlags. The \e statusFlags parameter is the logical OR of any of //! the following: //! //! - \b EQEP_STS_UNIT_POS_EVNT - Unit position event detected //! - \b EQEP_STS_CAP_OVRFLW_ERROR - Overflow occurred in eQEP capture timer //! - \b EQEP_STS_CAP_DIR_ERROR - Direction change occurred between position //! capture events //! - \b EQEP_STS_1ST_IDX_FLAG - Set by the occurrence of the first index //! pulse //! //! \note Only the above status fields can be cleared. All others are //! read-only, non-sticky fields. //! //! \return None. // //***************************************************************************** static inline void EQEP_clearStatus(uint32_t base, uint16_t statusFlags) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 845); } } while((_Bool)0); // // Clear the requested interrupt sources. // (*((volatile uint16_t *)(base + 0x1CU))) = statusFlags; } //***************************************************************************** // //! Configures eQEP module edge-capture unit. //! //! \param base is the base address of the eQEP module. //! \param capPrescale is the prescaler setting of the eQEP capture timer clk. //! \param evntPrescale is the prescaler setting of the unit position event //! frequency. //! //! This function configures the operation of the eQEP module edge-capture //! unit. The \e capPrescale parameter provides the configuration of the eQEP //! capture timer clock rate. It determines by which power of 2 between 1 and //! 128 inclusive SYSCLKOUT is divided. The macros for this parameter are in //! the format of EQEP_CAPTURE_CLK_DIV_X, where X is the divide value. For //! example, \b EQEP_CAPTURE_CLK_DIV_32 will give a capture timer clock //! frequency that is SYSCLKOUT/32. //! //! The \e evntPrescale parameter determines how frequently a unit position //! event occurs. The macro that can be passed this parameter is in the format //! EQEP_UNIT_POS_EVNT_DIV_X, where X is the number of quadrature clock //! periods between unit position events. For example, //! \b EQEP_UNIT_POS_EVNT_DIV_16 will result in a unit position event //! frequency of QCLK/16. //! //! \return None. // //***************************************************************************** static inline void EQEP_setCaptureConfig(uint32_t base, EQEP_CAPCLKPrescale capPrescale, EQEP_UPEVNTPrescale evntPrescale) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 887); } } while((_Bool)0); // // Write new prescaler configurations to the appropriate registers. // (*((volatile uint16_t *)(base + 0x16U))) = ((*((volatile uint16_t *)(base + 0x16U))) & ~(0xFU | 0x70U)) | ((uint16_t)evntPrescale | (uint16_t)capPrescale); } //***************************************************************************** // //! Enables the eQEP module edge-capture unit. //! //! \param base is the base address of the eQEP module. //! //! This function enables operation of the eQEP module's edge-capture unit. //! //! \return None. // //***************************************************************************** static inline void EQEP_enableCapture(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 915); } } while((_Bool)0); // // Enable edge capture. // (*((volatile uint16_t *)(base + 0x16U))) |= 0x8000U; } //***************************************************************************** // //! Disables the eQEP module edge-capture unit. //! //! \param base is the base address of the eQEP module. //! //! This function disables operation of the eQEP module's edge-capture unit. //! //! \return None. // //***************************************************************************** static inline void EQEP_disableCapture(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 940); } } while((_Bool)0); // // Disable edge capture. // (*((volatile uint16_t *)(base + 0x16U))) &= ~(0x8000U); } //***************************************************************************** // //! Gets the encoder capture period. //! //! \param base is the base address of the eQEP module. //! //! This function returns the period count value between the last successive //! eQEP position events. //! //! \return The period count value between the last successive position events. // //***************************************************************************** static inline uint16_t EQEP_getCapturePeriod(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 966); } } while((_Bool)0); // // Return the capture period. // return((*((volatile uint16_t *)(base + 0x1EU)))); } //***************************************************************************** // //! Gets the encoder capture timer value. //! //! \param base is the base address of the eQEP module. //! //! This function returns the time base for the edge capture unit. //! //! \return The capture timer value. // //***************************************************************************** static inline uint16_t EQEP_getCaptureTimer(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 991); } } while((_Bool)0); // // Return the capture timer value. // return((*((volatile uint16_t *)(base + 0x1DU)))); } //***************************************************************************** // //! Enables the eQEP module position-compare unit. //! //! \param base is the base address of the eQEP module. //! //! This function enables operation of the eQEP module's position-compare unit. //! //! \return None. // //***************************************************************************** static inline void EQEP_enableCompare(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1016); } } while((_Bool)0); // // Enable position compare. // (*((volatile uint16_t *)(base + 0x17U))) |= 0x1000U; } //***************************************************************************** // //! Disables the eQEP module position-compare unit. //! //! \param base is the base address of the eQEP module. //! //! This function disables operation of the eQEP module's position-compare //! unit. //! //! \return None. // //***************************************************************************** static inline void EQEP_disableCompare(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1042); } } while((_Bool)0); // // Disable position compare. // (*((volatile uint16_t *)(base + 0x17U))) &= ~(0x1000U); } //***************************************************************************** // //! Configures the position-compare unit's sync output pulse width. //! //! \param base is the base address of the eQEP module. //! \param cycles is the width of the pulse that can be generated on a //! position-compare event. It is in units of 4 SYSCLKOUT cycles. //! //! This function configures the width of the sync output pulse. The width of //! the pulse will be \e cycles * 4 * the width of a SYSCLKOUT cycle. The //! maximum width is 4096 * 4 * SYSCLKOUT cycles. //! //! \return None. // //***************************************************************************** static inline void EQEP_setComparePulseWidth(uint32_t base, uint16_t cycles) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1071); } } while((_Bool)0); do { if(!(cycles <= (0xFFFU + 1U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1072); } } while((_Bool)0); // // Set the pulse width. // (*((volatile uint16_t *)(base + 0x17U))) = ((*((volatile uint16_t *)(base + 0x17U))) & ~(uint16_t)0xFFFU) | (cycles - 1U); } //***************************************************************************** // //! Loads the eQEP module unit timer period as number of SYSCLK cycles. //! //! \param base is the base address of the eQEP module. //! \param period is period value at which a unit time-out interrupt is set. //! //! This function sets the unit time-out interrupt when it matches the value //! specified by \e period //! The unit timer is clocked by SYSCLKOUT //! //! \return None. // //***************************************************************************** static inline void EQEP_loadUnitTimer(uint32_t base, uint32_t period) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1102); } } while((_Bool)0); // // Set the period of the unit timer. // (*((volatile uint32_t *)(base + 0x10U))) = period; } //***************************************************************************** // //! Enables the eQEP module unit timer. //! //! \param base is the base address of the eQEP module. //! \param period is period value at which a unit time-out interrupt is set. //! //! This function enables operation of the eQEP module's peripheral unit timer. //! The unit timer is clocked by SYSCLKOUT and will set the unit time-out //! interrupt when it matches the value specified by \e period. //! //! \return None. // //***************************************************************************** static inline void EQEP_enableUnitTimer(uint32_t base, uint32_t period) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1130); } } while((_Bool)0); // // Set the period of the unit timer. // (*((volatile uint32_t *)(base + 0x10U))) = period; // // Enable peripheral unit timer. // (*((volatile uint16_t *)(base + 0x15U))) |= 0x2U; } //***************************************************************************** // //! Disables the eQEP module unit timer. //! //! \param base is the base address of the eQEP module. //! //! This function disables operation of the eQEP module's peripheral //! unit timer. //! //! \return None. // //***************************************************************************** static inline void EQEP_disableUnitTimer(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1161); } } while((_Bool)0); // // Disable peripheral unit timer. // (*((volatile uint16_t *)(base + 0x15U))) &= ~(0x2U); } //***************************************************************************** // //! Enables the eQEP module watchdog timer. //! //! \param base is the base address of the eQEP module. //! \param period is watchdog period value at which a time-out will occur if //! no quadrature-clock event is detected. //! //! This function enables operation of the eQEP module's peripheral watchdog //! timer. //! //! \note When selecting \e period, note that the watchdog timer is clocked //! from SYSCLKOUT/64. //! //! \return None. // //***************************************************************************** static inline void EQEP_enableWatchdog(uint32_t base, uint16_t period) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1192); } } while((_Bool)0); // // Set the timeout count for the eQEP peripheral watchdog timer. // (*((volatile uint16_t *)(base + 0x13U))) = period; // // Enable peripheral watchdog. // (*((volatile uint16_t *)(base + 0x15U))) |= 0x1U; } //***************************************************************************** // //! Disables the eQEP module watchdog timer. //! //! \param base is the base address of the eQEP module. //! //! This function disables operation of the eQEP module's peripheral watchdog //! timer. //! //! \return None. // //***************************************************************************** static inline void EQEP_disableWatchdog(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1223); } } while((_Bool)0); // // Disable peripheral watchdog. // (*((volatile uint16_t *)(base + 0x15U))) &= ~(0x1U); } //***************************************************************************** // //! Sets the eQEP module watchdog timer value. //! //! \param base is the base address of the eQEP module. //! \param value is the value to be written to the watchdog timer. //! //! This function sets the eQEP module's watchdog timer value. //! //! \return None. // //***************************************************************************** static inline void EQEP_setWatchdogTimerValue(uint32_t base, uint16_t value) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1249); } } while((_Bool)0); // // Write the value to the watchdog timer register. // (*((volatile uint16_t *)(base + 0x12U))) = value; } //***************************************************************************** // //! Gets the eQEP module watchdog timer value. //! //! \param base is the base address of the eQEP module. //! //! \return Returns the current watchdog timer value. // //***************************************************************************** static inline uint16_t EQEP_getWatchdogTimerValue(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1272); } } while((_Bool)0); // // Read the value from the watchdog timer register. // return((*((volatile uint16_t *)(base + 0x12U)))); } //***************************************************************************** // //! Configures the mode in which the position counter is initialized. //! //! \param base is the base address of the eQEP module. //! \param initMode is the configuration for initializing the position count. //! See below for a description of this parameter. //! //! This function configures the events on which the position count can be //! initialized. The \e initMode parameter provides the mode as either //! \b EQEP_INIT_DO_NOTHING (no action configured) or one of the following //! strobe events, index events, or a logical OR of both a strobe event and an //! index event. //! //! - \b EQEP_INIT_RISING_STROBE or \b EQEP_INIT_EDGE_DIR_STROBE specify //! which strobe event will initialize the position counter. //! - \b EQEP_INIT_RISING_INDEX or \b EQEP_INIT_FALLING_INDEX specify //! which index event will initialize the position counter. //! //! Use EQEP_setSWPositionInit() to cause a software initialization and //! EQEP_setInitialPosition() to set the value that gets loaded into the //! position counter upon initialization. //! //! \return None. // //***************************************************************************** static inline void EQEP_setPositionInitMode(uint32_t base, uint16_t initMode) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1312); } } while((_Bool)0); // // Set the init mode in the QEP Control register. // (*((volatile uint16_t *)(base + 0x15U))) = ((*((volatile uint16_t *)(base + 0x15U))) & ~(0x300U | 0xC00U)) | initMode; } //***************************************************************************** // //! Sets the software initialization of the encoder position counter. //! //! \param base is the base address of the eQEP module. //! \param initialize is a flag to specify if software initialization of the //! position counter is enabled. //! //! This function does a software initialization of the position counter when //! the \e initialize parameter is \b true. When \b false, the QEPCTL[SWI] bit //! is cleared and no action is taken. //! //! The init value to be loaded into the position counter can be set with //! EQEP_setInitialPosition(). Additional initialization causes can be //! configured with EQEP_setPositionInitMode(). //! //! \return None. // //***************************************************************************** static inline void EQEP_setSWPositionInit(uint32_t base, _Bool initialize) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1347); } } while((_Bool)0); // // Set or clear the software initialization bit. // if(initialize) { (*((volatile uint16_t *)(base + 0x15U))) |= 0x80U; } else { (*((volatile uint16_t *)(base + 0x15U))) &= ~0x80U; } } //***************************************************************************** // //! Sets the init value for the encoder position counter. //! //! \param base is the base address of the eQEP module. //! \param position is the value to be written to the position counter upon. //! initialization. //! //! This function sets the init value for position of the encoder. See //! EQEP_setPositionInitMode() to set the initialization cause or //! EQEP_setSWPositionInit() to cause a software initialization. //! //! \return None. // //***************************************************************************** static inline void EQEP_setInitialPosition(uint32_t base, uint32_t position) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1383); } } while((_Bool)0); // // Write position to position counter init register // (*((volatile uint32_t *)(base + 0x2U))) = position; } //***************************************************************************** // //! Configures the quadrature modes in which the position count can be latched. //! //! \param base is the base address of the eQEP module. //! \param latchMode is the configuration for latching of the position count //! and several other registers. See below for a description of this //! parameter. //! //! This function configures the events on which the position count and several //! other registers can be latched. The \e latchMode parameter provides the //! mode as the logical OR of several values. //! //! - \b EQEP_LATCH_CNT_READ_BY_CPU or \b EQEP_LATCH_UNIT_TIME_OUT specify //! the event that latches the position counter. This latch register can be //! read using EQEP_getPositionLatch(). The capture timer and capture //! period are also latched based on this setting, and can be read using //! EQEP_getCaptureTimerLatch() and EQEP_getCapturePeriodLatch(). //! - \b EQEP_LATCH_RISING_STROBE or \b EQEP_LATCH_EDGE_DIR_STROBE //! specify which strobe event will latch the position counter into the //! strobe position latch register. This register can be read with //! EQEP_getStrobePositionLatch(). //! - \b EQEP_LATCH_RISING_INDEX, \b EQEP_LATCH_FALLING_INDEX, or //! \b EQEP_LATCH_SW_INDEX_MARKER specify which index event will latch the //! position counter into the index position latch register. This register //! can be read with EQEP_getIndexPositionLatch(). //! //! \return None. // //***************************************************************************** static inline void EQEP_setLatchMode(uint32_t base, uint32_t latchMode) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1427); } } while((_Bool)0); // // Set the latch mode in the QEP Control register. // (*((volatile uint16_t *)(base + 0x15U))) = ((*((volatile uint16_t *)(base + 0x15U))) & ~(0x4U | 0x30U | 0x40U)) | latchMode; } //***************************************************************************** // //! Gets the encoder position that was latched on an index event. //! //! \param base is the base address of the eQEP module. //! //! This function returns the value in the index position latch register. The //! position counter is latched into this register on either a rising index //! edge, a falling index edge, or a software index marker. This is configured //! using EQEP_setLatchMode(). //! //! \return The position count latched on an index event. // //***************************************************************************** static inline uint32_t EQEP_getIndexPositionLatch(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1457); } } while((_Bool)0); // // Return the current position counter. // return((*((volatile uint32_t *)(base + 0x8U)))); } //***************************************************************************** // //! Gets the encoder position that was latched on a strobe event. //! //! \param base is the base address of the eQEP module. //! //! This function returns the value in the strobe position latch register. The //! position counter can be configured to be latched into this register on //! rising strobe edges only or on rising strobe edges while moving clockwise //! and falling strobe edges while moving counter-clockwise. This is configured //! using EQEP_setLatchMode(). //! //! \return The position count latched on a strobe event. // //***************************************************************************** static inline uint32_t EQEP_getStrobePositionLatch(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1486); } } while((_Bool)0); // // Return the current position counter. // return((*((volatile uint32_t *)(base + 0xAU)))); } //***************************************************************************** // //! Gets the encoder position that was latched on a unit time-out event. //! //! \param base is the base address of the eQEP module. //! //! This function returns the value in the position latch register. The //! position counter is latched into this register either on a unit time-out //! event. //! //! \return The position count latch register value. // //***************************************************************************** static inline uint32_t EQEP_getPositionLatch(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1513); } } while((_Bool)0); // // Return the current position counter. // return((*((volatile uint32_t *)(base + 0xCU)))); } //***************************************************************************** // //! Gets the encoder capture timer latch. //! //! \param base is the base address of the eQEP module. //! //! This function returns the value in the capture timer latch register. The //! capture timer value is latched into this register either on a unit time-out //! event or upon the CPU reading the eQEP position counter. This is configured //! using EQEP_setLatchMode(). //! //! \return The edge-capture timer latch value. // //***************************************************************************** static inline uint16_t EQEP_getCaptureTimerLatch(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1541); } } while((_Bool)0); // // Return the current position counter. // return((*((volatile uint16_t *)(base + 0x1FU)))); } //***************************************************************************** // //! Gets the encoder capture period latch. //! //! \param base is the base address of the eQEP module. //! //! This function returns the value in the capture period latch register. The //! capture period value is latched into this register either on a unit //! time-out event or upon the CPU reading the eQEP position counter. This is //! configured using EQEP_setLatchMode(). //! //! \return The edge-capture period latch value. // //***************************************************************************** static inline uint16_t EQEP_getCapturePeriodLatch(uint32_t base) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1569); } } while((_Bool)0); // // Return the current position counter. // return((*((volatile uint16_t *)(base + 0x20U)))); } //***************************************************************************** // //! Set the emulation mode of the eQEP module. //! //! \param base is the base address of the eQEP module. //! \param emuMode is the mode operation upon an emulation suspend. //! //! This function sets the eQEP module's emulation mode. This mode determines //! how the timers are affected by an emulation suspend. Valid values for the //! \e emuMode parameter are the following: //! //! - \b EQEP_EMULATIONMODE_STOPIMMEDIATELY - The position counter, watchdog //! counter, unit timer, and capture timer all stop immediately. //! - \b EQEP_EMULATIONMODE_STOPATROLLOVER - The position counter, watchdog //! counter, unit timer all count until period rollover. The capture timer //! counts until the next unit period event. //! - \b EQEP_EMULATIONMODE_RUNFREE - The position counter, watchdog counter, //! unit timer, and capture timer are all unaffected by an emulation suspend. //! //! \return None. // //***************************************************************************** static inline void EQEP_setEmulationMode(uint32_t base, EQEP_EmulationMode emuMode) { // // Check the arguments. // do { if(!(EQEP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/eqep.h", 1605); } } while((_Bool)0); // // Write the emulation mode to the FREE_SOFT bits. // (*((volatile uint16_t *)(base + 0x15U))) = ((*((volatile uint16_t *)(base + 0x15U))) & ~0xC000U) | ((uint16_t)emuMode << 14U); } //***************************************************************************** // //! Configures eQEP module position-compare unit. //! //! \param base is the base address of the eQEP module. //! \param config is the configuration for the eQEP module //! position-compare unit. See below for a description of this parameter. //! \param compareValue is the value to which the position count value is //! compared for a position-compare event. //! \param cycles is the width of the pulse that can be generated on a //! position-compare event. It is in units of 4 SYSCLKOUT cycles. //! //! This function configures the operation of the eQEP module position-compare //! unit. The \e config parameter provides the configuration of the //! position-compare unit and is the logical OR of several values: //! //! - \b EQEP_COMPARE_NO_SYNC_OUT, \b EQEP_COMPARE_IDX_SYNC_OUT, or //! \b EQEP_COMPARE_STROBE_SYNC_OUT specify if there is a sync output pulse //! and which pin should be used. //! - \b EQEP_COMPARE_NO_SHADOW, \b EQEP_COMPARE_LOAD_ON_ZERO, or //! \b EQEP_COMPARE_LOAD_ON_MATCH specify if a shadow is enabled and when //! should the load should occur--QPOSCNT = 0 or QPOSCNT = QPOSCOMP. //! //! The \e cycles is used to select the width of the sync output pulse. The //! width of the resulting pulse will be \e cycles * 4 * the width of a //! SYSCLKOUT cycle. The maximum width is 4096 * 4 * SYSCLKOUT cycles. //! //! \note You can set the sync pulse width independently using the //! EQEP_setComparePulseWidth() function. //! //! \return None. // //***************************************************************************** extern void EQEP_setCompareConfig(uint32_t base, uint16_t config, uint32_t compareValue, uint16_t cycles); //***************************************************************************** // //! Sets the polarity of the eQEP module's input signals. //! //! \param base is the base address of the eQEP module. //! \param invertQEPA is the flag to negate the QEPA input. //! \param invertQEPB is the flag to negate the QEPA input. //! \param invertIndex is the flag to negate the index input. //! \param invertStrobe is the flag to negate the strobe input. //! //! This function configures the polarity of the inputs to the eQEP module. To //! negate the polarity of any of the input signals, pass \b true into its //! corresponding parameter in this function. Pass \b false to leave it as-is. //! //! \return None. // //***************************************************************************** extern void EQEP_setInputPolarity(uint32_t base, _Bool invertQEPA, _Bool invertQEPB, _Bool invertIndex, _Bool invertStrobe); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: flash.h // // TITLE: C28x Flash driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup flash_api Flash //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_flash.h // // TITLE: Definitions for the FLASH registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the FLASH register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FRDCNTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FBAC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FBFALLBACK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FBPRDY register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FPAC1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FMSTAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FRD_INTF_CTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ECC_ENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ERR_STATUS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ERR_POS register // //************************************************************************************************* // bits // bits //************************************************************************************************* // // The following are defines for the bit fields in the ERR_STATUS_CLR register // //************************************************************************************************* // Value 0 Clear // Value 1 Clear // occurred Clear // Value 0 Clear // Value 1 Clear // occurred Clear //************************************************************************************************* // // The following are defines for the bit fields in the ERR_CNT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ERR_THRESHOLD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ERR_INTFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ERR_INTCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FADDR_TEST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FECC_TEST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FECC_CTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the FECC_STATUS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PUMPREQUEST register // //************************************************************************************************* // CPU1 and CPU2 // register #pragma CODE_SECTION(Flash_setBankPowerMode, ".TI.ramfunc"); #pragma CODE_SECTION(Flash_setPumpPowerMode, ".TI.ramfunc"); #pragma CODE_SECTION(Flash_disableCache, ".TI.ramfunc"); #pragma CODE_SECTION(Flash_disablePrefetch, ".TI.ramfunc"); #pragma CODE_SECTION(Flash_setWaitstates, ".TI.ramfunc"); #pragma CODE_SECTION(Flash_enableCache, ".TI.ramfunc"); #pragma CODE_SECTION(Flash_enablePrefetch, ".TI.ramfunc"); #pragma CODE_SECTION(Flash_enableECC, ".TI.ramfunc"); //***************************************************************************** // //! Values that can be passed to Flash_setBankPowerMode() as the bank parameter // //***************************************************************************** typedef enum { FLASH_BANK = 0x0 //!< Bank } Flash_BankNumber; //***************************************************************************** // //! Values that can be passed to Flash_claimPumpSemaphore() in order to claim //! the pump semaphore. // //***************************************************************************** typedef enum { FLASH_CPU1_WRAPPER = 0x2, //!< CPU1 Wrapper FLASH_CPU2_WRAPPER = 0x1 //!< CPU2 Wrapper }Flash_PumpOwnership; //***************************************************************************** // //! Values that can be passed to Flash_setBankPowerMode() as the powerMode //! parameter. // //***************************************************************************** typedef enum { FLASH_BANK_PWR_SLEEP = 0x0, //!< Sleep fallback mode FLASH_BANK_PWR_STANDBY = 0x1, //!< Standby fallback mode FLASH_BANK_PWR_ACTIVE = 0x3 //!< Active fallback mode } Flash_BankPowerMode; //***************************************************************************** // //! Values that can be passed to Flash_setPumpPowerMode() as the powerMode //! parameter. // //***************************************************************************** typedef enum { FLASH_PUMP_PWR_SLEEP = 0x0, //!< Sleep fallback mode FLASH_PUMP_PWR_ACTIVE = 0x1 //!< Active fallback mode } Flash_PumpPowerMode; //***************************************************************************** // //! Type that correspond to values returned from Flash_getLowErrorStatus() and //! Flash_getHighErrorStatus() determining the error status code. // //***************************************************************************** typedef enum { FLASH_NO_ERR = 0x0, //!< No error FLASH_FAIL_0 = 0x1, //!< Fail on 0 FLASH_FAIL_1 = 0x2, //!< Fail on 1 FLASH_UNC_ERR = 0x4 //!< Uncorrectable error } Flash_ErrorStatus; //***************************************************************************** // //! Values that can be returned from Flash_getLowErrorType() and //! Flash_getHighErrorType() determining the error type. // //***************************************************************************** typedef enum { FLASH_DATA_ERR = 0x0, //!< Data error FLASH_ECC_ERR = 0x1 //!< ECC error } Flash_ErrorType; //***************************************************************************** // //! Values that can be returned from Flash_getECCTestSingleBitErrorType(). // //***************************************************************************** typedef enum { FLASH_DATA_BITS = 0x0, //!< Data bits FLASH_CHECK_BITS = 0x1 //!< ECC bits } Flash_SingleBitErrorIndicator; //***************************************************************************** // // Values that can be passed to Flash_clearLowErrorStatus and // Flash_clearHighErrorStatus. // //***************************************************************************** //***************************************************************************** // // Values that can be returned from Flash_getInterruptFlag and // Flash_getECCTestStatus. // //***************************************************************************** //***************************************************************************** // // Delay instruction that allows for register configuration to complete. // //***************************************************************************** //***************************************************************************** // // Key value for claiming the pump semaphore. // //***************************************************************************** //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks a flash wrapper base address for the control registers. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! This function determines if a flash wrapper control base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool Flash_isCtrlBaseValid(uint32_t ctrlBase) { return((ctrlBase == 0x0005F800U)); } //***************************************************************************** // //! \internal //! Checks a flash wrapper base address for the ECC registers. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function determines if a flash wrapper ECC base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool Flash_isECCBaseValid(uint32_t eccBase) { return((eccBase == 0x0005FB00U)); } //***************************************************************************** // //! \internal //! Checks a flash pump semaphore base address. //! //! \param pumpSemBase is the base address of the flash pump semaphore. //! //! This function determines if a flash pump semaphore base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool Flash_isPumpSemBaseValid(uint32_t pumpSemBase) { return((pumpSemBase == 0x00050024U)); } //***************************************************************************** // //! Sets the random read wait state amount. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! \param waitstates is the wait-state value. //! //! This function sets the number of wait states for a flash read access. The //! \e waitstates parameter is a number between 0 and 15. It is \b important //! to look at your device's datasheet for information about what the required //! minimum flash wait-state is for your selected SYSCLK frequency. //! //! By default the wait state amount is configured to the maximum 15. //! //! \return None. // //***************************************************************************** static inline void Flash_setWaitstates(uint32_t ctrlBase, uint16_t waitstates) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 295); } } while((_Bool)0); // // waitstates is 4 bits wide. // do { if(!(waitstates <= 0xFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 300); } } while((_Bool)0); __eallow(); // // Write flash read wait-state amount to appropriate register. // (*((volatile uint32_t *)(ctrlBase + 0x0U))) = ((*((volatile uint32_t *)(ctrlBase + 0x0U))) & ~(uint32_t)0xF00U) | ((uint32_t)waitstates << 8U); __edis(); } //***************************************************************************** // //! Sets the fallback power mode of a flash bank. //! //! \param ctrlBase is the base address of the flash wrapper registers. //! \param bank is the flash bank that is being configured. //! \param powerMode is the power mode to be entered. //! //! This function sets the fallback power mode of the flash bank specified by //! them \e bank parameter. The power mode is specified by the \e powerMode //! parameter with one of the following values: //! //! - \b FLASH_BANK_PWR_SLEEP - Sense amplifiers and sense reference disabled. //! - \b FLASH_BANK_PWR_STANDBY - Sense amplifiers disabled but sense reference //! enabled. //! - \b FLASH_BANK_PWR_ACTIVE - Sense amplifiers and sense reference enabled. //! //! //! Note: There is only one Flash_BankNumber value on this device (FLASH_BANK). //! //! \return None. // //***************************************************************************** static inline void Flash_setBankPowerMode(uint32_t ctrlBase, Flash_BankNumber bank, Flash_BankPowerMode powerMode) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 346); } } while((_Bool)0); __eallow(); // // Write the power mode to the appropriate register. // (*((volatile uint32_t *)(ctrlBase + 0x20U))) = ((*((volatile uint32_t *)(ctrlBase + 0x20U))) & ~((0x3U) << ((uint32_t)bank * 2U))) | ((uint32_t)powerMode << ((uint32_t)bank * 2U)); __edis(); } //***************************************************************************** // //! Sets the fallback power mode of the charge pump. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! \param powerMode is the power mode to be entered. //! //! This function sets the fallback power mode flash charge pump. //! //! - \b FLASH_PUMP_PWR_SLEEP - All circuits disabled. //! - \b FLASH_PUMP_PWR_ACTIVE - All pump circuits active. //! //! \return None. // //***************************************************************************** static inline void Flash_setPumpPowerMode(uint32_t ctrlBase, Flash_PumpPowerMode powerMode) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 384); } } while((_Bool)0); __eallow(); // // Write the power mode to the appropriate register. // (*((volatile uint32_t *)(ctrlBase + 0x24U))) = ((*((volatile uint32_t *)(ctrlBase + 0x24U))) & ~(uint32_t)0x1U) | (uint32_t)powerMode; __edis(); } //***************************************************************************** // //! Enables prefetch mechanism. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! \return None. // //***************************************************************************** static inline void Flash_enablePrefetch(uint32_t ctrlBase) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 415); } } while((_Bool)0); __eallow(); // // Set the prefetch enable bit. // (*((volatile uint32_t *)(ctrlBase + 0x180U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disables prefetch mechanism. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! \return None. // //***************************************************************************** static inline void Flash_disablePrefetch(uint32_t ctrlBase) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 445); } } while((_Bool)0); __eallow(); // // Clear the prefetch enable bit. // (*((volatile uint32_t *)(ctrlBase + 0x180U))) &= ~(uint32_t)0x1U; __edis(); } //***************************************************************************** // //! Enables data cache. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! \return None. // //***************************************************************************** static inline void Flash_enableCache(uint32_t ctrlBase) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 475); } } while((_Bool)0); __eallow(); // // Set the data cache enable bit. // (*((volatile uint32_t *)(ctrlBase + 0x180U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Disables data cache. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! \return None. // //***************************************************************************** static inline void Flash_disableCache(uint32_t ctrlBase) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 505); } } while((_Bool)0); __eallow(); // // Clear the data cache enable bit. // (*((volatile uint32_t *)(ctrlBase + 0x180U))) &= ~(uint32_t)0x2U; __edis(); } //***************************************************************************** // //! Enables flash error correction code (ECC) protection. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_enableECC(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 535); } } while((_Bool)0); __eallow(); // // Write the key value 0xA to ECC_ENABLE register. // (*((volatile uint32_t *)(eccBase + 0x0U))) = ((*((volatile uint32_t *)(eccBase + 0x0U))) & ~(uint32_t)0xFU) | 0xAU; __edis(); } //***************************************************************************** // //! Disables flash error correction code (ECC) protection. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_disableECC(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 563); } } while((_Bool)0); __eallow(); // // Clear ECC enable field with the one's complement of the key. // (*((volatile uint32_t *)(eccBase + 0x0U))) = ((*((volatile uint32_t *)(eccBase + 0x0U))) & ~(uint32_t)0xFU) | 0x5U; __edis(); } //***************************************************************************** // //! Sets the bank power up delay. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! \param delay is the number of HCLK cycles. //! //! This function sets the VREADST delay to ensure that the requisite delay is //! introduced for the flash pump/bank to come out of low-power mode, so that //! the flash/OTP is ready for CPU access. //! //! Note: Refer to TRM before configuring VREADST. //! //! \return None. // //***************************************************************************** static inline void Flash_setBankPowerUpDelay(uint32_t ctrlBase, uint16_t delay) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 599); } } while((_Bool)0); do { if(!(delay <= 0xFF)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 600); } } while((_Bool)0); __eallow(); // // Write period to the BAGP of the FBAC register. // (*((volatile uint32_t *)(ctrlBase + 0x1EU))) = ((*((volatile uint32_t *)(ctrlBase + 0x1EU))) & ~(uint32_t)0xFFU) | delay; __edis(); } //***************************************************************************** // //! Sets the pump wake up time. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! \param sysclkCycles is the number of SYSCLK cycles it takes for the pump //! to wakeup. //! //! This function sets the wakeup time with \e sysclkCycles parameter. //! The \e sysclkCycles is a value between 0 and 8190. When the charge pump //! exits sleep power mode, it will take sysclkCycles to wakeup. //! //! \return None. // //***************************************************************************** static inline void Flash_setPumpWakeupTime(uint32_t ctrlBase, uint16_t sysclkCycles) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 633); } } while((_Bool)0); // // PSLEEP = sysclkCycles/2. PSLEEP maximum value is 4095(12 bits wide) // do { if(!(sysclkCycles <= 8190U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 638); } } while((_Bool)0); __eallow(); // // Write sysclkCycles/2 to PSLEEP of the FPAC1 register. // (*((volatile uint32_t *)(ctrlBase + 0x24U))) = ((*((volatile uint32_t *)(ctrlBase + 0x24U))) & ~(uint32_t)0xFFF0000U) | (((uint32_t)sysclkCycles / (uint32_t)2) << (uint32_t)16U); __edis(); } //***************************************************************************** // //! Reads the bank active power state. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! \param bank is the flash bank that is being used. //! //! \return Returns \b true if the Bank is in Active power state and \b false //! otherwise. // //***************************************************************************** static inline _Bool Flash_isBankReady(uint32_t ctrlBase, Flash_BankNumber bank) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 670); } } while((_Bool)0); _Bool ready; uint32_t bitMask = (uint32_t)0x1U << (uint32_t)bank; // // Return the BANKXRDY bit in FBPRDY. // if(((*((volatile uint32_t *)(ctrlBase + 0x22U))) & bitMask) == bitMask) { ready = 1; } else { ready = 0; } return(ready); } //***************************************************************************** // //! Reads the pump active power state. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! \return Returns \b true if the Pump is in Active power state and \b false //! otherwise. // //***************************************************************************** static inline _Bool Flash_isPumpReady(uint32_t ctrlBase) { // // Check the arguments. // do { if(!(Flash_isCtrlBaseValid(ctrlBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 704); } } while((_Bool)0); _Bool ready; // // Return the PUMPRDY bit in FBPRDY. // if(((*((volatile uint32_t *)(ctrlBase + 0x22U))) & (uint32_t)0x8000U) == 0x8000U) { ready = 1; } else { ready = 0; } return(ready); } //***************************************************************************** // //! Gets the single error address low. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the 32-bit address of the single bit error that //! occurred in the lower 64-bits of a 128-bit memory-aligned data. The //! returned address is to that 64-bit aligned data. //! //! \return Returns the 32 bits of a 64-bit aligned address where a single bit //! error occurred. // //***************************************************************************** static inline uint32_t Flash_getSingleBitErrorAddressLow(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 744); } } while((_Bool)0); return((*((volatile uint32_t *)(eccBase + 0x2U)))); } //***************************************************************************** // //! Gets the single error address high. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the 32-bit address of the single bit error that //! occurred in the upper 64-bits of a 128-bit memory-aligned data. The //! returned address is to that 64-bit aligned data. //! //! \return Returns the 32 bits of a 64-bit aligned address where a single bit //! error occurred. // //***************************************************************************** static inline uint32_t Flash_getSingleBitErrorAddressHigh(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 769); } } while((_Bool)0); return((*((volatile uint32_t *)(eccBase + 0x4U)))); } //***************************************************************************** // //! Gets the uncorrectable error address low. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the 32-bit address of the uncorrectable error that //! occurred in the lower 64-bits of a 128-bit memory-aligned data. The //! returned address is to that 64-bit aligned data. //! //! \return Returns the 32 bits of a 64-bit aligned address where an //! uncorrectable error occurred. // //***************************************************************************** static inline uint32_t Flash_getUncorrectableErrorAddressLow(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 794); } } while((_Bool)0); return((*((volatile uint32_t *)(eccBase + 0x6U)))); } //***************************************************************************** // //! Gets the uncorrectable error address high. //! //! \param eccBase is the base address of the flash wrapper ECC base. //! //! This function returns the 32-bit address of the uncorrectable error that //! occurred in the upper 64-bits of a 128-bit memory-aligned data. The //! returned address is to that 64-bit aligned data. //! //! \return Returns the 32 bits of a 64-bit aligned address where an //! uncorrectable error occurred. // //***************************************************************************** static inline uint32_t Flash_getUncorrectableErrorAddressHigh(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 819); } } while((_Bool)0); return((*((volatile uint32_t *)(eccBase + 0x8U)))); } //***************************************************************************** // //! Gets the error status of the Lower 64-bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the error status of the lower 64-bits of a 128-bit //! aligned address. //! //! \return Returns value of the low error status bits which can be used with //! Flash_ErrorStatus type. // //***************************************************************************** static inline Flash_ErrorStatus Flash_getLowErrorStatus(uint32_t eccBase) { uint32_t errorStatus; // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 844); } } while((_Bool)0); // // Get the Low Error Status bits // errorStatus = ((*((volatile uint32_t *)(eccBase + 0xAU))) & 0x7UL); return((Flash_ErrorStatus)errorStatus); } //***************************************************************************** // //! Gets the error status of the Upper 64-bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the error status of the upper 64-bits of a 128-bit //! aligned address. //! //! \return Returns value of the high error status bits which can be used with //! Flash_ErrorStatus type. // //***************************************************************************** static inline Flash_ErrorStatus Flash_getHighErrorStatus(uint32_t eccBase) { uint32_t errorStatus; // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 873); } } while((_Bool)0); // // Get the High Error Status bits // errorStatus = (((*((volatile uint32_t *)(eccBase + 0xAU))) >> 16U) & 0x7UL); return((Flash_ErrorStatus)errorStatus); } //***************************************************************************** // //! Gets the error position of the lower 64-bits for a single bit error. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the error position of the lower 64-bits. If the //! error type is FLASH_ECC_ERR, the position ranges from 0-7 else it ranges //! from 0-63 for FLASH_DATA_ERR. //! //! \return Returns the position of the lower error bit. // //***************************************************************************** static inline uint32_t Flash_getLowErrorPosition(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 901); } } while((_Bool)0); return(((*((volatile uint32_t *)(eccBase + 0xCU))) & (uint32_t)0x3FU) >> 0U); } //***************************************************************************** // //! Gets the error position of the upper 64-bits for a single bit error. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the error position of the upper 64-bits. If the //! error type is FLASH_ECC_ERR, the position ranges from 0-7 else it ranges //! from 0-63 for FLASH_DATA_ERR. //! //! \return Returns the position of the upper error bit. // //***************************************************************************** static inline uint32_t Flash_getHighErrorPosition(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 927); } } while((_Bool)0); return(((*((volatile uint32_t *)(eccBase + 0xCU))) & (uint32_t)0x3F0000U) >> 16U); } //***************************************************************************** // //! Gets the error type of the lower 64-bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the error type of the lower 64-bits. The error type //! can be FLASH_ECC_ERR or FLASH_DATA_ERR. //! //! \return Returns the type of the lower 64-bit error. // //***************************************************************************** static inline Flash_ErrorType Flash_getLowErrorType(uint32_t eccBase) { Flash_ErrorType errorType; // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 953); } } while((_Bool)0); // // Check which error type. // If bit is 1 then ECC error, else it is a Data error. // if(((*((volatile uint32_t *)(eccBase + 0xCU))) & 0x100U) == 0x100U) { errorType = FLASH_ECC_ERR; } else { errorType = FLASH_DATA_ERR; } return(errorType); } //***************************************************************************** // //! Gets the error type of the upper 64-bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the error type of the upper 64-bits. The error type //! can be FLASH_ECC_ERR or FLASH_DATA_ERR. //! //! \return Returns the type of the upper 64-bit error. // //***************************************************************************** static inline Flash_ErrorType Flash_getHighErrorType(uint32_t eccBase) { Flash_ErrorType errorType; // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 991); } } while((_Bool)0); // // Check which error type. // If bit is 1 then ECC error, else it is a Data error. // if(((*((volatile uint32_t *)(eccBase + 0xCU))) & 0x1000000U) == 0x1000000U) { errorType = FLASH_ECC_ERR; } else { errorType = FLASH_DATA_ERR; } return(errorType); } //***************************************************************************** // //! Clears the errors status of the lower 64-bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param errorStatus is the error status to clear. errorStatus is a uint16_t. //! errorStatus is a bitwise OR of the following value: //! //! - \b FLASH_FAIL_0_CLR //! - \b FLASH_FAIL_1_CLR //! - \b FLASH_UNC_ERR_CLR //! //! \return None. // //***************************************************************************** static inline void Flash_clearLowErrorStatus(uint32_t eccBase, uint16_t errorStatus) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1030); } } while((_Bool)0); do { if(!(errorStatus <= 7U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1031); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0xEU))) |= ((uint32_t)errorStatus); __edis(); } //***************************************************************************** // //! Clears the errors status of the upper 64-bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param errorStatus is the error status to clear. errorStatus is a uint16_t. //! errorStatus is a bitwise OR of the following value: //! //! - \b FLASH_FAIL_0_CLR //! - \b FLASH_FAIL_1_CLR //! - \b FLASH_UNC_ERR_CLR //! //! \return None. // //***************************************************************************** static inline void Flash_clearHighErrorStatus(uint32_t eccBase, uint16_t errorStatus) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1059); } } while((_Bool)0); do { if(!(errorStatus <= 7U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1060); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0xEU))) |= ((uint32_t)errorStatus << 16U); __edis(); } //***************************************************************************** // //! Gets the single bit error count. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return Returns the single bit error count. // //***************************************************************************** static inline uint32_t Flash_getErrorCount(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1082); } } while((_Bool)0); return((*((volatile uint32_t *)(eccBase + 0x10U))) & (uint32_t)0xFFFFU); } //***************************************************************************** // //! Sets the single bit error threshold. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param threshold is the single bit error threshold. Valid ranges are from //! 0-65535. //! //! \return None. // //***************************************************************************** static inline void Flash_setErrorThreshold(uint32_t eccBase, uint16_t threshold) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1105); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x12U))) = ((uint32_t)threshold & (uint32_t)0xFFFFU); __edis(); } //***************************************************************************** // //! Gets the error interrupt. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the type of error interrupt that occurred. The //! values can be used with //! - \b FLASH_NO_ERROR //! - \b FLASH_SINGLE_ERROR //! - \b FLASH_UNC_ERROR //! //! \return Returns the interrupt flag. // //***************************************************************************** static inline uint32_t Flash_getInterruptFlag(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1134); } } while((_Bool)0); // // Read which type of error occurred. // return(((*((volatile uint32_t *)(eccBase + 0x14U))) & (uint32_t)0x3U)); } //***************************************************************************** // //! Clears the single error interrupt flag. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_clearSingleErrorInterruptFlag(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1157); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x16U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Clears the uncorrectable error interrupt flag. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_clearUncorrectableInterruptFlag(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1180); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x16U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Sets the Data Low Test register for ECC testing. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param data is a 32-bit value that is the low double word of selected //! 64-bit data //! //! \return None. // //***************************************************************************** static inline void Flash_setDataLowECCTest(uint32_t eccBase, uint32_t data) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1205); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x1AU))) = data; __edis(); } //***************************************************************************** // //! Sets the Data High Test register for ECC testing. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param data is a 32-bit value that is the high double word of selected //! 64-bit data //! //! \return None. // //***************************************************************************** static inline void Flash_setDataHighECCTest(uint32_t eccBase, uint32_t data) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1229); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x18U))) = data; __edis(); } //***************************************************************************** // //! Sets the test address register for ECC testing. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param address is a 32-bit value containing an address. Bits 21-3 will be //! used as the flash word (128-bit) address. //! //! This function left shifts the address 1 bit to convert it to a byte address //! //! \return None. // //***************************************************************************** static inline void Flash_setECCTestAddress(uint32_t eccBase, uint32_t address) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1255); } } while((_Bool)0); // // Left shift the address 1 bit to make it byte-addressable // uint32_t byteAddress = address << 1; __eallow(); // // Write bits 21-3 to the register. // (*((volatile uint32_t *)(eccBase + 0x1CU))) = byteAddress; __edis(); } //***************************************************************************** // //! Sets the ECC test bits for ECC testing. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param ecc is a 32-bit value. The least significant 8 bits are used as //! the ECC Control Bits in the ECC Test. //! //! \return None. // //***************************************************************************** static inline void Flash_setECCTestECCBits(uint32_t eccBase, uint16_t ecc) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1290); } } while((_Bool)0); do { if(!(ecc <= 255U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1292); } } while((_Bool)0); __eallow(); // // Write the 8 ECC Control Bits. // (*((volatile uint32_t *)(eccBase + 0x1EU))) = ((uint32_t)ecc & (uint32_t)0xFFU); __edis(); } //***************************************************************************** // //! Enables ECC Test mode. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_enableECCTestMode(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1318); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x20U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disables ECC Test mode. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_disableECCTestMode(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1340); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x20U))) &= ~(uint32_t)0x1U; __edis(); } //***************************************************************************** // //! Selects the ECC block on bits [63:0] of bank data. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_selectLowECCBlock(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1363); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x20U))) &= ~(uint32_t)0x2U; __edis(); } //***************************************************************************** // //! Selects the ECC block on bits [127:64] of bank data. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_selectHighECCBlock(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1386); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x20U))) |= 0x2U; __edis(); } //***************************************************************************** // //! Performs the ECC calculation on the test block. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return None. // //***************************************************************************** static inline void Flash_performECCCalculation(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1408); } } while((_Bool)0); __eallow(); (*((volatile uint32_t *)(eccBase + 0x20U))) |= 0x4U; __edis(); } //***************************************************************************** // //! Gets the ECC Test data out high 63:32 bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return Returns the ECC TEst data out High. // //***************************************************************************** static inline uint32_t Flash_getTestDataOutHigh(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1430); } } while((_Bool)0); return((*((volatile uint32_t *)(eccBase + 0x22U)))); } //***************************************************************************** // //! Gets the ECC Test data out low 31:0 bits. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return Returns the ECC Test data out Low. // //***************************************************************************** static inline uint32_t Flash_getTestDataOutLow(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1450); } } while((_Bool)0); return((*((volatile uint32_t *)(eccBase + 0x24U)))); } //***************************************************************************** // //! Gets the ECC Test status. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! This function returns the ECC test status. The values can be used with //! - \b FLASH_NO_ERROR //! - \b FLASH_SINGLE_ERROR //! - \b FLASH_UNC_ERROR //! //! \return Returns the ECC test status. // //***************************************************************************** static inline uint32_t Flash_getECCTestStatus(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1475); } } while((_Bool)0); // // Read which type of error occurred. // return(((*((volatile uint32_t *)(eccBase + 0x26U)))) & (uint32_t)0x3U); } //***************************************************************************** // //! Gets the ECC Test single bit error position. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return Returns the ECC Test single bit error position. If the error type //! is check bits than the position can range from 0 to 7. If the error type //! is data bits than the position can range from 0 to 63. // //***************************************************************************** static inline uint32_t Flash_getECCTestErrorPosition(uint32_t eccBase) { // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1500); } } while((_Bool)0); // // Read the position bits and shift it to the right. // return(((*((volatile uint32_t *)(eccBase + 0x26U))) & (uint32_t)0xFCU) >> 2U); } //***************************************************************************** // //! Gets the single bit error type. //! //! \param eccBase is the base address of the flash wrapper ECC registers. //! //! \return Returns the single bit error type as a //! Flash_SingleBitErrorIndicator. FLASH_DATA_BITS and FLASH_CHECK_BITS //! indicate where the single bit error occurred. // //***************************************************************************** static inline Flash_SingleBitErrorIndicator Flash_getECCTestSingleBitErrorType(uint32_t eccBase) { uint32_t errorType; // // Check the arguments. // do { if(!(Flash_isECCBaseValid(eccBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1528); } } while((_Bool)0); // // Read the ERR_TYPE bit to see where the single bit error was. // errorType = (((*((volatile uint32_t *)(eccBase + 0x26U))) & (uint32_t)0x100U) >> 8U); return((Flash_SingleBitErrorIndicator)errorType); } //***************************************************************************** // //! Claim the flash pump semaphore. //! //! \param pumpSemBase is the base address of the flash pump semaphore. //! \param wrapper is the Flash_PumpOwnership wrapper claiming the pump //! semaphore. //! //! \return None. // //***************************************************************************** static inline void Flash_claimPumpSemaphore(uint32_t pumpSemBase, Flash_PumpOwnership wrapper) { // // Check the arguments. // do { if(!(Flash_isPumpSemBaseValid(pumpSemBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1555); } } while((_Bool)0); // // Block until the pump semaphore is claimed. // __eallow(); while(((*((volatile uint32_t *)(pumpSemBase + 0x0U))) & 0x3U) != wrapper) { (*((volatile uint32_t *)(pumpSemBase + 0x0U))) = 0x5A5A0000UL | (uint32_t)wrapper; } __edis(); } //***************************************************************************** // //! Release the flash pump semaphore. //! //! \param pumpSemBase is the base address of the flash pump semaphore. //! //! \return None. // //***************************************************************************** static inline void Flash_releasePumpSemaphore(uint32_t pumpSemBase) { // // Check the arguments. // do { if(!(Flash_isPumpSemBaseValid(pumpSemBase))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/flash.h", 1585); } } while((_Bool)0); // // Relinquish the pump semaphore. // __eallow(); (*((volatile uint32_t *)(pumpSemBase + 0x0U))) = 0x5A5A0000UL; __edis(); } //***************************************************************************** // //! Initializes the flash control registers. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! \param eccBase is the base address of the flash wrapper ECC registers. //! \param waitstates is the wait-state value. //! //! This function initializes the flash control registers. At reset bank and //! pump are in sleep. A flash access will power up the bank and pump //! automatically. This function will power up Flash bank and pump and set the //! fallback mode of flash and pump as active. //! //! This function also sets the number of wait-states for a flash access //! (see Flash_setWaitstates() for more details), and enables cache, the //! prefetch mechanism, and ECC. //! //! \return None. // //***************************************************************************** extern void Flash_initModule(uint32_t ctrlBase, uint32_t eccBase, uint16_t waitstates); //***************************************************************************** // //! Powers down the flash. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! This function powers down the flash bank(s) and the flash pump. //! //! Note: For this device, you must claim the flash pump semaphore before //! calling this function and powering down the pump. Afterwards, you may want //! to relinquish the flash pump. //! //! \return None. // //***************************************************************************** extern void Flash_powerDown(uint32_t ctrlBase); //***************************************************************************** // //! Wakes the flash from low power mode. //! //! \param ctrlBase is the base address of the flash wrapper control registers. //! //! This function will power up Flash bank and pump and set the //! fallback mode of flash and pump as active. //! //! \return None. // //***************************************************************************** extern void Flash_wakeFromLPM(uint32_t ctrlBase); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: gpio.h // // TITLE: C28x GPIO driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup gpio_api GPIO //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_gpio.h // // TITLE: Definitions for the GPIO registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the GPIO register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPACTRL register // //************************************************************************************************* // GPIO15 // GPIO23 // GPIO31 //************************************************************************************************* // // The following are defines for the bit fields in the GPAQSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAQSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPADIR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAPUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAODR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAGMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPAGMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPACSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPACSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPACSEL3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPACSEL4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPALOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPACR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBCTRL register // //************************************************************************************************* // GPIO39 // GPIO47 // GPIO55 // GPIO63 //************************************************************************************************* // // The following are defines for the bit fields in the GPBQSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBQSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBDIR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBPUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBODR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBAMSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBGMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBGMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBCSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBCSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBCSEL3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBCSEL4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCCTRL register // //************************************************************************************************* // GPIO71 // GPIO79 // GPIO87 // GPIO95 //************************************************************************************************* // // The following are defines for the bit fields in the GPCQSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCQSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCDIR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCPUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCODR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCGMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCGMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCCSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCCSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCCSEL3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCCSEL4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDCTRL register // //************************************************************************************************* // GPIO103 // GPIO111 // GPIO119 // GPIO127 //************************************************************************************************* // // The following are defines for the bit fields in the GPDQSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDQSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDDIR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDPUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDODR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDGMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDGMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDCSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDCSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDCSEL3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDCSEL4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPECTRL register // //************************************************************************************************* // GPIO135 // GPIO143 // GPIO151 // GPIO159 //************************************************************************************************* // // The following are defines for the bit fields in the GPEQSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEQSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEDIR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEPUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEODR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEGMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEGMUX2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPECSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPECSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPECSEL3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPECSEL4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPELOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPECR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFCTRL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFQSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFDIR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFPUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFODR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFGMUX1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFCSEL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFCSEL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFLOCK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPADAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPASET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPACLEAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPATOGGLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBDAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBCLEAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPBTOGGLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCDAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCCLEAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPCTOGGLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDDAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDCLEAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPDTOGGLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPEDAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPESET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPECLEAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPETOGGLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFDAT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFCLEAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GPFTOGGLE register // //************************************************************************************************* //########################################################################### // // FILE: hw_xint.h // // TITLE: Definitions for the XINT registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the XINT register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XINT1CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XINT2CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XINT3CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XINT4CR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XINT5CR register // //************************************************************************************************* //########################################################################### // // FILE: xbar.h // // TITLE: C28x X-BAR driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup xbar_api XBAR //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_clbxbar.h // // TITLE: Definitions for the XBAR registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the XBAR register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG0MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG0MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG1MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG1MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG2MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG2MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG3MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG3MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG4MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG4MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG5MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG5MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG6MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG6MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG7MUX0TO15CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG7MUX16TO31CFG register // //************************************************************************************************* // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR // CLB-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG0MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG1MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG2MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG3MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG4MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG5MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG6MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIG7MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIGOUTINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AUXSIGLOCK register // //************************************************************************************************* //########################################################################### // // FILE: hw_epwmxbar.h // // TITLE: Definitions for the XBAR registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the XBAR register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP4MUX0TO15CFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP4MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP5MUX0TO15CFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP5MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP7MUX0TO15CFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP7MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP8MUX0TO15CFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP8MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP9MUX0TO15CFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP9MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP10MUX0TO15CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP10MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP11MUX0TO15CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP11MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP12MUX0TO15CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP12MUX16TO31CFG register // //************************************************************************************************* // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR // EPWM-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the TRIP4MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP5MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP7MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP8MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP9MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP10MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP11MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIP12MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIPOUTINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRIPLOCK register // //************************************************************************************************* //########################################################################### // // FILE: hw_inputxbar.h // // TITLE: Definitions for the XBAR registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the XBAR register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INPUTSELECTLOCK register // //************************************************************************************************* //########################################################################### // // FILE: hw_outputxbar.h // // TITLE: Definitions for the XBAR registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the XBAR register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT1MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT1MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT2MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT2MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT3MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT3MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT4MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT4MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT5MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT5MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT6MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT6MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT7MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT7MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT8MUX0TO15CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT8MUX16TO31CFG register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT1MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT2MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT3MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT4MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT5MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT6MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT7MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUT8MUXENABLE register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUTLATCH register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUTLATCHCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUTLATCHFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUTLATCHENABLE register // //************************************************************************************************* // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR // OUTPUT-XBAR //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUTINV register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the OUTPUTLOCK register // //************************************************************************************************* //########################################################################### // // FILE: hw_xbar.h // // TITLE: Definitions for the XBAR registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the XBAR register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XBARFLG1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XBARFLG2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XBARFLG3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XBARCLR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XBARCLR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XBARCLR3 register // //************************************************************************************************* //***************************************************************************** // // Useful defines used within the driver functions. // Not intended for use by application code. // //***************************************************************************** //***************************************************************************** // // The following values define the muxes parameter for XBAR_enableEPWMMux(), // XBAR_enableOutputMux(), XBAR_disableEPWMMux(), and // XBAR_disableOutputMux(). // //***************************************************************************** //***************************************************************************** // //! The following values define the \e output parameter for //! XBAR_setOutputMuxConfig(), XBAR_enableOutputMux(), and //! XBAR_disableOutputMux(). // //***************************************************************************** typedef enum { XBAR_OUTPUT1 = 0, //!< OUTPUT1 of the Output X-BAR XBAR_OUTPUT2 = 2, //!< OUTPUT2 of the Output X-BAR XBAR_OUTPUT3 = 4, //!< OUTPUT3 of the Output X-BAR XBAR_OUTPUT4 = 6, //!< OUTPUT4 of the Output X-BAR XBAR_OUTPUT5 = 8, //!< OUTPUT5 of the Output X-BAR XBAR_OUTPUT6 = 10, //!< OUTPUT6 of the Output X-BAR XBAR_OUTPUT7 = 12, //!< OUTPUT7 of the Output X-BAR XBAR_OUTPUT8 = 14, //!< OUTPUT8 of the Output X-BAR } XBAR_OutputNum; //***************************************************************************** // //! The following values define the \e trip parameter for //! XBAR_setEPWMMuxConfig(), XBAR_invertEPWMSignal(), XBAR_enableEPWMMux(), //! and XBAR_disableEPWMMux(). // //***************************************************************************** typedef enum { XBAR_TRIP4 = 0, //!< TRIP4 of the ePWM X-BAR XBAR_TRIP5 = 2, //!< TRIP5 of the ePWM X-BAR XBAR_TRIP7 = 4, //!< TRIP7 of the ePWM X-BAR XBAR_TRIP8 = 6, //!< TRIP8 of the ePWM X-BAR XBAR_TRIP9 = 8, //!< TRIP9 of the ePWM X-BAR XBAR_TRIP10 = 10, //!< TRIP10 of the ePWM X-BAR XBAR_TRIP11 = 12, //!< TRIP11 of the ePWM X-BAR XBAR_TRIP12 = 14 //!< TRIP12 of the ePWM X-BAR } XBAR_TripNum; //***************************************************************************** // // The following values define the trip parameter for XBAR_setCLBMuxConfig(), // XBAR_enableCLBMux(), and XBAR_disableCLBMux(). // //***************************************************************************** typedef enum { XBAR_AUXSIG0 = 0, XBAR_AUXSIG1 = 2, XBAR_AUXSIG2 = 4, XBAR_AUXSIG3 = 6, XBAR_AUXSIG4 = 8, XBAR_AUXSIG5 = 10, XBAR_AUXSIG6 = 12, XBAR_AUXSIG7 = 14 } XBAR_AuxSigNum; //***************************************************************************** // //! The following values define the \e input parameter for XBAR_setInputPin(). // //***************************************************************************** typedef enum { XBAR_INPUT1, //!< ePWM[TZ1], ePWM[TRIP1], X-BARs XBAR_INPUT2, //!< ePWM[TZ2], ePWM[TRIP2], X-BARs XBAR_INPUT3, //!< ePWM[TZ3], ePWM[TRIP3], X-BARs XBAR_INPUT4, //!< ADC wrappers, X-BARs, XINT1 XBAR_INPUT5, //!< EXTSYNCIN1, X-BARs, XINT2 XBAR_INPUT6, //!< EXTSYNCIN2, ePWM[TRIP6], X-BARs, XINT3 XBAR_INPUT7, //!< eCAP1, X-BARs XBAR_INPUT8, //!< eCAP2, X-BARs XBAR_INPUT9, //!< eCAP3, X-BARs XBAR_INPUT10, //!< eCAP4, X-BARs XBAR_INPUT11, //!< eCAP5, X-BARs XBAR_INPUT12, //!< eCAP6, X-BARs XBAR_INPUT13, //!< XINT4, X-BARs XBAR_INPUT14 //!< XINT5, X-BARs } XBAR_InputNum; //***************************************************************************** // //! The following values define the \e muxConfig parameter for //! XBAR_setOutputMuxConfig(). // //***************************************************************************** typedef enum { // //OUTPUTXBAR // XBAR_OUT_MUX00_CMPSS1_CTRIPOUTH = 0x0000, XBAR_OUT_MUX00_CMPSS1_CTRIPOUTH_OR_L = 0x0001, XBAR_OUT_MUX00_ADCAEVT1 = 0x0002, XBAR_OUT_MUX00_ECAP1_OUT = 0x0003, XBAR_OUT_MUX01_CMPSS1_CTRIPOUTL = 0x0200, XBAR_OUT_MUX01_INPUTXBAR1 = 0x0201, XBAR_OUT_MUX01_CLB1_OUT4 = 0x0202, XBAR_OUT_MUX01_ADCCEVT1 = 0x0203, XBAR_OUT_MUX02_CMPSS2_CTRIPOUTH = 0x0400, XBAR_OUT_MUX02_CMPSS2_CTRIPOUTH_OR_L = 0x0401, XBAR_OUT_MUX02_ADCAEVT2 = 0x0402, XBAR_OUT_MUX02_ECAP2_OUT = 0x0403, XBAR_OUT_MUX03_CMPSS2_CTRIPOUTL = 0x0600, XBAR_OUT_MUX03_INPUTXBAR2 = 0x0601, XBAR_OUT_MUX03_CLB1_OUT5 = 0x0602, XBAR_OUT_MUX03_ADCCEVT2 = 0x0603, XBAR_OUT_MUX04_CMPSS3_CTRIPOUTH = 0x0800, XBAR_OUT_MUX04_CMPSS3_CTRIPOUTH_OR_L = 0x0801, XBAR_OUT_MUX04_ADCAEVT3 = 0x0802, XBAR_OUT_MUX04_ECAP3_OUT = 0x0803, XBAR_OUT_MUX05_CMPSS3_CTRIPOUTL = 0x0A00, XBAR_OUT_MUX05_INPUTXBAR3 = 0x0A01, XBAR_OUT_MUX05_CLB2_OUT4 = 0x0A02, XBAR_OUT_MUX05_ADCCEVT3 = 0x0A03, XBAR_OUT_MUX06_CMPSS4_CTRIPOUTH = 0x0C00, XBAR_OUT_MUX06_CMPSS4_CTRIPOUTH_OR_L = 0x0C01, XBAR_OUT_MUX06_ADCAEVT4 = 0x0C02, XBAR_OUT_MUX06_ECAP4_OUT = 0x0C03, XBAR_OUT_MUX07_CMPSS4_CTRIPOUTL = 0x0E00, XBAR_OUT_MUX07_INPUTXBAR4 = 0x0E01, XBAR_OUT_MUX07_CLB2_OUT5 = 0x0E02, XBAR_OUT_MUX07_ADCCEVT4 = 0x0E03, XBAR_OUT_MUX08_CMPSS5_CTRIPOUTH = 0x1000, XBAR_OUT_MUX08_CMPSS5_CTRIPOUTH_OR_L = 0x1001, XBAR_OUT_MUX08_ADCBEVT1 = 0x1002, XBAR_OUT_MUX08_ECAP5_OUT = 0x1003, XBAR_OUT_MUX09_CMPSS5_CTRIPOUTL = 0x1200, XBAR_OUT_MUX09_INPUTXBAR5 = 0x1201, XBAR_OUT_MUX09_CLB3_OUT4 = 0x1202, XBAR_OUT_MUX09_ADCDEVT1 = 0x1203, XBAR_OUT_MUX10_CMPSS6_CTRIPOUTH = 0x1400, XBAR_OUT_MUX10_CMPSS6_CTRIPOUTH_OR_L = 0x1401, XBAR_OUT_MUX10_ADCBEVT2 = 0x1402, XBAR_OUT_MUX10_ECAP6_OUT = 0x1403, XBAR_OUT_MUX11_CMPSS6_CTRIPOUTL = 0x1600, XBAR_OUT_MUX11_INPUTXBAR6 = 0x1601, XBAR_OUT_MUX11_CLB3_OUT5 = 0x1602, XBAR_OUT_MUX11_ADCDEVT2 = 0x1603, XBAR_OUT_MUX12_CMPSS7_CTRIPOUTH = 0x1800, XBAR_OUT_MUX12_CMPSS7_CTRIPOUTH_OR_L = 0x1801, XBAR_OUT_MUX12_ADCBEVT3 = 0x1802, XBAR_OUT_MUX13_CMPSS7_CTRIPOUTL = 0x1A00, XBAR_OUT_MUX13_ADCSOCA = 0x1A01, XBAR_OUT_MUX13_CLB4_OUT4 = 0x1A02, XBAR_OUT_MUX13_ADCDEVT3 = 0x1A03, XBAR_OUT_MUX14_CMPSS8_CTRIPOUTH = 0x1C00, XBAR_OUT_MUX14_CMPSS8_CTRIPOUTH_OR_L = 0x1C01, XBAR_OUT_MUX14_ADCBEVT4 = 0x1C02, XBAR_OUT_MUX14_EXTSYNCOUT = 0x1C03, XBAR_OUT_MUX15_CMPSS8_CTRIPOUTL = 0x1E00, XBAR_OUT_MUX15_ADCSOCB = 0x1E01, XBAR_OUT_MUX15_CLB4_OUT5 = 0x1E02, XBAR_OUT_MUX15_ADCDEVT4 = 0x1E03, XBAR_OUT_MUX16_SD1FLT1_COMPH = 0x2000, XBAR_OUT_MUX16_SD1FLT1_COMPH_OR_COMPL = 0x2001, XBAR_OUT_MUX17_SD1FLT1_COMPL = 0x2200, XBAR_OUT_MUX18_SD1FLT2_COMPH = 0x2400, XBAR_OUT_MUX18_SD1FLT2_COMPH_OR_COMPL = 0x2401, XBAR_OUT_MUX19_SD1FLT2_COMPL = 0x2600, XBAR_OUT_MUX20_SD1FLT3_COMPH = 0x2800, XBAR_OUT_MUX20_SD1FLT3_COMPH_OR_COMPL = 0x2801, XBAR_OUT_MUX21_SD1FLT3_COMPL = 0x2A00, XBAR_OUT_MUX22_SD1FLT4_COMPH = 0x2C00, XBAR_OUT_MUX22_SD1FLT4_COMPH_OR_COMPL = 0x2C01, XBAR_OUT_MUX23_SD1FLT4_COMPL = 0x2E00, XBAR_OUT_MUX24_SD2FLT1_COMPH = 0x3000, XBAR_OUT_MUX24_SD2FLT1_COMPH_OR_COMPL = 0x3001, XBAR_OUT_MUX25_SD2FLT1_COMPL = 0x3200, XBAR_OUT_MUX26_SD2FLT2_COMPH = 0x3400, XBAR_OUT_MUX26_SD2FLT2_COMPH_OR_COMPL = 0x3401, XBAR_OUT_MUX27_SD2FLT2_COMPL = 0x3600, XBAR_OUT_MUX28_SD2FLT3_COMPH = 0x3800, XBAR_OUT_MUX28_SD2FLT3_COMPH_OR_COMPL = 0x3801, XBAR_OUT_MUX29_SD2FLT3_COMPL = 0x3A00, XBAR_OUT_MUX30_SD2FLT4_COMPH = 0x3C00, XBAR_OUT_MUX30_SD2FLT4_COMPH_OR_COMPL = 0x3C01, XBAR_OUT_MUX31_SD2FLT4_COMPL = 0x3E00, } XBAR_OutputMuxConfig; //***************************************************************************** // //! The following values define the \e muxConfig parameter for //! XBAR_setEPWMMuxConfig(). // //***************************************************************************** typedef enum { XBAR_EPWM_MUX00_CMPSS1_CTRIPH = 0x0000, XBAR_EPWM_MUX00_CMPSS1_CTRIPH_OR_L = 0x0001, XBAR_EPWM_MUX00_ADCAEVT1 = 0x0002, XBAR_EPWM_MUX00_ECAP1_OUT = 0x0003, XBAR_EPWM_MUX01_CMPSS1_CTRIPL = 0x0200, XBAR_EPWM_MUX01_INPUTXBAR1 = 0x0201, XBAR_EPWM_MUX01_CLB1_OUT4 = 0x0202, XBAR_EPWM_MUX01_ADCCEVT1 = 0x0203, XBAR_EPWM_MUX02_CMPSS2_CTRIPH = 0x0400, XBAR_EPWM_MUX02_CMPSS2_CTRIPH_OR_L = 0x0401, XBAR_EPWM_MUX02_ADCAEVT2 = 0x0402, XBAR_EPWM_MUX02_ECAP2_OUT = 0x0403, XBAR_EPWM_MUX03_CMPSS2_CTRIPL = 0x0600, XBAR_EPWM_MUX03_INPUTXBAR2 = 0x0601, XBAR_EPWM_MUX03_CLB1_OUT5 = 0x0602, XBAR_EPWM_MUX03_ADCCEVT2 = 0x0603, XBAR_EPWM_MUX04_CMPSS3_CTRIPH = 0x0800, XBAR_EPWM_MUX04_CMPSS3_CTRIPH_OR_L = 0x0801, XBAR_EPWM_MUX04_ADCAEVT3 = 0x0802, XBAR_EPWM_MUX04_ECAP3_OUT = 0x0803, XBAR_EPWM_MUX05_CMPSS3_CTRIPL = 0x0A00, XBAR_EPWM_MUX05_INPUTXBAR3 = 0x0A01, XBAR_EPWM_MUX05_CLB2_OUT4 = 0x0A02, XBAR_EPWM_MUX05_ADCCEVT3 = 0x0A03, XBAR_EPWM_MUX06_CMPSS4_CTRIPH = 0x0C00, XBAR_EPWM_MUX06_CMPSS4_CTRIPH_OR_L = 0x0C01, XBAR_EPWM_MUX06_ADCAEVT4 = 0x0C02, XBAR_EPWM_MUX06_ECAP4_OUT = 0x0C03, XBAR_EPWM_MUX07_CMPSS4_CTRIPL = 0x0E00, XBAR_EPWM_MUX07_INPUTXBAR4 = 0x0E01, XBAR_EPWM_MUX07_CLB2_OUT5 = 0x0E02, XBAR_EPWM_MUX07_ADCCEVT4 = 0x0E03, XBAR_EPWM_MUX08_CMPSS5_CTRIPH = 0x1000, XBAR_EPWM_MUX08_CMPSS5_CTRIPH_OR_L = 0x1001, XBAR_EPWM_MUX08_ADCBEVT1 = 0x1002, XBAR_EPWM_MUX08_ECAP5_OUT = 0x1003, XBAR_EPWM_MUX09_CMPSS5_CTRIPL = 0x1200, XBAR_EPWM_MUX09_INPUTXBAR5 = 0x1201, XBAR_EPWM_MUX09_CLB3_OUT4 = 0x1202, XBAR_EPWM_MUX09_ADCDEVT1 = 0x1203, XBAR_EPWM_MUX10_CMPSS6_CTRIPH = 0x1400, XBAR_EPWM_MUX10_CMPSS6_CTRIPH_OR_L = 0x1401, XBAR_EPWM_MUX10_ADCBEVT2 = 0x1402, XBAR_EPWM_MUX10_ECAP6_OUT = 0x1403, XBAR_EPWM_MUX11_CMPSS6_CTRIPL = 0x1600, XBAR_EPWM_MUX11_INPUTXBAR6 = 0x1601, XBAR_EPWM_MUX11_CLB3_OUT5 = 0x1602, XBAR_EPWM_MUX11_ADCDEVT2 = 0x1603, XBAR_EPWM_MUX12_CMPSS7_CTRIPH = 0x1800, XBAR_EPWM_MUX12_CMPSS7_CTRIPH_OR_L = 0x1801, XBAR_EPWM_MUX12_ADCBEVT3 = 0x1802, XBAR_EPWM_MUX13_CMPSS7_CTRIPL = 0x1A00, XBAR_EPWM_MUX13_ADCSOCA = 0x1A01, XBAR_EPWM_MUX13_CLB4_OUT4 = 0x1A02, XBAR_EPWM_MUX13_ADCDEVT3 = 0x1A03, XBAR_EPWM_MUX14_CMPSS8_CTRIPH = 0x1C00, XBAR_EPWM_MUX14_CMPSS8_CTRIPH_OR_L = 0x1C01, XBAR_EPWM_MUX14_ADCBEVT4 = 0x1C02, XBAR_EPWM_MUX14_EXTSYNCOUT = 0x1C03, XBAR_EPWM_MUX15_CMPSS8_CTRIPL = 0x1E00, XBAR_EPWM_MUX15_ADCSOCB = 0x1E01, XBAR_EPWM_MUX15_CLB4_OUT5 = 0x1E02, XBAR_EPWM_MUX15_ADCDEVT4 = 0x1E03, XBAR_EPWM_MUX16_SD1FLT1_COMPH = 0x2000, XBAR_EPWM_MUX16_SD1FLT1_COMPH_OR_COMPL = 0x2001, XBAR_EPWM_MUX17_SD1FLT1_COMPL = 0x2200, XBAR_EPWM_MUX18_SD1FLT2_COMPH = 0x2400, XBAR_EPWM_MUX18_SD1FLT2_COMPH_OR_COMPL = 0x2401, XBAR_EPWM_MUX19_SD1FLT2_COMPL = 0x2600, XBAR_EPWM_MUX20_SD1FLT3_COMPH = 0x2800, XBAR_EPWM_MUX20_SD1FLT3_COMPH_OR_COMPL = 0x2801, XBAR_EPWM_MUX21_SD1FLT3_COMPL = 0x2A00, XBAR_EPWM_MUX22_SD1FLT4_COMPH = 0x2C00, XBAR_EPWM_MUX22_SD1FLT4_COMPH_OR_COMPL = 0x2C01, XBAR_EPWM_MUX23_SD1FLT4_COMPL = 0x2E00, XBAR_EPWM_MUX24_SD2FLT1_COMPH = 0x3000, XBAR_EPWM_MUX24_SD2FLT1_COMPH_OR_COMPL = 0x3001, XBAR_EPWM_MUX25_SD2FLT1_COMPL = 0x3200, XBAR_EPWM_MUX26_SD2FLT2_COMPH = 0x3400, XBAR_EPWM_MUX26_SD2FLT2_COMPH_OR_COMPL = 0x3401, XBAR_EPWM_MUX27_SD2FLT2_COMPL = 0x3600, XBAR_EPWM_MUX28_SD2FLT3_COMPH = 0x3800, XBAR_EPWM_MUX28_SD2FLT3_COMPH_OR_COMPL = 0x3801, XBAR_EPWM_MUX29_SD2FLT3_COMPL = 0x3A00, XBAR_EPWM_MUX30_SD2FLT4_COMPH = 0x3C00, XBAR_EPWM_MUX30_SD2FLT4_COMPH_OR_COMPL = 0x3C01, XBAR_EPWM_MUX31_SD2FLT4_COMPL = 0x3E00 } XBAR_EPWMMuxConfig; //***************************************************************************** // // The following values define the muxConfig parameter for // XBAR_setCLBMuxConfig(). // //***************************************************************************** typedef enum { XBAR_CLB_MUX00_CMPSS1_CTRIPH = 0x0000, XBAR_CLB_MUX00_CMPSS1_CTRIPH_OR_L = 0x0001, XBAR_CLB_MUX00_ADCAEVT1 = 0x0002, XBAR_CLB_MUX00_ECAP1_OUT = 0x0003, XBAR_CLB_MUX01_CMPSS1_CTRIPL = 0x0200, XBAR_CLB_MUX01_INPUTXBAR1 = 0x0201, XBAR_CLB_MUX01_CLB1_OUT4 = 0x0202, XBAR_CLB_MUX01_ADCCEVT1 = 0x0203, XBAR_CLB_MUX02_CMPSS2_CTRIPH = 0x0400, XBAR_CLB_MUX02_CMPSS2_CTRIPH_OR_L = 0x0401, XBAR_CLB_MUX02_ADCAEVT2 = 0x0402, XBAR_CLB_MUX02_ECAP2_OUT = 0x0403, XBAR_CLB_MUX03_CMPSS2_CTRIPL = 0x0600, XBAR_CLB_MUX03_INPUTXBAR2 = 0x0601, XBAR_CLB_MUX03_CLB1_OUT5 = 0x0602, XBAR_CLB_MUX03_ADCCEVT2 = 0x0603, XBAR_CLB_MUX04_CMPSS3_CTRIPH = 0x0800, XBAR_CLB_MUX04_CMPSS3_CTRIPH_OR_L = 0x0801, XBAR_CLB_MUX04_ADCAEVT3 = 0x0802, XBAR_CLB_MUX04_ECAP3_OUT = 0x0803, XBAR_CLB_MUX05_CMPSS3_CTRIPL = 0x0A00, XBAR_CLB_MUX05_INPUTXBAR3 = 0x0A01, XBAR_CLB_MUX05_CLB2_OUT4 = 0x0A02, XBAR_CLB_MUX05_ADCCEVT3 = 0x0A03, XBAR_CLB_MUX06_CMPSS4_CTRIPH = 0x0C00, XBAR_CLB_MUX06_CMPSS4_CTRIPH_OR_L = 0x0C01, XBAR_CLB_MUX06_ADCAEVT4 = 0x0C02, XBAR_CLB_MUX06_ECAP4_OUT = 0x0C03, XBAR_CLB_MUX07_CMPSS4_CTRIPL = 0x0E00, XBAR_CLB_MUX07_INPUTXBAR4 = 0x0E01, XBAR_CLB_MUX07_CLB2_OUT5 = 0x0E02, XBAR_CLB_MUX07_ADCCEVT4 = 0x0E03, XBAR_CLB_MUX08_CMPSS5_CTRIPH = 0x1000, XBAR_CLB_MUX08_CMPSS5_CTRIPH_OR_L = 0x1001, XBAR_CLB_MUX08_ADCBEVT1 = 0x1002, XBAR_CLB_MUX08_ECAP5_OUT = 0x1003, XBAR_CLB_MUX09_CMPSS5_CTRIPL = 0x1200, XBAR_CLB_MUX09_INPUTXBAR5 = 0x1201, XBAR_CLB_MUX09_CLB3_OUT4 = 0x1202, XBAR_CLB_MUX09_ADCDEVT1 = 0x1203, XBAR_CLB_MUX10_CMPSS6_CTRIPH = 0x1400, XBAR_CLB_MUX10_CMPSS6_CTRIPH_OR_L = 0x1401, XBAR_CLB_MUX10_ADCBEVT2 = 0x1402, XBAR_CLB_MUX10_ECAP6_OUT = 0x1403, XBAR_CLB_MUX11_CMPSS6_CTRIPL = 0x1600, XBAR_CLB_MUX11_INPUTXBAR6 = 0x1601, XBAR_CLB_MUX11_CLB3_OUT5 = 0x1602, XBAR_CLB_MUX11_ADCDEVT2 = 0x1603, XBAR_CLB_MUX12_CMPSS7_CTRIPH = 0x1800, XBAR_CLB_MUX12_CMPSS7_CTRIPH_OR_L = 0x1801, XBAR_CLB_MUX12_ADCBEVT3 = 0x1802, XBAR_CLB_MUX13_CMPSS7_CTRIPL = 0x1A00, XBAR_CLB_MUX13_ADCSOCA = 0x1A01, XBAR_CLB_MUX13_CLB4_OUT4 = 0x1A02, XBAR_CLB_MUX13_ADCDEVT3 = 0x1A03, XBAR_CLB_MUX14_CMPSS8_CTRIPH = 0x1C00, XBAR_CLB_MUX14_CMPSS8_CTRIPH_OR_L = 0x1C01, XBAR_CLB_MUX14_ADCBEVT4 = 0x1C02, XBAR_CLB_MUX14_EXTSYNCOUT = 0x1C03, XBAR_CLB_MUX15_CMPSS8_CTRIPL = 0x1E00, XBAR_CLB_MUX15_ADCSOCB = 0x1E01, XBAR_CLB_MUX15_CLB4_OUT5 = 0x1E02, XBAR_CLB_MUX15_ADCDEVT4 = 0x1E03, XBAR_CLB_MUX16_SD1FLT1_COMPH = 0x2000, XBAR_CLB_MUX16_SD1FLT1_COMPH_OR_COMPL = 0x2001, XBAR_CLB_MUX17_SD1FLT1_COMPL = 0x2200, XBAR_CLB_MUX18_SD1FLT2_COMPH = 0x2400, XBAR_CLB_MUX18_SD1FLT2_COMPH_OR_COMPL = 0x2401, XBAR_CLB_MUX19_SD1FLT2_COMPL = 0x2600, XBAR_CLB_MUX20_SD1FLT3_COMPH = 0x2800, XBAR_CLB_MUX20_SD1FLT3_COMPH_OR_COMPL = 0x2801, XBAR_CLB_MUX21_SD1FLT3_COMPL = 0x2A00, XBAR_CLB_MUX22_SD1FLT4_COMPH = 0x2C00, XBAR_CLB_MUX22_SD1FLT4_COMPH_OR_COMPL = 0x2C01, XBAR_CLB_MUX23_SD1FLT4_COMPL = 0x2E00, XBAR_CLB_MUX24_SD2FLT1_COMPH = 0x3000, XBAR_CLB_MUX24_SD2FLT1_COMPH_OR_COMPL = 0x3001, XBAR_CLB_MUX25_SD2FLT1_COMPL = 0x3200, XBAR_CLB_MUX26_SD2FLT2_COMPH = 0x3400, XBAR_CLB_MUX26_SD2FLT2_COMPH_OR_COMPL = 0x3401, XBAR_CLB_MUX27_SD2FLT2_COMPL = 0x3600, XBAR_CLB_MUX28_SD2FLT3_COMPH = 0x3800, XBAR_CLB_MUX28_SD2FLT3_COMPH_OR_COMPL = 0x3801, XBAR_CLB_MUX29_SD2FLT3_COMPL = 0x3A00, XBAR_CLB_MUX30_SD2FLT4_COMPH = 0x3C00, XBAR_CLB_MUX30_SD2FLT4_COMPH_OR_COMPL = 0x3C01, XBAR_CLB_MUX31_SD2FLT4_COMPL = 0x3E00, } XBAR_CLBMuxConfig; //***************************************************************************** // //! The following values define the \e inputFlag parameter for //! XBAR_getInputFlagStatus() and XBAR_clearInputFlag(). // //***************************************************************************** typedef enum { // // XBARFLG1 // XBAR_INPUT_FLG_CMPSS1_CTRIPL = 0x0000, XBAR_INPUT_FLG_CMPSS1_CTRIPH = 0x0001, XBAR_INPUT_FLG_CMPSS2_CTRIPL = 0x0002, XBAR_INPUT_FLG_CMPSS2_CTRIPH = 0x0003, XBAR_INPUT_FLG_CMPSS3_CTRIPL = 0x0004, XBAR_INPUT_FLG_CMPSS3_CTRIPH = 0x0005, XBAR_INPUT_FLG_CMPSS4_CTRIPL = 0x0006, XBAR_INPUT_FLG_CMPSS4_CTRIPH = 0x0007, XBAR_INPUT_FLG_CMPSS5_CTRIPL = 0x0008, XBAR_INPUT_FLG_CMPSS5_CTRIPH = 0x0009, XBAR_INPUT_FLG_CMPSS6_CTRIPL = 0x000A, XBAR_INPUT_FLG_CMPSS6_CTRIPH = 0x000B, XBAR_INPUT_FLG_CMPSS7_CTRIPL = 0x000C, XBAR_INPUT_FLG_CMPSS7_CTRIPH = 0x000D, XBAR_INPUT_FLG_CMPSS8_CTRIPL = 0x000E, XBAR_INPUT_FLG_CMPSS8_CTRIPH = 0x000F, XBAR_INPUT_FLG_CMPSS1_CTRIPOUTL = 0x0010, XBAR_INPUT_FLG_CMPSS1_CTRIPOUTH = 0x0011, XBAR_INPUT_FLG_CMPSS2_CTRIPOUTL = 0x0012, XBAR_INPUT_FLG_CMPSS2_CTRIPOUTH = 0x0013, XBAR_INPUT_FLG_CMPSS3_CTRIPOUTL = 0x0014, XBAR_INPUT_FLG_CMPSS3_CTRIPOUTH = 0x0015, XBAR_INPUT_FLG_CMPSS4_CTRIPOUTL = 0x0016, XBAR_INPUT_FLG_CMPSS4_CTRIPOUTH = 0x0017, XBAR_INPUT_FLG_CMPSS5_CTRIPOUTL = 0x0018, XBAR_INPUT_FLG_CMPSS5_CTRIPOUTH = 0x0019, XBAR_INPUT_FLG_CMPSS6_CTRIPOUTL = 0x001A, XBAR_INPUT_FLG_CMPSS6_CTRIPOUTH = 0x001B, XBAR_INPUT_FLG_CMPSS7_CTRIPOUTL = 0x001C, XBAR_INPUT_FLG_CMPSS7_CTRIPOUTH = 0x001D, XBAR_INPUT_FLG_CMPSS8_CTRIPOUTL = 0x001E, XBAR_INPUT_FLG_CMPSS8_CTRIPOUTH = 0x001F, // // XBARFLG2 // XBAR_INPUT_FLG_INPUT1 = 0x0100, XBAR_INPUT_FLG_INPUT2 = 0x0101, XBAR_INPUT_FLG_INPUT3 = 0x0102, XBAR_INPUT_FLG_INPUT4 = 0x0103, XBAR_INPUT_FLG_INPUT5 = 0x0104, XBAR_INPUT_FLG_INPUT6 = 0x0105, XBAR_INPUT_FLG_ADCSOCA = 0x0106, XBAR_INPUT_FLG_ADCSOCB = 0x0107, XBAR_INPUT_FLG_CLB1_OUT4 = 0x0108, XBAR_INPUT_FLG_CLB1_OUT5 = 0x0109, XBAR_INPUT_FLG_CLB2_OUT4 = 0x010A, XBAR_INPUT_FLG_CLB2_OUT5 = 0x010B, XBAR_INPUT_FLG_CLB3_OUT4 = 0x010C, XBAR_INPUT_FLG_CLB3_OUT5 = 0x010D, XBAR_INPUT_FLG_CLB4_OUT4 = 0x010E, XBAR_INPUT_FLG_CLB4_OUT5 = 0x010F, XBAR_INPUT_FLG_ECAP1_OUT = 0x0110, XBAR_INPUT_FLG_ECAP2_OUT = 0x0111, XBAR_INPUT_FLG_ECAP3_OUT = 0x0112, XBAR_INPUT_FLG_ECAP4_OUT = 0x0113, XBAR_INPUT_FLG_ECAP5_OUT = 0x0114, XBAR_INPUT_FLG_ECAP6_OUT = 0x0115, XBAR_INPUT_FLG_EXTSYNCOUT = 0x0116, XBAR_INPUT_FLG_ADCAEVT1 = 0x0117, XBAR_INPUT_FLG_ADCAEVT2 = 0x0118, XBAR_INPUT_FLG_ADCAEVT3 = 0x0119, XBAR_INPUT_FLG_ADCAEVT4 = 0x011A, XBAR_INPUT_FLG_ADCBEVT1 = 0x011B, XBAR_INPUT_FLG_ADCBEVT2 = 0x011C, XBAR_INPUT_FLG_ADCBEVT3 = 0x011D, XBAR_INPUT_FLG_ADCBEVT4 = 0x011E, XBAR_INPUT_FLG_ADCCEVT1 = 0x011F, // // XBARFLG3 // XBAR_INPUT_FLG_ADCCEVT2 = 0x0200, XBAR_INPUT_FLG_ADCCEVT3 = 0x0201, XBAR_INPUT_FLG_ADCCEVT4 = 0x0202, XBAR_INPUT_FLG_ADCDEVT1 = 0x0203, XBAR_INPUT_FLG_ADCDEVT2 = 0x0204, XBAR_INPUT_FLG_ADCDEVT3 = 0x0205, XBAR_INPUT_FLG_ADCDEVT4 = 0x0206, XBAR_INPUT_FLG_SD1FLT1_COMPL = 0x0207, XBAR_INPUT_FLG_SD1FLT1_COMPH = 0x0208, XBAR_INPUT_FLG_SD1FLT2_COMPL = 0x0209, XBAR_INPUT_FLG_SD1FLT2_COMPH = 0x020A, XBAR_INPUT_FLG_SD1FLT3_COMPL = 0x020B, XBAR_INPUT_FLG_SD1FLT3_COMPH = 0x020C, XBAR_INPUT_FLG_SD1FLT4_COMPL = 0x020D, XBAR_INPUT_FLG_SD1FLT4_COMPH = 0x020E, XBAR_INPUT_FLG_SD2FLT1_COMPL = 0x020F, XBAR_INPUT_FLG_SD2FLT1_COMPH = 0x0210, XBAR_INPUT_FLG_SD2FLT2_COMPL = 0x0211, XBAR_INPUT_FLG_SD2FLT2_COMPH = 0x0212, XBAR_INPUT_FLG_SD2FLT3_COMPL = 0x0213, XBAR_INPUT_FLG_SD2FLT3_COMPH = 0x0214, XBAR_INPUT_FLG_SD2FLT4_COMPL = 0x0215, XBAR_INPUT_FLG_SD2FLT4_COMPH = 0x0216 } XBAR_InputFlag; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! Enables the Output X-BAR mux values to be passed to the output signal. //! //! \param output is the X-BAR output being configured. //! \param muxes is a bit field of the muxes to be enabled. //! //! This function enables the mux values to be passed to the X-BAR output //! signal. The \e output parameter is a value \b XBAR_OUTPUTy where y is //! the output number between 1 and 8 inclusive. //! //! The \e muxes parameter is a bit field of the muxes being enabled where bit //! 0 represents mux 0, bit 1 represents mux 1 and so on. Defines are provided //! in the form of \b XBAR_MUXnn that can be OR'd together to enable several //! muxes on an output at the same time. For example, passing this function //! ( \b XBAR_MUX04 | \b XBAR_MUX10 ) would enable muxes 4 and 10. //! //! \return None. // //***************************************************************************** static inline void XBAR_enableOutputMux(XBAR_OutputNum output, uint32_t muxes) { // // Set the enable bit. // __eallow(); (*((volatile uint32_t *)((0x00007A80U + 0x20U) + (uint16_t)output))) |= muxes; __edis(); } //***************************************************************************** // //! Disables the Output X-BAR mux values from being passed to the output. //! //! \param output is the X-BAR output being configured. //! \param muxes is a bit field of the muxes to be disabled. //! //! This function disables the mux values from being passed to the X-BAR output //! signal. The \e output parameter is a value \b XBAR_OUTPUTy where y is //! the output number between 1 and 8 inclusive. //! //! The \e muxes parameter is a bit field of the muxes being disabled where bit //! 0 represents mux 0, bit 1 represents mux 1 and so on. Defines are provided //! in the form of \b XBAR_MUXnn that can be OR'd together to disable several //! muxes on an output at the same time. For example, passing this function //! ( \b XBAR_MUX04 | \b XBAR_MUX10 ) would disable muxes 4 and 10. //! //! \return None. // //***************************************************************************** static inline void XBAR_disableOutputMux(XBAR_OutputNum output, uint32_t muxes) { // // Clear the enable bit. // __eallow(); (*((volatile uint32_t *)((0x00007A80U + 0x20U) + (uint16_t)output))) &= ~(muxes); __edis(); } //***************************************************************************** // //! Enables or disables the output latch to drive the selected output. //! //! \param output is the X-BAR output being configured. //! The valid inputs are XBAR_OUTPUTy where y is from 1 to 8. //! \param enable is a flag that determines whether or not the latch is //! selected to drive the X-BAR output. //! //! This function sets the Output X-BAR output signal latch mode. If the //! \e enable parameter is \b true, the output specified by \e output will be //! driven by the output latch. //! //! \return None. // //***************************************************************************** static inline void XBAR_setOutputLatchMode(XBAR_OutputNum output, _Bool enable) { __eallow(); // // Set or clear the latch setting bit based on the enable parameter. // if(enable) { (*((volatile uint16_t *)(0x00007A80U + 0x36U))) |= 0x1U << ((uint16_t)output / 2U); } else { (*((volatile uint16_t *)(0x00007A80U + 0x36U))) &= ~(0x1U << ((uint16_t)output / 2U)); } __edis(); } //***************************************************************************** // //! Returns the status of the output latch //! //! \param output is the X-BAR output being checked. //! The valid inputs are XBAR_OUTPUTy where y is from 1 to 8. //! //! \return Returns \b true if the output corresponding to \e output was //! triggered. If not, it will return \b false. // //***************************************************************************** static inline _Bool XBAR_getOutputLatchStatus(XBAR_OutputNum output) { // // Get the status of the Output X-BAR output latch. // return(((*((volatile uint16_t *)(0x00007A80U + 0x30U))) & (0x1U << ((uint16_t)output / 2U))) != 0U); } //***************************************************************************** // //! Clears the output latch for the specified output. //! //! \param output is the X-BAR output being configured. //! The valid inputs are XBAR_OUTPUTy where y is from 1 to 8. //! //! This function clears the Output X-BAR output latch. The output to be //! configured is specified by the \e output parameter. //! //! \return None. // //***************************************************************************** static inline void XBAR_clearOutputLatch(XBAR_OutputNum output) { // // Set the bit that clears the corresponding OUTPUTLATCH bit. // (*((volatile uint16_t *)(0x00007A80U + 0x32U))) |= 0x1U << ((uint16_t)output / 2U); } //***************************************************************************** // //! Forces the output latch for the specified output. //! //! \param output is the X-BAR output being configured. //! The valid inputs are XBAR_OUTPUTy where y is from 1 to 8. //! //! This function forces the Output X-BAR output latch. The output to be //! configured is specified by the \e output parameter. //! //! \return None. // //***************************************************************************** static inline void XBAR_forceOutputLatch(XBAR_OutputNum output) { // // Set the bit that forces the corresponding OUTPUTLATCH bit. // (*((volatile uint16_t *)(0x00007A80U + 0x34U))) = (uint16_t)0x1U << ((uint16_t)output / 2U); } //***************************************************************************** // //! Configures the polarity of an Output X-BAR output. //! //! \param output is the X-BAR output being configured. //! The valid inputs are XBAR_OUTPUTy where y is from 1 to 8. //! \param invert is a flag that determines whether the output is active-high //! or active-low. //! //! This function inverts the Output X-BAR signal if the \e invert parameter is //! \b true. If \e invert is \b false, the signal will be passed as is. The //! \e output parameter is a value \b XBAR_OUTPUTy where y is the output //! number between 1 and 8 inclusive. //! //! \return None. // //***************************************************************************** static inline void XBAR_invertOutputSignal(XBAR_OutputNum output, _Bool invert) { // // Set or clear the polarity setting bit based on the invert parameter. // __eallow(); if(invert) { (*((volatile uint16_t *)(0x00007A80U + 0x38U))) |= 0x1U << ((uint16_t)output / 2U); } else { (*((volatile uint16_t *)(0x00007A80U + 0x38U))) &= ~(0x1U << ((uint16_t)output / 2U)); } __edis(); } //***************************************************************************** // //! Enables the ePWM X-BAR mux values to be passed to an ePWM module. //! //! \param trip is the X-BAR output being configured. //! \param muxes is a bit field of the muxes to be enabled. //! //! This function enables the mux values to be passed to the X-BAR trip //! signal. The \e trip parameter is a value \b XBAR_TRIPy where y is //! the number of the trip signal on the ePWM. //! //! The \e muxes parameter is a bit field of the muxes being enabled where bit //! 0 represents mux 0, bit 1 represents mux 1 and so on. Defines are provided //! in the form of \b XBAR_MUXnn that can be logically OR'd together to //! enable several muxes on an output at the same time. //! //! \return None. // //***************************************************************************** static inline void XBAR_enableEPWMMux(XBAR_TripNum trip, uint32_t muxes) { // // Set the enable bit. // __eallow(); (*((volatile uint32_t *)((0x00007A00U + 0x20U) + (uint32_t)trip))) |= muxes; __edis(); } //***************************************************************************** // //! Disables the ePWM X-BAR mux values to be passed to an ePWM module. //! //! \param trip is the X-BAR output being configured. //! \param muxes is a bit field of the muxes to be disabled. //! //! This function disables the mux values to be passed to the X-BAR trip //! signal. The \e trip parameter is a value \b XBAR_TRIPy where y is //! the number of the trip signal on the ePWM. //! //! The \e muxes parameter is a bit field of the muxes being disabled where bit //! 0 represents mux 0, bit 1 represents mux 1 and so on. Defines are provided //! in the form of \b XBAR_MUXnn that can be logically OR'd together to //! disable several muxes on an output at the same time. //! //! \return None. // //***************************************************************************** static inline void XBAR_disableEPWMMux(XBAR_TripNum trip, uint32_t muxes) { // // Clear the enable bit. // __eallow(); (*((volatile uint32_t *)((0x00007A00U + 0x20U) + (uint32_t)trip))) &= ~(muxes); __edis(); } //***************************************************************************** // //! Configures the polarity of an ePWM X-BAR output. //! //! \param trip is the X-BAR output being configured. //! \param invert is a flag that determines whether the output is active-high //! or active-low. //! //! This function inverts the ePWM X-BAR trip signal if the \e invert //! parameter is \b true. If \e invert is \b false, the signal will be passed //! as is. The \e trip parameter is a value \b XBAR_TRIPy where y is //! the number of the trip signal on the ePWM X-BAR that is being configured. //! //! \return None. // //***************************************************************************** static inline void XBAR_invertEPWMSignal(XBAR_TripNum trip, _Bool invert) { // // Set or clear the polarity setting bit based on the invert parameter. // __eallow(); if(invert) { (*((volatile uint16_t *)(0x00007A00U + 0x38U))) |= 0x1U << ((uint16_t)trip / 2U); } else { (*((volatile uint16_t *)(0x00007A00U + 0x38U))) &= ~(0x1U << ((uint16_t)trip / 2U)); } __edis(); } //***************************************************************************** // //! Sets the GPIO pin for an Input X-BAR input. //! //! \param input is the X-BAR input being configured. //! \param pin is the identifying number of the pin. //! //! This function configures which GPIO is assigned to an Input X-BAR input. //! The \e input parameter is a value in the form of a define \b XBAR_INPUTy //! where y is a the input number for the Input X-BAR. //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \return None. // //***************************************************************************** static inline void XBAR_setInputPin(XBAR_InputNum input, uint16_t pin) { // // Check the argument. // do { if(!(pin <= 168U)) { __error__("C:\\ti\\c2000\\C2000Ware_5_02_00_00\\driverlib\\f2837xd\\driverlib\\xbar.h", 962); } } while((_Bool)0); // // Write the requested pin to the appropriate input select register. // __eallow(); (*((volatile uint16_t *)((0x00007900U + 0x0U) + (uint16_t)input))) = pin; __edis(); } //***************************************************************************** // //! Locks an input to the Input X-BAR. //! //! \param input is an input to the Input X-BAR. //! //! This function locks the specific input on the Input X-BAR. //! //! \return None. // //***************************************************************************** static inline void XBAR_lockInput(XBAR_InputNum input) { // // lock the input in the INPUTSELECTLOCK register. // __eallow(); (*((volatile uint32_t *)(0x00007900U + 0x1EU))) = 1UL << (uint16_t)input; __edis(); } //***************************************************************************** // //! Locks the Output X-BAR. //! //! This function locks the Output X-BAR. //! //! \return None. // //***************************************************************************** static inline void XBAR_lockOutput(void) { // // Lock the Output X-BAR with the OUTPUTLOCK register. // Write key 0x5A5A to the KEY bits and 1 to LOCK bit. // __eallow(); (*((volatile uint32_t *)(0x00007A80U + 0x3EU))) = ((uint32_t)0x5A5A << 16U) | (uint32_t)0x1U; __edis(); } //***************************************************************************** // //! Locks the ePWM X-BAR. //! //! This function locks the ePWM X-BAR. //! //! \return None. // //***************************************************************************** static inline void XBAR_lockEPWM(void) { // // Lock the ePWM X-BAR with the TRIPLOCK register. // Write key 0x5A5A to the KEY bits and 1 to LOCK bit. // __eallow(); (*((volatile uint32_t *)(0x00007A00U + 0x3EU))) = ((uint32_t)0x5A5A << 16U) | (uint32_t)0x1U; __edis(); } //***************************************************************************** // //! Enables the CLB X-BAR mux values to be passed to an CLB module. //! //! \param auxSignal is the X-BAR output being configured. //! \param muxes is a bit field of the muxes to be enabled. //! //! This function enables the mux values to be passed to the X-BAR auxSignal //! signal. The \e auxSignal parameter is a value \b XBAR_AUXSIGy where y is //! the number of the signal on the CLB. //! //! The \e muxes parameter is a bit field of the muxes being enabled where bit //! 0 represents mux 0, bit 1 represents mux 1 and so on. Defines are provided //! in the form of \b XBAR_MUXnn that can be logically OR'd together to //! enable several muxes on an output at the same time. //! //! \return None. // //***************************************************************************** static inline void XBAR_enableCLBMux(XBAR_AuxSigNum auxSignal, uint32_t muxes) { // // Set the enable bit. // __eallow(); (*((volatile uint32_t *)((0x00007A40U + 0x20U) + (uint32_t)auxSignal))) |= muxes; __edis(); } //***************************************************************************** // //! Disables the CLB X-BAR mux values to be passed to an CLB module. //! //! \param auxSignal is the X-BAR output being configured. //! \param muxes is a bit field of the muxes to be disabled. //! //! This function disables the mux values to be passed to the X-BAR auxSignal //! signal. The \e auxSignal parameter is a value \b XBAR_AUXSIGy where y is //! the number of the signal on the CLB. //! //! The \e muxes parameter is a bit field of the muxes being disabled where bit //! 0 represents mux 0, bit 1 represents mux 1 and so on. Defines are provided //! in the form of \b XBAR_MUXnn that can be logically OR'd together to //! disable several muxes on an output at the same time. //! //! \return None. // //***************************************************************************** static inline void XBAR_disableCLBMux(XBAR_AuxSigNum auxSignal, uint32_t muxes) { // // Clear the enable bit. // __eallow(); (*((volatile uint32_t *)((0x00007A40U + 0x20U) + (uint32_t)auxSignal))) &= ~(muxes); __edis(); } //***************************************************************************** // //! Configures the polarity of an CLB X-BAR output. //! //! \param auxSignal is the X-BAR output being configured. //! \param invert is a flag that determines whether the output is active-high //! or active-low. //! //! This function inverts the CLB X-BAR auxSignal signal if the \e invert //! parameter is \b true. If \e invert is \b false, the signal will be passed //! as is. The \e auxSignal parameter is a value \b XBAR_AUXSIGy where y is //! the number of the signal on the CLB X-BAR that is being configured. //! //! \return None. // //***************************************************************************** static inline void XBAR_invertCLBSignal(XBAR_AuxSigNum auxSignal, _Bool invert) { // // Set or clear the polarity setting bit based on the invert parameter. // __eallow(); if(invert) { (*((volatile uint16_t *)(0x00007A40U + 0x38U))) |= 0x1U << ((uint16_t)auxSignal / 2U); } else { (*((volatile uint16_t *)(0x00007A40U + 0x38U))) &= ~(0x1U << ((uint16_t)auxSignal / 2U)); } __edis(); } //***************************************************************************** // //! Configures the Output X-BAR mux that determines the signals passed to an //! output. //! //! \param output is the X-BAR output being configured. //! \param muxConfig is mux configuration that specifies the signal. //! //! This function configures an Output X-BAR mux. This determines which //! signal(s) should be passed through the X-BAR to a GPIO. The \e output //! parameter is a value \b XBAR_OUTPUTy where y is a the output number //! between 1 and 8 inclusive. //! //! The \e muxConfig parameter for OUTPUT XBAR is the mux configuration //! value that specifies which signal will be passed from the mux. The //! values have the format of \b XBAR_OUT_MUXnn_xx where the 'xx' is //! the signal and nn is the mux number. //! //! This function may be called for each mux of an output and their values will //! be logically OR'd before being passed to the output signal. This means that //! this function may be called, for example, with the argument //! \b XBAR_OUT_MUX00_ECAP1_OUT and then with the argument //! \b XBAR_OUT_MUX01_INPUTXBAR1, resulting in the values of MUX00 and MUX01 //! being logically OR'd if both are enabled. Calling the function twice for //! the same mux on the output will result in the configuration in the second //! call overwriting the first. //! //! \return None. // //***************************************************************************** extern void XBAR_setOutputMuxConfig(XBAR_OutputNum output, XBAR_OutputMuxConfig muxConfig); //***************************************************************************** // //! Configures the ePWM X-BAR mux that determines the signals passed to an //! ePWM module. //! //! \param trip is the X-BAR output being configured. //! \param muxConfig is mux configuration that specifies the signal. //! //! This function configures an ePWM X-BAR mux. This determines which signal(s) //! should be passed through the X-BAR to an ePWM module. The \e trip //! parameter is a value \b XBAR_TRIPy where y is a the number of the trip //! signal on the ePWM. //! //! The \e muxConfig parameter is the mux configuration value that specifies //! which signal will be passed from the mux. The values have the format of //! \b XBAR_EPWM_MUXnn_xx where the 'xx' is the signal and nn is the mux //! number (0 through 31). The possible values are found in xbar.h //! //! This function may be called for each mux of an output and their values will //! be logically OR'd before being passed to the trip signal. This means that //! this function may be called, for example, with the argument //! \b XBAR_EPWM_MUX00_ECAP1_OUT and then with the argument //! \b XBAR_EPWM_MUX01_INPUTXBAR1, resulting in the values of MUX00 and MUX01 //! being logically OR'd if both are enabled. Calling the function twice for //! the same mux on the output will result in the configuration in the second //! call overwriting the first. //! //! \return None. // //***************************************************************************** extern void XBAR_setEPWMMuxConfig(XBAR_TripNum trip, XBAR_EPWMMuxConfig muxConfig); //***************************************************************************** // //! Returns the status of the input latch. //! //! \param inputFlag is the X-BAR input latch being checked. Values are in the //! format of /b XBAR_INPUT_FLG_XXXX where "XXXX" is name of the signal. //! //! \return Returns \b true if the X-BAR input corresponding to the //! \e inputFlag has been triggered. If not, it will return \b false. // //***************************************************************************** extern _Bool XBAR_getInputFlagStatus(XBAR_InputFlag inputFlag); //***************************************************************************** // //! Clears the input latch for the specified input latch. //! //! \param inputFlag is the X-BAR input latch being cleared. //! //! This function clears the Input X-BAR input latch. The input latch to be //! cleared is specified by the \e inputFlag parameter. //! //! \return None. // //***************************************************************************** extern void XBAR_clearInputFlag(XBAR_InputFlag inputFlag); //***************************************************************************** // //! Configures the CLB X-BAR mux that determines the signals passed to a //! CLB module. //! //! \param auxSignal is the X-BAR output being configured. //! \param muxConfig is mux configuration that specifies the signal. //! //! This function configures an CLB X-BAR mux. This determines which signal(s) //! should be passed through the X-BAR to an CLB module. The \e auxSignal //! parameter is a value \b XBAR_AUXSIGy where y is a the number of the //! signal on the CLB. //! //! The \e muxConfig parameter is the mux configuration value that specifies //! which signal will be passed from the mux. The values have the format of //! \b XBAR_CLB_MUXnn_xx where the 'xx' is the signal and nn is the mux //! number (0 through 31). The possible values are found in xbar.h //! //! This function may be called for each mux of an output and their values will //! be logically OR'd before being passed to the signal. This means that //! this function may be called, for example, with the argument //! \b XBAR_CLB_MUX00_ECAP1_OUT and then with the argument //! \b XBAR_CLB_MUX03_INPUTXBAR2, resulting in the values of MUX00 and MUX03 //! being logically OR'd if both are enabled. Calling the function twice for //! the same mux on the output will result in the configuration in the second //! call overwriting the first. //! //! \return None. // //***************************************************************************** extern void XBAR_setCLBMuxConfig(XBAR_AuxSigNum auxSignal, XBAR_CLBMuxConfig muxConfig); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //***************************************************************************** // // Useful defines used within the driver functions to access gpio registers. // Not intended for use by application code. // // Divide by 2 is for C28x which has word access // //***************************************************************************** //***************************************************************************** // // Values that can be passed to GPIO_setPadConfig() as the pinType parameter // and returned by GPIO_getPadConfig(). // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to GPIO_setDirectionMode() as the \e pinIO //! parameter and returned from GPIO_getDirectionMode(). // //***************************************************************************** typedef enum { GPIO_DIR_MODE_IN, //!< Pin is a GPIO input GPIO_DIR_MODE_OUT //!< Pin is a GPIO output } GPIO_Direction; //***************************************************************************** // //! Values that can be passed to GPIO_setInterruptType() as the \e intType //! parameter and returned from GPIO_getInterruptType(). // //***************************************************************************** typedef enum { GPIO_INT_TYPE_FALLING_EDGE = 0x00, //!< Interrupt on falling edge GPIO_INT_TYPE_RISING_EDGE = 0x04, //!< Interrupt on rising edge GPIO_INT_TYPE_BOTH_EDGES = 0x0C //!< Interrupt on both edges } GPIO_IntType; //***************************************************************************** // //! Values that can be passed to GPIO_setQualificationMode() as the //! \e qualification parameter and returned by GPIO_getQualificationMode(). // //***************************************************************************** typedef enum { GPIO_QUAL_SYNC, //!< Synchronization to SYSCLK GPIO_QUAL_3SAMPLE, //!< Qualified with 3 samples GPIO_QUAL_6SAMPLE, //!< Qualified with 6 samples GPIO_QUAL_ASYNC //!< No synchronization } GPIO_QualificationMode; //***************************************************************************** // //! Values that can be passed to GPIO_setAnalogMode() as the \e mode parameter. // //***************************************************************************** typedef enum { GPIO_ANALOG_DISABLED, //!< Pin is in digital mode GPIO_ANALOG_ENABLED //!< Pin is in analog mode } GPIO_AnalogMode; //***************************************************************************** // //! Values that can be passed to GPIO_setControllerCore() as the \e core //! parameter. // //***************************************************************************** typedef enum { GPIO_CORE_CPU1, //!< CPU1 selected as controller core GPIO_CORE_CPU1_CLA1, //!< CPU1's CLA1 selected as controller core GPIO_CORE_CPU2, //!< CPU2 selected as controller core GPIO_CORE_CPU2_CLA1 //!< CPU2's CLA1 selected as controller core } GPIO_CoreSelect; //***************************************************************************** // //! Values that can be passed to GPIO_readPortData(), GPIO_setPortPins(), //! GPIO_clearPortPins(), and GPIO_togglePortPins() as the \e port parameter. // //***************************************************************************** typedef enum { GPIO_PORT_A = 0, //!< GPIO port A GPIO_PORT_B = 1, //!< GPIO port B GPIO_PORT_C = 2, //!< GPIO port C GPIO_PORT_D = 3, //!< GPIO port D GPIO_PORT_E = 4, //!< GPIO port E GPIO_PORT_F = 5 //!< GPIO port F } GPIO_Port; //***************************************************************************** // //! Values that can be passed to GPIO_setInterruptPin(), //! GPIO_setInterruptType(), GPIO_getInterruptType(), GPIO_enableInterrupt(), //! GPIO_disableInterrupt(), as the \e extIntNum parameter. // //***************************************************************************** typedef enum { GPIO_INT_XINT1, //!< External Interrupt 1 GPIO_INT_XINT2, //!< External Interrupt 2 GPIO_INT_XINT3, //!< External Interrupt 3 GPIO_INT_XINT4, //!< External Interrupt 4 GPIO_INT_XINT5 //!< External Interrupt 5 } GPIO_ExternalIntNum; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks that a pin number is valid for a device. //! //! Note that this function reflects the highest possible GPIO number of a //! device on its biggest package. Check the datasheet to see what the actual //! range of valid pin numbers is for a specific package. //! //! \return None. // //***************************************************************************** static inline _Bool GPIO_isPinValid(uint32_t pin) { return(pin <= 168U); } //***************************************************************************** // //! Sets the interrupt type for the specified pin. //! //! \param extIntNum specifies the external interrupt. //! \param intType specifies the type of interrupt trigger mechanism. //! //! This function sets up the various interrupt trigger mechanisms for the //! specified pin on the selected GPIO port. //! //! The following defines can be used to specify the external interrupt for the //! \e extIntNum parameter: //! //! - \b GPIO_INT_XINT1 //! - \b GPIO_INT_XINT2 //! - \b GPIO_INT_XINT3 //! - \b GPIO_INT_XINT4 //! - \b GPIO_INT_XINT5 //! //! One of the following flags can be used to define the \e intType //! parameter: //! //! - \b GPIO_INT_TYPE_FALLING_EDGE sets detection to edge and trigger to //! falling //! - \b GPIO_INT_TYPE_RISING_EDGE sets detection to edge and trigger to rising //! - \b GPIO_INT_TYPE_BOTH_EDGES sets detection to both edges //! //! \return None. // //***************************************************************************** static inline void GPIO_setInterruptType(GPIO_ExternalIntNum extIntNum, GPIO_IntType intType) { // // Write the selected polarity to the appropriate register. // (*((volatile uint16_t *)(0x00007070U + (uint16_t)extIntNum))) = ((*((volatile uint16_t *)(0x00007070U + (uint16_t)extIntNum))) & ~0xCU) | (uint16_t)intType; } //***************************************************************************** // //! Gets the interrupt type for a pin. //! //! \param extIntNum specifies the external interrupt. //! //! This function gets the interrupt type for a interrupt. The interrupt can be //! configured as a falling-edge, rising-edge, or both-edges detected //! interrupt. //! //! The following defines can be used to specify the external interrupt for the //! \e extIntNum parameter: //! //! - \b GPIO_INT_XINT1 //! - \b GPIO_INT_XINT2 //! - \b GPIO_INT_XINT3 //! - \b GPIO_INT_XINT4 //! - \b GPIO_INT_XINT5 //! //! \return Returns one of the flags described for GPIO_setInterruptType(). // //***************************************************************************** static inline GPIO_IntType GPIO_getInterruptType(GPIO_ExternalIntNum extIntNum) { // // Read the selected polarity from the appropriate register. // return((GPIO_IntType)((uint16_t)((*((volatile uint16_t *)(0x00007070U + (uint16_t)extIntNum))) & 0xCU))); } //***************************************************************************** // //! Enables the specified external interrupt. //! //! \param extIntNum specifies the external interrupt. //! //! This function enables the indicated external interrupt sources. Only the //! sources that are enabled can be reflected to the processor interrupt. //! Disabled sources have no effect on the processor. //! //! The following defines can be used to specify the external interrupt for the //! \e extIntNum parameter: //! //! - \b GPIO_INT_XINT1 //! - \b GPIO_INT_XINT2 //! - \b GPIO_INT_XINT3 //! - \b GPIO_INT_XINT4 //! - \b GPIO_INT_XINT5 //! //! \return None. // //***************************************************************************** static inline void GPIO_enableInterrupt(GPIO_ExternalIntNum extIntNum) { // // Set the enable bit for the specified interrupt. // (*((volatile uint16_t *)(0x00007070U + (uint16_t)extIntNum))) |= 0x1U; } //***************************************************************************** // //! Disables the specified external interrupt. //! //! \param extIntNum specifies the external interrupt. //! //! This function disables the indicated external interrupt sources. Only the //! sources that are enabled can be reflected to the processor interrupt. //! Disabled sources have no effect on the processor. //! //! The following defines can be used to specify the external interrupt for the //! \e extIntNum parameter: //! //! - \b GPIO_INT_XINT1 //! - \b GPIO_INT_XINT2 //! - \b GPIO_INT_XINT3 //! - \b GPIO_INT_XINT4 //! - \b GPIO_INT_XINT5 //! //! \return None. // //***************************************************************************** static inline void GPIO_disableInterrupt(GPIO_ExternalIntNum extIntNum) { // // Clear the enable bit for the specified interrupt // (*((volatile uint16_t *)(0x00007070U + (uint16_t)extIntNum))) &= ~0x1U; } //***************************************************************************** // //! Gets the value of the external interrupt counter. //! //! \param extIntNum specifies the external interrupt. //! //! The following defines can be used to specify the external interrupt for the //! \e extIntNum parameter: //! //! - \b GPIO_INT_XINT1 //! - \b GPIO_INT_XINT2 //! - \b GPIO_INT_XINT3 //! //! \b Note: The counter is clocked at the SYSCLKOUT rate. //! //! \return Returns external interrupt counter value. // //***************************************************************************** static inline uint16_t GPIO_getInterruptCounter(GPIO_ExternalIntNum extIntNum) { do { if(!(extIntNum <= GPIO_INT_XINT3)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/gpio.h", 393); } } while((_Bool)0); // // Read the counter value from the appropriate register. // return(((*((volatile uint16_t *)(0x00007070U + 0x8U + (uint16_t)extIntNum))))); } //***************************************************************************** // //! Reads the value present on the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! //! The value at the specified pin are read, as specified by \e pin. The value //! is returned for both input and output pins. //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \return Returns the value in the data register for the specified pin. // //***************************************************************************** static inline uint32_t GPIO_readPin(uint32_t pin) { volatile uint32_t *gpioDataReg; // // Check the arguments. // do { if(!(GPIO_isPinValid(pin))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/gpio.h", 424); } } while((_Bool)0); gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((pin / 32U) * ((0x8U - 0x0U) / 2U)); return((gpioDataReg[(0x0U / 2U)] >> (pin % 32U)) & (uint32_t)0x1U); } //***************************************************************************** // //! Writes a value to the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! \param outVal is the value to write to the pin. //! //! Writes the corresponding bit values to the output pin specified by //! \e pin. Writing to a pin configured as an input pin has no effect. //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \return None. // //***************************************************************************** static inline void GPIO_writePin(uint32_t pin, uint32_t outVal) { volatile uint32_t *gpioDataReg; uint32_t pinMask; // // Check the arguments. // do { if(!(GPIO_isPinValid(pin))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/gpio.h", 458); } } while((_Bool)0); gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((pin / 32U) * ((0x8U - 0x0U) / 2U)); pinMask = (uint32_t)1U << (pin % 32U); if(outVal == 0U) { gpioDataReg[(0x4U / 2U)] = pinMask; } else { gpioDataReg[(0x2U / 2U)] = pinMask; } } //***************************************************************************** // //! Toggles the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! //! Writes the corresponding bit values to the output pin specified by //! \e pin. Writing to a pin configured as an input pin has no effect. //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \return None. // //***************************************************************************** static inline void GPIO_togglePin(uint32_t pin) { volatile uint32_t *gpioDataReg; // // Check the arguments. // do { if(!(GPIO_isPinValid(pin))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/gpio.h", 498); } } while((_Bool)0); gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((pin / 32U) * ((0x8U - 0x0U) / 2U)); gpioDataReg[(0x6U / 2U)] = (uint32_t)1U << (pin % 32U); } //***************************************************************************** // //! Reads the data on the specified port. //! //! \param port is the GPIO port being accessed in the form of \b GPIO_PORT_X //! where X is the port letter. //! //! \return Returns the value available on pin for the specified port. Each //! bit of the the return value represents a pin on the port, where bit 0 //! represents GPIO port pin 0, bit 1 represents GPIO port pin 1, and so on. // //***************************************************************************** static inline uint32_t GPIO_readPortData(GPIO_Port port) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and return DATA. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((uint32_t)port * ((0x8U - 0x0U) / 2U)); return(gpioDataReg[(0x0U / 2U)]); } //***************************************************************************** // //! Writes a value to the specified port. //! //! \param port is the GPIO port being accessed. //! \param outVal is the value to write to the port. //! //! This function writes the value \e outVal to the port specified by the //! \e port parameter which takes a value in the form of \b GPIO_PORT_X where X //! is the port letter. For example, use \b GPIO_PORT_A to affect port A //! (GPIOs 0-31). //! //! The \e outVal is a bit-packed value, where each bit represents a bit on a //! GPIO port. Bit 0 represents GPIO port pin 0, bit 1 represents GPIO port //! pin 1, and so on. //! //! \return None. // //***************************************************************************** static inline void GPIO_writePortData(GPIO_Port port, uint32_t outVal) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and write to DATA. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((uint32_t)port * ((0x8U - 0x0U) / 2U)); gpioDataReg[(0x0U / 2U)] = outVal; } //***************************************************************************** // //! Sets all of the specified pins on the specified port. //! //! \param port is the GPIO port being accessed. //! \param pinMask is a mask of which of the 32 pins on the port are affected. //! //! This function sets all of the pins specified by the \e pinMask parameter on //! the port specified by the \e port parameter which takes a value in the //! form of \b GPIO_PORT_X where X is the port letter. For example, use //! \b GPIO_PORT_A to affect port A (GPIOs 0-31). //! //! The \e pinMask is a bit-packed value, where each bit that is set identifies //! the pin to be set. Bit 0 represents GPIO port pin 0, bit 1 represents GPIO //! port pin 1, and so on. //! //! \return None. // //***************************************************************************** static inline void GPIO_setPortPins(GPIO_Port port, uint32_t pinMask) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and write to SET. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((uint32_t)port * ((0x8U - 0x0U) / 2U)); gpioDataReg[(0x2U / 2U)] = pinMask; } //***************************************************************************** // //! Clears all of the specified pins on the specified port. //! //! \param port is the GPIO port being accessed. //! \param pinMask is a mask of which of the 32 pins on the port are affected. //! //! This function clears all of the pins specified by the \e pinMask parameter //! on the port specified by the \e port parameter which takes a value in the //! form of \b GPIO_PORT_X where X is the port letter. For example, use //! \b GPIO_PORT_A to affect port A (GPIOs 0-31). //! //! The \e pinMask is a bit-packed value, where each bit that is \b set //! identifies the pin to be cleared. Bit 0 represents GPIO port pin 0, bit 1 //! represents GPIO port pin 1, and so on. //! //! \return None. // //***************************************************************************** static inline void GPIO_clearPortPins(GPIO_Port port, uint32_t pinMask) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and write to CLEAR. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((uint32_t)port * ((0x8U - 0x0U) / 2U)); gpioDataReg[(0x4U / 2U)] = pinMask; } //***************************************************************************** // //! Toggles all of the specified pins on the specified port. //! //! \param port is the GPIO port being accessed. //! \param pinMask is a mask of which of the 32 pins on the port are affected. //! //! This function toggles all of the pins specified by the \e pinMask parameter //! on the port specified by the \e port parameter which takes a value in the //! form of \b GPIO_PORT_X where X is the port letter. For example, use //! \b GPIO_PORT_A to affect port A (GPIOs 0-31). //! //! The \e pinMask is a bit-packed value, where each bit that is set identifies //! the pin to be toggled. Bit 0 represents GPIO port pin 0, bit 1 represents //! GPIO port pin 1, and so on. //! //! \return None. // //***************************************************************************** static inline void GPIO_togglePortPins(GPIO_Port port, uint32_t pinMask) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and write to TOGGLE. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007F00U) + ((uint32_t)port * ((0x8U - 0x0U) / 2U)); gpioDataReg[(0x6U / 2U)] = pinMask; } //***************************************************************************** // //! Locks the configuration of the specified pins on the specified port. //! //! \param port is the GPIO port being accessed. //! \param pinMask is a mask of which of the 32 pins on the port are affected. //! //! This function locks the configuration registers of the pins specified by //! the \e pinMask parameter on the port specified by the \e port parameter //! which takes a value in the form of \b GPIO_PORT_X where X is the port //! letter. For example, use \b GPIO_PORT_A to affect port A (GPIOs 0-31). //! //! The \e pinMask is a bit-packed value, where each bit that is set identifies //! the pin to be locked. Bit 0 represents GPIO port pin 0, bit 1 represents //! GPIO port pin 1, 0xFFFFFFFF represents all pins on that port, and so on. //! //! Note that this function is for locking the configuration of a pin such as //! the pin muxing, direction, open drain mode, and other settings. It does not //! affect the ability to change the value of the pin. //! //! \return None. // //***************************************************************************** static inline void GPIO_lockPortConfig(GPIO_Port port, uint32_t pinMask) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and write to the lock. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007C00U) + ((uint32_t)port * ((0x40U - 0x0U) / 2U)); __eallow(); gpioDataReg[(0x3CU / 2U)] |= pinMask; __edis(); } //***************************************************************************** // //! Unlocks the configuration of the specified pins on the specified port. //! //! \param port is the GPIO port being accessed. //! \param pinMask is a mask of which of the 32 pins on the port are affected. //! //! This function unlocks the configuration registers of the pins specified by //! the \e pinMask parameter on the port specified by the \e port parameter //! which takes a value in the form of \b GPIO_PORT_X where X is the port //! letter. For example, use \b GPIO_PORT_A to affect port A (GPIOs 0-31). //! //! The \e pinMask is a bit-packed value, where each bit that is set identifies //! the pin to be unlocked. Bit 0 represents GPIO port pin 0, bit 1 represents //! GPIO port pin 1, 0xFFFFFFFF represents all pins on that port, and so on. //! //! \return None. // //***************************************************************************** static inline void GPIO_unlockPortConfig(GPIO_Port port, uint32_t pinMask) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and write to the lock. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007C00U) + ((uint32_t)port * ((0x40U - 0x0U) / 2U)); __eallow(); gpioDataReg[(0x3CU / 2U)] &= ~pinMask; __edis(); } //***************************************************************************** // //! Commits the lock configuration of the specified pins on the specified port. //! //! \param port is the GPIO port being accessed. //! \param pinMask is a mask of which of the 32 pins on the port are affected. //! //! This function commits the lock configuration registers of the pins //! specified by the \e pinMask parameter on the port specified by the \e port //! parameter which takes a value in the form of \b GPIO_PORT_X where X is the //! port letter. For example, use \b GPIO_PORT_A to affect port A (GPIOs 0-31). //! //! The \e pinMask is a bit-packed value, where each bit that is set identifies //! the pin to be locked. Bit 0 represents GPIO port pin 0, bit 1 represents //! GPIO port pin 1, 0xFFFFFFFF represents all pins on that port, and so on. //! //! Note that once this function is called, GPIO_lockPortConfig() and //! GPIO_unlockPortConfig() will no longer have any effect on the specified //! pins. //! //! \return None. // //***************************************************************************** static inline void GPIO_commitPortConfig(GPIO_Port port, uint32_t pinMask) { volatile uint32_t *gpioDataReg; // // Get the starting address of the port's registers and write to the lock. // gpioDataReg = (uint32_t *)((uintptr_t)0x00007C00U) + ((uint32_t)port * ((0x40U - 0x0U) / 2U)); __eallow(); gpioDataReg[(0x3EU / 2U)] |= pinMask; __edis(); } //***************************************************************************** // //! Sets the direction and mode of the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! \param pinIO is the pin direction mode. //! //! This function configures the specified pin on the selected GPIO port as //! either input or output. //! //! The parameter \e pinIO is an enumerated data type that can be one of the //! following values: //! //! - \b GPIO_DIR_MODE_IN //! - \b GPIO_DIR_MODE_OUT //! //! where \b GPIO_DIR_MODE_IN specifies that the pin is programmed as an input //! and \b GPIO_DIR_MODE_OUT specifies that the pin is programmed as an output. //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \return None. // //***************************************************************************** extern void GPIO_setDirectionMode(uint32_t pin, GPIO_Direction pinIO); //***************************************************************************** // //! Gets the direction mode of a pin. //! //! \param pin is the identifying GPIO number of the pin. //! //! This function gets the direction mode for a specified pin. The pin can be //! configured as either an input or output The type of direction is returned //! as an enumerated data type. //! //! \return Returns one of the enumerated data types described for //! GPIO_setDirectionMode(). // //***************************************************************************** extern GPIO_Direction GPIO_getDirectionMode(uint32_t pin); //***************************************************************************** // //! Sets the pin for the specified external interrupt. //! //! \param pin is the identifying GPIO number of the pin. //! \param extIntNum specifies the external interrupt. //! //! This function sets which pin triggers the selected external interrupt. //! //! The following defines can be used to specify the external interrupt for the //! \e extIntNum parameter: //! //! - \b GPIO_INT_XINT1 //! - \b GPIO_INT_XINT2 //! - \b GPIO_INT_XINT3 //! - \b GPIO_INT_XINT4 //! - \b GPIO_INT_XINT5 //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \sa XBAR_setInputPin() //! //! \return None. // //***************************************************************************** extern void GPIO_setInterruptPin(uint32_t pin, GPIO_ExternalIntNum extIntNum); //***************************************************************************** // //! Sets the pad configuration for the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! \param pinType specifies the pin type. //! //! This function sets the pin type for the specified pin. The parameter //! \e pinType can be the following values: //! //! - \b GPIO_PIN_TYPE_STD specifies a push-pull output or a floating input //! - \b GPIO_PIN_TYPE_PULLUP specifies the pull-up is enabled for an input //! - \b GPIO_PIN_TYPE_OD specifies an open-drain output pin //! - \b GPIO_PIN_TYPE_INVERT specifies inverted polarity on an input //! //! \b GPIO_PIN_TYPE_INVERT may be OR-ed with \b GPIO_PIN_TYPE_STD or //! \b GPIO_PIN_TYPE_PULLUP. //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \return None. // //***************************************************************************** extern void GPIO_setPadConfig(uint32_t pin, uint32_t pinType); //***************************************************************************** // //! Gets the pad configuration for a pin. //! //! \param pin is the identifying GPIO number of the pin. //! //! This function returns the pin type for the specified pin. The value //! returned corresponds to the values used in GPIO_setPadConfig(). //! //! \return Returns a bit field of the values \b GPIO_PIN_TYPE_STD, //! \b GPIO_PIN_TYPE_PULLUP, \b GPIO_PIN_TYPE_OD, and \b GPIO_PIN_TYPE_INVERT. // //***************************************************************************** extern uint32_t GPIO_getPadConfig(uint32_t pin); //***************************************************************************** // //! Sets the qualification mode for the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! \param qualification specifies the qualification mode of the pin. //! //! This function sets the qualification mode for the specified pin. The //! parameter \e qualification can be one of the following values: //! - \b GPIO_QUAL_SYNC //! - \b GPIO_QUAL_3SAMPLE //! - \b GPIO_QUAL_6SAMPLE //! - \b GPIO_QUAL_ASYNC //! //! To set the qualification sampling period, use //! GPIO_setQualificationPeriod(). //! //! \return None. // //***************************************************************************** extern void GPIO_setQualificationMode(uint32_t pin, GPIO_QualificationMode qualification); //***************************************************************************** // //! Gets the qualification type for the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! //! \return Returns the qualification mode in the form of one of the values //! \b GPIO_QUAL_SYNC, \b GPIO_QUAL_3SAMPLE, \b GPIO_QUAL_6SAMPLE, or //! \b GPIO_QUAL_ASYNC. // //***************************************************************************** extern GPIO_QualificationMode GPIO_getQualificationMode(uint32_t pin); //***************************************************************************** // //! Sets the qualification period for a set of pins //! //! \param pin is the identifying GPIO number of the pin. //! \param divider specifies the output drive strength. //! //! This function sets the qualification period for a set of \b 8 \b pins, //! specified by the \e pin parameter. For instance, passing in 3 as the value //! of \e pin will set the qualification period for GPIO0 through GPIO7, and a //! value of 98 will set the qualification period for GPIO96 through GPIO103. //! This is because the register field that configures the divider is shared. //! //! To think of this in terms of an equation, configuring \e pin as \b n will //! configure GPIO (n & ~(7)) through GPIO ((n & ~(7)) + 7). //! //! \e divider is the value by which the frequency of SYSCLKOUT is divided. It //! can be 1 or an even value between 2 and 510 inclusive. //! //! \return None. // //***************************************************************************** extern void GPIO_setQualificationPeriod(uint32_t pin, uint32_t divider); //***************************************************************************** // //! Selects the controller core of a specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! \param core is the core that is controller of the specified pin. //! //! This function configures which core owns the specified pin's data registers //! (DATA, SET, CLEAR, and TOGGLE). The \e core parameter is an enumerated data //! type that specifies the core, such as \b GPIO_CORE_CPU1_CLA1 to make CPU1's //! CLA1 controller of the pin. //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \return None. // //***************************************************************************** extern void GPIO_setControllerCore(uint32_t pin, GPIO_CoreSelect core); //***************************************************************************** // //! Sets the analog mode of the specified pin. //! //! \param pin is the identifying GPIO number of the pin. //! \param mode is the selected analog mode. //! //! This function configures the specified pin for either analog or digital //! mode. Not all GPIO pins have the ability to be switched to analog mode, //! so refer to the technical reference manual for details. This setting should //! be thought of as another level of muxing. //! //! The parameter \e mode is an enumerated data type that can be one of the //! following values: //! //! - \b GPIO_ANALOG_DISABLED - Pin is in digital mode //! - \b GPIO_ANALOG_ENABLED - Pin is in analog mode //! //! The pin is specified by its numerical value. For example, GPIO34 is //! specified by passing 34 as \e pin. //! //! \b Note: The pin parameter is applicable for both AIO and GPIO because //! the GPAxMSEL.GPIOy register configures for both //! //! \return None. // //***************************************************************************** extern void GPIO_setAnalogMode(uint32_t pin, GPIO_AnalogMode mode); //***************************************************************************** // //! Configures the alternate function of a GPIO pin. //! //! \param pinConfig is the pin configuration value, specified as only one //! of the \b GPIO_#_???? values. //! //! This function configures the pin mux that selects the peripheral function //! associated with a particular GPIO pin. Only one peripheral function at a //! time can be associated with a GPIO pin, and each peripheral function should //! only be associated with a single GPIO pin at a time (despite the fact that //! many of them can be associated with more than one GPIO pin). //! //! The available mappings are supplied in pin_map.h. //! //! \return None. // //***************************************************************************** extern void GPIO_setPinConfig(uint32_t pinConfig); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //############################################################################# // // FILE: hrpwm.h // // TITLE: C28x HRPWM Driver // //############################################################################# // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //############################################################################# //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup hrpwm_api HRPWM //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_hrpwm.h // // TITLE: Definitions for the HRPWM registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the HRPWM register offsets // //************************************************************************************************* // Mirror Register // Mirror Register // Register //************************************************************************************************* // // The following are defines for the bit fields in the TBCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TBCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TBSTS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQTSRCSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the VCAPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the VCNTCFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRCNFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRPWR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRMSTEP register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRCNFG2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the HRPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TRREM register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GLDCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GLDCFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the EPWMXLINK register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLA2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCTLB2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQSFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the AQCSFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBREDHR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBRED register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBFEDHR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DBFED register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TBPHS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPA register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CMPB register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GLDCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZDCSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCTLDCA register // //************************************************************************************************* // UP // DOWN // UP // DOWN //************************************************************************************************* // // The following are defines for the bit fields in the TZCTLDCB register // //************************************************************************************************* // UP // DOWN // UP // DOWN //************************************************************************************************* // // The following are defines for the bit fields in the TZEINT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCBCFLG register // //************************************************************************************************* // 2 // 2 //************************************************************************************************* // // The following are defines for the bit fields in the TZOSTFLG register // //************************************************************************************************* // 1 // 1 //************************************************************************************************* // // The following are defines for the bit fields in the TZCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZCBCCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZOSTCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the TZFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETPS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETFRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETINTPS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETSOCPS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETCNTINITCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ETCNTINIT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCACTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCBCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCFCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCCAPCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCAHTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCALTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCBHTRIPSEL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DCBLTRIPSEL register // //************************************************************************************************* //############################################################################# // // FILE: hrpwm.h // // TITLE: C28x HRPWM Driver // //############################################################################# // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //############################################################################# //***************************************************************************** // //! Values that can be passed to HRPWM_setMEPEdgeSelect(), //! HRPWM_setMEPControlMode(), HRPWM_setCounterCompareShadowLoadEvent() //! as the \e channel parameter. // //***************************************************************************** typedef enum { HRPWM_CHANNEL_A = 0, //!< HRPWM A HRPWM_CHANNEL_B = 8 //!< HRPWM B } HRPWM_Channel; //***************************************************************************** // //! Values that can be passed to HRPWM_setMEPEdgeSelect() as the \e mepEdgeMode //! parameter. // //***************************************************************************** typedef enum { //! HRPWM is disabled HRPWM_MEP_CTRL_DISABLE = 0, //! MEP controls rising edge HRPWM_MEP_CTRL_RISING_EDGE = 1, //! MEP controls falling edge HRPWM_MEP_CTRL_FALLING_EDGE = 2, //! MEP controls both rising and falling edge HRPWM_MEP_CTRL_RISING_AND_FALLING_EDGE = 3 } HRPWM_MEPEdgeMode; //***************************************************************************** // //! Values that can be passed to HRPWM_setHRMEPCtrlMode() as the \e //! parameter. // //***************************************************************************** typedef enum { //! CMPAHR/CMPBHR or TBPRDHR controls MEP edge HRPWM_MEP_DUTY_PERIOD_CTRL = 0, //! TBPHSHR controls MEP edge HRPWM_MEP_PHASE_CTRL = 1 } HRPWM_MEPCtrlMode; //***************************************************************************** // //! Values that can be passed to HRPWM_setCounterCompareShadowLoadEvent(), //! HRPWM_setRisingEdgeDelayLoadMode() and HRPWM_setFallingEdgeDelayLoadMode //! as the \e loadEvent parameter. // //***************************************************************************** typedef enum { //! load when counter equals zero HRPWM_LOAD_ON_CNTR_ZERO = 0, //! load when counter equals period HRPWM_LOAD_ON_CNTR_PERIOD = 1, //! load when counter equals zero or period HRPWM_LOAD_ON_CNTR_ZERO_PERIOD = 2, } HRPWM_LoadMode; //***************************************************************************** // //! Values that can be passed to HRPWM_setChannelBOutputPath() as the \e //! outputOnB parameter. // //***************************************************************************** typedef enum { HRPWM_OUTPUT_ON_B_NORMAL = 0, //!< ePWMxB output is normal. HRPWM_OUTPUT_ON_B_INV_A = 1 //!< ePWMxB output is inverted //!< version of ePWMxA signal } HRPWM_ChannelBOutput; //***************************************************************************** // //! Values that can be passed to HRPWM_setSyncPulseSource() as the \e //! syncPulseSource parameter. // //***************************************************************************** typedef enum { //! Counter equals Period HRPWM_PWMSYNC_SOURCE_PERIOD = 0, //! Counter equals zero HRPWM_PWMSYNC_SOURCE_ZERO = 1, //! Counter equals COMPC when counting up HRPWM_PWMSYNC_SOURCE_COMPC_UP = 4, //! Counter equals COMPC when counting down HRPWM_PWMSYNC_SOURCE_COMPC_DOWN = 5, //! Counter equals COMPD when counting up HRPWM_PWMSYNC_SOURCE_COMPD_UP = 6, //! Counter equals COMPD when counting down HRPWM_PWMSYNC_SOURCE_COMPD_DOWN = 7 } HRPWM_SyncPulseSource; //***************************************************************************** // //! Values that can be passed to HRPWM_setCounterCompareValue() as the \e //! compModule parameter. // //***************************************************************************** typedef enum { HRPWM_COUNTER_COMPARE_A = 0, //!< counter compare A HRPWM_COUNTER_COMPARE_B = 4 //!< counter compare B } HRPWM_CounterCompareModule; //***************************************************************************** // //! Values that can be passed to HRPWM_setDeadbandMEPEdgeSelect() as the \e //! mepDBEdge. // //***************************************************************************** typedef enum { //! HRPWM is disabled HRPWM_DB_MEP_CTRL_DISABLE = 0, //! MEP controls Rising Edge Delay HRPWM_DB_MEP_CTRL_RED = 1, //! MEP controls Falling Edge Delay HRPWM_DB_MEP_CTRL_FED = 2, //! MEP controls both Falling and Rising edge delay HRPWM_DB_MEP_CTRL_RED_FED = 3 } HRPWM_MEPDeadBandEdgeMode; //***************************************************************************** // //! Values that can be passed to HRPWM_lockRegisters() as the \e registerGroup //! parameter. // //***************************************************************************** typedef enum { HRPWM_REGISTER_GROUP_HRPWM = 0x1, //!< HRPWM register group HRPWM_REGISTER_GROUP_GLOBAL_LOAD = 0x2, //!< Global load register group HRPWM_REGISTER_GROUP_TRIP_ZONE = 0x4, //!< Trip zone register group HRPWM_REGISTER_GROUP_TRIP_ZONE_CLEAR = 0x8, //!< Trip zone clear group HRPWM_REGISTER_GROUP_DIGITAL_COMPARE = 0x10 //!< Digital compare group } HRPWM_LockRegisterGroup; //***************************************************************************** // // Functions APIs shared with ePWM module // //***************************************************************************** // // Time Base Sub Module related APIs // // // Action Qualifier module related APIs // /* HRPWM_setActionQualifierSwAction is kept for compatibility, use HRPWM_setActionQualifierSWAction*/ /* HRPWM_forceActionQualifierSwAction is kept for compatibility, use HRPWM_forceActionQualifierSWAction*/ // // Dead Band Module related APIs // // // Chopper module related APIs // // // Trip Zone module related APIs // // // HRPWM_getTripZoneInterruptStatus API define is obsolete please use // HRPWM_getTripZoneFlagStatus going forward. // // // HRPWM_getCycleByCycleTripZoneInterruptStatus API define is obsolete // please use HRPWM_getCycleByCycleTripZoneFlagStatus going forward. // // // HRPWM_getOneShotTripZoneInterruptStatus is obsolete please use // HRPWM_getOneShotTripZoneFlagStatus going forward. // // // HRPWM_clearTripZoneInterruptFlag is obsolete please use // HRPWM_clearTripZoneFlag going forward. // // // HRPWM_clearCycleByCycleTripZoneInterruptFlag is obsolete please use // HRPWM_clearCycleByCycleTripZoneFlag going forward. // // // HRPWM_clearOneShotTripZoneInterruptFlag is obsolete please use // HRPWM_clearOneShotTripZoneFlag going forward. // // // Event Trigger related APIs // // // ADC SOC configuration related APIs // // // Digital Compare Module related APIs // // // Valley switching related APIs // // // Global Load feature related APIs // //***************************************************************************** // // Prototypes for the API. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks HRPWM base address. //! //! \param base specifies the HRPWM module base address. //! //! This function determines if an HRPWM module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool HRPWM_isBaseValid(uint32_t base) { return((base == 0x00004000U) || (base == 0x00004100U) || (base == 0x00004200U) || (base == 0x00004300U) || (base == 0x00004400U) || (base == 0x00004500U) || (base == 0x00004600U) || (base == 0x00004700U)); } //***************************************************************************** // //! Sets the consolidated phase shift value in high resolution mode. //! //! \param base is the base address of the EPWM module. //! \param phaseCount is the consolidated phase shift count value. //! //! This function sets the consolidated phase shift value, that is, both TBPHS //! and TBPHSHR values are configured together. //! //! Call EPWM_enablePhaseShiftLoad & HRPWM_enableHRPhaseShiftLoad() functions //! to enable loading of the phaseCount in high resolution mode. //! //! \b Note: phaseCount is a 24-bit value. //! \b Note: For configuring TBPHS = 0x3C, TBPHSHR = 0x2; //! phaseCount = 0x3C02 //! //! \return None. // //***************************************************************************** static inline void HRPWM_setPhaseShift(uint32_t base, uint32_t phaseCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 559); } } while((_Bool)0); do { if(!(phaseCount < 0x1000000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 560); } } while((_Bool)0); // // Write to TBPHS:TBPHSHR bits // (*((volatile uint32_t *)(base + 0x60U))) = phaseCount << 8U; } //***************************************************************************** // //! Sets only the high resolution phase shift value. //! //! \param base is the base address of the EPWM module. //! \param hrPhaseCount is the high resolution phase shift count value. //! //! This function sets only the high resolution phase shift(TBPHSHR) value. //! Call the HRPWM_enableHRPhaseShiftLoad() function to enable loading of //! the hrPhaseCount. //! //! \b Note: hrPhaseCount is an 8-bit value. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setHiResPhaseShiftOnly(uint32_t base, uint16_t hrPhaseCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 590); } } while((_Bool)0); do { if(!(hrPhaseCount < 256U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 591); } } while((_Bool)0); // // Write to TBPHSHR bits // (*((volatile uint16_t *)(base + 0x60U))) = hrPhaseCount << 8U; } //***************************************************************************** // //! Sets the consolidated period of time base counter used in HR mode. //! //! \param base is the base address of the EPWM module. //! \param periodCount is the consolidated period count value. //! //! This function sets the consolidated period of time base counter value //! (TBPRD:TBPRDHR) required in high resolution mode. //! //! User should map the desired period or frequency of the waveform into //! the correct periodCount. //! //! \b Note: periodCount is a 24 bit value. //! \b Note: For configuring TBPRD = 0x3C, TBPRDHR = 0xA; //! periodCount = 0x3C0A //! //! \return None. // //***************************************************************************** static inline void HRPWM_setTimeBasePeriod(uint32_t base, uint32_t periodCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 625); } } while((_Bool)0); do { if(!(periodCount < 0x1000000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 626); } } while((_Bool)0); // // Write to TBPRD:TBPRDHR bits // (*((volatile uint32_t *)(base + 0x62U))) = periodCount << 8U; } //***************************************************************************** // //! Sets only the high resolution time base counter. //! //! \param base is the base address of the EPWM module. //! \param hrPeriodCount is the high resolution period count value. //! //! This function sets only the high resolution time base counter(TBPRDHR) //! value. //! //! User should map the desired period or frequency of the waveform into //! the correct hrPeriodCount. //! //! \b Note: hrPeriodCount is an 8-bit value. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setHiResTimeBasePeriodOnly(uint32_t base, uint16_t hrPeriodCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 658); } } while((_Bool)0); do { if(!(hrPeriodCount < 256U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 659); } } while((_Bool)0); // // Write to TBPRDHR bits // (*((volatile uint16_t *)(base + 0x62U))) = hrPeriodCount << 8U; } //***************************************************************************** // //! Gets the consolidated time base period count used in HR mode //! //! \param base is the base address of the EPWM module. //! //! This function gets the consolidated time base period(TBPRD:TBPRDHR) value //! used in high resolution mode. //! //! \return The consolidated time base period count value. // //***************************************************************************** static inline uint32_t HRPWM_getTimeBasePeriod(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 685); } } while((_Bool)0); // // Read from TBPRD:TBPRDHR bit // return((*((volatile uint32_t *)(base + 0x62U))) >> 8U); } //***************************************************************************** // //! Gets the only the high resolution time base period count. //! //! \param base is the base address of the EPWM module. //! //! This function gets only the high resolution time base period(TBPRDHR) value. //! //! \return The high resolution time base period count value. // //***************************************************************************** static inline uint16_t HRPWM_getHiResTimeBasePeriodOnly(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 710); } } while((_Bool)0); // // Read from TBPRDHR bit // return((*((volatile uint16_t *)(base + 0x62U))) >> 8U); } //***************************************************************************** // //! Sets the high resolution edge controlled by MEP (Micro Edge Positioner). //! //! \param base is the base address of the EPWM module. //! \param channel is high resolution period module. //! \param mepEdgeMode edge of the PWM that is controlled by MEP (Micro Edge //! Positioner). //! //! This function sets the edge of the PWM that is controlled by MEP (Micro //! Edge Positioner). Valid values for the parameters are: //! - channel //! - HRPWM_CHANNEL_A - HRPWM A //! - HRPWM_CHANNEL_B - HRPWM B //! - mepEdgeMode //! - HRPWM_MEP_CTRL_DISABLE - HRPWM is disabled //! - HRPWM_MEP_CTRL_RISING_EDGE - MEP (Micro Edge Positioner) //! controls rising edge. //! - HRPWM_MEP_CTRL_FALLING_EDGE - MEP (Micro Edge Positioner) //! controls falling edge. //! - HRPWM_MEP_CTRL_RISING_AND_FALLING_EDGE - MEP (Micro Edge Positioner) //! controls both edges. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setMEPEdgeSelect(uint32_t base, HRPWM_Channel channel, HRPWM_MEPEdgeMode mepEdgeMode) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 751); } } while((_Bool)0); // // Set the edge mode // __eallow(); (*((volatile uint16_t *)(base + 0x20U))) = (((*((volatile uint16_t *)(base + 0x20U))) & ~(0x3U << (uint16_t)channel )) | ((uint16_t)mepEdgeMode << (uint16_t)channel)); __edis(); } //***************************************************************************** // //! Sets the MEP (Micro Edge Positioner) control mode. //! //! \param base is the base address of the EPWM module. //! \param channel is high resolution period module. //! \param mepCtrlMode is the MEP (Micro Edge Positioner) control mode. //! //! This function sets the mode (register type) the MEP (Micro Edge Positioner) //! will control. Valid values for the parameters are: //! - channel //! - HRPWM_CHANNEL_A - HRPWM A //! - HRPWM_CHANNEL_B - HRPWM B //! - mepCtrlMode //! - HRPWM_MEP_DUTY_PERIOD_CTRL - MEP (Micro Edge Positioner) is //! controlled by value of CMPAHR/ //! CMPBHR(depending on the value of //! channel) or TBPRDHR. //! - HRPWM_MEP_PHASE_CTRL - MEP (Micro Edge Positioner) is //! controlled by TBPHSHR. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setMEPControlMode(uint32_t base, HRPWM_Channel channel, HRPWM_MEPCtrlMode mepCtrlMode) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 794); } } while((_Bool)0); // // Set the MEP control // __eallow(); (*((volatile uint16_t *)(base + 0x20U))) = (((*((volatile uint16_t *)(base + 0x20U))) & ~(0x1U << ((uint16_t)channel + 2U))) | ((uint16_t)mepCtrlMode << ((uint16_t)channel + 2U))); __edis(); } //***************************************************************************** // //! Sets the high resolution comparator load mode. //! //! \param base is the base address of the EPWM module. //! \param channel is high resolution period module. //! \param loadEvent is the MEP (Micro Edge Positioner) control mode. //! //! This function sets the shadow load mode of the high resolution comparator. //! The function sets the COMPA or COMPB register depending on the channel //! variable. //! Valid values for the parameters are: //! - channel //! - HRPWM_CHANNEL_A - HRPWM A //! - HRPWM_CHANNEL_B - HRPWM B //! - loadEvent //! - HRPWM_LOAD_ON_CNTR_ZERO - load when counter equals zero //! - HRPWM_LOAD_ON_CNTR_PERIOD - load when counter equals period //! - HRPWM_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals zero or //! period //! //! \return None. // //***************************************************************************** static inline void HRPWM_setCounterCompareShadowLoadEvent(uint32_t base, HRPWM_Channel channel, HRPWM_LoadMode loadEvent) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 837); } } while((_Bool)0); // // Set the CMPAHR or CMPBHR load mode // __eallow(); (*((volatile uint16_t *)(base + 0x20U))) = (((*((volatile uint16_t *)(base + 0x20U))) & ~(0x3U << ((uint16_t)channel + 3U))) | ((uint16_t)loadEvent << ((uint16_t)channel + 3U))); __edis(); } //***************************************************************************** // //! Sets the high resolution output swap mode. //! //! \param base is the base address of the EPWM module. //! \param enableOutputSwap is the output swap flag. //! //! This function sets the HRPWM output swap mode. If enableOutputSwap is true, //! ePWMxA signal appears on ePWMxB output and ePWMxB signal appears on ePWMxA //! output. If it is false ePWMxA and ePWMxB outputs are unchanged. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setOutputSwapMode(uint32_t base, _Bool enableOutputSwap) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 869); } } while((_Bool)0); // // Set output swap mode // __eallow(); if(enableOutputSwap) { (*((volatile uint16_t *)(base + 0x20U))) |= 0x80U; } else { (*((volatile uint16_t *)(base + 0x20U))) &= ~0x80U; } __edis(); } //***************************************************************************** // //! Sets the high resolution output on ePWMxB //! //! \param base is the base address of the EPWM module. //! \param outputOnB is the output signal on ePWMxB. //! //! This function sets the HRPWM output signal on ePWMxB. If outputOnB is //! HRPWM_OUTPUT_ON_B_INV_A, ePWMxB output is an inverted version of //! ePWMxA. If outputOnB is HRPWM_OUTPUT_ON_B_NORMAL, ePWMxB output is //! ePWMxB. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setChannelBOutputPath(uint32_t base, HRPWM_ChannelBOutput outputOnB) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 907); } } while((_Bool)0); // // Set the output on ePWM B // __eallow(); (*((volatile uint16_t *)(base + 0x20U))) = (((*((volatile uint16_t *)(base + 0x20U))) & ~(0x20U)) | ((uint16_t)outputOnB << 5U)); __edis(); } //***************************************************************************** // //! Enables MEP (Micro Edge Positioner) automatic scale mode. //! //! \param base is the base address of the EPWM module. //! //! This function enables the MEP (Micro Edge Positioner) to automatically //! scale HRMSTEP. //! //! The SFO library will calculate required MEP steps per coarse steps and //! feed it to HRMSTEP register. The MEP calibration module will use the value //! in HRMSTEP to determine appropriate number of MEP steps represented by //! fractional duty cycle. //! //! \return None. // //***************************************************************************** static inline void HRPWM_enableAutoConversion(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 942); } } while((_Bool)0); // // Enable MEP automatic scale // __eallow(); (*((volatile uint16_t *)(base + 0x20U))) |= 0x40U; __edis(); } //***************************************************************************** // //! Disables MEP automatic scale mode. //! //! \param base is the base address of the EPWM module. //! //! This function disables the MEP (Micro Edge Positioner) from automatically //! scaling HRMSTEP. //! //! \return None. // //***************************************************************************** static inline void HRPWM_disableAutoConversion(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 970); } } while((_Bool)0); // // Disable MEP automatic scale // __eallow(); (*((volatile uint16_t *)(base + 0x20U))) &= ~0x40U; __edis(); } //***************************************************************************** // //! Enable high resolution period feature. //! //! \param base is the base address of the EPWM module. //! //! This function enables the high resolution period feature. //! //! \return None. // //***************************************************************************** static inline void HRPWM_enablePeriodControl(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 997); } } while((_Bool)0); // // Set HRPE bit // __eallow(); (*((volatile uint16_t *)(base + 0x2DU))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disable high resolution period feature. //! //! \param base is the base address of the EPWM module. //! //! This function disables the high resolution period feature. //! //! \return None. // //***************************************************************************** static inline void HRPWM_disablePeriodControl(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1024); } } while((_Bool)0); // // Clear HRPE bit // __eallow(); (*((volatile uint16_t *)(base + 0x2DU))) &= ~0x1U; __edis(); } //***************************************************************************** // //! Enable high resolution phase load //! //! \param base is the base address of the EPWM module. //! //! This function enables loading of high resolution phase shift value which is //! set by the function HRPWM_setPhaseShift(). //! //! \return None. // //***************************************************************************** static inline void HRPWM_enablePhaseShiftLoad(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1052); } } while((_Bool)0); // // Set TBPHSHRLOADE bit // __eallow(); (*((volatile uint16_t *)(base + 0x2DU))) |= 0x4U; __edis(); } //***************************************************************************** // //! Disable high resolution phase load //! //! \param base is the base address of the EPWM module. //! //! This function disables loading of high resolution phase shift value. //! //! \return // //***************************************************************************** static inline void HRPWM_disablePhaseShiftLoad(uint32_t base) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1079); } } while((_Bool)0); // // Clear TBPHSHRLOADE bit // __eallow(); (*((volatile uint16_t *)(base + 0x2DU))) &= ~0x4U; __edis(); } //***************************************************************************** // //! Set high resolution PWMSYNC source. //! //! \param base is the base address of the EPWM module. //! \param syncPulseSource is the PWMSYNC source. //! //! This function sets the high resolution PWMSYNC pulse source. //! Valid values for syncPulseSource are: //! - HRPWM_PWMSYNC_SOURCE_PERIOD - Counter equals Period. //! - HRPWM_PWMSYNC_SOURCE_ZERO - Counter equals zero. //! - HRPWM_PWMSYNC_SOURCE_COMPC_UP - Counter equals COMPC when //! counting up. //! - HRPWM_PWMSYNC_SOURCE_COMPC_DOWN - Counter equals COMPC when //! counting down. //! - HRPWM_PWMSYNC_SOURCE_COMPD_UP - Counter equals COMPD when //! counting up. //! - HRPWM_PWMSYNC_SOURCE_COMPD_DOWN - Counter equals COMPD when //! counting down. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setSyncPulseSource(uint32_t base, HRPWM_SyncPulseSource syncPulseSource) { // // Set the PWMSYNC source // __eallow(); // // Configuration for sync pulse source equal to HRPWM_PWMSYNC_SOURCE_PERIOD // or HRPWM_PWMSYNC_SOURCE_ZERO // if(syncPulseSource < HRPWM_PWMSYNC_SOURCE_COMPC_UP) { (*((volatile uint16_t *)(base + 0x2DU))) = (((*((volatile uint16_t *)(base + 0x2DU))) & ~(0x70U | 0x2U)) | ((uint16_t)syncPulseSource << 1U)); } else { (*((volatile uint16_t *)(base + 0x2DU))) = (((*((volatile uint16_t *)(base + 0x2DU))) & ~0x70U) | ((uint16_t)syncPulseSource << 4U)); } __edis(); } //***************************************************************************** // //! Sets the Translator Remainder value. //! //! \param base is the base address of the EPWM module. //! \param trremVal is the translator remainder value. //! //! This function sets the Translator Remainder value. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setTranslatorRemainder(uint32_t base, uint16_t trremVal) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1158); } } while((_Bool)0); do { if(!(trremVal < 2048U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1159); } } while((_Bool)0); // // Set Translator Remainder value // __eallow(); (*((volatile uint16_t *)(base + 0x2EU))) = (trremVal & 0x7FFU); __edis(); } //***************************************************************************** // //! Sets the consolidated counter compare values in HR mode. //! //! \param base is the base address of the EPWM module. //! \param compModule is the Counter Compare module. //! \param compCount is the consolidated counter compare count value. //! //! This function sets the consolidated counter compare(CMPx:CMPxHR) value //! required in high resolution mode for counter compare registers. //! Valid values for compModule are: //! - HRPWM_COUNTER_COMPARE_A - counter compare A. //! - HRPWM_COUNTER_COMPARE_B - counter compare B. //! //! \b Note: compCount is a 24 bit value. //! \b Note: For configuring CMPA = 0xB4, CMPAHR = 0x64; value of //! compCount = 0xB464 //! //! \return None. // //***************************************************************************** static inline void HRPWM_setCounterCompareValue(uint32_t base, HRPWM_CounterCompareModule compModule, uint32_t compCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1198); } } while((_Bool)0); do { if(!(compCount < 0x1000000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1199); } } while((_Bool)0); // // Write to counter compare registers // if(compModule == HRPWM_COUNTER_COMPARE_A) { // // Write to CMPA:CMPAHR // (*((volatile uint32_t *)(base + 0x6AU))) = compCount << 8U; } else { // // Write to CMPB:CMPBHR // (*((volatile uint32_t *)(base + 0x6CU))) = compCount << 8U; } } //***************************************************************************** // //! Sets only the high resolution counter compare value. //! //! \param base is the base address of the EPWM module. //! \param compModule is the Counter Compare module. //! \param hrCompCount is the high resolution counter compare count value. //! //! This function sets the high resolution counter compare value(CMPxHR) for //! counter compare registers. //! Valid values for compModule are: //! - HRPWM_COUNTER_COMPARE_A - counter compare A. //! - HRPWM_COUNTER_COMPARE_B - counter compare B. //! //! \b Note: hrCompCount is an 8-bit value. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setHiResCounterCompareValueOnly(uint32_t base, HRPWM_CounterCompareModule compModule, uint16_t hrCompCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1247); } } while((_Bool)0); do { if(!(hrCompCount < 256U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1248); } } while((_Bool)0); // // Write to the high resolution counter compare registers // if(compModule == HRPWM_COUNTER_COMPARE_A) { // // Write to CMPAHR // (*((volatile uint16_t *)(base + 0x6AU))) = hrCompCount << 8U; } else { // // Write to CMPBHR // (*((volatile uint16_t *)(base + 0x6CU))) = hrCompCount << 8U; } } //***************************************************************************** // //! Gets the consolidated counter compare values. //! //! \param base is the base address of the EPWM module. //! \param compModule is the Counter Compare module value. //! //! This function gets the consolidated counter compare(CMPx:CMPxHR) value //! used in high resolution for the counter compare module specified. //! Valid values for compModule are: //! - HRPWM_COUNTER_COMPARE_A - counter compare A. //! - HRPWM_COUNTER_COMPARE_B - counter compare B. //! //! //! \return None. // //***************************************************************************** static inline uint32_t HRPWM_getCounterCompareValue(uint32_t base, HRPWM_CounterCompareModule compModule) { uint32_t compCount; // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1295); } } while((_Bool)0); // // Get counter compare value for selected module // if(compModule == HRPWM_COUNTER_COMPARE_A) { // // Read from CMPAHR // compCount = (*((volatile uint32_t *)(base + 0x6AU))) >> 8U; } else { // // Read from CMPBHR // compCount = (*((volatile uint32_t *)(base + 0x6CU))) >> 8U; } return(compCount); } //***************************************************************************** // //! Gets only the high resolution counter compare values. //! //! \param base is the base address of the EPWM module. //! \param compModule is the Counter Compare module value. //! //! This function gets only the high resolution counter compare(CMPxHR) value //! for the counter compare module specified. //! Valid values for compModule are: //! - HRPWM_COUNTER_COMPARE_A - counter compare A. //! - HRPWM_COUNTER_COMPARE_B - counter compare B. //! //! \return None. // //***************************************************************************** static inline uint16_t HRPWM_getHiResCounterCompareValueOnly(uint32_t base, HRPWM_CounterCompareModule compModule) { uint16_t hrCompCount; // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1342); } } while((_Bool)0); // // Get counter compare value for selected module // if(compModule == HRPWM_COUNTER_COMPARE_A) { // // Read from CMPAHR // hrCompCount = (*((volatile uint16_t *)(base + 0x6AU))) >> 8U; } else { // // Read from CMPBHR // hrCompCount = (*((volatile uint16_t *)(base + 0x6CU))) >> 8U; } return(hrCompCount); } //***************************************************************************** // //! Sets the consolidated RED count in high resolution mode. //! //! \param base is the base address of the EPWM module. //! \param redCount is the high resolution RED count. //! //! This function sets the consolidated RED (Rising Edge Delay) count //! (DBRED:DBREDHR) value used in high resolution mode. The value of //! redCount should be less than 0x200000. //! //! \b Note: redCount is a 21 bit value. //! \b Note: For configuring DBRED = 0x4, DBREDHR = 0x1; value of //! redCount = ((0x4 << 7) | 0x1) = 0x201 //! //! \return None. // //***************************************************************************** static inline void HRPWM_setRisingEdgeDelay(uint32_t base, uint32_t redCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1388); } } while((_Bool)0); do { if(!(redCount < 0x200000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1389); } } while((_Bool)0); // // Set the consolidated RED (Rising Edge Delay) count // (*((volatile uint32_t *)(base + 0x50U))) = redCount << 9U; } //***************************************************************************** // //! Sets the high resolution RED count only. //! //! \param base is the base address of the EPWM module. //! \param hrRedCount is the high resolution RED count. //! //! This function sets only the high resolution RED (Rising Edge Delay) //! count(DBREDHR) value. //! The value of hrRedCount should be less than 128. //! //! \b Note: hrRedCount is a 7-bit value. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setHiResRisingEdgeDelayOnly(uint32_t base, uint16_t hrRedCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1419); } } while((_Bool)0); do { if(!(hrRedCount < 128U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1420); } } while((_Bool)0); // // Set the High Resolution RED (Rising Edge Delay) count only // (*((volatile uint16_t *)(base + 0x50U))) = hrRedCount << 9U; } //***************************************************************************** // //! Sets the consolidated FED value in high resolution mode. //! //! \param base is the base address of the EPWM module. //! \param fedCount is the high resolution FED count. //! //! This function sets the consolidated FED (Falling Edge Delay) count //! (DBFED: DBFEDHR) value used in high resolution mode. The value of fedCount //! should be less than 0x200000. //! //! \b Note: fedCount is a 21 bit value. //! \b Note: For configuring DBFED = 0x4, DBFEDHR = 0x1; value of //! fedCount = ((0x4 << 7) | 0x1) = 0x201 //! //! \return None. // //***************************************************************************** static inline void HRPWM_setFallingEdgeDelay(uint32_t base, uint32_t fedCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1452); } } while((_Bool)0); do { if(!(fedCount < 0x200000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1453); } } while((_Bool)0); // // Set the High Resolution FED (Falling Edge Delay) count // (*((volatile uint32_t *)(base + 0x52U))) = fedCount << 9U; } //***************************************************************************** // //! Sets high resolution FED count only. //! //! \param base is the base address of the EPWM module. //! \param hrFedCount is the high resolution FED count. //! //! This function sets only the high resolution FED (Falling Edge Delay) count //! (DBFEDHR)value. The value of hrFedCount should be less than 128. //! //! \b Note: hrFedCount is a 7-bit value. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setHiResFallingEdgeDelayOnly(uint32_t base, uint16_t hrFedCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1482); } } while((_Bool)0); do { if(!(hrFedCount < 128U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1483); } } while((_Bool)0); // // Set the high resolution FED (Falling Edge Delay) count // (*((volatile uint16_t *)(base + 0x52U))) = hrFedCount << 9U; } //***************************************************************************** // //! Set high resolution MEP (Micro Edge Positioner) step. //! //! \param base is the base address of the EPWM module. //! \param mepCount is the high resolution MEP (Micro Edge Positioner) step //! count. //! //! This function sets the high resolution MEP (Micro Edge Positioner) step //! count. The maximum value for the MEP count step is 255. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setMEPStep(uint32_t base, uint16_t mepCount) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1511); } } while((_Bool)0); do { if(!(mepCount < 256U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1512); } } while((_Bool)0); // // Set HRPWM MEP count // __eallow(); (*((volatile uint16_t *)(base + 0x26U))) = (((*((volatile uint16_t *)(base + 0x26U))) & ~0xFFU) | mepCount); __edis(); } //***************************************************************************** // //! Set high resolution Dead Band MEP (Micro Edge Positioner) control. //! //! \param base is the base address of the EPWM module. //! \param mepDBEdge is the high resolution MEP (Micro Edge Positioner) control //! edge. //! //! This function sets the high resolution Dead Band edge that the MEP (Micro //! Edge Positioner) controls Valid values for mepDBEdge are: //! - HRPWM_DB_MEP_CTRL_DISABLE - HRPWM is disabled //! - HRPWM_DB_MEP_CTRL_RED - MEP (Micro Edge Positioner) controls //! Rising Edge Delay //! - HRPWM_DB_MEP_CTRL_FED - MEP (Micro Edge Positioner) controls //! Falling Edge Delay //! - HRPWM_DB_MEP_CTRL_RED_FED - MEP (Micro Edge Positioner) controls both //! Falling and Rising edge delays //! //! \return None. // //***************************************************************************** static inline void HRPWM_setDeadbandMEPEdgeSelect(uint32_t base, HRPWM_MEPDeadBandEdgeMode mepDBEdge) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1552); } } while((_Bool)0); // // Set the HRPWM DB edge mode // __eallow(); (*((volatile uint16_t *)(base + 0x27U))) = (((*((volatile uint16_t *)(base + 0x27U))) & ~0x3U) | ((uint16_t)mepDBEdge)); __edis(); } //***************************************************************************** // //! Set the high resolution Dead Band RED load mode. //! //! \param base is the base address of the EPWM module. //! \param loadEvent is the shadow to active load event. //! //! This function sets the high resolution Rising Edge Delay(RED)Dead Band //! count load mode. //! Valid values for loadEvent are: //! - HRPWM_LOAD_ON_CNTR_ZERO - load when counter equals zero. //! - HRPWM_LOAD_ON_CNTR_PERIOD - load when counter equals period //! - HRPWM_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals zero //! or period. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setRisingEdgeDelayLoadMode(uint32_t base, HRPWM_LoadMode loadEvent) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1589); } } while((_Bool)0); // // Set the HRPWM RED load mode // __eallow(); (*((volatile uint16_t *)(base + 0x27U))) = (((*((volatile uint16_t *)(base + 0x27U))) & ~0xCU) | ((uint16_t)loadEvent << 2U)); __edis(); } //***************************************************************************** // //! Set the high resolution Dead Band FED load mode. //! //! \param base is the base address of the EPWM module. //! \param loadEvent is the shadow to active load event. //! //! This function sets the high resolution Falling Edge Delay(FED) Dead Band //! count load mode. //! Valid values for loadEvent are: //! - HRPWM_LOAD_ON_CNTR_ZERO - load when counter equals zero. //! - HRPWM_LOAD_ON_CNTR_PERIOD - load when counter equals period //! - HRPWM_LOAD_ON_CNTR_ZERO_PERIOD - load when counter equals zero //! or period. //! //! \return None. // //***************************************************************************** static inline void HRPWM_setFallingEdgeDelayLoadMode(uint32_t base, HRPWM_LoadMode loadEvent) { // // Check the arguments // do { if(!(HRPWM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/hrpwm.h", 1625); } } while((_Bool)0); // // Set the HRPWM FED load mode // __eallow(); (*((volatile uint16_t *)(base + 0x27U))) = (((*((volatile uint16_t *)(base + 0x27U))) & ~0x30U) | ((uint16_t)loadEvent << 4U)); __edis(); } //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: i2c.h // // TITLE: C28x I2C driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup i2c_api I2C //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_i2c.h // // TITLE: Definitions for the I2C registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the I2C register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2COAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CIER register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CSTR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CDRR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CSAR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CDXR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CMDR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CISRC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CEMDR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CPSC register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CFFTX register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the I2CFFRX register // //************************************************************************************************* //***************************************************************************** // SPI //***************************************************************************** //***************************************************************************** // I2C //***************************************************************************** //***************************************************************************** // // Defines for the API. // //***************************************************************************** //***************************************************************************** // // I2C Controller commands. // //***************************************************************************** //***************************************************************************** // // I2C interrupts for use with the intFlags parameter of I2C_enableInterrupt(), // I2C_disableInterrupt(), and I2C_clearInterruptStatus() and to be returned by // I2C_getInterruptStatus(). // //***************************************************************************** // // Helpful define to mask out the bits in the I2CSTR register that aren't // associated with interrupts. // //***************************************************************************** // // Flags for use as the stsFlags parameter of I2C_clearStatus() and to be // returned by I2C_getStatus(). // //***************************************************************************** //***************************************************************************** // //! I2C interrupts to be returned by I2C_getInterruptSource(). // //***************************************************************************** typedef enum { I2C_INTSRC_NONE, //!< No interrupt pending I2C_INTSRC_ARB_LOST, //!< Arbitration-lost interrupt I2C_INTSRC_NO_ACK, //!< NACK interrupt I2C_INTSRC_REG_ACCESS_RDY, //!< Register-access-ready interrupt I2C_INTSRC_RX_DATA_RDY, //!< Receive-data-ready interrupt I2C_INTSRC_TX_DATA_RDY, //!< Transmit-data-ready interrupt I2C_INTSRC_STOP_CONDITION, //!< Stop condition detected I2C_INTSRC_ADDR_TARGET, //!< Addressed as target interrupt } I2C_InterruptSource; //***************************************************************************** // //! Values that can be passed to I2C_setFIFOInterruptLevel() as the \e txLevel //! parameter, returned by I2C_getFIFOInterruptLevel() in the \e txLevel //! parameter, and returned by I2C_getTxFIFOStatus(). // //***************************************************************************** typedef enum { I2C_FIFO_TXEMPTY = 0x0000U, //!< Transmit FIFO empty I2C_FIFO_TX0 = 0x0000U, //!< Transmit FIFO empty I2C_FIFO_TX1 = 0x0001U, //!< Transmit FIFO 1/16 full I2C_FIFO_TX2 = 0x0002U, //!< Transmit FIFO 2/16 full I2C_FIFO_TX3 = 0x0003U, //!< Transmit FIFO 3/16 full I2C_FIFO_TX4 = 0x0004U, //!< Transmit FIFO 4/16 full I2C_FIFO_TX5 = 0x0005U, //!< Transmit FIFO 5/16 full I2C_FIFO_TX6 = 0x0006U, //!< Transmit FIFO 6/16 full I2C_FIFO_TX7 = 0x0007U, //!< Transmit FIFO 7/16 full I2C_FIFO_TX8 = 0x0008U, //!< Transmit FIFO 8/16 full I2C_FIFO_TX9 = 0x0009U, //!< Transmit FIFO 9/16 full I2C_FIFO_TX10 = 0x000AU, //!< Transmit FIFO 10/16 full I2C_FIFO_TX11 = 0x000BU, //!< Transmit FIFO 11/16 full I2C_FIFO_TX12 = 0x000CU, //!< Transmit FIFO 12/16 full I2C_FIFO_TX13 = 0x000DU, //!< Transmit FIFO 13/16 full I2C_FIFO_TX14 = 0x000EU, //!< Transmit FIFO 14/16 full I2C_FIFO_TX15 = 0x000FU, //!< Transmit FIFO 15/16 full I2C_FIFO_TX16 = 0x0010U, //!< Transmit FIFO full I2C_FIFO_TXFULL = 0x0010U //!< Transmit FIFO full } I2C_TxFIFOLevel; //***************************************************************************** // //! Values that can be passed to I2C_setFIFOInterruptLevel() as the \e rxLevel //! parameter, returned by I2C_getFIFOInterruptLevel() in the \e rxLevel //! parameter, and returned by I2C_getRxFIFOStatus(). // //***************************************************************************** typedef enum { I2C_FIFO_RXEMPTY = 0x0000U, //!< Receive FIFO empty I2C_FIFO_RX0 = 0x0000U, //!< Receive FIFO empty I2C_FIFO_RX1 = 0x0001U, //!< Receive FIFO 1/16 full I2C_FIFO_RX2 = 0x0002U, //!< Receive FIFO 2/16 full I2C_FIFO_RX3 = 0x0003U, //!< Receive FIFO 3/16 full I2C_FIFO_RX4 = 0x0004U, //!< Receive FIFO 4/16 full I2C_FIFO_RX5 = 0x0005U, //!< Receive FIFO 5/16 full I2C_FIFO_RX6 = 0x0006U, //!< Receive FIFO 6/16 full I2C_FIFO_RX7 = 0x0007U, //!< Receive FIFO 7/16 full I2C_FIFO_RX8 = 0x0008U, //!< Receive FIFO 8/16 full I2C_FIFO_RX9 = 0x0009U, //!< Receive FIFO 9/16 full I2C_FIFO_RX10 = 0x000AU, //!< Receive FIFO 10/16 full I2C_FIFO_RX11 = 0x000BU, //!< Receive FIFO 11/16 full I2C_FIFO_RX12 = 0x000CU, //!< Receive FIFO 12/16 full I2C_FIFO_RX13 = 0x000DU, //!< Receive FIFO 13/16 full I2C_FIFO_RX14 = 0x000EU, //!< Receive FIFO 14/16 full I2C_FIFO_RX15 = 0x000FU, //!< Receive FIFO 15/16 full I2C_FIFO_RX16 = 0x0010U, //!< Receive FIFO full I2C_FIFO_RXFULL = 0x0010U //!< Receive FIFO full } I2C_RxFIFOLevel; //***************************************************************************** // //! Values that can be passed to I2C_setBitCount() as the \e size parameter. // //***************************************************************************** typedef enum { I2C_BITCOUNT_1 = 1U, //!< 1 bit per data byte I2C_BITCOUNT_2 = 2U, //!< 2 bits per data byte I2C_BITCOUNT_3 = 3U, //!< 3 bits per data byte I2C_BITCOUNT_4 = 4U, //!< 4 bits per data byte I2C_BITCOUNT_5 = 5U, //!< 5 bits per data byte I2C_BITCOUNT_6 = 6U, //!< 6 bits per data byte I2C_BITCOUNT_7 = 7U, //!< 7 bits per data byte I2C_BITCOUNT_8 = 0U //!< 8 bits per data byte } I2C_BitCount; //***************************************************************************** // //! Values that can be passed to I2C_setAddressMode() as the \e mode parameter. // //***************************************************************************** typedef enum { I2C_ADDR_MODE_7BITS = 0x0000U, //!< 7-bit address I2C_ADDR_MODE_10BITS = 0x0100U //!< 10-bit address } I2C_AddressMode; //***************************************************************************** // //! Values that can be passed to I2C_setEmulationMode() as the \e mode //! parameter. // //***************************************************************************** typedef enum { //! If SCL is low, keep it low. If high, stop when it goes low again. I2C_EMULATION_STOP_SCL_LOW = 0x0000U, //! Continue I2C operation regardless I2C_EMULATION_FREE_RUN = 0x4000U } I2C_EmulationMode; //***************************************************************************** // //! Values that can be passed to I2C_initController() as the \e dutyCycle //! parameter. // //***************************************************************************** typedef enum { I2C_DUTYCYCLE_33, //!< Clock duty cycle is 33% I2C_DUTYCYCLE_50 //!< Clock duty cycle is 55% } I2C_DutyCycle; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks an I2C base address. //! //! \param base is the base address of the I2C instance used. //! //! This function determines if a I2C module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool I2C_isBaseValid(uint32_t base) { return( (base == 0x00007300U) || (base == 0x00007340U) ); } //***************************************************************************** // //! Enables the I2C module. //! //! \param base is the base address of the I2C instance used. //! //! This function enables operation of the I2C module. //! //! \return None. // //***************************************************************************** static inline void I2C_enableModule(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 323); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x9U))) |= 0x20U; } //***************************************************************************** // //! Disables the I2C module. //! //! \param base is the base address of the I2C instance used. //! //! This function disables operation of the I2C module. //! //! \return None. // //***************************************************************************** static inline void I2C_disableModule(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 345); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x9U))) &= ~(0x20U); } //***************************************************************************** // //! Enables the transmit and receive FIFOs. //! //! \param base is the base address of the I2C instance used. //! //! This functions enables the transmit and receive FIFOs in the I2C. //! //! \return None. // //***************************************************************************** static inline void I2C_enableFIFO(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 367); } } while((_Bool)0); // // Enable the FIFO. // (*((volatile uint16_t *)(base + 0x20U))) |= 0x4000U | 0x2000U; (*((volatile uint16_t *)(base + 0x21U))) |= 0x2000U; } //***************************************************************************** // //! Disables the transmit and receive FIFOs. //! //! \param base is the base address of the I2C instance used. //! //! This functions disables the transmit and receive FIFOs in the I2C. //! //! \return None. // //***************************************************************************** static inline void I2C_disableFIFO(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 393); } } while((_Bool)0); // // Disable the FIFO. // (*((volatile uint16_t *)(base + 0x20U))) &= ~(0x4000U | 0x2000U); (*((volatile uint16_t *)(base + 0x21U))) &= ~0x2000U; } //***************************************************************************** // //! Sets the FIFO level at which interrupts are generated. //! //! \param base is the base address of the I2C instance used. //! \param txLevel is the transmit FIFO interrupt level, specified as //! \b I2C_FIFO_TX0, \b I2C_FIFO_TX1, \b I2C_FIFO_TX2, . . . or //! \b I2C_FIFO_TX16. //! \param rxLevel is the receive FIFO interrupt level, specified as //! \b I2C_FIFO_RX0, \b I2C_FIFO_RX1, \b I2C_FIFO_RX2, . . . or //! \b I2C_FIFO_RX16. //! //! This function sets the FIFO level at which transmit and receive interrupts //! are generated. The transmit FIFO interrupt flag will be set when the FIFO //! reaches a value less than or equal to \e txLevel. The receive FIFO //! flag will be set when the FIFO reaches a value greater than or equal to //! \e rxLevel. //! //! \return None. // //***************************************************************************** static inline void I2C_setFIFOInterruptLevel(uint32_t base, I2C_TxFIFOLevel txLevel, I2C_RxFIFOLevel rxLevel) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 430); } } while((_Bool)0); // // Set the FIFO interrupt levels. // (*((volatile uint16_t *)(base + 0x20U))) = ((*((volatile uint16_t *)(base + 0x20U))) & (~0x1FU)) | (uint16_t)txLevel; (*((volatile uint16_t *)(base + 0x21U))) = ((*((volatile uint16_t *)(base + 0x21U))) & (~0x1FU)) | (uint16_t)rxLevel; } //***************************************************************************** // //! Gets the FIFO level at which interrupts are generated. //! //! \param base is the base address of the I2C instance used. //! \param txLevel is a pointer to storage for the transmit FIFO level, //! returned as one of \b I2C_FIFO_TX0, \b I2C_FIFO_TX1, //! \b I2C_FIFO_TX2, . . . or \b I2C_FIFO_TX16. //! \param rxLevel is a pointer to storage for the receive FIFO level, //! returned as one of \b I2C_FIFO_RX0, \b I2C_FIFO_RX1, //! \b I2C_FIFO_RX2, . . . or \b I2C_FIFO_RX16. //! //! This function gets the FIFO level at which transmit and receive interrupts //! are generated. The transmit FIFO interrupt flag will be set when the FIFO //! reaches a value less than or equal to \e txLevel. The receive FIFO //! flag will be set when the FIFO reaches a value greater than or equal to //! \e rxLevel. //! //! \return None. // //***************************************************************************** static inline void I2C_getFIFOInterruptLevel(uint32_t base, I2C_TxFIFOLevel *txLevel, I2C_RxFIFOLevel *rxLevel) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 469); } } while((_Bool)0); // // Extract the transmit and receive FIFO levels. // *txLevel = (I2C_TxFIFOLevel)((*((volatile uint16_t *)(base + 0x20U))) & 0x1FU); *rxLevel = (I2C_RxFIFOLevel)((*((volatile uint16_t *)(base + 0x21U))) & 0x1FU); } //***************************************************************************** // //! Get the transmit FIFO status //! //! \param base is the base address of the I2C instance used. //! //! This function gets the current number of words in the transmit FIFO. //! //! \return Returns the current number of words in the transmit FIFO specified //! as one of the following: //! \b I2C_FIFO_TX0, \b I2C_FIFO_TX1, \b I2C_FIFO_TX2, \b I2C_FIFO_TX3, //! ..., or \b I2C_FIFO_TX16 // //***************************************************************************** static inline I2C_TxFIFOLevel I2C_getTxFIFOStatus(uint32_t base) { uint16_t level; // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 502); } } while((_Bool)0); // // Get the current FIFO status // level = (((*((volatile uint16_t *)(base + 0x20U))) & 0x1F00U) >> 8U); return((I2C_TxFIFOLevel)level); } //***************************************************************************** // //! Get the receive FIFO status //! //! \param base is the base address of the I2C instance used. //! //! This function gets the current number of words in the receive FIFO. //! //! \return Returns the current number of words in the receive FIFO specified //! as one of the following: //! \b I2C_FIFO_RX0, \b I2C_FIFO_RX1, \b I2C_FIFO_RX2, \b I2C_FIFO_RX3, //! ..., or \b I2C_FIFO_RX16 // //***************************************************************************** static inline I2C_RxFIFOLevel I2C_getRxFIFOStatus(uint32_t base) { uint16_t level; // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 535); } } while((_Bool)0); // // Get the current FIFO status // level = (((*((volatile uint16_t *)(base + 0x21U))) & 0x1F00U) >> 8U); return((I2C_RxFIFOLevel)level); } //***************************************************************************** // //! Reads I2C Module clock prescaler value. //! //! \param base is the base address of the I2C instance used. //! //! This function reads the I2C prescaler value which configures the I2C module //! clock by dividing down the SYSCLK. I2C_MODULE_CLK = SYSCLK / (I2CPSC + ) //! //! \return Returns the I2C prescaler(I2CPSC) cast as an uint16_t. // //***************************************************************************** static inline uint16_t I2C_getPreScaler(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 564); } } while((_Bool)0); // // Return the contents of the Prescaler register. // return((*((volatile uint16_t *)(base + 0xCU)))); } //***************************************************************************** // //! Sets the address that the I2C Controller places on the bus. //! //! \param base is the base address of the I2C instance used. //! \param targetAddr 7-bit or 10-bit target address //! //! This function configures the address that the I2C Controller places on the bus //! when initiating a transaction. //! //! \return None. // //***************************************************************************** static inline void I2C_setTargetAddress(uint32_t base, uint16_t targetAddr) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 591); } } while((_Bool)0); do { if(!(targetAddr <= 0x3FFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 592); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x7U))) = targetAddr; } //***************************************************************************** // //! Sets the own address for this I2C module. //! //! \param base is the base address of the I2C Target module. //! \param Addr is the 7-bit or 10-bit address //! //! This function writes the specified address. //! //! The parameter \e Addr is the value that is compared against the //! target address sent by an I2C controller. //! //! \return None. // //***************************************************************************** static inline void I2C_setOwnAddress(uint32_t base, uint16_t Addr) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 618); } } while((_Bool)0); do { if(!(Addr <= 0x3FFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 619); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x0U))) = Addr; } //***************************************************************************** // //! Indicates whether or not the I2C bus is busy. //! //! \param base is the base address of the I2C instance used. //! //! This function returns an indication of whether or not the I2C bus is busy. //! This function can be used in a multi-controller environment to determine if the //! bus is free for another data transfer. //! //! \return Returns \b true if the I2C bus is busy; otherwise, returns //! \b false. // //***************************************************************************** static inline _Bool I2C_isBusBusy(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 644); } } while((_Bool)0); return(((*((volatile uint16_t *)(base + 0x2U))) & 0x1000U) == 0x1000U); } //***************************************************************************** // //! Gets the current I2C module status. //! //! \param base is the base address of the I2C instance used. //! //! This function returns the status for the I2C module. //! //! \return The current module status, enumerated as a bit field of //! - \b I2C_STS_ARB_LOST - Arbitration-lost //! - \b I2C_STS_NO_ACK - No-acknowledgment (NACK) //! - \b I2C_STS_REG_ACCESS_RDY - Register-access-ready (ARDY) //! - \b I2C_STS_RX_DATA_RDY - Receive-data-ready //! - \b I2C_STS_TX_DATA_RDY - Transmit-data-ready //! - \b I2C_STS_STOP_CONDITION - Stop condition detected //! - \b I2C_STS_ADDR_ZERO - Address of all zeros detected //! - \b I2C_STS_ADDR_TARGET - Addressed as Target //! - \b I2C_STS_TX_EMPTY - Transmit shift register empty //! - \b I2C_STS_RX_FULL - Receive shift register full //! - \b I2C_STS_BUS_BUSY - Bus busy, wait for STOP or reset //! - \b I2C_STS_NACK_SENT - NACK was sent //! - \b I2C_STS_TARGET_DIR- Addressed as Target transmitter // //***************************************************************************** static inline uint16_t I2C_getStatus(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 679); } } while((_Bool)0); // // Return contents of the status register // return((*((volatile uint16_t *)(base + 0x2U)))); } //***************************************************************************** // //! Clears I2C status flags. //! //! \param base is the base address of the I2C instance used. //! \param stsFlags is a bit mask of the status flags to be cleared. //! //! This function clears the specified I2C status flags. The \e stsFlags //! parameter is the logical OR of the following values: //! - \b I2C_STS_ARB_LOST //! - \b I2C_STS_NO_ACK, //! - \b I2C_STS_REG_ACCESS_RDY //! - \b I2C_STS_RX_DATA_RDY //! - \b I2C_STS_STOP_CONDITION //! - \b I2C_STS_NACK_SENT //! - \b I2C_STS_TARGET_DIR //! //! \note Note that some of the status flags returned by I2C_getStatus() cannot //! be cleared by this function. Some may only be cleared by hardware or a //! reset of the I2C module. //! //! \return None. // //***************************************************************************** static inline void I2C_clearStatus(uint32_t base, uint16_t stsFlags) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 717); } } while((_Bool)0); // // Write to the status registers to clear them. // (*((volatile uint16_t *)(base + 0x2U))) = stsFlags; } //***************************************************************************** // //! Controls the state of the I2C module. //! //! \param base is the base address of the I2C instance used. //! \param config is the command to be issued to the I2C module. //! //! This function is used to control the state of the controller and target send and //! receive operations. The \e config is a logical OR of the following options. //! //! One of the following four options: //! - \b I2C_CONTROLLER_SEND_MODE - Controller-transmitter mode //! - \b I2C_CONTROLLER_RECEIVE_MODE - Controller-receiver mode //! - \b I2C_TARGET_SEND_MODE - Target-transmitter mode //! - \b I2C_TARGET_RECEIVE_MODE - Target-receiver mode //! //! Any of the following: //! - \b I2C_REPEAT_MODE - Sends data until stop bit is set, ignores data count //! - \b I2C_START_BYTE_MODE - Use start byte mode //! - \b I2C_FREE_DATA_FORMAT - Use free data format, transfers have no address //! //! \return None. // //***************************************************************************** static inline void I2C_setConfig(uint32_t base, uint16_t config) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 755); } } while((_Bool)0); // // Write the selected options to the mode register. // (*((volatile uint16_t *)(base + 0x9U))) = ((*((volatile uint16_t *)(base + 0x9U))) & ~(0x400U | 0x200U | 0x80U | 0x10U | 0x8U)) | config; } //***************************************************************************** // //! Sets the data byte bit count the I2C module. //! //! \param base is the base address of the I2C instance used. //! \param size is the number of bits per data byte. //! //! The \e size parameter is a value I2C_BITCOUNT_x where x is the number of //! bits per data byte. The default and maximum size is 8 bits. //! //! \return None. // //***************************************************************************** static inline void I2C_setBitCount(uint32_t base, I2C_BitCount size) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 784); } } while((_Bool)0); // // Write the selected options to the mode register. // (*((volatile uint16_t *)(base + 0x9U))) = ((*((volatile uint16_t *)(base + 0x9U))) & ~0x7U) | (uint16_t)size; } //***************************************************************************** // //! Issues an I2C START condition. //! //! \param base is the base address of the I2C instance used. //! //! This function causes the I2C module to generate a start condition. This //! function is only valid when the I2C module specified by the \b base //! parameter is a controller. //! //! \return None. // //***************************************************************************** static inline void I2C_sendStartCondition(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 812); } } while((_Bool)0); // // Set the START condition bit. // (*((volatile uint16_t *)(base + 0x9U))) |= 0x2000U; } //***************************************************************************** // //! Issues an I2C STOP condition. //! //! \param base is the base address of the I2C instance used. //! //! This function causes the I2C module to generate a stop condition. This //! function is only valid when the I2C module specified by the \b base //! parameter is a controller. //! //! To check on the status of the STOP condition, I2C_getStopConditionStatus() //! can be used. //! //! \return None. // //***************************************************************************** static inline void I2C_sendStopCondition(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 842); } } while((_Bool)0); // // Set the STOP condition bit. // (*((volatile uint16_t *)(base + 0x9U))) |= 0x800U; } //***************************************************************************** // //! Issues a no-acknowledge (NACK) bit. //! //! \param base is the base address of the I2C instance used. //! //! This function causes the I2C module to generate a NACK bit. This is only //! applicable when the I2C module is acting as a receiver. //! //! \return None. // //***************************************************************************** static inline void I2C_sendNACK(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 868); } } while((_Bool)0); // // Set the NACK mode bit. // (*((volatile uint16_t *)(base + 0x9U))) |= 0x8000U; } //***************************************************************************** // //! Receives a byte that has been sent to the I2C. //! //! \param base is the base address of the I2C instance used. //! //! This function reads a byte of data from the I2C Data Receive Register. //! //! \return Returns the byte received from by the I2C cast as an uint16_t. // //***************************************************************************** static inline uint16_t I2C_getData(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 893); } } while((_Bool)0); // // Return the contents of the receive register. // return((*((volatile uint16_t *)(base + 0x6U)))); } //***************************************************************************** // //! Transmits a byte from the I2C. //! //! \param base is the base address of the I2C instance used. //! \param data is the data to be transmitted from the I2C Controller. //! //! This function places the supplied data into I2C Data Transmit Register. //! //! \return None. // //***************************************************************************** static inline void I2C_putData(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 919); } } while((_Bool)0); // // Place the data into the transmit register. // (*((volatile uint16_t *)(base + 0x8U))) = data; } //***************************************************************************** // //! Get stop condition status. //! //! \param base is the base address of the I2C instance used. //! //! This function reads and returns the stop condition bit status. //! //! \return Returns \b true if the STP bit has been set by the device to //! generate a stop condition when the internal data counter of the I2C module //! has reached 0. Returns \b false when the STP bit is zero. This bit is //! automatically cleared after the stop condition has been generated. // //***************************************************************************** static inline _Bool I2C_getStopConditionStatus(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 947); } } while((_Bool)0); // // Check the stop condition bit and return appropriately. // return(((*((volatile uint16_t *)(base + 0x9U))) & 0x800U) != 0U); } //***************************************************************************** // //! Set number of bytes to be to transfer or receive when repeat mode is off. //! //! \param base is the base address of the I2C instance used. //! \param count is the value to be put in the I2C data count register. //! //! This function sets the number of bytes to transfer or receive when repeat //! mode is off. //! //! \return None. // //***************************************************************************** static inline void I2C_setDataCount(uint32_t base, uint16_t count) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 974); } } while((_Bool)0); // // Write the count value to the appropriate register. // (*((volatile uint16_t *)(base + 0x5U))) = count; } //***************************************************************************** // //! Sets the addressing mode to either 7-bit or 10-bit. //! //! \param base is the base address of the I2C instance used. //! \param mode is the address mode, 7-bit or 10-bit. //! //! This function configures the I2C module for either a 7-bit address //! (default) or a 10-bit address. The \e mode parameter configures the address //! length to 10 bits when its value is \b I2C_ADDR_MODE_10BITS and 7 bits when //! \b I2C_ADDR_MODE_7BITS. //! //! \return None. // //***************************************************************************** static inline void I2C_setAddressMode(uint32_t base, I2C_AddressMode mode) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 1003); } } while((_Bool)0); // // Write the appropriate value to the address expansion bit. // (*((volatile uint16_t *)(base + 0x9U))) = ((*((volatile uint16_t *)(base + 0x9U))) & ~0x100U) | (uint16_t)mode; } //***************************************************************************** // //! Sets I2C emulation mode. //! //! \param base is the base address of the I2C instance used. //! \param mode is the emulation mode. //! //! This function sets the behavior of the I2C operation when an emulation //! suspend occurs. The \e mode parameter can be one of the following: //! //! - \b I2C_EMULATION_STOP_SCL_LOW - If SCL is low when the breakpoint occurs, //! the I2C module stops immediately. If SCL is high, the I2C module waits //! until SCL becomes low and then stops. //! - \b I2C_EMULATION_FREE_RUN - I2C operation continues regardless of a //! the suspend. //! //! \return None. // //***************************************************************************** static inline void I2C_setEmulationMode(uint32_t base, I2C_EmulationMode mode) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 1037); } } while((_Bool)0); // // Write the desired emulation mode to the register. // (*((volatile uint16_t *)(base + 0x9U))) = ((*((volatile uint16_t *)(base + 0x9U))) & ~0x4000U) | (uint16_t)mode; } //***************************************************************************** // //! Enables I2C loopback mode. //! //! \param base is the base address of the I2C instance used. //! //! This function enables loopback mode. This mode is only valid during controller //! mode and is helpful during device testing as it causes data transmitted out //! of the data transmit register to be received in data receive register. //! //! \return None. // //***************************************************************************** static inline void I2C_enableLoopback(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 1065); } } while((_Bool)0); // // Set the bit that enables loopback mode. // (*((volatile uint16_t *)(base + 0x9U))) |= 0x40U; } //***************************************************************************** // //! Disables I2C loopback mode. //! //! \param base is the base address of the I2C instance used. //! //! This function disables loopback mode. Loopback mode is disabled by default //! after reset. //! //! \return None. // //***************************************************************************** static inline void I2C_disableLoopback(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 1091); } } while((_Bool)0); // // Clear the bit that enables loopback mode. // (*((volatile uint16_t *)(base + 0x9U))) &= ~0x40U; } //***************************************************************************** // //! Returns the current I2C interrupt source. //! //! \param base is the base address of the I2C instance used. //! //! This function returns the event that generated an I2C basic (non-FIFO) //! interrupt. The possible sources are the following: //! - \b I2C_INTSRC_NONE //! - \b I2C_INTSRC_ARB_LOST //! - \b I2C_INTSRC_NO_ACK //! - \b I2C_INTSRC_REG_ACCESS_RDY //! - \b I2C_INTSRC_RX_DATA_RDY //! - \b I2C_INTSRC_TX_DATA_RDY //! - \b I2C_INTSRC_STOP_CONDITION //! - \b I2C_INTSRC_ADDR_TARGET //! //! Calling this function will result in hardware automatically clearing the //! current interrupt code and if ready, loading the next pending enabled //! interrupt. It will also clear the corresponding interrupt flag if the //! source is \b I2C_INTSRC_ARB_LOST, \b I2C_INTSRC_NO_ACK, or //! \b I2C_INTSRC_STOP_CONDITION. //! //! \note Note that this function differs from I2C_getInterruptStatus() in that //! it returns a single interrupt source. I2C_getInterruptSource() will return //! the status of all interrupt flags possible, including the flags that aren't //! necessarily enabled to generate interrupts. //! //! \return None. // //***************************************************************************** static inline I2C_InterruptSource I2C_getInterruptSource(uint32_t base) { // // Check the arguments. // do { if(!(I2C_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/i2c.h", 1136); } } while((_Bool)0); // // Return the interrupt source value // return((I2C_InterruptSource)((*((volatile uint16_t *)(base + 0xAU))) & 0x7U)); } //***************************************************************************** // //! Initializes the I2C Controller. //! //! \param base is the base address of the I2C instance used. //! \param sysclkHz is the rate of the clock supplied to the I2C module //! (SYSCLK) in Hz. //! \param bitRate is the rate of the controller clock signal, SCL. //! \param dutyCycle is duty cycle of the SCL signal. //! //! This function initializes operation of the I2C Controller by configuring the //! bus speed for the controller. Note that the I2C module \b must be put into //! reset before calling this function. You can do this with the function //! I2C_disableModule(). //! //! A programmable prescaler in the I2C module divides down the input clock //! (rate specified by \e sysclkHz) to produce the module clock (calculated to //! be around 10 MHz in this function). That clock is then divided down further //! to configure the SCL signal to run at the rate specified by \e bitRate. The //! \e dutyCycle parameter determines the percentage of time high and time low //! on the clock signal. The valid values are \b I2C_DUTYCYCLE_33 for 33% and //! \b I2C_DUTYCYCLE_50 for 50%. //! //! The peripheral clock is the system clock. This value is returned by //! SysCtl_getClock(), or it can be explicitly hard coded if it is //! constant and known (to save the code/execution overhead of a call to //! SysCtl_getClock()). //! //! \return None. // //***************************************************************************** extern void I2C_initController(uint32_t base, uint32_t sysclkHz, uint32_t bitRate, I2C_DutyCycle dutyCycle); //***************************************************************************** // //! Initializes the I2C Controller. //! //! \param base is the base address of the I2C instance used. //! \param sysclkHz is the rate of the clock supplied to the I2C module //! (SYSCLK) in Hz. //! \param bitRate is the rate of the controller clock signal, SCL. //! \param dutyCycle is duty cycle of the SCL signal. //! \param moduleFrequency is the module clock used by I2C module //! //! This function initializes operation of the I2C Controller by configuring the //! bus speed for the controller. Note that the I2C module \b must be put into //! reset before calling this function. You can do this with the function //! I2C_disableModule(). //! //! A programmable prescaler in the I2C module divides down the input clock //! (rate specified by \e sysclkHz) to produce the module clock (calculated to //! be around 10 MHz in this function). That clock is then divided down further //! to configure the SCL signal to run at the rate specified by \e bitRate. The //! \e dutyCycle parameter determines the percentage of time high and time low //! on the clock signal. The valid values are \b I2C_DUTYCYCLE_33 for 33% and //! \b I2C_DUTYCYCLE_50 for 50%. //! //! The peripheral clock is the system clock. This value is returned by //! SysCtl_getClock(), or it can be explicitly hard coded if it is //! constant and known (to save the code/execution overhead of a call to //! SysCtl_getClock()). //! //! \return None. // //***************************************************************************** extern void I2C_initControllerModuleFrequency(uint32_t base, uint32_t sysclkHz, uint32_t bitRate, I2C_DutyCycle dutyCycle, uint32_t moduleFrequency); //***************************************************************************** // //! Enables I2C interrupt sources. //! //! \param base is the base address of the I2C instance used. //! \param intFlags is the bit mask of the interrupt sources to be enabled. //! //! This function enables the indicated I2C Controller interrupt sources. Only the //! sources that are enabled can be reflected to the processor interrupt. //! Disabled sources have no effect on the processor. //! //! The \e intFlags parameter is the logical OR of any of the following: //! //! - \b I2C_INT_ARB_LOST - Arbitration-lost interrupt //! - \b I2C_INT_NO_ACK - No-acknowledgment (NACK) interrupt //! - \b I2C_INT_REG_ACCESS_RDY - Register-access-ready interrupt //! - \b I2C_INT_RX_DATA_RDY - Receive-data-ready interrupt //! - \b I2C_INT_TX_DATA_RDY - Transmit-data-ready interrupt //! - \b I2C_INT_STOP_CONDITION - Stop condition detected //! - \b I2C_INT_ADDR_TARGET - Addressed as target interrupt //! - \b I2C_INT_RXFF - RX FIFO level interrupt //! - \b I2C_INT_TXFF - TX FIFO level interrupt //! //! \note \b I2C_INT_RXFF and \b I2C_INT_TXFF are associated with the I2C FIFO //! interrupt vector. All others are associated with the I2C basic interrupt. //! //! \return None. // //***************************************************************************** extern void I2C_enableInterrupt(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Disables I2C interrupt sources. //! //! \param base is the base address of the I2C instance used. //! \param intFlags is the bit mask of the interrupt sources to be disabled. //! //! This function disables the indicated I2C Target interrupt sources. Only //! the sources that are enabled can be reflected to the processor interrupt. //! Disabled sources have no effect on the processor. //! //! The \e intFlags parameter has the same definition as the \e intFlags //! parameter to I2C_enableInterrupt(). //! //! \return None. // //***************************************************************************** extern void I2C_disableInterrupt(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Gets the current I2C interrupt status. //! //! \param base is the base address of the I2C instance used. //! //! This function returns the interrupt status for the I2C module. //! //! \return The current interrupt status, enumerated as a bit field of //! - \b I2C_INT_ARB_LOST //! - \b I2C_INT_NO_ACK //! - \b I2C_INT_REG_ACCESS_RDY //! - \b I2C_INT_RX_DATA_RDY //! - \b I2C_INT_TX_DATA_RDY //! - \b I2C_INT_STOP_CONDITION //! - \b I2C_INT_ADDR_TARGET //! - \b I2C_INT_RXFF //! - \b I2C_INT_TXFF //! //! \note This function will only return the status flags associated with //! interrupts. However, a flag may be set even if its corresponding interrupt //! is disabled. // //***************************************************************************** extern uint32_t I2C_getInterruptStatus(uint32_t base); //***************************************************************************** // //! Clears I2C interrupt sources. //! //! \param base is the base address of the I2C instance used. //! \param intFlags is a bit mask of the interrupt sources to be cleared. //! //! The specified I2C interrupt sources are cleared, so that they no longer //! assert. This function must be called in the interrupt handler to keep the //! interrupt from being triggered again immediately upon exit. //! //! The \e intFlags parameter has the same definition as the \e intFlags //! parameter to I2C_enableInterrupt(). //! //! \note \b I2C_INT_RXFF and \b I2C_INT_TXFF are associated with the I2C FIFO //! interrupt vector. All others are associated with the I2C basic interrupt. //! //! \note Also note that some of the status flags returned by //! I2C_getInterruptStatus() cannot be cleared by this function. Some may only //! be cleared by hardware or a reset of the I2C module. //! //! \return None. // //***************************************************************************** extern void I2C_clearInterruptStatus(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Configures I2C Module Clock Frequency //! //! \param base is the base address of the I2C instance used. //! \param sysclkHz is the rate of the clock supplied to the I2C module //! (SYSCLK) in Hz. //! //! This function configures I2C module clock frequency by initializing //! prescale register based on SYSCLK frequency. //! Note that the I2C module \b must be put into //! reset before calling this function. You can do this with the function //! I2C_disableModule(). //! //! \return None. // //***************************************************************************** extern void I2C_configureModuleFrequency(uint32_t base, uint32_t sysclkHz); //***************************************************************************** // //! Configures I2C Module Clock Frequency with a given module clock //! //! \param base is the base address of the I2C instance used. //! \param sysclkHz is the rate of the clock supplied to the I2C module //! (SYSCLK) in Hz. //! \param moduleFrequency is the rate of the module clock used by I2C module //! This function configures I2C module clock frequency by initializing //! prescale register based on SYSCLK frequency. //! Note that the I2C module \b must be put into //! reset before calling this function. You can do this with the function //! I2C_disableModule(). //! //! \return None. // //***************************************************************************** extern void I2C_configureModuleClockFrequency(uint32_t base, uint32_t sysclkHz, uint32_t moduleFrequency); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: ipc.h // // TITLE: C28x IPC driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup ipc_api IPC //! \brief This module is used for inter-processor communications. //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_ipc.h // // TITLE: Definitions for the IPC registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // The following are defines for the IPC register offsets // //***************************************************************************** // (acknowledge) register // register // register // register // Register // Register // Register // Data Register // Register // Register // Register // Data Register // Register // Register //***************************************************************************** // // The following are defines for the bit fields in the IPCACK register // //***************************************************************************** // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement // Acknowledgement //***************************************************************************** // // The following are defines for the bit fields in the IPCSTS register // //***************************************************************************** //***************************************************************************** // // The following are defines for the bit fields in the IPCSET register // //***************************************************************************** //***************************************************************************** // // The following are defines for the bit fields in the IPCCLR register // //***************************************************************************** //***************************************************************************** // // The following are defines for the bit fields in the IPCFLG register // //***************************************************************************** //***************************************************************************** // // Defines for the APIs // //***************************************************************************** //***************************************************************************** // // Driver configuration macros // //***************************************************************************** // // Number of IPC messages in circular buffer (must be interval of 2) // // // Number of IPC interrupts using circular buffer (must be same number on both // CPUs) // //***************************************************************************** // // Values that can be passed as parameter flags in all the IPC API functions. // //***************************************************************************** //***************************************************************************** // // Values that can be passed as parameter ipcInt in // IPC_registerInterrupt and IPC_unregisterInterrupt functions. // Please refer to the datasheet for the actual number of interrupts available // for each IPC instance // //***************************************************************************** //***************************************************************************** // // Values that can be passed as parameter addrCorrEnable in // IPC_sendCommand, IPC_readCommand, IPC_sendMessageToQueue and // IPC_readMessageFromQueue functions. // //***************************************************************************** //***************************************************************************** // // Values that can be passed as parameter block in // IPC_sendMessageToQueue and IPC_readMessageFromQueue functions. // //***************************************************************************** //***************************************************************************** // // Internal macros used for message queue implementation // //***************************************************************************** //***************************************************************************** // // Enums for the APIs // //***************************************************************************** //***************************************************************************** // //! Values that can be passed as parameter \e ipcType in all the driver //! functions // //***************************************************************************** typedef enum { IPC_CPU1_L_CPU2_R, //!< CPU1 - Local core, CPU2 - Remote core IPC_CPU2_L_CPU1_R, //!< CPU2 - Local core, CPU1 - Remote core IPC_TOTAL_NUM }IPC_Type_t; //***************************************************************************** // // Internal structs for register and messaage queue accesses // //***************************************************************************** typedef struct { uint32_t IPC_ACK; uint32_t IPC_STS; uint32_t IPC_SET; uint32_t IPC_CLR; uint32_t IPC_FLG; uint32_t IPC_RSVDREG; uint32_t IPC_COUNTERL; uint32_t IPC_COUNTERH; }IPC_Flag_Ctr_Reg_t; typedef struct { uint32_t IPC_SENDCOM; uint32_t IPC_SENDADDR; uint32_t IPC_SENDDATA; uint32_t IPC_REMOTEREPLY; }IPC_SendCmd_Reg_t; typedef struct { uint32_t IPC_RECVCOM; uint32_t IPC_RECVADDR; uint32_t IPC_RECVDATA; uint32_t IPC_LOCALREPLY; }IPC_RecvCmd_Reg_t; typedef struct { uint32_t IPC_BOOTSTS; uint32_t IPC_BOOTMODE; }IPC_Boot_Pump_Reg_t; typedef struct { uint32_t command; uint32_t address; uint32_t dataw1; uint32_t dataw2; }IPC_Message_t; typedef struct { IPC_Message_t Buffer[4U][4U]; uint16_t PutWriteIndex[4U]; uint16_t GetReadIndex[4U]; }IPC_PutBuffer_t; typedef struct { IPC_Message_t Buffer[4U][4U]; uint16_t GetWriteIndex[4U]; uint16_t PutReadIndex[4U]; }IPC_GetBuffer_t; //***************************************************************************** // // Internal struct used to store the required information regarding an IPC // instance // //***************************************************************************** typedef struct { volatile IPC_Flag_Ctr_Reg_t *IPC_Flag_Ctr_Reg; volatile IPC_SendCmd_Reg_t *IPC_SendCmd_Reg; volatile IPC_RecvCmd_Reg_t *IPC_RecvCmd_Reg; volatile IPC_Boot_Pump_Reg_t *IPC_Boot_Pump_Reg; uint32_t IPC_IntNum[8U]; uint32_t IPC_MsgRam_LtoR; uint32_t IPC_MsgRam_RtoL; uint32_t IPC_Offset_Corr; IPC_PutBuffer_t *IPC_PutBuffer; IPC_GetBuffer_t *IPC_GetBuffer; }IPC_Instance_t; extern const IPC_Instance_t IPC_Instance[IPC_TOTAL_NUM]; //***************************************************************************** // // A structure that defines an IPC message queue. These // fields are used by the IPC drivers, and normally it is not necessary for // user software to directly read or write fields in the table. // //***************************************************************************** typedef struct { IPC_Message_t * PutBuffer; uint32_t PutFlag; uint16_t * PutWriteIndex; uint16_t * PutReadIndex; IPC_Message_t * GetBuffer; uint16_t * GetWriteIndex; uint16_t * GetReadIndex; } IPC_MessageQueue_t; //***************************************************************************** // // API Function prototypes // //***************************************************************************** //***************************************************************************** // //! Local core sets Local to Remote IPC Flag //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flags is the IPC flag mask for the flags being set //! //! This function will allow the Local core system to set the designated IPC //! flags to send to the Remote core system. The \e flags parameter can be any //! of the IPC flag values: \b IPC_FLAG0 - \b IPC_FLAG31. //! //! \return None. // //***************************************************************************** static inline void IPC_setFlagLtoR(IPC_Type_t ipcType, uint32_t flags) { IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_SET = flags; } //***************************************************************************** // //! Local core clears Local to Remote IPC Flag //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flags is the IPC flag mask for the flags being cleared //! //! This function will allow the Local core system to clear the designated IPC //! flags sent to the Remote core system. The \e flags parameter can be any //! of the IPC flag values: \b IPC_FLAG0 - \b IPC_FLAG31. //! //! \return None. // //***************************************************************************** static inline void IPC_clearFlagLtoR(IPC_Type_t ipcType, uint32_t flags) { IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_CLR = flags; } //***************************************************************************** // //! Local core acknowledges Remote to Local IPC Flag. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flags is the IPC flag mask for the flags being acknowledged. //! //! This function will allow the Local core system to acknowledge/clear the IPC //! flag set by the Remote core system. The \e flags parameter can be any of //! the IPC flag values: \b IPC_FLAG0 - \b IPC_FLAG31. //! //! \return None. // //***************************************************************************** static inline void IPC_ackFlagRtoL(IPC_Type_t ipcType, uint32_t flags) { IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_ACK = flags; } //***************************************************************************** // //! Determines whether the given IPC flags are busy or not. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flags is the Local to Remote IPC flag masks to check the status of //! //! Allows the caller to determine whether the designated Local to Remote //! IPC flags are pending. The \e flags parameter can be any of the IPC flag //! values: \b IPC_FLAG0 - \b IPC_FLAG31. //! //! \return Returns \b true if the any of the designated IPC flags are busy //! or \b false if all the designated IPC flags are free. // //***************************************************************************** static inline _Bool IPC_isFlagBusyLtoR(IPC_Type_t ipcType, uint32_t flags) { return((IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_FLG & flags) != 0U); } //***************************************************************************** // //! Determines whether the given Remote to Local IPC flags are busy or not. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flags is the Remote to Local IPC Flag masks to check the status of //! //! Allows the caller to determine whether the designated Remote to Local //! IPC flags are pending. The \e flags parameter can be any of the IPC flag //! values: \b IPC_FLAG0 - \b IPC_FLAG31. //! //! \return Returns \b true if the any of the designated IPC flags are busy //! or \b false if all the designated IPC flags are free. // //***************************************************************************** static inline _Bool IPC_isFlagBusyRtoL(IPC_Type_t ipcType, uint32_t flags) { return((IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_STS & flags) != 0U); } //***************************************************************************** // //! Wait for the remote core to send a flag //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flag is the Remote to Local IPC flag mask to wait for //! //! Allows the caller to wait for the Remote to Local flag to be send by //! the remote core. The \e flags parameter can be any of the IPC flag //! values: \b IPC_FLAG0 - \b IPC_FLAG31. //! //! \return None // //***************************************************************************** static inline void IPC_waitForFlag(IPC_Type_t ipcType, uint32_t flag) { while((IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_STS & flag) == 0U) { } } //***************************************************************************** // //! Wait for the IPC flag to be acknowledged //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flag is the IPC flag mask for which ack is pending //! //! Allows the caller to wait for the IPC flag to be acknowledged by the //! remote core. The \e flagsparameter can be any of the IPC flag values: //! \b IPC_FLAG0 - \b IPC_FLAG31. //! //! \return None // //***************************************************************************** static inline void IPC_waitForAck(IPC_Type_t ipcType, uint32_t flag) { while((IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_FLG & flag) != 0U) { } } //***************************************************************************** // //! Synchronises the two cores //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flag is the IPC flag mask with which synchronisation is done //! //! Allows the local and remote cores to synchronise. Neither core will return //! from this function call before the other core enters it. //! //! \note Must be called with same flag mask on both the cores //! //! \return None // //***************************************************************************** static inline void IPC_sync(IPC_Type_t ipcType, uint32_t flag) { IPC_setFlagLtoR(ipcType, flag); IPC_waitForFlag(ipcType, flag); IPC_ackFlagRtoL(ipcType, flag); IPC_waitForAck(ipcType, flag); } //***************************************************************************** // //! Initialize IPC //! //! \param ipcType is the enum corresponding to the IPC instance used // //! This function initializes IPC by clearing all the flags //! //! \return None // //***************************************************************************** static inline void IPC_init(IPC_Type_t ipcType) { IPC_clearFlagLtoR(ipcType, 0xFFFFFFFFU); } //***************************************************************************** // //! Sends a command to the Remote core //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flags is the IPC flag mask for the flags to be set //! \param addrCorrEnable is the flag used to determine whether or not to //! convert the addr parameter to remote core's address space //! \param command is the 32-bit command value //! \param addr is the 32-bit address to be sent as part of command //! \param data is the 32-bit data to be sent as part of command //! //! Allows the caller to send a command to the remote core. A command consists //! of a unique command value, a 32-bit address and a 32-bit data. The function //! also sends the designated flags to the remote core. //! There may be differences in the address spaces of Local and Remote core. //! For example in case of F2838X device, the address spaces of C28x core and //! CM core are different. In case the \e addr refers to an address in the IPC //! MSG RAM, \e addrCorrEnable param may be used to correct the address mismatch //! //! The \e flags parameter can be any of the IPC flag values: \b IPC_FLAG0 - //! \b IPC_FLAG31. //! The \e addrCorrEnable parameter can take values IPC_ADDR_CORRECTION_ENABLE //! (converts the address to remote core's address space) or //! IPC_ADDR_CORRECTION_DISABLE(does not modify the addr parmeter) //! //! The application shall use the function IPC_getResponse to read the response //! sent by the remote core. //! //! \note The application is expected to wait until the the response is //! received before sending another command. //! //! \note \e addrCorrEnable parameter must be kept same on the sending and //! receiving cores //! //! \return Returns \b true if the command is sent properly and \b false if //! the designated flags were busy and hence command was not sent. // //***************************************************************************** extern _Bool IPC_sendCommand(IPC_Type_t ipcType, uint32_t flags, _Bool addrCorrEnable, uint32_t command, uint32_t addr, uint32_t data); //***************************************************************************** // //! Reads a command sent by the Remote core //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param flags is the IPC flag mask for the flags sent by the remote core //! \param addrCorrEnable is the flag used to determine whether or not to //! convert the addr parameter to remote core's address space //! \param command is the 32-bit pointer at which the command value is read to //! \param addr is the 32-bit pointer at which address value is read to //! \param data is the 32-bit pointer at which the data is read to //! //! Allows the caller to read a command sent by the remote core. A command //! consists of a unique command value, a 32-bit address and a 32-bit data. //! There may be differences in the address spaces of Local and Remote core. //! For example in case of F2838X device, the address spaces of C28x core and //! CM core are different. In case the \e addr refers to an address in the IPC //! MSG RAM, \e addrCorrEnable param may be used to correct the address mismatch //! //! The \e flags parameter can be any of the IPC flag values: \b IPC_FLAG0 - //! \b IPC_FLAG31. //! The \e addrCorrEnable parameter can take values IPC_ADDR_CORRECTION_ENABLE //! (converts the address to remote core's address space) or //! IPC_ADDR_CORRECTION_DISABLE(does not modify the addr parmeter) //! //! \note The application is expected to acknowledge the flag and send a //! response (if needed) after reading the command //! //! \note \e addrCorrEnable parameter must be kept same on the sending and //! receiving cores //! //! \return Returns \b true if the command is read properly and \b false if //! the designated flags were empty and hence command was not read. // //***************************************************************************** extern _Bool IPC_readCommand(IPC_Type_t ipcType, uint32_t flags, _Bool addrCorrEnable, uint32_t *command, uint32_t *addr, uint32_t *data); //***************************************************************************** // //! Sends the response to the command sent by remote core. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param data is the 32-bit value of the response to be sent //! //! Allows the caller to send a response to the command previously sent by the //! remote core //! //! \return None. // //***************************************************************************** static inline void IPC_sendResponse(IPC_Type_t ipcType, uint32_t data) { IPC_Instance[ipcType].IPC_RecvCmd_Reg->IPC_LOCALREPLY = data; } //***************************************************************************** // //! Reads the response from the remote core. //! //! \param ipcType is the enum corresponding to the IPC instance used //! //! Allows the caller to read the response sent by the remote core to the //! command previously sent by the local core //! //! \return the 32-bit value of the response. // //***************************************************************************** static inline uint32_t IPC_getResponse(IPC_Type_t ipcType) { return(IPC_Instance[ipcType].IPC_SendCmd_Reg->IPC_REMOTEREPLY); } //***************************************************************************** // //! Sets the BOOTMODE register. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param mode is the 32-bit value to be set //! //! Allows the caller to set the BOOTMODE register. //! //! \note This function shall be called by CPU1 only. //! //! \return None // //***************************************************************************** static inline void IPC_setBootMode(IPC_Type_t ipcType, uint32_t mode) { do { if(!(ipcType == IPC_CPU1_L_CPU2_R)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ipc.h", 639); } } while((_Bool)0); IPC_Instance[ipcType].IPC_Boot_Pump_Reg->IPC_BOOTMODE = mode; } //***************************************************************************** // //! Reads the BOOTMODE register. //! //! \param ipcType is the enum corresponding to the IPC instance used //! //! Allows the caller to read the BOOTMODE register. //! //! //! \return 32-bit value of the BOOOTMODE register // //***************************************************************************** static inline uint32_t IPC_getBootMode(IPC_Type_t ipcType) { return(IPC_Instance[ipcType].IPC_Boot_Pump_Reg->IPC_BOOTMODE); } //***************************************************************************** // //! Sets the BOOTSTS register. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param status is the 32-bit value to be set //! //! Allows the caller to set the BOOTSTS register. //! //! \note This function shall be called by CPU2 and CM only //! //! \note This function shall be called by CPU2 only. //! //! \return None. // //***************************************************************************** static inline void IPC_setBootStatus(IPC_Type_t ipcType, uint32_t status) { do { if(!(ipcType == IPC_CPU2_L_CPU1_R)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/ipc.h", 681); } } while((_Bool)0); IPC_Instance[ipcType].IPC_Boot_Pump_Reg->IPC_BOOTSTS = status; } //***************************************************************************** // //! Reads the BOOTSTS register. //! //! \param ipcType is the enum corresponding to the IPC instance used //! //! Allows the caller to set the BOOTMODE register. //! //! //! \return 32-bit value of the BOOOTSTS register // //***************************************************************************** static inline uint32_t IPC_getBootStatus(IPC_Type_t ipcType) { return(IPC_Instance[ipcType].IPC_Boot_Pump_Reg->IPC_BOOTSTS); } //***************************************************************************** // //! Reads the timestamp counter value. //! //! \param ipcType is the enum corresponding to the IPC instance used //! //! Allows the caller to read the IPC timestamp counter value. //! //! \return 64-bit counter value. // //***************************************************************************** static inline uint64_t IPC_getCounter(IPC_Type_t ipcType) { // // Get the Counter High and Low values. Read to the Counter low register // saves the value of Counter High register. // uint32_t ctrL = IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_COUNTERL; uint32_t ctrH = IPC_Instance[ipcType].IPC_Flag_Ctr_Reg->IPC_COUNTERH; // // Return the 64-bit value of the counter // return(((uint64_t)ctrH << 32) | ((uint64_t)ctrL)); } //***************************************************************************** // //! Registers an interrupt handler for IPC //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param ipcInt is the Flag number for which interrupt is being registered //! \param pfnHandler is the pointer to ISR function //! //! This function registers the handler to be called when an IPC interrupt //! occurs. This function enables the global interrupt in the interrupt //! controller. //! The \e ipcInt parameter can be any of the IPC flag values:\b IPC_INT0 - //! \b IPC_INT7. IPC_INT0 corresponds to IPC Flag 0 interrupt and so on. // //***************************************************************************** extern void IPC_registerInterrupt(IPC_Type_t ipcType, uint32_t ipcInt, void (*pfnHandler)(void)); //***************************************************************************** // //! Unregisters an interrupt handler for IPC //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param ipcInt is the Flag number for which interrupt is being unregistered //! //! This function clears the handler to be called when an IPC interrupt //! occurs. This function also masks off the interrupt in the interrupt //! controller so that the interrupt handler no longer is called. //! The \e ipcInt parameter can be any of the IPC flag values:\b IPC_INT0 - //! \b IPC_INT7. IPC_INT0 corresponds to IPC Flag 0 interrupt and so on. // //***************************************************************************** extern void IPC_unregisterInterrupt(IPC_Type_t ipcType, uint32_t ipcInt); //***************************************************************************** // //! Initializes the IPC message queue //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param msgQueue specifies the address of a \e IPC_MessageQueue_t instance //! \param ipcInt_L specifies the interrupt number on the local core used by //! the message queue . //! \param ipcInt_R specifies the interrupt number on the remote core used by //! the message queue. //! //! This function initializes the IPC message queue with circular buffer //! and index addresses for an IPC interrupt pair. The //! \e ipcInt_L and \e ipcInt_R parameters can be one of the following values: //! \b IPC_INT0, \b IPC_INT1, \b IPC_INT2, \b IPC_INT3. //! //! \note If an interrupt is currently in use by an \e IPC_MessageQueue_t //! instance, that particular interrupt should not be tied to a second //! \e IPC_MessageQueue_t instance. //! //! \note For a particular ipcInt_L - ipcInt_R pair, there must be an instance //! of IPC_MessageQueue_t defined and initialized on both the locakl and remote //! systems. //! //! \return None. // //***************************************************************************** extern void IPC_initMessageQueue(IPC_Type_t ipcType, volatile IPC_MessageQueue_t *msgQueue, uint32_t ipcInt_L, uint32_t ipcInt_R); //***************************************************************************** // //! Sends a message into the messageQueue. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param msgQueue specifies the address of a \e IPC_MessageQueue_t instance //! \param addrCorrEnable is the flag used to determine whether or not to //! convert the addr parameter to remote core's address space //! \param msg specifies the address of the \e IPC_Message_t instance to be //! sent to message queue. //! \param block specifies whether to allow function to block until the buffer //! has a free slot //! //! This function checks if there is a free slot in the message queue. If so, it //! puts the message pointed to by \e msg into the free and sets the //! appropriate IPC interrupt flag //! //! The \e addrCorrEnable parameter can take values IPC_ADDR_CORRECTION_ENABLE //! (converts the address to remote core's address space) or //! IPC_ADDR_CORRECTION_DISABLE(does not modify the addr parmeter) //! The \e block parameter can be one of the following values: //! \b IPC_BLOCKING_CALL or \b IPC_NONBLOCKING_CALL. //! //! \return \b false if the queue is full. \b true if the message is //! successfully sent. // //***************************************************************************** extern _Bool IPC_sendMessageToQueue(IPC_Type_t ipcType, volatile IPC_MessageQueue_t *msgQueue, _Bool addrCorrEnable, IPC_Message_t *msg, _Bool block); //***************************************************************************** // //! Reads a message from the messageQueue. //! //! \param ipcType is the enum corresponding to the IPC instance used //! \param msgQueue specifies the address of a \e IPC_MessageQueue_t instance //! \param addrCorrEnable is the flag used to determine whether or not to //! convert the addr parameter to remote core's address space //! \param msg specifies the address of the \e IPC_Message_t instance to which //! the message needs to be read //! \param block specifies whether to allow function to block until a message //! is available in the message queue //! //! This function checks if there is a message in the message queue. If so, it //! reads the message and writes to the address pointed to by \e msg into. //! //! The \e addrCorrEnable parameter can take values IPC_ADDR_CORRECTION_ENABLE //! (converts the address to remote core's address space) or //! IPC_ADDR_CORRECTION_DISABLE(does not modify the addr parmeter) //! The \e block parameter can be one of the following values: //! \b IPC_BLOCKING_CALL or \b IPC_NONBLOCKING_CALL. //! //! \return \b false if the queue is empty. \b true if the message successfully //! read. // //***************************************************************************** extern _Bool IPC_readMessageFromQueue(IPC_Type_t ipcType, volatile IPC_MessageQueue_t *msgQueue, _Bool addrCorrEnable, IPC_Message_t *msg, _Bool block); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: mcbsp.h // // TITLE: C28x McBSP driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup mcbsp_api McBSP //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_mcbsp.h // // TITLE: Definitions for the MCBSP registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the MCBSP register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DRR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DRR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DXR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DXR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPCR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPCR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RCR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RCR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XCR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the XCR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SRGR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SRGR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MCR2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MCR1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the MFFINT register // //************************************************************************************************* //***************************************************************************** // // Defines for the API. // //***************************************************************************** //***************************************************************************** // // Define to specify mask for setting the word and frame length in // McBSP_setTxDataSize() anf McBSP_setRxDataSize(). // //***************************************************************************** //***************************************************************************** // // Defines the values that can be returned by McBSP_getRxErrorStatus() when // there is an error in Rx. // //***************************************************************************** //***************************************************************************** // // Defines the values that can be returned by McBSP_getTxErrorStatus() when // there is an error in Tx. // //***************************************************************************** //***************************************************************************** // // Values that can be returned by McBSP_configureTxMultichannel() and // McBSP_configureRxMultichannel(). // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to McBSP_setRxSignExtension() as the \e //! mode parameters. // //***************************************************************************** typedef enum { MCBSP_RIGHT_JUSTIFY_FILL_ZERO = 0x0000U, //!< Right justify and //!< zero fill MSB. MCBSP_RIGHT_JUSTIFY_FILL_SIGN = 0x2000U, //!< Right justified sign //!< extended into MSBs. MCBSP_LEFT_JUSTIFY_FILL_ZER0 = 0x4000U //!< Left justifies LBS //!< filled with zero. }McBSP_RxSignExtensionMode; //***************************************************************************** // //! Values that can be passed to McBSP_setClockStopMode() as the \e mode //! parameter. // //***************************************************************************** typedef enum { MCBSP_CLOCK_MCBSP_MODE = 0x0000U, //!< Disables clock stop mode. MCBSP_CLOCK_SPI_MODE_NO_DELAY = 0x1000U, //!< Enables clock stop mode. MCBSP_CLOCK_SPI_MODE_DELAY = 0x1800U //!< Enables clock stop mode //!< with half cycle delay. }McBSP_ClockStopMode; //***************************************************************************** // //! Values that can be passed to McBSP_setRxInterruptSource() as the //! \e interruptSource parameter. // //***************************************************************************** typedef enum { MCBSP_RX_ISR_SOURCE_SERIAL_WORD = 0x0000U, //!> 1U) << 7U)); } //***************************************************************************** // //! Configures transmitter input clock source for sample generator. //! //! \param base is the base address of the McBSP module. //! \param srgClockSource is clock source for the sample generator. //! //! This functions sets the clock source for the sample rate generator. //! Valid values for \e clockSource are //! - \b MCBSP_SRG_TX_CLOCK_SOURCE_LSPCLK for LSPCLK. //! - \b MCBSP_SRG_TX_CLOCK_SOURCE_MCLKR_PIN for external clock at MCLKR pin. //! MCLKX pin will be an output driven by sample rate generator. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxSRGClockSource(uint32_t base, const McBSP_SRGTxClockSource srgClockSource) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 1840); } } while((_Bool)0); // // Set or clear CLKSM bit. // (*((volatile uint16_t *)(base + 0xAU))) = (((*((volatile uint16_t *)(base + 0xAU))) & ~0x2000U) | ((uint16_t)((uint16_t)srgClockSource & 0x1U) << 13U)); // // Set or clear SCLKME bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x80U) | (uint16_t)(((uint16_t)srgClockSource >> 1U) << 7U)); } //***************************************************************************** // //! Sets the mode for transmitter internal frame sync signal. //! //! \param base is the base address of the McBSP module. //! \param syncMode is the frame sync mode. //! //! This function sets the frame sync signal generation mode. The signal can be //! generated based on clock divider as set in McBSP_setFrameSyncPulsePeriod() //! function or when data is transferred from DXR registers to XSR registers. //! Valid input for syncMode are: //! //! - \b MCBSP_TX_INTERNAL_FRAME_SYNC_DATA - frame sync signal is //! generated when data is transferred from //! DXR registers to XSR registers. //! - \b MCBSP_TX_INTERNAL_FRAME_SYNC_SRG - frame sync signal is //! generated based on the clock counter //! value as defined in //! McBSP_setFrameSyncPulsePeriod() //! function. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxInternalFrameSyncSource(uint32_t base, const McBSP_TxInternalFrameSyncSource syncMode) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 1887); } } while((_Bool)0); // // Set or clear FSGM bit. // (*((volatile uint16_t *)(base + 0xAU))) = (((*((volatile uint16_t *)(base + 0xAU))) & ~0x1000U) | (uint16_t)syncMode); } //***************************************************************************** // //! Set Multichannel receiver partitions. //! //! \param base is the base address of the McBSP module. //! \param partition is the number of partitions. //! //! This function sets the partitions for Multichannel receiver. Valid values //! for partition are \b MCBSP_MULTICHANNEL_TWO_PARTITION or \b //! MCBSP_MULTICHANNEL_EIGHT_PARTITION for 2 and 8 partitions respectively. //! //! \return None. // //***************************************************************************** static inline void McBSP_setRxMultichannelPartition(uint32_t base, const McBSP_MultichannelPartition partition) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 1917); } } while((_Bool)0); // // Set or Clear RMCME bit. // (*((volatile uint16_t *)(base + 0xDU))) = (((*((volatile uint16_t *)(base + 0xDU))) & ~0x200U) | (uint16_t)partition); } //***************************************************************************** // //! Sets block to receiver in two partition configuration. //! //! \param base is the base address of the McBSP module. //! \param block is the block to assign to the partition. //! //! This function assigns the block the user provides to the appropriate //! receiver partition. //! If user sets the value of block to 0,2,4 or 6 the API will assign the //! blocks to partition A. If values 1,3,5,or 7 are set to block, then //! the API assigns the block to partition B. //! //! \note This function should be used with the two partition configuration //! only and not with eight partition configuration. //! //! \return None. // //***************************************************************************** static inline void McBSP_setRxTwoPartitionBlock(uint32_t base, const McBSP_PartitionBlock block) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 1951); } } while((_Bool)0); // //Check the block value if it is 0,2,4,6 or 1,3,5,7. // if(((uint16_t)block == 0U) || ((uint16_t)block == 2U) || ((uint16_t)block == 4U) || ((uint16_t)block == 6U)) { // // write to RPABLK bits. // (*((volatile uint16_t *)(base + 0xDU))) = (((*((volatile uint16_t *)(base + 0xDU))) & ~0x60U) | (uint16_t)(((uint16_t)block >> 1U)<< 5U)); } else { // // write to RPBBLK bits. // (*((volatile uint16_t *)(base + 0xDU))) = (((*((volatile uint16_t *)(base + 0xDU))) & ~0x180U) | (uint16_t)(((uint16_t)block >> 1U)<< 7U)); } } //***************************************************************************** // //! Returns the current active receiver block number. //! //! \param base is the base address of the McBSP module. //! //! This function returns the current active receiver block involved in McBSP //! reception. //! //! \return Active block in McBSP reception. Returned values range from 0 to 7 //! representing the respective active block number . // //***************************************************************************** static inline uint16_t McBSP_getRxActiveBlock(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 1998); } } while((_Bool)0); // // return RCBLK bits. // return(((*((volatile uint16_t *)(base + 0xDU))) & 0x1CU) >> 2U); } //***************************************************************************** // //! Configure channel selection mode for receiver. //! //! \param base is the base address of the McBSP module. //! \param channelMode is the channel selection mode. //! //! This function configures the channel selection mode. The following are //! valid values for channelMode: //! //! - \b MCBSP_ALL_RX_CHANNELS_ENABLED - enables all channels. //! - \b MCBSP_RX_CHANNEL_SELECTION_ENABLED - lets the user enable desired //! channels by using McBSP_enableRxChannel(). //! //! \return None. // //***************************************************************************** static inline void McBSP_setRxChannelMode(uint32_t base, const McBSP_RxChannelMode channelMode) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2030); } } while((_Bool)0); // // Set or clear RMCM bit. // (*((volatile uint16_t *)(base + 0xDU))) = (((*((volatile uint16_t *)(base + 0xDU))) & ~0x1U) | (uint16_t)channelMode); } //***************************************************************************** // //! Set Multichannel transmitter partitions. //! //! \param base is the base address of the McBSP module. //! \param partition is the number of partitions. //! //! This function sets the partitions for Multichannel transmitter. Valid //! values for partition are \b MCBSP_MULTICHANNEL_TWO_PARTITION or \b //! MCBSP_MULTICHANNEL_EIGHT_PARTITION for 2 and 8 partitions respectively. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxMultichannelPartition(uint32_t base, const McBSP_MultichannelPartition partition) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2060); } } while((_Bool)0); // // Set or clear XMCME bit. // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~0x200U) | (uint16_t)partition); } //***************************************************************************** // //! Sets block to transmitter in two partition configuration. //! //! \param base is the base address of the McBSP module. //! \param block is the block to assign to the partition. //! //! This function assigns the block the user provides to the appropriate //! transmitter partition. //! If user sets the value of block to 0,2,4 or 6 the API will assign the //! blocks to partition A. If values 1,3,5,or 7 are set to block, then //! the API assigns the block to partition B. //! //! \note This function should be used with the two partition configuration //! only and not with eight partition configuration. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxTwoPartitionBlock(uint32_t base, const McBSP_PartitionBlock block) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2094); } } while((_Bool)0); if(((uint16_t)block == 0U) || ((uint16_t)block == 2U) || ((uint16_t)block == 4U) || ((uint16_t)block == 6U)) { // // write to XPABLK bits. // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~0x60U) | ((uint16_t)((uint16_t)block >> 1U)<< 5U)); } else { // // write to XPBBLK bits. // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~0x180U) | ((uint16_t)((uint16_t)block >> 1U)<< 7U)); } } //***************************************************************************** // //! Returns the current active transmitter block number. //! //! \param base is the base address of the McBSP module. //! //! This function returns the current active transmitter block involved in //! McBSP transmission. //! //! \return Active block in McBSP transmission. Returned values range from //! 0 to 7 representing the respective active block number. // //***************************************************************************** static inline uint16_t McBSP_getTxActiveBlock(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2138); } } while((_Bool)0); // // return XCBLK bits. // return(((*((volatile uint16_t *)(base + 0xCU))) & 0x1CU) >> 2U); } //***************************************************************************** // //! Configure channel selection mode for transmitter. //! //! \param base is the base address of the McBSP module. //! \param channelMode is the channel selection mode. //! //! This function configures the channel selection mode. The following are //! valid values for channelMode: //! //! - \b MCBSP_ALL_TX_CHANNELS_ENABLED - enables and unmasks all channels //! - \b MCBSP_TX_CHANNEL_SELECTION_ENABLED - lets the user enable and unmask //! desired channels by using McBSP_enableTxChannel() //! - \b MCBSP_ENABLE_MASKED_TX_CHANNEL_SELECTION - All channels enables but //! until enabled by McBSP_enableTxChannel() //! - \b MCBSP_SYMMERTIC_RX_TX_SELECTION - Symmetric transmission and //! reception. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxChannelMode(uint32_t base, const McBSP_TxChannelMode channelMode) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2175); } } while((_Bool)0); // // Set values to the XMCM bits. // (*((volatile uint16_t *)(base + 0xCU))) = (((*((volatile uint16_t *)(base + 0xCU))) & ~0x3U) | (uint16_t)channelMode); } //***************************************************************************** // //! Select the transmitter frame sync signal source. //! //! \param base is the base address of the McBSP module. //! \param syncSource is the transmitter frame sync source. //! //! This function sets external or internal sync signal source based on the //! syncSource selection. Valid input for syncSource are: //! //! - \b MCBSP_TX_EXTERNAL_FRAME_SYNC_SOURCE - frame sync signal is supplied //! externally by pin FSX. //! - \b MCBSP_TX_INTERNAL_FRAME_SYNC_SOURCE - frame sync signal is supplied //! internally. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxFrameSyncSource(uint32_t base, const McBSP_TxFrameSyncSource syncSource) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2210); } } while((_Bool)0); // //Set or Clear the FSXM bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x800U) | (uint16_t)syncSource); } //***************************************************************************** // //! Select receiver frame sync signal source. //! //! \param base is the base address of the McBSP module. //! \param syncSource is the receiver frame sync source. //! //! This function sets external or internal sync signal source based on the //! syncSource selection. Valid input for syncSource are: //! //! - \b MCBSP_RX_EXTERNAL_FRAME_SYNC_SOURCE - frame sync signal is supplied //! externally by pin FSR. //! - \b MCBSP_RX_INTERNAL_FRAME_SYNC_SOURCE - frame sync signal is supplied //! by SRG. //! //! \return None. // //***************************************************************************** static inline void McBSP_setRxFrameSyncSource(uint32_t base, const McBSP_RxFrameSyncSource syncSource) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2244); } } while((_Bool)0); // // Set or clear FSRM bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x400U) | (uint16_t)syncSource); } //***************************************************************************** // //! Configures the Transmit clock source. //! //! \param base is the base address of the McBSP module. //! \param clockSource is clock source for the transmission pin. //! //! This function configures the clock source for the transmitter. Valid input //! for rxClockSource are: //! - \b MCBSP_INTERNAL_TX_CLOCK_SOURCE - internal clock source. SRG is the //! source. //! - \b MCBSP_EXTERNAL_TX_CLOCK_SOURCE - external clock source. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxClockSource(uint32_t base, const McBSP_TxClockSource clockSource) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2275); } } while((_Bool)0); // // Set or clear CLKXM bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x200U ) | (uint16_t)clockSource); } //***************************************************************************** // //! Configures the Receive clock source. //! //! \param base is the base address of the McBSP module. //! \param clockSource is clock source for the reception pin. //! //! This function configures the clock source for the receiver. Valid input //! for base are: //! - \b MCBSP_INTERNAL_RX_CLOCK_SOURCE - internal clock source. Sample Rate //! Generator will be used. //! - \b MCBSP_EXTERNAL_RX_CLOCK_SOURCE - external clock will drive the data. //! //! \return None. // //***************************************************************************** static inline void McBSP_setRxClockSource(uint32_t base, const McBSP_RxClockSource clockSource) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2306); } } while((_Bool)0); // // Set or clear CLKRM bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x100U) | (uint16_t)clockSource); } //***************************************************************************** // //! Sets transmitter frame sync polarity. //! //! \param base is the base address of the McBSP module. //! \param syncPolarity is the polarity of frame sync pulse. //! //! This function sets the polarity (rising or falling edge)of the frame sync //! on FSX pin. Use \b MCBSP_TX_FRAME_SYNC_POLARITY_LOW for active low //! frame sync pulse and \b MCBSP_TX_FRAME_SYNC_POLARITY_HIGH for active //! high sync pulse. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxFrameSyncPolarity(uint32_t base, const McBSP_TxFrameSyncPolarity syncPolarity) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2337); } } while((_Bool)0); // // Set or clear FSXP bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x8U) | (uint16_t)syncPolarity); } //***************************************************************************** //! Sets receiver frame sync polarity. //! //! \param base is the base address of the McBSP module. //! \param syncPolarity is the polarity of frame sync pulse. //! //! This function sets the polarity (rising or falling edge)of the frame sync //! on FSR pin. Use \b MCBSP_RX_FRAME_SYNC_POLARITY_LOW for active low //! frame sync pulse and \b MCBSP_RX_FRAME_SYNC_POLARITY_HIGH for active //! high sync pulse. //! //! \return None. // //***************************************************************************** static inline void McBSP_setRxFrameSyncPolarity(uint32_t base, const McBSP_RxFrameSyncPolarity syncPolarity) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2367); } } while((_Bool)0); // // Set or clear FSRP bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x4U) | (uint16_t)syncPolarity); } //***************************************************************************** //! Sets transmitter clock polarity when using external clock source. //! //! \param base is the base address of the McBSP module. //! \param clockPolarity is the polarity of external clock. //! //! This function sets the polarity (rising or falling edge) of the transmitter //! clock on MCLKX pin. //! Valid values for clockPolarity are: //! - \b MCBSP_TX_POLARITY_RISING_EDGE for rising edge. //! - \b MCBSP_TX_POLARITY_FALLING_EDGE for falling edge. //! //! \return None. // //***************************************************************************** static inline void McBSP_setTxClockPolarity(uint32_t base, const McBSP_TxClockPolarity clockPolarity) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2398); } } while((_Bool)0); // // Clear CLKXP bit first , then set or clear CLKXP bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x2U) | (uint16_t)clockPolarity); } //***************************************************************************** //! Sets receiver clock polarity when using external clock source. //! //! \param base is the base address of the McBSP module. //! \param clockPolarity is the polarity of external clock. //! //! This function sets the polarity (rising or falling edge) of the receiver //! clock on MCLKR pin. If external clock is used, the polarity will affect //! CLKG signal. //! Valid values for clockPolarity are: //! - \b MCBSP_RX_POLARITY_RISING_EDGE for rising edge. //! - \b MCBSP_RX_POLARITY_FALLING_EDGE for falling edge. //! //! \return None. // //***************************************************************************** static inline void McBSP_setRxClockPolarity(uint32_t base, const McBSP_RxClockPolarity clockPolarity) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2431); } } while((_Bool)0); // // Clear CLKRP bit first , then set or clear CLKRP bit. // (*((volatile uint16_t *)(base + 0x12U))) = (((*((volatile uint16_t *)(base + 0x12U))) & ~0x1U) | (uint16_t)clockPolarity); } //***************************************************************************** // //! Read 8,12 or 16 bit data word from McBSP data receive registers. //! //! \param base is the base address of the McBSP port. //! //! This function returns the data value in data receive register. //! //! \return received data. // //***************************************************************************** static inline uint16_t McBSP_read16bitData(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2458); } } while((_Bool)0); // // Read DRR1 register. // return((*((volatile uint16_t *)(base + 0x1U)))); } //***************************************************************************** // //! Read 20, 24 or 32 bit data word from McBSP data receive registers. //! //! \param base is the base address of the McBSP port. //! //! This function returns the data values in data receive registers. //! //! \return received data. // //***************************************************************************** static inline uint32_t McBSP_read32bitData(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2483); } } while((_Bool)0); // // Read DDR1 register and return DDR2:DDR1. // return((((uint32_t)(*((volatile uint16_t *)(base + 0x0U))) << 16U) | (*((volatile uint16_t *)(base + 0x1U))))); } //***************************************************************************** // //! Write 8,12 or 16 bit data word to McBSP data transmit registers. //! //! \param base is the base address of the McBSP port. //! \param data is the data to be written. //! //! This function writes 8,12 or 16 bit data to data transmit register. //! //! \return None. // //***************************************************************************** static inline void McBSP_write16bitData(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2510); } } while((_Bool)0); // // Write to DXR1 register. // (*((volatile uint16_t *)(base + 0x3U))) = data; } //***************************************************************************** // //! Write 20, 24 or 32 bit data word to McBSP data transmit registers. //! //! \param base is the base address of the McBSP port. //! \param data is the data to be written. //! //! This function writes 20, 24 or 32 bit data to data transmit registers. //! //! \return None. // //***************************************************************************** static inline void McBSP_write32bitData(uint32_t base, uint32_t data) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2536); } } while((_Bool)0); // // Write to DXR2 register first. // (*((volatile uint16_t *)(base + 0x2U))) = data >> 16U; // // Write to DXR1 register. // (*((volatile uint16_t *)(base + 0x3U))) = data & 0xFFFFU; } //***************************************************************************** // //! Return left justified for data for U Law or A Law companding. //! //! \param data is the 14 bit word. //! \param compandingType specifies the type comapnding desired. //! //! This functions returns U law or A law adjusted word. //! //! \return U law or A law left justified word. // //***************************************************************************** static inline uint16_t McBSP_getLeftJustifyData(uint16_t data, const McBSP_CompandingType compandingType) { return(data << (uint16_t)compandingType); } //***************************************************************************** // //! Enable Recieve Interrupt. //! //! \param base is the base address of the McBSP module. //! //! This function enables Recieve Interrupt on RRDY. //! //! \return None. // //***************************************************************************** static inline void McBSP_enableRxInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2586); } } while((_Bool)0); // // Set RINT ENA bit. // (*((volatile uint16_t *)(base + 0x23U))) |= 0x4U; } //***************************************************************************** // //! Disable Recieve Interrupt. //! //! \param base is the base address of the McBSP module. //! //! This function disables Recieve Interrupt on RRDY. //! //! \return None. // //***************************************************************************** static inline void McBSP_disableRxInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2611); } } while((_Bool)0); // // Clear RINT ENA bit. // (*((volatile uint16_t *)(base + 0x23U))) |= ~(0x4U); } //***************************************************************************** // //! Enable Transmit Interrupt. //! //! \param base is the base address of the McBSP module. //! //! This function enables Transmit Interrupt on XRDY. //! //! \return None. // //***************************************************************************** static inline void McBSP_enableTxInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2636); } } while((_Bool)0); // // Set XINT ENA bit. // (*((volatile uint16_t *)(base + 0x23U))) |= 0x1U; } //***************************************************************************** // //! Disable Transmit Interrupt. //! //! \param base is the base address of the McBSP module. //! //! This function disables Transmit Interrupt on XRDY. //! //! \return None. // //***************************************************************************** static inline void McBSP_disableTxInterrupt(uint32_t base) { // // Check the arguments. // do { if(!(McBSP_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/mcbsp.h", 2661); } } while((_Bool)0); // // Clear XINT ENA bit. // (*((volatile uint16_t *)(base + 0x23U))) |= ~(0x1U); } //***************************************************************************** // //! Write 8,12 or 16 bit data word to McBSP data transmit registers //! //! \param base is the base address of the McBSP port. //! \param data is the data to be written. //! //! This function sends 16 bit or less data to the transmitter buffer. //! //! \return None. //! //! \return None. // //***************************************************************************** extern void McBSP_transmit16BitDataNonBlocking(uint32_t base, uint16_t data); //***************************************************************************** // //! Write 8,12 or 16 bit data word to McBSP data transmit registers //! //! \param base is the base address of the McBSP port. //! \param data is the data to be written. //! //! This function sends 16 bit or less data to the transmitter buffer. If //! transmit buffer is not ready the function will wait until transmit buffer //! is empty. If the transmitter buffer is empty the data will be written to //! the data registers. //! //! \return None. // //***************************************************************************** extern void McBSP_transmit16BitDataBlocking(uint32_t base, uint16_t data); //***************************************************************************** // //! Write 20 , 24 or 32 bit data word to McBSP data transmit registers //! //! \param base is the base address of the McBSP port. //! \param data is the data to be written. //! //! This function sends 20 , 24 or 32 bit data to the transmitter buffer. If //! the transmitter buffer is empty the data will be written to the data //! registers. //! //! \return None. // //***************************************************************************** extern void McBSP_transmit32BitDataNonBlocking(uint32_t base, uint32_t data); //***************************************************************************** // //! Write 20 , 24 or 32 bit data word to McBSP data transmit registers //! //! \param base is the base address of the McBSP port. //! \param data is the data to be written. //! //! This function sends 20 , 24 or 32 bit data to the transmitter buffer. If //! transmit buffer is not ready the function will wait until transmit buffer //! is empty. If the transmitter buffer is empty the data will be written //! to the data registers. //! //! \return None. // //***************************************************************************** extern void McBSP_transmit32BitDataBlocking(uint32_t base, uint32_t data); //***************************************************************************** // //! Read 8,12 or 16 bit data word from McBSP data receive registers //! //! \param base is the base address of the McBSP port. //! \param receiveData is the pointer to the receive data. //! //! This function reads 8,12 or 16 bit data from the receiver buffer. //! If the receiver buffer has new data, the data will be read. //! //! \return None. // //***************************************************************************** extern void McBSP_receive16BitDataNonBlocking(uint32_t base, uint16_t *receiveData); //***************************************************************************** // //! Read 8,12 or 16 bit data word from McBSP data receive registers //! //! \param base is the base address of the McBSP port. //! \param receiveData is the pointer to the receive data. //! //! This function reads 8,12 or 16 bit data from the receiver buffer. If //! receiver buffer is not ready the function will wait until receiver buffer //! has new data. //! If the receiver buffer has new data, the data will be read. //! //! \return None. // //***************************************************************************** extern void McBSP_receive16BitDataBlocking(uint32_t base, uint16_t *receiveData); //***************************************************************************** // //! Read 20, 24 or 32 bit data word from McBSP data receive registers //! //! \param base is the base address of the McBSP port. //! \param receiveData is the pointer to the receive data. //! //! This function reads 20, 24 or 32 bit data from the receiver buffer. //! If the receiver buffer has new data, the data will be read. //! //! \return None. // //***************************************************************************** extern void McBSP_receive32BitDataNonBlocking(uint32_t base, uint32_t *receiveData); //***************************************************************************** // //! Read 20, 24 or 32 bit data word from McBSP data receive registers //! //! \param base is the base address of the McBSP port. //! \param receiveData is the pointer to the receive data. //! //! This function reads 20, 24 or 32 bit data from the receiver buffer. If //! receiver buffer is not ready the function will wait until receiver buffer //! has new data. //! If the receiver buffer has new data, the data will be read. //! //! \return None. // //***************************************************************************** extern void McBSP_receive32BitDataBlocking(uint32_t base, uint32_t *receiveData); //***************************************************************************** // //! Sets number of words per frame and bits per word for data Reception. //! //! \param base is the base address of the McBSP module. //! \param dataFrame is the data frame phase. //! \param bitsPerWord is the number of bits per word. //! \param wordsPerFrame is the number of words per frame per phase. //! //! This function sets the number of bits per word and the number of words per //! frame for the given phase. //! Valid inputs for phase are \b MCBSP_PHASE_ONE_FRAME or \b //! MCBSP_PHASE_TWO_FRAME representing the first or second frame phase //! respectively. Valid value for bitsPerWord are: //! - \b MCBSP_BITS_PER_WORD_8 8 bit word. //! - \b MCBSP_BITS_PER_WORD_12 12 bit word. //! - \b MCBSP_BITS_PER_WORD_16 16 bit word. //! - \b MCBSP_BITS_PER_WORD_20 20 bit word. //! - \b MCBSP_BITS_PER_WORD_24 24 bit word. //! - \b MCBSP_BITS_PER_WORD_32 32 bit word. //! The maximum value for wordsPerFrame is 127 (128 - 1)representing 128 words. //! //! \return None. // //***************************************************************************** extern void McBSP_setRxDataSize(uint32_t base, const McBSP_DataPhaseFrame dataFrame, const McBSP_DataBitsPerWord bitsPerWord, uint16_t wordsPerFrame); //***************************************************************************** // //! Sets number of words per frame and bits per word for data Transmission. //! //! \param base is the base address of the McBSP module. //! \param dataFrame is the data frame phase. //! \param bitsPerWord is the number of bits per word. //! \param wordsPerFrame is the number of words per frame per phase. //! //! This function sets the number of bits per word and the number of words per //! frame for the given phase. //! Valid inputs for phase are \b MCBSP_PHASE_ONE_FRAME or \b //! MCBSP_PHASE_TWO_FRAME representing single or dual phase respectively. //! Valid values for bitsPerWord are: //! - \b MCBSP_BITS_PER_WORD_8 8 bit word. //! - \b MCBSP_BITS_PER_WORD_12 12 bit word. //! - \b MCBSP_BITS_PER_WORD_16 16 bit word. //! - \b MCBSP_BITS_PER_WORD_20 20 bit word. //! - \b MCBSP_BITS_PER_WORD_24 24 bit word. //! - \b MCBSP_BITS_PER_WORD_32 32 bit word. //! The maximum value for wordsPerFrame is 127 (128 - 1)representing 128 words. //! //! \return None. // //***************************************************************************** extern void McBSP_setTxDataSize(uint32_t base, const McBSP_DataPhaseFrame dataFrame, const McBSP_DataBitsPerWord bitsPerWord, uint16_t wordsPerFrame); //***************************************************************************** // //! Disables a channel in an eight partition receiver //! //! \param base is the base address of the McBSP module. //! \param partition is the partition of the channel. //! \param channel is the receiver channel number to be enabled. //! //! This function disables the given receiver channel number for the partition //! provided. //! Valid values for partition are \b MCBSP_MULTICHANNEL_TWO_PARTITION or //! \b MCBSP_MULTICHANNEL_EIGHT_PARTITION for 2 or 8 partitions respectively. //! Valid values for channel range from 0 to 127. //! //! \return None. // //***************************************************************************** extern void McBSP_disableRxChannel(uint32_t base, const McBSP_MultichannelPartition partition, uint16_t channel); //***************************************************************************** // //! Enables a channel for eight partition receiver //! //! \param base is the base address of the McBSP module. //! \param partition is the partition of the channel. //! \param channel is the receiver channel number to be enabled. //! //! This function enables the given receiver channel number for the partition //! provided. //! Valid values for partition are \b MCBSP_MULTICHANNEL_TWO_PARTITION or //! \b MCBSP_MULTICHANNEL_EIGHT_PARTITION for 2 or 8 partitions respectively. //! Valid values for channel range from 0 to 127. //! //! \return None. // //***************************************************************************** extern void McBSP_enableRxChannel(uint32_t base, const McBSP_MultichannelPartition partition, uint16_t channel); //***************************************************************************** // //! Disables a channel in an eight partition transmitter //! //! \param base is the base address of the McBSP module. //! \param partition is the partition of the channel. //! \param channel is the transmitter channel number to be enabled. //! //! This function disables the given transmitter channel number for the //! partition provided. //! Valid values for partition are \b MCBSP_MULTICHANNEL_TWO_PARTITION or //! \b MCBSP_MULTICHANNEL_EIGHT_PARTITION for 2 or 8 partitions respectively. //! Valid values for channel range from 0 to 127. //! //! \return None. // //***************************************************************************** extern void McBSP_disableTxChannel(uint32_t base, const McBSP_MultichannelPartition partition, uint16_t channel); //***************************************************************************** // //! Enables a channel for eight partition transmitter //! //! \param base is the base address of the McBSP module. //! \param partition is the partition of the channel. //! \param channel is the transmitter channel number to be enabled. //! //! This function enables the given transmitter channel number for the //! partition provided. //! Valid values for partition are \b MCBSP_MULTICHANNEL_TWO_PARTITION or //! \b MCBSP_MULTICHANNEL_EIGHT_PARTITION for 2 or 8 partitions respectively. //! Valid values for channel range from 0 to 127. //! //! \return None. // //***************************************************************************** extern void McBSP_enableTxChannel(uint32_t base, const McBSP_MultichannelPartition partition, uint16_t channel); //***************************************************************************** // //! Configures transmitter clock //! //! \param base is the base address of the McBSP module. //! \param ptrClockParams is a pointer to a structure containing \e clock //! parameters McBSP_ClockParams. //! This function sets up the transmitter clock. The following are valid //! values and ranges for the parameters of the McBSP_TxFsyncParams. //! - \b clockSRGSyncFSR - true to sync with signal on FSR pin, //! false to ignore signal on FSR pin. //! the pulse on FSR pin. //! - \b clockSRGDivider - Maximum valid value is 255. //! - \b clockSource - MCBSP_EXTERNAL_TX_CLOCK_SOURCE or //! MCBSP_INTERNAL_TX_CLOCK_SOURCE //! - \b clockTxSRGSource - MCBSP_SRG_TX_CLOCK_SOURCE_LSPCLK or //! MCBSP_SRG_TX_CLOCK_SOURCE_MCLKR_PIN //! - \b clockMCLKXPolarity - Output polarity on MCLKX pin. //! - MCBSP_TX_POLARITY_RISING_EDGE //! - MCBSP_TX_POLARITY_FALLING_EDGE //! - \b clockMCLKRPolarity - Input polarity on MCLKR pin (if SRG is //! sourced from MCLKR pin). //! - MCBSP_RX_POLARITY_FALLING_EDGE //! - MCBSP_RX_POLARITY_RISING_EDGE //! //! \note Make sure the clock divider is such that, the McBSP clock is not //! running faster than 1/2 the speed of the source clock. //! //! \return None. // //***************************************************************************** extern void McBSP_configureTxClock(uint32_t base, const McBSP_ClockParams * ptrClockParams); //***************************************************************************** // //! Configures receiver clock //! //! \param base is the base address of the McBSP module. //! \param ptrClockParams is a pointer to a structure containing \e clock //! parameters McBSP_ClockParams. //! This function sets up the receiver clock. The following are valid //! values and ranges for the parameters of the McBSP_TxFsyncParams. //! - \b clockSRGSyncFlag - true to sync with signal on FSR pin, false to //! ignore the pulse on FSR pin. //! - \b clockSRGDivider - Maximum valid value is 255. //! - \b clockSource - MCBSP_EXTERNAL_RX_CLOCK_SOURCE or //! MCBSP_INTERNAL_RX_CLOCK_SOURCE //! - \b clockRxSRGSource - MCBSP_SRG_RX_CLOCK_SOURCE_LSPCLK or //! MCBSP_SRG_RX_CLOCK_SOURCE_MCLKX_PIN //! - \b clockMCLKRPolarity- output polarity on MCLKR pin. //! - MCBSP_RX_POLARITY_FALLING_EDGE or //! - MCBSP_RX_POLARITY_RISING_EDGE //! - \b clockMCLKXPolarity- Input polarity on MCLKX pin (if SRG is sourced //! from MCLKX pin). //! - MCBSP_TX_POLARITY_RISING_EDGE or //! - MCBSP_TX_POLARITY_FALLING_EDGE //! //! \note Make sure the clock divider is such that, the McBSP clock is not //! running faster than 1/2 the speed of the source clock. //! //! \return None. // //***************************************************************************** extern void McBSP_configureRxClock(uint32_t base, const McBSP_ClockParams * ptrClockParams); //***************************************************************************** // //! Configures transmitter frame sync. //! //! \param base is the base address of the McBSP module. //! \param ptrFsyncParams is a pointer to a structure containing \e frame sync //! parameters McBSPTxFsyncParams. //! This function sets up the transmitter frame sync. The following are valid //! values and ranges for the parameters of the McBSPTxFsyncParams. //! - \b syncSRGSyncFSRFlag - true to sync with signal on FSR pin, false to //! ignore the pulse on FSR pin.This value has to //! be similar to the value of //! McBSP_ClockParams.clockSRGSyncFlag. //! - \b syncErrorDetect - true to enable frame sync error detect. false //! to disable. //! - \b syncClockDivider - Maximum valid value is 4095. //! - \b syncPulseDivider - Maximum valid value is 255. //! - \b syncSourceTx - MCBSP_TX_INTERNAL_FRAME_SYNC_SOURCE or //! MCBSP_TX_EXTERNAL_FRAME_SYNC_SOURCE //! - \b syncIntSource - MCBSP_TX_INTERNAL_FRAME_SYNC_DATA or //! MCBSP_TX_INTERNAL_FRAME_SYNC_SRG //! - \b syncFSXPolarity - MCBSP_TX_FRAME_SYNC_POLARITY_LOW or //! MCBSP_TX_FRAME_SYNC_POLARITY_HIGH. //! //! \return None. // //***************************************************************************** extern void McBSP_configureTxFrameSync(uint32_t base, const McBSP_TxFsyncParams * ptrFsyncParams); //***************************************************************************** // //! Configures receiver frame sync. //! //! \param base is the base address of the McBSP module. //! \param ptrFsyncParams is a pointer to a structure containing \e frame sync //! parameters McBSP_RxFsyncParams. //! This function sets up the receiver frame sync. The following are valid //! values and ranges for the parameters of the McBSPTxFsyncParams. //! - \b syncSRGSyncFSRFlag - true to sync with signal on FSR pin, //! false to ignore the pulse on FSR pin. //! This value has to be similar to the value of //! McBSP_ClockParams.clockSRGSyncFlag. //! - \b syncErrorDetect - true to enable frame sync error detect. //! false to disable. //! - \b syncClockDivider - Maximum valid value is 4095. //! - \b syncPulseDivider - Maximum valid value is 255. //! - \b syncSourceRx - MCBSP_RX_INTERNAL_FRAME_SYNC_SOURCE or //! MCBSP_RX_EXTERNAL_FRAME_SYNC_SOURCE //! - \b syncFSRPolarity - MCBSP_RX_FRAME_SYNC_POLARITY_LOW or //! MCBSP_RX_FRAME_SYNC_POLARITY_HIGH //! //! \return None. // //***************************************************************************** extern void McBSP_configureRxFrameSync(uint32_t base, const McBSP_RxFsyncParams * ptrFsyncParams); //***************************************************************************** // //! Configures transmitter data format. //! //! \param base is the base address of the McBSP module. //! \param ptrDataParams is a pointer to a structure containing \e data format //! parameters McBSPTxDataParams. //! This function sets up the transmitter data format and properties. The //! following are valid values and ranges for the parameters of the //! McBSPTxDataParams. //! - \b loopbackModeFlag - true for digital loop-back mode. //! false for no loop-back mode. //! - \b twoPhaseModeFlag - true for two phase mode. //! false for single phase mode. //! - \b pinDelayEnableFlag - true to enable DX pin delay. //! false to disable DX pin delay. //! - \b phase1FrameLength - maximum value of 127. //! - \b phase2FrameLength - maximum value of 127. //! - \b clockStopMode - MCBSP_CLOCK_SPI_MODE_NO_DELAY or //! MCBSP_CLOCK_SPI_MODE_DELAY //! - \b phase1WordLength - MCBSP_BITS_PER_WORD_x , x = 8,12,16,20,24,32 //! - \b phase2WordLength - MCBSP_BITS_PER_WORD_x , x = 8,12,16,20,24,32 //! - \b compandingMode - MCBSP_COMPANDING_NONE, //! MCBSP_COMPANDING_NONE_LSB_FIRST //! MCBSP_COMPANDING_U_LAW_SET or //! MCBSP_COMPANDING_A_LAW_SET. //! - \b dataDelayBits - MCBSP_DATA_DELAY_BIT_0, //! MCBSP_DATA_DELAY_BIT_1 or //! MCBSP_DATA_DELAY_BIT_2 //! - \b interruptMode - MCBSP_TX_ISR_SOURCE_TX_READY, //! MCBSP_TX_ISR_SOURCE_END_OF_BLOCK, //! MCBSP_TX_ISR_SOURCE_FRAME_SYNC or //! MCBSP_TX_ISR_SOURCE_SYNC_ERROR //! //! \b Note - When using companding,phase1WordLength and phase2WordLength //! must be 8 bits wide. //! //! \return None. // //***************************************************************************** extern void McBSP_configureTxDataFormat(uint32_t base, const McBSP_TxDataParams * ptrDataParams); //***************************************************************************** // //! Configures receiver data format. //! //! \param base is the base address of the McBSP module. //! \param ptrDataParams is a pointer to a structure containing data format //! parameters McBSP_RxDataParams. //! This function sets up the transmitter data format and properties. The //! following are valid values and ranges for the parameters of the //! McBSP_RxDataParams. //! - \b loopbackModeFlag - true for digital loop-back mode. //! false for non loop-back mode. //! - \b twoPhaseModeFlag - true for two phase mode. //! false for single phase mode. //! - \b phase1FrameLength - maximum value of 127. //! - \b phase2FrameLength - maximum value of 127. //! - \b phase1WordLength - MCBSP_BITS_PER_WORD_x , x = 8,12,16,20,24,32 //! - \b phase2WordLength - MCBSP_BITS_PER_WORD_x , x = 8,12,16,20,24,32 //! - \b compandingMode - MCBSP_COMPANDING_NONE, //! MCBSP_COMPANDING_NONE_LSB_FIRST //! MCBSP_COMPANDING_U_LAW_SET or //! MCBSP_COMPANDING_A_LAW_SET. //! - \b dataDelayBits - MCBSP_DATA_DELAY_BIT_0, //! MCBSP_DATA_DELAY_BIT_1 or //! MCBSP_DATA_DELAY_BIT_2 //! - \b signExtMode - MCBSP_RIGHT_JUSTIFY_FILL_ZERO, //! MCBSP_RIGHT_JUSTIFY_FILL_SIGN or //! MCBSP_LEFT_JUSTIFY_FILL_ZER0 //! - \b interruptMode - MCBSP_RX_ISR_SOURCE_SERIAL_WORD, //! MCBSP_RX_ISR_SOURCE_END_OF_BLOCK, //! MCBSP_RX_ISR_SOURCE_FRAME_SYNC or //! MCBSP_RX_ISR_SOURCE_SYNC_ERROR //! //! \b Note - When using companding,phase1WordLength and phase2WordLength //! must be 8 bits wide. //! //! \return None. // //***************************************************************************** extern void McBSP_configureRxDataFormat(uint32_t base, const McBSP_RxDataParams * ptrDataParams); //***************************************************************************** // //! Configures transmitter multichannel. //! //! \param base is the base address of the McBSP module. //! \param ptrMchnParams is a pointer to a structure containing multichannel //! parameters McBSP_TxMultichannelParams. //! //! This function sets up the transmitter multichannel mode. The following are //! valid values and ranges for the parameters of the //! McBSP_TxMultichannelParams. //! - \b channelCount - Maximum value of 128 for partition 8 //! Maximum value of 32 for partition 2 //! - \b ptrChannelsList - Pointer to an array of size channelCount that //! has unique channels. //! - \b multichannelMode - MCBSP_ALL_TX_CHANNELS_ENABLED, //! MCBSP_TX_CHANNEL_SELECTION_ENABLED, //! MCBSP_ENABLE_MASKED_TX_CHANNEL_SELECTION or //! MCBSP_SYMMERTIC_RX_TX_SELECTION //! - \b partition - MCBSP_MULTICHANNEL_TWO_PARTITION or //! MCBSP_MULTICHANNEL_EIGHT_PARTITION //! \note - In 2 partition mode only channels that belong to a single even or //! odd block number should be listed. It is valid to have an even and //! odd channels. For example you can have channels [48 -63] and //! channels [96 - 111] enables as one belongs to an even block and //! the other to an odd block or two partitions. But not channels //! [48 - 63] and channels [112 - 127] since they both are even blocks //! or similar partitions. //! //! \return returns the following error codes. //! - \b MCBSP_ERROR_EXCEEDED_CHANNELS - number of channels exceeds 128 //! - \b MCBSP_ERROR_2_PARTITION_A - invalid channel combination for //! partition A //! - \b MCBSP_ERROR_2_PARTITION_B - invalid channel combination for //! partition B //! - \b MCBSP_ERROR_INVALID_MODE - invalid transmitter channel mode. //! //! \return Returns the following error codes. //! - \b MCBSP_ERROR_EXCEEDED_CHANNELS - Exceeded number of channels. //! - \b MCBSP_ERROR_2_PARTITION_A - Error in 2 partition A setup. //! - \b MCBSP_ERROR_2_PARTITION_B - Error in 2 partition B setup. //! - \b MCBSP_ERROR_INVALID_MODE - Invalid mode. // //***************************************************************************** extern uint16_t McBSP_configureTxMultichannel(uint32_t base, const McBSP_TxMultichannelParams * ptrMchnParams); //***************************************************************************** // //! Configures receiver multichannel. //! //! \param base is the base address of the McBSP module. //! \param ptrMchnParams is a pointer to a structure containing multichannel //! parameters McBSP_RxMultiChannelParams. //! //! This function sets up the receiver multichannel mode. The following are //! valid values and ranges for the parameters of the McBSPMultichannelParams. //! - \b channelCount - Maximum value of 128 for partition 8 //! Maximum value of 32 for partition 2 //! - \b ptrChannelsList - Pointer to an array of size channelCount that //! has unique channels. //! - \b multichannelMode - MCBSP_ALL_RX_CHANNELS_ENABLED, //! MCBSP_RX_CHANNEL_SELECTION_ENABLED, //! - \b partition - MCBSP_MULTICHANNEL_TWO_PARTITION or //! MCBSP_MULTICHANNEL_EIGHT_PARTITION //! \note - In 2 partition mode only channels that belong to a single even or //! odd block number should be listed. It is valid to have an even //! and odd channels. For example you can have channels [48 - 63] and //! channels [96 - 111] enables as one belongs to an even block and //! the other to an odd block or two partitions. But not channels //! [48 - 63]and channels [112 - 127] since they both are even blocks //! or similar partitions. //! //! \return returns the following error codes. //! - \b MCBSP_ERROR_EXCEEDED_CHANNELS - number of channels exceeds 128 //! - \b MCBSP_ERROR_2_PARTITION_A - invalid channel combination for //! partition A //! - \b MCBSP_ERROR_2_PARTITION_B - invalid channel combination for //! partition B //! - \b MCBSP_ERROR_INVALID_MODE - invalid transmitter channel mode. //! //! \return Returns the following error codes. //! - \b MCBSP_ERROR_EXCEEDED_CHANNELS - Exceeded number of channels. //! - \b MCBSP_ERROR_2_PARTITION_A - Error in 2 partition A setup. //! - \b MCBSP_ERROR_2_PARTITION_B - Error in 2 partition B setup. //! - \b MCBSP_ERROR_INVALID_MODE - Invalid mode. // //***************************************************************************** extern uint16_t McBSP_configureRxMultichannel(uint32_t base, const McBSP_RxMultichannelParams * ptrMchnParams); //***************************************************************************** // //! Configures McBSP in SPI master mode //! //! \param base is the base address of the McBSP module. //! \param ptrSPIMasterMode is a pointer to a structure containing SPI //! parameters McBSP_SPIMasterModeParams. //! This function sets up the McBSP module in SPI master mode.The following are //! valid values and ranges for the parameters of the //! McBSP_SPIMasterModeParams. //! - \b loopbackModeFlag - true for digital loop-back //! false for no loop-back //! - \b clockStopMode - MCBSP_CLOCK_SPI_MODE_NO_DELAY or //! MCBSP_CLOCK_SPI_MODE_DELAY //! - \b wordLength - MCBSP_BITS_PER_WORD_x , x = 8,12,16,20,24,32 //! - \b spiMode It represents the clock polarity can take values: //! - MCBSP_TX_POLARITY_RISING_EDGE or //! MCBSP_TX_POLARITY_FALLING_EDGE //! - \b clockSRGDivider - Maximum valid value is 255. //! //! \note Make sure the clock divider is such that, the McBSP clock is not //! running faster than 1/2 the speed of the source clock. //! //! \return None. // //***************************************************************************** extern void McBSP_configureSPIMasterMode(uint32_t base, const McBSP_SPIMasterModeParams * ptrSPIMasterMode); //***************************************************************************** // //! Configures McBSP in SPI slave mode //! //! \param base is the base address of the McBSP module. //! \param ptrSPISlaveMode is a pointer to a structure containing SPI //! parameters McBSP_SPISlaveModeParams. //! This function sets up the McBSP module in SPI slave mode.The following are //! valid values and ranges for the parameters of the McBSP_SPISlaveModeParams. //! - \b loopbackModeFlag - true for digital loop-back //! false for no loop-back //! - \b clockStopMode - MCBSP_CLOCK_SPI_MODE_NO_DELAY or //! MCBSP_CLOCK_SPI_MODE_DELAY //! - \b wordLength - MCBSP_BITS_PER_WORD_x , x = 8,12,16,20,24,32 //! - \b spiMode It represents the clock polarity and can take //! values: //! - MCBSP_RX_POLARITY_FALLING_EDGE or //! MCBSP_RX_POLARITY_RISING_EDGE //! //! \return None. // //***************************************************************************** extern void McBSP_configureSPISlaveMode(uint32_t base, const McBSP_SPISlaveModeParams * ptrSPISlaveMode); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: memcfg.h // // TITLE: C28x RAM config driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup memcfg_api MemCfg //! @{ // //***************************************************************************** //***************************************************************************** // // Useful defines used within the driver functions. Not intended for use by // application code. // //***************************************************************************** // // Masks to decode memory section defines. // // // Used for access violation functions. // //***************************************************************************** // // Values that can be passed to MemCfg_lockConfig(), MemCfg_unlockConfig(), // MemCfg_commitConfig(), MemCfg_setProtection(), MemCfg_initSections(), // MemCfg_setCLAMemType(), MemCfg_setLSRAMControllerSel(), // MemCfg_getInitStatus() as the memSection(s) or ramSection(s) parameter. // //***************************************************************************** // // DxRAM - Dedicated RAM config // // // LSxRAM - Local shared RAM config // // // GSxRAM - Global shared RAM config // // // MSGxRAM - Message RAM config // // // All sections // //***************************************************************************** // // Values that can be passed to MemCfg_setProtection() as the protectMode // parameter. // //***************************************************************************** //***************************************************************************** // // Values that can be passed to MemCfg_enableViolationInterrupt() // MemCfg_disableViolationInterrupt(), MemCfg_forceViolationInterrupt(), // MemCfg_clearViolationInterruptStatus(), and MemCfg_getViolationAddress() as // the intFlags parameter. They also make up the return value of // MemCfg_getViolationInterruptStatus(). // //***************************************************************************** //***************************************************************************** // // Values that can be passed to MemCfg_enableViolationInterrupt() // MemCfg_disableViolationInterrupt(), MemCfg_forceViolationInterrupt(), // MemCfg_clearViolationInterruptStatus(), and MemCfg_getViolationAddress() as // the intFlags parameter. They also make up the return value of // MemCfg_getViolationInterruptStatus(). // //***************************************************************************** //***************************************************************************** // // Values that can be passed to MemCfg_forceCorrErrorStatus(), // MemCfg_clearCorrErrorStatus(), and MemCfg_getCorrErrorAddress() as the // stsFlag(s) parameter and returned by MemCfg_getCorrErrorStatus(). // // Note that MEMCFG_CERR_CPUREAD is the only value below that has a // corresponding interrupt and may be used with the error functions that take // an intFlag(s) parameter. // //***************************************************************************** //***************************************************************************** // // Values that can be passed to MemCfg_forceUncorrErrorStatus(), // MemCfg_clearUncorrErrorStatus(), and MemCfg_getUncorrErrorAddress() as the // stsFlag(s) parameter and returned by MemCfg_getUncorrErrorStatus(). // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to MemCfg_setCLAMemType() as the \e claMemType //! parameter. // //***************************************************************************** typedef enum { MEMCFG_CLA_MEM_DATA, //!< Section is CLA data memory MEMCFG_CLA_MEM_PROGRAM //!< Section is CLA program memory } MemCfg_CLAMemoryType; //***************************************************************************** // //! Values that can be passed to MemCfg_setLSRAMControllerSel() as the //! \e controllerSel parameter. // //***************************************************************************** typedef enum { MEMCFG_LSRAMCONTROLLER_CPU_ONLY, //!< CPU is the owner of the section MEMCFG_LSRAMCONTROLLER_CPU_CLA1 //!< CPU and CLA1 share this section } MemCfg_LSRAMControllerSel; //***************************************************************************** // //! Values that can be passed to MemCfg_setGSRAMControllerSel() as the //! \e controllerSel parameter. // //***************************************************************************** typedef enum { MEMCFG_GSRAMCONTROLLER_CPU1, //!< CPU1 is controller of the section MEMCFG_GSRAMCONTROLLER_CPU2 //!< CPU2 is controller of the section } MemCfg_GSRAMControllerSel; //***************************************************************************** // //! Values that can be passed to MemCfg_setTestMode() as the \e testMode //! parameter. // //***************************************************************************** typedef enum { //! Functional mode. Test mode is disabled. MEMCFG_TEST_FUNCTIONAL = 0, //! Writes allowed to data only MEMCFG_TEST_WRITE_DATA = 1, //! Writes allowed to ECC only (for DxRAM/MxRAM) MEMCFG_TEST_WRITE_ECC = 2, //! Writes allowed to parity only (for LSxRAM, GSxRAM, and MSGxRAM) MEMCFG_TEST_WRITE_PARITY = 2 } MemCfg_TestMode; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! Sets the CLA memory type of the specified RAM section. //! //! \param ramSections is the logical OR of the sections to be configured. //! \param claMemType indicates data memory or program memory. //! //! This function sets the CLA memory type configuration of the RAM section. If //! the \e claMemType parameter is \b MEMCFG_CLA_MEM_DATA, the RAM section will //! be configured as CLA data memory. If \b MEMCFG_CLA_MEM_PROGRAM, the RAM //! section will be configured as CLA program memory. //! //! The \e ramSections parameter is an OR of the following indicators: //! \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx. //! //! \note This API only applies to LSx RAM and has no effect if the CLA isn't //! controller of the memory section. //! //! \sa MemCfg_setLSRAControllerSel() //! //! \return None. // //***************************************************************************** static inline void MemCfg_setCLAMemType(uint32_t ramSections, MemCfg_CLAMemoryType claMemType) { // // Check the arguments. // do { if(!((ramSections & 0xFF000000U) == 0x01000000U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/memcfg.h", 322); } } while((_Bool)0); // // Write the CLA memory configuration to the appropriate register. Either // set or clear the bit that determines the function of the RAM section as // it relates to the CLA. // __eallow(); if(claMemType == MEMCFG_CLA_MEM_PROGRAM) { // // Program memory // (*((volatile uint32_t *)(0x0005F400U + 0x26U))) |= ramSections; } else { // // Data memory // (*((volatile uint32_t *)(0x0005F400U + 0x26U))) &= ~ramSections; } __edis(); } //***************************************************************************** // //! Enables individual RAM access violation interrupt sources. //! //! \param intFlags is a bit mask of the interrupt sources to be enabled. //! Can be a logical OR any of the following values: //! - \b MEMCFG_NMVIOL_CPUREAD - Non-controller CPU read access //! - \b MEMCFG_NMVIOL_CPUWRITE - Non-controller CPU write access //! - \b MEMCFG_NMVIOL_CPUFETCH - Non-controller CPU fetch access //! - \b MEMCFG_NMVIOL_DMAWRITE - Non-controller DMA write access //! - \b MEMCFG_NMVIOL_CLA1READ - Non-controller CLA1 read access //! - \b MEMCFG_NMVIOL_CLA1WRITE - Non-controller CLA1 write access //! - \b MEMCFG_NMVIOL_CLA1FETCH - Non-controller CLA1 fetch access //! - \b MEMCFG_MVIOL_CPUFETCH - Controller CPU fetch access //! - \b MEMCFG_MVIOL_CPUWRITE - Controller CPU write access //! - \b MEMCFG_MVIOL_DMAWRITE - Controller DMA write access //! This function enables the indicated RAM access violation interrupt sources. //! Only the sources that are enabled can be reflected to the processor //! interrupt; disabled sources have no effect on the processor. //! //! \return None. // //***************************************************************************** static inline void MemCfg_enableViolationInterrupt(uint32_t intFlags) { // // Enable the specified interrupts. // __eallow(); (*((volatile uint32_t *)(0x0005F4C0U + 0x6U))) |= intFlags & 0x0000FFFFU; (*((volatile uint32_t *)(0x0005F4C0U + 0x26U))) |= (intFlags & 0x000F0000U) >> 16U; __edis(); } //***************************************************************************** // //! Disables individual RAM access violation interrupt sources. //! //! \param intFlags is a bit mask of the interrupt sources to be disabled. //! Can be a logical OR any of the following values: //! - \b MEMCFG_NMVIOL_CPUREAD - Non-controller CPU read access //! - \b MEMCFG_NMVIOL_CPUWRITE - Non-controller CPU write access //! - \b MEMCFG_NMVIOL_CPUFETCH - Non-controller CPU fetch access //! - \b MEMCFG_NMVIOL_DMAWRITE - Non-controller DMA write access //! - \b MEMCFG_NMVIOL_CLA1READ - Non-controller CLA1 read access //! - \b MEMCFG_NMVIOL_CLA1WRITE - Non-controller CLA1 write access //! - \b MEMCFG_NMVIOL_CLA1FETCH - Non-controller CLA1 fetch access //! - \b MEMCFG_MVIOL_CPUFETCH - Controller CPU fetch access //! - \b MEMCFG_MVIOL_CPUWRITE - Controller CPU write access //! - \b MEMCFG_MVIOL_DMAWRITE - Controller DMA write access //! //! This function disables the indicated RAM access violation interrupt //! sources. Only the sources that are enabled can be reflected to the //! processor interrupt; disabled sources have no effect on the processor. //! //! \note Note that only non-controller violations may generate interrupts. //! //! \return None. // //***************************************************************************** static inline void MemCfg_disableViolationInterrupt(uint32_t intFlags) { // // Disable the specified interrupts. // __eallow(); (*((volatile uint32_t *)(0x0005F4C0U + 0x6U))) &= ~(intFlags & 0x0000FFFFU); (*((volatile uint32_t *)(0x0005F4C0U + 0x26U))) &= ~((intFlags & 0x000F0000U) >> 16U); __edis(); } //***************************************************************************** // //! Gets the current RAM access violation status. //! //! This function returns the RAM access violation status. This function will //! return flags for both controller and non-controller access violations //! although only the non-controller flags have the ability to cause the //! generation of an interrupt. //! //! \return Returns the current violation status, enumerated as a bit field of //! the values: //! - \b MEMCFG_NMVIOL_CPUREAD - Non-controller CPU read access //! - \b MEMCFG_NMVIOL_CPUWRITE - Non-controller CPU write access //! - \b MEMCFG_NMVIOL_CPUFETCH - Non-controller CPU fetch access //! - \b MEMCFG_NMVIOL_DMAWRITE - Non-controller DMA write access //! - \b MEMCFG_NMVIOL_CLA1READ - Non-controller CLA1 read access //! - \b MEMCFG_NMVIOL_CLA1WRITE - Non-controller CLA1 write access //! - \b MEMCFG_NMVIOL_CLA1FETCH - Non-controller CLA1 fetch access //! - \b MEMCFG_MVIOL_CPUFETCH - Controller CPU fetch access //! - \b MEMCFG_MVIOL_CPUWRITE - Controller CPU write access //! - \b MEMCFG_MVIOL_DMAWRITE - Controller DMA write access //***************************************************************************** static inline uint32_t MemCfg_getViolationInterruptStatus(void) { uint32_t status; // // Read and return RAM access status flags. // status = ((*((volatile uint32_t *)(0x0005F4C0U + 0x0U)))) | ((*((volatile uint32_t *)(0x0005F4C0U + 0x20U))) << 16U); return(status); } //***************************************************************************** // //! Sets the RAM access violation status. //! //! \param intFlags is a bit mask of the access violation flags to be set. //! Can be a logical OR any of the following values: //! - \b MEMCFG_NMVIOL_CPUREAD - Non-controller CPU read access //! - \b MEMCFG_NMVIOL_CPUWRITE - Non-controller CPU write access //! - \b MEMCFG_NMVIOL_CPUFETCH - Non-controller CPU fetch access //! - \b MEMCFG_NMVIOL_DMAWRITE - Non-controller DMA write access //! - \b MEMCFG_NMVIOL_CLA1READ - Non-controller CLA1 read access //! - \b MEMCFG_NMVIOL_CLA1WRITE - Non-controller CLA1 write access //! - \b MEMCFG_NMVIOL_CLA1FETCH - Non-controller CLA1 fetch access //! - \b MEMCFG_MVIOL_CPUFETCH - Controller CPU fetch access //! - \b MEMCFG_MVIOL_CPUWRITE - Controller CPU write access //! - \b MEMCFG_MVIOL_DMAWRITE - Controller DMA write access //! //! This function sets the RAM access violation status. This function will //! set flags for both controller and non-controller access violations, and an //! interrupt will be generated if it is enabled. //! //! \return None. // //***************************************************************************** static inline void MemCfg_forceViolationInterrupt(uint32_t intFlags) { // // Shift and mask the flags appropriately and write them to the // corresponding SET register. // __eallow(); (*((volatile uint32_t *)(0x0005F4C0U + 0x2U))) = intFlags & 0x0000FFFFU; (*((volatile uint32_t *)(0x0005F4C0U + 0x22U))) = (intFlags & 0x000F0000U) >> 16U; __edis(); } //***************************************************************************** // //! Clears RAM access violation flags. //! //! \param intFlags is a bit mask of the access violation flags to be cleared. //! Can be a logical OR any of the following values: //! - \b MEMCFG_NMVIOL_CPUREAD - Non-controller CPU read access //! - \b MEMCFG_NMVIOL_CPUWRITE - Non-controller CPU write access //! - \b MEMCFG_NMVIOL_CPUFETCH - Non-controller CPU fetch access //! - \b MEMCFG_NMVIOL_DMAWRITE - Non-controller DMA write access //! - \b MEMCFG_NMVIOL_CLA1READ - Non-controller CLA1 read access //! - \b MEMCFG_NMVIOL_CLA1WRITE - Non-controller CLA1 write access //! - \b MEMCFG_NMVIOL_CLA1FETCH - Non-controller CLA1 fetch access //! - \b MEMCFG_MVIOL_CPUFETCH - Controller CPU fetch access //! - \b MEMCFG_MVIOL_CPUWRITE - Controller CPU write access //! - \b MEMCFG_MVIOL_DMAWRITE - Controller DMA write access //! //! \return None. // //***************************************************************************** static inline void MemCfg_clearViolationInterruptStatus(uint32_t intFlags) { // // Clear the requested access violation flags. // __eallow(); (*((volatile uint32_t *)(0x0005F4C0U + 0x4U))) |= intFlags & 0x0000FFFFU; (*((volatile uint32_t *)(0x0005F4C0U + 0x24U))) |= (intFlags & 0x000F0000U) >> 16U; __edis(); } //***************************************************************************** // //! Sets the correctable error threshold value. //! //! \param threshold is the correctable error threshold. //! //! This value sets the error-count threshold at which a correctable error //! interrupt is generated. That is when the error count register reaches the //! value specified by the \e threshold parameter, an interrupt is //! generated if it is enabled. //! //! \return None. // //***************************************************************************** static inline void MemCfg_setCorrErrorThreshold(uint32_t threshold) { // // Write the threshold value to the appropriate register. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x30U))) = threshold; __edis(); } //***************************************************************************** // //! Gets the correctable error count. //! //! \return Returns the number of correctable error have occurred. // //***************************************************************************** static inline uint32_t MemCfg_getCorrErrorCount(void) { // // Read and return the number of errors that have occurred. // return((*((volatile uint32_t *)(0x0005F500U + 0x2EU)))); } //***************************************************************************** // //! Enables individual RAM correctable error interrupt sources. //! //! \param intFlags is a bit mask of the interrupt sources to be enabled. Can //! take the value \b MEMCFG_CERR_CPUREAD only. Other values are reserved. //! //! This function enables the indicated RAM correctable error interrupt //! sources. Only the sources that are enabled can be reflected to the //! processor interrupt; disabled sources have no effect on the processor. //! //! \note Note that only correctable errors may generate interrupts. //! //! \return None. // //***************************************************************************** static inline void MemCfg_enableCorrErrorInterrupt(uint32_t intFlags) { // // Enable the specified interrupts. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x38U))) |= intFlags; __edis(); } //***************************************************************************** // //! Disables individual RAM correctable error interrupt sources. //! //! \param intFlags is a bit mask of the interrupt sources to be disabled. Can //! take the value \b MEMCFG_CERR_CPUREAD only. Other values are reserved. //! //! This function disables the indicated RAM correctable error interrupt //! sources. Only the sources that are enabled can be reflected to the //! processor interrupt; disabled sources have no effect on the processor. //! //! \note Note that only correctable errors may generate interrupts. //! //! \return None. // //***************************************************************************** static inline void MemCfg_disableCorrErrorInterrupt(uint32_t intFlags) { // // Disable the specified interrupts. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x38U))) &= ~(intFlags); __edis(); } //***************************************************************************** // //! Gets the current RAM correctable error interrupt status. //! //! \return Returns the current error interrupt status. Will return a value of //! \b MEMCFG_CERR_CPUREAD if an interrupt has been generated. If not, the //! function will return 0. // //***************************************************************************** static inline uint32_t MemCfg_getCorrErrorInterruptStatus(void) { // // Read and return correctable error interrupt flags. // return((*((volatile uint32_t *)(0x0005F500U + 0x32U)))); } //***************************************************************************** // //! Sets the RAM correctable error interrupt status. //! //! \param intFlags is a bit mask of the interrupt sources to be set. Can take //! the value \b MEMCFG_CERR_CPUREAD only. Other values are reserved. //! //! This function sets the correctable error interrupt flag. //! //! \note Note that only correctable errors may generate interrupts. //! //! \return None. // //***************************************************************************** static inline void MemCfg_forceCorrErrorInterrupt(uint32_t intFlags) { // // Write the flags to the appropriate SET register. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x36U))) = intFlags; __edis(); } //***************************************************************************** // //! Clears the RAM correctable error interrupt status. //! //! \param intFlags is a bit mask of the interrupt sources to be cleared. Can //! take the value \b MEMCFG_CERR_CPUREAD only. Other values are reserved. //! //! This function clears the correctable error interrupt flag. //! //! \note Note that only correctable errors may generate interrupts. //! //! \return None. // //***************************************************************************** static inline void MemCfg_clearCorrErrorInterruptStatus(uint32_t intFlags) { // // Clear the requested flags. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x34U))) |= intFlags; __edis(); } //***************************************************************************** // //! Gets the current correctable RAM error status. //! //! \return Returns the current error status, enumerated as a bit field of //! \b MEMCFG_CERR_CPUREAD, \b MEMCFG_CERR_DMAREAD, or \b MEMCFG_CERR_CLA1READ // //***************************************************************************** static inline uint32_t MemCfg_getCorrErrorStatus(void) { // // Read and return RAM error status flags. // return((*((volatile uint32_t *)(0x0005F500U + 0x20U)))); } //***************************************************************************** // //! Gets the current uncorrectable RAM error status. //! //! \return Returns the current error status, enumerated as a bit field of //! \b MEMCFG_UCERR_CPUREAD, \b MEMCFG_UCERR_DMAREAD, \b MEMCFG_UCERR_CLA1READ, //! or \b MEMCFG_UCERR_ECATMEMREAD. // //***************************************************************************** static inline uint32_t MemCfg_getUncorrErrorStatus(void) { // // Read and return RAM error status flags. // return((*((volatile uint32_t *)(0x0005F500U + 0x0U)))); } //***************************************************************************** // //! Sets the specified correctable RAM error status flag. //! //! \param stsFlags is a bit mask of the error sources. This parameter can be //! any of the following values: //! \b MEMCFG_CERR_CPUREAD, \b MEMCFG_CERR_DMAREAD, or \b MEMCFG_CERR_CLA1READ //! //! This function sets the specified correctable RAM error status flag. //! //! \return None. // //***************************************************************************** static inline void MemCfg_forceCorrErrorStatus(uint32_t stsFlags) { // // Write the flags to the appropriate SET register. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x22U))) = stsFlags; __edis(); } //***************************************************************************** // //! Sets the specified uncorrectable RAM error status flag. //! //! \param stsFlags is a bit mask of the error sources. This parameter can be //! any of the following values: //! \b MEMCFG_UCERR_CPUREAD, \b MEMCFG_UCERR_DMAREAD, \b MEMCFG_UCERR_CLA1READ, //! or \b MEMCFG_UCERR_ECATMEMREAD. //! //! This function sets the specified uncorrectable RAM error status flag. //! //! \return None. // //***************************************************************************** static inline void MemCfg_forceUncorrErrorStatus(uint32_t stsFlags) { // // Write the flags to the appropriate SET register. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x2U))) = stsFlags; __edis(); } //***************************************************************************** // //! Clears correctable RAM error flags. //! //! \param stsFlags is a bit mask of the status flags to be cleared. //! This parameter can be any of the following : //! \b MEMCFG_CERR_CPUREAD, \b MEMCFG_CERR_DMAREAD, or \b MEMCFG_CERR_CLA1READ //! //! This function clears the specified correctable RAM error flags. //! //! \return None. // //***************************************************************************** static inline void MemCfg_clearCorrErrorStatus(uint32_t stsFlags) { // // Clear the requested flags. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x24U))) |= stsFlags; __edis(); } //***************************************************************************** // //! Clears uncorrectable RAM error flags. //! //! \param stsFlags is a bit mask of the status flags to be cleared. //! This parameter can be any of the following : //! \b MEMCFG_UCERR_CPUREAD, \b MEMCFG_UCERR_DMAREAD, \b MEMCFG_UCERR_CLA1READ, //! or \b MEMCFG_UCERR_ECATMEMREAD. //! //! This function clears the specified uncorrectable RAM error flags. //! //! \return None. // //***************************************************************************** static inline void MemCfg_clearUncorrErrorStatus(uint32_t stsFlags) { // // Clear the requested flags. // __eallow(); (*((volatile uint32_t *)(0x0005F500U + 0x4U))) |= stsFlags; __edis(); } //***************************************************************************** // //! Enables ROM wait state. //! //! This function enables the ROM wait state. This mean CPU accesses to ROM are //! 1-wait. //! //! \return None. // //***************************************************************************** static inline void MemCfg_enableROMWaitState(void) { // // Clear the disable bit. // __eallow(); (*((volatile uint32_t *)(0x0005F540U + 0x0U))) &= ~((uint32_t)0x1U); __edis(); } //***************************************************************************** // //! Disables ROM wait state. //! //! This function enables the ROM wait state. This mean CPU accesses to ROM are //! 0-wait. //! //! \return None. // //***************************************************************************** static inline void MemCfg_disableROMWaitState(void) { // // Set the disable bit. // __eallow(); (*((volatile uint32_t *)(0x0005F540U + 0x0U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Enables ROM prefetch. //! //! This function enables the ROM prefetch for both secure ROM and boot ROM. //! //! \return None. // //***************************************************************************** static inline void MemCfg_enableROMPrefetch(void) { // // Set the enable bit. // __eallow(); (*((volatile uint32_t *)(0x0005E608U + 0x0U))) |= 0x1U; __edis(); } //***************************************************************************** // //! Disables ROM prefetch. //! //! This function enables the ROM prefetch for both secure ROM and boot ROM. //! //! \return None. // //***************************************************************************** static inline void MemCfg_disableROMPrefetch(void) { // // Clear the enable bit. // __eallow(); (*((volatile uint32_t *)(0x0005E608U + 0x0U))) &= ~((uint32_t)0x1U); __edis(); } //***************************************************************************** // //! Locks the writes to the configuration of specified memory sections. //! //! \param memSections is the logical OR of the sections to be configured. //! //! This function locks writes to the access protection and controller select //! configuration of a memory section.That means calling MemCfg_setProtection() //! or MemCfg_setLSRAMControllerSel() for a locked memory section will have no //! effect until MemCfg_unlockConfig() is called. //! //! The \e memSections parameter is an OR of one of the following sets of //! indicators: //! - \b MEMCFG_SECT_D0 and \b MEMCFG_SECT_D1 or \b MEMCFG_SECT_DX_ALL //! - \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx or \b MEMCFG_SECT_LSX_ALL //! - \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx or \b MEMCFG_SECT_GSX_ALL //! - \b OR use \b MEMCFG_SECT_ALL to configure all possible sections. //! //! \return None. // //***************************************************************************** extern void MemCfg_lockConfig(uint32_t memSections); //***************************************************************************** // //! Unlocks the writes to the configuration of a memory section. //! //! \param memSections is the logical OR of the sections to be configured. //! //! This function unlocks writes to the access protection and controller select //! configuration of a memory section that has been locked using //! MemCfg_lockConfig(). //! //! The \e memSections parameter is an OR of one of the following sets of //! indicators: //! - \b MEMCFG_SECT_D0 and \b MEMCFG_SECT_D1 or \b MEMCFG_SECT_DX_ALL //! - \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx or \b MEMCFG_SECT_LSX_ALL //! - \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx or \b MEMCFG_SECT_GSX_ALL //! - \b OR use \b MEMCFG_SECT_ALL to configure all possible sections. //! //! \return None. // //***************************************************************************** extern void MemCfg_unlockConfig(uint32_t memSections); //***************************************************************************** // //! Permanently locks writes to the configuration of a memory section. //! //! \param memSections is the logical OR of the sections to be configured. //! //! This function permanently locks writes to the access protection and //! controller select configuration of a memory section. That means calling //! MemCfg_setProtection() or MemCfg_setLSRAMControllerSel() for a locked memory //! section will have no effect. To lock the configuration in a nonpermanent //! way, use MemCfg_lockConfig(). //! //! The \e memSections parameter is an OR of one of the following sets of //! indicators: //! - \b MEMCFG_SECT_D0 and \b MEMCFG_SECT_D1 or \b MEMCFG_SECT_DX_ALL //! - \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx or \b MEMCFG_SECT_LSX_ALL //! - \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx or \b MEMCFG_SECT_GSX_ALL //! - \b OR use \b MEMCFG_SECT_ALL to configure all possible sections. //! //! \return None. // //***************************************************************************** extern void MemCfg_commitConfig(uint32_t memSections); //***************************************************************************** // //! Sets the access protection mode of a single memory section. //! //! \param memSection is the memory section to be configured. //! \param protectMode is the logical OR of the settings to be applied. //! //! This function sets the access protection mode of a specified memory section. //! The mode is passed into the \e protectMode parameter as the logical OR of //! the following values: //! - \b MEMCFG_PROT_ALLOWCPUFETCH or \b MEMCFG_PROT_BLOCKCPUFETCH - CPU fetch //! - \b MEMCFG_PROT_ALLOWCPUWRITE or \b MEMCFG_PROT_BLOCKCPUWRITE - CPU write //! - \b MEMCFG_PROT_ALLOWDMAWRITE or \b MEMCFG_PROT_BLOCKDMAWRITE - DMA write //! //! The \e memSection parameter is one of the following indicators: //! - \b MEMCFG_SECT_D0 or \b MEMCFG_SECT_D1 //! - \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx //! - \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx //! //! This function will have no effect if the associated registers have been //! locked by MemCfg_lockConfig() or MemCfg_commitConfig() or if the memory //! is configured as CLA program memory. //! //! \return None. // //***************************************************************************** extern void MemCfg_setProtection(uint32_t memSection, uint32_t protectMode); //***************************************************************************** // //! Sets the controller of the specified LSxRAM section. //! //! \param ramSection is the LSxRAM section to be configured. //! \param controllerSel is the sharing selection. //! //! This function sets the controller select configuration of the LSxRAM //! section. //! If the \e controllerSel parameter is \b MEMCFG_LSRAMCONTROLLER_CPU_ONLY, //! the LSxRAM section passed into the \e ramSection parameter will be dedicated //! to the CPU. If \b MEMCFG_LSRAMCONTROLLER_CPU_CLA1, the memory section will //! be shared between the CPU and the CLA. //! //! The \e ramSection parameter should be a value from \b MEMCFG_SECT_LS0 //! through \b MEMCFG_SECT_LSx. //! //! This function will have no effect if the associated registers have been //! locked by MemCfg_lockConfig() or MemCfg_commitConfig(). //! //! \note This API only applies to LSxRAM. //! //! \return None. // //***************************************************************************** extern void MemCfg_setLSRAMControllerSel(uint32_t ramSection, MemCfg_LSRAMControllerSel controllerSel); //***************************************************************************** // //! Sets the controller of the specified GSxRAM section. //! //! \param ramSections is the logical OR of the sections to be configured. //! \param controllerSel is the sharing selection. //! //! This function sets the controller select configuration of the GSxRAM //! section.If the \e controllerSel parameter is \b MEMCFG_GSRAMCONTROLLER_CPU1, //! the GSRAM sections passed into the \e ramSections parameter will be //! dedicated to CPU1. If \b MEMCFG_GSRAMCONTROLLER_CPU2, the memory section //! will be dedicated to CPU2. //! //! The \e ramSections parameter should be a logical OR of values from //! \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx. //! //! This function will have no effect if the associated registers have been //! locked by MemCfg_lockConfig() or MemCfg_commitConfig(). //! //! \note This API only applies to GSxRAM. //! //! \return None. // //***************************************************************************** extern void MemCfg_setGSRAMControllerSel(uint32_t ramSections, MemCfg_GSRAMControllerSel controllerSel); //***************************************************************************** // //! Sets the test mode of the specified memory section. //! //! \param memSection is the memory section to be configured. //! \param testMode is the test mode selected. //! //! This function sets the test mode configuration of the RAM section. The //! \e testMode parameter can take one of the following values: //! - \b MEMCFG_TEST_FUNCTIONAL //! - \b MEMCFG_TEST_WRITE_DATA //! - \b MEMCFG_TEST_WRITE_ECC //! - \b MEMCFG_TEST_WRITE_PARITY //! //! The \e memSection parameter is one of the following indicators: //! - \b MEMCFG_SECT_M0, \b MEMCFG_SECT_M1 //! - \b MEMCFG_SECT_D0, \b MEMCFG_SECT_D1 //! - \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx //! - \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx //! - \b MEMCFG_SECT_MSGCPUTOCPU, \b MEMCFG_SECT_MSGCPUTOCLA1, or //! \b MEMCFG_SECT_MSGCLA1TOCPU //! //! \return None. // //***************************************************************************** extern void MemCfg_setTestMode(uint32_t memSection, MemCfg_TestMode testMode); //***************************************************************************** // //! Starts the initialization the specified RAM sections. //! //! \param ramSections is the logical OR of the sections to be initialized. //! //! This function starts the initialization of the specified RAM sections. Use //! MemCfg_getInitStatus() to check if the initialization is done. //! //! The \e ramSections parameter is an OR of one of the following sets of //! indicators: //! - \b MEMCFG_SECT_M0, \b MEMCFG_SECT_M1, \b MEMCFG_SECT_D0, //! \b MEMCFG_SECT_D1, or \b MEMCFG_SECT_DX_ALL //! - \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx, or \b MEMCFG_SECT_LSX_ALL //! - \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx, or \b MEMCFG_SECT_GSX_ALL //! - \b MEMCFG_SECT_MSGCPUTOCPU, \b MEMCFG_SECT_MSGCPUTOCLA1, or //! \b MEMCFG_SECT_MSGCLA1TOCPU //! - \b OR use \b MEMCFG_SECT_ALL to configure all possible sections. //! //! \return None. // //***************************************************************************** extern void MemCfg_initSections(uint32_t ramSections); //***************************************************************************** // //! Get the status of initialized RAM sections. //! //! \param ramSections is the logical OR of the sections to be checked. //! //! This function gets the initialization status of the RAM sections specified //! by the \e ramSections parameter. //! //! The \e ramSections parameter is an OR of one of the following sets of //! indicators: //! - \b MEMCFG_SECT_M0, \b MEMCFG_SECT_M1, \b MEMCFG_SECT_D0, //! \b MEMCFG_SECT_D1, or \b MEMCFG_SECT_DX_ALL //! - \b MEMCFG_SECT_LS0 through \b MEMCFG_SECT_LSx, or \b MEMCFG_SECT_LSX_ALL //! - \b MEMCFG_SECT_GS0 through \b MEMCFG_SECT_GSx, or \b MEMCFG_SECT_GSX_ALL //! - \b MEMCFG_SECT_MSGCPUTOCPU, \b MEMCFG_SECT_MSGCPUTOCLA1, or //! \b MEMCFG_SECT_MSGCLA1TOCPU //! - \b OR use \b MEMCFG_SECT_ALL to get status of all possible sections. //! //! \note Use MemCfg_initSections() to start the initialization. //! //! \return Returns \b true if all the sections specified by \e ramSections //! have been initialized and \b false if not. // //***************************************************************************** extern _Bool MemCfg_getInitStatus(uint32_t ramSections); //***************************************************************************** // //! Get the violation address associated with a intFlag. //! //! \param intFlag is the type of access violation as indicated by ONE of //! these values: //! - \b MEMCFG_NMVIOL_CPUREAD - Non-controller CPU read access //! - \b MEMCFG_NMVIOL_CPUWRITE - Non-controller CPU write access //! - \b MEMCFG_NMVIOL_CPUFETCH - Non-controller CPU fetch access //! - \b MEMCFG_NMVIOL_DMAWRITE - Non-controller DMA write access //! - \b MEMCFG_NMVIOL_CLA1READ - Non-controller CLA1 read access //! - \b MEMCFG_NMVIOL_CLA1WRITE - Non-controller CLA1 write access //! - \b MEMCFG_NMVIOL_CLA1FETCH - Non-controller CLA1 fetch access //! - \b MEMCFG_MVIOL_CPUFETCH - Controller CPU fetch access //! - \b MEMCFG_MVIOL_CPUWRITE - Controller CPU write access //! - \b MEMCFG_MVIOL_DMAWRITE - Controller DMA write access //! //! \return Returns the violation address associated with the \e intFlag. // //***************************************************************************** extern uint32_t MemCfg_getViolationAddress(uint32_t intFlag); //***************************************************************************** // //! Get the correctable error address associated with a stsFlag. //! //! \param stsFlag is the type of error to which the returned address will //! correspond. Can currently take the value \b MEMCFG_CERR_CPUREAD only. //! Other values are reserved. //! //! \return Returns the error address associated with the stsFlag. // //***************************************************************************** extern uint32_t MemCfg_getCorrErrorAddress(uint32_t stsFlag); //***************************************************************************** // //! Get the uncorrectable error address associated with a stsFlag. //! //! \param stsFlag is the type of error to which the returned address will //! correspond. It may be passed one of these values: //! \b MEMCFG_UCERR_CPUREAD, \b MEMCFG_UCERR_DMAREAD, or //! \b MEMCFG_UCERR_CLA1READ values //! //! \return Returns the error address associated with the stsFlag. // //***************************************************************************** extern uint32_t MemCfg_getUncorrErrorAddress(uint32_t stsFlag); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: pin_map.h // // TITLE: Definitions of pin mux info for gpio.c. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // 0x00000003 = MUX register value // 0x0000000C = GMUX register value // 0x0000FF00 = Shift amount within mux registers // 0xFFFF0000 = Offset of MUX register //***************************************************************************** //########################################################################### // // FILE: pin_map.h // // TITLE: Legacy definitions of pin mux info for gpio.c. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // Legacy pinmuxing MACROS - Retained for portability across devices ONLY // Not recommended for new users //***************************************************************************** //########################################################################### // // FILE: sci.h // // TITLE: C28x SCI driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup sci_api SCI //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_sci.h // // TITLE: Definitions for the SCI registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the SCI register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCICCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCICTL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIHBAUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCILBAUD register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCICTL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIRXST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIRXEMU register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIRXBUF register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCITXBUF register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIFFTX register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIFFRX register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIFFCT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SCIPRI register // //************************************************************************************************* //***************************************************************************** // // Values that can be passed to SCI_enableInterrupt, SCI_disableInterrupt, and // SCI_clearInterruptStatus as the intFlags parameter, and returned from // SCI_getInterruptStatus. // //***************************************************************************** //***************************************************************************** // // Values that can be passed to SCI_setConfig as the config parameter // and returned by SCI_getConfig in the config parameter. // Additionally, the SCI_CONFIG_PAR_* enum subset can be passed to // SCI_setParityMode as the parity parameter, and are returned by // SCI_getParityMode. // //***************************************************************************** //***************************************************************************** // //! Values that can be used with SCI_setParityMode() and SCI_getParityMode() to //! describe the parity of the SCI communication. // //***************************************************************************** typedef enum { SCI_CONFIG_PAR_NONE = 0x0000U, //!< No parity SCI_CONFIG_PAR_EVEN = 0x0060U, //!< Even parity SCI_CONFIG_PAR_ODD = 0x0020U //!< Odd parity } SCI_ParityType; //***************************************************************************** // //! Values that can be passed to SCI_setFIFOInterruptLevel() as the txLevel //! parameter and returned by SCI_getFIFOInteruptLevel() and //! SCI_getTxFIFOStatus(). // //***************************************************************************** typedef enum { SCI_FIFO_TX0 = 0x0000U, //!< Transmit interrupt empty SCI_FIFO_TX1 = 0x0001U, //!< Transmit interrupt 1/16 full SCI_FIFO_TX2 = 0x0002U, //!< Transmit interrupt 2/16 full SCI_FIFO_TX3 = 0x0003U, //!< Transmit interrupt 3/16 full SCI_FIFO_TX4 = 0x0004U, //!< Transmit interrupt 4/16 full SCI_FIFO_TX5 = 0x0005U, //!< Transmit interrupt 5/16 full SCI_FIFO_TX6 = 0x0006U, //!< Transmit interrupt 6/16 full SCI_FIFO_TX7 = 0x0007U, //!< Transmit interrupt 7/16 full SCI_FIFO_TX8 = 0x0008U, //!< Transmit interrupt 8/16 full SCI_FIFO_TX9 = 0x0009U, //!< Transmit interrupt 9/16 full SCI_FIFO_TX10 = 0x000AU, //!< Transmit interrupt 10/16 full SCI_FIFO_TX11 = 0x000BU, //!< Transmit interrupt 11/16 full SCI_FIFO_TX12 = 0x000CU, //!< Transmit interrupt 12/16 full SCI_FIFO_TX13 = 0x000DU, //!< Transmit interrupt 13/16 full SCI_FIFO_TX14 = 0x000EU, //!< Transmit interrupt 14/16 full SCI_FIFO_TX15 = 0x000FU, //!< Transmit interrupt 15/16 full SCI_FIFO_TX16 = 0x0010U //!< Transmit interrupt full } SCI_TxFIFOLevel; //***************************************************************************** // //! Values that can be passed to SCI_setFIFOInterruptLevel() as the rxLevel //! parameter and returned by SCI_getFIFOInterruptLevel() and //! SCI_getRxFIFOStatus(). // //***************************************************************************** typedef enum { SCI_FIFO_RX0 = 0x0000U, //!< Receive interrupt empty SCI_FIFO_RX1 = 0x0001U, //!< Receive interrupt 1/16 full SCI_FIFO_RX2 = 0x0002U, //!< Receive interrupt 2/16 full SCI_FIFO_RX3 = 0x0003U, //!< Receive interrupt 3/16 full SCI_FIFO_RX4 = 0x0004U, //!< Receive interrupt 4/16 full SCI_FIFO_RX5 = 0x0005U, //!< Receive interrupt 5/16 full SCI_FIFO_RX6 = 0x0006U, //!< Receive interrupt 6/16 full SCI_FIFO_RX7 = 0x0007U, //!< Receive interrupt 7/16 full SCI_FIFO_RX8 = 0x0008U, //!< Receive interrupt 8/16 full SCI_FIFO_RX9 = 0x0009U, //!< Receive interrupt 9/16 full SCI_FIFO_RX10 = 0x000AU, //!< Receive interrupt 10/16 full SCI_FIFO_RX11 = 0x000BU, //!< Receive interrupt 11/16 full SCI_FIFO_RX12 = 0x000CU, //!< Receive interrupt 12/16 full SCI_FIFO_RX13 = 0x000DU, //!< Receive interrupt 13/16 full SCI_FIFO_RX14 = 0x000EU, //!< Receive interrupt 14/16 full SCI_FIFO_RX15 = 0x000FU, //!< Receive interrupt 15/16 full SCI_FIFO_RX16 = 0x0010U //!< Receive interrupt full } SCI_RxFIFOLevel; //***************************************************************************** // // Values returned from SCI_getRxStatus(). These correspond to the different // bits and flags of the SCIRXST register. // //***************************************************************************** //***************************************************************************** // // API Function prototypes // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks a SCI base address. //! //! \param base is the base address of the SCI port. //! //! This function determines if a SCI port base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool SCI_isBaseValid(uint32_t base) { return( (base == 0x00007200U) || (base == 0x00007210U) || (base == 0x00007220U) || (base == 0x00007230U) ); } //***************************************************************************** // //! Sets the type of parity. //! //! \param base is the base address of the SCI port. //! \param parity specifies the type of parity to use. //! //! Sets the type of parity to use for transmitting and expect when receiving. //! The \e parity parameter must be one of the following: //! \b SCI_CONFIG_PAR_NONE, \b SCI_CONFIG_PAR_EVEN, \b SCI_CONFIG_PAR_ODD. //! //! \return None. // //***************************************************************************** static inline void SCI_setParityMode(uint32_t base, SCI_ParityType parity) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 242); } } while((_Bool)0); // // Set the parity mode. // (*((volatile uint16_t *)(base + 0x0U))) = (((*((volatile uint16_t *)(base + 0x0U))) & ~(0x0060U)) | (uint16_t)parity); } //***************************************************************************** // //! Gets the type of parity currently being used. //! //! \param base is the base address of the SCI port. //! //! This function gets the type of parity used for transmitting data and //! expected when receiving data. //! //! \return Returns the current parity settings, specified as one of the //! following: //! \b SCI_CONFIG_PAR_NONE, \b SCI_CONFIG_PAR_EVEN, \b SCI_CONFIG_PAR_ODD. // //***************************************************************************** static inline SCI_ParityType SCI_getParityMode(uint32_t base) { uint16_t parity; // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 273); } } while((_Bool)0); // // Return the current parity setting. // parity = ((*((volatile uint16_t *)(base + 0x0U))) & (0x0060U)); return((SCI_ParityType)parity); } //***************************************************************************** // //! Sets the multiprocessor protocol to address-bit mode. //! //! \param base is the base address of the SCI port. //! //! This function sets the multi-processor protocol to address-bit mode. //! //! \return None. // //***************************************************************************** static inline void SCI_setAddrMultiProcessorMode(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 300); } } while((_Bool)0); // // Enable the address-bit mode protocol // (*((volatile uint16_t *)(base + 0x0U))) |= 0x8U; } //***************************************************************************** // //! Sets the multiprocessor protocol to idle-line mode. //! //! \param base is the base address of the SCI port. //! //! This function sets the multi-processor protocol to idle-line protocol. //! //! \return None. // //***************************************************************************** static inline void SCI_setIdleMultiProcessorMode(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 325); } } while((_Bool)0); // // Disable the address-bit mode protocol // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x8U; } //***************************************************************************** // //! Locks Autobaud. //! //! \param base is the base address of the SCI port. //! //! This function performs an autobaud lock for the SCI. //! //! \return None. // //***************************************************************************** static inline void SCI_lockAutobaud(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 350); } } while((_Bool)0); // // Prime the baud register // (*((volatile uint16_t *)(base + 0x2U))) = 0x0U; (*((volatile uint16_t *)(base + 0x3U))) = 0x1U; // // Prepare for autobaud detection. // Set the CDC bit to enable autobaud detection and clear the ABD bit. // (*((volatile uint16_t *)(base + 0xCU))) |= 0x2000U; (*((volatile uint16_t *)(base + 0xCU))) |= 0x4000U; // // Wait until we correctly read an 'A' or 'a' and lock // while(((*((volatile uint16_t *)(base + 0xCU))) & 0x8000U) != 0x8000U) { } // // After autobaud lock, clear the ABD and CDC bits // (*((volatile uint16_t *)(base + 0xCU))) |= 0x4000U; (*((volatile uint16_t *)(base + 0xCU))) &= ~0x2000U; } //***************************************************************************** // //! Sets the FIFO interrupt level at which interrupts are generated. //! //! \param base is the base address of the SCI port. //! \param txLevel is the transmit FIFO interrupt level, specified as one of //! the following: //! \b SCI_FIFO_TX0, \b SCI_FIFO_TX1, \b SCI_FIFO_TX2, . . . or //! \b SCI_FIFO_TX15. //! \param rxLevel is the receive FIFO interrupt level, specified as one of //! the following //! \b SCI_FIFO_RX0, \b SCI_FIFO_RX1, \b SCI_FIFO_RX2, ... or \b SCI_FIFO_RX15. //! //! This function sets the FIFO level at which transmit and receive interrupts //! are generated. //! //! \return None. // //***************************************************************************** static inline void SCI_setFIFOInterruptLevel(uint32_t base, SCI_TxFIFOLevel txLevel, SCI_RxFIFOLevel rxLevel) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 405); } } while((_Bool)0); // // Set the FIFO interrupt levels. // (*((volatile uint16_t *)(base + 0xAU))) = ((*((volatile uint16_t *)(base + 0xAU))) & (~0x1FU)) | (uint16_t)txLevel; (*((volatile uint16_t *)(base + 0xBU))) = ((*((volatile uint16_t *)(base + 0xBU))) & (~0x1FU)) | (uint16_t)rxLevel; } //***************************************************************************** // //! Gets the FIFO interrupt level at which interrupts are generated. //! //! \param base is the base address of the SCI port. //! \param txLevel is a pointer to storage for the transmit FIFO interrupt //! level, returned as one of the following: //! \b SCI_FIFO_TX0, \b SCI_FIFO_TX1, \b SCI_FIFO_TX2, ... or \b SCI_FIFO_TX15. //! \param rxLevel is a pointer to storage for the receive FIFO interrupt //! level, returned as one of the following: //! \b SCI_FIFO_RX0, \b SCI_FIFO_RX1, \b SCI_FIFO_RX2, ... or \b SCI_FIFO_RX15. //! //! This function gets the FIFO level at which transmit and receive interrupts //! are generated. //! //! \return None. // //***************************************************************************** static inline void SCI_getFIFOInterruptLevel(uint32_t base, SCI_TxFIFOLevel *txLevel, SCI_RxFIFOLevel *rxLevel) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 442); } } while((_Bool)0); // // Extract the transmit and receive FIFO levels. // *txLevel = (SCI_TxFIFOLevel)((*((volatile uint16_t *)(base + 0xAU))) & 0x1FU); *rxLevel = (SCI_RxFIFOLevel)((*((volatile uint16_t *)(base + 0xBU))) & 0x1FU); } //***************************************************************************** // //! Gets the current configuration of a SCI. //! //! \param base is the base address of the SCI port. //! \param lspclkHz is the rate of the clock supplied to the SCI module. This //! is the LSPCLK. //! \param baud is a pointer to storage for the baud rate. //! \param config is a pointer to storage for the data format. //! //! The baud rate and data format for the SCI is determined, given an //! explicitly provided peripheral clock (hence the ExpClk suffix). The //! returned baud rate is the actual baud rate; it may not be the exact baud //! rate requested or an ``official'' baud rate. The data format returned in //! \e config is enumerated the same as the \e config parameter of //! SCI_setConfig(). //! //! The peripheral clock is the low speed peripheral clock. This will be //! the value returned by SysCtl_getLowSeedClock(), or it can be explicitly //! hard coded if it is constant and known (to save the code/execution overhead //! of a call to SysCtl_getLowSpeedClock()). //! //! \return None. // //***************************************************************************** static inline void SCI_getConfig(uint32_t base, uint32_t lspclkHz, uint32_t *baud, uint32_t *config) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 485); } } while((_Bool)0); // // Compute the baud rate. // *baud = lspclkHz / ((1U + (((uint32_t)(*((volatile uint16_t *)(base + 0x2U))) << 8U) | (*((volatile uint16_t *)(base + 0x3U))))) * 8U); // // Get the parity, data length, and number of stop bits. // *config = (uint32_t)(*((volatile uint16_t *)(base + 0x0U))) & (0x0060U | 0x0080U | 0x0007U); } //***************************************************************************** // //! Enables transmitting and receiving. //! //! \param base is the base address of the SCI port. //! //! Enables SCI by taking SCI out of the software reset. Sets the TXENA, and //! RXENA bits which enables transmit and receive. //! //! \return None. // //***************************************************************************** static inline void SCI_enableModule(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 520); } } while((_Bool)0); // // Enable RX, TX, and the SCI. // (*((volatile uint16_t *)(base + 0x1U))) |= (0x2U | 0x1U | 0x20U); } //***************************************************************************** // //! Disables transmitting and receiving. //! //! \param base is the base address of the SCI port. //! //! Clears the SCIEN, TXE, and RXE bits. The user should ensure that all the //! data has been sent before disable the module during transmission. //! //! \return None. // //***************************************************************************** static inline void SCI_disableModule(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 547); } } while((_Bool)0); // // Disable the FIFO. // (*((volatile uint16_t *)(base + 0xAU))) &= ~(0x4000U); // // Disable the SCI. // (*((volatile uint16_t *)(base + 0x1U))) &= ~(0x2U | 0x1U); } //***************************************************************************** // //! Enables transmitting. //! //! \param base is the base address of the SCI port. //! //! Enables SCI by taking SCI out of the software reset. Sets the TXENA bit //! which enables transmit. //! //! \return None. // //***************************************************************************** static inline void SCI_enableTxModule(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 578); } } while((_Bool)0); // // Enable TX and the SCI. // (*((volatile uint16_t *)(base + 0x1U))) |= (0x2U | 0x20U); } //***************************************************************************** // //! Disables transmitting. //! //! \param base is the base address of the SCI port. //! //! Disables SCI by taking SCI out of the software reset. Clears the TXENA bit //! which disables transmit. //! //! \return None. // //***************************************************************************** static inline void SCI_disableTxModule(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 604); } } while((_Bool)0); // // Disable TX. // (*((volatile uint16_t *)(base + 0x1U))) &= ~0x2U; } //***************************************************************************** // //! Enables receiving. //! //! \param base is the base address of the SCI port. //! //! Enables SCI by taking SCI out of the software reset. Sets the RXENA bit //! which enables receive. //! //! \return None. // //***************************************************************************** static inline void SCI_enableRxModule(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 630); } } while((_Bool)0); // // Enable RX and the SCI. // (*((volatile uint16_t *)(base + 0x1U))) |= (0x1U | 0x20U); } //***************************************************************************** // //! Disables receiving. //! //! \param base is the base address of the SCI port. //! //! Disables SCI by taking SCI out of the software reset. Clears the RXENA bit //! which disables receive. //! //! \return None. // //***************************************************************************** static inline void SCI_disableRxModule(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 656); } } while((_Bool)0); // // Disable RX. // (*((volatile uint16_t *)(base + 0x1U))) &= ~0x1U; } //***************************************************************************** // //! Enables Sleep Mode //! //! \param base is the base address of the SCI port. //! //! Enables the sleep mode in SCI by setting the SLEEP bit in SCICTL1 register //! //! \return None. // //***************************************************************************** static inline void SCI_enableSleepMode(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 681); } } while((_Bool)0); // // Set sleep bit // (*((volatile uint16_t *)(base + 0x1U))) |= 0x4U; } //***************************************************************************** // //! Disables Sleep Mode //! //! \param base is the base address of the SCI port. //! //! Disables the sleep mode in SCI by clearing the SLEEP bit in SCICTL1 register //! //! \return None. // //***************************************************************************** static inline void SCI_disableSleepMode(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 706); } } while((_Bool)0); // // Clear sleep bit // (*((volatile uint16_t *)(base + 0x1U))) &= ~0x4U; } //***************************************************************************** // //! Enables the transmit and receive FIFOs. //! //! \param base is the base address of the SCI port. //! //! This functions enables the transmit and receive FIFOs in the SCI. //! //! \return None. // //***************************************************************************** static inline void SCI_enableFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 731); } } while((_Bool)0); // // Enable the FIFO. // (*((volatile uint16_t *)(base + 0xAU))) |= 0x8000U; (*((volatile uint16_t *)(base + 0xAU))) |= 0x4000U | 0x2000U; (*((volatile uint16_t *)(base + 0xBU))) |= 0x2000U; } //***************************************************************************** // //! Disables the transmit and receive FIFOs. //! //! \param base is the base address of the SCI port. //! //! This functions disables the transmit and receive FIFOs in the SCI. //! //! \return None. // //***************************************************************************** static inline void SCI_disableFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 758); } } while((_Bool)0); // // Disable the FIFO. // (*((volatile uint16_t *)(base + 0xAU))) &= ~0x4000U; } //***************************************************************************** // //! Determines if the FIFO enhancement is enabled. //! //! \param base is the base address of the SCI port. //! //! This function returns a flag indicating whether or not the FIFO enhancement //! is enabled. //! //! \return Returns \b true if the FIFO enhancement is enabled or \b false //! if the FIFO enhancement is disabled. // //***************************************************************************** static inline _Bool SCI_isFIFOEnabled(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 785); } } while((_Bool)0); // // Return true if the FIFO is enabled and false if it is disabled. // return((((*((volatile uint16_t *)(base + 0xAU))) & 0x4000U) == 0x4000U) ? 1 : 0); } //***************************************************************************** // //! Resets the receive FIFO. //! //! \param base is the base address of the SCI port. //! //! This functions resets the receive FIFO of the SCI. //! //! \return None. // //***************************************************************************** static inline void SCI_resetRxFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 811); } } while((_Bool)0); // // Reset the specified FIFO. // (*((volatile uint16_t *)(base + 0xBU))) &= ~0x2000U; (*((volatile uint16_t *)(base + 0xBU))) |= 0x2000U; } //***************************************************************************** // //! Resets the transmit FIFO. //! //! \param base is the base address of the SCI port. //! //! This functions resets the transmit FIFO of the SCI. //! //! \return None. // //***************************************************************************** static inline void SCI_resetTxFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 837); } } while((_Bool)0); // // Reset the specified FIFO. // (*((volatile uint16_t *)(base + 0xAU))) &= ~0x2000U; (*((volatile uint16_t *)(base + 0xAU))) |= 0x2000U; } //***************************************************************************** // //! Resets the SCI Transmit and Receive Channels //! //! \param base is the base address of the SCI port. //! //! This functions resets transmit and receive channels in the SCI. //! //! \return None. // //***************************************************************************** static inline void SCI_resetChannels(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 863); } } while((_Bool)0); // // Reset the Tx and Rx Channels // (*((volatile uint16_t *)(base + 0xAU))) &= ~0x8000U; (*((volatile uint16_t *)(base + 0xAU))) |= 0x8000U; } //***************************************************************************** // //! Determines if there are any characters in the receive buffer when the //! FIFO enhancement is not enabled. //! //! \param base is the base address of the SCI port. //! //! This function returns a flag indicating whether or not there is data //! available in the receive buffer. //! //! \return Returns \b true if there is data in the receive buffer or \b false //! if there is no data in the receive buffer. // //***************************************************************************** static inline _Bool SCI_isDataAvailableNonFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 892); } } while((_Bool)0); // // Return the availability of characters with FIFO disabled. // return((((*((volatile uint16_t *)(base + 0x5U))) & 0x40U) == 0x40U) ? 1 : 0); } //***************************************************************************** // //! Determines if there is any space in the transmit buffer when the FIFO //! enhancement is not enabled. //! //! \param base is the base address of the SCI port. //! //! This function returns a flag indicating whether or not there is space //! available in the transmit buffer when not using the FIFO enhancement. //! //! \return Returns \b true if there is space available in the transmit buffer //! or \b false if there is no space available in the transmit buffer. // //***************************************************************************** static inline _Bool SCI_isSpaceAvailableNonFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 921); } } while((_Bool)0); // // Return the availability of space. // return((((*((volatile uint16_t *)(base + 0x4U))) & 0x80U) == 0x80U) ? 1 : 0); } //***************************************************************************** // //! Get the transmit FIFO status //! //! \param base is the base address of the SCI port. //! //! This functions gets the current number of words in the transmit FIFO. //! //! \return Returns the current number of words in the transmit FIFO specified //! as one of the following: //! \b SCI_FIFO_TX0, \b SCI_FIFO_TX1, \b SCI_FIFO_TX2, \b SCI_FIFO_TX3 //! \b SCI_FIFO_TX4, ..., or \b SCI_FIFO_TX16 // //***************************************************************************** static inline SCI_TxFIFOLevel SCI_getTxFIFOStatus(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 950); } } while((_Bool)0); // // Get the current FIFO status // return((SCI_TxFIFOLevel)(((*((volatile uint16_t *)(base + 0xAU))) & 0x1F00U) >> 8U)); } //***************************************************************************** // //! Get the receive FIFO status //! //! \param base is the base address of the SCI port. //! //! This functions gets the current number of words in the receive FIFO. //! //! \return Returns the current number of words in the receive FIFO specified //! as one of the following: //! \b SCI_FIFO_RX0, \b SCI_FIFO_RX1, \b SCI_FIFO_RX2, \b SCI_FIFO_RX3 //! \b SCI_FIFO_RX4, ..., or \b SCI_FIFO_RX16 // //***************************************************************************** static inline SCI_RxFIFOLevel SCI_getRxFIFOStatus(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 979); } } while((_Bool)0); // // Get the current FIFO status // return((SCI_RxFIFOLevel)(((*((volatile uint16_t *)(base + 0xBU))) & 0x1F00U) >> 8U)); } //***************************************************************************** // //! Determines whether the SCI transmitter is busy or not. //! //! \param base is the base address of the SCI port. //! //! Allows the caller to determine whether all transmitted bytes have cleared //! the transmitter hardware when the FIFO is not enabled. When the FIFO is //! enabled, this function allows the caller to determine whether there is any //! data in the FIFO. //! //! Without the FIFO enabled, if \b false is returned, the transmit buffer and //! shift registers are empty and the transmitter is not busy. With the FIFO //! enabled, if \b false is returned, the FIFO is empty. This does not //! necessarily mean that the transmitter is not busy. The empty FIFO does not //! reflect the status of the transmitter shift register. The FIFO may be empty //! while the transmitter is still transmitting data. //! //! \return Returns \b true if the SCI is transmitting or \b false if //! transmissions are complete. // //***************************************************************************** static inline _Bool SCI_isTransmitterBusy(uint32_t base) { // // Check the argument. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1016); } } while((_Bool)0); // // Check if FIFO enhancement is enabled. // if(SCI_isFIFOEnabled(base)) { // // With FIFO enhancement, determine if the SCI is busy. // return((((*((volatile uint16_t *)(base + 0xAU))) & 0x1F00U) != 0U) ? 1 : 0); } else { // // Without FIFO enhancement, determine if the SCI is busy. // Check if the transmit buffer and shift register empty. // return((((*((volatile uint16_t *)(base + 0x4U))) & 0x40U) == 0x40U) ? 0 : 1); } } //***************************************************************************** // //! Waits to send a character from the specified port when the FIFO enhancement //! is enabled. //! //! \param base is the base address of the SCI port. //! \param data is the character to be transmitted. //! //! Sends the character \e data to the transmit buffer for the specified port. //! If there is no space available in the transmit FIFO, this function waits //! until there is space available before returning. \e data is a uint16_t but //! only 8 bits are written to the SCI port. SCI only transmits 8 bit //! characters. //! //! \return None. // //***************************************************************************** static inline void SCI_writeCharBlockingFIFO(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1063); } } while((_Bool)0); // // Wait until space is available in the transmit FIFO. // while(SCI_getTxFIFOStatus(base) == SCI_FIFO_TX16) { } // // Send a char. // (*((volatile uint16_t *)(base + 0x9U))) = data; } //***************************************************************************** // //! Waits to send a character from the specified port. //! //! \param base is the base address of the SCI port. //! \param data is the character to be transmitted. //! //! Sends the character \e data to the transmit buffer for the specified port. //! If there is no space available in the transmit buffer, or the transmit //! FIFO if it is enabled, this function waits until there is space available //! before returning. \e data is a uint16_t but only 8 bits are written to the //! SCI port. SCI only transmits 8 bit characters. //! //! \return None. // //***************************************************************************** static inline void SCI_writeCharBlockingNonFIFO(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1100); } } while((_Bool)0); // // Wait until space is available in the transmit buffer. // while(!SCI_isSpaceAvailableNonFIFO(base)) { } // // Send a char. // (*((volatile uint16_t *)(base + 0x9U))) = data; } //***************************************************************************** // //! Sends a character to the specified port. //! //! \param base is the base address of the SCI port. //! \param data is the character to be transmitted. //! //! Writes the character \e data to the transmit buffer for the specified port. //! This function does not block and only writes to the transmit buffer. //! The user should use SCI_isSpaceAvailableNonFIFO() or SCI_getTxFIFOStatus() //! to determine if the transmit buffer or FIFO have space available. //! \e data is a uint16_t but only 8 bits are written to the SCI port. SCI //! only transmits 8 bit characters. //! //! This function replaces the original SCICharNonBlockingPut() API and //! performs the same actions. A macro is provided in sci.h to map //! the original API to this API. //! //! \return None. // //***************************************************************************** static inline void SCI_writeCharNonBlocking(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1142); } } while((_Bool)0); // // Send a char. // (*((volatile uint16_t *)(base + 0x9U))) = data; } //***************************************************************************** // //! Gets current receiver status flags. //! //! \param base is the base address of the SCI port. //! //! This function returns the current receiver status flags. The returned //! error flags are equivalent to the error bits returned via the previous //! reading or receiving of a character with the exception that the overrun //! error is set immediately the overrun occurs rather than when a character //! is next read. //! //! \return Returns a bitwise OR combination of the receiver status flags, //! \b SCI_RXSTATUS_WAKE, \b SCI_RXSTATUS_PARITY, \b SCI_RXSTATUS_OVERRUN, //! \b SCI_RXSTATUS_FRAMING, \b SCI_RXSTATUS_BREAK, \b SCI_RXSTATUS_READY, //! and \b SCI_RXSTATUS_ERROR. // //***************************************************************************** static inline uint16_t SCI_getRxStatus(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1174); } } while((_Bool)0); // // Return the current value of the receive status register. // return((*((volatile uint16_t *)(base + 0x5U)))); } //***************************************************************************** // //! Waits for a character from the specified port when the FIFO enhancement //! is enabled. //! //! \param base is the base address of the SCI port. //! //! Gets a character from the receive FIFO for the specified port. If there //! are no characters available, this function waits until a character is //! received before returning. Returns immediately in case of Error. //! //! \return Returns the character read from the specified port as \e uint16_t //! or 0x0 in case of Error. The application must use //! SCI_getRxStatus() API to check if some error occurred before //! consuming the data // //***************************************************************************** static inline uint16_t SCI_readCharBlockingFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1205); } } while((_Bool)0); // // Wait until a character is available in the receive FIFO. // while(SCI_getRxFIFOStatus(base) == SCI_FIFO_RX0) { // //If there is any error return // if((SCI_getRxStatus(base) & 0x0080U) != 0U) { return(0U); } } // // Return the character from the receive buffer. // return((uint16_t)((*((volatile uint16_t *)(base + 0x7U))) & 0xFFU)); } //***************************************************************************** // //! Waits for a character from the specified port when the FIFO enhancement //! is not enabled. //! //! \param base is the base address of the SCI port. //! //! Gets a character from the receive buffer for the specified port. If there //! is no characters available, this function waits until a character is //! received before returning. //! //! \return Returns the character read from the specified port as \e uint16_t. // //***************************************************************************** static inline uint16_t SCI_readCharBlockingNonFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1247); } } while((_Bool)0); // // Wait until a character is available in the receive FIFO. // while(!SCI_isDataAvailableNonFIFO(base)) { } // // Return the character from the receive buffer. // return((uint16_t)((*((volatile uint16_t *)(base + 0x7U))) & 0xFFU)); } //***************************************************************************** // //! Receives a character from the specified port. //! //! \param base is the base address of the SCI port. //! //! Gets a character from the receive buffer for the specified port. This //! function does not block and only reads the receive buffer. The user should //! use SCI_isDataAvailableNonFIFO() or SCI_getRxFIFOStatus() to determine if //! the receive buffer or FIFO have data available. //! //! This function replaces the original SCICharNonBlockingGet() API and //! performs the same actions. A macro is provided in sci.h to map //! the original API to this API. //! //! \return Returns \e uin16_t which is read from the receive buffer. // //***************************************************************************** static inline uint16_t SCI_readCharNonBlocking(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1286); } } while((_Bool)0); // // Return the character from the receive buffer. // return((uint16_t)((*((volatile uint16_t *)(base + 0x7U))) & 0xFFU)); } //***************************************************************************** // //! Performs a software reset of the SCI and Clears all reported receiver //! status flags. //! //! \param base is the base address of the SCI port. //! //! This function performs a software reset of the SCI port. It affects the //! operating flags of the SCI, but it neither affects the configuration bits //! nor restores the reset values. //! //! \return None. // //***************************************************************************** static inline void SCI_performSoftwareReset(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1314); } } while((_Bool)0); // // To clear all errors a sw reset of the module is required // (*((volatile uint16_t *)(base + 0x1U))) &= ~0x20U; (*((volatile uint16_t *)(base + 0x1U))) |= 0x20U; } //***************************************************************************** // //! Enables Loop Back Test Mode //! //! \param base is the base address of the SCI port. //! //! Enables the loop back test mode where the Tx pin is internally connected //! to the Rx pin. //! //! \return None. // //***************************************************************************** static inline void SCI_enableLoopback(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1341); } } while((_Bool)0); // // Set the loop back mode. // (*((volatile uint16_t *)(base + 0x0U))) |= 0x10U; } //***************************************************************************** // //! Disables Loop Back Test Mode //! //! \param base is the base address of the SCI port. //! //! Disables the loop back test mode where the Tx pin is no longer internally //! connected to the Rx pin. //! //! \return None. // //***************************************************************************** static inline void SCI_disableLoopback(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1367); } } while((_Bool)0); // // Clear the loop back mode. // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x10U; } //***************************************************************************** // //! Get the receive FIFO Overflow flag status //! //! \param base is the base address of the SCI port. //! //! This functions gets the receive FIFO overflow flag status. //! //! \return Returns \b true if overflow has occurred, else returned \b false if //! an overflow hasn't occurred. // //***************************************************************************** static inline _Bool SCI_getOverflowStatus(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1393); } } while((_Bool)0); // // Return the current FIFO overflow status // return(((*((volatile uint16_t *)(base + 0xBU))) & 0x8000U) == 0x8000U); } //***************************************************************************** // //! Clear the receive FIFO Overflow flag status //! //! \param base is the base address of the SCI port. //! //! This functions clears the receive FIFO overflow flag status. //! //! \return None. // //***************************************************************************** static inline void SCI_clearOverflowStatus(uint32_t base) { // // Check the arguments. // do { if(!(SCI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sci.h", 1418); } } while((_Bool)0); // // Clear the current FIFO overflow status // (*((volatile uint16_t *)(base + 0xBU))) |= 0x4000U; } //***************************************************************************** // //! Sets the configuration of a SCI. //! //! \param base is the base address of the SCI port. //! \param lspclkHz is the rate of the clock supplied to the SCI module. This //! is the LSPCLK. //! \param baud is the desired baud rate. //! \param config is the data format for the port (number of data bits, //! number of stop bits, and parity). //! //! This function configures the SCI for operation in the specified data //! format. The baud rate is provided in the \e baud parameter and the data //! format in the \e config parameter. //! //! The \e config parameter is the bitwise OR of three values: the number of //! data bits, the number of stop bits, and the parity. \b SCI_CONFIG_WLEN_8, //! \b SCI_CONFIG_WLEN_7, \b SCI_CONFIG_WLEN_6, \b SCI_CONFIG_WLEN_5, //! \b SCI_CONFIG_WLEN_4, \b SCI_CONFIG_WLEN_3, \b SCI_CONFIG_WLEN_2, and //! \b SCI_CONFIG_WLEN_1. Select from eight to one data bits per byte //! (respectively). //! \b SCI_CONFIG_STOP_ONE and \b SCI_CONFIG_STOP_TWO select one or two stop //! bits (respectively). \b SCI_CONFIG_PAR_NONE, \b SCI_CONFIG_PAR_EVEN, //! \b SCI_CONFIG_PAR_ODD, select the parity mode (no parity bit, even parity //! bit, odd parity bit respectively). //! //! The peripheral clock is the low speed peripheral clock. This will be //! the value returned by SysCtl_getLowSpeedClock(), or it can be explicitly //! hard coded if it is constant and known (to save the code/execution overhead //! of a call to SysCtl_getLowSpeedClock()). //! //! A baud rate divider (BRR) is used in this function to calculate the //! baud rate. The value of BRR is calculated in float and type casted as int //! to be fed in the \b SCIHBAUD and \b SCILBAUD registers. This conversion //! brings an error in the calculated baud rate and the requested. Error will //! be significant when operating at higher baud rates. The error is due to //! lower BRR integer value granularity at higher baud rates. //! //! \return None. // //***************************************************************************** extern void SCI_setConfig(uint32_t base, uint32_t lspclkHz, uint32_t baud, uint32_t config); //***************************************************************************** // //! Waits to send an array of characters from the specified port. //! //! \param base is the base address of the SCI port. //! \param array is the address of the array of characters to be transmitted. //! It is pointer to the array of characters to be transmitted. //! \param length is the length of the array, or number of characters in the //! array to be transmitted. //! //! Sends the number of characters specified by \e length, starting at the //! address \e array, out of the transmit buffer for the specified port. //! If there is no space available in the transmit buffer, or the transmit //! FIFO if it is enabled, this function waits until there is space available //! and \e length number of characters are transmitted before returning. //! \e array is a pointer to uint16_ts but only the least significant 8 bits //! are written to the SCI port. SCI only transmits 8 bit characters. //! //! \return None. // //***************************************************************************** extern void SCI_writeCharArray(uint32_t base, const uint16_t * const array, uint16_t length); //***************************************************************************** // //! Waits to receive an array of characters from the specified port. //! //! \param base is the base address of the SCI port. //! \param array is the address of the array of characters to be received. //! It is a pointer to the array of characters to be received. //! \param length is the length of the array, or number of characters in the //! array to be received. //! //! Receives an array of characters from the receive buffer for the specified //! port, and stores them as an array of characters starting at address //! \e array. This function waits until the \e length number of characters are //! received before returning. //! //! \return None. // //***************************************************************************** extern void SCI_readCharArray(uint32_t base, uint16_t * const array, uint16_t length); //***************************************************************************** // //! Enables individual SCI interrupt sources. //! //! \param base is the base address of the SCI port. //! \param intFlags is the bit mask of the interrupt sources to be enabled. //! //! Enables the indicated SCI interrupt sources. Only the sources that are //! enabled can be reflected to the processor interrupt; disabled sources have //! no effect on the processor. //! //! The \e intFlags parameter is the bitwise OR of any of the following: //! //! - \b SCI_INT_RXERR - RXERR Interrupt //! - \b SCI_INT_RXRDY_BRKDT - RXRDY/BRKDT Interrupt //! - \b SCI_INT_TXRDY - TXRDY Interrupt //! - \b SCI_INT_TXFF - TX FIFO Level Interrupt //! - \b SCI_INT_RXFF - RX FIFO Level Interrupt //! - \b SCI_INT_FE - Frame Error //! - \b SCI_INT_OE - Overrun Error //! - \b SCI_INT_PE - Parity Error //! //! \return None. // //***************************************************************************** extern void SCI_enableInterrupt(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Disables individual SCI interrupt sources. //! //! \param base is the base address of the SCI port. //! \param intFlags is the bit mask of the interrupt sources to be disabled. //! //! Disables the indicated SCI interrupt sources. Only the sources that are //! enabled can be reflected to the processor interrupt; disabled sources have //! no effect on the processor. //! //! The \e intFlags parameter has the same definition as the \e intFlags //! parameter to SCI_enableInterrupt(). //! //! \return None. // //***************************************************************************** extern void SCI_disableInterrupt(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Gets the current interrupt status. //! //! \param base is the base address of the SCI port. //! //! \return Returns the current interrupt status, enumerated as a bit field of //! values described in SCI_enableInterrupt(). // //***************************************************************************** extern uint32_t SCI_getInterruptStatus(uint32_t base); //***************************************************************************** // //! Clears SCI interrupt sources. //! //! \param base is the base address of the SCI port. //! \param intFlags is a bit mask of the interrupt sources to be cleared. //! //! The specified SCI interrupt sources are cleared, so that they no longer //! assert. This function must be called in the interrupt handler to keep the //! interrupt from being recognized again immediately upon exit. //! //! The \e intFlags parameter has the same definition as the \e intFlags //! parameter to SCI_enableInterrupt(). //! //! \return None. // //***************************************************************************** extern void SCI_clearInterruptStatus(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Sets SCI Baud rate. //! //! \param base is the base address of the SCI port. //! \param lspclkHz is the rate of the clock supplied to the SCI module. This //! is the LSPCLK. //! \param baud is the desired baud rate. //! //! This function configures the SCI for operation in the specified baud rate //! The baud rate is provided in the \e baud parameter. //! //! The peripheral clock is the low speed peripheral clock. This will be //! the value returned by SysCtl_getLowSpeedClock() //! //! \return None. // //***************************************************************************** extern void SCI_setBaud(uint32_t base, uint32_t lspclkHz, uint32_t baud); //***************************************************************************** // //! Sets the SCI TXWAKE flag //! //! \param base is the base address of the SCI port. //! //! This function sets the TXWAKE flag bit to indicate that the next frame //! is an address frame. //! TXWAKE bit controls selection of data-transmit feature based on //! which mode is selected from idle-line and address-bit. //! //! \return None. // //***************************************************************************** extern void SCI_setWakeFlag(uint32_t base); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: sdfm.h // // TITLE: C28x SDFM Driver // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup sdfm_api SDFM //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_sdfm.h // // TITLE: Definitions for the SDFM registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the SDFM register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDIFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDIFLGCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDMFILEN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCTLPARM1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDFPARM1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDPARM1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPH1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPL1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCPARM1 register // //************************************************************************************************* // (Sincfast/Sinc1/Sinc2/Sinc3 //************************************************************************************************* // // The following are defines for the bit fields in the SDDATA1 register // //************************************************************************************************* // mode //************************************************************************************************* // // The following are defines for the bit fields in the SDCTLPARM2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDFPARM2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDPARM2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPH2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPL2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCPARM2 register // //************************************************************************************************* // (Sincfast/Sinc1/Sinc2/Sinc3 //************************************************************************************************* // // The following are defines for the bit fields in the SDDATA2 register // //************************************************************************************************* // mode //************************************************************************************************* // // The following are defines for the bit fields in the SDCTLPARM3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDFPARM3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDPARM3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPH3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPL3 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCPARM3 register // //************************************************************************************************* // (Sincfast/Sinc1/Sinc2/Sinc3 //************************************************************************************************* // // The following are defines for the bit fields in the SDDATA3 register // //************************************************************************************************* // mode //************************************************************************************************* // // The following are defines for the bit fields in the SDCTLPARM4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDFPARM4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDDPARM4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPH4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCMPL4 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SDCPARM4 register // //************************************************************************************************* // (Sincfast/Sinc1/Sinc2/Sinc3 //************************************************************************************************* // // The following are defines for the bit fields in the SDDATA4 register // //************************************************************************************************* // mode //***************************************************************************** // // Defines for the API. // //***************************************************************************** //! Macro to get the low threshold //! //! Macro to get the high threshold //! //! Macro to convert comparator over sampling ratio to acceptable bit location //! //! Macro to convert the data shift bit values to acceptable bit location //! //! Macro to combine high threshold and low threshold values //! //! Macro to set the FIFO level to acceptable bit location //! //! Macro to set and enable the zero cross threshold value. //! //! Macros to enable or disable filter. //! //***************************************************************************** // //! Values that can be returned from SDFM_getThresholdStatus() // //***************************************************************************** typedef enum { SDFM_OUTPUT_WITHIN_THRESHOLD = 0, //!< SDFM output is within threshold SDFM_OUTPUT_ABOVE_THRESHOLD = 1, //!< SDFM output is above threshold SDFM_OUTPUT_BELOW_THRESHOLD = 2 //!< SDFM output is below threshold } SDFM_OutputThresholdStatus; //***************************************************************************** // //! Values that can be passed to all functions as the \e filterNumber //! parameter. // //***************************************************************************** typedef enum { SDFM_FILTER_1 = 0, //!< Digital filter 1 SDFM_FILTER_2 = 1, //!< Digital filter 2 SDFM_FILTER_3 = 2, //!< Digital filter 3 SDFM_FILTER_4 = 3 //!< Digital filter 4 } SDFM_FilterNumber; //***************************************************************************** // //! Values that can be passed to SDFM_setFilterType(), //! SDFM_setComparatorFilterType() as the \e filterType parameter. // //***************************************************************************** typedef enum { //! Digital filter with SincFast structure. SDFM_FILTER_SINC_FAST = 0x00, //! Digital filter with Sinc1 structure SDFM_FILTER_SINC_1 = 0x10, //! Digital filter with Sinc3 structure. SDFM_FILTER_SINC_2 = 0x20, //! Digital filter with Sinc4 structure. SDFM_FILTER_SINC_3 = 0x30 } SDFM_FilterType; //***************************************************************************** // //! Values that can be passed to SDFM_setupModulatorClock(),as the //! \e clockMode parameter. // //***************************************************************************** typedef enum { //! Modulator clock is identical to the data rate SDFM_MODULATOR_CLK_EQUAL_DATA_RATE = 0, //! Modulator clock is half the data rate SDFM_MODULATOR_CLK_HALF_DATA_RATE = 1, //! Modulator clock is off. Data is Manchester coded. SDFM_MODULATOR_CLK_OFF = 2, //! Modulator clock is double the data rate. SDFM_MODULATOR_CLK_DOUBLE_DATA_RATE = 3 } SDFM_ModulatorClockMode; //***************************************************************************** // //! Values that can be passed to SDFM_setOutputDataFormat(),as the //! \e dataFormat parameter. // //***************************************************************************** typedef enum { //! Filter output is in 16 bits 2's complement format. SDFM_DATA_FORMAT_16_BIT = 0, //! Filter output is in 32 bits 2's complement format. SDFM_DATA_FORMAT_32_BIT = 1 } SDFM_OutputDataFormat; //***************************************************************************** // // Values that can be passed to SDFM_enableInterrupt and SDFM_disableInterrupt // as intFlags parameter // //***************************************************************************** //! Interrupt is generated if Modulator fails. //! //! Interrupt on Comparator low-level threshold. //! //! Interrupt on Comparator high-level threshold. //! //! Interrupt on Acknowledge flag //! //***************************************************************************** // // Values that can be passed to SDFM_clearInterruptFlag flags parameter // //***************************************************************************** //! Main interrupt flag //! //! Filter 1 high -level threshold flag //! //! Filter 1 low -level threshold flag //! //! Filter 2 high -level threshold flag //! //! Filter 2 low -level threshold flag //! //! Filter 3 high -level threshold flag //! //! Filter 3 low -level threshold flag //! //! Filter 4 high -level threshold flag //! //! Filter 4 low -level threshold flag //! //! Filter 1 modulator failed flag //! //! Filter 2 modulator failed flag //! //! Filter 3 modulator failed flag //! //! Filter 4 modulator failed flag //! //! Filter 1 new data flag //! //! Filter 2 new data flag //! //! Filter 3 new data flag //! //! Filter 4 new data flag //! //***************************************************************************** // //! \internal //! Checks SDFM base address. //! //! \param base specifies the SDFM module base address. //! //! This function determines if SDFM module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool SDFM_isBaseValid(uint32_t base) { return( (base == 0x00005E00U) || (base == 0x00005E80U) ); } //***************************************************************************** // //! Enable external reset //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function enables data filter to be reset by an external source (PWM //! compare output). //! //! \return None. // //***************************************************************************** static inline void SDFM_enableExternalReset(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 300); } } while((_Bool)0); // // Set the SDSYNCEN bit // __eallow(); (*((volatile uint16_t *)(base + 0x11U + ((uint32_t)filterNumber * 16U)))) |= 0x1000U; __edis(); } //***************************************************************************** // //! Disable external reset //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function disables data filter from being reset by an external source //! (PWM compare output). //! //! \return None. //***************************************************************************** static inline void SDFM_disableExternalReset(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 326); } } while((_Bool)0); // // Clear the SDSYNCEN bit // __eallow(); (*((volatile uint16_t *)(base + 0x11U + ((uint32_t)filterNumber * 16U)))) &= ~0x1000U; __edis(); } //***************************************************************************** // //! Enable filter //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function enables the filter specified by the \e filterNumber variable. //! //! \return None. // //***************************************************************************** static inline void SDFM_enableFilter(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 352); } } while((_Bool)0); // // Set the FEN bit // __eallow(); (*((volatile uint16_t *)(base + 0x11U + ((uint32_t)filterNumber * 16U)))) |= 0x100U; __edis(); } //***************************************************************************** // //! Disable filter //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function disables the filter specified by the \e filterNumber //! variable. //! //! \return None. //***************************************************************************** static inline void SDFM_disableFilter(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 378); } } while((_Bool)0); // // Clear the FEN bit // __eallow(); (*((volatile uint16_t *)(base + 0x11U + ((uint32_t)filterNumber * 16U)))) &= ~0x100U; __edis(); } //***************************************************************************** // //! Set filter type. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param filterType is the filter type or structure. //! //! This function sets the filter type or structure to be used as specified by //! filterType for the selected filter number as specified by filterNumber. //! //! \return None. //***************************************************************************** static inline void SDFM_setFilterType(uint32_t base, SDFM_FilterNumber filterNumber, SDFM_FilterType filterType) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 408); } } while((_Bool)0); address = base + 0x11U + ((uint32_t)filterNumber * 16U); // // Write to SST bits // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & (~0xC00U)) | ((uint16_t)filterType << 6U); __edis(); } //***************************************************************************** // //! Set data filter over sampling ratio. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param overSamplingRatio is the data filter over sampling ratio. //! //! This function sets the filter oversampling ratio for the filter specified //! by the filterNumber variable.Valid values for the variable //! overSamplingRatio are 0 to 255 inclusive. The actual oversampling ratio //! will be this value plus one. //! //! \return None. //***************************************************************************** static inline void SDFM_setFilterOverSamplingRatio(uint32_t base, SDFM_FilterNumber filterNumber, uint16_t overSamplingRatio) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 442); } } while((_Bool)0); do { if(!(overSamplingRatio < 256U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 443); } } while((_Bool)0); address = base + 0x11U + ((uint32_t)filterNumber * 16U); // // Write to DOSR bits // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & (~0xFFU)) | overSamplingRatio; __edis(); } //***************************************************************************** // //! Set modulator clock mode. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param clockMode is the modulator clock mode. //! //! This function sets the modulator clock mode specified by clockMode //! for the filter specified by filterNumber. //! //! //! \return None. //***************************************************************************** static inline void SDFM_setupModulatorClock(uint32_t base, SDFM_FilterNumber filterNumber, SDFM_ModulatorClockMode clockMode) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 476); } } while((_Bool)0); address = base + 0x10U + ((uint32_t)filterNumber * 16U); // // Write to MOD bits // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & (~0x3U)) | (uint16_t)clockMode; __edis(); } //***************************************************************************** // //! Set the output data format //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param dataFormat is the output data format. //! //! This function sets the output data format for the filter specified by //! filterNumber. //! //! \return None. // //***************************************************************************** static inline void SDFM_setOutputDataFormat(uint32_t base, SDFM_FilterNumber filterNumber, SDFM_OutputDataFormat dataFormat) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 510); } } while((_Bool)0); address = base + 0x12U + ((uint32_t)filterNumber * 16U); // // Write to DR bit // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & (~0x400U)) | ((uint16_t)dataFormat << 10U); __edis(); } //***************************************************************************** // //! Set data shift value. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param shiftValue is the data shift value. //! //! This function sets the shift value for the 16 bit 2's complement data //! format. The valid maximum value for shiftValue is 31. //! //! \b Note: Use this function with 16 bit 2's complement data format only. //! //! \return None. // //***************************************************************************** static inline void SDFM_setDataShiftValue(uint32_t base, SDFM_FilterNumber filterNumber, uint16_t shiftValue) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 545); } } while((_Bool)0); do { if(!(shiftValue < 32U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 546); } } while((_Bool)0); address = base + 0x12U + ((uint32_t)filterNumber * 16U); // // Write to SH bit // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & (~0xF800U)) | (shiftValue << 11U); __edis(); } //***************************************************************************** // //! Set Filter output high-level threshold. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param highThreshold is the high-level threshold. //! //! This function sets the unsigned high-level threshold value for the //! Comparator filter output. If the output value of the filter exceeds //! highThreshold and interrupt generation is enabled, an interrupt will be //! issued. //! //! \return None. // //***************************************************************************** static inline void SDFM_setCompFilterHighThreshold(uint32_t base, SDFM_FilterNumber filterNumber, uint16_t highThreshold) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 581); } } while((_Bool)0); do { if(!(highThreshold < 0x7FFFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 582); } } while((_Bool)0); address = base + 0x13U + ((uint32_t)filterNumber * 16U); // // Write to HLT bit // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & ~0x7FFFU) | highThreshold; __edis(); } //***************************************************************************** // //! Set Filter output low-level threshold. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param lowThreshold is the low-level threshold. //! //! This function sets the unsigned low-level threshold value for the //! Comparator filter output. If the output value of the filter gets below //! lowThreshold and interrupt generation is enabled, an interrupt will be //! issued. //! //! \return None. // //***************************************************************************** static inline void SDFM_setCompFilterLowThreshold(uint32_t base, SDFM_FilterNumber filterNumber, uint16_t lowThreshold) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 616); } } while((_Bool)0); do { if(!(lowThreshold < 0x7FFFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 617); } } while((_Bool)0); address = base + 0x14U + ((uint32_t)filterNumber * 16U); // // Write to LLT bit // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & ~0x7FFFU) | lowThreshold; __edis(); } //***************************************************************************** // //! Enable SDFM interrupts. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param intFlags is the interrupt source. //! //! This function enables the low threshold , high threshold or modulator //! failure interrupt as determined by intFlags for the filter specified //! by filterNumber. //! Valid values for intFlags are: //! SDFM_MODULATOR_FAILURE_INTERRUPT , SDFM_LOW_LEVEL_THRESHOLD_INTERRUPT, //! SDFM_HIGH_LEVEL_THRESHOLD_INTERRUPT,SDFM_DATA_FILTER_ACKNOWLEDGE_INTERRUPT //! //! \return None. // //***************************************************************************** static inline void SDFM_enableInterrupt(uint32_t base, SDFM_FilterNumber filterNumber, uint16_t intFlags) { uint16_t offset; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 653); } } while((_Bool)0); offset = (uint16_t)filterNumber * 16U; __eallow(); // // Low, high threshold, Modulator failure // if((intFlags & (0x200U | 0x40U | 0x20U)) != 0U) { // // Set IEL or IEH or MFIE bit of SDFM_O_SDCPARMx // (*((volatile uint16_t *)(base + 0x15U + offset))) |= (intFlags & (0x200U | 0x40U | 0x20U)); } // // Data filter acknowledge interrupt // if((intFlags & 0x1U) != 0U) { (*((volatile uint16_t *)(base + 0x11U + offset))) |= 0x200U; } __edis(); } //***************************************************************************** // //! Disable SDFM interrupts. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param intFlags is the interrupt source. //! //! This function disables the low threshold , high threshold or modulator //! failure interrupt as determined by intFlags for the filter //! specified by filterNumber. //! Valid values for intFlags are: //! SDFM_MODULATOR_FAILURE_INTERRUPT , SDFM_LOW_LEVEL_THRESHOLD_INTERRUPT, //! SDFM_HIGH_LEVEL_THRESHOLD_INTERRUPT,SDFM_DATA_FILTER_ACKNOWLEDGE_INTERRUPT //! //! \return None. // //***************************************************************************** static inline void SDFM_disableInterrupt(uint32_t base, SDFM_FilterNumber filterNumber, uint16_t intFlags) { uint16_t offset; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 709); } } while((_Bool)0); offset = (uint16_t)filterNumber * 16U; __eallow(); // // Low, high threshold, modulator failure interrupts // if((intFlags & (0x200U | 0x40U | 0x20U)) != 0U) { // // Set IEL or IEH or MFIE bit of SDFM_O_SDCPARMx // (*((volatile uint16_t *)(base + 0x15U + offset))) &= ~(intFlags & (0x200U | 0x40U | 0x20U)); } // // Data filter acknowledge interrupt // if((intFlags & 0x1U) != 0U) { (*((volatile uint16_t *)(base + 0x11U + offset))) &= ~0x200U; } __edis(); } //***************************************************************************** // //! Set the comparator filter type. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param filterType is the comparator filter type or structure. //! //! This function sets the Comparator filter type or structure to be used as //! specified by filterType for the selected filter number as specified by //! filterNumber. //! //! \return None. //***************************************************************************** static inline void SDFM_setComparatorFilterType(uint32_t base, SDFM_FilterNumber filterNumber, SDFM_FilterType filterType) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 761); } } while((_Bool)0); address = base + 0x15U + ((uint32_t)filterNumber * 16U); // // Write to CS1_CS0 bits // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & (~0x180U)) | ((uint16_t)filterType << 3U); __edis(); } //***************************************************************************** // //! Set Comparator filter over sampling ratio. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! \param overSamplingRatio is the comparator filter over sampling ration. //! //! This function sets the comparator filter oversampling ratio for the filter //! specified by the filterNumber.Valid values for the variable //! overSamplingRatio are 0 to 31 inclusive. //! The actual oversampling ratio will be this value plus one. //! //! \return None. //***************************************************************************** static inline void SDFM_setCompFilterOverSamplingRatio(uint32_t base, SDFM_FilterNumber filterNumber, uint16_t overSamplingRatio) { uint32_t address; do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 796); } } while((_Bool)0); do { if(!(overSamplingRatio < 32U)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 797); } } while((_Bool)0); address = base + 0x15U + ((uint32_t)filterNumber * 16U); // // Write to COSR bits // __eallow(); (*((volatile uint16_t *)(address))) = ((*((volatile uint16_t *)(address))) & (~0x1FU)) | overSamplingRatio; __edis(); } //***************************************************************************** // //! Get the filter data output. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function returns the latest data filter output. Depending on the //! filter data output format selected, the valid value will be the lower 16 //! bits or the whole 32 bits of the returned value. //! //! \return Returns the latest data filter output. //***************************************************************************** static inline uint32_t SDFM_getFilterData(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 826); } } while((_Bool)0); // // Read SDDATA bits // return((*((volatile uint32_t *)(base + 0x16U + ((uint32_t)filterNumber * 16U))))); } //***************************************************************************** // //! Get the Comparator threshold status. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function returns the Comparator output threshold status for the given //! filterNumber. //! //! \return Returns the following status flags. //! - \b SDFM_OUTPUT_WITHIN_THRESHOLD if the output is within the //! specified threshold. //! - \b SDFM_OUTPUT_ABOVE_THRESHOLD if the output is above the high //! threshold //! - \b SDFM_OUTPUT_BELOW_THRESHOLD if the output is below the low //! threshold. //! //***************************************************************************** static inline SDFM_OutputThresholdStatus SDFM_getThresholdStatus(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 856); } } while((_Bool)0); // // Read SDIFLG high/low threshold bits // return((SDFM_OutputThresholdStatus)(((*((volatile uint32_t *)(base + 0x0U))) >> (2U * (uint16_t)filterNumber)) & 0x3U)); } //***************************************************************************** // //! Get the Modulator status. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function returns the Modulator status. //! //! \return Returns true if the Modulator is operating normally //! Returns false if the Modulator has failed //! //***************************************************************************** static inline _Bool SDFM_getModulatorStatus(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 881); } } while((_Bool)0); // // Read SDIFLG MF1, MF2, MF3 OR MF4 bits // return((((*((volatile uint32_t *)(base + 0x0U))) >> ((uint16_t)filterNumber + 8U)) & 0x1U) != 0x1U); } //***************************************************************************** // //! Check if new Filter data is available. //! //! \param base is the base address of the SDFM module //! \param filterNumber is the filter number. //! //! This function returns new filter data status. //! //! \return Returns \b true if new filter data is available //! Returns \b false if no new filter data is available //! //***************************************************************************** static inline _Bool SDFM_getNewFilterDataStatus(uint32_t base, SDFM_FilterNumber filterNumber) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 906); } } while((_Bool)0); // // Read SDIFLG AF1, AF2, AF3 OR AF4 bits // return((((*((volatile uint32_t *)(base + 0x0U))) >> ((uint16_t)filterNumber + 12U)) & 0x1U) == 0x1U); } //***************************************************************************** // //! Get pending interrupt. //! //! \param base is the base address of the SDFM module //! //! This function returns any pending interrupt status. //! //! \return Returns \b true if there is a pending interrupt. //! Returns \b false if no interrupt is pending. //! //***************************************************************************** static inline _Bool SDFM_getIsrStatus(uint32_t base) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 930); } } while((_Bool)0); // // Read SDIFLG MIF // return(((*((volatile uint32_t *)(base + 0x0U))) >> 31U) == 0x1U); } //***************************************************************************** // //! Clear pending flags. //! //! \param base is the base address of the SDFM module //! \param flag is the SDFM status //! //! This function clears the specified pending interrupt flag. //! Valid values are //! SDFM_MAIN_INTERRUPT_FLAG,SDFM_FILTER_1_NEW_DATA_FLAG, //! SDFM_FILTER_2_NEW_DATA_FLAG,SDFM_FILTER_3_NEW_DATA_FLAG, //! SDFM_FILTER_4_NEW_DATA_FLAG,SDFM_FILTER_1_MOD_FAILED_FLAG, //! SDFM_FILTER_2_MOD_FAILED_FLAG,SDFM_FILTER_3_MOD_FAILED_FLAG, //! SDFM_FILTER_4_MOD_FAILED_FLAG,SDFM_FILTER_1_HIGH_THRESHOLD_FLAG, //! SDFM_FILTER_1_LOW_THRESHOLD_FLAG,SDFM_FILTER_2_HIGH_THRESHOLD_FLAG, //! SDFM_FILTER_2_LOW_THRESHOLD_FLAG,SDFM_FILTER_3_HIGH_THRESHOLD_FLAG, //! SDFM_FILTER_3_LOW_THRESHOLD_FLAG,SDFM_FILTER_4_HIGH_THRESHOLD_FLAG, //! SDFM_FILTER_4_LOW_THRESHOLD_FLAG or any combination of the above //! flags. //! //! \return None //! //***************************************************************************** static inline void SDFM_clearInterruptFlag(uint32_t base, uint32_t flag) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 964); } } while((_Bool)0); do { if(!((flag & 0x8000FFFFU) == flag)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 965); } } while((_Bool)0); // // Write to SDIFLGCLR register // (*((volatile uint32_t *)(base + 0x2U))) |= flag; } //***************************************************************************** // //! Enable main interrupt. //! //! \param base is the base address of the SDFM module //! //! This function enables the main SDFM interrupt. //! //! \return None //! //***************************************************************************** static inline void SDFM_enableMainInterrupt(uint32_t base) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 987); } } while((_Bool)0); // // Set SDCTL MIE bit // __eallow(); (*((volatile uint16_t *)(base + 0x4U))) |= 0x2000U; __edis(); } //***************************************************************************** // //! Disable main interrupt. //! //! \param base is the base address of the SDFM module //! //! This function disables the main SDFM interrupt. //! //! \return None //! //***************************************************************************** static inline void SDFM_disableMainInterrupt(uint32_t base) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 1011); } } while((_Bool)0); // // Clear SDCTL MIE bit // __eallow(); (*((volatile uint16_t *)(base + 0x4U))) &= ~0x2000U; __edis(); } //***************************************************************************** // //! Enable main filter. //! //! \param base is the base address of the SDFM module //! //! This function enables main filter. //! //! \return None //! //***************************************************************************** static inline void SDFM_enableMainFilter(uint32_t base) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 1035); } } while((_Bool)0); // // Set SDMFILEN MFE bit // __eallow(); (*((volatile uint16_t *)(base + 0x6U))) |= 0x800U; __edis(); } //***************************************************************************** // //! Disable main filter. //! //! \param base is the base address of the SDFM module //! //! This function disables main filter. //! //! \return None //! //***************************************************************************** static inline void SDFM_disableMainFilter(uint32_t base) { do { if(!(SDFM_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/sdfm.h", 1059); } } while((_Bool)0); // // Clear SDMFILEN MFE bit // __eallow(); (*((volatile uint16_t *)(base + 0x6U))) &= ~0x800U; __edis(); } //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! Configures SDFM comparator for filter config & threshold values //! //! \param base is the base address of the SDFM module //! \param config1 is the filter number, filter type and over sampling ratio. //! \param config2 is high-level and low-level threshold values. //! //! This function configures the comparator filter for filter config and //! threshold values based on provided inputs. //! //! The config1 parameter is the logical OR of the filter number, filter type //! and oversampling ratio. //! The bit definitions for config1 are as follow: //! - config1.[3:0] filter number //! - config1.[7:4] filter type //! - config1.[15:8] Over sampling Ratio //! Valid values for filter number and filter type are defined in //! SDFM_FilterNumber and SDFM_FilterType enumerations respectively. //! SDFM_SET_OSR(X) macro can be used to set the value of the oversampling //! ratio ,which ranges [1,32] inclusive, in the appropriate bit location. //! For example the value //! (SDFM_FILTER_1 | SDFM_FILTER_SINC_2 | SDFM_SET_OSR(16)) //! will select Filter 1, SINC 2 type with an oversampling ratio of 16. //! //! The config2 parameter is the logical OR of the filter high and low //! threshold values. //! The bit definitions for config2 are as follow: //! - config2.[15:0] low threshold //! - config2.[31:16] high threshold //! The upper 16 bits define the high threshold and the lower //! 16 bits define the low threshold. //! SDFM_THRESHOLD(H,L) can be used to combine the high and low thresholds. //! //! \return None. //! //***************************************************************************** extern void SDFM_configComparator(uint32_t base, uint16_t config1, uint32_t config2); //***************************************************************************** // //! Configure SDFM data filter //! //! \param base is the base address of the SDFM module //! \param config1 is the filter number, filter type and over sampling ratio //! configuration. //! \param config2 is filter switch, data representation and data shift values //! configuration. //! //! This function configures the data filter based on configurations //! config1 and config2. //! //! The config1 parameter is the logical OR of the filter number, filter type //! and oversampling ratio. //! The bit definitions for config1 are as follow: //! - config1.[3:0] Filter number //! - config1.[7:4] Filter type //! - config1.[15:8] Over sampling Ratio //! Valid values for filter number and filter type are defined in //! SDFM_FilterNumber and SDFM_FilterType enumerations respectively. //! SDFM_SET_OSR(X) macro can be used to set the value of the oversampling //! ratio , which ranges [1,256] inclusive , in the appropriate bit location //! for config1. For example the value //! (SDFM_FILTER_2 | SDFM_FILTER_SINC_3 | SDFM_SET_OSR(64)) //! will select Filter 2 , SINC 3 type with an oversampling ratio of 64. //! //! The config2 parameter is the logical OR of data representation, filter //! switch, and data shift values //! The bit definitions for config2 are as follow: //! - config2.[0] Data representation //! - config2.[1] Filter switch //! - config2.[15:2] Shift values //! Valid values for data representation are given in SDFM_OutputDataFormat //! enumeration. SDFM_FILTER_DISABLE or SDFM_FILTER_ENABLE will define the //! filter switch values.SDFM_SHIFT_VALUE(X) macro can be used to set the value //! of the data shift value,which ranges [0,31] inclusive, in the appropriate //! bit location for config2. //! The shift value is valid only in SDFM_DATA_FORMAT_16_BIT data //! representation format. //! //! \return None. //! //***************************************************************************** extern void SDFM_configDataFilter(uint32_t base, uint16_t config1, uint16_t config2); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: spi.h // // TITLE: C28x SPI driver. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup spi_api SPI //! \brief This module is used for SPI configurations. //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_spi.h // // TITLE: Definitions for the SPI registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the SPI register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPICCR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPICTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPISTS register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPIBRR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPIFFTX register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPIFFRX register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPIFFCT register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the SPIPRI register // //************************************************************************************************* //***************************************************************************** // // Values that can be passed to SPI_enableInterrupt(), SPI_disableInterrupt(), // and SPI_clearInterruptStatus() as the intFlags parameter, and returned by // SPI_getInterruptStatus(). // //***************************************************************************** //***************************************************************************** // //! This macro definition is used to transmit a byte of data //! //! \param base specifies the SPI module base address. //! \param txData is the data to be transmitted over SPI //! //! This macro definition is to transmit a byte of data. //! This macro uses SPI_pollingNonFIFOTransaction function //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! This macro definition is used to transmit a 16-bit word of data //! //! \param base specifies the SPI module base address. //! \param txData is the data to be transmitted over SPI //! //! This macro definition is to transmit a 16-bit word of data. //! This macro uses SPI_pollingNonFIFOTransaction function //! SPI character length must be configured to 16 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! This macro definition can be used to transmit 'N' bytes of data //! //! \param base specifies the SPI module base address. //! \param txBuffer is the transmit buffer to be transmitted over SPI //! \param numOfWords is the number of bytes to be transmitted //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This macro definition can be used to transmit 'N' bytes of data. //! This macro definition uses SPI_pollingFIFOTransaction function. //! //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! This macro definition can be used to transmit 'N' 16-bit words of data //! //! \param base specifies the SPI module base address. //! \param txBuffer is the transmit buffer to be transmitted over SPI //! \param numOfWords is the number of 16-bit word to be transmitted //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function can be used to transmit 'N' 16-bit words of data. //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 16 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! This macro definition can be used to transmit 'N' with previously //! configured SPI character length //! //! \param base specifies the SPI module base address //! \param charLength specifies the SPI character length //! \param txBuffer is the transmit buffer to be transmitted over SPI //! \param numOfWords is the number of 16-bit word to be transmitted //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This macro definition can be used to transmit 'N' with configurable //! SPI character length. //! //! This macro uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to required value BEFORE calling //! the function, and passed as the charLength parameter. //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! This macro definition is used to receive a byte of data //! //! \param base specifies the SPI module base address. //! \param dummyData is the data which is transmitted to initiate //! SPI transaction to receive SPI data //! //! This macro definition is to receive a byte of data. //! This macro uses SPI_pollingNonFIFOTransaction function //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return the received byte. // //***************************************************************************** //***************************************************************************** // //! This macro is used to receive 'N' bytes of data //! //! \param base specifies the SPI module base address. //! \param rxBuffer specifies receive buffer which will store the received bytes //! \param numOfWords specifies the number of bytes to be received //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function is used to receive 'N' bytes of data //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! This macro is used to receive 'N' 16-bits words of data //! //! \param base specifies the SPI module base address. //! \param rxBuffer specifies receive buffer which will store the received bytes //! \param numOfWords specifies the number of 16-bit words to be received //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function is used to receive 'N' 16-bit words of data //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 16 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! This macro is used to receive 'N' words with previously configured character //! length //! //! \param base specifies the SPI module base address. //! \param charLength specifies the SPI character length of SPI transaction //! \param rxBuffer specifies receive buffer which will store the received bytes //! \param numOfWords specifies the number of words with specified character //! length //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function is used to receive 'N' words with specified character length //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to required value BEFORE calling //! the function, and passed as the charLength parameter. //! //! \return None. // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to SPI_setConfig() as the \e protocol parameter. // //***************************************************************************** typedef enum { //! Mode 0. Polarity 0, phase 0. Rising edge without delay. SPI_PROT_POL0PHA0 = 0x0000U, //! Mode 1. Polarity 0, phase 1. Rising edge with delay. SPI_PROT_POL0PHA1 = 0x0002U, //! Mode 2. Polarity 1, phase 0. Falling edge without delay. SPI_PROT_POL1PHA0 = 0x0001U, //! Mode 3. Polarity 1, phase 1. Falling edge with delay. SPI_PROT_POL1PHA1 = 0x0003U } SPI_TransferProtocol; //***************************************************************************** // //! Values that can be passed to SPI_setConfig() as the \e mode parameter. // //***************************************************************************** typedef enum { SPI_MODE_PERIPHERAL = 0x0002U, //!< SPI peripheral SPI_MODE_CONTROLLER = 0x0006U, //!< SPI controller SPI_MODE_PERIPHERAL_OD = 0x0000U, //!< SPI peripheral w/ output disabled SPI_MODE_CONTROLLER_OD = 0x0004U //!< SPI controller w/ output disabled } SPI_Mode; //***************************************************************************** // //! Values that can be passed to SPI_setFIFOInterruptLevel() as the \e txLevel //! parameter, returned by SPI_getFIFOInterruptLevel() in the \e txLevel //! parameter, and returned by SPI_getTxFIFOStatus(). // //***************************************************************************** typedef enum { SPI_FIFO_TXEMPTY = 0x0000U, //!< Transmit FIFO empty SPI_FIFO_TX0 = 0x0000U, //!< Transmit FIFO empty SPI_FIFO_TX1 = 0x0001U, //!< Transmit FIFO 1/16 full SPI_FIFO_TX2 = 0x0002U, //!< Transmit FIFO 2/16 full SPI_FIFO_TX3 = 0x0003U, //!< Transmit FIFO 3/16 full SPI_FIFO_TX4 = 0x0004U, //!< Transmit FIFO 4/16 full SPI_FIFO_TX5 = 0x0005U, //!< Transmit FIFO 5/16 full SPI_FIFO_TX6 = 0x0006U, //!< Transmit FIFO 6/16 full SPI_FIFO_TX7 = 0x0007U, //!< Transmit FIFO 7/16 full SPI_FIFO_TX8 = 0x0008U, //!< Transmit FIFO 8/16 full SPI_FIFO_TX9 = 0x0009U, //!< Transmit FIFO 9/16 full SPI_FIFO_TX10 = 0x000AU, //!< Transmit FIFO 10/16 full SPI_FIFO_TX11 = 0x000BU, //!< Transmit FIFO 11/16 full SPI_FIFO_TX12 = 0x000CU, //!< Transmit FIFO 12/16 full SPI_FIFO_TX13 = 0x000DU, //!< Transmit FIFO 13/16 full SPI_FIFO_TX14 = 0x000EU, //!< Transmit FIFO 14/16 full SPI_FIFO_TX15 = 0x000FU, //!< Transmit FIFO 15/16 full SPI_FIFO_TX16 = 0x0010U, //!< Transmit FIFO full SPI_FIFO_TXFULL = 0x0010U //!< Transmit FIFO full } SPI_TxFIFOLevel; //***************************************************************************** // //! Values that can be passed to SPI_setFIFOInterruptLevel() as the \e rxLevel //! parameter, returned by SPI_getFIFOInterruptLevel() in the \e rxLevel //! parameter, and returned by SPI_getRxFIFOStatus(). // //***************************************************************************** typedef enum { SPI_FIFO_RXEMPTY = 0x0000U, //!< Receive FIFO empty SPI_FIFO_RX0 = 0x0000U, //!< Receive FIFO empty SPI_FIFO_RX1 = 0x0001U, //!< Receive FIFO 1/16 full SPI_FIFO_RX2 = 0x0002U, //!< Receive FIFO 2/16 full SPI_FIFO_RX3 = 0x0003U, //!< Receive FIFO 3/16 full SPI_FIFO_RX4 = 0x0004U, //!< Receive FIFO 4/16 full SPI_FIFO_RX5 = 0x0005U, //!< Receive FIFO 5/16 full SPI_FIFO_RX6 = 0x0006U, //!< Receive FIFO 6/16 full SPI_FIFO_RX7 = 0x0007U, //!< Receive FIFO 7/16 full SPI_FIFO_RX8 = 0x0008U, //!< Receive FIFO 8/16 full SPI_FIFO_RX9 = 0x0009U, //!< Receive FIFO 9/16 full SPI_FIFO_RX10 = 0x000AU, //!< Receive FIFO 10/16 full SPI_FIFO_RX11 = 0x000BU, //!< Receive FIFO 11/16 full SPI_FIFO_RX12 = 0x000CU, //!< Receive FIFO 12/16 full SPI_FIFO_RX13 = 0x000DU, //!< Receive FIFO 13/16 full SPI_FIFO_RX14 = 0x000EU, //!< Receive FIFO 14/16 full SPI_FIFO_RX15 = 0x000FU, //!< Receive FIFO 15/16 full SPI_FIFO_RX16 = 0x0010U, //!< Receive FIFO full SPI_FIFO_RXFULL = 0x0010U, //!< Receive FIFO full SPI_FIFO_RXDEFAULT = 0x001FU //!< To prevent interrupt at reset } SPI_RxFIFOLevel; //***************************************************************************** // //! Values that can be passed to SPI_setEmulationMode() as the \e mode //! parameter. // //***************************************************************************** typedef enum { //! Transmission stops after midway in the bit stream SPI_EMULATION_STOP_MIDWAY = 0x0000U, //! Continue SPI operation regardless SPI_EMULATION_FREE_RUN = 0x0010U, //! Transmission will stop after a started transmission completes SPI_EMULATION_STOP_AFTER_TRANSMIT = 0x0020U } SPI_EmulationMode; //***************************************************************************** // //! Values that can be passed to SPI_setPTESignalPolarity() as the \e polarity //! parameter. // //***************************************************************************** typedef enum { SPI_PTE_ACTIVE_LOW = 0x0000U, //!< SPIPTE is active low (normal) SPI_PTE_ACTIVE_HIGH = 0x2U //!< SPIPTE is active high (inverted) } SPI_PTEPolarity; //***************************************************************************** // //! Values that can be passed to SPI_receive16Bits(), SPI_receive24Bits(), //! SPI_receive32Bits() // //***************************************************************************** typedef enum { SPI_DATA_LITTLE_ENDIAN = 0U, //!< LITTLE ENDIAN SPI_DATA_BIG_ENDIAN = 1U, //!< BIG ENDIAN } SPI_endianess; //***************************************************************************** // // Prototypes for the APIs. // //***************************************************************************** //***************************************************************************** // //! \internal //! Checks an SPI base address. //! //! \param base specifies the SPI module base address. //! //! This function determines if a SPI module base address is valid. //! //! \return Returns \b true if the base address is valid and \b false //! otherwise. // //***************************************************************************** static inline _Bool SPI_isBaseValid(uint32_t base) { return( (base == 0x00006100U) || (base == 0x00006110U) || (base == 0x00006120U) ); } //***************************************************************************** // //! Enables the serial peripheral interface. //! //! \param base specifies the SPI module base address. //! //! This function enables operation of the serial peripheral interface. The //! serial peripheral interface must be configured before it is enabled. //! //! \return None. // //***************************************************************************** static inline void SPI_enableModule(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 459); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x0U))) |= 0x80U; } //***************************************************************************** // //! Disables the serial peripheral interface. //! //! \param base specifies the SPI module base address. //! //! This function disables operation of the serial peripheral interface. Call //! this function before doing any configuration. //! //! \return None. // //***************************************************************************** static inline void SPI_disableModule(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 482); } } while((_Bool)0); (*((volatile uint16_t *)(base + 0x0U))) &= ~(0x80U); } //***************************************************************************** // //! Sets the character length of SPI transaction //! //! \param base specifies the SPI module base address. //! \param charLength specifies the character length of SPI transaction //! //! This function configures the character length of SPI transaction. //! SPI character length can be from anywhere between 1-bit word to 16 bit word //! of character length //! //! \return None. // //***************************************************************************** static inline void SPI_setcharLength(uint32_t base, uint16_t charLength) { do { if(!((charLength >= 1U) && (charLength <= 16U))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 504); } } while((_Bool)0); SPI_disableModule(base); (*((volatile uint16_t *)(base + 0x0U))) = ((*((volatile uint16_t *)(base + 0x0U))) & ~0xFU) | (charLength - 1U); SPI_enableModule(base); } //***************************************************************************** // //! Enables the transmit and receive FIFOs. //! //! \param base is the base address of the SPI port. //! //! This functions enables the transmit and receive FIFOs in the SPI. //! //! \return None. // //***************************************************************************** static inline void SPI_enableFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 529); } } while((_Bool)0); // // Enable the FIFO. // (*((volatile uint16_t *)(base + 0xAU))) |= 0x4000U | 0x2000U; (*((volatile uint16_t *)(base + 0xBU))) |= 0x2000U; } //***************************************************************************** // //! Disables the transmit and receive FIFOs. //! //! \param base is the base address of the SPI port. //! //! This functions disables the transmit and receive FIFOs in the SPI. //! //! \return None. // //***************************************************************************** static inline void SPI_disableFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 555); } } while((_Bool)0); // // Disable the FIFO. // (*((volatile uint16_t *)(base + 0xAU))) &= ~(0x4000U | 0x2000U); (*((volatile uint16_t *)(base + 0xBU))) &= ~0x2000U; } //***************************************************************************** // //! Resets the transmit FIFO. //! //! \param base is the base address of the SPI port. //! //! This function resets the transmit FIFO, setting the FIFO pointer back to //! zero. //! //! \return None. // //***************************************************************************** static inline void SPI_resetTxFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 582); } } while((_Bool)0); // // Reset the TX FIFO. // (*((volatile uint16_t *)(base + 0xAU))) &= ~0x2000U; (*((volatile uint16_t *)(base + 0xAU))) |= 0x2000U; } //***************************************************************************** // //! Resets the receive FIFO. //! //! \param base is the base address of the SPI port. //! //! This function resets the receive FIFO, setting the FIFO pointer back to //! zero. //! //! \return None. // //***************************************************************************** static inline void SPI_resetRxFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 609); } } while((_Bool)0); // // Reset the RX FIFO. // (*((volatile uint16_t *)(base + 0xBU))) &= ~0x2000U; (*((volatile uint16_t *)(base + 0xBU))) |= 0x2000U; } //***************************************************************************** // //! Sets the FIFO level at which interrupts are generated. //! //! \param base is the base address of the SPI port. //! \param txLevel is the transmit FIFO interrupt level, specified as //! \b SPI_FIFO_TX0, \b SPI_FIFO_TX1, \b SPI_FIFO_TX2, . . . or //! \b SPI_FIFO_TX16. //! \param rxLevel is the receive FIFO interrupt level, specified as //! \b SPI_FIFO_RX0, \b SPI_FIFO_RX1, \b SPI_FIFO_RX2, . . . or //! \b SPI_FIFO_RX16. //! //! This function sets the FIFO level at which transmit and receive interrupts //! are generated. //! //! \return None. // //***************************************************************************** static inline void SPI_setFIFOInterruptLevel(uint32_t base, SPI_TxFIFOLevel txLevel, SPI_RxFIFOLevel rxLevel) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 643); } } while((_Bool)0); // // Set the FIFO interrupt levels. // (*((volatile uint16_t *)(base + 0xAU))) = ((*((volatile uint16_t *)(base + 0xAU))) & (~0x1FU)) | (uint16_t)txLevel; (*((volatile uint16_t *)(base + 0xBU))) = ((*((volatile uint16_t *)(base + 0xBU))) & (~0x1FU)) | (uint16_t)rxLevel; } //***************************************************************************** // //! Gets the FIFO level at which interrupts are generated. //! //! \param base is the base address of the SPI port. //! \param txLevel is a pointer to storage for the transmit FIFO level, //! returned as one of \b SPI_FIFO_TX0, \b SPI_FIFO_TX1, //! \b SPI_FIFO_TX2, . . . or \b SPI_FIFO_TX16. //! \param rxLevel is a pointer to storage for the receive FIFO level, //! returned as one of \b SPI_FIFO_RX0, \b SPI_FIFO_RX1, //! \b SPI_FIFO_RX2, . . . or \b SPI_FIFO_RX16. //! //! This function gets the FIFO level at which transmit and receive interrupts //! are generated. //! //! \return None. // //***************************************************************************** static inline void SPI_getFIFOInterruptLevel(uint32_t base, SPI_TxFIFOLevel *txLevel, SPI_RxFIFOLevel *rxLevel) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 679); } } while((_Bool)0); // // Extract the transmit and receive FIFO levels. // *txLevel = (SPI_TxFIFOLevel)((uint16_t)((*((volatile uint16_t *)(base + 0xAU))) & 0x1FU)); *rxLevel = (SPI_RxFIFOLevel)((uint16_t)((*((volatile uint16_t *)(base + 0xBU))) & 0x1FU)); } //***************************************************************************** // //! Get the transmit FIFO status //! //! \param base is the base address of the SPI port. //! //! This function gets the current number of words in the transmit FIFO. //! //! \return Returns the current number of words in the transmit FIFO specified //! as one of the following: //! \b SPI_FIFO_TX0, \b SPI_FIFO_TX1, \b SPI_FIFO_TX2, \b SPI_FIFO_TX3, //! ..., or \b SPI_FIFO_TX16 // //***************************************************************************** static inline SPI_TxFIFOLevel SPI_getTxFIFOStatus(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 710); } } while((_Bool)0); // // Get the current FIFO status // return((SPI_TxFIFOLevel)((uint16_t)(((*((volatile uint16_t *)(base + 0xAU))) & 0x1F00U) >> 8U))); } //***************************************************************************** // //! Get the receive FIFO status //! //! \param base is the base address of the SPI port. //! //! This function gets the current number of words in the receive FIFO. //! //! \return Returns the current number of words in the receive FIFO specified //! as one of the following: //! \b SPI_FIFO_RX0, \b SPI_FIFO_RX1, \b SPI_FIFO_RX2, \b SPI_FIFO_RX3, //! ..., or \b SPI_FIFO_RX16 // //***************************************************************************** static inline SPI_RxFIFOLevel SPI_getRxFIFOStatus(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 739); } } while((_Bool)0); // // Get the current FIFO status // return((SPI_RxFIFOLevel)((uint16_t)(((*((volatile uint16_t *)(base + 0xBU))) & 0x1F00U) >> 8U))); } //***************************************************************************** // //! Determines whether the SPI transmitter is busy or not. //! //! \param base is the base address of the SPI port. //! //! This function allows the caller to determine whether all transmitted bytes //! have cleared the transmitter hardware. If \b false is returned, then the //! transmit FIFO is empty and all bits of the last transmitted word have left //! the hardware shift register. This function is only valid when operating in //! FIFO mode. //! //! \return Returns \b true if the SPI is transmitting or \b false if all //! transmissions are complete. // //***************************************************************************** static inline _Bool SPI_isBusy(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 770); } } while((_Bool)0); // // Determine if the SPI is busy. // return(((*((volatile uint16_t *)(base + 0xAU))) & 0x1F00U) != 0U); } //***************************************************************************** // //! Puts a data element into the SPI transmit buffer. //! //! \param base specifies the SPI module base address. //! \param data is the left-justified data to be transmitted over SPI. //! //! This function places the supplied data into the transmit buffer of the //! specified SPI module. //! //! \note The data being sent must be left-justified in \e data. The lower //! 16 - N bits will be discarded where N is the data width selected in //! SPI_setConfig(). For example, if configured for a 6-bit data width, the //! lower 10 bits of data will be discarded. //! //! \return None. // //***************************************************************************** static inline void SPI_writeDataNonBlocking(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 802); } } while((_Bool)0); // // Write data to the transmit buffer. // (*((volatile uint16_t *)(base + 0x8U))) = data; } //***************************************************************************** // //! Gets a data element from the SPI receive buffer. //! //! \param base specifies the SPI module base address. //! //! This function gets received data from the receive buffer of the specified //! SPI module and returns it. //! //! \note Only the lower N bits of the value written to \e data contain valid //! data, where N is the data width as configured by SPI_setConfig(). For //! example, if the interface is configured for 8-bit data width, only the //! lower 8 bits of the value written to \e data contain valid data. //! //! \return Returns the word of data read from the SPI receive buffer. // //***************************************************************************** static inline uint16_t SPI_readDataNonBlocking(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 833); } } while((_Bool)0); // // Check for data to read. // return((*((volatile uint16_t *)(base + 0x7U)))); } //***************************************************************************** // //! Waits for space in the FIFO and then puts data into the transmit buffer. //! //! \param base specifies the SPI module base address. //! \param data is the left-justified data to be transmitted over SPI. //! //! This function places the supplied data into the transmit buffer of the //! specified SPI module once space is available in the transmit FIFO. This //! function should only be used when the FIFO is enabled. //! //! \note The data being sent must be left-justified in \e data. The lower //! 16 - N bits will be discarded where N is the data width selected in //! SPI_setConfig(). For example, if configured for a 6-bit data width, the //! lower 10 bits of data will be discarded. //! //! \return None. // //***************************************************************************** static inline void SPI_writeDataBlockingFIFO(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 866); } } while((_Bool)0); // // Wait until space is available in the receive FIFO. // while(SPI_getTxFIFOStatus(base) == SPI_FIFO_TXFULL) { } // // Write data to the transmit buffer. // (*((volatile uint16_t *)(base + 0x8U))) = data; } //***************************************************************************** // //! Waits for data in the FIFO and then reads it from the receive buffer. //! //! \param base specifies the SPI module base address. //! //! This function waits until there is data in the receive FIFO and then reads //! received data from the receive buffer. This function should only be used //! when FIFO mode is enabled. //! //! \note Only the lower N bits of the value written to \e data contain valid //! data, where N is the data width as configured by SPI_setConfig(). For //! example, if the interface is configured for 8-bit data width, only the //! lower 8 bits of the value written to \e data contain valid data. //! //! \return Returns the word of data read from the SPI receive buffer. // //***************************************************************************** static inline uint16_t SPI_readDataBlockingFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 905); } } while((_Bool)0); // // Wait until data is available in the receive FIFO. // while(SPI_getRxFIFOStatus(base) == SPI_FIFO_RXEMPTY) { } // // Check for data to read. // return((*((volatile uint16_t *)(base + 0x7U)))); } //***************************************************************************** // //! Waits for the transmit buffer to empty and then writes data to it. //! //! \param base specifies the SPI module base address. //! \param data is the left-justified data to be transmitted over SPI. //! //! This function places the supplied data into the transmit buffer of the //! specified SPI module once it is empty. This function should not be used //! when FIFO mode is enabled. //! //! \note The data being sent must be left-justified in \e data. The lower //! 16 - N bits will be discarded where N is the data width selected in //! SPI_setConfig(). For example, if configured for a 6-bit data width, the //! lower 10 bits of data will be discarded. //! //! \return None. // //***************************************************************************** static inline void SPI_writeDataBlockingNonFIFO(uint32_t base, uint16_t data) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 945); } } while((_Bool)0); // // Wait until the transmit buffer is not full. // while(((*((volatile uint16_t *)(base + 0x2U))) & 0x20U) != 0U) { } // // Write data to the transmit buffer. // (*((volatile uint16_t *)(base + 0x8U))) = data; } //***************************************************************************** // //! Waits for data to be received and then reads it from the buffer. //! //! \param base specifies the SPI module base address. //! //! This function waits for data to be received and then reads it from the //! receive buffer of the specified SPI module. This function should not be //! used when FIFO mode is enabled. //! //! \note Only the lower N bits of the value written to \e data contain valid //! data, where N is the data width as configured by SPI_setConfig(). For //! example, if the interface is configured for 8-bit data width, only the //! lower 8 bits of the value written to \e data contain valid data. //! //! \return Returns the word of data read from the SPI receive buffer. // //***************************************************************************** static inline uint16_t SPI_readDataBlockingNonFIFO(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 984); } } while((_Bool)0); // // Wait until data has been received. // while(((*((volatile uint16_t *)(base + 0x2U))) & 0x40U) == 0U) { } // // Check for data to read. // return((*((volatile uint16_t *)(base + 0x7U)))); } //***************************************************************************** // //! Enables SPI 3-wire mode. //! //! \param base is the base address of the SPI port. //! //! This function enables 3-wire mode. When in controller mode, this allows //! SPIPICO to become SPICOCI and SPIPOCI to become free for non-SPI use. //! When in peripheral mode, SPIPOCI because the SPIPIPO pin and SPIPICO is //! free for non-SPI use. //! //! \return None. // //***************************************************************************** static inline void SPI_enableTriWire(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1019); } } while((_Bool)0); // // Set the tri-wire bit to enable 3-wire mode. // (*((volatile uint16_t *)(base + 0xFU))) |= 0x1U; } //***************************************************************************** // //! Disables SPI 3-wire mode. //! //! \param base is the base address of the SPI port. //! //! This function disables 3-wire mode. SPI will operate in normal 4-wire mode. //! //! \return None. // //***************************************************************************** static inline void SPI_disableTriWire(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1044); } } while((_Bool)0); // // Clear the tri-wire bit to disable 3-wire mode. // (*((volatile uint16_t *)(base + 0xFU))) &= ~0x1U; } //***************************************************************************** // //! Enables SPI loopback mode. //! //! \param base is the base address of the SPI port. //! //! This function enables loopback mode. This mode is only valid during //! controller mode and is helpful during device testing as it internally //! connects PICO and POCI. //! //! \return None. // //***************************************************************************** static inline void SPI_enableLoopback(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1071); } } while((_Bool)0); // // Set the bit that enables loopback mode. // (*((volatile uint16_t *)(base + 0x0U))) |= 0x10U; } //***************************************************************************** // //! Disables SPI loopback mode. //! //! \param base is the base address of the SPI port. //! //! This function disables loopback mode. Loopback mode is disabled by default //! after reset. //! //! \return None. // //***************************************************************************** static inline void SPI_disableLoopback(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1097); } } while((_Bool)0); // // Clear the bit that enables loopback mode. // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x10U; } //***************************************************************************** // //! Set the peripheral select (SPIPTE) signal polarity. //! //! \param base is the base address of the SPI port. //! \param polarity is the SPIPTE signal polarity. //! //! This function sets the polarity of the peripheral select (SPIPTE) signal. //! The two modes to choose from for the \e polarity parameter are //! \b SPI_PTE_ACTIVE_LOW for active-low polarity (typical) and //! \b SPI_PTE_ACTIVE_HIGH for active-high polarity (considered inverted). //! //! \note This has no effect on the PTE signal when in controller mode. It is //! only applicable to peripheral mode. //! //! \return None. // //***************************************************************************** static inline void SPI_setPTESignalPolarity(uint32_t base, SPI_PTEPolarity polarity) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1129); } } while((_Bool)0); // // Write the polarity of the SPIPTE signal to the register. // (*((volatile uint16_t *)(base + 0xFU))) = ((*((volatile uint16_t *)(base + 0xFU))) & ~0x2U) | (uint16_t)polarity; } //***************************************************************************** // //! Enables SPI high speed mode. //! //! \param base is the base address of the SPI port. //! //! This function enables high speed mode. //! //! \return None. // //***************************************************************************** static inline void SPI_enableHighSpeedMode(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1155); } } while((_Bool)0); // // Set the bit that enables high speed mode. // (*((volatile uint16_t *)(base + 0x0U))) |= 0x20U; } //***************************************************************************** // //! Disables SPI high speed mode. //! //! \param base is the base address of the SPI port. //! //! This function disables high speed mode. High speed mode is disabled by //! default after reset. //! //! \return None. // //***************************************************************************** static inline void SPI_disableHighSpeedMode(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1181); } } while((_Bool)0); // // Clear the bit that enables high speed mode. // (*((volatile uint16_t *)(base + 0x0U))) &= ~0x20U; } //***************************************************************************** // //! Sets SPI emulation mode. //! //! \param base is the base address of the SPI port. //! \param mode is the emulation mode. //! //! This function sets the behavior of the SPI operation when an emulation //! suspend occurs. The \e mode parameter can be one of the following: //! //! - \b SPI_EMULATION_STOP_MIDWAY - Transmission stops midway through the bit //! stream. The rest of the bits will be transmitting after the suspend is //! deasserted. //! - \b SPI_EMULATION_STOP_AFTER_TRANSMIT - If the suspend occurs before the //! first SPICLK pulse, the transmission will not start. If it occurs later, //! the transmission will be completed. //! - \b SPI_EMULATION_FREE_RUN - SPI operation continues regardless of a //! the suspend. //! //! \return None. // //***************************************************************************** static inline void SPI_setEmulationMode(uint32_t base, SPI_EmulationMode mode) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1217); } } while((_Bool)0); // // Write the desired emulation mode to the register. // (*((volatile uint16_t *)(base + 0xFU))) = ((*((volatile uint16_t *)(base + 0xFU))) & ~(0x10U | 0x20U)) | (uint16_t)mode; } //***************************************************************************** // //! Configures the FIFO Transmit Delay //! //! \param base is the base address of the SPI port. //! \param delay Tx FIFO delay to be configured in cycles (0..0xFF) //! //! This function sets the delay between every transfer from FIFO //! transmit buffer to transmit shift register. The delay is defined in //! number SPI serial clock cycles. //! //! \return None // //***************************************************************************** static inline void SPI_setTxFifoTransmitDelay(uint32_t base, uint16_t delay) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1247); } } while((_Bool)0); do { if(!(delay <= 0xFFU)) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1248); } } while((_Bool)0); // // Configure the FIFO Transmit Delay Bits // (*((volatile uint16_t *)(base + 0xCU))) = delay; } //***************************************************************************** // //! Returns the Emulation Buffer Received Data //! //! \param base is the base address of the SPI port. //! //! This function returns the Emulation Buffer Received Data //! //! \return Rx emulation buffer data // //***************************************************************************** static inline uint16_t SPI_readRxEmulationBuffer(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1273); } } while((_Bool)0); // // Return Emulation Buffer Received Data // return((*((volatile uint16_t *)(base + 0x6U)))); } //***************************************************************************** // //! Enable Trasnmit //! //! \param base is the base address of the SPI port. //! //! This function sets the TALK bit enabling the data trasnmission. //! This bit is enabled by SPI_setConfig if the parameter \r mode is selected as //! SPI_MODE_PERIPHERAL or SPI_MODE_CONTROLLER. //! //! \return None // //***************************************************************************** static inline void SPI_enableTalk(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1300); } } while((_Bool)0); // // Set the TALK bit // (*((volatile uint16_t *)(base + 0x1U))) |= 0x2U; } //***************************************************************************** // //! Disable Trasnmit //! //! \param base is the base address of the SPI port. //! //! This function clears the TALK bit disabling the data trasnmission. The //! output pin will be put in high-impedance state. //! This bit is enabled by SPI_setConfig if the parameter \r mode is selected as //! SPI_MODE_PERIPHERAL or SPI_MODE_CONTROLLER. //! //! \return None // //***************************************************************************** static inline void SPI_disableTalk(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1328); } } while((_Bool)0); // // Set the TALK bit // (*((volatile uint16_t *)(base + 0x1U))) &= ~0x2U; } //***************************************************************************** // //! Reset SPI transmit and receive channels //! //! \param base is the base address of the SPI port. //! //! This function resets the SPI transmit and receive channels. //! //! \return None // //***************************************************************************** static inline void SPI_reset(uint32_t base) { // // Check the arguments. // do { if(!(SPI_isBaseValid(base))) { __error__("C:/ti/c2000/C2000Ware_5_02_00_00/driverlib/f2837xd/driverlib/spi.h", 1353); } } while((_Bool)0); // // Write to SPRST bit the TX FIFO. // (*((volatile uint16_t *)(base + 0xAU))) &= ~0x8000U; (*((volatile uint16_t *)(base + 0xAU))) |= 0x8000U; } //***************************************************************************** // //! Configures the serial peripheral interface. //! //! \param base specifies the SPI module base address. //! \param lspclkHz is the rate of the clock supplied to the SPI module //! (LSPCLK) in Hz. //! \param protocol specifies the data transfer protocol. //! \param mode specifies the mode of operation. //! \param bitRate specifies the clock rate in Hz. //! \param dataWidth specifies number of bits transferred per frame. //! //! This function configures the serial peripheral interface. It sets the SPI //! protocol, mode of operation, bit rate, and data width. //! //! The \e protocol parameter defines the data frame format. The \e protocol //! parameter can be one of the following values: \b SPI_PROT_POL0PHA0, //! \b SPI_PROT_POL0PHA1, \b SPI_PROT_POL1PHA0, or //! \b SPI_PROT_POL1PHA1. These frame formats encode the following polarity //! and phase configurations: //! //! 
//! Polarity Phase       Mode
//!   0       0   SPI_PROT_POL0PHA0
//!   0       1   SPI_PROT_POL0PHA1
//!   1       0   SPI_PROT_POL1PHA0
//!   1       1   SPI_PROT_POL1PHA1
//!
//! //! The \e mode parameter defines the operating mode of the SPI module. The //! SPI module can operate as a controller or peripheral; the SPI can also be be //! configured to disable output on its serial output line. The \e mode //! parameter can be one of the following values: \b SPI_MODE_CONTROLLER, //! \b SPI_MODE_PERIPHERAL, \b SPI_MODE_CONTROLLER_OD or //! \b SPI_MODE_PERIPHERAL_OD ("OD" indicates "output disabled"). //! //! The \e bitRate parameter defines the bit rate for the SPI. This bit rate //! must satisfy the following clock ratio criteria: //! //! - \e bitRate can be no greater than lspclkHz divided by 4. //! - \e lspclkHz / \e bitRate cannot be greater than 128. //! //! The \e dataWidth parameter defines the width of the data transfers and //! can be a value between 1 and 16, inclusive. //! //! The peripheral clock is the low speed peripheral clock. This value is //! returned by SysCtl_getLowSpeedClock(), or it can be explicitly hard coded //! if it is constant and known (to save the code/execution overhead of a call //! to SysCtl_getLowSpeedClock()). //! //! \note SPI operation should be disabled via SPI_disableModule() before any //! changes to its configuration. //! //! \return None. // //***************************************************************************** extern void SPI_setConfig(uint32_t base, uint32_t lspclkHz, SPI_TransferProtocol protocol, SPI_Mode mode, uint32_t bitRate, uint16_t dataWidth); //***************************************************************************** // //! Configures the baud rate of the serial peripheral interface. //! //! \param base specifies the SPI module base address. //! \param lspclkHz is the rate of the clock supplied to the SPI module //! (LSPCLK) in Hz. //! \param bitRate specifies the clock rate in Hz. //! //! This function configures the SPI baud rate. The \e bitRate parameter //! defines the bit rate for the SPI. This bit rate must satisfy the following //! clock ratio criteria: //! //! - \e bitRate can be no greater than \e lspclkHz divided by 4. //! - \e lspclkHz / \e bitRate cannot be greater than 128. //! //! The peripheral clock is the low speed peripheral clock. This value is //! returned by SysCtl_getLowSpeedClock(), or it can be explicitly hard coded //! if it is constant and known (to save the code/execution overhead of a call //! to SysCtl_getLowSpeedClock()). //! //! \note SPI_setConfig() also sets the baud rate. Use SPI_setBaudRate() //! if you wish to configure it separately from protocol and mode. //! //! \return None. // //***************************************************************************** extern void SPI_setBaudRate(uint32_t base, uint32_t lspclkHz, uint32_t bitRate); //***************************************************************************** // //! Enables individual SPI interrupt sources. //! //! \param base specifies the SPI module base address. //! \param intFlags is a bit mask of the interrupt sources to be enabled. //! //! This function enables the indicated SPI interrupt sources. Only the sources //! that are enabled can be reflected to the processor interrupt; disabled //! sources have no effect on the processor. The \e intFlags parameter can be //! any of the following values: //! - \b SPI_INT_RX_OVERRUN - Receive overrun interrupt //! - \b SPI_INT_RX_DATA_TX_EMPTY - Data received, transmit empty //! - \b SPI_INT_RXFF (also enables \b SPI_INT_RXFF_OVERFLOW) - RX FIFO level //! interrupt (and RX FIFO overflow) //! - \b SPI_INT_TXFF - TX FIFO level interrupt //! //! \note \b SPI_INT_RX_OVERRUN, \b SPI_INT_RX_DATA_TX_EMPTY, //! \b SPI_INT_RXFF_OVERFLOW, and \b SPI_INT_RXFF are associated with //! \b SPIRXINT; \b SPI_INT_TXFF is associated with \b SPITXINT. //! //! \return None. // //***************************************************************************** extern void SPI_enableInterrupt(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Disables individual SPI interrupt sources. //! //! \param base specifies the SPI module base address. //! \param intFlags is a bit mask of the interrupt sources to be disabled. //! //! This function disables the indicated SPI interrupt sources. The //! \e intFlags parameter can be any of the following values: //! - \b SPI_INT_RX_OVERRUN //! - \b SPI_INT_RX_DATA_TX_EMPTY //! - \b SPI_INT_RXFF (also disables \b SPI_INT_RXFF_OVERFLOW) //! - \b SPI_INT_TXFF //! //! \note \b SPI_INT_RX_OVERRUN, \b SPI_INT_RX_DATA_TX_EMPTY, //! \b SPI_INT_RXFF_OVERFLOW, and \b SPI_INT_RXFF are associated with //! \b SPIRXINT; \b SPI_INT_TXFF is associated with \b SPITXINT. //! //! \return None. // //***************************************************************************** extern void SPI_disableInterrupt(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! Gets the current interrupt status. //! //! \param base specifies the SPI module base address. //! //! This function returns the interrupt status for the SPI module. //! //! \return The current interrupt status, enumerated as a bit field of the //! following values: //! - \b SPI_INT_RX_OVERRUN - Receive overrun interrupt //! - \b SPI_INT_RX_DATA_TX_EMPTY - Data received, transmit empty //! - \b SPI_INT_RXFF - RX FIFO level interrupt //! - \b SPI_INT_RXFF_OVERFLOW - RX FIFO overflow //! - \b SPI_INT_TXFF - TX FIFO level interrupt // //***************************************************************************** extern uint32_t SPI_getInterruptStatus(uint32_t base); //***************************************************************************** // //! Clears SPI interrupt sources. //! //! \param base specifies the SPI module base address. //! \param intFlags is a bit mask of the interrupt sources to be cleared. //! //! This function clears the specified SPI interrupt sources so that they no //! longer assert. This function must be called in the interrupt handler to //! keep the interrupts from being triggered again immediately upon exit. The //! \e intFlags parameter can consist of a bit field of the following values: //! - \b SPI_INT_RX_OVERRUN //! - \b SPI_INT_RX_DATA_TX_EMPTY //! - \b SPI_INT_RXFF //! - \b SPI_INT_RXFF_OVERFLOW //! - \b SPI_INT_TXFF //! //! \note \b SPI_INT_RX_DATA_TX_EMPTY is cleared by a read of the receive //! receive buffer, so it usually doesn't need to be cleared using this //! function. //! //! \note Also note that \b SPI_INT_RX_OVERRUN, \b SPI_INT_RX_DATA_TX_EMPTY, //! \b SPI_INT_RXFF_OVERFLOW, and \b SPI_INT_RXFF are associated with //! \b SPIRXINT; \b SPI_INT_TXFF is associated with \b SPITXINT. //! //! \return None. // //***************************************************************************** extern void SPI_clearInterruptStatus(uint32_t base, uint32_t intFlags); //***************************************************************************** // //! This function can be used to transmit a 24-bit word of data //! //! \param base specifies the SPI module base address. //! \param txData is the data to be transmitted over SPI //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function can be used to transmit a 24-bit word of data. //! 24-bit word data is divided into three bytes of data. //! //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** extern void SPI_transmit24Bits(uint32_t base, uint32_t data, uint16_t txDelay); //***************************************************************************** // //! This function can be used to transmit a 32-bit word of data //! //! \param base specifies the SPI module base address. //! \param txData is the data to be transmitted over SPI //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function can be used to transmit a 32-bit word of data. //! 32-bit word data is divided into four bytes of data. //! //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 16 bits BEFORE calling the //! function //! //! \return None. // //***************************************************************************** extern void SPI_transmit32Bits(uint32_t base, uint32_t data, uint16_t txDelay); //***************************************************************************** // //! This function is used to receive a 16-bit word of data //! //! \param base specifies the SPI module base address. //! \param endianness specifies the endianess of received data //! \param dummyData is the data which is transmitted to initiate //! SPI transaction to receive SPI data //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function is used to receive a 16-bit word of data. //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return the received 16-bit word. // //***************************************************************************** extern uint16_t SPI_receive16Bits(uint32_t base, SPI_endianess endianness, uint16_t dummyData, uint16_t txDelay); //***************************************************************************** // //! This function is used to receive a 24-bit word of data //! //! \param base specifies the SPI module base address. //! \param endianness specifies the endianess of received data //! \param dummyData is the data which is transmitted to initiate //! SPI transaction to receive SPI data //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function is used to receive a 24-bit word of data. //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return the received 24-bit word. // //***************************************************************************** extern uint32_t SPI_receive24Bits(uint32_t base, SPI_endianess endianness, uint16_t dummyData, uint16_t txDelay); //***************************************************************************** // //! This function is used to receive a 32-bit word of data //! //! \param base specifies the SPI module base address. //! \param endianness specifies the endianess of received data //! \param dummyData is the data which is transmitted to initiate //! SPI transaction to receive SPI data //! \param txDelay specifies the number of serial clock cycles delay time after //! completion of perious word //! //! This function is used to receive a 32-bit word of data. //! This function uses SPI_pollingFIFOTransaction function. //! SPI character length must be configured to 8 bits BEFORE calling the //! function //! //! \return the received 32-bit word. // //***************************************************************************** extern uint32_t SPI_receive32Bits(uint32_t base, SPI_endianess endianness, uint16_t dummyData, uint16_t txDelay); //***************************************************************************** // //! This function is used to initiate SPI transaction of specified character //! length //! //! \param base specifies the SPI module base address. //! \param charLength specifies the SPI character length of SPI transaction //! \param data specified the data to be transmitted //! //! The SPI must be configured to the provided charLength BEFORE the function //! is called. This function does not set/change the SPI char length. //! //! \return . // //***************************************************************************** extern uint16_t SPI_pollingNonFIFOTransaction(uint32_t base, uint16_t charLength, uint16_t data); //***************************************************************************** // //! This function is used to initiate SPI transaction of specified character //! length and 'N' words of transaction //! //! \param base specifies the SPI module base address. //! \param charLength specifies the SPI character length of SPI transaction //! \param pTxBuffer specifies the pointer to transmit buffer //! \param pRxBuffer specifies the pointer to receive buffer //! \param numOfWords specified the number of data to be transmitted / received //! //! The SPI must be configured to the provided charLength BEFORE the function //! is called. This function does not set/change the SPI char length. //! //! \return none // //***************************************************************************** extern void SPI_pollingFIFOTransaction(uint32_t base, uint16_t charLength, uint16_t *pTxBuffer, uint16_t *pRxBuffer, uint16_t numOfWords, uint16_t txDelay); //***************************************************************************** // // Close the Doxygen group. //! @} // //***************************************************************************** //***************************************************************************** // // Mark the end of the C bindings section for C++ compilers. // //***************************************************************************** //########################################################################### // // FILE: upp.h // // TITLE: C28x uPP driver. // //########################################################################### // // // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //***************************************************************************** // // If building with a C++ compiler, make all of the definitions in this header // have a C binding. // //***************************************************************************** //***************************************************************************** // //! \addtogroup upp_api UPP //! @{ // //***************************************************************************** //########################################################################### // // FILE: hw_upp.h // // TITLE: Definitions for the UPP registers. // //########################################################################### // $Copyright: // Copyright (C) 2022 Texas Instruments Incorporated - http://www.ti.com // // 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 Texas Instruments Incorporated 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 // OWNER 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. // $ //########################################################################### //************************************************************************************************* // // The following are defines for the UPP register offsets // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the PERCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CHCTL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the IFCFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the IFIVAL register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the THCFG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the RAWINTST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the ENINTST register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INTENSET register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the INTENCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CHIDESC1 register // //************************************************************************************************* // transfer. // transfer. //************************************************************************************************* // // The following are defines for the bit fields in the CHIDESC2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CHIST1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CHIST2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CHQDESC1 register // //************************************************************************************************* // transfer. // transfer. //************************************************************************************************* // // The following are defines for the bit fields in the CHQDESC2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CHQST1 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the CHQST2 register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GINTEN register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GINTFLG register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the GINTCLR register // //************************************************************************************************* //************************************************************************************************* // // The following are defines for the bit fields in the DLYCTL register // //************************************************************************************************* //***************************************************************************** // // Defines for the API. // //***************************************************************************** //***************************************************************************** // // Defines that can be passed as addr field of UPP_DMADescriptor to // UPP_setDMADescriptor(). Since the addresses for Tx & Rx MSG RAMs are // different for CPU & DMA views, these defines can be used as DMA descriptor // addresses. // //***************************************************************************** //***************************************************************************** // // Defines that can be used in user program as start address for CPU/CLA write // to TX MSG RAM for transmitting data & for CPU/CLA read from RX MSG RAM for // receiving data. Since the addresses for Tx & Rx MSG RAMs are different for // CPU & DMA views, these defines can be used for CPU read/writes. // //***************************************************************************** //***************************************************************************** // // Defines to specify the size of the uPP Tx and Rx MSG RAMs. // //***************************************************************************** //***************************************************************************** // // Define to specify 32 cycle delay between software reset issue & release in // UPP_performSoftReset(). // //***************************************************************************** //***************************************************************************** // // Define to specify mask for setting emulation mode in UPP_setEmulationMode(). // //***************************************************************************** //***************************************************************************** // // Defines to specify masks for enabling/disabling uPP Tx/Rx control signals in // UPP_setTxControlSignalMode() & UPP_setRxControlSignalMode() respectively. // //***************************************************************************** //***************************************************************************** // // Define to specify mask for configuring polarities for uPP control signals // in UPP_setControlSignalPolarity(). // //***************************************************************************** //***************************************************************************** // // Define to specify masks for returning interrupt status in // UPP_getInterruptStatus() & UPP_getRawInterruptStatus(). // //***************************************************************************** //***************************************************************************** // // Values that can be passed to UPP_enableInterrupt(), // UPP_disableInterrupt() and UPP_clearInterruptStatus() as the // intFlags parameter and returned by UPP_getInterruptStatus() & // UPP_getRawInterruptStatus(). // //***************************************************************************** //***************************************************************************** // //! Values that can be passed to UPP_setEmulationMode() as \e emuMode //! parameter. // //***************************************************************************** typedef enum { UPP_EMULATIONMODE_HARDSTOP = 0x0U, //!< uPP stops immediately UPP_EMULATIONMODE_RUNFREE = 0x1U, //!< uPP unaffected by suspend UPP_EMULATIONMODE_SOFTSTOP = 0x2U //!< uPP stops at DMA transaction finish } UPP_EmulationMode; //***************************************************************************** // //! Values that can be passed to UPP_setOperationMode() as \e opMode parameter. // //***************************************************************************** typedef enum { UPP_RECEIVE_MODE = 0x0U, //!< uPP to be configured as Receiver UPP_TRANSMIT_MODE = 0x1U //!< uPP to be configured as Transmitter } UPP_OperationMode; //***************************************************************************** // //! Values that can be passed to UPP_setDataRate() as \e dataRate //! parameter. // //***************************************************************************** typedef enum { UPP_DATA_RATE_SDR = 0x00000U, //!< uPP to operate in Single Data Rate Mode UPP_DATA_RATE_DDR = 0x10000U //!< uPP to operate in Double Data Rate Mode } UPP_DataRate; //***************************************************************************** // //! Values that can be passed to UPP_setTxSDRInterleaveMode() as \e mode //! parameter. // //***************************************************************************** typedef enum { UPP_TX_SDR_INTERLEAVE_DISABLE = 0x0U, //!