incubator-nuttx/boards/arm/s32k1xx/s32k148evb
Peter van der Perk 6b3b5751c1 S32K automatically calculate size of periphclocks array 2022-12-13 19:50:01 +08:00
..
configs/nsh sched: Remove SDCLONE_DISABLE option and config 2022-01-31 19:03:20 +01:00
include NXP S32K1XX boards: add up_perf_init to support SEGGER SystemView 2022-08-01 16:32:41 +03:00
scripts Move warning option from Make.defs to Toolchain.defs 2022-05-15 15:40:35 +03:00
src S32K automatically calculate size of periphclocks array 2022-12-13 19:50:01 +08:00
Kconfig
README.txt S32K1XXEVB boards: Fix RGB LED output and add comments 2021-09-21 07:22:06 -07:00

README.txt

README
======

This directory holds the port to the NXP S32K148EVB-Q176 development board.

Contents
========

  o Status
  o Serial Console
  o LEDs and Buttons
  o OpenSDA Notes
  o Configurations

Status
======

  2019-08-20:  NSH configuration created but entirely untested.

  2019-08-24:  NSH configuration verified running from FLASH.

  2019-10-19:  FLASH configuration options were added.

  2020-06-15:  Added FlexCAN driver with SocketCAN support to the S32K1XX
    arch.  This feature been tested extensively with the S32K148EVB.

  2020-06-16:  Added Emulated EEPROM driver and initialization.

  TODO:  Need to calibrate the delay loop.  The current value of
  CONFIG_BOARD_LOOPSPERMSEC is a bogus value retained from a copy-paste
  (see apps/examples/calib_udelay).

Serial Console
==============

  By default, the serial console will be provided on the OpenSDA VCOM port:

    OpenSDA UART TX  PTC7 (LPUART1_TX)
    OpenSDA UART RX  PTC6 (LPUART1_RX)

  USB drivers for the PEmicro CDC Serial Port are available here:
  http://www.pemicro.com/opensda/

LEDs and Buttons
================

  LEDs
  ----
  The S32K148EVB has one RGB LED:

    RedLED    PTE21  (FTM4 CH1)
    GreenLED  PTE22  (FTM4 CH2)
    BlueLED   PTE23  (FTM4 CH3)

  An output of '1' illuminates the LED.

  If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in
  any way.  The following definitions are used to access individual RGB
  components (see s32k148evb.h):

    GPIO_LED_R
    GPIO_LED_G
    GPIO_LED_B

  The RGB components could, alternatively, be controlled through PWM using
  the common RGB LED driver.

  If CONFIG_ARCH_LEDs is defined, then NuttX will control the LEDs on board
  the S32K148EVB.  The following definitions describe how NuttX controls the
  LEDs:

    ==========================================+========+========+=========
                                                 RED     GREEN     BLUE
    ==========================================+========+========+=========

    LED_STARTED      NuttX has been started      OFF      OFF      OFF
    LED_HEAPALLOCATE Heap has been allocated     OFF      OFF      ON
    LED_IRQSENABLED  Interrupts enabled          OFF      OFF      ON
    LED_STACKCREATED Idle stack created          OFF      ON       OFF
    LED_INIRQ        In an interrupt                   (no change)
    LED_SIGNAL       In a signal handler               (no change)
    LED_ASSERTION    An assertion failed               (no change)
    LED_PANIC        The system has crashed      FLASH    OFF      OFF
    LED_IDLE         S32K148 in sleep mode             (no change)
    ==========================================+========+========+=========

  Buttons
  -------
  The S32K148EVB supports two buttons:

    SW3  PTC12
    SW4  PTC13

OpenSDA Notes
=============

  - USB drivers for the PEmicro CDC Serial Port are available here:
    http://www.pemicro.com/opensda/

  - The drag'n'drog interface expects files in .srec format.

  - Using Segger J-Link:  Easy... but remember to use the 20-pin SWD
    connector J10 near the ethernet connector and not the 10-pin OpenSDA
    connector J20 closer to the OpenSDA USB connector J24.

Configurations
==============

  Common Information
  ------------------
  Each S32K148EVB configuration is maintained in a sub-directory and can be
  selected as follows:

    tools/configure.sh s32k148evb:<subdir>

  Where <subdir> is one of the sub-directories listed in the next paragraph.

    NOTES (common for all configurations):

    1. This configuration uses the mconf-based configuration tool.  To change
       this configuration using that tool, you should:

       a. Build and install the kconfig-mconf tool.  See nuttx/README.txt.
          Also see additional README.txt files in the NuttX tools repository.

       b. Execute 'make menuconfig' in nuttx/ in order to start the
          reconfiguration process.

    2. Unless otherwise stated, the serial console used is LPUART1 at
       115,200 8N1.  This corresponds to the OpenSDA VCOM port.

  Configuration Sub-directories
  -----------------------------

    nsh:
    ---
      Configures the NuttShell (nsh) located at apps/examples/nsh.  Support
      for builtin applications is enabled, but in the base configuration the
      only application selected is the "Hello, World!" example.