********************
Release Notes v2.0.0
********************

.. highlight:: console

.. note::

    Release v2.0.0 is an Alpha release based on Yocto Scarthgap and version v6.12 of the Linux Kernel.
    Functionality is currently limited. The latest feature complete release is :doc:`v1.7.0`.

Introduction
============

Astra™ is Synaptics' new compute platform designed for the IoT market. It features a series of high-performance,
AI-native, multi-modal SoCs optimized for consumer, enterprise, and industrial IoT workloads. These SoCs are
equipped with hardware accelerators for edge inferencing, security, graphics, vision, and audio, and offer
out-of-the-box functionality with Synaptics' connectivity solutions.

Astra (v2.0.0 Alpha) Release is a unified software development kit supporting the SL-Series of MPUs.

The high-level components included in this SDK are described below:

    * Upstream Linux Kernel and device tree.
    * Low-level Linux device drivers (U-BOOT) for peripheral devices.
    * Open source code for Multimedia pipelines.
    * Synaptics proprietary security approach.
    * Related SDK Documents

All of these items can be found through Synaptics’ and third parties open source Git repositories on GitHub.

Yocto SDK
---------

The Yocto Project is an open-source collaboration project that provides templates, tools and
methods for custom Linux-based systems for embedded and IoT products. By leveraging the power
of the open-source development community, Synaptics hopes to provide its customers with a wider
array of compatible software packages to build their products faster, with more features, while
at the same time having the stability and support of a large open-source development project.
Additionally, the SDK enables customers who already use a Yocto-based development environment
to migrate to Synaptics class-leading silicon solutions for improved performance and additional
functionality. The Yocto Project offers a vast number of software packages that provide many options.

Reference Board Supported Scope
-------------------------------

Below table lists the supported ASTRA reference board (Machina) and supported scope.

============================       =================================
SOC / Reference Board              Test Validation and Support Scope
============================       =================================
SL1680 Core board + IO board       GA
SL1640 Core board + IO board       GA
SL1620 Core board + IO board       GA
============================       =================================

License
-------

Using the Astra Software Developer Kit and BSP requires complying with the :doc:`../EULA`.

Synaptics TAs
-------------

The following Trusted Applications (TAs) are Synaptics TAs which run in the OP-TEE Trusted Execution Environment.
These TAs are open source and can be found at `<https://github.com/synaptics-astra/tee-optee_dev/tree/scarthgap_6.12_v2.0.0_alpha/ta>`__.

========    =========================
Package     Notes
========    =========================
Fastlogo    TA

            SL1680 / SL1640

DHUB        TA

            SL1680 / SL1640

Vmeta       TA

            SL1680 / SL1640 / SL1620

========    =========================

Where to get the SDK from GitHub
--------------------------------

Images and Toolchains
^^^^^^^^^^^^^^^^^^^^^

`<https://github.com/synaptics-astra/sdk/releases/>`__

SDK
^^^

`<https://github.com/synaptics-astra/sdk/tree/scarthgap_6.12_v2.0.0_alpha>`__

Documentation
^^^^^^^^^^^^^

:doc:`../quickstart/index`

:doc:`../hw/index`

:doc:`../yocto`

:doc:`../linux/index`

For other collaterals please refer to the `Synaptics Customer Portal <https://cp.synaptics.com/>`__.

New Features
============

Common New Features
-------------------

+-----------------------------+--------------------------+--------------------------------------------------------------------+
| Feature                     | SoC                      | Description                                                        |
+-----------------------------+--------------------------+--------------------------------------------------------------------+
| Yocto Scarthgap             | All                      | Base release on Yocto Scarthgap                                    |
+-----------------------------+--------------------------+--------------------------------------------------------------------+
| Linux v6.12                 | All                      | Upgrade to the Linux v6.12 Kernel                                  |
+-----------------------------+--------------------------+--------------------------------------------------------------------+
| U-Boot 2025.01              | All                      | Upgrade Synaptics U-Boot to be based on upstream 2025.01 release   |
+-----------------------------+--------------------------+--------------------------------------------------------------------+

SL1620 New Features
-------------------

