usb_selftest_host.c

Go to the documentation of this file.

 
#include "usb_selftest_host.h"
 
#include <stdint.h>
#include <string.h>
 
#include "ra8_board_ek_ra8d2.h"
#include "ra8_err.h"
#include "ra8_fs.h"
#include "ra8_io_blockdev.h"
#include "ra8_io_blockdev_usbmsc.h"
#include "ra8_time.h"
#include "ra8_usb_hmsc.h"
#include "usb_selftest_common.h"
#include "usb_selftest_console.h"
 
/* -------------------------------------------------------------------------- */
/* J-Link probes (host side) */
/* -------------------------------------------------------------------------- */

static volatile uint32_t s_dbg_phase;
static volatile uint32_t s_dbg_verified_bytes;
static volatile uint32_t s_dbg_mismatch_off = (uint32_t)k_selftest_no_mismatch;
static volatile uint32_t s_dbg_verify_ms;
static volatile uint32_t s_dbg_pass_count;
 
/* -------------------------------------------------------------------------- */
/* Host side: ra8_fs mount over the ra8_io USB-MSC block device */
/* -------------------------------------------------------------------------- */

static ra8_io_blockdev_t s_selftest_usb_dev;

static ra8_io_blockdev_usbmsc_state_t s_selftest_usb_state;

static const char* selftest_fs_type_name(ra8_fs_type_t type)
{
  switch (type) {
    case k_ra8_fs_type_fat12:
      return "fat12";
    case k_ra8_fs_type_fat16:
      return "fat16";
    case k_ra8_fs_type_fat32:
      return "fat32";
    case k_ra8_fs_type_exfat:
      return "exfat";
    case k_ra8_fs_type_unknown:
    default:
      return "unknown";
  }
}

[[nodiscard]] static ra8_err_t selftest_mount_volume(ra8_fs_mount_t** out_mount)
{
  ra8_err_t err = ra8_io_blockdev_usbmsc_init(&s_selftest_usb_dev,
                                              &s_selftest_usb_state,
                                              (uint8_t)k_selftest_target_lun);
  if (err != k_ra8_ok) {
    (void)selftest_print_fail("blockdev", err);
    return err;
  }
  ra8_fs_backend_t backend = {};
  err                      = ra8_io_blockdev_as_fs_backend(&s_selftest_usb_dev, &backend);
  if (err != k_ra8_ok) {
    (void)selftest_print_fail("backend", err);
    return err;
  }
  err = ra8_fs_mount(&backend, out_mount);
  if (err != k_ra8_ok) {
    (void)selftest_print_fail("mount", err);
    return err;
  }
  err = selftest_print("ra8d2 selftest: mounted fs=");
  if (err != k_ra8_ok) {
    return err;
  }
  err = selftest_print(selftest_fs_type_name((*out_mount)->type));
  if (err != k_ra8_ok) {
    return err;
  }
  return selftest_print("\r\n");
}

[[nodiscard]] static ra8_err_t selftest_verify_mram_raw(void)
{
  static uint8_t s_burst[k_selftest_burst_bytes] = {};
 
  s_dbg_verified_bytes = 0U;
  s_dbg_mismatch_off   = (uint32_t)k_selftest_no_mismatch;
  const uint32_t t0    = ra8_time_ms();
  for (uint32_t blk = 0U; blk < (uint32_t)k_fat_mram_clusters;
       blk += (uint32_t)k_selftest_burst_blocks) {
    const uint32_t lba = (uint32_t)k_fat_data_lba + blk;
    ra8_err_t      err = ra8_usb_hmsc_read10((uint8_t)k_selftest_target_lun,
                                             lba,
                                             (uint16_t)k_selftest_burst_blocks,
                                             s_burst);
    if (err != k_ra8_ok) {
      (void)selftest_print_fail("READ(10) burst", err);
      return err;
    }
    const uint32_t offset = blk * (uint32_t)k_selftest_block_size;
    const uint8_t* mram   = (const uint8_t*)(uintptr_t)((uint32_t)k_mram_base_addr + offset);
    if (memcmp(s_burst, mram, (size_t)k_selftest_burst_bytes) != 0) {
      s_dbg_mismatch_off = offset;
      (void)selftest_print_fail("content mismatch at 0x", (ra8_err_t)offset);
      return k_ra8_err_invalid_state;
    }
    s_dbg_verified_bytes = offset + (uint32_t)k_selftest_burst_bytes;
  }
  s_dbg_verify_ms = ra8_time_ms() - t0;
  return k_ra8_ok;
}

[[nodiscard]] static ra8_err_t selftest_write_protect_probe(void)
{
  static uint8_t s_wp_buf[k_selftest_block_size] = {};
 
  ra8_err_t err = selftest_print("ra8d2 selftest: WRITE(10) into RO LUN must be rejected...\r\n");
  if (err != k_ra8_ok) {
    return err;
  }
  const ra8_err_t wr = ra8_usb_hmsc_write10((uint8_t)k_selftest_target_lun,
                                            (uint32_t)k_selftest_wp_probe_lba,
                                            1U,
                                            s_wp_buf);
  if (wr == k_ra8_ok) {
    (void)selftest_print_fail("write unexpectedly accepted", k_ra8_err_invalid_state);
    return k_ra8_err_invalid_state;
  }
  err = selftest_print("ra8d2 selftest: write rejected (code 0x");
  if (err != k_ra8_ok) {
    return err;
  }
  err = selftest_print_hex((uint32_t)wr, (uint8_t)k_selftest_hex_chars_u32);
  if (err != k_ra8_ok) {
    return err;
  }
  return selftest_print("), MRAM protected\r\n");
}

