Skip to content

I2C slave protocol to answer to multiple addresses for the RP2040

License

Notifications You must be signed in to change notification settings

dgatf/I2C-slave-multi-address-RP2040

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

I2C slave protocol to answer to multiple addresses for the RP2040

This is a pio program for the RP2040 that implements I2C slave protocol and answers to multiple addresses. It is compatible with the SDK and Arduino.

How to use it:

  • With SDK. Add i2c_multi.pio, i2c_multi.h and i2c_multi.c to your project. Modify CMakeLists.txt. Add pico_generate_pio_header and the required libraries (pico_stdlib, hardware_irq, hardware_pio, hardware_i2c). See CMakeLists.txt.
  • With Arduino. Add i2c_multi.pio.h, i2c_multi.h and i2c_multi.c to your project.
  • Define required handlers: receive, request and stop. Handlers are optional.
  • Set pointer to write buffer.
  • Enable desired I2C addresses to send and receive data.

Use pull up resistors (1k to 3.3k)

See main.c with code example.

Occupies one entire pio.


RP2040 as I2C slave (left), receving and sending data to multiple I2C addresses sent from I2C master (right)

Functions:

void i2c_multi_init(pio, pin)

Must be called in first place

Parameters:
  pio - load the pio program at pio0 or pio1
  pin - set SDA at pin and SCL at pin + 1

void i2c_multi_set_receive_handler(i2c_receive_handler_t i2c_receive_handler)

Parameters:
  i2c_receive_handler - receive handler function

void i2c_multi_set_request_handler(i2c_request_handler_t i2c_request_handler)

Parameters:
  i2c_request_handler - request handler function

void i2c_multi_set_stop_handler(i2c_stop_handler_t 2c_stop_handler)

Parameters:
  i2c_stop_handler - stop handler function

void i2c_multi_set_write_buffer(uint8_t buffer)

Parameters:
  buffer - write buffer

void i2c_multi_disable(void)

Sets I2C on hold. Disables I2C pio states machines

void i2c_multi_restart(void)

Restart I2C pio states machines and the byte counter

void i2c_multi_remove(void)

Removes I2C pio states machines, handlers, write buffer and counter

void i2c_multi_enable_address(uint8_t address)

Parameters:
  address - enable I2C address

void i2c_multi_disable_address(uint8_t address)

Parameters:
  address - disable I2C address

void i2c_multi_enable_all_addresses(void)
Enables all I2C addresses

void i2c_multi_disable_all_addresses(void)
Disables all I2C addresses

bool i2c_multi_is_address_enabled(uint8_t address)

Parameters:
  address - check wheter I2C address is enabled

Returns:
  true if enabled, false if disabled

Handler functions:

void receive_handler(uint8_t data, bool is_address)

Parameters received:
  data - byte or address received
  is_address - true is address, false is byte received

void request_handler(uint8_t address)

Parameters received:
  address - I2C address

void stop_handler(uint8_t length)

Parameters received:
  length - number of bytes received or sent

About

I2C slave protocol to answer to multiple addresses for the RP2040

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published