*No SL1620 specific features were added in this release.*

SL1640 New Features
-------------------

*No SL1640 specific features were added in this release.*

SL1680 New Features
-------------------

*No SL1680 specific features were added in this release.*


SoC Core Feature Summary
========================

This section summarizes the hardware features of Astra Machina SoCs.

======================================    ==========================
Feature                                   SoC
======================================    ==========================
2D and 3D Graphics with GPU               SL1620, SL1640, and SL1680
DRM-KMS                                   SL1620, SL1640, and SL1680
Multi-standard Video Encoding/Decoding    SL1640 and SL1680
Cortex-M core boot                        SL1620, SL1640, and SL1680
HIFI4 DSP                                 SL1640
NPU                                       SL1640 and SL1680
Security for CPU, BOOT, and DRM engine    SL1620, SL1640, and SL1680
MIPI CSI & ISP                            SL1680
======================================    ==========================

Specific Modules and Features
=============================

+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| Feature Modules    | Feature Items                                       |  SL1620 | SL1640  | SL1680  | Comment                                                                        |
+====================+=====================================================+=========+=========+=========+================================================================================+
| GST Audio Pipeline | GST Audio Pipeline                                  |    Y    |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | BT A2DP Audio                                       |    Y    |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | PDM MIC Support                                     |    Y    |   N/A   |   N/A   |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | SW Decoding Capability                              |    Y    |    Y    |    Y    | - Supported formats: AAC, MP2, MP3, Vobis, AC3, OPUS                           |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | File Playback                                       |    Y    |    Y    |    Y    | - Supported formats: TS, MP3, MP4, Webm                                        |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | GST Sample Rate Conversion & Mixing                 |    Y    |    Y    |    Y    | - Limitation on SL1620 audio mixing.                                           |
|                    |                                                     |         |         |         |   Sample Rate conversion is fine.                                              |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | HDMI-RX (Audio)                                     |   N/A   |   N/A   |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| GST Video Pipeline | KMS SINK with IOMMU                                 |   N/A   |    Y    |    Y    | - MultiView: Camera + Video OR multi Video                                     |
|                    +-----------------------------------------------------+---------+---------+---------+ - Dual display means the output simultaneously                                 |
|                    | HDMI Rx Video Path to Display Sink                  |   N/A   |   N/A   |    Y    | - Dual display for SL1680 means HDMI-TX + MIPI-DSI                             |
|                    +-----------------------------------------------------+---------+---------+---------+ - Dual display for SL1620 means MIPI-DSI + RGB                                 |
|                    | RTSP stream with V4L2 playback                      |   N/A   |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+                                                                                |
|                    | Multiview RTSP Playback                             |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Support Wayland Sink Window Dragging with mouse     |    Y    |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Multi View                                          |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Video Decode with 2K Wayland Sink                   |    Y    |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | FFMPEG Decode                                       |    Y    |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | V4L2 Decode                                         |   N/A   |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Dual Display                                        |    Y    |   N/A   |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| HDMI-RX            | HDMI-RX 4K                                          |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | DHUB TA in OP-TEE                                   |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | HDIM-Rx Video 2K all formats support                |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | GST Pipeline Support                                |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | HDMI-Rx Driver for Video – 2K60                     |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | YUYV and NV12 formats as VIP output                 |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | EDID Support                                        |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | VIP Scalar                                          |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | RGB, YUV444/422/420 – 12/10/8 bit input             |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Gstreamer v4l2src pipeline to Display               |   N/A   |   N/A   |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| DRM-KMS            | Fastlogo with OP-TEE                                |    Y    |    Y    |    Y    | Supports both HDMI and MIPI                                                    |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | HDMI Hot Plug Detect and Dynamic Resolution Change  |   N/A   |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | EDID parsing                                        |   N/A   |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | MIPI, HDMI on Astra Machina boards                  |    Y    |    Y    |    Y    | - SL1620 /SL1640 supports either HDMI or MIPI output.                          |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         | - SL1680 supports HDMI and MIPI simultaneously.                                |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         |   Default is HDMI, can be changes to MIPI via DTS                              |
|                    |                                                     |         |         |         |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| Display            | Wayland Display Server                              |    Y    |    Y    |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| V4L2 ISP           | Single Sensor V4L2 ISP Driver                       |   N/A   |   N/A   |    Y    | - ISP feature is only for SL1680                                               |
|                    +-----------------------------------------------------+---------+---------+---------+                                                                                |
|                    | Support for 4K input and output                     |   N/A   |   N/A   |    Y    | - Known limitation of Downscaling of inputs: YUV420 SP 10bit and RGB 888       |
|                    +-----------------------------------------------------+---------+---------+---------+                                                                                |
|                    | Support for downscaling of the inputs               |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Support cropping in ISP down scaler                 |   N/A   |   N/A   |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Supports Bayer and RGB formats                      |   N/A   |   N/A   |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| U-Boot             | EMMC HS400 support                                  |    Y    |    Y    |    Y    |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | SL1620 1G DDR4 x 16 support                         |    Y    |   N/A   |   N/A   |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | DVFS Support                                        |    Y    |    Y    |    Y    | VCPU DVFS can be supported on SL1620/SL1640/SL1680                             |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         | VCORE DVFS is only supported on SL1640                                         |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | U-BOOT v2025.01                                     |    Y    |    Y    |    Y    |                                                                                |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         |                                                                                |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | General peripherals support                         |    Y    |    Y    |    Y    | - Supports USB2.0 devices                                                      |
|                    |                                                     |         |         |         | - Supports USB3.0 host                                                         |
|                    |                                                     |         |         |         | - Supports Ethernet                                                            |
|                    |                                                     |         |         |         | - Supports SPI Flash                                                           |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Boot mode:  from eMMC                               |    Y    |    Y    |    Y    | - Support eMMC HS400 mode                                                      |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Image Upgrade                                       |    Y    |    Y    |    Y    | - Supports eMMC image upgrade with USB U-Boot and SU-Boot                      |
|                    |                                                     |         |         |         |                                                                                |                                                                                |
|                    |                                                     |         |         |         | - USB U-Boot: image via TFTP and USB target                                    |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         |   (connected to PC)                                                            |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         | - SU-Boot: image via TFTP and USB Host                                         |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         |   (connected to USB Disk)                                                      |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         | - Supports sparse image slices (Yocto will generate                            |
|                    |                                                     |         |         |         |                                                                                |
|                    |                                                     |         |         |         |   sparse image automatically).                                                 |
|                    |                                                     |         |         |         |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| OP-TEE             | OP-TEE enabled                                      |    Y    |    Y    |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| WIFI               | WIFI 6 & WIFI 6E                                    |    Y    |    Y    |    Y    | wpa_supplicant 2.11                                                            |
|                    +-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
|                    | Host AP mode using hostapd                          |    Y    |    Y    |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+
| Bluetooth          | Supported                                           |    Y    |    Y    |    Y    |                                                                                |
+--------------------+-----------------------------------------------------+---------+---------+---------+--------------------------------------------------------------------------------+

