i2c-xzynq-axi

Driver for AXI inter-integrated circuits for the Xilinx ZYNQ ZCU106 platforms. A bitstream including AXI I2C core must be loaded before starting the driver.

Note:
ZCU102 does not support this driver. For the ZCU106 Video Codec Unit (VCU) core, you must have the Xilinx-specific FPGA image (system.bit) which includes VCU.

Syntax:

i2c-xzynq-axi [zynq_options [zynq_options]...]
           [generic_option [generic option]...]

Runs on:

QNX OS

Options:

There are board-specific (single-dash) and generic (double-dash) options available.
CAUTION:
Board-specific options must always appear before generic options, otherwise the driver fails to initialize. For example, the correct sequence would as follows: 
i2c-xzynq-axi -v --u0
However, if you incorrectly issue the command in the wrong sequence as shown here, it will fail:
i2c-xzynq-axi --u0 -v

Board-specific options:

These are Xilinx board-specific drivers.
-c clock
The s_axi_aclk frequency in Hertz (Hz). The default is what's specified in the firmware.
-i irq
The IRQ. There is no default IRQ.
-jclock source
The TSUSTA (address space offset of 128h) timing parameters. The value specified in firmware is the default.
-ktsusto address
The TSUSTO (address space offset of #12C) timing parameters. The value specified in firmware is the default.
-lthdsta address
The THDSTA (address space offset of 130h) timing parameters. The value specified in firmware is the default.
-mtsudat address
The TSUDAT (address space offset of 134h) timing parameters. The value specified in firmware is the default.
-ntbuf address
The TBUF (address space offset of 138h) timing parameters. The value specified in firmware is the default.
-othigh address
The THIGH (address space offset of 13Ch) timing parameters. The value specified in firmware is the default.
-p address
Base address of the controller. There is no default address.
-qtlow address
The TLOW (address space offset of 140h) timing parameters. The value specified in firmware is the default.
-rthddat address
The THDDAT (address space offset of 144h) timing parameters. The value specified in firmware is the default.
-stsusta address
The clock source. The default is 0. The following values can be used:
  • 1 — XZYNQ_DBG_TRACE_CTRL
  • 2 — XZYNQ_DBG_FPD_CTRL
  • 3 — XZYNQ_DP_VIDEO_CTRL
  • 4 — XZYNQ_DP_AUDIO_CTRL
  • 5 — XZYNQ_DP_STC_CTRL
  • 6 — XZYNQ_DDR_CTRL
  • 7 — XZYNQ_GPU_CTRL
  • 8 — XZYNQ_SATA_CTRL
  • 9 — XZYNQ_PCIE_CTRL
  • 10 — XZYNQ_FPD_DMA_CTRL
  • 11 — XZYNQ_DPDMA_CTRL
  • 12 — XZYNQ_TOPSW_LSBUS_CTRL
  • 13 — XZYNQ_TOPSW_TSTMP_CTRL
  • 14 — XZYNQ_TOPSW_TSTMP_CTRL
  • 15 — XZYNQ_GEM0_CTRL
  • 16 — XZYNQ_GEM1_CTRL
  • 17 — XZYNQ_GEM2_CTRL
  • 18 — XZYNQ_GEM3_CTRL
  • 19 — XZYNQ_USB0_CTRL
  • 20 — XZYNQ_USB1_CTRL
  • 21 — XZYNQ_QSPI_CTRL
  • 22 — XZYNQ_SDIO_CTRL
  • 23 — XZYNQ_UART0_CTRL
  • 24 — XZYNQ_UART1_CTRL
  • 25 — XZYNQ_SPI0_CTRL
  • 26 — XZYNQ_SPI1_CTRL
  • 27 — XZYNQ_CAN0_CTRL
  • 28 — XZYNQ_CAN1_CTRL
  • 29 — XZYNQ_CPU_R5_CTRL
  • 30 — XZYNQ_IOU_SWITCH_CTRL
  • 31 — XZYNQ_CSU_PLL_CTRL
  • 32 — XZYNQ_PCAP_CTRL
  • 33 — XZYNQ_LPD_SWITCH_CTRL
  • 34 — XZYNQ_LPD_SBUS_CTRL
  • 35 — XZYNQ_DBG_LPD_CTRL
  • 36 — XZYNQ_NAND_CTRL
  • 37 — XZYNQ_LPD_DMA_CTRL
  • 38 — XZYNQ_PL0_CTRL
  • 39 — XZYNQ_PL1_CTRL
  • 40 — XZYNQ_PL2_CTRL
  • 41 — XZYNQ_PL3_CTRL
  • 42 — XZYNQ_GEM_TSU_CTRL
  • 43 — XZYNQ_AMS_CTRL
  • 44 — XZYNQ_I2C0_CTRL
  • 45 — XZYNQ_I2C1_CTRL
  • 46 — XZYNQ_TIMESTAMP_CTRL
-v level
Set the mask for the verbosity level. The default is 0x9 (XAXI_INFO_VAL & XAXI_ERROR_VAL). The following specifies the values you can use for your mask:
  • 0x0001 (XAXI_ERROR_VAL)— Show errors logs.
  • 0x0002 (XAXI_WARNING_VAL)— Show warnings logs.
  • 0x0004 (XAXI_NOTICE_VAL)— Show notifications logs.
  • 0x0008 (XAXI_INFO_VAL)— Show information logs.
  • 0x0010 (XAXI_DEBUG1_VAL)— Show debug logs.
  • 0x0020 (XAXI_DEBUG2_VAL)— Show advanced debug logs.

Generic options:

These are the generic options for the driver.
--u unit
The unit number, which is the number to append to device name prefix (e.g., /dev/i2c). The default to use is 0 (zero).

Example:

Specify a base of address 0xA0051000 with an IRQ of 139: 
i2c-xzynq-axi -p 0xA0051000 -i 139 --u 2
Page updated: