---
tag: m0261
title: I2C Request
brief: Request and echo bytes from the I2C bus.
author: thinkyhead

group: i2c
requires: EXPERIMENTAL_I2CBUS
experimental: true

codes: [ M261 ]
related: [ M260 ]

parameters:

- tag: A
  optional: false
  description: The bus address to request bytes from
  values:
  - tag: addr
    type: int

- tag: B
  optional: false
  description: The number of bytes to request
  values:
  - tag: count
    type: int

- tag: S
  optional: true
  since: 2.0.9.3
  description: Output style. Default is 0 (raw echo) if nothing else is given.
  values:
  - tag: 0
    type: style
    description: Raw echo
  - tag: 1
    description: Bytes (hex)
    type: style
  - tag: 2
    description: 1 or 2 byte value (decimal)
    type: style
  - tag: 3
    description: Bytes (decimal)
    type: style

---

Request bytes from the I2C bus and echo them to the host. To find out how to do more useful things with I2C see the I2C master / slave article.