[[nodiscard]] static ra8_err_t selftest_host_enumerate(ra8_usb_hmsc_device_t* out_device)
{
  s_dbg_phase   = (uint32_t)k_selftest_phase_host_init;
  ra8_err_t err = selftest_print("ra8d2 selftest: host up on USB-HS, probing the loop...\r\n");
  if (err != k_ra8_ok) {
    return err;
  }
  err = ra8_usb_hmsc_init(k_ra8_usb_speed_hs);
  if (err != k_ra8_ok) {
    (void)selftest_print_fail("host init", err);
    return err;
  }
  s_dbg_phase = (uint32_t)k_selftest_phase_enum;
  err         = ra8_usb_hmsc_enumerate(out_device);
  if (err != k_ra8_ok) {
    (void)selftest_print_fail("enumerate", err);
    (void)ra8_usb_hmsc_close();
    return err;
  }
  err = selftest_print("ra8d2 selftest: enumerated vid=0x");
  if (err != k_ra8_ok) {
    return err;
  }
  err = selftest_print_hex((uint32_t)out_device->vendor_id, (uint8_t)k_selftest_hex_chars_u16);
  if (err != k_ra8_ok) {
    return err;
  }
  err = selftest_print(" pid=0x");
  if (err != k_ra8_ok) {
    return err;
  }
  err = selftest_print_hex((uint32_t)out_device->product_id, (uint8_t)k_selftest_hex_chars_u16);
  if (err != k_ra8_ok) {
    return err;
  }
  return selftest_print(" over the loop cable\r\n");
}

[[nodiscard]] static ra8_err_t selftest_print_soak_verdict(uint64_t total_bytes, uint64_t total_ms)
{
  uint64_t ms = total_ms;
  if (ms == 0U) {
    ms = 1U;
  }
  const uint32_t kib_per_s = (uint32_t)((total_bytes * (uint64_t)k_selftest_ms_per_sec) /
                                        (ms * (uint64_t)k_selftest_bytes_per_kib));
  ra8_err_t      err       = selftest_print("ra8d2 soak: ");
  if (err == k_ra8_ok) {
    err = selftest_print_dec((uint32_t)k_selftest_soak_iters);
  }
  if (err == k_ra8_ok) {
    err = selftest_print(" iters, ");
  }
  if (err == k_ra8_ok) {
    err = selftest_print_dec((uint32_t)(total_bytes / (uint64_t)k_selftest_bytes_per_mib));
  }
  if (err == k_ra8_ok) {
    err = selftest_print(" MiB verified in ");
  }
  if (err == k_ra8_ok) {
    err = selftest_print_dec((uint32_t)total_ms);
  }
  if (err == k_ra8_ok) {
    err = selftest_print(" ms (");
  }
  if (err == k_ra8_ok) {
    err = selftest_print_dec(kib_per_s);
  }
  if (err == k_ra8_ok) {
    err = selftest_print(" KiB/s), 0 errors\r\n");
  }
  return err;
}

[[nodiscard]] ra8_err_t selftest_host_pass(void)
{
  ra8_usb_hmsc_device_t device = {};
  ra8_err_t             err    = selftest_host_enumerate(&device);
  if (err != k_ra8_ok) {
    return err;
  }
  s_dbg_phase           = (uint32_t)k_selftest_phase_mount;
  ra8_fs_mount_t* mount = nullptr;
  err                   = selftest_mount_volume(&mount);
  if (err != k_ra8_ok) {
    (void)ra8_usb_hmsc_close();
    return err;
  }
  (void)ra8_fs_unmount(mount);
 
  s_dbg_phase          = (uint32_t)k_selftest_phase_verify;
  uint64_t total_bytes = 0U;
  uint64_t total_ms    = 0U;
  for (uint32_t it = 0U; it < (uint32_t)k_selftest_soak_iters; it++) {
    err = selftest_verify_mram_raw();
    if (err != k_ra8_ok) {
      (void)ra8_usb_hmsc_close();
      return err;
    }
    total_bytes += (uint64_t)s_dbg_verified_bytes;
    total_ms += (uint64_t)s_dbg_verify_ms;
    s_dbg_pass_count = it + 1U;
  }
 
  s_dbg_phase = (uint32_t)k_selftest_phase_wp;
  err         = selftest_write_protect_probe();
  if (err == k_ra8_ok) {
    err = selftest_print_soak_verdict(total_bytes, total_ms);
  }
  if (err != k_ra8_ok) {
    (void)ra8_usb_hmsc_close();
    return err;
  }
  s_dbg_phase = (uint32_t)k_selftest_phase_pass;
  err         = selftest_print("ra8d2 soak: USB SELFTEST SOAK PASS\r\n");
  if (err != k_ra8_ok) {
    return err;
  }
  (void)ra8_board_led_on(k_ra8_board_led2);
  return k_ra8_ok;
}