General Modules, Peripherals, and Interfaces Supported
======================================================

+-------------------------------------------------------------------------------------------------------------+
| General                                                                                                     |
+================================+============================================================================+
| Kernel                         | Kernel Version 6.12.11                                                     |
+--------------------------------+----------------------------------------------------------------------------+
| Yocto                          | Scarthgap: 5.0.9                                                           |
+--------------------------------+----------------------------------------------------------------------------+
| U-Boot                         | SPI U-Boot version: v1.1.1                                                 |
|                                |                                                                            |
|                                | USB SU-Boot version: v1.7                                                  |
|                                |                                                                            |
|                                | *Synaptics U-Boot based on U-Boot 2025.01                                  |
|                                |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| USB Tool                       | astra-update: 1.0.2                                                        |
+--------------------------------+----------------------------------------------------------------------------+
| OP-TEE                         | OP-TEE version: 4.5.0                                                      |
+--------------------------------+----------------------------------------------------------------------------+
| Gstreamer (GST)                | GST version: 1.22.12                                                       |
+--------------------------------+----------------------------------------------------------------------------+
| ISP Firmware                   | version: 6.5.1                                                             |
+--------------------------------+----------------------------------------------------------------------------+

+-------------------------------------------------------------------------------------------------------------+
| Memory                                                                                                      |
+================================+========+==========+========================================================+
| Memory - DDR                   | SL1620 | DDR3     | 1GB 1866 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 2GB 1866 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 4GB 1866 Mbps                                          |
|                                |        +----------+--------------------------------------------------------+
|                                |        | DDR4     | 1GB 2133 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 2GB 2133 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 4GB 2133 Mbps                                          |
|                                |        +----------+--------------------------------------------------------+
|                                |        | DDR4x16  | 1GB 2133 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 2GB 2133 Mbps                                          |
|                                +--------+----------+--------------------------------------------------------+
|                                | SL1640 | DDR4     | 1GB 3200 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 2GB 2400 / 2666 / 3200 Mbps                            |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 4GB 3200 Mbps                                          |
|                                |        +----------+--------------------------------------------------------+
|                                |        | DDRx16   | 1GB 3200 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 2GB 3200 Mbps                                          |
|                                |        +----------+--------------------------------------------------------+
|                                |        | LPDDR4   | 2GB 3733 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 3GB 3733 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 4GB 3733 Mbps                                          |
|                                |        +----------+--------------------------------------------------------+
|                                |        | LPDDR4x  | 3733 Mbps                                              |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 3GB 3733 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 4GB 3733 Mbps                                          |
|                                +--------+----------+--------------------------------------------------------+
|                                | SL1680 | LPDDR4   | 2GB 3733 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 3GB 3733 Mbps                                          |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 4GB 3733 Mbps                                          |
|                                |        +----------+--------------------------------------------------------+
|                                |        | LPDDR4x  | 2GB 3200 / 3733 Mbps                                   |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 3GB 3200 / 3733 Mbps                                   |
|                                |        |          +--------------------------------------------------------+
|                                |        |          | 4GB 3733 Mbps                                          |
+--------------------------------+--------+----------+--------------------------------------------------------+
| Memory - eMMC                  | up to 32GB                                                                 |
+--------------------------------+----------------------------------------------------------------------------+

