i2c.h 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  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. /*
  51. * Probe the given I2C chip address. Returns 0 if a chip responded,
  52. * not 0 on failure.
  53. */
  54. int i2c_probe(uchar chip);
  55. /*
  56. * Read/Write interface:
  57. * chip: I2C chip address, range 0..127
  58. * addr: Memory (register) address within the chip
  59. * alen: Number of bytes to use for addr (typically 1, 2 for larger
  60. * memories, 0 for register type devices with only one
  61. * register)
  62. * buffer: Where to read/write the data
  63. * len: How many bytes to read/write
  64. *
  65. * Returns: 0 on success, not 0 on failure
  66. */
  67. int i2c_read(uchar chip, uint addr, int alen, uchar *buffer, int len);
  68. int i2c_write(uchar chip, uint addr, int alen, uchar *buffer, int len);
  69. /*
  70. * Utility routines to read/write registers.
  71. */
  72. uchar i2c_reg_read (uchar chip, uchar reg);
  73. void i2c_reg_write(uchar chip, uchar reg, uchar val);
  74. #endif /* _I2C_H_ */