Updates for backward compatible release 11_01_07_00

Signed-off-by: Abhay Chirania <a-chirania@ti.com>

Author: abhaychirania2411

docs/update_target.md

@@ -48,6 +48,43 @@ cd ../
 - Compile the models on X86_PC using the latest tidl-tools and copy over the artifacts to target device file system at ./edgeai-tidl-tools/
 - Execute below to run inference on target device with both Python and CPP APIs
 
+```
+# scp -r <pc>/edgeai-tidl-tools/model-artifacts/  <dev board>/edgeai-tidl-tool/
+# scp -r <pc>/edgeai-tidl-tools/models/  <dev board>/edgeai-tidl-tool/
+python3 ./scripts/gen_test_report.py
+```
+- The execution of above step will generate output images at ```./edgeai-tidl-tools/output_images```.
+
+## SDK 9.2
+### Example usage for updating OSRT components and C7x firmwares
+**Run the following on target device** 
+> **_NOTE:_**
+> Backward compatibility for 9.2 SDK is only available for AM69A ADAS SDK
+
+```
+export SDK_VERSION=9_2
+export SOC=am69a
+export TISDK_IMAGE=adas
+./update_target.sh
+```
+
+> **_NOTE:_**
+> Make sure you reboot the EVM after the update for the new firmware to be loaded
+
+### Compilation and validation
+- Once the setup is done, follow the steps below to build CPP application on EVM
+
+**Run the following on target device** 
+```
+mkdir build
+cd build
+cmake ../examples -DENABLE_SDK_9_2_COMPATIBILITY=1
+make -j2
+cd ../
+```
+- Compile the models on X86_PC using the latest tidl-tools and copy over the artifacts to target device file system at ./edgeai-tidl-tools/
+- Execute below to run inference on target device with both Python and CPP APIs
+
 ```
 # scp -r <pc>/edgeai-tidl-tools/model-artifacts/  <dev board>/edgeai-tidl-tool/
 # scp -r <pc>/edgeai-tidl-tools/models/  <dev board>/edgeai-tidl-tool/

docs/version_compatibility_table.md

@@ -13,6 +13,7 @@
 
 |EdgeAI TIDL Tools Version       |           Notes |           AM62A |          AM68A/J721S2 (TDA4AL, TDA4VL) |          AM68PA/J721E (TDA4VM)|          AM69A/J784S4(TDA4AP, TDA4VP,TDA4AH, TDA4VH)| AM67A (J722S)|          AM62|
 | ---------------------------- |:--------------:|:---------------:|:--------------:|:--------------:|:-------------:|:-------------:|:-------------:|
+|  11_01_07_00                  | This release is backward compatible with SDK 11.0 for all targets except AM62A and AM62. The firmware and libraries can be directly updated on the target by following the steps [here](./update_target.md)    |   NOT AVAILABLE | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   |   Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06  | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   |    NOT AVAILABLE|
 |  11_01_06_00                  |     |   Processor SDK LINUX: 11.01.07.05 | Processor SDK LINUX 11.01.00.03<br /> Processor SDK RTOS 11.01.00.04   |   Processor SDK LINUX 11.01.00.03<br /> Processor SDK RTOS 11.01.00.04  |Processor SDK LINUX 11.01.00.03<br /> Processor SDK RTOS 11.01.00.04   | Processor SDK LINUX 11.01.00.03<br /> Processor SDK RTOS 11.01.00.04   |    11_01_05_03 |
 |  11_01_05_00 | This release is backward compatible with SDK 11.0 for all targets except AM62A and AM62. The firmware and libraries can be directly updated on the target checking out to tag **11_01_05_00** and following the steps in **docs/update_target.md**      |   NOT AVAILABLE | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   |   Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06  | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   |    NOT AVAILABLE|
 |  11_00_08_00                  |   An additional C7x firmware patch is needed to leverage some additional features mentioned as part of the release notes. The firmware and libraries can be directly updated on the target by following the steps [here](update_target.md). Make sure that models are compiled with the appropriate [c7x_firmware_version](../examples/osrt_python/README.md#advanced-miscellaneous-options) compilation option (Set to 11_00_08_00)  |     NOT AVAILABLE | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   |   Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06  | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   | Processor SDK LINUX 11.00.00.08<br /> Processor SDK RTOS 11.00.00.06   |    NOT AVAILABLE|

examples/osrt_python/README.md

@@ -227,7 +227,7 @@ Please refer [Quantization](../../docs/tidl_fsg_quantization.md) for more detail
 | advanced_options:high_resolution_optimization    | This option enables performance optimization for high resolution models  | 0 - disable, <br> 1 enable    | 0       | Model compilation | |
 | advanced_options:add_data_convert_ops   | This option embeds input and output format conversions (layout, data type, etc.) as part of model and performs the same in DSP instead of ARM    | 0 - disable, <br> 1 - Input format conversion <br> 2 - output format conversion <br> 3 - Input and output format conversion |    0      | Model compilation | This is currently an experimental feature |
 | advanced_options:network_name   | This option allows the user to set the network name (used for the name of the subgraph being delegated to C7x/MMA). If your model contains a network name, it will get used by default    | String |    "Subgraph"      | Model compilation |  |
-| advanced_options:c7x_firmware_version   |  Refer to [**Release version convention**](../../docs/version_compatibility_table.md). In case you are using firmware released as part of processor SDK RTOS, this field can be ignored. If you are using TIDL firmware release with a new patch release of the same "release line" then it is essential to use c7x_firmware_version explicitly      | String |    "11_01_06_00"      | Model compilation | Possible values are "11_01_06_00"   |
+| advanced_options:c7x_firmware_version   |  Refer to [**Release version convention**](../../docs/version_compatibility_table.md). In case you are using firmware released as part of processor SDK RTOS, this field can be ignored. If you are using TIDL firmware release with a new patch release of the same "release line" then it is essential to use c7x_firmware_version explicitly      | String |    "11_01_07_00"      | Model compilation | Possible values are "11_01_07_00"   |
 | advanced_options:partial_init_during_compile   | This option allows the user to enable partial initialization of handles during model compilation to reduce the runtime initialization time | 0 -  disable, 1 - enable | 0 | Model compilation | - |
 | advanced_options:batch_mode   | This option allows the user to enable batch stitching | 0 - disable, 1 - enable | 0 | Model compilation | - |
 | advanced_options:log_file_name   | This option allows the user to redirect the output logs to a file | String | "" | Model compilation |  |

setup.sh

@@ -75,7 +75,7 @@ cp_osrt_lib()
 
 
 SCRIPTDIR=`pwd`
-REL=11_01_06_00
+REL=11_01_07_00
 skip_cpp_deps=0
 skip_arm_gcc_download=0
 skip_x86_python_install=0

update_target.sh

@@ -32,7 +32,7 @@
 SCRIPTDIR=`pwd`
 TARGET_FS_PATH=/
 
-REL="11_01_06_00"
+REL="11_01_07_00"
 SOC=${SOC:-'null'}
 TISDK_IMAGE=${TISDK_IMAGE:-'null'}
 SDK_VERSION=${SDK_VERSION:-'null'}
@@ -54,7 +54,7 @@ if [ `arch` != "aarch64" ]; then
 fi
 
 verify_env() {
-    if [ "$REL" != "11_01_05_00" ]; then
+    if [ "$REL" != "11_01_07_00" ]; then
         echo "Cannot invoke this script with version $REL. This is not a backward compatible release."
     fi
 
@@ -82,13 +82,21 @@ verify_env() {
         return 1
     fi
 
-    if [ "$SDK_VERSION" != "11_0" ]; then
+    if [ "$SDK_VERSION" != "11_0" ] && [ "$SDK_VERSION" != "9_2" ]; then
         echo
         echo "Incorrect SDK_VERSION defined: $SDK_VERSION"
-        echo "Allowed values for SDK_VERSION is 11_0"
+        echo "Allowed values for SDK_VERSION is 11_0 or 9_2"
         return 1
     fi
 
+    if [ "$SDK_VERSION" == "9_2" ] && [ "$UPDATE_FIRMWARE_AND_LIB" == "1" ]; then
+        if [ "$SOC" != "am69a" ] || [ "$TISDK_IMAGE" != "adas" ]; then
+            echo
+            echo "Backward compatibility for 9.2 SDK is only enabled for AM69A ADAS IMAGES"
+            return 1
+        fi
+    fi
+
     if [ "$SOC" == "am62a" ] && [ "$TISDK_IMAGE" == "adas" ]; then
         echo
         echo "AM62A does not have ADAS Image. Using EDGEAI"
@@ -115,9 +123,11 @@ update_osrt_components() {
     # Updating DLR
     cd $TARGET_FS_PATH/$HOME/arago_j7_pywhl
 
-    echo "==================== Updating dlr runtime wheel ===================="
-    wget --proxy off https://software-dl.ti.com/jacinto7/esd/tidl-tools/$REL/OSRT_TOOLS/ARM_LINUX/ARAGO/$SDK_VERSION/dlr-1.13.0-py3-none-any.whl
-    pip3 install --upgrade --force-reinstall dlr-1.13.0-py3-none-any.whl --disable-pip-version-check
+    if [ "$SDK_VERSION" != "9_2" ]; then
+        echo "==================== Updating dlr runtime wheel ===================="
+        wget --proxy off https://software-dl.ti.com/jacinto7/esd/tidl-tools/$REL/OSRT_TOOLS/ARM_LINUX/ARAGO/$SDK_VERSION/dlr-1.13.0-py3-none-any.whl
+        pip3 install --upgrade --force-reinstall dlr-1.13.0-py3-none-any.whl --disable-pip-version-check
+    fi
 
     echo "==================== Updating arm-tidl headers ===================="
     cd $TARGET_FS_PATH/$HOME/required_libs
@@ -143,8 +153,13 @@ update_osrt_components() {
 
     echo "==================== Updating onnxruntime wheel ===================="
 
-    onnx_wheel=onnxruntime_tidl-1.15.0-cp312-cp312-linux_aarch64.whl
-    onnx_tar=onnx_1.15.0_aragoj7
+    if [ "$SDK_VERSION" == "9_2" ]; then
+        onnx_wheel=onnxruntime_tidl-1.15.0-cp310-cp310-linux_aarch64.whl
+        onnx_tar=onnx_1.15.0_aragoj7_cp310
+    else
+        onnx_wheel=onnxruntime_tidl-1.15.0-cp312-cp312-linux_aarch64.whl
+        onnx_tar=onnx_1.15.0_aragoj7
+    fi
 
     wget --proxy off https://software-dl.ti.com/jacinto7/esd/tidl-tools/$REL/OSRT_TOOLS/ARM_LINUX/ARAGO/$SDK_VERSION/$onnx_wheel
     pip3 install $onnx_wheel --disable-pip-version-check
@@ -179,7 +194,11 @@ update_osrt_components() {
 
     echo "==================== Updating tflite wheel ===================="
 
-    tfl_wheel=tflite_runtime-2.12.0-cp312-cp312-linux_aarch64.whl
+    if [ "$SDK_VERSION" == "9_2" ]; then
+        tfl_wheel=tflite_runtime-2.12.0-cp310-cp310-linux_aarch64.whl
+    else
+        tfl_wheel=tflite_runtime-2.12.0-cp312-cp312-linux_aarch64.whl
+    fi
 
     wget --proxy off https://software-dl.ti.com/jacinto7/esd/tidl-tools/$REL/OSRT_TOOLS/ARM_LINUX/ARAGO/$SDK_VERSION/$tfl_wheel
     pip3 install --upgrade --force-reinstall $tfl_wheel --disable-pip-version-check