text: /*
   * This file is part of the MicroPython project, http://micropython.org/
   *
   * The MIT License (MIT)
   *
   * Copyright (c) 2013, 2014 Damien P. George
   * Copyright (c) 2019 Analog Devices, Inc.
   *
   * Permission is hereby granted, free of charge, to any person obtaining a copy
   * of this software and associated documentation files (the "Software"), to deal
   * in the Software without restriction, including without limitation the rights
   * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   * copies of the Software, and to permit persons to whom the Software is
   * furnished to do so, subject to the following conditions:
   *
   * The above copyright notice and this permission notice shall be included in
   * all copies or substantial portions of the Software.
   *
   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
   * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
   * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
   * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
   * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
   * THE SOFTWARE.
   */
  #ifndef MICROPY_INCLUDED_SC5XX_SPI_H
  #define MICROPY_INCLUDED_SC5XX_SPI_H
  
  #include "drivers/bus/spi.h"
  #include "bm_spi.h"
  
  typedef struct _spi_t {
      BM_SPI *spi;
  } spi_t;
  
  typedef struct _spi_proto_cfg_t {
      const spi_t *spi;
      uint32_t baudrate;
      uint8_t polarity;
      uint8_t phase;
      uint8_t bits;
  } spi_proto_cfg_t;
  
  typedef struct _machine_hard_spi_obj_t {
      mp_obj_base_t base;
      const spi_t *spi;
  } machine_hard_spi_obj_t;
  
  extern const spi_t spi_obj[3];
  
  extern const mp_spi_proto_t spi_proto;
  extern const mp_obj_type_t pyb_spi_type;
  extern const mp_obj_type_t machine_soft_spi_type;
  extern const mp_obj_type_t machine_hard_spi_type;
  
  // A transfer of "len" bytes should take len*8*1000/baudrate milliseconds.
  // To simplify the calculation we assume the baudrate is never less than 8kHz
  // and use that value for the baudrate in the formula, plus a small constant.
  #define SPI_TRANSFER_TIMEOUT(len) ((len) + 100)
  
  void spi_init0(void);
  void spi_init(const spi_t *spi, bool enable_nss_pin);
  void spi_deinit(const spi_t *spi_obj);
  int spi_find_index(mp_obj_t id);
  void spi_set_params(const spi_t *spi_obj, int32_t baudrate,
      int32_t polarity, int32_t phase, int32_t bits);
  void spi_transfer(const spi_t *self, size_t len, const uint8_t *src, uint8_t *dest, uint32_t timeout);
  void spi_print(const mp_print_t *print, const spi_t *spi_obj, bool legacy);
  const spi_t *spi_from_mp_obj(mp_obj_t o);
  
  #endif // MICROPY_INCLUDED_SC5XX_SPI_H
  