+-------------------------------------------------------------------------------------------------------------+
| General Peripherals                                                                                         |
+================================+============================================================================+
| Interrupt                      | GIC                                                                        |
+--------------------------------+----------------------------------------------------------------------------+
| Clock                          | Controls the system frequency and clock tree distribution                  |
+--------------------------------+----------------------------------------------------------------------------+
| Timer                          |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| GPIO                           | GPIO is initialized in earlier phase according to hardware design          |
+--------------------------------+----------------------------------------------------------------------------+
| SDMA                           | Conforms to the DMA engine framework                                       |
+--------------------------------+----------------------------------------------------------------------------+
| UART                           |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| USB 2.0 (OTG)                  |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| USB 3.0 (Host)                 |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| I2C                            |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| SPI                            |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+

+-------------------------------------------------------------------------------------------------------------+
| Network                                                                                                     |
+================================+============================================================================+
| Ethernet                       | SL1620: 10 / 100 / 1000 Mbps                                               |
|                                |                                                                            |
|                                | SL1640: 10 / 100 Mbps                                                      |
|                                |                                                                            |
|                                | SL1680: 10 /100 / 1000 Mbps                                                |
|                                |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| Wireless Connectivity          | Supports  WIFI & BT                                                        |
+--------------------------------+----------------------------------------------------------------------------+

