123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210 |
- /**
- * @file csl_cpts.h
- *
- * @brief
- * Header file containing various enumerations, structure definitions and function
- * declarations for the Time synchronization submodule of EMAC.
- * \par
- * ============================================================================
- * @n (C) Copyright 2009-2014, Texas Instruments, Inc.
- *
- * 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.
- *
- */
- #ifndef CSL_CPTS_H_
- #define CSL_CPTS_H_
- #ifdef __cplusplus
- extern "C" {
- #endif
- #include <ti/csl/soc.h>
- #include <ti/csl/csl.h>
- #include <ti/csl/cslr_cpts.h>
- /**
- @defgroup CSL_CPTS_SYMBOL CPTS Symbols Defined
- @ingroup CSL_CPTS_API
- */
- /**
- @defgroup CSL_CPTS_DATASTRUCT CPTS Data Structures
- @ingroup CSL_CPTS_API
- */
- /**
- @defgroup CSL_CPTS_FUNCTION CPTS Functions
- @ingroup CSL_CPTS_API
- */
- /**
- @defgroup CSL_CPTS_ENUM CPTS Enumerated Data Types
- @ingroup CSL_CPTS_API
- */
- /**
- @addtogroup CSL_CPTS_SYMBOL
- @{
- */
- /**
- @}
- */
- /** @addtogroup CSL_CPTS_DATASTRUCT
- @{ */
- /** @brief
- *
- * Defines CPTS event types.
- */
- /** Time stamp push event */
- #define CSL_CPTS_EVENTTYPE_TS_PUSH 0
- /** Time stamp rollover event (32-bit mode only) */
- #define CSL_CPTS_EVENTTYPE_TS_ROLLOVER 1
- /** Time stamp Half Rollover event (32-bit mode only) */
- #define CSL_CPTS_EVENTTYPE_TS_HALFROLLOVER 2
- /** Hardware Time stamp push event */
- #define CSL_CPTS_EVENTTYPE_HW_TS_PUSH 3
- /** Ethernet receive event */
- #define CSL_CPTS_EVENTTYPE_ETH_RECEIVE 4
- /** Ethernet Transmit event */
- #define CSL_CPTS_EVENTTYPE_ETH_TRANSMIT 5
-
- /** Time stamp compare event (non-toggle mode only) */
- #define CSL_CPTS_EVENTTYPE_TS_COMP 6
- /** Host event */
- #define CSL_CPTS_EVENTTYPE_HOST 7
- /** @brief
- *
- * Holds the Time sync submodule's version info.
- */
- typedef struct {
- /** Minor version value */
- Uint32 minorVer;
- /** Major version value */
- Uint32 majorVer;
- /** RTL version value */
- Uint32 rtlVer;
- /** Identification value */
- Uint32 id;
- } CSL_CPTS_VERSION;
- /** @brief
- *
- * Holds Time sync event info contents.
- */
- typedef struct {
- /** 32-bit Event Time stamp */
- Uint32 timeStamp;
-
- /** Upper 32-bit Event Time stamp provided by new generation CPTS */
- Uint32 timeStampHi;
- /** Event Sequence Id */
- Uint32 seqId;
- /** Event Message Type */
- Uint32 msgType;
- /** Event Type */
- Uint32 eventType;
- /** EMAC Port number */
- Uint32 portNo;
- /** Event Domain */
- Uint32 domain;
- } CSL_CPTS_EVENTINFO;
-
- /**
- @}
- */
- /** ============================================================================
- *
- * @defgroup CSL_CPTS_API Time Sync Submodule (CPTS)
- * @ingroup CSL_CPSW_API
- *
- *
- * @subsection xxx Overview
- *
- * CSL CPTS API has common implementation for multiple SoCs along with below SoC specific
- * implementation with the mapping as below.
- * -# cpts v0 - SOC_K2K/SOC_K2H
- * -# cpts v1 - SOC_K2E/SOC_K2L
- * -# cpts v2 - SOC_K2G
- * -# cpts v4 - SOC_C6678
- *
- * @note: there may not be any ip specific implementation for that soc, if it contains only cslr_* files
- *
- * ============================================================================
- */
- #if defined(SOC_K2K) || defined(SOC_K2H)
- #include <ti/csl/src/ip/cpsw/V0/csl_cpts.h>
- #elif defined(SOC_C6678)
- #include <ti/csl/src/ip/cpsw/V4/csl_cpts.h>
- #elif defined(SOC_K2E)
- #include <ti/csl/src/ip/cpsw/V1/csl_cpts.h>
- #elif defined(SOC_K2L)
- #include <ti/csl/src/ip/cpsw/V1/csl_cpts.h>
- #elif defined(SOC_K2G)
- #include <ti/csl/src/ip/cpsw/V2/csl_cpts.h>
- #endif /* SOC_XXXXX */
- #ifdef __cplusplus
- }
- #endif
- #endif
- /**
- @}
- */
|