doc: espi_saf: Make documentation readable

Use @code ... @Endcode for ascii graphics.

Signed-off-by: Andrei Emeltchenko <[email protected]>

Author: finikorg

include/zephyr/drivers/espi_saf.h

@@ -29,6 +29,7 @@ extern "C" {
 
 
 /**
+ * @code
  *+----------------------------------------------------------------------+
  *|                                                                      |
  *|  eSPI host                           +-------------+                 |
@@ -80,6 +81,7 @@ extern "C" {
  * |  Flash  |  Slave Attached Flash   |
  * +---------+                         |
  *                                     |
+ * @endcode
  */
 
 
@@ -177,6 +179,7 @@ __subsystem struct espi_saf_driver_api {
  * will be used by eSPI master to determine minimum common capabilities with
  * eSPI slave then send via SET_CONFIGURATION command.
  *
+ * @code
  * +--------+   +---------+     +------+          +---------+   +---------+
  * |  eSPI  |   |  eSPI   |     | eSPI |          |  eSPI   |   |  eSPI   |
  * |  slave |   | driver  |     |  bus |          |  driver |   |  host   |
@@ -200,6 +203,7 @@ __subsystem struct espi_saf_driver_api {
  *     |              |            |  accept           |             |
  *     |              |            +------------------>+             |
  *     +              +            +                   +             +
+ * @endcode
  *
  * @param dev Pointer to the device structure for the driver instance.
  * @param cfg the device runtime configuration for the eSPI controller.
@@ -382,6 +386,7 @@ static inline int z_impl_espi_saf_flash_erase(const struct device *dev,
 /**
  * Callback model
  *
+ * @code
  *+-------+                  +-------------+   +------+     +---------+
  *|  App  |                  | eSPI driver |   |  HW  |     |eSPI Host|
  *+---+---+                  +-------+-----+   +---+--+     +----+----+
@@ -437,6 +442,7 @@ static inline int z_impl_espi_saf_flash_erase(const struct device *dev,
  *    <------------------------------+             |             |
  *    | App executes                 |             |             |
  *    + power mgmt policy            |             |             |
+ * @endcode
  */
 
 /**