+-------------------------------------------------------------------------------------------------------------+
| GPU and Display                                                                                             |
+================================+============================================================================+
| GPU                            | * DDK 24.2\@6643903                                                        |
|                                |                                                                            |
|                                | * OpenGL ES 3.2                                                            |
|                                |                                                                            |
|                                | * Mesa 24.0.7                                                              |
|                                |                                                                            |
|                                | * libdrm 2.4.120                                                           |
|                                |                                                                            |
|                                | * Weston 13.0.1                                                            |
|                                |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| Direct Rendering Manager (DRM) |                                                                            |
|                                |                                                                            |
| Display                        |                                                                            |
+--------------------------------+----------------------------------------------------------------------------+
| RGB Parallel Output            | Supported on SL1620                                                        |
+--------------------------------+----------------------------------------------------------------------------+
| HDMI-TX                        | Supported on SL1620/SL1640/SL1680                                          |
+--------------------------------+----------------------------------------------------------------------------+
| HDMI-RX                        | Supported on SL1680                                                        |
+--------------------------------+----------------------------------------------------------------------------+
| MIPI-DSI                       | SL1680/SL1640/SL1620. On SL1640 it needs to be enabled via DTS             |
+--------------------------------+----------------------------------------------------------------------------+

+-------------------------------------------------------------------------------------------------------------+
| Camera                                                                                                      |
+================================+============================================================================+
| MIPI-CSI                       | SL1680                                                                     |
+--------------------------------+----------------------------------------------------------------------------+
| ISP                            | SL1680                                                                     |
+--------------------------------+----------------------------------------------------------------------------+

+-------------------------------------------------------------------------------------------------------------+
| Audio Interfaces                                                                                            |
+================================+============================================================================+
| PDM                            | SL1620                                                                     |
+--------------------------------+----------------------------------------------------------------------------+
| SPDIF                          | None                                                                       |
+--------------------------------+----------------------------------------------------------------------------+
| I2S                            | SL1620, SL1640, SL1680                                                     |
+--------------------------------+----------------------------------------------------------------------------+

Supported Camera Modules
------------------------

+--------+------------------------------------------------------------------------------------------+-----------------+------------------------------------------------------+----------------------------------------------------+
| Sensor | Module                                                                                   | Resolution      | Interface (Device Tree Overlay if Required)          | Notes                                              |
+========+==========================================================================================+=================+======================================================+====================================================+
| IMX258 | Synaptics IMX258 Camera Module                                                           | 3840x2160 30fps | MIPI-CSI 0 w/ dolphin-csi0-with-expander.dtbo        | Synaptics SL1680 MIPI CSI Adaptor Board Required   |
|        |                                                                                          | (mode 0)        |                                                      |                                                    |
|        |                                                                                          |                 |                                                      |                                                    |
|        |                                                                                          | 1920x1080 30fps |                                                      |                                                    |
|        |                                                                                          | (mode 1)        |                                                      |                                                    |
|        |                                                                                          |                 |                                                      |                                                    |
+--------+------------------------------------------------------------------------------------------+-----------------+------------------------------------------------------+----------------------------------------------------+
| IMX415 | Synaptics IMX415 Camera Module                                                           | 3840x2160 30fps | MIPI-CSI 0 w/ dolphin-csi0-with-expander.dtbo        | Synaptics SL1680 MIPI CSI Adaptor Board Required   |
|        |                                                                                          | (mode 0)        |                                                      |                                                    |
|        |                                                                                          |                 |                                                      |                                                    |
|        |                                                                                          | 1920x1080 30fps |                                                      |                                                    |
|        |                                                                                          | (mode 1)        |                                                      |                                                    |
|        |                                                                                          |                 |                                                      |                                                    |
+--------+------------------------------------------------------------------------------------------+-----------------+------------------------------------------------------+----------------------------------------------------+
| OV5647 | `Arducam 5MP OV5647 Camera Module                                                        | 640x480 60fps   | MIPI-CSI0                                            | 1920x1080 30fps output is non-calibrated           |
|        | <https://www.arducam.com/product/arducam-ov5647-standard-raspberry-pi-camera-b0033/>`__  | (mode 0)        |                                                      |                                                    |
|        |                                                                                          |                 +------------------------------------------------------+                                                    |
|        |                                                                                          | 1920x1080 30fps | MIPI-CSI 1 w/ dolphin-csi1-without-expander.dtbo     |                                                    |
|        |                                                                                          | (mode 1)        |                                                      |                                                    |
+--------+------------------------------------------------------------------------------------------+-----------------+------------------------------------------------------+----------------------------------------------------+
| IMX477 | `Raspberry Pi High Quality Camera                                                        | 3840x2160 30fps | MIPI-CSI0                                            | Single Sensor Support Only                         |
|        | <https://www.raspberrypi.com/products/raspberry-pi-high-quality-camera/>`__              | (mode 0)        +------------------------------------------------------+                                                    |
|        |                                                                                          |                 |  MIPI-CSI 1 w/ dolphin-csi1-without-expander.dtbo    | 3840x2160 30fps output is non-calibrated           |
+--------+------------------------------------------------------------------------------------------+-----------------+------------------------------------------------------+----------------------------------------------------+

