MicroAPRS/bertos/cpu/arm/io/at91_twi.h

191 lines
8.1 KiB
C
Raw Normal View History

2014-04-03 14:21:37 -06:00
/**
* \file
* <!--
* This file is part of BeRTOS.
*
* Bertos is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*
* As a special exception, you may use this file as part of a free software
* library without restriction. Specifically, if other files instantiate
* templates or use macros or inline functions from this file, or you compile
* this file and link it with other files to produce an executable, this
* file does not by itself cause the resulting executable to be covered by
* the GNU General Public License. This exception does not however
* invalidate any other reasons why the executable file might be covered by
* the GNU General Public License.
*
* Copyright 2008 Develer S.r.l. (http://www.develer.com/)
*
* -->
*
*
* \author Francesco Sacchi <batt@develer.com>
*
* AT91SAM7 Two wire interface.
* This file is based on NUT/OS implementation. See license below.
*/
/*
* Copyright (C) 2006 by egnite Software GmbH. 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 copyright holders nor the names of
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY EGNITE SOFTWARE GMBH 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 EGNITE
* SOFTWARE GMBH 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 (*((reg32_t *)(INCLUDING NEGLIGENCE OR OTHERWISE))) ARISING IN ANY WAY OUT OF
* THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* For additional information see http://www.ethernut.de/
*/
#ifndef AT91_TWI_H
#define AT91_TWI_H
/**
* TWI Control Register.
* \{
*/
#define TWI_CR_OFF 0x00000000 ///< Control register offset.
#define TWI_CR (*((reg32_t *)(TWI_BASE + TWI_CR_OFF))) ///< Control register address.
#define TWI_START 0 ///< Send start condition.
#define TWI_STOP 1 ///< Send stop condition.
#define TWI_MSEN 2 ///< Enable master mode.
#define TWI_MSDIS 3 ///< Disable master mode.
/*
#define TWI_SVEN 4 ///< Enable slave mode.
#define TWI_SVDIS 5 ///< Disable slave mode.
*/
#define TWI_SWRST 7 ///< Software reset.
/*\}*/
/**
* TWI Master Mode Register.
* \{
*/
#define TWI_MMR_OFF 0x00000004 ///< Master mode register offset.
#define TWI_MMR (*((reg32_t *)(TWI_BASE + TWI_MMR_OFF))) ///< Master mode register address.
#define TWI_IADRSZ_SHIFT 8 ///< Internal device address size shift.
#define TWI_IADRSZ 0x00000300 ///< Internal device address size mask.
#define TWI_IADRSZ_NONE 0x00000000 ///< No internal device address.
#define TWI_IADRSZ_1BYTE 0x00000100 ///< One byte internal device address.
#define TWI_IADRSZ_2BYTE 0x00000200 ///< Two byte internal device address.
#define TWI_IADRSZ_3BYTE 0x00000300 ///< Three byte internal device address.
#define TWI_MREAD 12 ///< Master read direction.
#define TWI_DADR 0x007F0000 ///< Device address mask.
#define TWI_DADR_SHIFT 16 ///< Device address LSB.
/*\}*/
/**
* TWI Internal Address Register.
* \{
*/
#define TWI_IADR_OFF 0x0000000C ///< Internal address register offset.
#define TWI_IADR (*((reg32_t *)(TWI_BASE + TWI_IADR_OFF))) ///< Internal address register address.
#define TWI_IADR_MASK 0x00FFFFFF ///< Internal address mask.
#define TWI_IADR_SHIFT 0 ///< Internal address LSB.
/*\}*/
/**
* TWI Clock Waveform Generator Register.
* \{
*/
#define TWI_CWGR_OFF 0x00000010 ///< Clock waveform generator register offset.
#define TWI_CWGR (*((reg32_t *)(TWI_BASE + TWI_CWGR_OFF))) ///< Clock waveform generator register address.
#define TWI_CLDIV 0x000000FF ///< Clock low divider mask.
#define TWI_CLDIV_SHIFT 0 ///< Clock low divider LSB.
#define TWI_CHDIV 0x0000FF00 ///< Clock high divider mask.
#define TWI_CHDIV_SHIFT 8 ///< Clock high divider LSB.
#define TWI_CKDIV 0x00070000 ///< Clock divider mask.
#define TWI_CKDIV_SHIFT 16 ///< Clock divider LSB.
/*\}*/
/**
* TWI Status and Interrupt Registers.
* \{
*/
#define TWI_SR_OFF 0x00000020 ///< Status register offset.
#define TWI_SR (*((reg32_t *)(TWI_BASE + TWI_SR_OFF))) ///< Status register address.
#define TWI_IER_OFF 0x00000024 ///< Interrupt enable register offset.
#define TWI_IER (*((reg32_t *)(TWI_BASE + TWI_IER_OFF))) ///< Interrupt enable register address.
#define TWI_IDR_OFF 0x00000028 ///< Interrupt disable register offset.
#define TWI_IDR (*((reg32_t *)(TWI_BASE + TWI_IDR_OFF))) ///< Interrupt disable register address.
#define TWI_IMR_OFF 0x0000002C ///< Interrupt mask register offset.
#define TWI_IMR (*((reg32_t *)(TWI_BASE + TWI_IMR_OFF))) ///< Interrupt mask register address.
#define TWI_TXCOMP 0 ///< Transmission completed.
#define TWI_RXRDY 1 ///< Receive holding register ready.
#define TWI_TXRDY 2 ///< Transmit holding register ready.
/*
#define TWI_SVREAD 0x00000008 ///< Slave read.
#define TWI_SVACC 0x00000010 ///< Slave access.
#define TWI_GACC 0x00000020 ///< General call access.
*/
#if CPU_ARM_SAM7X
#define TWI_OVRE 6 ///< Overrun error.
#define TWI_UNRE 7 ///< Underrun error.
#endif
#define TWI_NACK 8 ///< Not acknowledged.
/*
#define TWI_ARBLST 0x00000200 ///< Arbitration lost.
#define TWI_SCLWS 0x00000400 ///< Clock wait state.
#define TWI_EOSACC 0x00000800 ///< End of slave access.
*/
/*\}*/
/**
* TWI Receive Holding Register.
* \{
*/
#define TWI_RHR_OFF 0x00000030 ///< Receive holding register offset.
#define TWI_RHR (*((reg32_t *)(TWI_BASE + TWI_RHR_OFF))) ///< Receive holding register address.
/*\}*/
/**
* TWI Transmit Holding Register.
* \{
*/
#define TWI_THR_OFF 0x00000034 ///< Transmit holding register offset.
#define TWI_THR (*((reg32_t *)(TWI_BASE + TWI_THR_OFF))) ///< Transmit holding register address.
/*\}*/
#endif /* AT91_TWI_H */