mirror of
https://github.com/thelsing/knx.git
synced 2025-11-24 20:06:01 +01:00
e51b65f8c2
git-subtree-dir: examples/knx-cc1310/coresdk_cc13xx_cc26xx git-subtree-split: 0d78d3280357416a5c0388148cda13717c9ffaa5
340 lines
12 KiB
C
340 lines
12 KiB
C
/******************************************************************************
|
|
* Filename: rfc.c
|
|
* Revised: 2018-08-08 11:04:37 +0200 (Wed, 08 Aug 2018)
|
|
* Revision: 52334
|
|
*
|
|
* Description: Driver for the RF Core.
|
|
*
|
|
* Copyright (c) 2015 - 2017, Texas Instruments Incorporated
|
|
* 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.
|
|
*
|
|
* 3) Neither the name of the ORGANIZATION nor the names of its contributors may
|
|
* be used to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
******************************************************************************/
|
|
|
|
#include "rfc.h"
|
|
#include "rf_mailbox.h"
|
|
#include <string.h>
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Handle support for DriverLib in ROM:
|
|
// This section will undo prototype renaming made in the header file
|
|
//
|
|
//*****************************************************************************
|
|
#if !defined(DOXYGEN)
|
|
#undef RFCCpeIntGetAndClear
|
|
#define RFCCpeIntGetAndClear NOROM_RFCCpeIntGetAndClear
|
|
#undef RFCDoorbellSendTo
|
|
#define RFCDoorbellSendTo NOROM_RFCDoorbellSendTo
|
|
#undef RFCSynthPowerDown
|
|
#define RFCSynthPowerDown NOROM_RFCSynthPowerDown
|
|
#undef RFCCpePatchReset
|
|
#define RFCCpePatchReset NOROM_RFCCpePatchReset
|
|
#undef RFCOverrideSearch
|
|
#define RFCOverrideSearch NOROM_RFCOverrideSearch
|
|
#undef RFCOverrideUpdate
|
|
#define RFCOverrideUpdate NOROM_RFCOverrideUpdate
|
|
#undef RFCHwIntGetAndClear
|
|
#define RFCHwIntGetAndClear NOROM_RFCHwIntGetAndClear
|
|
#undef RFCRfTrimRead
|
|
#define RFCRfTrimRead NOROM_RFCRfTrimRead
|
|
#undef RFCRfTrimSet
|
|
#define RFCRfTrimSet NOROM_RFCRfTrimSet
|
|
#undef RFCRTrim
|
|
#define RFCRTrim NOROM_RFCRTrim
|
|
#undef RFCAdi3VcoLdoVoltageMode
|
|
#define RFCAdi3VcoLdoVoltageMode NOROM_RFCAdi3VcoLdoVoltageMode
|
|
#endif
|
|
|
|
// Definition of addresses and offsets
|
|
#define _CPERAM_START 0x21000000
|
|
#define _PARSER_PATCH_TAB_OFFSET 0x0334
|
|
#define _PATCH_TAB_OFFSET 0x033C
|
|
#define _IRQPATCH_OFFSET 0x03AC
|
|
#define _PATCH_VEC_OFFSET 0x0404
|
|
|
|
#define RFC_RTRIM_PATTERN 0x4038
|
|
#define RFC_RTRIM_MASK 0xFFFF
|
|
|
|
// Default interrupt table
|
|
static const uint16_t rfc_defaultIrqAddr[] =
|
|
{
|
|
0x398b,
|
|
0x3805,
|
|
0x3825,
|
|
0x3839,
|
|
0x0acf,
|
|
0x3857,
|
|
0x38d7,
|
|
0x09dd,
|
|
0x5819,
|
|
0x0ab3,
|
|
0x38f7,
|
|
};
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Get and clear CPE interrupt flags which match the provided bitmask
|
|
//
|
|
//*****************************************************************************
|
|
uint32_t
|
|
RFCCpeIntGetAndClear(uint32_t ui32Mask)
|
|
{
|
|
// Read the CPE interrupt flags which match the provided bitmask
|
|
uint32_t ui32Ifg = HWREG(RFC_DBELL_BASE + RFC_DBELL_O_RFCPEIFG) & ui32Mask;
|
|
|
|
// Clear the interrupt flags
|
|
RFCCpeIntClear(ui32Ifg);
|
|
|
|
// Return with the interrupt flags
|
|
return (ui32Ifg);
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Send a radio operation to the doorbell and wait for an acknowledgement
|
|
//
|
|
//*****************************************************************************
|
|
uint32_t
|
|
RFCDoorbellSendTo(uint32_t pOp)
|
|
{
|
|
// Wait until the doorbell becomes available
|
|
while(HWREG(RFC_DBELL_BASE + RFC_DBELL_O_CMDR) != 0);
|
|
RFCAckIntClear();
|
|
|
|
// Submit the command to the CM0 through the doorbell
|
|
HWREG(RFC_DBELL_BASE + RFC_DBELL_O_CMDR) = pOp;
|
|
|
|
// Wait until the CM0 starts to parse the command
|
|
while(!HWREG(RFC_DBELL_BASE + RFC_DBELL_O_RFACKIFG));
|
|
RFCAckIntClear();
|
|
|
|
// Return with the content of status register
|
|
return(HWREG(RFC_DBELL_BASE + RFC_DBELL_O_CMDSTA));
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Turn off the RF synthesizer. The radio will no longer respond to commands!
|
|
//
|
|
//*****************************************************************************
|
|
void
|
|
RFCSynthPowerDown(void)
|
|
{
|
|
// Definition of reserved words
|
|
const uint32_t RFC_RESERVED0 = 0x40044108;
|
|
const uint32_t RFC_RESERVED1 = 0x40044114;
|
|
const uint32_t RFC_RESERVED2 = 0x4004410C;
|
|
const uint32_t RFC_RESERVED3 = 0x40044100;
|
|
|
|
// Disable CPE clock, enable FSCA clock.
|
|
HWREG(RFC_PWR_NONBUF_BASE + RFC_PWR_O_PWMCLKEN) = (HWREG(RFC_PWR_NONBUF_BASE + RFC_PWR_O_PWMCLKEN)
|
|
& ~RFC_PWR_PWMCLKEN_CPE_M) | RFC_PWR_PWMCLKEN_FSCA_M;
|
|
|
|
HWREG(RFC_RESERVED0) = 3;
|
|
HWREG(RFC_RESERVED1) = 0x1030;
|
|
HWREG(RFC_RESERVED2) = 1;
|
|
HWREG(RFC_RESERVED1) = 0x50;
|
|
HWREG(RFC_RESERVED2) = 1;
|
|
HWREG(RFC_RESERVED1) = 0x650;
|
|
HWREG(RFC_RESERVED2) = 1;
|
|
HWREG(RFC_RESERVED3) = 1;
|
|
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Reset previously patched CPE RAM to a state where it can be patched again
|
|
//
|
|
//*****************************************************************************
|
|
void
|
|
RFCCpePatchReset(void)
|
|
{
|
|
uint8_t *pPatchTab = (uint8_t *) (_CPERAM_START + _PARSER_PATCH_TAB_OFFSET);
|
|
uint32_t *pIrqPatch = (uint32_t *)(_CPERAM_START + _IRQPATCH_OFFSET);
|
|
|
|
memset(pPatchTab, 0xFF, _IRQPATCH_OFFSET - _PARSER_PATCH_TAB_OFFSET);
|
|
|
|
int i;
|
|
for (i = 0; i < sizeof(rfc_defaultIrqAddr)/sizeof(rfc_defaultIrqAddr[0]); i++)
|
|
{
|
|
pIrqPatch[i * 2 + 1] = rfc_defaultIrqAddr[i];
|
|
}
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Function to search an override list for the provided pattern within the search depth.
|
|
//
|
|
//*****************************************************************************
|
|
uint8_t
|
|
RFCOverrideSearch(const uint32_t *pOverride, const uint32_t pattern, const uint32_t mask, const uint8_t searchDepth)
|
|
{
|
|
// Search from start of the override list, to look for first override entry that matches search pattern
|
|
uint8_t override_index;
|
|
for(override_index = 0; (override_index < searchDepth) && (pOverride[override_index] != END_OVERRIDE); override_index++)
|
|
{
|
|
// Compare the value to the given pattern
|
|
if((pOverride[override_index] & mask) == pattern)
|
|
{
|
|
// Return with the index of override in case of match
|
|
return override_index;
|
|
}
|
|
}
|
|
|
|
// Return with an invalid index
|
|
return 0xFF;
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Update the override list based on values stored in FCFG1
|
|
//
|
|
//*****************************************************************************
|
|
uint8_t
|
|
RFCOverrideUpdate(rfc_radioOp_t *pOpSetup, uint32_t *pParams)
|
|
{
|
|
// Function is left blank for compatibility reasons.
|
|
return 0;
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Get and clear HW interrupt flags
|
|
//
|
|
//*****************************************************************************
|
|
uint32_t
|
|
RFCHwIntGetAndClear(uint32_t ui32Mask)
|
|
{
|
|
// Read the CPE interrupt flags which match the provided bitmask
|
|
uint32_t ui32Ifg = HWREG(RFC_DBELL_BASE + RFC_DBELL_O_RFHWIFG) & ui32Mask;
|
|
|
|
// Clear the interupt flags
|
|
RFCHwIntClear(ui32Ifg);
|
|
|
|
// Return with the interrupt flags
|
|
return (ui32Ifg);
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Read RF trim values from FCFG1
|
|
//
|
|
//*****************************************************************************
|
|
void
|
|
RFCRfTrimRead(rfc_radioOp_t *pOpSetup, rfTrim_t* pRfTrim)
|
|
{
|
|
// Definition of position and bitmask of divider value
|
|
const uint32_t CONFIG_MISC_ADC_DIVIDER = 27;
|
|
const uint32_t CONFIG_MISC_ADC_DIVIDER_BM = 0xF8000000U;
|
|
|
|
// Read trim values from FCFG1
|
|
pRfTrim->configIfAdc = HWREG(FCFG1_BASE + FCFG1_O_CONFIG_IF_ADC);
|
|
pRfTrim->configRfFrontend = HWREG(FCFG1_BASE + FCFG1_O_CONFIG_RF_FRONTEND);
|
|
pRfTrim->configSynth = HWREG(FCFG1_BASE + FCFG1_O_CONFIG_SYNTH);
|
|
// Make sure configMiscAdc is not 0 by setting an unused bit to 1
|
|
pRfTrim->configMiscAdc = (HWREG(FCFG1_BASE + FCFG1_O_CONFIG_MISC_ADC)
|
|
& ~CONFIG_MISC_ADC_DIVIDER_BM) | (2U << CONFIG_MISC_ADC_DIVIDER);
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Write preloaded RF trim values to the CM0
|
|
//
|
|
//*****************************************************************************
|
|
void
|
|
RFCRfTrimSet(rfTrim_t* pRfTrim)
|
|
{
|
|
memcpy((void*)&HWREG(0x21000018), (void*)pRfTrim, sizeof(rfTrim_t));
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Check Override RTrim vs FCFG RTrim
|
|
//
|
|
//*****************************************************************************
|
|
uint8_t
|
|
RFCRTrim(rfc_radioOp_t *pOpSetup)
|
|
{
|
|
// Function is left blank for compatibility reasons.
|
|
return 0;
|
|
}
|
|
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Function to set VCOLDO reference to voltage mode
|
|
//
|
|
//*****************************************************************************
|
|
void
|
|
RFCAdi3VcoLdoVoltageMode(bool bEnable)
|
|
{
|
|
// Function is left blank for compatibility reasons.
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Handle support for DriverLib in ROM:
|
|
// This section will undo prototype renaming made in the header file
|
|
//
|
|
//*****************************************************************************
|
|
#if !defined(DOXYGEN)
|
|
#undef RFCCpeIntGetAndClear
|
|
#define RFCCpeIntGetAndClear NOROM_RFCCpeIntGetAndClear
|
|
#undef RFCDoorbellSendTo
|
|
#define RFCDoorbellSendTo NOROM_RFCDoorbellSendTo
|
|
#undef RFCSynthPowerDown
|
|
#define RFCSynthPowerDown NOROM_RFCSynthPowerDown
|
|
#undef RFCCpePatchReset
|
|
#define RFCCpePatchReset NOROM_RFCCpePatchReset
|
|
#undef RFCOverrideSearch
|
|
#define RFCOverrideSearch NOROM_RFCOverrideSearch
|
|
#undef RFCOverrideUpdate
|
|
#define RFCOverrideUpdate NOROM_RFCOverrideUpdate
|
|
#undef RFCHwIntGetAndClear
|
|
#define RFCHwIntGetAndClear NOROM_RFCHwIntGetAndClear
|
|
#undef RFCRfTrimRead
|
|
#define RFCRfTrimRead NOROM_RFCRfTrimRead
|
|
#undef RFCRfTrimSet
|
|
#define RFCRfTrimSet NOROM_RFCRfTrimSet
|
|
#undef RFCRTrim
|
|
#define RFCRTrim NOROM_RFCRTrim
|
|
#undef RFCAdi3VcoLdoVoltageMode
|
|
#define RFCAdi3VcoLdoVoltageMode NOROM_RFCAdi3VcoLdoVoltageMode
|
|
#endif
|
|
|
|
// See rfc.h for implementation
|