Known Issues and Limitations
============================

.. note::

    Versions of U-Boot included in the Astra SDK v0.9.0 release are not compatible with Astra SDK releases v1.0 or later.
    Please ensure that you are using `USB Tool v1.0 <https://github.com/synaptics-astra/usb-tool/releases/>`__ or later
    when flashing using USB. Or U-Boot `v1.0.0 <https://github.com/synaptics-astra/spi-u-boot/releases/>`__
    or later when updating with internal SPI flash. See :ref:`flash_internal_spi` for instructions on updating the
    internal SPI flash.

.. note::

    U-Boot version v1.1.0 improves emmc flash times significantly. We recommend updating to U-Boot v1.1.0 to benefit from these
    improvements.

.. note::

    SD Boot with release v1.3 and later requires updating to U-Boot `v1.1.1 <https://github.com/synaptics-astra/spi-u-boot/releases/>`__
    or later. See :ref:`flash_internal_spi` for instructions on updating the internal SPI flash.

.. note::

    In Astra v1.3, the default display output for the SL1620 is set to HDMI via a DSI-to-HDMI conversion. Starting with Astra v1.4,
    the onboard DSI-to-HDMI converter for the SL1620 Rev D core module has been enabled. For older core modules, an external
    DSI-to-HDMI adapter board is required. The default display output can be switched to MIPI by following the instructions provided
    in the User Guides. :doc:`../subject/haier_panel_configuration` and :doc:`../subject/waveshare_dsi-configuration`.

.. note::

    In Astra v1.4, the default MIPI display on SL1680 was changed to the Waveshare 7" Panel.

.. note::

    In Astra v1.4, ISP IOMMU only supports the NV12 format. When using RGB888 format, set the v4l2src parameters ``extra-controls="c,mmu_enable=0"``
    to disable IOMMU.

.. note::

    In Astra v1.5, the rootfs partition sizes increased to accommodate the extra packages in the OOBE images. This interferes with OTA since SWUpdate
    expects the rootfs partition size to be the same. To perform OTA on a system with v1.4 installed, please build an image using `v1.4's partition
    sizes <https://github.com/synaptics-astra/configs/blob/v1.4.0/product/sl1680_poky_aarch64_rdk/emmc.pt>`__. (See :doc:`../subject/emmc_layout_customization`)

.. note::

    Network Manager can be supported in Astra 1.7, but it's disabled by default as there are some stability issues found.
    If needed, Network Manager can be enabled. Please, contact the Synaptics Astra support team for more information.

.. note::

    SyNAP AI features are NOT currently available in the Astra Scarthgap v2.0.0 Alpha release. SyNAP will be included in a future release.

Known Issues
------------

