twihs_slave.h 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. /**
  2. * \file
  3. *
  4. * \brief TWIHS Slave Mode management
  5. *
  6. * Copyright (c) 2013-2015 Atmel Corporation. All rights reserved.
  7. *
  8. * \asf_license_start
  9. *
  10. * \page License
  11. *
  12. * Redistribution and use in source and binary forms, with or without
  13. * modification, are permitted provided that the following conditions are met:
  14. *
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. *
  18. * 2. Redistributions in binary form must reproduce the above copyright notice,
  19. * this list of conditions and the following disclaimer in the documentation
  20. * and/or other materials provided with the distribution.
  21. *
  22. * 3. The name of Atmel may not be used to endorse or promote products derived
  23. * from this software without specific prior written permission.
  24. *
  25. * 4. This software may only be redistributed and used in connection with an
  26. * Atmel microcontroller product.
  27. *
  28. * THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED
  29. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  30. * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
  31. * EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR
  32. * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  33. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  34. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  35. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  36. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  37. * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  38. * POSSIBILITY OF SUCH DAMAGE.
  39. *
  40. * \asf_license_stop
  41. *
  42. */
  43. /*
  44. * Support and FAQ: visit <a href="http://www.atmel.com/design-support/">Atmel Support</a>
  45. */
  46. #ifndef TWIHS_SLAVE_H_INCLUDED
  47. #define TWIHS_SLAVE_H_INCLUDED
  48. #include <parts.h>
  49. #include <compiler.h>
  50. #if (SAMG || SAMV70 || SAMV71 || SAME70 || SAMS70)
  51. # include "sam_twihs/twihs_slave.h"
  52. #else
  53. # error Unsupported chip type
  54. #endif
  55. /**
  56. *
  57. * \defgroup twihs_group Two Wire-interface High Speed(TWIHS)
  58. *
  59. * This is the common API for TWIHS. Additional features are available
  60. * in the documentation of the specific modules.
  61. *
  62. * \section twihs_group_platform Platform Dependencies
  63. *
  64. * The twihs API is partially chip- or platform-specific. While all
  65. * platforms provide mostly the same functionality, there are some
  66. * variations around how different bus types and clock tree structures
  67. * are handled.
  68. *
  69. * The following functions are available on all platforms, but there may
  70. * be variations in the function signature (i.e. parameters) and
  71. * behaviour. These functions are typically called by platform-specific
  72. * parts of drivers, and applications that aren't intended to be
  73. * portable:
  74. * - twihs_slave_setup()
  75. * - twihs_slave_enable()
  76. * - twihs_slave_disable()
  77. * - twihs_slave_read()
  78. * - twihs_slave_write()
  79. *
  80. * @{
  81. */
  82. /**
  83. * \typedef twihs_slave_t
  84. * This type can be used independently to refer to TWIHS slave module for the
  85. * architecture used.
  86. */
  87. //! @}
  88. #endif /* TWIHS_SLAVE_H_INCLUDED */