diff --git a/appnotes/astra-security.rst b/appnotes/astra-security.rst index 348d554..8f77d90 100644 --- a/appnotes/astra-security.rst +++ b/appnotes/astra-security.rst @@ -257,6 +257,8 @@ Generic Boot Flow Astra Generic Boot Flow +.. _ab_boot: + A/B Boot Flow (boot failover) ----------------------------- @@ -384,6 +386,8 @@ result, NAND boot can only be done on vendor HW device. Astra NAND Boot Flow +.. _sd_card_boot_flow: + SD Card Boot ------------ diff --git a/appnotes/decode_encode_capabilities.rst b/appnotes/decode_encode_capabilities.rst index 8879746..88a2243 100644 --- a/appnotes/decode_encode_capabilities.rst +++ b/appnotes/decode_encode_capabilities.rst @@ -5,36 +5,83 @@ Astra Machina Video Decode and Encode Capabilities Astra Machina Decode Capabilities ================================= -+-----------------+----------------------------------------------+----------------------------------------------+ -| Formats | H.264 Decoding | H.265 Decoding | -+=================+================+=================+===========+================+=================+===========+ -| | SL1680 | SL1640 | SL1620 | SL1680 | SL1640 | SL1620 | -| | | | | | | | -| | HW Accelerated | HW Accelerated | FFMPEG SW | HW Accelerated | HW Accelerated | FFMPEG SW | -| | | | | | | | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 3840x2160\@60 | Yes | Yes | No | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 4x1920x1080\@60 | Yes | Yes | No | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 3x1920x1080\@60 | Yes | Yes | No | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 2x1920x1080\@60 | Yes | Yes | No | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 4x1920x1080\@30 | Yes | Yes | No | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 1x1920x1080\@30 | Yes | Yes | Yes | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 1x1920x1080\@24 | Yes | Yes | Yes | Yes | Yes | Yes | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 9x1280x720\@25 | Yes | Yes | No | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 9x640x480\@25 | Yes | Yes | No | Yes | Yes | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 16x640x480\@25 | Yes | No | No | Yes | No | No | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ -| 2x1280x720\@30 | Yes | Yes | Yes | Yes | Yes | Yes | -+-----------------+----------------+-----------------+-----------+----------------+-----------------+-----------+ ++-----------------+---------------------------------------------------------------------------------------------------------------------+ +| Formats | H.264 Decoding | ++=================+================+=================+=================+================+===========+===========+=======================+ +| | SL1680 | SL1680 | SL1640 | SL1640 | SL1620 | SL2611 | SL2615 / SL2619 | +| | | | | | | | | +| | HW Accelerated | FFMPEG SW | HW Accelerated | FFMPEG SW | FFMPEG SW | FFMPEG SW | FFMPEG SW | +| | | | | | | | | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 3840x2160\@60 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 3840x2160\@30 | No | Yes | No | Yes | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 4x1920x1080\@60 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 3x1920x1080\@60 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 2x1920x1080\@60 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 4x1920x1080\@30 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@60 | No | Yes | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@30 | Yes | Yes | Yes | Yes | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@24 | Yes | No | Yes | Yes | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@15 | Yes | Yes | Yes | Yes | Yes | No | Yes | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 9x1280x720\@25 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 9x640x480\@25 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 16x640x480\@25 | Yes | No | No | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 2x1280x720\@30 | Yes | No | Yes | Yes | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1280x720\@30 | Yes | Yes | Yes | Yes | Yes | No | Yes | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ + ++-----------------+---------------------------------------------------------------------------------------------------------------------+ +| Formats | H.265 Decoding | ++=================+================+=================+=================+================+===========+===========+===========+===========+ +| | SL1680 | SL1680 | SL1640 | SL1640 | SL1620 | SL2611 | SL2615 / SL2619 | +| | | | | | | | | +| | HW Accelerated | FFMPEG SW | HW Accelerated | FFMPEG SW | FFMPEG SW | FFMPEG SW | FFMPEG SW | +| | | | | | | | | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 3840x2160\@60 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 3840x2160\@30 | No | No | No | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 4x1920x1080\@60 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 3x1920x1080\@60 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 2x1920x1080\@60 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 4x1920x1080\@30 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@60 | No | Yes | Yes | Yes | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@30 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@24 | Yes | No | Yes | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1920x1080\@15 | Yes | Yes | Yes | Yes | Yes | No | Yes | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 9x1280x720\@25 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 9x640x480\@25 | Yes | No | Yes | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 16x640x480\@25 | Yes | No | No | No | No | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 2x1280x720\@30 | Yes | No | Yes | No | Yes | No | No | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ +| 1x1280x720\@30 | Yes | Yes | Yes | Yes | Yes | No | Yes | ++-----------------+----------------+-----------------+-----------------+----------------+-----------+-----------+-----------------------+ .. note:: @@ -153,4 +200,4 @@ Usecase #4: .. note:: To verify performance for codec block, basic GStreamer pipelines were executed. Adding extra overhead of video mixer - or memory copy may impact the codec performance depending on usecase. \ No newline at end of file + or memory copy may impact the codec performance depending on use case. \ No newline at end of file diff --git a/conf.py b/conf.py index 6c79c9e..118505d 100644 --- a/conf.py +++ b/conf.py @@ -4,7 +4,7 @@ author = 'Synaptics' # version of the software being documented -release = 'scarthgap_6.12_v2.1.0' +release = 'scarthgap_6.12_v2.2.0' extensions = [ 'synaptics_sphinx_theme' ] diff --git a/linux/index.rst b/linux/index.rst index 7445e79..5832c6c 100644 --- a/linux/index.rst +++ b/linux/index.rst @@ -1244,12 +1244,17 @@ The Torq Demo supports using both the CPU or the NPU. .. _synap: -Machine Learning with SyNAP +Machine Learning with Astra =========================== -Astra Machina uses the SyNAP framework for execution of neural networks using the platform's hardware accelerators. -This framework allows users to run programs which take advantage of the Neural Processing Unit (NPU) -and Graphics Processing Unit (GPU) to accelerate the execution of neural networks. (see the `SyNAP documentation `__ for more details.) +With the introduction of the SL261x product line, Astra Machina now supports two machine learning frameworks depending on the product line. +The SyNAP framwork is supported on SL16x0 SoCs and the Torq framework is supported on SL261x SoCs with the Coral NPU. Both frameworks +allows users to run programs which take advantage of the Neural Processing Unit (NPU) and Graphics Processing Unit (GPU) to accelerate the +execution of neural networks. + +For details on using the SyNAP framework, see the `SyNAP documentation `__. + +For details on using the Torq framework, see the `Torq documentation __`. Connectivity ============ @@ -1258,20 +1263,59 @@ Bluetooth and Wi-Fi are supported on Astra Machina through on-board chip solutions and external hardware. The following table lists the various on-board chips and external solutions: -============ =============== ===================== ======================================================== -SL Processor Wireless Device Physical Interface Software Information - - (M.2 PCIe / M.2 SDIO) -============ =============== ===================== ======================================================== -SL1620 SYNA 43711 M.2 SDIO - wpa_supplicant v2.11 - - WIFI driver version: v101.10.478 -SL1640 SYNA 43752 M.2 PCIe - wpa_supplicant v2.11 - - WIFI driver version: v101.10.478 -SL1680 SYNA 43752 M.2 PCIe - wpa_supplicant v2.11 - - WIFI driver version: v101.10.478 -SL2610 SYNA 43711S M.2 SDIO - wpa_supplicant v2.11 - - WIFI driver version: v101.10.478 -============ =============== ===================== ======================================================== ++--------------+-----------------+-------------------------+--------------------------------------------------------+ +| SL Processor | Wireless Device | Physical Interface | Software Information | +| | | | | +| | | (M.2 PCIe / M.2 SDIO) | | ++==============+=================+=========================+========================================================+ +| SL1620 | SYNA 43711 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4612 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.591 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4381 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4384 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.591 | ++--------------+-----------------+-------------------------+--------------------------------------------------------+ +| SL1640 | SYNA 43752 | M.2 PCIe | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 43756 | M.2 PCIe | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4381 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4382 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4384 | M.2 PCIe | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.591 | ++--------------+-----------------+-------------------------+--------------------------------------------------------+ +| SL1680 | SYNA 43752 | M.2 PCIe | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 43756 | M.2 PCIe | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4381 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4382 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4384 | M.2 PCIe | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.591 | ++--------------+-----------------+-------------------------+--------------------------------------------------------+ +| SL2610 | SYNA 43711S | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.478 | +| +-----------------+-------------------------+--------------------------------------------------------+ +| | SYNA 4612 | M.2 SDIO | - wpa_supplicant v2.11 | +| | | | - WIFI driver version: v101.10.591 | ++--------------+-----------------+-------------------------+--------------------------------------------------------+ The Synaptics Astra Linux BSP contains all of the drivers and firmware required to use the 43xxx modules with both PCIe and SDIO interfaces. Wireless network management is handled by the WPA Supplicant daemon which key negotiation with a WPA Authenticator. It supports WEP, WPA, WPA2, and WPA3 @@ -1568,8 +1612,8 @@ Server side:: ``iperf`` server running on SL1620 with custom options -Using the Bluetooth A2DP source role ------------------------------------- +Using Bluetooth +--------------- Searching and connecting to the headset ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -1713,8 +1757,8 @@ We can now get the information about the device:: RSSI: -69 TxPower: 4 -Playing music to the headset -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Playing music to the Headset Using A2DP Source Role +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In order to test playback you need to upload a sound file (in ``.wav`` format) to the board for instance using ``scp``. @@ -1751,6 +1795,141 @@ headeset (in the example below ``0A:73:76:09:55:C0``) and the name of wave file boundary : 6755399441055744000 +Using Bluetooth SCO +^^^^^^^^^^^^^^^^^^^ + +SCO deliberately only supports 8KHz and S16_LE with 1 channel prioritizing low latency over the quality, +so need to configure the PCM accordingly as below. + +:: + + vi ~/.asoundrc + pcm.sco_playback { + type plug + slave { + pcm "hw:0,1" # Replace with your actual device + format S16_LE + rate 8000 + channels 1 + period_size 256 + buffer_size 1024 + } + } + pcm.sco_capture { + type plug + slave { + pcm "hw:0,4" # Replace with your actual device + format S16_LE + rate 8000 + channels 1 + period_size 512 + buffer_size 1024 + } + } + ctl.sco_capture { + type hw + card 0 + } + ctl.sco_playback { + type hw + card 0 + } + +Modify the alsa config for SCO: + +:: + + root@sl1680:~# diff /usr/share/alsa/alsa.conf /usr/share/alsa/alsa.conf + --- /usr/share/alsa/alsa_og.conf + +++ /usr/share/alsa/alsa.conf + @@ -118,9 +118,9 @@ + defaults.pcm.dmix.rate 48000 + defaults.pcm.dmix.format unchanged + defaults.pcm.dmix.card defaults.pcm.card + -defaults.pcm.dmix.device defaults.pcm.device + +defaults.pcm.dmix.device 1 + defaults.pcm.dsnoop.card defaults.pcm.card + -defaults.pcm.dsnoop.device defaults.pcm.device + +defaults.pcm.dsnoop.device 4 + defaults.pcm.front.card defaults.pcm.card + defaults.pcm.front.device defaults.pcm.device + defaults.pcm.rear.card defaults.pcm.card + +:: + + root@sl1680:~# diff /usr/share/alsa/pcm/default.conf /usr/share/alsa/pcm/default.conf + --- /usr/share/alsa/pcm/default.conf + +++ /usr/share/alsa/pcm/default.conf + @@ -40,7 +40,6 @@ + type hw + card $CARD + } + - hint.device 0 + } + } + hint { + +Ensure that the SCO profile is detected in BlueALSA: + +:: + + root@sl1620:~# bluealsa-aplay -l + **** List of PLAYBACK Bluetooth Devices **** + hci0: 90:7A:58:CA:AB:28 [WI-C200], trusted audio-headset + SCO (CVSD): S16_LE 1 channel 8000 Hz + A2DP (SBC): S16_LE 2 channels 48000 Hz + **** List of CAPTURE Bluetooth Devices **** + hci0: 90:7A:58:CA:AB:28 [WI-C200], trusted audio-headset + SCO (CVSD): S16_LE 1 channel 8000 Hz + + root@sl1620:~# bluealsa-aplay -L + bluealsa:SRV=org.bluealsa,DEV=90:7A:58:CA:AB:28,PROFILE=sco + WI-C200, trusted audio-headset, playback + SCO (CVSD): S16_LE 1 channel 8000 Hz + bluealsa:SRV=org.bluealsa,DEV=90:7A:58:CA:AB:28,PROFILE=sco + WI-C200, trusted audio-headset, capture + SCO (CVSD): S16_LE 1 channel 8000 Hz + bluealsa:SRV=org.bluealsa,DEV=90:7A:58:CA:AB:28,PROFILE=a2dp + WI-C200, trusted audio-headset, playback + A2DP (SBC): S16_LE 2 channels 48000 Hz + +Set the SCO Profile: + +:: + + hcitool -i hci0 cmd 0x01 0x03d \ + 0b 00 40 1f 00 00 40 1f 00 00 02 00 \ + 00 00 00 02 00 00 00 00 3c 00 3c 00 \ + 80 3e 00 00 80 3e 00 00 04 00 00 00 \ + 00 04 00 00 00 00 10 00 10 00 02 02 \ + 00 00 04 04 10 10 0a 00 80 03 01 + +Using ``aplay`` and ``arecord``: + +:: + + arecord -D "sco_capture" -f S16_LE /home/root/rec_bt_sco_audo.wav & + aplay -D "sco_playback" --dump-hw-params /home/root/rec_bt_sco_audo.wav & + +Using SCO with Chromium: + +:: + + export XDG_RUNTIME_DIR=/run/user/0 + export WAYLAND_DISPLAY=wayland-1 + + chromium --no-sandbox --alsa-output-device='sco_playback' --alsa-input-device='sco_capture' \ + --alsa-output-buffer-size=1024 --alsa-output-period-size=512 + +.. note:: + + In case of facing any failure in internet connection due to date and time advancing or mismatch in chromium, + please set it manually with below command:: + + timedatectl set-ntp false + timedatectl set-time "DATE TIME" + Example: timedatectl set-time "2025-01-15 15:00:00" + The Linux Boot Process ====================== @@ -1874,6 +2053,24 @@ found in the :doc:`/yocto`. .. _uboot: +A/B Booting +^^^^^^^^^^^ + +Astra supports A/B booting. A/B booting uses two two independent bootable slots. Only +one slot is active at a time. This supports fail-safe updates and fail-over recovery +if one slot becomes corrupted. Key paritions such as the bootloader, rootfs, and others +have a and b versions. See :ref:`example_parition_table`. + +The active slot is selected at boot based on metadata about slots is stored in the ``misc`` +partition. The ``misc`` partition is initialized when an image is flashed (eMMC) or by SU-Boot +on first boot (SPI). + +See :ref:`ab_boot` for more information on A/B Booting. + +.. note:: + + When ``misc`` is initialized to will default to Slot A. + U-Boot ------ @@ -1904,7 +2101,7 @@ SPI flash. The SPI flash may be located on the main board of Astra Machina or it may be a located on a SPI daughter card which is plugged into the device. Once SPI U-Boot is running on the board it can be used to write an image to the eMMC. -`Synaptics U-Boot Source Code `__ +`Synaptics U-Boot Source Code `__ .. note:: @@ -1931,7 +2128,8 @@ can be used to set variables, or flash the eMMC and internal SPI flash. .. note:: - Booting from SD cards is not supported on SL1620 + When booting from SPI to SD Card, the misc parition on the SD card is used instead of the partition on SPI. + See :ref:`sd_card_boot_flow` Generating Bootable SD Card Images ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -2014,6 +2212,8 @@ emmc_part_list describes the GUID Partition Table (GPT) which will be used for the eMMC. The emmc_image_list\* files specify which sub image files should be written to which partition on the eMMC. +.. _example_parition_table: + Example SL1640 Partition Table: ================== =================================================================== ================== =========================== @@ -2044,11 +2244,12 @@ home Mounted in /home, can be customized Updating Software Images using USB ---------------------------------- +Astra Machina supports updating software images using USB. + .. note:: - USB Boot is not supported with SL261x. Use :ref:`update_with_uboot` instead. - -Astra Machina supports updating software images using USB. + SL261x uses a different USB protocol then SL16x0. After completing the Hardware Setup section, + proceed to :ref:`usb_boot_sl261x`. .. _usb_boot_setup: @@ -2074,6 +2275,11 @@ system to the USB Type-C USB 2.0 port on Astra Machina (next to the ethernet por Installing the WinUSB Driver (Windows Only) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +.. note:: + + The driver is not required for SL261x devices. Please proceeed to :ref:`usb_boot_sl261x` + when using SL262x SoCs. + Windows requires a special USB kernel driver to communicate with Astra Machina over USB. Please download the driver from `GitHub `__. Linux and Mac hosts @@ -2109,6 +2315,11 @@ Driver for Synaptics Processors" when operating in USB Boot mode. Running Astra Update ^^^^^^^^^^^^^^^^^^^^ +.. note:: + + ``astra-update`` currently does not support SL261x boards. Please proceeed to :ref:`usb_boot_sl261x` + when using SL262x SoCs. + Astra Update can be downloaded from `GitHub `__. The tool is included in the same repository as the WinUSB driver. @@ -2203,6 +2414,46 @@ requires additional permissions to interface with USB devices and access system Astra Update no longer requires a USB-TTL board or cable to run commands at the U-Boot prompt. +.. _usb_boot_sl261x: + +USB Boot with SL261x +^^^^^^^^^^^^^^^^^^^^ + +The scarthgap_6.12_v2.2.0 release supports loading SU-Boot over the USB interface. Once SU-Boot is loaded +the emmc and SPI images can be updated using a USB drive (see :ref:`flashing_from_usb_drive`) or TFTP server +(see :ref:`flashing_from_tftp_server`). + +SL261x uses a USB-CDC interface to communicate with the host. This type of device has built-in drivers on all +supported OSes so no additional drivers need to be installed. The ``usb_boot_tool.py`` script is used to download +images from the host PC onto the device. The tool can be found in the ``SL261x`` branch of the +`usb-tool `__ repository. + +The ``usb-boot-tool.py`` requires Python 3.13 or later and the ``pyserial`` Python module. Once Python is installed +you can install the ``pyserial`` module using ``pip``:: + + pip install pyserial + +Run the following command to download SU-Boot and have it run on the board:: + + python usb_boot_tool.py --op run-acore --sm sysmgr.subimg --bl bl.subimg --tzk tzk.subimg + +Once the ``usb-boot-tool.py`` tool is running on the host system, Astra Machina will need to be placed into USB +Boot mode. To do this, press and hold the "USB_BOOT" button on the I/O board. Then press and release the +"RESET" button. Be sure to hold the "USB_BOOT" button long enough so that the board can reset and detect +that the "USB_BOOT" button is pressed. The tool will then detect that the device has entered into USB Boot mode and +begin sending images to the board. Once the images are sent you will see the U-Boot prompt on the serial console. + +.. figure:: media/sl261x-usb-boot-tool.png + + Output of ``usb-boot-tool.py`` after booting to SU-Boot. + +.. figure:: media/sl261x-usb-boot-tool-u-boot.png + + U-Boot prompt on the serial console after booting U-Boot using ``usb-boot-tool.py``. + +After booting U-Boot proceed to :ref:`update_with_uboot`. Additional instructions on using the ``usb-boot-tool.py`` +can be found in tool's `README file `__. + .. _update_with_uboot: Updating Images from U-Boot @@ -2286,6 +2537,8 @@ The parameter eMMCimg is the name of the image directory on the USB drive. then the USB drive needs to be connected to the USB Type-C USB 2.0 port (may require USB Type-C to USB Type-A adaptor). +.. _flashing_from_tftp_server: + Flashing Images from a TFTP Server ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -2330,6 +2583,16 @@ You can find the latest versions of the SPI images on `GitHub __` + for information on converting and running models with Torq. + To run a image classification neural network on a random image using an evaluation kit: 1. Install a pre-built image and connect to the board as described :doc:`here ` diff --git a/quickstart/ai_model.rst b/quickstart/ai_model.rst index f2c6ecc..f8f1d74 100644 --- a/quickstart/ai_model.rst +++ b/quickstart/ai_model.rst @@ -3,6 +3,11 @@ Converting and running a custom neural network .. highlight:: console +.. note:: + + SL261x uses the Torq framework instead of SyNAP. See the `Torq User Manual __` + for information on converting and running models with Torq. + .. note:: In addition to the :ref:`prerequisites for flashing ` you also need a host with @@ -51,12 +56,12 @@ To convert your own AI model and run it on an evaluation kit use the following s 7. Find the ip address of the board with the following command on the target:: - # ifconfig eth0 | grep "/inet addr/" + # ifconfig eth0 | grep "inet addr" inet addr:192.168.1.110 Bcast:192.168.1.255 Mask:255.255.255.0 8. Upload the converted model to the board by running the following command on the host:: - $ scp converted-model/model.synap root@192.168.1.110:/tmp + $ scp converted/model.synap root@192.168.1.110:/tmp 9. Connect to the board and issue the following command:: diff --git a/quickstart/oobe.rst b/quickstart/oobe.rst index 3ff234b..12a1dbd 100644 --- a/quickstart/oobe.rst +++ b/quickstart/oobe.rst @@ -166,8 +166,12 @@ environment. These demos are `Textures `__. + +.. note:: + + FastLogo and DHUB TAs were open sourced in release v1.7. + +Where to get the SDK from GitHub +-------------------------------- + +Images and Toolchains +^^^^^^^^^^^^^^^^^^^^^ + +``__ + +SDK +^^^ + +``__ + +Documentation +^^^^^^^^^^^^^ + +:doc:`../quickstart/index` + +:doc:`../hw/index` + +:doc:`../yocto` + +:doc:`../linux/index` + +`SL1620 Product Documentation `__ + +`SL1640 Product Documentation `__ + +`SL1680 Product Documentation `__ + +`SL261x Product Documentation `__ + +For other collaterals please refer to the `Synaptics Customer Portal `__. + +`Torq Compiler User Guide `__ + +New Features +============ + +Common New Features +------------------- + ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Feature | SoC | Description | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Upgrade ADB Version | All | Upgrade ADB version from the Android SDK. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Berlin PWM Support | All | Solve limitation in SYNA PWN driver. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ + +SL1620 New Features +------------------- + ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Feature | SoC | Description | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Support SYN4612 | SL1620 | Add support for the SYN4612 WiFi / BT chip. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| PMIC-based VPComp | SL1620, SL1640, SL1680 | Add support for PMIC-based Power Voltage Compensation. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| MIPI-DSI Power Clock Gating | SL1620 | Add support for Power Clock Gating with MIPI-DSI. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ + +SL1640 New Features +------------------- + ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Feature | SoC | Description | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Motion Vector Data | SL1640, SL1680 | Adds support for accessing Motion Vector data from the H.264 | +| | | encoder. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| PMIC-based VPComp | SL1620, SL1640, SL1680 | Add support for PMIC-based Power Voltage Compensation. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ + + + +SL1680 New Features +------------------- + ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Feature | SoC | Description | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Motion Vector Data | SL1640, SL1680 | Adds support for accessing Motion Vector data from the H.264 | +| | | encoder. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Face Recognition with RTSP | SL1680 | Support using RTSP with the Face Recognition demo. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| PMIC-based VPComp | SL1620, SL1640, SL1680 | Add support for PMIC-based Power Voltage Compensation. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ + +SL261x New Features +------------------- + ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Feature | SoC | Description | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| DMIC Recording | SL2611, SL2615, SL2619 | Add pinmux changed needed to record with the DMIC. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| SL2611 Gstreamer Support | SL2611 | Enable Gstreamer on SL2611 | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| I2S Support | SL2611 | Enable the I2S audio interface on SL2611. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| New Torq Version | SL2615, SL2619 | Update to new Torq version to sync with upstream AI repo. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Touchscreen for 7" display | SL2615, SL2619 | Enable touchscreen for Waveshare 7" display | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Bluetooth Settings | SL2615, SL2619 | Add Bluetooth Settings to OOBE images. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Display Settings | SL2615, SL2619 | Add Display Settings to OOBE images. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| QT Camera Application | SL2619 | Add QT Camera Application for testing ISP Cameras. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Support ISP Cropping | SL2619 | Support Cropping on SL2619 ISP. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Bluetooth SCO | SL2611, SL2615, SL2619 | Add support for Bluetooth SCO. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| WiFi Auto Channel Selection | SL2611, SL2615, SL2619 | Add support for WiFi AP mode with Auto Channel Selection. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Support SYN4612 | SL2611, SL2615, SL2619 | Add support for the SYN4612 WiFi / BT chip. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| TCPWM Peripherals | SL2611, SL2615, SL2619 | Add support for TCPWM peripherals. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| IPC Mailbox | SL2615, SL2619 | Support IPC Mailboxes with the M52. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| Support Suspend and Resume | SL2611, SL2615, SL2619 | Add support for suspend and resume. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| DDR3L Support | SL2611, SL2615, SL2619 | Support DDR3L on SL261x. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ +| USB Boot Support | SL2611, SL2615, SL2619 | Support loading and booting U-Boot using the USB interface. | ++-------------------------------+--------------------------+--------------------------------------------------------------------+ + +SoC Core Feature Summary +======================== + +This section summarizes the hardware features of Astra Machina SoCs. + +====================================== ========================================== +Feature SoC +====================================== ========================================== +2D and 3D Graphics with GPU SL1620, SL1640, SL1680, SL2615, and SL2619 +DRM-KMS SL1620, SL1640, SL1680, SL2615, and SL2619 +Multi-standard Video Encoding/Decoding SL1640, SL1680, SL2615, and SL2619 +Cortex-M core boot SL1620, SL1640, SL1680, SL2615, and SL2619 +HIFI4 DSP SL1640 +Security for CPU, BOOT, and DRM engine SL1620, SL1640, SL1680, SL2615, and SL2619 +MIPI CSI & ISP SL1680 and SL2619 +====================================== ========================================== + +Specific Modules and Features +============================= + ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| Feature Modules | Feature Items | SL1620 | SL1640 | SL1680 | SL2611 | SL2615 | SL2619 | Comment | ++====================+=====================================================+=========+=========+=========+=========+=========+=========+===============================================================================================+ +| GST Audio Pipeline | GST Audio Pipeline | Y | Y | Y | N/A | Y | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | BT A2DP Audio | Y | Y | Y | N/A | N/A | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | PDM MIC Support | Y | N/A | N/A | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | SW Decoding Capability | Y | Y | Y | N/A | Y | Y | - Supported formats: AAC, MP2, MP3, Vobis, AC3, OPUS | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | File Playback | Y | Y | Y | N/A | Y | Y | - Supported formats: TS, MP3, MP4, Webm | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | GST Sample Rate Conversion & Mixing | Y | Y | Y | N/A | Y | Y | - Limitation on SL1620 audio mixing. | +| | | | | | | | | Sample Rate conversion is fine. | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | HDMI-RX (Audio) | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Volume Control for USB audio devices | Y | Y | Y | N/A | N/A | Y | Supports volume control of USB audio devices using GPIOs | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| GST Video Pipeline | HDMI Rx Video Path to Display Sink | N/A | N/A | Y | N/A | N/A | N/A | - MultiView: Camera + Video OR multi Video | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+ - Dual display means the output simultaneously | +| | RTSP stream with V4L2 playback | N/A | Y | Y | N/A | Y | Y | - Dual display for SL1680 means HDMI-TX + MIPI-DSI | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+ - Dual display for SL1620 means MIPI-DSI + RGB | +| | Multiview RTSP Playback | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Support Wayland Sink Window Dragging with mouse | Y | Y | Y | N/A | Y | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Multi View | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Video Decode with 2K Wayland Sink | Y | Y | Y | N/A | Y | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | FFMPEG Decode | Y | Y | Y | N/A | Y | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | V4L2 Decode | N/A | Y | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Dual Display | Y | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Video Decode with QT Applications | Y | Y | Y | N/A | Y | Y | Multi-playback only on SL1680 | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| GST AI | OpenCV Support | Y | Y | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Multistream AI with RTSP | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | AI support for ISP Camera | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | GST AI Support for GPU models | Y | N/A | N/A | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Pose Estimation | Y | Y | Y | N/A | N/A | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Image Classification | Y | Y | Y | N/A | N/A | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Single View AI use case | Y | Y | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Multi View AI user case | N/A | N/A | Y | N/A | N/A | N/A | - SL1680 supports multi-view AI case | +| | | | | | | | | - SL1640/SL1620/SL261x only supports single view AI case | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Super Resolution AI use case | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Face Recognition use case | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | SR Slideshow | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | SyNAP | Y | Y | Y | N/A | N/A | N/A | - supports SyNAP pre-process and sink | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Torq | N/A | N/A | N/A | N/A | Y | Y | - NPU is optional on SL2615 | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| HDMI-RX | HDMI-RX 4K | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | DHUB TA in OP-TEE | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | HDIM-Rx Video 2K all formats support | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | GST Pipeline Support | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | HDMI-Rx Driver for Video – 2K60 | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | YUYV and NV12 formats as VIP output | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | EDID Support | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | VIP Scalar | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | RGB, YUV444/422/420 – 12/10/8 bit input | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Gstreamer v4l2src pipeline to Display | N/A | N/A | Y | N/A | N/A | N/A | | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| DRM-KMS | Fastlogo with OP-TEE | Y | Y | Y | N/A | N/A | N/A | Supports both HDMI and MIPI | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | HDMI Hot Plug Detect and Dynamic Resolution Change | N/A | Y | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | EDID parsing | N/A | Y | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | MIPI, HDMI on Astra Machina boards | Y | Y | Y | N/A | 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 | +| | | | | | | | | | +| | | | | | | | | - SL2611 has no display, SL2615 MIPI DSI is optional | +| | | | | | | | | | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| Display | Wayland Display Server | Y | Y | Y | N/A | Y | Y | | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| V4L2 ISP | Dual / Single Sensor V4L2 ISP Driver | N/A | N/A | Y | N/A | N/A | Y | - ISP feature is only for SL1680 | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+ | +| | Support for 4K input and output | N/A | N/A | Y | N/A | N/A | N/A | - Known limitation of Downscaling of inputs: YUV420 SP 10bit and RGB 888 | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+ | +| | Support for downscaling of the inputs | N/A | N/A | Y | N/A | N/A | N/A | - SL2619 ISP is single sensor only | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Support cropping in ISP down scaler | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Supports Bayer and RGB formats | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Support Simultaneous Path Playback w/ Single Sensor | N/A | N/A | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Direct Sensor(MCM) output for ISP bypass | N/A | N/A | Y | N/A | N/A | N/A | | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| U-Boot | EMMC HS400 support | Y | Y | Y | Y | Y | Y | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | SL1620 1G DDR4 x 16 support | Y | N/A | N/A | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | DVFS Support | Y | Y | Y | N/A | N/A | N/A | VCPU DVFS can be supported on SL1620/SL1640/SL1680 | +| | | | | | | | | | +| | | | | | | | | VCORE DVFS is only supported on SL1640 | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | U-BOOT | Y | Y | Y | Y | Y | Y | `Release Notes | +| | | | | | | | | `__ | +| | | | | | | | | | +| | | | | | | | | `Release Notes for SL261x | +| | | | | | | | | `__ | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | General peripherals support | Y | Y | Y | Y | Y | Y | - Supports USB2.0 devices | +| | | | | | | | | - Supports USB3.0 host | +| | | | | | | | | - Supports Ethernet (SL16x0 and SL2619 only) | +| | | | | | | | | - Supports SPI Flash | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Boot mode: from eMMC | Y | Y | Y | Y | Y | Y | - Support eMMC HS400 mode | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Boot mode: from SD-CARD | Y | Y | Y | N/A | N/A | N/A | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Image Upgrade | Y | Y | Y | Y | Y | Y | - Supports eMMC image upgrade with USB U-Boot, | +| | | | | | | | | | +| | | | | | | | | SPI U-Boot and SU-Boot | +| | | | | | | | | | +| | | | | | | | | - Supports SD card image upgrade with SPI U-Boot and | +| | | | | | | | | | +| | | | | | | | | SU-Boot | +| | | | | | | | | | +| | | | | | | | | - USB U-Boot: image via TFTP and USB target | +| | | | | | | | | | +| | | | | | | | | (connected to PC) (SL16x0 only) | +| | | | | | | | | | +| | | | | | | | | - SPI U-Boot: image via TFTP and USB Host | +| | | | | | | | | | +| | | | | | | | | (connected to USB Disk) | +| | | | | | | | | | +| | | | | | | | | - SU-Boot: image via TFTP and USB Host | +| | | | | | | | | | +| | | | | | | | | (connected to USB Disk) | +| | | | | | | | | | +| | | | | | | | | - Supports sparse image slices (Yocto will generate | +| | | | | | | | | | +| | | | | | | | | sparse image automatically). | +| | | | | | | | | | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Low Power Standby | N/A | Y | Y | N/A | N/A | N/A | | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| OP-TEE | OP-TEE enabled | Y | Y | Y | Y | Y | Y | | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| WIFI | WIFI 6 & WIFI 6E | Y | Y | Y | Y | Y | Y | wpa_supplicant 2.11 | +| +-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| | Host AP mode using hostapd | Y | Y | Y | Y | Y | Y | | ++--------------------+-----------------------------------------------------+---------+---------+---------+---------+---------+---------+-----------------------------------------------------------------------------------------------+ +| Bluetooth | Supported | Y | Y | Y | N/A | N/A | 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 (SL16x0 only) | +| | | +| | \*Synaptics U-Boot based on U-Boot 2025.01 | +| | | ++--------------------------------+----------------------------------------------------------------------------+ +| USB Tool | astra-update: 1.0.6 (SL16x0 only) | +| | | +| | usb_boot_tool.py: 2.2 (SL261x only) | +| | | ++--------------------------------+----------------------------------------------------------------------------+ +| 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 | +| +--------+----------+--------------------------------------------------------+ +| | SL261x | DDR3 | 2GB 1866 Mbps | +| | | +--------------------------------------------------------+ +| | | | 4GB 1866 Mbps | +| | +----------+--------------------------------------------------------+ +| | | DDR4 | 2GB 1600 / 3200 Mbps | +| | | +--------------------------------------------------------+ +| | | | 4GB 1600 / 3200 Mbps | +| | +----------+--------------------------------------------------------+ +| | | LPDDR4 | 2GB 3200 Mbps | +| | | +--------------------------------------------------------+ +| | | | 4GB 3200 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) | SL16x0 Only | ++--------------------------------+----------------------------------------------------------------------------+ +| USB 3.0 (Host) | | ++--------------------------------+----------------------------------------------------------------------------+ +| I2C | | ++--------------------------------+----------------------------------------------------------------------------+ +| SPI | | ++--------------------------------+----------------------------------------------------------------------------+ + ++-------------------------------------------------------------------------------------------------------------+ +| Network | ++================================+============================================================================+ +| Ethernet | SL1620: 10 / 100 / 1000 Mbps | +| | | +| | SL1640: 10 / 100 Mbps | +| | | +| | SL1680: 10 /100 / 1000 Mbps | +| | | +| | SL261x: 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/SL2615/SL2619 | ++--------------------------------+----------------------------------------------------------------------------+ +| HDMI-RX | Supported on SL1680 | ++--------------------------------+----------------------------------------------------------------------------+ +| MIPI-DSI | SL1680/SL1640/SL1620. On SL1640 it needs to be enabled via DTS | ++--------------------------------+----------------------------------------------------------------------------+ + ++-------------------------------------------------------------------------------------------------------------+ +| Camera | ++================================+============================================================================+ +| MIPI-CSI | SL1680 and SL2619 | ++--------------------------------+----------------------------------------------------------------------------+ +| ISP | SL1680 and SL2619 (mini ISP) | ++--------------------------------+----------------------------------------------------------------------------+ + ++-------------------------------------------------------------------------------------------------------------+ +| Audio Interfaces | ++================================+============================================================================+ +| PDM | SL1620 and SL261x | ++--------------------------------+----------------------------------------------------------------------------+ +| SPDIF | None | ++--------------------------------+----------------------------------------------------------------------------+ +| I2S | SL1620, SL1640, SL1680, SL261x | ++--------------------------------+----------------------------------------------------------------------------+ + +Supported Camera Modules for SL1680 +----------------------------------- + ++--------+------------------------------------------------------------------------------------------+-----------------+----------------------------------------------------------+----------------------------------------------------+ +| 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) | | | +| | | | Dewarp w/ dolphin-csi0-with-expander-dewarp-imx258.dtb | | +| | | 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) | | | +| | | | Dewarp w/ dolphin-csi0-with-expander-dewarp-imx415.dtbo | | +| | | 1920x1080 30fps | | | +| | | (mode 1) | | | +| | | | | | +| +------------------------------------------------------------------------------------------+-----------------+----------------------------------------------------------+----------------------------------------------------+ +| | `Waveshare IMX415 Camera Module | 3840x2160 30fps | MIPI-CSI 0 | Requires updating I2C address in the sensor driver.| +| | `__ | (mode 0) | | | +| | | | | | +| | | 1920x1080 30fps | | | +| | | (mode 1) | | | +| | | | | | ++--------+------------------------------------------------------------------------------------------+-----------------+----------------------------------------------------------+----------------------------------------------------+ +| OV5647 | `Arducam 5MP OV5647 Camera Module | 640x480 60fps | MIPI-CSI0 | | +| | `__ | (mode 0) | | | +| | | +----------------------------------------------------------+ | +| | | 1920x1080 30fps | MIPI-CSI 1 w/ dolphin-csi1-without-expander.dtbo | | +| | | (mode 1) +----------------------------------------------------------+ | +| | | | Dual CSI0/1 w/ dolphin-bothcsi-without-expander.dtbo | | ++--------+------------------------------------------------------------------------------------------+-----------------+----------------------------------------------------------+----------------------------------------------------+ +| IMX477 | `Raspberry Pi High Quality Camera | 3840x2160 30fps | MIPI-CSI0 | Single Sensor Support Only | +| | `__ | (mode 0) +----------------------------------------------------------+ | +| | | | MIPI-CSI 1 w/ dolphin-csi1-without-expander.dtbo | 3840x2160 30fps output is non-calibrated | ++--------+------------------------------------------------------------------------------------------+-----------------+----------------------------------------------------------+----------------------------------------------------+ + +Supported Camera Modules for SL2619 +----------------------------------- + ++--------+------------------------------------------------------------------------------------------+-----------------+------------------------------------------------------+----------------------------------------------------+ +| Sensor | Module | Resolution | Interface (Device Tree Overlay if Required) | Notes | ++========+==========================================================================================+=================+======================================================+====================================================+ +| OV5647 | `Arducam 5MP OV5647 Camera Module | 640x480 60fps | MIPI-CSI0 | | +| | `__ | | | | +| | | | | | +| | | 1920x1080 30fps | | | +| | | | | | +| | | 1296x972 30fps | | | +| | | | | | ++--------+------------------------------------------------------------------------------------------+-----------------+------------------------------------------------------+----------------------------------------------------+ + +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 `__ or later + when flashing using USB. Or U-Boot `v1.0.0 `__ + 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 `__ + 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 `__. (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. + +Known Issues +------------ + ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| SL1620 | SL1640 | SL1680 | SL2611 | SL2615 | SL2619 | Module | ID | Summary | ++=========+==========+==========+=========+==========+==========+=====================+========+=====================================================================================+ +| Y | N/A | N/A | N/A | N/A | N/A | Power Management | 35192 | HDMI display shows garbage when doing Suspend / Resume. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| Y | N/A | N/A | N/A | N/A | N/A | Audio | 35219 | Audio is recorded at 0.75x speed when using arecord to record DMIC input at 44KHz. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| Y | N/A | N/A | N/A | N/A | N/A | BT and WiFi | 35662 | No WiFi of Bluetooth observed in Settings. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| Y | Y | N/A | N/A | N/A | N/A | OOBE | 35789 | Chromium behaves abnormally after minimizing. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| Y | N/A | N/A | N/A | N/A | N/A | OOBE | 35820 | Chromium window reopens in the wrong position after maximizing then closing. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| Y | N/A | N/A | N/A | N/A | N/A | OOBE | 35994 | GFX Demo app UI goes to background when opening. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| Y | N/A | N/A | N/A | N/A | N/A | Bluetooth | 36026 | Observed noise when playing sound with BT Headphones with BT SCO. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | Y | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35944 | Video does not play smoothly when running the multi display "glvideomixerelement" | +| | | | | | | | | testcase. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | Y | Y | N/A | N/A | N/A | Gstreamer Pipeline | 36755 | Video freezes for two seconds when using NNStreamer with a USB camera. | +| | | | | | | | | | +| | | | | | | (NNStreamer) | | | +| | | | | | | | | | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 34950 | Output shows green and noise artifacts when testing OV5647 sensor. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Display | 35003 | Observed a green flash at the beginning when using KMS Sink to display some streams.| ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | Y | Y | N/A | N/A | N/A | Display | 35004 | Last frame retained after playback stops when using KMS sink. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | Y | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35005 | Randomly observed screen garbage when using playbin / raw commands to decode some | +| | | | | | | | | streams. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| Y | Y | Y | N/A | N/A | N/A | Linux Kernel | 35126 | Framebuffer Console is unresponsive. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35147 | Observed video garbage during the first few seconds (about 5s) when testing | +| | | | | | | | | | +| | | | | | | | | 640x360@30_H.264 IP camera v4l2 decoding. | +| | | | | | | | | | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35288 | Video shakes when playing 4 videos using Syna Video Player with V4L2 decoding. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35488 | Observed video stutter when test Multi-Ai 4x1080p30. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Display | 35493 | Dual display with KMS sink with one display and Weston UI on another does not work. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | HDMI-RX | 35497 | Video output shows garbage when using KMS sink to display HDMI-RX testcases. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | HDMI-RX | 35502 | Channel mapping is wrong when testing audio with QD980 4K30 RGB at 1080p30Hz | +| | | | | | | | | | +| | | | | | | | | with NV12 & 48k, S32_LE,8 channel using alsasink. | +| | | | | | | | | | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35742 | Randomly, stream playback will fail when testing AudioMixer with Sample Rates of | +| | | | | | | | | | +| | | | | | | | | 48.0 kHz and 44.1 kHz using a USB speaker. | +| | | | | | | | | | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 35770 | Garbage flashes on screen at the begining of test using IMX415 with MAIN and SP2 | +| | | | | | | | | paths. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 35792 | Display shows excessive green when testing OV5647 sensor with 1080P output. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 35797 | Display shows excessive blue when testing IMX477 with CSI-0 and CSI-1 port. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 35815 | Display shows excessive purple when testing IMX477 in dark environments. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 35927 | Kernel panic observed when testing multi-path stream tests with IMX477 camera. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Syna AI Player | 35953 | Video stutter observed when doing multi-stream AI detection with RTSP cameras. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35959 | Video randomly shows garbage when using glvideomixerelement / synacompositor to do | +| | | | | | | | | multiple stream decode. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | HDMI-RX | 35965 | Met error print during HDMI-RX audio playback. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | Y | Y | N/A | N/A | N/A | WiFi | 35986 | Destination unreachable when pinging www.google.com on IPV6 network. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Gstreamer Pipeline | 35988 | Video is not smooth when testinng Super Resolution with a USB camera an the | +| | | | | | | | | | +| | | | | | | | | sr_qdeo_y_uv_640x360_1920x1080 model. | +| | | | | | | | | | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | HDMI-RX | 36155 | Observed 15 - 30 second delay when starting and switching resolutions when testing | +| | | | | | | | | HDMI-RX. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 36164 | Observed a purple screen when testing OV5647 in low-light environments. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Display | 36372 | Black screen persists for 7 seconds between fastlogo and Weston UI. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | HDMI-RX | 36401 | System reboots when waking from suspend when HDMI-RX cable is connected. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Gstreamer Pipeline | 36657 | Video output is not smooth when testing three windows with downscaling and color | +| | | | | | | | | conversion. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 36804 | Observed green flash on SP1/SP2 paths when testing playback and dumping with ISP. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | OOBE | 36812 | Video stutter when testing Super Resolution with 720p input from USB camera. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 36977 | Green flash and garbage observed when testing dusl sensor multi-path output with | +| | | | | | | | | the OV5647 sensor. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | ISP | 36978 | Observed freeze when testing dual sensor multi-path output with the OV5647 sensor. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | Y | Y | N/A | N/A | N/A | Display | 37034 | glmark2-es2-drm score decreased since previous versions. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | Y | Y | N/A | N/A | N/A | Audio | 37058 | No audio outpute to USB speaker when playing Youtube in Chromium. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | Y | N/A | N/A | N/A | Power Management | 37076 | Gstreamer AI pipeline fails after resuming from suspend. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | Y | Y | N/A | OTA | 37113 | OTA with SWUpdate fails from U-Boot and the Web UI. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | Y | Y | Y | Linux Kernel | 36069 |Failed to mount USB disc from USB2.0 port ( Type-C port). | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | Y | N/A | Y | Bluetooth | 37013 | Audio is noisy while recording audio with Bluetooth SCO. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | Display | 37112 | There is no output from MIPI panel after seting the Panel in the Display Section. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | N/A | Gstreamer Pipeline | 37105 | Observed video stutter issue while doing Object Detection with NNStreamer using GPU.| ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | Power Management | 37122 | HDMI shows no-signal after waking up from suspend. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | N/A | Y | OOBE | 36699 | Symbol lookup error when testinf WebRTC with QTBrowser and Chromium. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | Gstreamer Pipeline | 36710 | Observed video stutter while doing Object Detection with Yolo-V8. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | Audio | 36971 | Recorded audio played back at 0.75x speed after recording from DMIC at 44.1KHz. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | Power Management | 37123 | Errors observed when suspending for a second time. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | Display | 36091 | No fastlogo displayed on HDMI during boot. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | N/A | Y | Power Management | 36104 | System fails to wakeup after going into low power mode. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | N/A | Y | Display | 36137 | System reports the error "Error: Failed to restore original CRTC: -2" when running | +| | | | | | | | | | +| | | | | | | | | glmark2-es2-drm test. | +| | | | | | | | | | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | OOBE | 36763 | Available WiFi Network window does not differentiate secure / non-secure networks. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | OOBE | 37048 | The ifconfig command still displays the IP address after turning on WiFi in the UI. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ +| N/A | N/A | N/A | N/A | Y | Y | OOBE | 37057 | No audio after connecting to a Bluetooth device. | ++---------+----------+----------+---------+----------+----------+---------------------+--------+-------------------------------------------------------------------------------------+ diff --git a/subject/encoder_motion_vector.rst b/subject/encoder_motion_vector.rst new file mode 100644 index 0000000..94e2b32 --- /dev/null +++ b/subject/encoder_motion_vector.rst @@ -0,0 +1,67 @@ +==================================== +Motion Vector with the H.264 Encoder +==================================== + +Astra SDK scarthgap_6.12_v2.2.0 adds support for accessing motion vectors from the H.264 encoder used +by SL1640 and SL1680. + +The ``vpu`` driver adds a new control ``SYNA_V4L2_CID_VENC_ENABLE_METADATA_MV`` which can be set to enable motion +vector data. https://github.com/synaptics-astra/linux_6_12-drivers-synaptics/commit/fd6bca6bf70637aa267d2d36159f05ecfa97a979 + +This example sets the V4L2 Control ID and Value:: + + ctrl.id = SYNA_V4L2_CID_VENC_ENABLE_METADATA_MV; + ctrl.value = true; + dbg("setting (%d): %u", id, ctrl.value); + ret = ::ioctl(mFd, VIDIOC_S_CTRL, &ctrl); + +Motion Vector Data can be accessed from the capture buffer:: + + v4l2_buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE; + ret = ::ioctrl(mFd, VIDIOC_DQBUF, &v4l2_buf); + v4l2_buf plane[0]: encoded ES data + v4l2_buf plane[1]: motion vector data + +This example prints the Motion Vector data to a file:: + + int write_motion_vector(void *mv, /* plane[1] address */ + size_t size, /* plane[1]payload */ + uint32_t frameIdx, /* v4l2_buf sequence */ + uint32_t width, uint32_t height) + { + uint32_t i; + uint32_t mbPerRow = (width + 15) / 16; + uint32_t mbPerCol = (height + 15) / 16; + uint32_t mbPerFrame = mbPerRow * mbPerCol; + MVInfo_t *mbInfo = (MVInfo_t *)mv; + if (!mFp || !mv) + return 0; + /* Print motion vector for every macroblock. */ + fprintf(mFp, "\npic=%d MV full-pixel X,Y " + "for %d macroblocks (%dx%d) block=0\n", + frameIdx, mbPerFrame, mbPerRow, mbPerCol); + for (i = 0; i < mbPerFrame; i++) { + uint32_t mb_type = mbInfo[i].mbType; + uint32_t mb_y = i / mbPerRow; + uint32_t mb_x = i % mbPerRow; + uint32_t sx = mb_x * 16; + uint32_t sy = mb_y * 16; + fprintf(mFp, " MBxy:(%3d,%3d) Type:%8s ", sx, sy, mbModetostr(mb_type)); + if (mb_type == 6) { // P16x16 + fprintf(mFp, "MV(%3d,%3d )[%21s]", mbInfo[i].mvX[0], mbInfo[i].mvY[0], " "); + } else if (mb_type == 7 || mb_type == 8) { // P16x8, P8x16 + fprintf(mFp, "MV(%3d,%3d ", mbInfo[i].mvX[0], mbInfo[i].mvY[0]); + fprintf(mFp, "%3d,%3d) [%13s]", mbInfo[i].mvX[1], mbInfo[i].mvY[1], " "); + } else if (mb_type == 9) { // P8x8 + fprintf(mFp, "MV(%3d,%3d ", mbInfo[i].mvX[0], mbInfo[i].mvY[0]); + fprintf(mFp, "%3d,%3d ", mbInfo[i].mvX[1], mbInfo[i].mvY[1]); + fprintf(mFp, "%3d,%3d ", mbInfo[i].mvX[2], mbInfo[i].mvY[2]); + fprintf(mFp, "%3d,%3d)", mbInfo[i].mvX[3], mbInfo[i].mvY[3]); + } else { + fprintf(mFp, "MV[%31s]", " "); + } + if ((i % mbPerRow) == mbPerRow-1) fprintf(mFp, "\n"); + } + fflush(mFp); + return 0; + } \ No newline at end of file diff --git a/subject/haier_panel_configuration.rst b/subject/haier_panel_configuration.rst index e07ae20..31b745b 100644 --- a/subject/haier_panel_configuration.rst +++ b/subject/haier_panel_configuration.rst @@ -40,7 +40,7 @@ The Haier panel can be enabled by setting the ``dtbo`` variable, in U-Boot, to t +-----------------+--------------------------------+-----------------------------------+----------------------------------+----------------------------------+ | | SL1620 | SL1640 | SL1680 | SL2619 | +=================+================================+===================================+==================================+==================================+ -| DTS Overlay | myna2-haier-panel-overlay.dtbo | platypus-haier-panel-overlay.dtbo | dolphin-haier-panel-overlay.dtbo | sl2619-haier-panel-overlay.dtbo | +| DTS Overlay | myna2-haier-panel-overlay.dtbo | platypus-haier-panel-overlay.dtbo | dolphin-haier-panel-overlay.dtbo | sl261x-haier-panel-overlay.dtbo | +-----------------+--------------------------------+-----------------------------------+----------------------------------+----------------------------------+ See :ref:`devicetree_overlays` for details on how to enable the devicetree overlays. \ No newline at end of file diff --git a/subject/index.rst b/subject/index.rst index 230540e..72609cb 100644 --- a/subject/index.rst +++ b/subject/index.rst @@ -30,6 +30,8 @@ Subject Specific User Guides setting_hdmi_resolution usb_boot_user_guide rescue_mode_user_guide + pmic_based_pvcomp + encoder_motion_vector The following guides provide additional details on a specific subject or module. @@ -84,4 +86,8 @@ The following guides provide additional details on a specific subject or module. - :doc:`usb_boot_user_guide` -- :doc:`rescue_mode_user_guide` \ No newline at end of file +- :doc:`rescue_mode_user_guide` + +- :doc:`pmic_based_pvcomp` + +- :doc:`encoder_motion_vector` \ No newline at end of file diff --git a/subject/media/sl1680-voltage-measurement-points.png b/subject/media/sl1680-voltage-measurement-points.png new file mode 100644 index 0000000..97e708e Binary files /dev/null and b/subject/media/sl1680-voltage-measurement-points.png differ diff --git a/subject/memory_layout_customization.rst b/subject/memory_layout_customization.rst index 53aae5b..ef04873 100644 --- a/subject/memory_layout_customization.rst +++ b/subject/memory_layout_customization.rst @@ -21,6 +21,7 @@ Chip Default Memory Supported Memory SL1620 2GB 1GB / 2GB / 4GB SL1640 2GB 2GB / 3GB / 4GB SL1680 4GB 2GB / 4GB +SL261x 2GB 2GB / 4GB ======== ============== ================ Below are the memory layouts for all available DDR sizes. @@ -110,6 +111,29 @@ SL1680 Memory Layout | | Secure | 16MB | +-------------------+------------------------+----------------------------+ +SL261x Memory Layout +^^^^^^^^^^^^^^^^^^^^ + ++-------------------+------------------------+----------------------------+ +| Memory Size | Memory Section | Size | ++-------------------+------------------------+----------------------------+ +| 2 GB DDR | NonSecure (CMA) | 260MB | +| +------------------------+----------------------------+ +| | System | 1.948GB | +| +------------------------+----------------------------+ +| | NonSecure (Non-cached) | 8MB | +| +------------------------+----------------------------+ +| | Secure | 16MB | ++-------------------+------------------------+----------------------------+ +| 4 GB DDR | NonSecure (CMA) | 500MB | +| +------------------------+----------------------------+ +| | System | 3.482GB | +| +------------------------+----------------------------+ +| | NonSecure (Non-cached) | 8MB | +| +------------------------+----------------------------+ +| | Secure | 16MB | ++-------------------+------------------------+----------------------------+ + .. note:: NonSecure (CMA) memory sections can be used as system memory when CMA is not needed. System @@ -167,11 +191,13 @@ For SL1640 ``sl1640_poky_aarch64_rdk/sl1640_poky_aarch64_rdk_defconfig`` and SL1 .. figure:: media/sl1680-preboot-ddr-type.png -`Supported DDR types for SL1620 `__ +`Supported DDR types for SL1620 `__ + +`Supported DDR types for SL1640 `__ -`Supported DDR types for SL1640 `__ +`Supported DDR types for SL1680 `__ -`Supported DDR types for SL1680 `__ +`Supported DDR types for SL261x `__ Finally, build an image with the modified memory layout:: diff --git a/subject/pmic_based_pvcomp.rst b/subject/pmic_based_pvcomp.rst new file mode 100644 index 0000000..c9822f5 --- /dev/null +++ b/subject/pmic_based_pvcomp.rst @@ -0,0 +1,96 @@ +=========================== +Configuring PMIC for PVComp +=========================== + +Astra SDK scarthgap_6.12_v2.2 adds support for configuring Power-Voltage Compensation (PVComp) based on the PMIC +and Leakage ID. PVComp will adjust the voltages on VCORE and VCPU accordingly. PVComp is implemented in the miniloader +for all PMICs supported by our QVL list. The PMIC must be set in the Astra SDK config when building custom boards. This +guide covers configuring the PMIC and validating the PVComp functionality. + + +.. note:: + + PVComp based on PMIC is supported on SL16x0 platforms. + +Validating PVComp from Serial Console Logs +========================================== + +The Astra Machina RDK board will print the following when the configured PMIC is detected. + +:: + + Miniloader: tz loader! boot_type(0) + PMIC: Try... + PMIC: VCORE tps6287x (ID: 0x0a), VCPU tps6287x (ID: 0x0a) I2C PMIC detected + set Vcpu from 800000uv to 815000uv + set Vcore from 800000uv to 825000uv + +Then set VCORE and VCPU based on the Leakage ID. + +:: + + RKEK_ID (byte[0:7]) = 0000000000000000 + ULT (byte[0:7]) = 4316ebb236e191b5 + Leakage ID = 1609 + SOCTSEN ID = 105 + +If the configured PMIC is not detected then the output will look like: + +:: + + PMIC: Try... + PMIC: Invalid magic number 0x00000000, expected 0x504d4943 + PMIC: unknown PMIC model + PMIC: Try again... + +Configuring PMIC in Astra SDK configuration +=========================================== + +The PMIC is configured in the Astra SDK configution file for the board. Set ``CONFIG_PMIC_MODE_I2C`` to ``y`` and +set ``CONFIG_VCORE_PMIC_MODEL`` and ``CONFIG_VCPU_PMIC_MODEL`` to the name of the PMIC from the QVL being used. + +:: + + # + # Preboot Configuration + # + # CONFIG_PREBOOT_MEMORY_MULTIPLE is not set + CONFIG_PMIC_MODE_I2C=y + # CONFIG_PMIC_MODE_PWM is not set + CONFIG_VCORE_PMIC_MODEL="tps6287x" + CONFIG_VCPU_PMIC_MODEL="tps6287x" + # end of Preboot Configuration + +.. note:: + + Valid PMIC models are ``m88pg86x``, ``sy8824b``, ``ncp6335d``, ``mp886x``, ``sy8827n``, + ``hl7593wl06``, ``tps62868``, ``rt5739``, ``fp6359`` and ``tps6287x``. + +Validating Functionality +======================== + +In addition to the log statements, you can also validate the change using a digital multimeter to measure the voltage using the +voltage measurement points. + +Start by setting the voltage to the maximum value. Run the following command from the Linux prompt. + +:: + + MAX=$(cat /sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_max_freq) + echo $MAX > /sys/devices/system/cpu/cpu0/cpufreq/scaling_min_freq + echo $MAX > /sys/devices/system/cpu/cpu0/cpufreq/scaling_min_freq + +Observe that the voltage reading on the multimeter shows the maximum voltages. + +Next, reboot the system and observe the voltages when the miniloader sets the voltages based on the leakage ID. The voltages should change accordingly. + +:: + + PMIC: Try... + PMIC: VCORE tps6287x (ID: 0x0a), VCPU tps6287x (ID: 0x0a) I2C PMIC detected + set Vcpu from 900000uv to 750000uv + Vcore is 850000uV, default setting by hardware. + +.. figure:: media/sl1680-voltage-measurement-points.png + + Voltage Measurement Points on SL1680 \ No newline at end of file diff --git a/subject/updating_isp_sensor_configuration.rst b/subject/updating_isp_sensor_configuration.rst index f568d10..ca958a8 100644 --- a/subject/updating_isp_sensor_configuration.rst +++ b/subject/updating_isp_sensor_configuration.rst @@ -28,6 +28,13 @@ Supported Camera Modules | | | 1920x1080 30fps | | | | | | (mode 1) | | | | | | | | | +| +------------------------------------------------------------------------------------------+-----------------+----------------------------------------------------------+----------------------------------------------------+ +| | `Waveshare IMX415 Camera Module | 3840x2160 30fps | MIPI-CSI 0 | Requires updating I2C address in the sensor driver.| +| | `__ | (mode 0) | | | +| | | | | | +| | | 1920x1080 30fps | | | +| | | (mode 1) | | | +| | | | | | +--------+------------------------------------------------------------------------------------------+-----------------+----------------------------------------------------------+----------------------------------------------------+ | OV5647 | `Arducam 5MP OV5647 Camera Module | 640x480 60fps | MIPI-CSI0 | | | | `__ | (mode 0) | | | diff --git a/subject/waveshare_dsi-configuration.rst b/subject/waveshare_dsi-configuration.rst index 9471c59..c53d4c4 100644 --- a/subject/waveshare_dsi-configuration.rst +++ b/subject/waveshare_dsi-configuration.rst @@ -32,9 +32,9 @@ The Waveshare panel can be enabled by setting the ``dtbo`` variable, in U-Boot, +-----------------+-----------------------------------+--------------------------------------+-------------------------------------+------------------------------------+ | | SL1620 | SL1640 | SL1680 | SL2619 | +=================+===================================+======================================+=====================================+====================================+ -| 7" Panel | myna2-ws-panel-overlay.dtbo | platypus-ws-panel-overlay.dtbo | dolphin-ws-panel-overlay.dtbo | sl2619-ws-panel-overlay.dtbo | +| 7" Panel | myna2-ws-panel-overlay.dtbo | platypus-ws-panel-overlay.dtbo | dolphin-ws-panel-overlay.dtbo | sl261x-ws-panel-overlay.dtbo | +-----------------+-----------------------------------+--------------------------------------+-------------------------------------+------------------------------------+ -| 13.3" Panel | myna2-ws-1080p-panel-overlay.dtbo | platypus-ws-1080p-panel-overlay.dtbo | dolphin-ws-1080p-panel-overlay.dtbo | sl2619-ws-1080p-panel-overlay.dtbo | +| 13.3" Panel | myna2-ws-1080p-panel-overlay.dtbo | platypus-ws-1080p-panel-overlay.dtbo | dolphin-ws-1080p-panel-overlay.dtbo | sl261x-ws-1080p-panel-overlay.dtbo | +-----------------+-----------------------------------+--------------------------------------+-------------------------------------+------------------------------------+ See :ref:`devicetree_overlays` for details on how to enable the devicetree overlays. \ No newline at end of file diff --git a/yocto.rst b/yocto.rst index bfd0a4e..fe7885d 100644 --- a/yocto.rst +++ b/yocto.rst @@ -466,12 +466,15 @@ Partition tables ---------------- Partition tables are configured in the file ``emmc.pt`` found in the directory -``product/${SYNA_SDK_CONFIG_NAME}/emmc.pt`` found at http://github.com/synaptics-astra/configs . +``product/${SYNA_SDK_CONFIG_NAME}``. This is part of the `config repo `__. The ``SYNA_SDK_CONFIG_NAME`` depends on the ``MACHINE`` and ``DISTRO_CONFIG`` variables. +SPI images have partition tables configured in the file ``spi.pt`` found in the directory +``product/${SYNA_SDK_CONFIG_NAME}``. This applies to ``*spi`` ``MACHINE`` types. + To customize this file you can override the recipe ``syna-config-native``. -Some partitions are used by the early boot components stored in eMMC boot partition. These +Some partitions are used by the early boot components stored in eMMC or SPI boot partition. These partitions cannot be removed but can be moved. The early boot components locate these partitions using the GPT found in the UDA. Loading from other hardware partitions is not supported.