LCOV - code coverage report
Current view: top level - zephyr/drivers/i3c - hdr_ddr.h Coverage Total Hit
Test: new.info Lines: 75.0 % 4 3
Test Date: 2025-09-05 16:43:28

            Line data    Source code
       1            0 : /*
       2              :  * Copyright 2024 Meta Platforms
       3              :  *
       4              :  * SPDX-License-Identifier: Apache-2.0
       5              :  */
       6              : 
       7              : #ifndef ZEPHYR_INCLUDE_DRIVERS_I3C_HDR_DDR_H_
       8              : #define ZEPHYR_INCLUDE_DRIVERS_I3C_HDR_DDR_H_
       9              : 
      10              : /**
      11              :  * @brief I3C HDR DDR API
      12              :  * @defgroup i3c_hdr_ddr I3C HDR DDR API
      13              :  * @ingroup i3c_interface
      14              :  * @{
      15              :  */
      16              : 
      17              : #include <errno.h>
      18              : #include <stddef.h>
      19              : #include <stdint.h>
      20              : 
      21              : #include <zephyr/drivers/i3c.h>
      22              : 
      23              : #ifdef __cplusplus
      24              : extern "C" {
      25              : #endif
      26              : 
      27              : /**
      28              :  * @brief Write a set amount of data to an I3C target device with HDR DDR.
      29              :  *
      30              :  * This routine writes a set amount of data synchronously.
      31              :  *
      32              :  * @param target I3C target device descriptor.
      33              :  * @param cmd 7-bit command code
      34              :  * @param buf Memory pool from which the data is transferred.
      35              :  * @param num_bytes Number of bytes to write.
      36              :  *
      37              :  * @retval 0 If successful.
      38              :  * @retval -EBUSY Bus is busy.
      39              :  * @retval -EIO General input / output error.
      40              :  */
      41            1 : static inline int i3c_hdr_ddr_write(struct i3c_device_desc *target, uint8_t cmd, uint8_t *buf,
      42              :                                     uint32_t num_bytes)
      43              : {
      44              :         struct i3c_msg msg;
      45              : 
      46              :         msg.buf = buf;
      47              :         msg.len = num_bytes;
      48              :         msg.flags = I3C_MSG_WRITE | I3C_MSG_STOP | I3C_MSG_HDR;
      49              :         msg.hdr_mode = I3C_MSG_HDR_DDR;
      50              :         msg.hdr_cmd_code = cmd;
      51              : 
      52              :         return i3c_transfer(target, &msg, 1);
      53              : }
      54              : 
      55              : /**
      56              :  * @brief Read a set amount of data from an I3C target device with HDR DDR.
      57              :  *
      58              :  * This routine reads a set amount of data synchronously.
      59              :  *
      60              :  * @param target I3C target device descriptor.
      61              :  * @param cmd 7-bit command code
      62              :  * @param buf Memory pool that stores the retrieved data.
      63              :  * @param num_bytes Number of bytes to read.
      64              :  *
      65              :  * @retval 0 If successful.
      66              :  * @retval -EBUSY Bus is busy.
      67              :  * @retval -EIO General input / output error.
      68              :  */
      69            1 : static inline int i3c_hdr_ddr_read(struct i3c_device_desc *target, uint8_t cmd, uint8_t *buf,
      70              :                                    uint32_t num_bytes)
      71              : {
      72              :         struct i3c_msg msg;
      73              : 
      74              :         msg.buf = buf;
      75              :         msg.len = num_bytes;
      76              :         msg.flags = I3C_MSG_READ | I3C_MSG_STOP | I3C_MSG_HDR;
      77              :         msg.hdr_mode = I3C_MSG_HDR_DDR;
      78              :         msg.hdr_cmd_code = cmd;
      79              : 
      80              :         return i3c_transfer(target, &msg, 1);
      81              : }
      82              : 
      83              : /**
      84              :  * @brief Write then read data from an I3C target device with HDR DDR.
      85              :  *
      86              :  * This supports the common operation "this is what I want", "now give
      87              :  * it to me" transaction pair through a combined write-then-read bus
      88              :  * transaction.
      89              :  *
      90              :  * @param target I3C target device descriptor.
      91              :  * @param write_buf Pointer to the data to be written
      92              :  * @param num_write Number of bytes to write
      93              :  * @param read_cmd 7-bit command code for read
      94              :  * @param read_buf Pointer to storage for read data
      95              :  * @param num_read Number of bytes to read
      96              :  * @param write_cmd 7-bit command code for write
      97              :  *
      98              :  * @retval 0 if successful
      99              :  * @retval -EBUSY Bus is busy.
     100              :  * @retval -EIO General input / output error.
     101              :  */
     102            1 : static inline int i3c_hdr_ddr_write_read(struct i3c_device_desc *target, const void *write_buf,
     103              :                                          size_t num_write, uint8_t read_cmd, void *read_buf,
     104              :                                          size_t num_read, uint8_t write_cmd)
     105              : {
     106              :         struct i3c_msg msg[2];
     107              : 
     108              :         msg[0].buf = (uint8_t *)write_buf;
     109              :         msg[0].len = num_write;
     110              :         msg[0].flags = I3C_MSG_WRITE | I3C_MSG_HDR;
     111              :         msg[0].hdr_mode = I3C_MSG_HDR_DDR;
     112              :         msg[0].hdr_cmd_code = write_cmd;
     113              : 
     114              :         msg[1].buf = (uint8_t *)read_buf;
     115              :         msg[1].len = num_read;
     116              :         msg[1].flags = I3C_MSG_RESTART | I3C_MSG_READ | I3C_MSG_HDR | I3C_MSG_STOP;
     117              :         msg[1].hdr_mode = I3C_MSG_HDR_DDR;
     118              :         msg[1].hdr_cmd_code = read_cmd;
     119              : 
     120              :         return i3c_transfer(target, msg, 2);
     121              : }
     122              : 
     123              : #ifdef __cplusplus
     124              : }
     125              : #endif
     126              : 
     127              : /**
     128              :  * @}
     129              :  */
     130              : 
     131              : #endif /* ZEPHYR_INCLUDE_DRIVERS_I3C_HDR_DDR_H_ */
        

Generated by: LCOV version 2.0-1