t
Fork of mbed-dev by
Diff: targets/TARGET_Maxim/TARGET_MAX32630/mxc/i2cs.c
- Revision:
- 157:ff67d9f36b67
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/targets/TARGET_Maxim/TARGET_MAX32630/mxc/i2cs.c Thu Feb 02 17:01:33 2017 +0000 @@ -0,0 +1,209 @@ +/** + * @file + * @brief This file contains the function implementations for the I2CS + * (Inter-Integrated Circuit Slave) peripheral module. + */ +/* **************************************************************************** + * Copyright (C) 2016 Maxim Integrated Products, Inc., All Rights Reserved. + * + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS + * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES + * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, + * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR + * OTHER DEALINGS IN THE SOFTWARE. + * + * Except as contained in this notice, the name of Maxim Integrated + * Products, Inc. shall not be used except as stated in the Maxim Integrated + * Products, Inc. Branding Policy. + * + * The mere transfer of this software does not imply any licenses + * of trade secrets, proprietary technology, copyrights, patents, + * trademarks, maskwork rights, or any other form of intellectual + * property whatsoever. Maxim Integrated Products, Inc. retains all + * ownership rights. + * + * $Date: 2016-09-08 18:05:59 -0500 (Thu, 08 Sep 2016) $ + * $Revision: 24332 $ + * + *************************************************************************** */ + +/* **** Includes **** */ +#include <string.h> +#include "mxc_assert.h" +#include "mxc_errors.h" +#include "mxc_sys.h" +#include "i2cs.h" + +/** + * @ingroup i2cs + * @{ + */ +/* **** Definitions **** */ + +/* **** Globals ***** */ + + +// No Doxygen documentation for the items between here and endcond. +/* Clock divider lookup table */ +static const uint32_t clk_div_table[2][8] = { + /* I2CS_SPEED_100KHZ */ + { + // 12000000 + (6 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS), + // 24000000 + (12 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS), + // 36000000 NOT SUPPORTED + 0, + // 48000000 + (24 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS), + // 60000000 NOT SUPPORTED + 0, + // 72000000 NOT SUPPORTED + 0, + // 84000000 NOT SUPPORTED + 0, + // 96000000 + (48 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS) + }, + /* I2CS_SPEED_400KHZ */ + { + // 12000000 + (2 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS), + // 24000000 + (3 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS), + // 36000000 NOT SUPPORTED + 0, + // 48000000 + (6 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS), + // 60000000 NOT SUPPORTED + 0, + // 72000000 NOT SUPPORTED + 0, + // 84000000 NOT SUPPORTED + 0, + // 96000000 + (12 << MXC_F_I2CS_CLK_DIV_FS_FILTER_CLOCK_DIV_POS) + }, +}; + + +static void (*callbacks[MXC_CFG_I2CS_INSTANCES][MXC_CFG_I2CS_BUFFER_SIZE])(uint8_t); + +/* **** Functions **** */ + +/* ************************************************************************* */ +int I2CS_Init(mxc_i2cs_regs_t *i2cs, const sys_cfg_i2cs_t *sys_cfg, i2cs_speed_t speed, + uint16_t address, i2cs_addr_t addr_len) +{ + int err, i, i2cs_index; + + i2cs_index = MXC_I2CS_GET_IDX(i2cs); + MXC_ASSERT(i2cs_index >= 0); + + // Set system level configurations + if ((err = SYS_I2CS_Init(i2cs, sys_cfg)) != E_NO_ERROR) { + return err; + } + + // Compute clock array index + int clki = ((SYS_I2CS_GetFreq(i2cs) / 12000000) - 1); + + // Get clock divider settings from lookup table + if ((speed == I2CS_SPEED_100KHZ) && (clk_div_table[I2CS_SPEED_100KHZ][clki] > 0)) { + i2cs->clk_div = clk_div_table[I2CS_SPEED_100KHZ][clki]; + } else if ((speed == I2CS_SPEED_400KHZ) && (clk_div_table[I2CS_SPEED_400KHZ][clki] > 0)) { + i2cs->clk_div = clk_div_table[I2CS_SPEED_400KHZ][clki]; + } else { + MXC_ASSERT_FAIL(); + } + + // Clear the interrupt callbacks + for(i = 0; i < MXC_CFG_I2CS_BUFFER_SIZE; i++) { + callbacks[i2cs_index][i] = NULL; + } + + // Reset module + i2cs->dev_id = MXC_F_I2CS_DEV_ID_SLAVE_RESET; + i2cs->dev_id = ((((address >> 0) << MXC_F_I2CS_DEV_ID_SLAVE_DEV_ID_POS) + & MXC_F_I2CS_DEV_ID_SLAVE_DEV_ID) | addr_len); + + return E_NO_ERROR; +} + +/* ************************************************************************* */ +int I2CS_Shutdown(mxc_i2cs_regs_t *i2cs) +{ + int err; + + // Disable and clear interrupts + i2cs->inten = 0; + i2cs->intfl = i2cs->intfl; + + // clears system level configurations + if ((err = SYS_I2CS_Shutdown(i2cs)) != E_NO_ERROR) { + return err; + } + + return E_NO_ERROR; +} + +/* ************************************************************************* */ +void I2CS_Handler(mxc_i2cs_regs_t *i2cs) +{ + uint32_t intfl; + uint8_t i; + int i2cs_index = MXC_I2CS_GET_IDX(i2cs); + + // Save and clear the interrupt flags + intfl = i2cs->intfl; + i2cs->intfl = intfl; + + // Process each interrupt + for(i = 0; i < 32; i++) { + if(intfl & (0x1 << i)) { + if(callbacks[i2cs_index][i] != NULL) { + callbacks[i2cs_index][i](i); + } + } + } + +} + +/* ************************************************************************* */ +void I2CS_RegisterCallback(mxc_i2cs_regs_t *i2cs, uint8_t addr, i2cs_callback_fn callback) +{ + int i2cs_index = MXC_I2CS_GET_IDX(i2cs); + + // Make sure we don't overflow + MXC_ASSERT(addr < MXC_CFG_I2CS_BUFFER_SIZE); + + if(callback != NULL) { + // Save the callback address + callbacks[i2cs_index][addr] = callback; + + // Clear and Enable the interrupt for the given byte + i2cs->intfl = (0x1 << addr); + i2cs->inten |= (0x1 << addr); + } else { + // Disable and clear the interrupt + i2cs->inten &= ~(0x1 << addr); + i2cs->intfl = (0x1 << addr); + + // Clear the callback address + callbacks[i2cs_index][addr] = NULL; + } +} + +/**@} end of group i2cs*/