i2c.h 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. /*
  2. * (C) Copyright 2001
  3. * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com.
  4. *
  5. * See file CREDITS for list of people who contributed to this
  6. * project.
  7. *
  8. * This program is free software; you can redistribute it and/or
  9. * modify it under the terms of the GNU General Public License as
  10. * published by the Free Software Foundation; either version 2 of
  11. * the License, or (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program; if not, write to the Free Software
  20. * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
  21. * MA 02111-1307 USA
  22. *
  23. * The original I2C interface was
  24. * (C) 2000 by Paolo Scaffardi (arsenio@tin.it)
  25. * AIRVENT SAM s.p.a - RIMINI(ITALY)
  26. * but has been changed substantially.
  27. */
  28. #ifndef _I2C_H_
  29. #define _I2C_H_
  30. /*
  31. * WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  32. *
  33. * The implementation MUST NOT use static or global variables if the
  34. * I2C routines are used to read SDRAM configuration information
  35. * because this is done before the memories are initialized. Limited
  36. * use of stack-based variables are OK (the initial stack size is
  37. * limited).
  38. *
  39. * WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  40. */
  41. /*
  42. * Configuration items.
  43. */
  44. #define I2C_RXTX_LEN 128 /* maximum tx/rx buffer length */
  45. /*
  46. * Initialization, must be called once on start up, may be called
  47. * repeatedly to change the speed and slave addresses.
  48. */
  49. void i2c_init(int speed, int slaveaddr);
  50. #ifdef CFG_I2C_INIT_BOARD
  51. void i2c_init_board(void);
  52. #endif
  53. /*
  54. * Probe the given I2C chip address. Returns 0 if a chip responded,
  55. * not 0 on failure.
  56. */
  57. int i2c_probe(uchar chip);
  58. /*
  59. * Read/Write interface:
  60. * chip: I2C chip address, range 0..127
  61. * addr: Memory (register) address within the chip
  62. * alen: Number of bytes to use for addr (typically 1, 2 for larger
  63. * memories, 0 for register type devices with only one
  64. * register)
  65. * buffer: Where to read/write the data
  66. * len: How many bytes to read/write
  67. *
  68. * Returns: 0 on success, not 0 on failure
  69. */
  70. int i2c_read(uchar chip, uint addr, int alen, uchar *buffer, int len);
  71. int i2c_write(uchar chip, uint addr, int alen, uchar *buffer, int len);
  72. /*
  73. * Utility routines to read/write registers.
  74. */
  75. uchar i2c_reg_read (uchar chip, uchar reg);
  76. void i2c_reg_write(uchar chip, uchar reg, uchar val);
  77. #endif /* _I2C_H_ */