From 718a122308b422e3bc91431c5f561d8226ecaa89 Mon Sep 17 00:00:00 2001 From: Hari Prasath Gujulan Elango Date: Tue, 19 May 2026 16:09:46 +0530 Subject: [PATCH] feat: Update release notes for SDK 11.02 J722S Update the release notes and the kernel performance metrics for the SDK 11.02 J722s specific release. Signed-off-by: Hari Prasath Gujulan Elango --- Makefile | 4 +- configs/J722S/J722S_linux_tags.py | 2 +- configs/J722S/J722S_linux_toc.txt | 14 +- .../devices/J722S/linux/Release_Specific.rst | 12 + ...ease_Specific_Kernel_Performance_Guide.rst | 1364 +++++++++++++++++ .../Release_Specific_Migration_Guide.rst | 40 + .../linux/Release_Specific_Release_Notes.rst | 539 +++++++ ...cific_Supported_Platforms_and_Versions.rst | 117 ++ ...ase_Specific_Yocto_layer_Configuration.rst | 52 + .../J722S/linux/_Release_Specific_QSG.rst | 93 ++ source/devices/J722S/linux/index.rst | 38 + source/devices/J722S/linux/version.txt | 1 + 12 files changed, 2266 insertions(+), 10 deletions(-) create mode 100644 source/devices/J722S/linux/Release_Specific.rst create mode 100644 source/devices/J722S/linux/Release_Specific_Kernel_Performance_Guide.rst create mode 100644 source/devices/J722S/linux/Release_Specific_Migration_Guide.rst create mode 100644 source/devices/J722S/linux/Release_Specific_Release_Notes.rst create mode 100644 source/devices/J722S/linux/Release_Specific_Supported_Platforms_and_Versions.rst create mode 100644 source/devices/J722S/linux/Release_Specific_Yocto_layer_Configuration.rst create mode 100644 source/devices/J722S/linux/_Release_Specific_QSG.rst create mode 100644 source/devices/J722S/linux/index.rst create mode 100644 source/devices/J722S/linux/version.txt diff --git a/Makefile b/Makefile index f9d2d284b..be151120a 100644 --- a/Makefile +++ b/Makefile @@ -23,14 +23,14 @@ $(info DEVFAMILY is $(DEVFAMILY_UP)) ifeq ($(OS_LOW), android) # For Android, AM67A and AM67 have their own device directories - ifeq ($(DEVFAMILY_UP), $(filter $(DEVFAMILY_UP), J721E J7200 J721S2 J784S4 AM68 AM69 J722S J742S2 AM68A AM69A TDA4VM)) + ifeq ($(DEVFAMILY_UP), $(filter $(DEVFAMILY_UP), J721E J7200 J721S2 J784S4 AM68 AM69 J742S2 AM68A AM69A TDA4VM)) CONFDIR = source/devices/J7_Family/${OS_LOW} else CONFDIR = source/devices/$(DEVFAMILY_UP)/${OS_LOW} endif else # For Linux and other OSes, use J7_Family grouping including AM67A and AM67 - ifeq ($(DEVFAMILY_UP), $(filter $(DEVFAMILY_UP), J721E J7200 J721S2 J784S4 AM68 AM69 J722S AM67 J742S2 AM68A AM67A AM69A TDA4VM)) + ifeq ($(DEVFAMILY_UP), $(filter $(DEVFAMILY_UP), J721E J7200 J721S2 J784S4 AM68 AM69 AM67 J742S2 AM68A AM67A AM69A TDA4VM)) CONFDIR = source/devices/J7_Family/${OS_LOW} else CONFDIR = source/devices/$(DEVFAMILY_UP)/${OS_LOW} diff --git a/configs/J722S/J722S_linux_tags.py b/configs/J722S/J722S_linux_tags.py index 21fa5db25..c1ab110d2 100644 --- a/configs/J722S/J722S_linux_tags.py +++ b/configs/J722S/J722S_linux_tags.py @@ -3,4 +3,4 @@ html_title = 'Processor SDK J722S Documentation' # The master toctree document. -master_doc = 'devices/J7_Family/linux/index' +master_doc = 'devices/J722S/linux/index' diff --git a/configs/J722S/J722S_linux_toc.txt b/configs/J722S/J722S_linux_toc.txt index 45115a6aa..83569dea2 100644 --- a/configs/J722S/J722S_linux_toc.txt +++ b/configs/J722S/J722S_linux_toc.txt @@ -10,13 +10,13 @@ linux/Overview/Download_and_Install_the_SDK linux/Overview/Run_Setup_Scripts linux/Overview/GCC_ToolChain linux/Overview/Processor_SDK_Linux_create_SD_card -devices/J7_Family/linux/index -devices/J7_Family/linux/Release_Specific -devices/J7_Family/linux/Release_Specific_Release_Notes -devices/J7_Family/linux/Release_Specific_Yocto_layer_Configuration -devices/J7_Family/linux/Release_Specific_Migration_Guide -devices/J7_Family/linux/Release_Specific_Kernel_Performance_Guide -devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions +devices/J722S/linux/index +devices/J722S/linux/Release_Specific +devices/J722S/linux/Release_Specific_Release_Notes +devices/J722S/linux/Release_Specific_Yocto_layer_Configuration +devices/J722S/linux/Release_Specific_Migration_Guide +devices/J722S/linux/Release_Specific_Kernel_Performance_Guide +devices/J722S/linux/Release_Specific_Supported_Platforms_and_Versions linux/Foundational_Components linux/Foundational_Components_U-Boot linux/Foundational_Components/U-Boot/Users-Guide diff --git a/source/devices/J722S/linux/Release_Specific.rst b/source/devices/J722S/linux/Release_Specific.rst new file mode 100644 index 000000000..665666e3d --- /dev/null +++ b/source/devices/J722S/linux/Release_Specific.rst @@ -0,0 +1,12 @@ +################## +Release Specific +################## + +.. toctree:: + :maxdepth: 5 + + Release_Specific_Release_Notes + Release_Specific_Kernel_Performance_Guide + Release_Specific_Yocto_layer_Configuration + Release_Specific_Supported_Platforms_and_Versions + Release_Specific_Migration_Guide diff --git a/source/devices/J722S/linux/Release_Specific_Kernel_Performance_Guide.rst b/source/devices/J722S/linux/Release_Specific_Kernel_Performance_Guide.rst new file mode 100644 index 000000000..a3d6c350c --- /dev/null +++ b/source/devices/J722S/linux/Release_Specific_Kernel_Performance_Guide.rst @@ -0,0 +1,1364 @@ + +====================================== + Linux 11.02 Performance Guide +====================================== + +.. rubric:: **Read This First** + :name: read-this-first-kernel-perf-guide + +**All performance numbers provided in this document are gathered using +following Evaluation Modules unless otherwise specified.** + ++----------------+----------------------------------------------------------------------------------------------------------------+ +| Name | Description | ++================+================================================================================================================+ +| J722S EVM | J722S Evaluation Module rev E1 with ARM running at 1.4GHz, DDR data rate 3200 MT/S | ++----------------+----------------------------------------------------------------------------------------------------------------+ + +Table: Evaluation Modules + +.. rubric:: About This Manual + :name: about-this-manual-kernel-perf-guide + +This document provides performance data for each of the device drivers +which are part of the Processor SDK Linux package. This document should be +used in conjunction with release notes and user guides provided with the +Processor SDK Linux package for information on specific issues present +with drivers included in a particular release. + +.. rubric:: If You Need Assistance + :name: if-you-need-assistance-kernel-perf-guide + +For further information or to report any problems, contact +https://e2e.ti.com/ or https://support.ti.com/ + + +System Benchmarks +------------------- + + +LMBench +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +LMBench is a collection of microbenchmarks of which the memory bandwidth +and latency related ones are typically used to estimate processor +memory system performance. More information about lmbench at +https://lmbench.sourceforge.net/whatis_lmbench.html and +https://lmbench.sourceforge.net/man/lmbench.8.html + +**Latency**: :command:`lat_mem_rd-stride128-szN`, where N is equal to or smaller than the cache +size at given level measures the cache miss penalty. N that is at least +double the size of last level cache is the latency to external memory. + +**Bandwidth**: :command:`bw_mem_bcopy-N`, where N is equal to or smaller than the cache size at +a given level measures the achievable memory bandwidth from software doing +a memcpy() type operation. Typical use is for external memory bandwidth +calculation. The bandwidth is calculated as byte read and written counts +as 1 which should be roughly half of STREAM copy result. + +Execute the LMBench with the following: + +.. code-block:: console + + cd /opt/ltp + ./runltp -P j721e-idk-gw -f ddt/lmbench -s LMBENCH_L_PERF_0001 + +.. csv-table:: LMBench Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "af_unix_sock_stream_latency (microsec)","30.20 (min 29.18, max 31.07)" + "af_unix_socket_stream_bandwidth (mb\s)","1078.30 (min 1053.08, max 1122.04)" + "bw_file_rd-io-1mb (mb/s)","1353.62 (min 1303.36, max 1414.93)" + "bw_file_rd-o2c-1mb (mb/s)","742.49 (min 668.11, max 794.91)" + "bw_mem-bcopy-16mb (mb/s)","1738.94 (min 1587.93, max 1876.17)" + "bw_mem-bcopy-1mb (mb/s)","1915.36 (min 1835.24, max 2010.45)" + "bw_mem-bcopy-2mb (mb/s)","1656.80 (min 1592.99, max 1794.04)" + "bw_mem-bcopy-4mb (mb/s)","1658.39 (min 1475.47, max 1811.87)" + "bw_mem-bcopy-8mb (mb/s)","1722.99 (min 1599.04, max 1854.86)" + "bw_mem-bzero-16mb (mb/s)","7220.21 (min 7142.86, max 7323.77)" + "bw_mem-bzero-1mb (mb/s)","4562.12 (min 1835.24, max 7329.45)" + "bw_mem-bzero-2mb (mb/s)","4433.42 (min 1592.99, max 7318.35)" + "bw_mem-bzero-4mb (mb/s)","4434.37 (min 1475.47, max 7319.91)" + "bw_mem-bzero-8mb (mb/s)","4468.98 (min 1599.04, max 7322.65)" + "bw_mem-cp-16mb (mb/s)","878.09 (min 847.46, max 917.22)" + "bw_mem-cp-1mb (mb/s)","4196.46 (min 833.75, max 7636.43)" + "bw_mem-cp-2mb (mb/s)","4106.97 (min 819.22, max 7477.30)" + "bw_mem-cp-4mb (mb/s)","4089.46 (min 850.07, max 7399.93)" + "bw_mem-cp-8mb (mb/s)","4088.66 (min 870.61, max 7358.58)" + "bw_mem-fcp-16mb (mb/s)","1633.25 (min 1479.43, max 1729.17)" + "bw_mem-fcp-1mb (mb/s)","4432.13 (min 1593.20, max 7329.45)" + "bw_mem-fcp-2mb (mb/s)","4379.45 (min 1448.44, max 7318.35)" + "bw_mem-fcp-4mb (mb/s)","4416.70 (min 1542.22, max 7319.91)" + "bw_mem-fcp-8mb (mb/s)","4424.50 (min 1587.30, max 7322.65)" + "bw_mem-frd-16mb (mb/s)","1819.06 (min 1743.68, max 1917.78)" + "bw_mem-frd-1mb (mb/s)","1785.39 (min 1593.20, max 2036.28)" + "bw_mem-frd-2mb (mb/s)","1607.76 (min 1448.44, max 1900.78)" + "bw_mem-frd-4mb (mb/s)","1663.02 (min 1517.64, max 1913.27)" + "bw_mem-frd-8mb (mb/s)","1688.41 (min 1571.86, max 1919.16)" + "bw_mem-fwr-16mb (mb/s)","7243.41 (min 7172.74, max 7346.19)" + "bw_mem-fwr-1mb (mb/s)","4708.61 (min 1781.58, max 7636.43)" + "bw_mem-fwr-2mb (mb/s)","4511.05 (min 1544.88, max 7477.30)" + "bw_mem-fwr-4mb (mb/s)","4494.90 (min 1517.64, max 7399.93)" + "bw_mem-fwr-8mb (mb/s)","4498.44 (min 1571.86, max 7358.58)" + "bw_mem-rd-16mb (mb/s)","1854.34 (min 1787.91, max 1959.10)" + "bw_mem-rd-1mb (mb/s)","1889.98 (min 1569.86, max 2246.35)" + "bw_mem-rd-2mb (mb/s)","1682.18 (min 1395.67, max 1955.99)" + "bw_mem-rd-4mb (mb/s)","1735.74 (min 1550.59, max 1930.19)" + "bw_mem-rd-8mb (mb/s)","1781.20 (min 1585.41, max 1951.70)" + "bw_mem-rdwr-16mb (mb/s)","1764.06 (min 1708.31, max 1887.01)" + "bw_mem-rdwr-1mb (mb/s)","1268.24 (min 833.75, max 1827.15)" + "bw_mem-rdwr-2mb (mb/s)","1162.25 (min 819.22, max 1595.15)" + "bw_mem-rdwr-4mb (mb/s)","1247.41 (min 850.07, max 1718.71)" + "bw_mem-rdwr-8mb (mb/s)","1318.71 (min 870.61, max 1856.79)" + "bw_mem-wr-16mb (mb/s)","1758.40 (min 1687.41, max 1838.24)" + "bw_mem-wr-1mb (mb/s)","1655.81 (min 1515.92, max 1827.15)" + "bw_mem-wr-2mb (mb/s)","1493.50 (min 1370.10, max 1671.68)" + "bw_mem-wr-4mb (mb/s)","1620.08 (min 1527.69, max 1756.18)" + "bw_mem-wr-8mb (mb/s)","1715.91 (min 1585.41, max 1856.79)" + "bw_mmap_rd-mo-1mb (mb/s)","2037.99 (min 1962.18, max 2149.77)" + "bw_mmap_rd-o2c-1mb (mb/s)","740.64 (min 658.65, max 794.91)" + "bw_pipe (mb/s)","771.95 (min 723.11, max 811.97)" + "bw_unix (mb/s)","1078.30 (min 1053.08, max 1122.04)" + "lat_connect (us)","56.95 (min 56.32, max 57.46)" + "lat_ctx-2-128k (us)","8.01 (min 7.64, max 8.67)" + "lat_ctx-2-256k (us)","9.26 (min 6.69, max 14.05)" + "lat_ctx-4-128k (us)","7.73 (min 6.99, max 8.68)" + "lat_ctx-4-256k (us)","7.42 (min 5.49, max 9.58)" + "lat_fs-0k (num_files)","239.09 (min 218.00, max 266.00)" + "lat_fs-10k (num_files)","114.45 (min 107.00, max 123.00)" + "lat_fs-1k (num_files)","162.18 (min 144.00, max 177.00)" + "lat_fs-4k (num_files)","155.73 (min 138.00, max 174.00)" + "lat_mem_rd-stride128-sz1000k (ns)","32.45 (min 30.66, max 33.53)" + "lat_mem_rd-stride128-sz125k (ns)","5.56 (min 5.53, max 5.59)" + "lat_mem_rd-stride128-sz250k (ns)","5.84 (min 5.83, max 5.85)" + "lat_mem_rd-stride128-sz31k (ns)","3.71 (min 2.16, max 4.20)" + "lat_mem_rd-stride128-sz50 (ns)","2.15" + "lat_mem_rd-stride128-sz500k (ns)","12.07 (min 9.83, max 15.73)" + "lat_mem_rd-stride128-sz62k (ns)","5.17 (min 4.52, max 5.26)" + "lat_mmap-1m (us)","54.09 (min 50.00, max 58.00)" + "lat_ops-double-add (ns)","2.86" + "lat_ops-double-div (ns)","15.74 (min 15.74, max 15.75)" + "lat_ops-double-mul (ns)","2.86" + "lat_ops-float-add (ns)","2.86" + "lat_ops-float-div (ns)","9.30 (min 9.30, max 9.31)" + "lat_ops-float-mul (ns)","2.86" + "lat_ops-int-add (ns)","0.72" + "lat_ops-int-bit (ns)","0.48" + "lat_ops-int-div (ns)","4.29 (min 4.29, max 4.30)" + "lat_ops-int-mod (ns)","4.53 (min 4.53, max 4.54)" + "lat_ops-int-mul (ns)","3.08 (min 3.07, max 3.09)" + "lat_ops-int64-add (ns)","0.72" + "lat_ops-int64-bit (ns)","0.48" + "lat_ops-int64-div (ns)","6.80 (min 6.79, max 6.80)" + "lat_ops-int64-mod (ns)","5.25" + "lat_ops-int64-mul (ns)","3.56 (min 3.55, max 3.57)" + "lat_pagefault (us)","0.68 (min 0.52, max 1.11)" + "lat_pipe (us)","25.83 (min 25.14, max 26.41)" + "lat_proc-exec (us)","734.79 (min 697.63, max 780.00)" + "lat_proc-fork (us)","643.13 (min 619.44, max 677.38)" + "lat_proc-proccall (us)","0.01" + "lat_select (us)","34.11 (min 33.90, max 34.35)" + "lat_sem (us)","3.03 (min 2.48, max 3.95)" + "lat_sig-catch (us)","5.57 (min 5.25, max 5.73)" + "lat_sig-install (us)","0.67 (min 0.64, max 0.70)" + "lat_sig-prot (us)","0.72 (min 0.55, max 1.38)" + "lat_syscall-fstat (us)","2.00 (min 1.90, max 2.07)" + "lat_syscall-null (us)","0.46 (min 0.46, max 0.50)" + "lat_syscall-open (us)","167.61 (min 148.50, max 199.96)" + "lat_syscall-read (us)","0.82 (min 0.80, max 0.89)" + "lat_syscall-stat (us)","4.83 (min 4.63, max 4.99)" + "lat_syscall-write (us)","0.77 (min 0.75, max 0.84)" + "lat_tcp (us)","0.92 (min 0.91, max 0.97)" + "lat_unix (us)","30.20 (min 29.18, max 31.07)" + "latency_for_0.50_mb_block_size (nanosec)","12.07 (min 9.83, max 15.73)" + "latency_for_1.00_mb_block_size (nanosec)","16.22 (min 0.00, max 33.53)" + "pipe_bandwidth (mb\s)","771.95 (min 723.11, max 811.97)" + "pipe_latency (microsec)","25.83 (min 25.14, max 26.41)" + "procedure_call (microsec)","0.01" + "select_on_200_tcp_fds (microsec)","34.11 (min 33.90, max 34.35)" + "semaphore_latency (microsec)","3.03 (min 2.48, max 3.95)" + "signal_handler_latency (microsec)","0.67 (min 0.64, max 0.70)" + "signal_handler_overhead (microsec)","5.57 (min 5.25, max 5.73)" + "tcp_ip_connection_cost_to_localhost (microsec)","56.95 (min 56.32, max 57.46)" + "tcp_latency_using_localhost (microsec)","0.92 (min 0.91, max 0.97)" + + + + +Dhrystone +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Dhrystone is a core only benchmark that runs from warm L1 caches in all +modern processors. It scales linearly with clock speed. + +Please take note, different run may produce different slightly results. +This is advised to run this test multiple times in order to get maximum +performance numbers. + + +Execute the benchmark with the following: + +.. code-block:: console + + runDhrystone + +.. csv-table:: Dhrystone Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "cpu_clock (mhz)","1400.00" + "dhrystone_per_mhz (dmips/mhz)","2.91 (min 2.90, max 3.00)" + "dhrystone_per_second (dhrystonep)","7166907.05 (min 7142857.00, max 7407407.50)" + + + + +Whetstone +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Whetstone is a benchmark primarily measuring floating-point arithmetic performance. + +Execute the benchmark with the following: + +.. code-block:: console + + runWhetstone + +.. csv-table:: Whetstone Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "whetstone (mips)","7727.27 (min 5000.00, max 10000.00)" + + + + +Linpack +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Linpack measures peak double precision (64 bit) floating point performance in +solving a dense linear system. + +.. csv-table:: Linpack Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "linpack (kflops)","576093.64 (min 573082.00, max 578392.00)" + + + + +NBench +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +NBench which stands for Native Benchmark is used to measure macro benchmarks +for commonly used operations such as sorting and analysis algorithms. +More information about NBench at +https://en.wikipedia.org/wiki/NBench and +https://nbench.io/articles/index.html + +.. csv-table:: NBench Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "assignment (iterations)","14.49 (min 14.45, max 14.52)" + "fourier (iterations)","22829.27 (min 22821.00, max 22831.00)" + "fp_emulation (iterations)","215.64 (min 215.62, max 215.65)" + "huffman (iterations)","1184.02 (min 1183.30, max 1184.30)" + "idea (iterations)","3444.75 (min 3444.60, max 3444.90)" + "lu_decomposition (iterations)","529.78 (min 527.92, max 531.90)" + "neural_net (iterations)","8.65 (min 8.65, max 8.66)" + "numeric_sort (iterations)","625.40 (min 616.42, max 629.11)" + "string_sort (iterations)","163.94 (min 163.93, max 163.94)" + + + + +Stream +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +STREAM is a microbenchmark for measuring data memory system performance without +any data reuse. It is designed to miss on caches and exercise data prefetcher +and speculative accesses. +It uses double precision floating point (64bit) but in +most modern processors the memory access will be the bottleneck. +The four individual scores are copy, scale as in multiply by constant, +add two numbers, and triad for multiply accumulate. +For bandwidth, a byte read counts as one and a byte written counts as one, +resulting in a score that is double the bandwidth LMBench will show. + +Execute the benchmark with the following: + +.. code-block:: console + + stream_c + +.. csv-table:: Stream Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "add (mb/s)","2463.19 (min 2403.10, max 2614.00)" + "copy (mb/s)","3585.41 (min 3509.50, max 3810.40)" + "scale (mb/s)","3272.55 (min 3167.90, max 3465.20)" + "triad (mb/s)","2258.07 (min 2216.30, max 2372.80)" + + + + +CoreMarkPro +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +CoreMark®-Pro is a comprehensive, advanced processor benchmark that works with +and enhances the market-proven industry-standard EEMBC CoreMark® benchmark. +While CoreMark stresses the CPU pipeline, CoreMark-Pro tests the entire processor, +adding comprehensive support for multicore technology, a combination of integer +and floating-point workloads, and data sets for utilizing larger memory subsystems. + + +.. csv-table:: CoreMarkPro Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "cjpeg-rose7-preset (workloads/)","41.95 (min 41.67, max 42.02)" + "core (workloads/)","0.30" + "coremark-pro ()","921.98 (min 896.57, max 945.42)" + "linear_alg-mid-100x100-sp (workloads/)","14.68 (min 14.67, max 14.68)" + "loops-all-mid-10k-sp (workloads/)","0.71 (min 0.70, max 0.71)" + "nnet_test (workloads/)","1.09 (min 1.08, max 1.09)" + "parser-125k (workloads/)","8.72 (min 8.62, max 8.77)" + "radix2-big-64k (workloads/)","61.84 (min 47.42, max 74.70)" + "sha-test (workloads/)","81.30 (min 80.65, max 81.97)" + "zip-test (workloads/)","22.13 (min 21.74, max 22.22)" + + + + +.. csv-table:: CoreMarkProTwoCore Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "cjpeg-rose7-preset (workloads/)","83.34 (min 82.64, max 84.03)" + "core (workloads/)","0.60" + "coremark-pro ()","1635.28 (min 1620.08, max 1655.03)" + "linear_alg-mid-100x100-sp (workloads/)","29.34 (min 29.33, max 29.38)" + "loops-all-mid-10k-sp (workloads/)","1.28 (min 1.27, max 1.29)" + "nnet_test (workloads/)","2.17" + "parser-125k (workloads/)","13.22 (min 12.58, max 14.08)" + "radix2-big-64k (workloads/)","64.15 (min 60.39, max 67.36)" + "sha-test (workloads/)","161.29" + "zip-test (workloads/)","42.55" + + + + +.. csv-table:: CoreMarkProFourCore Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "cjpeg-rose7-preset (workloads/)","159.01 (min 153.85, max 161.29)" + "core (workloads/)","1.19 (min 1.18, max 1.20)" + "coremark-pro ()","2558.18 (min 2515.96, max 2580.49)" + "linear_alg-mid-100x100-sp (workloads/)","56.26 (min 55.68, max 56.37)" + "loops-all-mid-10k-sp (workloads/)","2.06 (min 2.00, max 2.12)" + "nnet_test (workloads/)","3.62 (min 3.61, max 3.62)" + "parser-125k (workloads/)","8.75 (min 8.26, max 9.24)" + "radix2-big-64k (workloads/)","92.95 (min 87.57, max 98.36)" + "sha-test (workloads/)","270.27" + "zip-test (workloads/)","76.05 (min 66.67, max 78.43)" + + + + + + + +MultiBench +^^^^^^^^^^^^^^^^^^^^^^^^^^^ +MultiBench™ is a suite of benchmarks that allows processor and system designers to +analyze, test, and improve multicore processors. It uses three forms of concurrency: +Data decomposition: multiple threads cooperating on achieving a unified goal and +demonstrating a processor’s support for fine grain parallelism. +Processing multiple data streams: uses common code running over multiple threads and +demonstrating how well a processor scales over scalable data inputs. +Multiple workload processing: shows the scalability of general-purpose processing, +demonstrating concurrency over both code and data. +MultiBench combines a wide variety of application-specific workloads with the EEMBC +Multi-Instance-Test Harness (MITH), compatible and portable with most any multicore +processors and operating systems. MITH uses a thread-based API (POSIX-compliant) to +establish a common programming model that communicates with the benchmark through an +abstraction layer and provides a flexible interface to allow a wide variety of +thread-enabled workloads to be tested. + +.. csv-table:: Multibench Benchmarks + :header: "Benchmarks","j722s_evm-fs: perf" + + "4m-check (workloads/)","396.91 (min 379.08, max 410.64)" + "4m-check-reassembly (workloads/)","116.11 (min 111.36, max 120.77)" + "4m-check-reassembly-tcp (workloads/)","57.94 (min 56.18, max 59.52)" + "4m-check-reassembly-tcp-cmykw2-rotatew2 (workloads/)","32.35 (min 31.76, max 32.99)" + "4m-check-reassembly-tcp-x264w2 (workloads/)","1.86 (min 1.69, max 1.92)" + "4m-cmykw2 (workloads/)","241.82 (min 232.83, max 247.83)" + "4m-cmykw2-rotatew2 (workloads/)","48.95 (min 47.77, max 49.71)" + "4m-reassembly (workloads/)","80.73 (min 76.75, max 90.17)" + "4m-rotatew2 (workloads/)","52.53 (min 51.71, max 53.68)" + "4m-tcp-mixed (workloads/)","116.37 (min 114.29, max 118.52)" + "4m-x264w2 (workloads/)","1.95 (min 1.89, max 1.98)" + "idct-4m (workloads/)","19.15 (min 19.14, max 19.16)" + "idct-4mw1 (workloads/)","19.15 (min 19.14, max 19.17)" + "ippktcheck-4m (workloads/)","396.73 (min 381.04, max 412.68)" + "ippktcheck-4mw1 (workloads/)","397.66 (min 378.90, max 413.84)" + "ipres-4m (workloads/)","105.59 (min 98.62, max 110.70)" + "ipres-4mw1 (workloads/)","105.87 (min 99.67, max 110.87)" + "md5-4m (workloads/)","27.24 (min 26.75, max 27.87)" + "md5-4mw1 (workloads/)","27.40 (min 26.92, max 27.82)" + "rgbcmyk-4m (workloads/)","64.68 (min 62.32, max 65.53)" + "rgbcmyk-4mw1 (workloads/)","64.64 (min 62.29, max 65.49)" + "rotate-4ms1 (workloads/)","22.99 (min 22.17, max 23.70)" + "rotate-4ms1w1 (workloads/)","23.00 (min 22.09, max 23.70)" + "rotate-4ms64 (workloads/)","23.26 (min 22.36, max 23.93)" + "rotate-4ms64w1 (workloads/)","23.19 (min 22.28, max 23.89)" + "x264-4mq (workloads/)","0.58 (min 0.57, max 0.58)" + "x264-4mqw1 (workloads/)","0.58 (min 0.55, max 0.58)" + + + + + + + +Boot-time Measurement +--------------------- + + +Boot media: MMCSD +^^^^^^^^^^^^^^^^^ + +.. csv-table:: Linux boot time MMCSD + :header: "Boot Configuration","j722s_evm-fs: Boot time in seconds: avg(min,max)" + + "Linux boot time from SD with default rootfs (20 boot cycles)","22.51 (min 20.09, max 47.31)" + + + + + +Boot time numbers [avg, min, max] are measured from "Starting kernel" to Linux prompt across 20 boot cycles. + + + + +| + +ALSA SoC Audio Driver +------------------------- + +#. Access type - RW\_INTERLEAVED +#. Channels - 2 +#. Format - S16\_LE +#. Period size - 64 + + +.. csv-table:: Audio Capture + :header: "Sampling Rate (Hz)","j722s_evm-fs: Throughput (bits/sec)","j722s_evm-fs: CPU Load (%)" + + "11025","331812.00","0.31" + "16000","511983.00","0.34" + "22050","663606.00","0.34" + "24000","663624.00","0.35" + "32000","1023958.00","0.38" + "44100","1327261.00","0.42" + "48000","1535942.00","0.40" + "88200","2654511.00","0.54" + "96000","3071726.00","0.58" + + + + +.. csv-table:: Audio Playback + :header: "Sampling Rate (Hz)","j722s_evm-fs: Throughput (bits/sec)","j722s_evm-fs: CPU Load (%)" + + "11025","183250.00","0.26" + "16000","244824.00","0.26" + "22050","367203.00","0.27" + "24000","366979.00","0.27" + "32000","489566.00","0.27" + "44100","734279.00","0.33" + "48000","733745.00","0.27" + "88200","1467285.00","0.37" + "96000","1467503.00","0.31" + + + + + + + + + + +| + +Graphics SGX/RGX Driver +------------------------- + + + + + +Glmark2 +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Run Glmark2 and capture performance reported (Score). All display outputs (HDMI, Displayport and/or LCD) are connected when running these tests + +.. csv-table:: Glmark2 Performance + :header: "Benchmark","j722s_evm-fs: Score" + + "Glmark2-DRM","286.18 (min 285.00, max 287.00)" + "Glmark2-Wayland","788.82 (min 740.00, max 810.00)" + + + + + + + + + + +| + +Ethernet +----------------- +Ethernet performance benchmarks were measured using :command:`netperf` 2.7.1 https://hewlettpackard.github.io/netperf/doc/netperf.html +Test procedures were modeled after those defined in RFC-2544: +https://tools.ietf.org/html/rfc2544, where the DUT is the TI device +and the "tester" used was a Linux PC. To produce consistent results, +it is recommended to carry out performance tests in a private network and to avoid +running NFS on the same interface used in the test. In these results, +CPU utilization was captured as the total percentage used across all cores on the device, +while running the performance test over one external interface. + +UDP Throughput (0% loss) was measured by the procedure defined in RFC-2544 section 26.1: Throughput. +In this scenario, :command:`netperf` options burst_size (-b) and wait_time (-w) are used to limit bandwidth +during different trials of the test, with the goal of finding the highest rate at which +no loss is seen. For example, to limit bandwidth to 500Mbits/sec with 1472B datagram: + +.. code-block:: console + + burst_size = / 8 (bits -> bytes) / / 100 (seconds -> 10 ms) + burst_size = 500000000 / 8 / 1472 / 100 = 425 + + wait_time = 10 milliseconds (minimum supported by Linux PC used for testing) + +UDP Throughput (possible loss) was measured by capturing throughput and packet loss statistics when +running the :command:`netperf` test with no bandwidth limit (remove -b/-w options). + +In order to start a :command:`netperf` client on one device, the other device must have :command:`netserver` running. +To start :command:`netserver`: + +.. code-block:: console + + netserver [-p ] [-4 (IPv4 addressing)] [-6 (IPv6 addressing)] + +Running the following shell script from the DUT will trigger :command:`netperf` clients to measure +bidirectional TCP performance for 60 seconds and report CPU utilization. Parameter -k is used in +client commands to summarize selected statistics on their own line and -j is used to gain +additional timing measurements during the test. + +.. code-block:: console + + #!/bin/bash + for i in 1 + do + netperf -H -j -c -l 60 -t TCP_STREAM -- + -k DIRECTION,THROUGHPUT,MEAN_LATENCY,LOCAL_CPU_UTIL,REMOTE_CPU_UTIL,LOCAL_BYTES_SENT,REMOTE_BYTES_RECVD,LOCAL_SEND_SIZE & + + netperf -H -j -c -l 60 -t TCP_MAERTS -- + -k DIRECTION,THROUGHPUT,MEAN_LATENCY,LOCAL_CPU_UTIL,REMOTE_CPU_UTIL,LOCAL_BYTES_SENT,REMOTE_BYTES_RECVD,LOCAL_SEND_SIZE & + done + +Running the following commands will trigger :command:`netperf` clients to measure UDP burst performance for +60 seconds at various burst/datagram sizes and report CPU utilization. + +- For UDP egress tests, run :command:`netperf` client from DUT and start :command:`netserver` on tester. + +.. code-block:: console + + netperf -H -j -c -l 60 -t UDP_STREAM -b -w -- -m + -k DIRECTION,THROUGHPUT,MEAN_LATENCY,LOCAL_CPU_UTIL,REMOTE_CPU_UTIL,LOCAL_BYTES_SENT,REMOTE_BYTES_RECVD,LOCAL_SEND_SIZE + +- For UDP ingress tests, run :command:`netperf` client from tester and start :command:`netserver` on DUT. + +.. code-block:: console + + netperf -H -j -C -l 60 -t UDP_STREAM -b -w -- -m + -k DIRECTION,THROUGHPUT,MEAN_LATENCY,LOCAL_CPU_UTIL,REMOTE_CPU_UTIL,LOCAL_BYTES_SENT,REMOTE_BYTES_RECVD,LOCAL_SEND_SIZE + + +CPSW/CPSW2g/CPSW3g Ethernet Driver +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +- CPSW2g: AM65x, J7200, J721e, J721S2, J784S4, J742S2 +- CPSW3g: AM64x, AM62x, AM62ax, AM62dx, AM62px + + +.. rubric:: TCP Bidirectional Throughput + :name: CPSW2g-tcp-bidirectional-throughput + +.. csv-table:: CPSW2g TCP Bidirectional Throughput + :header: "Command Used","j722s_evm-fs: THROUGHPUT (Mbits/sec)","j722s_evm-fs: CPU Load % (LOCAL_CPU_UTIL)" + + "netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_STREAM; netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_MAERTS","1400.96 (min 821.14, max 1858.02)","50.61 (min 34.00, max 66.05)" + + + + +.. rubric:: TCP Bidirectional Throughput Interrupt Pacing + :name: CPSW2g-tcp-bidirectional-throughput-interrupt-pacing + +.. csv-table:: CPSW2g TCP Bidirectional Throughput Interrupt Pacing + :header: "Command Used","j722s_evm-fs: THROUGHPUT (Mbits/sec)","j722s_evm-fs: CPU Load % (LOCAL_CPU_UTIL)" + + "netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_STREAM; netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_MAERTS","1249.26 (min 838.70, max 1858.49)","35.94 (min 31.92, max 40.01)" + + + + +.. rubric:: UDP Throughput + :name: CPSW2g-udp-throughput-0-loss + +.. csv-table:: CPSW2g UDP Egress Throughput 0 loss + :header: "Frame Size(bytes)","j722s_evm-fs: UDP Datagram Size(bytes) (LOCAL_SEND_SIZE)","j722s_evm-fs: THROUGHPUT (Mbits/sec)","j722s_evm-fs: Packets Per Second (kPPS)","j722s_evm-fs: CPU Load % (LOCAL_CPU_UTIL)" + + "64","","56.39 (min 53.92, max 59.25)","110.11 (min 105.00, max 116.00)","32.81 (min 25.28, max 47.09)" + "128","","104.27 (min 49.66, max 116.67)","101.70 (min 48.00, max 114.00)","30.39 (min 17.06, max 39.64)" + "256","","222.26 (min 211.61, max 232.25)","108.33 (min 103.00, max 113.00)","25.87 (min 25.26, max 26.19)" + "1024","","676.85 (min 104.85, max 844.00)","82.73 (min 13.00, max 103.00)","28.89 (min 2.08, max 40.04)" + "1518","","772.00 (min 559.32, max 836.04)","63.70 (min 46.00, max 69.00)","28.08 (min 21.61, max 37.42)" + + + + + + + + + + + + + + + + + + + +| + +Linux OSPI Flash Driver +------------------------- + + + + + + + + + + + + + + + + + + + + + + + + + + +.. rubric:: J722S-EVM + :name: j722s-evm-ospi + + +.. rubric:: UBIFS + :name: j722s-evm-ospi-ubifs + +.. csv-table:: OSPI Flash Driver + :header: "Buffer size (bytes)","j722s_evm-fs: Write UBIFS Throughput (Mbytes/sec)","j722s_evm-fs: Write UBIFS CPU Load (%)","j722s_evm-fs: Read UBIFS Throughput (Mbytes/sec)","j722s_evm-fs: Read UBIFS CPU Load (%)" + + "102400","0.18 (min 0.13, max 0.29)","29.24 (min 24.84, max 37.67)","63.58 (min 55.35, max 65.07)","22.91 (min 8.33, max 53.85)" + "262144","0.14 (min 0.10, max 0.19)","30.11 (min 25.37, max 35.93)","64.49 (min 62.76, max 65.47)","21.86 (min 8.33, max 28.57)" + "524288","0.15 (min 0.11, max 0.19)","30.40 (min 26.04, max 37.28)","63.99 (min 62.63, max 65.20)","17.30 (min 0.00, max 26.67)" + "1048576","0.15 (min 0.11, max 0.19)","30.15 (min 26.60, max 37.86)","62.81 (min 62.12, max 64.01)","22.31 (min 15.38, max 26.67)" + + + + +.. rubric:: RAW + :name: j722s-evm-ospi-raw + +.. csv-table:: OSPI Raw Flash Driver + :header: "File size (Mbytes)","j722s_evm-fs: Raw Read Throughput (Mbytes/sec)" + + "50","225.38 (min 208.33, max 227.27)" + + + + + + + + + + + + + + + + + + + + + + + + + +EMMC Driver +----------- +.. warning:: + + **IMPORTANT**: The performance numbers can be severely affected if the media is + mounted in sync mode. Hot plug scripts in the filesystem mount + removable media in sync mode to ensure data integrity. For performance + sensitive applications, umount the auto-mounted filesystem and + re-mount in async mode. + + + +EMMC EXT4 FIO 1G +^^^^^^^^^^^^^^^^ + + + + + + + + + + + + + + + + + + + + + + + + + + +.. csv-table:: EMMC EXT4 FIO 1G + :header: "Buffer size (bytes)","j722s_evm-fs: Write EXT4 Throughput (Mbytes/sec)","j722s_evm-fs: Write EXT4 CPU Load (%)","j722s_evm-fs: Read EXT4 Throughput (Mbytes/sec)","j722s_evm-fs: Read EXT4 CPU Load (%)" + + "1m","93.70 (min 78.00, max 97.60)","1.79 (min 1.41, max 1.97)","261.64 (min 113.00, max 296.00)","2.77 (min 1.36, max 3.32)" + "4m","93.98 (min 78.40, max 98.10)","1.29 (min 1.05, max 1.41)","235.82 (min 112.00, max 295.00)","2.01 (min 1.15, max 2.43)" + "4k","70.18 (min 8.57, max 83.90)","21.84 (min 3.20, max 26.13)","83.22 (min 56.60, max 90.90)","19.52 (min 14.57, max 21.33)" + "256k","92.02 (min 68.70, max 97.60)","2.19 (min 1.69, max 2.46)","257.33 (min 94.80, max 296.00)","3.91 (min 1.51, max 4.50)" + + + + + + + + + + + + + + + + + + + + + +EMMC RAW FIO 1G +^^^^^^^^^^^^^^^ + + + + + + + + + + + + + + + + + + + + + + + + + + +.. csv-table:: EMMC RAW FIO 1G + :header: "Buffer size (bytes)","j722s_evm-fs: Write Raw Throughput (Mbytes/sec)","j722s_evm-fs: Write Raw CPU Load (%)","j722s_evm-fs: Read Raw Throughput (Mbytes/sec)","j722s_evm-fs: Read Raw CPU Load (%)" + + "1m","92.23 (min 78.00, max 97.80)","1.59 (min 1.28, max 1.76)","245.55 (min 112.00, max 296.00)","2.60 (min 1.43, max 3.31)" + "4m","92.55 (min 78.20, max 98.30)","1.20 (min 1.01, max 1.36)","240.84 (min 95.20, max 296.00)","1.98 (min 1.05, max 2.41)" + "4k","62.22 (min 8.58, max 82.70)","14.71 (min 2.45, max 19.51)","83.77 (min 56.60, max 94.30)","18.76 (min 13.48, max 20.97)" + "256k","88.79 (min 68.50, max 97.80)","1.91 (min 1.30, max 2.17)","240.81 (min 94.30, max 296.00)","3.47 (min 1.66, max 4.34)" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +UBoot EMMC Driver +----------------- + + + + + + + + + + + + + + + + + + + + + + + + + + +.. csv-table:: UBOOT EMMC RAW + :header: "File size (bytes in hex)","j722s_evm-fs: Write Throughput (Kbytes/sec)","j722s_evm-fs: Read Throughput (Kbytes/sec)" + + "2000000","97416.47 (min 93622.86, max 103044.03)","158425.46 (min 95255.81, max 172463.16)" + "4000000","97962.16 (min 95812.87, max 100669.74)","165579.48 (min 123886.58, max 175699.73)" + + + + + + + + + + + + + + + + + + + + + + + +MMCSD +----- + +.. warning:: + + **IMPORTANT**: The performance numbers can be severely affected if the media is + mounted in sync mode. Hot plug scripts in the filesystem mount + removable media in sync mode to ensure data integrity. For performance + sensitive applications, umount the auto-mounted filesystem and + re-mount in async mode. + + +MMC EXT4 FIO 1G +^^^^^^^^^^^^^^^ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +.. csv-table:: MMC EXT4 FIO 1G + :header: "Buffer size (bytes)","j722s_evm-fs: Write EXT4 Throughput (Mbytes/sec)","j722s_evm-fs: Write EXT4 CPU Load (%)","j722s_evm-fs: Read EXT4 Throughput (Mbytes/sec)","j722s_evm-fs: Read EXT4 CPU Load (%)" + + "1m","42.14 (min 41.20, max 43.40)","1.31 (min 1.24, max 1.39)","86.92 (min 85.10, max 87.40)","1.53 (min 1.41, max 1.62)" + "4m","42.24 (min 40.80, max 43.30)","0.93 (min 0.86, max 1.02)","86.82 (min 85.00, max 87.40)","1.15 (min 1.09, max 1.25)" + "4k","2.78 (min 2.77, max 2.82)","1.94 (min 1.87, max 2.07)","12.99 (min 12.90, max 13.10)","4.53 (min 4.33, max 4.79)" + "256k","38.05 (min 36.70, max 39.60)","1.51 (min 1.38, max 1.60)","83.69 (min 83.20, max 84.40)","1.75 (min 1.64, max 1.84)" + + + + + + + + + + + + + + + + + + + + + + + + + +MMC RAW FIO 1G +^^^^^^^^^^^^^^ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +.. csv-table:: MMC RAW FIO 1G + :header: "Buffer size (bytes)","j722s_evm-fs: Write Raw Throughput (Mbytes/sec)","j722s_evm-fs: Write Raw CPU Load (%)","j722s_evm-fs: Read Raw Throughput (Mbytes/sec)","j722s_evm-fs: Read Raw CPU Load (%)" + + "1m","43.52 (min 42.00, max 45.00)","1.15 (min 1.07, max 1.23)","88.16 (min 88.10, max 88.30)","1.42 (min 1.28, max 1.52)" + "4m","43.30 (min 41.20, max 45.10)","0.92 (min 0.81, max 0.96)","88.13 (min 88.00, max 88.30)","1.12 (min 1.03, max 1.25)" + "4k","2.81 (min 2.80, max 2.82)","1.61 (min 1.54, max 1.71)","13.03 (min 13.00, max 13.10)","4.19 (min 4.05, max 4.33)" + "256k","38.05 (min 36.10, max 41.30)","1.28 (min 1.15, max 1.37)","84.36 (min 84.30, max 84.50)","1.72 (min 1.64, max 1.80)" + + + + + + + + + + + + + +MMC EXT4 +^^^^^^^^ + + + + + + + + + + + + + + + + + + +.. csv-table:: MMC EXT4 + :header: "Buffer size (bytes)","j722s_evm-fs: Write Raw Throughput (Mbytes/sec)","j722s_evm-fs: Write Raw CPU Load (%)","j722s_evm-fs: Read Raw Throughput (Mbytes/sec)","j722s_evm-fs: Read Raw CPU Load (%)" + + "102400","37.68 (min 33.75, max 43.21)","3.12 (min 2.33, max 4.56)","76.75 (min 72.19, max 81.41)","4.78 (min 4.01, max 5.54)" + "262144","38.19 (min 35.48, max 42.02)","3.29 (min 2.47, max 4.96)","83.48 (min 77.77, max 87.12)","4.99 (min 3.42, max 6.57)" + "524288","39.14 (min 37.30, max 42.85)","3.15 (min 2.56, max 4.66)","90.90 (min 89.43, max 91.30)","5.23 (min 4.37, max 6.24)" + "1048576","38.17 (min 36.81, max 40.88)","3.05 (min 2.34, max 4.61)","90.96 (min 89.06, max 91.33)","5.34 (min 4.81, max 5.86)" + "5242880","38.80 (min 36.47, max 41.93)","3.04 (min 2.44, max 4.46)","91.04 (min 89.07, max 91.36)","5.12 (min 4.81, max 5.43)" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +MMC EXT2 +^^^^^^^^ + + + + + + + + + + + + + + + + + + +.. csv-table:: MMC EXT2 + :header: "Buffer size (bytes)","j722s_evm-fs: Write Raw Throughput (Mbytes/sec)","j722s_evm-fs: Write Raw CPU Load (%)","j722s_evm-fs: Read Raw Throughput (Mbytes/sec)","j722s_evm-fs: Read Raw CPU Load (%)" + + "102400","39.80 (min 33.62, max 42.84)","3.73 (min 2.83, max 6.09)","79.44 (min 76.26, max 80.71)","5.08 (min 4.08, max 5.94)" + "262144","38.33 (min 33.20, max 42.42)","3.51 (min 2.51, max 6.19)","85.14 (min 81.72, max 86.81)","5.62 (min 4.38, max 6.24)" + "524288","37.10 (min 32.44, max 41.65)","3.37 (min 2.43, max 5.82)","88.85 (min 85.08, max 90.53)","5.42 (min 4.91, max 5.88)" + "1048576","38.16 (min 32.93, max 41.90)","3.47 (min 2.63, max 6.11)","89.86 (min 84.98, max 90.43)","5.33 (min 4.76, max 5.62)" + "5242880","37.69 (min 32.90, max 41.33)","3.38 (min 2.41, max 5.67)","89.85 (min 85.36, max 90.54)","5.39 (min 4.56, max 6.06)" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +The performance numbers were captured using the following: + +- SanDisk Max Endurance SD card (SDSQQVR-032G-GN6IA) +- Partition was mounted with async option + + + + +UBoot MMCSD +----------- + + +UBOOT MMCSD FAT +^^^^^^^^^^^^^^^ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +.. csv-table:: UBOOT MMCSD FAT + :header: "File size (bytes in hex)","j722s_evm-fs: Write Throughput (Kbytes/sec)","j722s_evm-fs: Read Throughput (Kbytes/sec)" + + "400000","33637.83 (min 17429.79, max 39766.99)","82077.95 (min 80313.73, max 83591.84)" + "800000","41165.44 (min 18492.10, max 47080.46)","87239.45 (min 85333.33, max 88086.02)" + "1000000","43838.50 (min 19006.96, max 49951.22)","89665.66 (min 88562.16, max 90021.98)" + + + + + + + + + + + + + + + + + + + + + + + + + + +The performance numbers were captured using the following: + +- SanDisk Max Endurance SD card (SDSQQVR-032G-GN6IA) + + + + + + +| + +CRYPTO Driver +------------------------- + + +OpenSSL Performance +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. csv-table:: OpenSSL Performance + :header: "Algorithm","Buffer Size (in bytes)","j722s_evm-fs: throughput (KBytes/Sec)" + + "aes-128-cbc","1024","23385.77 (min 22151.17, max 24363.69)" + "aes-128-cbc","16","426.13 (min 403.10, max 439.23)" + "aes-128-cbc","16384","85549.80 (min 83197.95, max 86168.92)" + "aes-128-cbc","256","7047.33 (min 6523.65, max 7271.51)" + "aes-128-cbc","64","1844.64 (min 1697.60, max 1920.32)" + "aes-128-cbc","8192","72172.76 (min 69530.97, max 73400.32)" + "aes-128-ecb","1024","23927.47 (min 22709.93, max 24908.80)" + "aes-128-ecb","16","438.04 (min 407.23, max 449.49)" + "aes-128-ecb","16384","88185.14 (min 86496.60, max 89139.88)" + "aes-128-ecb","256","7221.45 (min 6547.20, max 7430.74)" + "aes-128-ecb","64","1895.82 (min 1759.64, max 1970.97)" + "aes-128-ecb","8192","74501.03 (min 71783.77, max 75513.86)" + "aes-192-cbc","1024","22845.69 (min 21753.17, max 23803.56)" + "aes-192-cbc","16","427.62 (min 403.40, max 438.95)" + "aes-192-cbc","16384","77440.71 (min 76283.90, max 78260.91)" + "aes-192-cbc","256","7000.01 (min 6517.93, max 7218.77)" + "aes-192-cbc","64","1841.18 (min 1695.85, max 1924.48)" + "aes-192-cbc","8192","66273.53 (min 64555.69, max 67267.24)" + "aes-192-ecb","1024","23497.57 (min 22318.08, max 24482.13)" + "aes-192-ecb","16","436.89 (min 407.09, max 447.47)" + "aes-192-ecb","16384","79628.23 (min 77720.23, max 80745.81)" + "aes-192-ecb","256","7163.56 (min 6531.24, max 7358.72)" + "aes-192-ecb","64","1884.96 (min 1727.21, max 1957.40)" + "aes-192-ecb","8192","68409.90 (min 66385.24, max 69394.43)" + "aes-256-cbc","1024","22245.66 (min 21141.50, max 23027.37)" + "aes-256-cbc","16","427.53 (min 402.01, max 437.66)" + "aes-256-cbc","16384","70223.81 (min 69058.56, max 71538.01)" + "aes-256-cbc","256","6931.14 (min 6486.10, max 7170.05)" + "aes-256-cbc","64","1839.63 (min 1679.91, max 1927.49)" + "aes-256-cbc","8192","61112.32 (min 59370.15, max 62180.01)" + "aes-256-ecb","1024","22870.67 (min 21734.06, max 23703.55)" + "aes-256-ecb","16","436.69 (min 407.34, max 448.30)" + "aes-256-ecb","16384","72585.59 (min 70866.26, max 73536.85)" + "aes-256-ecb","256","7115.51 (min 6539.86, max 7290.97)" + "aes-256-ecb","64","1874.33 (min 1758.95, max 1940.03)" + "aes-256-ecb","8192","62940.13 (min 61115.05, max 63646.38)" + "sha256","1024","37625.58 (min 37018.97, max 38389.76)" + "sha256","16","627.07 (min 619.02, max 634.84)" + "sha256","16384","299595.84 (min 297194.84, max 302661.63)" + "sha256","256","9837.03 (min 9667.41, max 10056.79)" + "sha256","64","2484.70 (min 2441.51, max 2533.16)" + "sha256","8192","202278.11 (min 200119.64, max 205138.60)" + "sha512","1024","26074.30 (min 25574.40, max 26348.20)" + "sha512","16","612.69 (min 600.61, max 621.75)" + "sha512","16384","68395.26 (min 68217.51, max 68556.12)" + "sha512","256","8708.25 (min 8516.52, max 8841.22)" + "sha512","64","2455.26 (min 2403.86, max 2504.26)" + "sha512","8192","61569.33 (min 61429.08, max 61707.61)" + + + + +.. csv-table:: OpenSSL CPU Load + :header: "Algorithm","j722s_evm-fs: CPU Load" + + "aes-128-cbc","32.36 (min 31.00, max 34.00)" + "aes-128-ecb","33.55 (min 32.00, max 35.00)" + "aes-192-cbc","32.36 (min 30.00, max 33.00)" + "aes-192-ecb","33.00 (min 31.00, max 34.00)" + "aes-256-cbc","31.45 (min 29.00, max 33.00)" + "aes-256-ecb","32.27 (min 31.00, max 33.00)" + "sha256","94.45 (min 84.00, max 96.00)" + "sha512","94.73 (min 90.00, max 96.00)" + + + +Listed for each algorithm are the code snippets used to run each + benchmark test. + +.. code-block:: console + + time -v openssl speed -elapsed -evp aes-128-cbc + + + + + + + + + + + + + diff --git a/source/devices/J722S/linux/Release_Specific_Migration_Guide.rst b/source/devices/J722S/linux/Release_Specific_Migration_Guide.rst new file mode 100644 index 000000000..499f4a4e0 --- /dev/null +++ b/source/devices/J722S/linux/Release_Specific_Migration_Guide.rst @@ -0,0 +1,40 @@ +.. http://processors.wiki.ti.com/index.php/Processor_SDK_Linux_Migration_Guide + +************************************ +Processor SDK Linux Migration Guide +************************************ + +.. rubric:: Overview + +This page covers migration information for applications built on top +of the Processor SDK for Linux. + +Processor SDK 11.xx Releases +============================ + +Processor SDK Jacinto 11.02 +--------------------------- +- This is the Third release in the 2025 LTS stream with 6.12 kernel, 2025.01 U-Boot and Yocto scarthgap/5.0 +- ATF v2.13.0+ +- OPTEE 4.7.0 +- Yocto Scarthgap/5.0 +- Platforms Supported : J721E, J7200, J721S2, J784S4, J722S, J742S2 + +Processor SDK Jacinto 11.01 +--------------------------- +- This is the Second release in the 2025 LTS stream with 6.12 kernel, 2025.01 U-Boot and Yocto scarthgap/5.0 +- ATF v2.13.0+ +- OPTEE 4.6.0 +- Yocto Scarthgap/5.0 +- Platforms Supported : J721E, J7200, J721S2, J784S4, AM68, AM69, J722S, J742S2 + +.. note:: + + - For U-Boot builds, k3-image-gen and core-secdev-k3 are no longer needed + as **binman** is used instead. Please refer to :ref:`U-Boot build + instructions` for the updated steps. + + - For Linux builds, generic ``defconfig`` is used instead of custom + fragments. Please refer to `linux users guide + <../../../linux/Foundational_Components_Kernel_Users_Guide.html#preparing-to-build>`__ + for build instructions. diff --git a/source/devices/J722S/linux/Release_Specific_Release_Notes.rst b/source/devices/J722S/linux/Release_Specific_Release_Notes.rst new file mode 100644 index 000000000..aaf2e16f2 --- /dev/null +++ b/source/devices/J722S/linux/Release_Specific_Release_Notes.rst @@ -0,0 +1,539 @@ +.. _release-specific-release-notes: + +************************************ +Release Notes +************************************ +.. http://processors.wiki.ti.com/index.php/Processor_SDK_Linux_Release_Notes + +Overview +======== + +The **Processor Software Development Kit (Processor-SDK) for Linux** +provides a fundamental software platform for development, deployment and +execution of Linux based applications and includes the following: + +- Bootloaders, Linux Kernel & Filesystem +- SDK installer & Prebuilt Binaries +- Setup scripts +- Demo applications +- Documentation + +.. ifconfig:: CONFIG_sdk in ('JACINTO') + + .. Note:: + For building some of the RTOS-based demonstrations, you should also download + Processor SDK RTOS installer. For more information, + refer to /index.html. + + +Licensing +========= + +Please refer to the software manifest, which outlines the licensing +status for all packages included in this release. The manifest can be found on the SDK +download page or in the installed directory as indicated below. In +addition, see :ref:`Processor SDK Linux GPLv3 Disclaimer `. + + +Documentation +============= +- :ref:`Processor SDK Linux Software Developer's Guide `: Provides information on features, functions, delivery package and, + compile tools for the Processor SDK Linux release. This also provides + detailed information regarding software elements and software + infrastructure to allow developers to start creating applications. +- :ref:`Processor SDK Linux Getting Started Guide `: Provides information on getting the software and running + examples/demonstrations bundled in the SDK. +- **Software Manifest**: Provides license information on software + included in the SDK release. This document is in the release at + ``[INSTALL-DIR]/manifest``. +- **EVM Quick Start Guide**: Provides information on hardware setup and + running the demonstration application that is loaded on flash. This + document is provided as part of the EVM kit. + + +Supported Platforms +=================== +See :ref:`here ` for a list of supported platforms and links to more information. + + +Release 11.02.00 +================ + +Released Dec 2025 + +.. rubric:: What's New + :name: whats-new + +Processor SDK 11.02 Release supports the following platforms: + + * J721E + * J7200 + * J721S2 + * J784S4 + * J722S + * J742S2 + +Processor SDK 11.02 Release has following new features: + + * Third 2025 LTS (Linux 6.12 and u-boot 2025.01) + * ATF v2.13.0+ + * OPTEE 4.7.0 + * Yocto Scarthgap/5.0 + * Low power mode support for J784S4 and J7200 + * Temperature based refresh rate change for DDR + * Crypto: Add AES-CMAC algorithm support in SA2UL driver + * Added support for McASP async mode: independent transmit (playback) and receive (capture) clocking + +.. _release-specific-build-information: + +Build Information +================= + +U-Boot +------ +| Head Commit: 19795f63be7ee27e38b6e800ff6c88a2feaae13f: TI: dts: upstream: arm64: ti: Sync dtbs from ti-linux sha c52c5589aab8 +| Date: Thu Apr 16 13:13:43 2026 +0530 +| uBoot Version: 2025.01 +| uBoot Description: 11.02.13 + +| Repo: git://git.ti.com/ti-u-boot/ti-u-boot.git +| Branch: ti-u-boot-2025.01 +| uBoot Tag: 11.02.13 + +| Compiler Information: arm-oe-eabi-gcc (GCC) 13.4.0, aarch64-oe-linux-gcc (GCC) 13.4.0 +| + +.. ifconfig:: CONFIG_image_type in ('edgeai', 'adas') + + .. note:: + + meta-edgeai Yocto layer contains additional patches for U-Boot `here `__. + +.. _kernel-release-notes: + +Kernel +------ +.. rubric:: Linux Kernel + :name: linux-kernel + +| Head Commit: c52c5589aab8c376f975b1feb7b8746b7b6624bd: TI: arm64: dts: ti: k3-j722s-evm-fpdlink-iv-fusion: Add explicit pinctrl for UB9702 reset GPIO +| Date: Thu Apr 16 11:38:50 2026 +0530 +| Kernel Version: 6.12.57 +| Kernel Description: 11.02.13 + +| Repo: git://git.ti.com/ti-linux-kernel/ti-linux-kernel.git +| Branch: ti-linux-6.12.y +| Tag: 11.02.13 +| Non-RT Kernel defconfig: defconfig + ti_arm64_prune.config +| RT Kernel defconfig: defconfig + ti_rt.config + ti_arm64_prune.config + +| Compiler Information: aarch64-oe-linux-gcc (GCC) 13.4.0, GNU ld (GNU Binutils) 2.42.0 +| + + +.. ifconfig:: CONFIG_image_type in ('edgeai', 'adas') + + .. note:: + + meta-edgeai Yocto layer contains additional patches for Kernel `here `__. + +TF-A +---- +| Head Commit: e0c4d3903b382bf34f552af53e6d955fae5283ab: Merge changes from topic "xlnx_fix_gen_con_datatype" into integration +| Date : Tue Jul 1 07:01:36 2025 +0000 +| Version: 2.13 + +| Repo: https://github.com/ARM-software/arm-trusted-firmware +| Branch: master +| + +.. note:: + + meta-ti Yocto layer contains additional patches for TF-A `here `__. + +OP-TEE +------ +| Head Commit: a9690ae39995af36a31b7a4f446f27ea0787e3a4: plat-k3: drivers: Add TRNG driver support in AM62L +| Date : Fri Aug 1 15:40:58 2025 +0530 +| Version: 4.7.0 + +| Repo: https://github.com/OP-TEE/optee_os/ +| Branch: master +| Tag: 4.7.0 +| + +.. note:: + + meta-ti Yocto layer contains additional patches for OP-TEE `here `__. + +ti-linux-firmware +----------------- +| Head Commit: 946606d906c6a07ff844c1e6f5451cbace08b96b: ti-ipc: j722s: update ipc binaries +| Date: Thu Apr 2 12:05:45 2026 +0530 + +| Repo: https://git.ti.com/cgit/processor-firmware/ti-linux-firmware +| Branch: ti-linux-firmware +| Tag: 11.02.13 +| + + + +Yocto +----- +.. rubric:: meta-ti + :name: meta-ti + +| Head Commit: a444d3137a527d4a405986a5ffa143ed7dfc0961: CI/CD Auto-Merger: cicd.scarthgap.202604160814 +| Date: Thu Apr 16 08:14:28 2026 -0500 + +| Repo: https://git.ti.com/cgit/arago-project/meta-ti +| Branch: scarthgap +| Release Tag: 11.02.13 +| + +.. rubric:: meta-arago + :name: meta-arago + +| Head Commit: efba4adb406b9675641ee85ea3bce1c375ef5963: ltp-ddt: Change branch to ti-ltp-ddt_20260212 +| Date: Thu Feb 12 15:38:01 2026 -0600 + +| Repo: https://git.yoctoproject.org/meta-arago +| Branch: scarthgap +| Release Tag: 11.02.13 +| + +.. rubric:: meta-tisdk + +| Head Commit: 078b37b05e191a0e69ddbe74b402e0f1b29e6b30 tisdk-evse-image: add image recipe for EVSE OOB +| Date: Tue Dec 23 00:26:58 2025 -0600 + +| Repo: https://github.com/TexasInstruments/meta-tisdk.git +| Branch: scarthgap +| Release Tag: REL.PSDK.ANALYTICS.11.02.00.06 +| + +.. ifconfig:: CONFIG_image_type in ('edgeai', 'adas') + + .. rubric:: meta-edgeai + + | Head Commit: 7d07e25a15632494d6c30efb09d68de1c95f9394 recipes-core/packagegroup: Add yaml-cpp packagegroup + | Date: Fri Jan 23 04:50:28 2026 -0600 + + | Clone: git://git.ti.com/edgeai/meta-edgeai.git + | Branch: scarthgap + | Release Tag: REL.PSDK.ANALYTICS.11.02.00.06 + | + +Issues Tracker +============== + +Issues opened in previous releases that were closed on this release +------------------------------------------------------------------- +.. csv-table:: + :header: "Record ID", "Title", "Platform" + :widths: 15, 70, 20 + + "LCPD-45040","CICD: HWSPINLOCK_S_FUNC functional test failures","am62xxsip_sk-fs,j722s_evm-fs" + "LCPD-44980","Backport ""board: ti: common: Kconfig: add CMD_CACHE"" into TI U-Boot Tree","am62axx_sk-fs,am62axx_sk-se,am62lxx_evm-fs,am62lxx_evm-se,am62pxx_sk-fs,am62pxx_sk-se,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx_p0_sk-fs,am62xx_sk-fs,am62xx_sk-se,am62xxsip_sk-fs,am62xxsip_sk-se,am64xx-evm,am64xx-hsevm,am64xx-hssk,am64xx_evm-se,am64xx_sk-fs,am64xx_sk-se,am654x-evm,am654x-hsevm,am654x-idk,am68_sk-fs,am68_sk-se,am69_sk-fs,bbai,bbai64-gp,j7200-evm,j7200-hsevm,j721e-idk-gw,j721s2-evm,j721s2-hsevm,j722s_evm-fs,j722s_evm-se,j784s4-evm,j784s4-hsevm" + "LCPD-44855","j722s_evm-fs: RC-08: Failure: Core SDK Linux shall include performance documenta...","j722s_evm-fs" + "LCPD-44655","J722S: DFU test case is broken in SDK 11.01 RC7","j722s_evm-fs" + "LCPD-44466","Codec: Wave5: Improve Decoder Performance and Fix SError Crash on Fluster test","am62axx_sk-fs,am62pxx_sk-fs,j721s2-evm,j722s_evm-fs,j742s2_evm-fs,j784s4-evm" + "LCPD-42572","IPC: Testscript: Sometimes U-Boot not able to find firmware from boot media after symlink update","am68_sk-fs,am69_sk-fs,j721e-idk-gw,j721s2_evm-fs,j722s_evm-fs,j742s2_evm-fs,j784s4-evm" + "LCPD-37704","J722S : i2c test failing ","j722s_evm-fs" + +| + +Issues found and closed on this release that may be applicable to prior releases +-------------------------------------------------------------------------------- +.. csv-table:: + :header: "Record ID", "Title", "Platform" + :widths: 15, 70, 20 + + "LCPD-47389","USART: Erroneous clear/trigger of timeout interrupt","j7200-evm,j7200-hsevm,j7200_evm-fs,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm" + "LCPD-47109","j784s4 HS-SE LPM support ","j784s4-evm,j784s4-hsevm" + "LCPD-46968","Linux: CPSW Proxy Client: DMA Coherency is not inherited","j7200-evm,j7200-hsevm,j7200_evm-fs,j721e-idk-gw,j742s2_evm-fs,j784s4-evm,j784s4-hsevm" + "LCPD-46928","gstreamer 1.26.9: v4l2src format negotiation fails with capsfilter constraints","am62axx_sk-fs,am62dxx_evm-fs,am62pxx_sk-fs,am62xx_lp_sk-fs,am62xx_sk-fs,am62xxsip_sk-fs,am68_sk-fs,am69_sk-fs,j721e-idk-gw,j721s2_evm-fs,j722s_evm-fs,j784s4-hsevm" + "LCPD-46401","Resolve and test the parameters passed to cppi5_trdesc_calc_size() function","am62axx_sk-fs,am62axx_sk-se,am62dxx_evm-fs,am62dxx_evm-se,am62lxx_evm-fs,am62lxx_evm-se,am62pxx-zebu,am62pxx_sk-fs,am62pxx_sk-se,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx_p0_sk-fs,am62xx_sk-fs,am62xx_sk-se,am62xxsip_sk-fs,am62xxsip_sk-se,am64xx-evm,am64xx-hsevm,am64xx-hssk,am64xx_evm-se,am64xx_sk-fs,am64xx_sk-se,am654x-evm,am654x-hsevm,am654x-idk,am68_sk-fs,am68_sk-se,am69_sk-fs,bbai64-gp,beagleplay-gp,beagleplay-gp-uart,beagley_ai,j7200-evm,j7200-hsevm,j7200_evm-fs,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm" + "LCPD-45971","Automated SDL2 testscript failures ","am62xx_sk-fs,am68_sk-fs,am69_sk-fs,j721s2-evm,j784s4-evm" + "LCPD-45962","Remotecore IPC communication is not functional after suspend-resume","j7200-evm,j784s4-evm" + "LCPD-45771","GPIO PADCONFIG Bits Changing after using gpiod userspace","am62pxx_sk-fs,am62pxx_sk-se,j722s_evm-fs,j722s_evm-se" + "LCPD-45576","Improper Timestamp Handling in Wave5 driver","am62axx_sk-fs,am62pxx_sk-fs,am68_sk-fs,am69_sk-fs,j721s2-evm,j722s_evm-fs,j742s2_evm-fs,j784s4-evm" + "LCPD-45566","OSPI : Unable to create MTD partitions","j7200-evm" + "LCPD-45554","NFS boot takes too much time due to PHY negotiation for every request","am62axx_sk-fs,am62axx_sk-se,j7200_evm-fs,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm" + "LCPD-45495"," K3CONF_SOC_PD_TEST fail","am62axx_sk-fs,am62dxx_evm-fs,am62xx_lp_sk-fs,am62xx_sk-fs,am68_sk-fs,am69_sk-fs,j7200_evm-fs,j721e-idk-gw,j721s2-evm" + "LCPD-45439","Linux: J784S4 PCIe Endpoint DMA Throughput is low","j784s4-evm,j784s4-hsevm" + "LCPD-45421","UFS within U-Boot fails to set bRefClkFreq","j784s4-evm" + "LCPD-45420","U-Boot: J784S4: Unexpected MAIN CPSW2G probe and error at U-Boot prompt","j784s4-evm,j784s4-hsevm" + "LCPD-45386","ltp-ddt: ltp result file not found ","am62pxx_sk-fs,am68_sk-fs,j721s2-evm" + "LCPD-45257","MK-Image tool packaged in U-boot increasing size of u-boot.img ","j721e-hsevm,j721s2_evm-se,j722s_evm-se,j784s4-hsevm" + +| + +Errata Workarounds Available in this Release +-------------------------------------------- +.. csv-table:: + :header: "Record ID", "Title", "Platform", "ErrataId" + :widths: 15, 30, 70, 60 + + "LCPD-47389","USART: Erroneous clear/trigger of timeout interrupt","j7200-evm,j7200-hsevm,j7200_evm-fs,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm","i2310" + "LCPD-44174","Add workaround for SE in C7x boot sequence","j721s2-evm,j784s4-evm","i2437" + "LCPD-32351","MMCSD: HS200 and SDR104 Command Timeout Window Too Small","am62axx_sk-fs,am62axx_sk-se,am62pxx_sk-fs,am62pxx_sk-se,am62xx-sk,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx_sk-fs,am62xx_sk-se,am62xxsip_sk-fs,am62xxsip_sk-se,am64xx-hsevm,am68_sk-fs,am69_sk-fs,j7200-evm,j721e-idk-gw,j721s2-evm,j722s_evm-fs,j742s2_evm-fs,j784s4-evm","i2312" + "LCPD-29297","PCIe: Timing requirement for disabling output refclk during L1.2 substate is not met","j7200-evm,j7200-hsevm,j7200_evm-fs,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se","i2243" + "LCPD-27886","USART: Erroneous clear/trigger of timeout interrupt","am62axx_sk-fs,am62xx-sk,am62xxsip_sk-fs,am62xxsip_sk-se,am64xx-evm,j7200-evm,j721e-idk-gw,j784s4-evm,j784s4-hsevm","i2310" + "LCPD-22926","PCIe: The SerDes PCIe Reference Clock Output can exceed the 5.0 GT/s Data Rate RMS jitter limit","j7200-hsevm,j7200_evm-fs","i2241" + "LCPD-22925","PCIe: SerDes Reference Clock Output does not comply to Vcross, Rise-Fall Matching, and Edge Rate limits","j7200-evm,j7200-hsevm,j7200_evm-fs,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se","i2237" + "LCPD-22905","UDMA: TR15 hangs if ICNT0 is less than 64 bytes","am654x-evm,j721e-idk-gw","i2234" + "LCPD-22750","MSMC: Set-hazarding logic withholding RT access waiting on NRT access completion","j7200-evm,j721e-idk-gw","i2116" + "LCPD-22544","DDR: LPDDR4 should be configured to 2666 MT/S","j7200-evm","i2186" + "LCPD-19965","OSPI PHY Controller Bug Affecting Read Transactions","am64xx-evm,am654x-idk,j7200-evm,j721e-idk-gw","i2189" + "LCPD-19047","USB: Race condition while reading TRB from system memory in device mode","j721e-evm,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw","i2067" + "LCPD-17220","U-Boot Hyperbus: Hyperflash reads limited to 125MHz max. frequency","j721e-idk-gw","i2088" + "LCPD-16605","MMC: MMC1/2 Speed Issue","j721e-evm,j721e-evm-ivi,j721e-idk-gw","i2090" + +| + +U-Boot Known Issues +------------------- +.. csv-table:: + :header: "Record ID", "Title", "Platform", "Workaround" + :widths: 15, 30, 70, 30 + + "LCPD-44857","j722s_evm-fs","j722s_evm-fs: RC-08: Failure: UBOOT : MSC boot shall be supported","" + +| + +Linux Known Issues +------------------ +.. csv-table:: + :header: "Record ID", "Title", "Platform", "Workaround" + :widths: 5, 10, 70, 35 + + "LCPD-47654","DDR: Valid VRef range must be defined during LPDDR4 Command Bus Training","j7200-evm,j7200-hsevm,j721e-idk-gw,j721s2-hsevm,j721s2_evm-fs,j722s_evm-fs,j722s_evm-se,j784s4-evm,j784s4-hsevm","" + "LCPD-47605","k3conf tool does not show k3conf ddrbw","j722s_evm-fs","" + "LCPD-47393","DWC3 USB should not be configured as a wakeup source by default","j722s_evm-fs,j722s_evm-se","" + "LCPD-47381","MCAN: Message Transmit order not guaranteed from dedicated Tx Buffers configured with same Message ID","j7200-evm,j7200-hsevm,j7200_evm-fs,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm","Workaround #1: + After writing the Tx messages with same Message ID to the Message RAM, request transmission of all these message concurrently by single write access to TXBAR. Make sure none of these messages have a pending Tx request before making the concurrent request. + + Workaround #2: + Use the Tx FIFO instead of dedicated Tx Buffers (set bit MCAN_TXBC[30] TFQM = 0 to use Tx FIFO) for the transmission of several messages with the same Message ID in a specific order." + "LCPD-46418","Crypto: cbc and ecb sa2ul self tests fails on few platforms","am62axx_sk-fs,am62pxx_sk-fs,j722s_evm-fs","" + "LCPD-46190","j722s_evm-fs: RC-08: TESTGAP: Linux SDK: CPSW: Native XDP Support + zero copy su...","j722s_evm-fs","" + "LCPD-46120","cpuloadgen testcase fails to run on all cores","j7200-evm,j721e-idk-gw,j721s2-evm,j722s_evm-fs,j742s2_evm-fs,j784s4-evm","" + "LCPD-45969","J722S: Changing DPHY parent refclk breaks USB","am62pxx_sk-fs,j722s_evm-fs","" + "LCPD-45903","J722s/AM67 & AM62P: eDP random display init failure","am62pxx_sk-fs,j722s_evm-fs,j722s_evm-se","" + "LCPD-45902","J722s/AM67 & AM62P: eDP HPD failure","am62pxx_sk-fs,j722s_evm-fs,j722s_evm-se","" + "LCPD-45253","c7x ipc failure on linux loading remote core firmwares","j722s_evm-fs","" + "LCPD-45239","VTM module sensor reset sequence modification for reliable functionality ","am62axx_sk-fs,am62axx_sk-se,am62dxx_evm-fs,am62dxx_evm-se,am62lxx_evm-fs,am62lxx_evm-se,am62pxx-zebu,am62pxx_sk-fs,am62pxx_sk-se,am62xx_lp_sk-fs,am62xx_lp_sk-se,am62xx_p0_sk-fs,am62xx_sk-fs,am62xx_sk-se,am62xxsip_sk-fs,am62xxsip_sk-se,am64xx-evm,am64xx-hsevm,am64xx-hssk,am64xx_evm-se,am64xx_sk-fs,am64xx_sk-se,am654x-evm,am654x-hsevm,am654x-idk,am68_sk-fs,am68_sk-se,am69_sk-fs,j7200-evm,j7200-hsevm,j7200_evm-fs,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm","" + "LCPD-44854","Test: Ethernet slave peripheral boot failure","am62pxx_sk-fs,am62xx_lp_sk-fs,am62xx_sk-fs,am69_sk-fs,j722s_evm-fs","" + "LCPD-44505","WDT_RTI: Make the watchdog timeout configurable","j722s_evm-fs,j722s_evm-se","" + "LCPD-44298","J722s: MAIN_I2C4 device tree node is missing","j722s_evm-fs,j722s_evm-se","" + "LCPD-43480","USB : Selective suspend to RAM test is failing","am68_sk-fs,am69_sk-fs,j7200-evm,j721e-idk-gw,j721s2_evm-fs,j722s_evm-fs,j742s2_evm-fs,j784s4-evm","" + "LCPD-43407","IPC Graceful Shutdown on C7x cores","j721e-idk-gw,j721s2-evm,j722s_evm-fs,j784s4-evm","" + "LCPD-43304","CSI RX driver does not consider byterperline parameter in set format","am62axx_sk-fs,am62axx_sk-se,j721e-evm-ivi,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm","" + "LCPD-42843","remoteproc/k3-dsp: PDK IPC echo test binaries fails to do IPC in remoteproc mode on second run","j7200-evm,j721e-idk-gw,j721s2-evm,j722s_evm-fs,j784s4-evm","" + "LCPD-41066","CSI outputs black images when DMA is set to ASEL 15","am62pxx_sk-fs,j722s_evm-fs","" + "LCPD-41044","ARM toolchain used in Yocto build keeps on updating every release","am62axx_sk-fs,am62axx_sk-se,am68_sk-fs,am68_sk-se,am69_sk-fs,j721e-evm-ivi,j721e-hsevm,j721e-idk-gw,j721e-sk,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j742s2_evm-fs,j784s4-evm,j784s4-hsevm","" + "LCPD-38311","Power off test case failing","j7200-evm,j721e-idk-gw,j721s2-evm,j722s_evm-fs,j742s2_evm-fs,j784s4-evm","" + "LCPD-38267","J722S: tiboot3.bin / R5 SPL within size limit fails to boot","j722s_evm-fs","" + "LCPD-37705","crypto perf failure ","am68_sk-fs,j7200-evm,j722s_evm-fs","" + "LCPD-37702","J722S : Crypto perf (ipsec) test failed ","j722s_evm-fs","" + "LCPD-37314","NFS in UBOOT on J722S EVM (HS-FS) Fails","j722s_evm-fs","" + "LCPD-34712","OSPI: 2-byte address is not supported in PHY DDR mode","j7200-evm,j721e-idk-gw,j721s2-evm,j721s2-hsevm,j721s2_evm-fs,j721s2_evm-se,j722s_evm-fs,j722s_evm-se,j742s2_evm-fs,j784s4-evm,j784s4-hsevm","For compatible OSPI memories that have programmable address byte settings, set the amount of address bytes required from 2 to 4 on the flash. This may involve sending a specific command to change address bytes and/or writing a configuration register on the flash. Once done, update the amount of address bytes sent in the controller settings from 2 to 4.  + + For compatible OSPI memories that only support 2-byte addressing and cannot be re-programmed, PHY DDR mode will not be compatible with that memory. Alternative modes include: + + PHY SDR mode + TAP (no-PHY) DDR mode + TAP (no-PHY) SDR mode" + "LCPD-24654","MCAN: Implement workaround for errata i2279","j7200-evm,j721e-idk-gw,j721s2-evm,j722s_evm-fs,j742s2_evm-fs,j784s4-evm","" + + +| + +Issues closed in system firmware in this release +------------------------------------------------- + +System firmware Known Issues +------------------------------ + +Change Requests +=============== + +SDK features descoped from 11.02 (J722s) release +------------------------------------------------ +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-9373, "Scope Change for LPM Support on J722S", "J722S", 11.02.00, 12.02.00 + +SDK features descoped from 11.02 release +---------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-9115, "Linux DSS driver to support frame freeze detect", "All J7 Platforms", 11.02.00, "Dropped" + JACINTOREQ-8931, "J784S4 firewalling support", "J784S4,J742S2", 11.02.00, "Future Release" + JACINTOREQ-9146, "Low power support on HS-SE/J784S4, R5 as suspend master", "J784S4,J7200", 11.02.00, 11.02.01 + +SDK features descoped from 11.01 release +---------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-7915, "J7: Support for Kexec/Kdump in Linux", "All J7 Platforms", 11.01.00, 12.00.00 + JACINTOREQ-7596, "[Linux]: Support for Headless display using QT", "J722S,J7ES,J784S4,J721S2", 11.01.00, "Future Release" + +SDK features descoped from 11.00 release +---------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-3987, "Linux SDK shall support ADC: 12-bit, 4MSPS analog to digital converter", "J784S4", 11.00.00, Descoped + JACINTOREQ-5770, "U-Boot: support remoteproc load of HSM M4F core", "J722S", 11.00.00, 11.01.00 + +SDK features descoped from 10.01 release +---------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-5776 ,Linux Driver for GPMC - FPGA connection, "J722S", 10.01.00 , Dropped + JACINTOREQ-5138 ,"Linux SDK shall support SA2UL: HMAC using MD5, SHA1, SHA2-224, SHA2-256 and SHA2-512", "J784S4, J721E, J721S2, J7200, J722S", 10.00.00 , 11.01.00 + JACINTOREQ-5529 ,Power Management support, "J722S", 10.01.00 ,11.01.00 + +SDK features descoped from 10.00 release +---------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-7514 ,Linux SDK shall support MSMC: Security Firewall, "J784S4", 10.00.00 ,10.01.00 + JACINTOREQ-5042 ,Linux SDK shall support cpufreq [opp] DFS, "J784S4, J721E, J721S2, J7200, J722S", 10.00.00 ,Dropped + JACINTOREQ-4121 ,Support to boot MCU R5 1_1 in split mode, "J784S4, J721E, J721S2, J7200", 10.00.00 ,10.01.00 + +SDK features descoped from 9.2 release +-------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-3970 ,Linux SDK shall support MSMC: Security Firewall, "J784S4", 09.02.00 ,10.00.00 + JACINTOREQ-5042 ,AM69/J784S4 Linux SDK shall support cpufreq [opp], "AM69, J784S4", 09.02.00 ,10.00.00 + +SDK features scoped in 9.1 release +---------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-3761 ,Linux SDK shall support RTI: Watchdog support J721S2, "J721S2", 09.02.00 ,09.01.00 + JACINTOREQ-3981 ,Linux SDK shall support RTI: Watchdog support J784S4, "J784S4", 09.02.00 ,09.01.00 + +SDK features descoped from 9.1 release +-------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-3970 ,Linux SDK shall support MSMC: Security Firewall, "J784S4", 09.01.00 ,09.02.00 + JACINTOREQ-3920 ,"Linux SDK shall support SA2UL: HMAC using MD5, SHA1, SHA2-224, SHA2-256 and SHA2-512", "J784S4", 09.01.00 ,09.02.00 + +SDK features descoped from 9.0 release +-------------------------------------- +.. csv-table:: + :header: "ID", "Head Line", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-3598 ,Jacinto Device firewalling support, "J7200, J721e, J721s2, J784s4", 09.00.00 ,09.01.00 + +SDK features descoped from 8.6 release +-------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-5338 ,Jacinto PSDK 8.6 AEP/AHP industrial APL pull-in impact, "J721e, J7200, J721S2 , J784S4", 08.06.00 ,09.00.00 + + +SDK features descoped from 8.5 release +-------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-5060, Jacinto networking requirements - CR to 8.6, "J721S2, J784S4", 08.05.00, 08.06.00 + JACINTOREQ-4991, "Jacinto Baseport, Graphics, Multimedia CR to 8.6", "J721S2, J784S4", 08.05.00, 08.06.00 + JACINTOREQ-4934, CSI Capture Automated Testing for J7AEP, J721S2, 08.05.00, 08.06.00 + JACINTOREQ-4928, J7AEP Multimedia Scope Modify, J721S2, 08.05.00, 08.06.00 + JACINTOREQ-5001, Configurable Buffering Descope, J784S4, 08.05.00, None + JACINTOREQ-4993, Descope GLBenchmark, J784S4, 08.05.00, None + JACINTOREQ-4927, J7AHP Graphics Scope Modify, J784S4, 08.05.00, 08.06.00 + +SDK features scope change for 8.5 release +----------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform" + :widths: 40, 60, 60 + + JACINTOREQ-4994 , Video Codec Memory Optimization Scope Change, J721e + +SDK features descoped from 8.4 release +-------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-4930 ,k3conf Doc and Test Modify, J721e, 08.04.00 ,08.05.00 + JACINTOREQ-4905 ,J7AEP Graphics Scope Modify, J721s2, 08.04.00 ,08.05.00/08.06.00 + JACINTOREQ-4898 ,SERDES: PCIe + USB schedule update, J721s2, 08.04.00 ,08.05.00 + JACINTOREQ-4864 ,4k Resolution Scope change, J721s2, 08.04.00 ,08.05.00 + JACINTOREQ-4854 ,McASP Scope Change, J721s2, 08.04.00 ,08.05.00 + JACINTOREQ-4930 ,k3conf Doc and Test Modify, J721s2, 08.04.00 ,08.05.00 + +SDK features descoped from 8.0 release +-------------------------------------- +.. csv-table:: + :header: "ID", "Headline", "Platform", "Original Fix Version", "New Fix Version" + :widths: 20, 90, 90, 20, 20 + + JACINTOREQ-1559 ,Linux H264 decoder support, J721e, 08.00.00 ,08.01.00 + JACINTOREQ-1485 ,Linux writeback pipeline support , J721e, 08.00.00 ,None + JACINTOREQ-1444 ,Vision apps inclusion in yocto build , J721e, 08.00.00 ,None + + +SDK features present in 7.0 that were descoped in 7.1 +----------------------------------------------------- +.. csv-table:: + :header: "Feature", "Comments", "Platform" + :widths: 40, 60, 60 + + HS support,Restored in 7.3, J721e + SPL/Uboot boot modes restricted to SD card boot mode,Restored in 7.3, J721e + 1s Linux boot, , "J721e" + Descope for support of native H264 encode/decode,Use R5F based driver with OpenVX as interface. H.264 decoder support restored in 7.3, J721e + GPU compression, , J712e + SA2UL driver optimization, , J721e + Display Sharing,Display sharing demo available in SDK v6.1, J721e + Virtualization (Jailhouse hypervisor/IPC virtualization/CPSW9G virtualization),Does not affect 3P virtualization solutions. Basic Jailhouse demo can be seen in SDK 7.0, J721e + + +Installation and Usage +====================== + +The :ref:`Software Developer's Guide ` provides instructions on how to setup your Linux development environment, install the SDK and start your development. It also includes User's Guides for various Example Applications. + +| + +Host Support +============ + +For the specific supported hosts for current SDK, see :ref:`this page `. + +.. note:: + Processor SDK Installer is 64-bit, and installs only on 64-bit host machine. + +.. |reg| unicode:: U+00AE .. REGISTERED SIGN diff --git a/source/devices/J722S/linux/Release_Specific_Supported_Platforms_and_Versions.rst b/source/devices/J722S/linux/Release_Specific_Supported_Platforms_and_Versions.rst new file mode 100644 index 000000000..522ec1da8 --- /dev/null +++ b/source/devices/J722S/linux/Release_Specific_Supported_Platforms_and_Versions.rst @@ -0,0 +1,117 @@ +.. _release-specific-supported-platforms-and-versions: + +************************************ +Supported Platforms and Versions +************************************ + +.. rubric:: Supported Host Operating Systems + +The following operating systems have been validated to work with our +SDK. + +- **Linux SDK** + ++---------------------------+-------------------------+ +| **Operating System** | | **Version** | ++---------------------------+-------------------------+ +| Ubuntu | | 22.04 (64-bit) | ++---------------------------+-------------------------+ + +| + +.. rubric:: Supported Platforms and EVMs + +The following platforms and EVMs are supported with Processor SDK. + +.. ifconfig:: CONFIG_part_variant in ('J721E') + + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS ** | + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + | J721e/DRA829 | J721e EVM | Alpha | Hardware User's Guide | Y | Y | + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + | J721e/DRA829 | J721e EVM | Beta | Hardware User's Guide | Y | Y | + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + | J721e/DRA829 | J721e SK | Alpha | Hardware User's Guide | Y | | + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + +.. ifconfig:: CONFIG_part_variant in ('J7200') + + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + | J7200/DRA821 | J7200 EVM | Alpha | Hardware User's Guide | Y | Y | + +--------------+-----------+-----------+-----------------------+-------------------+------------------+ + +.. ifconfig:: CONFIG_sdk in ('j7_foundational') + + .. ifconfig:: CONFIG_part_variant in ('J721S2') + + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | AM68 | AM68 SK | Alpha | Hardware User's Guide | Y | | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + + .. ifconfig:: CONFIG_part_variant in ('J784S4') + + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | AM69 | AM69 SK | Alpha | Hardware User's Guide | Y | | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + + .. ifconfig:: CONFIG_part_variant in ('J722S') + + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | AM67 | J722S EVM | Alpha | Hardware User's Guide | Y | | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + +.. ifconfig:: CONFIG_sdk in ('JACINTO') + + .. ifconfig:: CONFIG_part_variant in ('J721S2') + + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | J721s2 | J721s2 EVM | Alpha | Hardware User's Guide | Y | Y | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | AM68A | AM68A SK | Alpha | Hardware User's Guide | Y | | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + + .. ifconfig:: CONFIG_part_variant in ('J784S4') + + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | J784s4 | J784s4 EVM | Alpha | Hardware User's Guide | Y | Y | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | AM69A | AM69A SK | Alpha | Hardware User's Guide | Y | Y | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + + .. ifconfig:: CONFIG_part_variant in ('J742S2') + + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | J742s2 | J742s2 EVM | Alpha | Hardware User's Guide | Y | Y | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + + .. ifconfig:: CONFIG_part_variant in ('J722S') + + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | **Platform** | **EVM** | **Tested | **Document** | **Processor SDK | **Processor SDK | + | | | Version** | | Linux** | RTOS** | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ + | J722S | J722S EVM | Alpha | Hardware User's Guide | Y | | + +--------------+------------+-----------+-----------------------+-------------------+------------------+ diff --git a/source/devices/J722S/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/J722S/linux/Release_Specific_Yocto_layer_Configuration.rst new file mode 100644 index 000000000..79340e8b5 --- /dev/null +++ b/source/devices/J722S/linux/Release_Specific_Yocto_layer_Configuration.rst @@ -0,0 +1,52 @@ +.. _yocto-layer-configuration: + +************************** +Yocto Layer Configuration +************************** + +.. http://processors.wiki.ti.com/index.php/Processor_SDK_Building_The_SDK#Layer_Configuration + +.. ifconfig:: CONFIG_image_type in ( 'adas', 'edgeai') + + |__SDK_FULL_NAME__| uses the 'oe-layersetup' tool to configure the meta layers. If you do not have the Linux SDK package installed: + + .. code-block:: console + + git clone https://git.ti.com/git/arago-project/oe-layersetup.git yocto-build + cd yocto-build + ./oe-layertool-setup.sh -f configs/processor-sdk-analytics/ + +.. ifconfig:: CONFIG_image_type in ('default') + + |__SDK_FULL_NAME__| uses the 'oe-layersetup' tool to configure the meta layers. If you do not have the Linux SDK package installed: + + .. code-block:: console + + git clone https://git.ti.com/git/arago-project/oe-layersetup.git yocto-build + cd yocto-build + ./oe-layertool-setup.sh -f configs/processor-sdk-linux/ + +The Linux SDK package also has the above tool cloned at the top level. If you have it installed: + +:: + + cd /yocto-build + ./oe-layertool-setup.sh -f configs/processor-sdk-/ + +Use below in place of , to setup the meta layers for the current release version. + +.. ifconfig:: CONFIG_image_type in ('default') + + +----------------------------------------------------+-------------------------------------+--------------------------------+ + | Description | Config File | Supported yocto build machine | + +====================================================+=====================================+================================+ + | |__SDK_FULL_NAME__| : 11_00 Release | processor-sdk-linux-11_00_10_01.txt | |__SDK_BUILD_MACHINE__| | + +----------------------------------------------------+-------------------------------------+--------------------------------+ + +.. ifconfig:: CONFIG_image_type in ('edgeai', 'adas') + + +----------------------------------------------------+------------------------------------------------+--------------------------------+ + | Description | Config File | Supported yocto build machine | + +====================================================+================================================+================================+ + | |__SDK_FULL_NAME__| : 11_02_00 Release | processor-sdk-analytics-11.02.00-config.txt | |__SDK_BUILD_MACHINE__| | + +----------------------------------------------------+------------------------------------------------+--------------------------------+ diff --git a/source/devices/J722S/linux/_Release_Specific_QSG.rst b/source/devices/J722S/linux/_Release_Specific_QSG.rst new file mode 100644 index 000000000..80eac0461 --- /dev/null +++ b/source/devices/J722S/linux/_Release_Specific_QSG.rst @@ -0,0 +1,93 @@ +.. rubric:: Quick Start Guide + +Thanks for your interest in |__SDK_FULL_NAME__|. +In this section, we describe the basic steps needed to start development using the SDK. + +For more detailed documentation, refer to :ref:`overview-getting-started` + +.. rubric:: Steps for SDK installation + :name: qsg-steps-for-sdk-installation + +Refer to section :ref:`download-and-install-sdk` +for instructions on running the SDK installer. + +.. rubric:: Setting up host environment + :name: qsg-setting-up-host-environment + +Once the installer is run, you can setup your host environment with a few steps. +Run the following scripts to achieve this: + +* *setup.sh* to install all host packages needed for development. + +Detailed steps are described at :ref:`run-setup-scripts` + +.. rubric:: Hardware EVM setup + :name: qsg-hardware-evm-setup + + +.. ifconfig:: CONFIG_sdk in ('JACINTO') + + .. ifconfig:: CONFIG_part_variant not in ('J784S4','J742S2') + + The J7 EVM comes with a SoM (System on Chip) based on which J7 variant is being used, + a common processor board, a PMIC and a few optional daughter cards. + + .. ifconfig:: CONFIG_part_variant in ('J784S4','J742S2') + + The |__PART_FAMILY_NAME__| EVM comes with the main |__PART_FAMILY_NAME__| EVM board, a PMIC and a few optional daughter cards. + +Detailed instructions for EVM setup with image illustration can be found at +:ref:`hardware-evm-setup`. +Refer to this to setup your EVM based on which J7 variant you are using +as well as for instructions for booting with the default card. + +The preferred way for starting SDK development is SD card boot. The section referenced above +describes pin settings to set the EVM in SD boot mode. + +.. ifconfig:: CONFIG_part_variant not in ('J7200') + + .. rubric:: Running out of the box demo + :name: qsg-running-oob-demo + + By default, the SD card comes with pre-built Linux SDK binaries flashed. + This will allow you to quickly verify the EVM functionality with just a Display Port monitor. + Insert the SD card with pre-built binaries and boot the EVM. + + .. ifconfig:: CONFIG_sdk in ('j7_foundational') + + Refer to the section :ref:`oob-demo-applications` to run the Out-of-Box demo-applications. + +.. rubric:: Flashing release binaries + :name: qsg-flashing-release-binaries + +The SDK Installer packages latest pre-built binaries and filesystem for the target. +For detailed steps on flashing these binaries on the SD card, refer to the section +:ref:`processor-sdk-linux-create-sd-card` and flash all the pre-built binaries from +the SDK release. + +You should be able to verify the same out of box demo after flashing the SD card. +This step should be used only when you want to completely overwrite the card with +release binaries. + +.. rubric:: Illustration for simple kernel build and install to target + :name: qsg-kernel-build-install-example + +For most users, an important step in development is the ability to customize +baseport software components like bootloader, Linux kernel, hypervisor, etc. +This SDK allows you to build these components and install the built binaries +for target EVM. This step allows you to verify that your host environment +is configured correctly, and you can build and install these components. + +For detailed instructions on building and installing BSP components, refer to +the section :ref:`top-level-makefile`. +After you build and copy all the binaries to your SD card, you can boot the +EVM with binaries built on your host. Upon successful bootup, you can run the +following command on the target to verify that you are using the newly-built +Linux kernel. + +:: + + $> cat /proc/version + +The output should indicate the build date, host PC name, etc. This verifies +that your SDK has been setup correctly, enabling you to start development. diff --git a/source/devices/J722S/linux/index.rst b/source/devices/J722S/linux/index.rst new file mode 100644 index 000000000..a8b02fc03 --- /dev/null +++ b/source/devices/J722S/linux/index.rst @@ -0,0 +1,38 @@ +.. _linux-index: + +********************************************** +Processor SDK Linux Software Developer's Guide +********************************************** + + +.. rubric:: Welcome to the Processor SDK Linux Software Developer's Guide for |__PART_FAMILY_DEVICE_NAMES__| + +.. include:: /linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst + +.. toctree:: + :maxdepth: 5 + :hidden: + :numbered: + + /linux/Overview + Release_Specific + /linux/Foundational_Components + /linux/index_Edge_AI + /linux/How_to_Guides + /linux/Demo_User_Guides/index_Demos + /linux/Documentation_Tarball + +| + +.. include:: /devices/J722S/linux/_Release_Specific_QSG.rst + +.. rubric:: Feedback + +If you have feedback, suggestions, or ideas on how to improve the SDK, +it is very appreciated. Please post your ideas to the Linux +forum listed at :ref:`Technical Support `. + + ++--------------------------------+---------------------------------------------------------------------------------------------------+ +| .. Image:: /images/E2e.jpg | For technical support please post your questions at `https://e2e.ti.com `__. | ++--------------------------------+---------------------------------------------------------------------------------------------------+ diff --git a/source/devices/J722S/linux/version.txt b/source/devices/J722S/linux/version.txt new file mode 100644 index 000000000..b314e2d51 --- /dev/null +++ b/source/devices/J722S/linux/version.txt @@ -0,0 +1 @@ +11_02