12#include "hardware/structs/i2c.h"
13#include "hardware/regs/dreq.h"
16#ifndef PARAM_ASSERTIONS_ENABLED_I2C
17#define PARAM_ASSERTIONS_ENABLED_I2C 0
68#define i2c0 (&i2c0_inst)
69#define i2c1 (&i2c1_inst)
71#if !defined(PICO_DEFAULT_I2C_INSTANCE) && defined(PICO_DEFAULT_I2C)
72#define PICO_DEFAULT_I2C_INSTANCE (__CONCAT(i2c,PICO_DEFAULT_I2C))
75#ifdef PICO_DEFAULT_I2C_INSTANCE
76#define i2c_default PICO_DEFAULT_I2C_INSTANCE
137 bool restart_on_next;
147 invalid_params_if(I2C, i2c !=
i2c0 && i2c !=
i2c1);
148 return i2c ==
i2c1 ? 1 : 0;
207int i2c_write_timeout_per_char_us(
i2c_inst_t *i2c, uint8_t addr,
const uint8_t *src,
size_t len,
bool nostop, uint timeout_per_char_us);
226int i2c_read_timeout_per_char_us(
i2c_inst_t *i2c, uint8_t addr, uint8_t *dst,
size_t len,
bool nostop, uint timeout_per_char_us);
263 const size_t IC_TX_BUFFER_DEPTH = 16;
264 return IC_TX_BUFFER_DEPTH - i2c_get_hw(i2c)->txflr;
275 return i2c_get_hw(i2c)->rxflr;
289 for (
size_t i = 0; i < len; ++i) {
293 i2c_get_hw(i2c)->data_cmd = *src++;
308 for (
size_t i = 0; i < len; ++i) {
311 *dst++ = (uint8_t)i2c_get_hw(i2c)->data_cmd;
322 static_assert(DREQ_I2C0_RX == DREQ_I2C0_TX + 1,
"");
323 static_assert(DREQ_I2C1_RX == DREQ_I2C1_TX + 1,
"");
324 static_assert(DREQ_I2C1_TX == DREQ_I2C0_TX + 2,
"");
static int i2c_write_timeout_us(i2c_inst_t *i2c, uint8_t addr, const uint8_t *src, size_t len, bool nostop, uint timeout_us)
Attempt to write specified number of bytes to address, with timeout.
Definition: i2c.h:202
int i2c_read_blocking_until(i2c_inst_t *i2c, uint8_t addr, uint8_t *dst, size_t len, bool nostop, absolute_time_t until)
Attempt to read specified number of bytes from address, blocking until the specified absolute time is...
Definition: i2c.c:327
void i2c_deinit(i2c_inst_t *i2c)
Disable the I2C HW block.
Definition: i2c.c:60
void i2c_set_slave_mode(i2c_inst_t *i2c, bool slave, uint8_t addr)
Set I2C port to slave mode.
Definition: i2c.c:114
static uint i2c_hw_index(i2c_inst_t *i2c)
Convert I2C instance to hardware instance number.
Definition: i2c.h:146
int i2c_write_blocking(i2c_inst_t *i2c, uint8_t addr, const uint8_t *src, size_t len, bool nostop)
Attempt to write specified number of bytes to address, blocking.
Definition: i2c.c:243
i2c_inst_t i2c0_inst
The I2C identifiers for use in I2C functions.
Definition: i2c.c:15
static size_t i2c_get_read_available(i2c_inst_t *i2c)
Determine number of bytes received.
Definition: i2c.h:274
uint i2c_set_baudrate(i2c_inst_t *i2c, uint baudrate)
Set I2C baudrate.
Definition: i2c.c:64
static size_t i2c_get_write_available(i2c_inst_t *i2c)
Determine non-blocking write space available.
Definition: i2c.h:262
static int i2c_read_timeout_us(i2c_inst_t *i2c, uint8_t addr, uint8_t *dst, size_t len, bool nostop, uint timeout_us)
Attempt to read specified number of bytes from address, with timeout.
Definition: i2c.h:221
int i2c_read_blocking(i2c_inst_t *i2c, uint8_t addr, uint8_t *dst, size_t len, bool nostop)
Attempt to read specified number of bytes from address, blocking.
Definition: i2c.c:323
static void i2c_read_raw_blocking(i2c_inst_t *i2c, uint8_t *dst, size_t len)
Read direct from RX FIFO.
Definition: i2c.h:307
static uint i2c_get_dreq(i2c_inst_t *i2c, bool is_tx)
Return the DREQ to use for pacing transfers to/from a particular I2C instance.
Definition: i2c.h:321
uint i2c_init(i2c_inst_t *i2c, uint baudrate)
Initialise the I2C HW block.
Definition: i2c.c:34
static void i2c_write_raw_blocking(i2c_inst_t *i2c, const uint8_t *src, size_t len)
Write direct to TX FIFO.
Definition: i2c.h:288
int i2c_write_blocking_until(i2c_inst_t *i2c, uint8_t addr, const uint8_t *src, size_t len, bool nostop, absolute_time_t until)
Attempt to write specified number of bytes to address, blocking until the specified absolute time is ...
Definition: i2c.c:247
static absolute_time_t make_timeout_time_us(uint64_t us)
Convenience method to get the timestamp a number of microseconds from the current time.
Definition: time.h:129
#define i2c0
Identifier for I2C HW Block 0.
Definition: i2c.h:68
#define i2c1
Identifier for I2C HW Block 1.
Definition: i2c.h:69