+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
| SL1620  |  SL1640  |  SL1680  |  Module             |  ID    | Summary                                                                             |
+=========+==========+==========+=====================+========+=====================================================================================+
|    Y    |   N/A    |   N/A    | Gstreamer Pipeline  | 34977  | Gstreamer freezes at the beginning of video playback.                               |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|    Y    |   N/A    |   N/A    | Display             | 34979  | Inverted colors observed when playing secret_640x480.264 with live555MediaServer on |
|         |          |          |                     |        | TFT Panel.                                                                          |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|    Y    |   N/A    |   N/A    | Audio               | 34969  | Arecord reports "Sample format non available" when recording at 24 and 32 bit.      |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|    Y    |   N/A    |   N/A    | Display             | 34567  | Observed garbage output on the TFT Panel while in U-Boot.                           |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|    Y    |   N/A    |   N/A    | Display             | 34580  | Observed garbage output on TFT panel after reboot.                                  |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|    Y    |   N/A    |   N/A    | Networking          | 34587  | Hostapd is not available.                                                           |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |    Y     | Bluetooth           | 35007  | BT SCO behaves abnormally and fails to record voice by BT headphone.                |
|         |          |          |                     |        |                                                                                     |
|         |          |          |                     | 35009  |                                                                                     |
|         |          |          |                     |        |                                                                                     |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |    Y     | Display             | 35004  | Last frame retained after playback has stopped when using kmssink.                  |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |   N/A    | Display             | 35002  | Observe horizontal lines during playback when using kmssink.                        |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |    Y     | Display             | 35003  | Met a green flash at the beginning of playback when using kmssink.                  |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |    Y     | Gstreamer Pipeline  | 34997  | Debug message "[berlin_bm kernel driver] pt freed trying 0 times, addr              |
|         |          |          |                     |        | 0x0000000004a0d000" printed during playback.                                        |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|   Y     |    Y     |    Y     | Linux Kernel        | 34382  | Failure to automatically mount USB disk.                                            |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |    Y     | Suspend / Resume    | 34557  | Pressing key fails to wake system from Low Power Standby.                           |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|   Y     |    Y     |    Y     | Suspend / Resume    | 34564  | System hangs when entering Suspend to RAM.                                          |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |   N/A    | Display             | 34935  | System takes a long time to show Weston UI during boot.                             |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|   Y     |    Y     |    Y     | Fastlogo            | 34944  | No fastlogo output on HDMI / MIPI Panel.                                            |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |    Y     | Graphics            | 34947  | Observe "Error: Failed to restore original CRTC: -2" at the end of glmark2-es2-drm  |
|         |          |          |                     |        | test.                                                                               |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |    Y     | SD      Boot        | 34959  | get_sd.sh script reported "home.subimg has unsupported feature(s): FEATURE_C12"     |
|         |          |          |                     |        | when generating SD Card image.                                                      |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |    Y     |   N/A    | Display             | 34970  | No video when using Waveshare 7.1" panel (only backlight turns on).                 |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|   Y     |    Y     |    Y     | Video Player Demo   | 34971  | syna-video-player freezes on first frame when using FFMPEG playback.                |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | Display             | 34995  | No output displayed on Waveshare 7.1" panel after setting the DTBO for the panel.   |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | Display             | 35005  | Observed garbage on screen during playback when using playbin and kmssink.          |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | HDMI-RX             | 35024  | Console prints "[avio] avio_devices_dhub_isr:220: Spurious interrupt - 25/0/0"      |
|         |          |          |                     |        | during testing.                                                                     |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | Linux Kernel        | 34949  | Randomly observed hang while booting with the Waveshare 13" panel.                  |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | ISP                 | 34950  | Output shows green and noise artifacts when testing OV5647 sensor.                  |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | Display             | 34958  | Randomly observed "No Signal" when switching from 4K TV to 2K TV.                   |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | HDMI-RX             | 34962  | HDMI-RX gets darker after resolution change.                                        |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | ISP                 | 34963  | Output is a solid green screen when testing downscaling on ISP camera with NV12     |
|         |          |          |                     |        | input.                                                                              |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | HDMI-RX             | 34965  | Random hang occurs when switching resolution from resolution 4k60 RGB 8bit to       |
|         |          |          |                     |        | 1080P60 YUV444 10bit.                                                               |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | HDMI-RX             | 34967  | Randomly abnormal output will be displayed when switching from 1080P60 YUV444 10bit |
|         |          |          |                     |        | to 720P60 YUV444 8bit.                                                              |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | Video Player Demo   | 34973  | Fourth video is displayed on top of first video during mult-video playback.         |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | Gstreamer Pipeline  | 34975  | YUV 420 10bit format is not supported.                                              |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+
|  N/A    |   N/A    |    Y     | HDMI-RX             | 34980  | Random black scren and error "not programming full PHY" when switch resolution      |
|         |          |          |                     |        | from 4k60 RGB 8bit to 1080P60 RGB 8bit.                                             |
+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+