1 # TIOVX Build & Run Instructions {#BUILD_INSTRUCTIONS}
5 # Build instructions for x86_64 Linux Platform (HOST Emulation Mode) {#BUILD_LINUX}
8 - Tested on Ubuntu Linux x86_64 machine, v22.04 LTS
10 - Download and Run PSDK RTOS Add-on package installer file **ti-processor-sdk-rtos-${SOC}-evm-xx_xx_xx_xx-linux-x64-installer.run** on a Ubuntu 22.04 (x86_64). This package
11 contains performance datasheet documentation as well as PC compiled cmodel libraries for VPAC and DMPAC OpenVX nodes.
12 \attention The installer is available only through TI mySecure login.
13 \attention To Request access for PSDK RTOS Add-on Packages the first time: [<a href="https://www.ti.com/licreg/docs/swlicexportcontrol.tsp?form_id=276074&prod_no=PSDK-RTOS-AUTO&ref_url=adas">LINK</a>]
14 \attention mySecure SW Access Link (after access has been granted) : [<a href="https://www.ti.com/securesoftware/docs/securesoftwarehome.tsp">LINK</a>]
15 - Do below to download and install additional dependencies needed to build TIOVX
18 ./sdk_builder/scripts/setup_psdk_rtos.sh
22 - Edit sdk_builder/tools_path.mak
23 - Modify "GCC_LINUX_ROOT" to match your environment if needed
26 - Open a command prompt at $TIOVX_PATH
27 - Type "make" to build TIOVX and associated libraries
28 - This builds the TIOVX libraries, conformance tests, and tutorial executables
29 - This uses pre-built library for VXLIB, from "$TIOVX_PATH\lib\PC\x86_64\LINUX\$PROFILE\*.a"
30 - The pre-built libraries are compiled in 64bit x86 host emulation mode
31 - Conformance test, tutorial executable is output at
32 - "$TIOVX_PATH\out\PC\x86_64\LINUX\debug\vx_conformance_tests_exe"
33 - "$TIOVX_PATH\out\PC\x86_64\LINUX\debug\vx_tutorial_exe"
35 ## Running the conformance test and tutorial
36 - Open a command prompt at the folder "$TIOVX_PATH/out/PC/x86_64/LINUX/$PROFILE/"
37 - Download and untar the test_data package from the associated release page
38 - Set the environment variable below to specify the path of the test data. This is used by both
39 the conformance test and tutorial executables
41 export VX_TEST_DATA_PATH=<path_to_untarred_test_data>
43 - Execute "./vx_conformance_tests_exe" to run the conformance test
44 - Execute "./vx_tutorial_exe" to run the tutorial
45 - NOTE: Output .bmp/.png files generated by the tutorial will be present in the folder $VX_TEST_DATA_PATH
47 # Build instructions for J7 EVM Platform (Target Mode) {#BUILD_EVM}
49 - TIOVX is built for the J7 SoC as a part of the SDK Builder "make sdk" command. Please refer to the Vision Apps User Guide for more details.
53 # Makefile build options (found in Makefile and/or sdk_builder/build_flags.mak) {#BUILD_OPTIONS}
57 Build Option | Description | Default Setting |
58 -------------------------------------|-------------|-----------------|
59 PROFILE | Determines which profile to build for <BR> Valid values are: <BR> release, debug, all | all |
60 BUILD_EMULATION_MODE | Builds PC emulation mode | yes |
61 BUILD_EMULATION_ARCH | PC emulation architecture. <BR> Valid values are: X86 x86_64 all | x86_64 |
62 BUILD_TARGET_MODE | Builds for target SoC platform like TDAxx | yes |
63 BUILD_CONFORMANCE_TEST | Builds entire test suite executable | yes |
64 BUILD_IVISION_KERNELS | Builds iVision kernels (EVE_SW_PATH required to be set for this build) | no |
65 BUILD_BAM | Builds DMA wrapper (DMAUTILS_PATH and ALGFRAMEWORK_PATH required to be set for this build) | no |
66 BUILD_TUTORIAL | Builds OpenVX tutorial | yes |
67 BUILD_LINUX_MPU | Builds for A72 Linux target (NOT used in PC HOST emulation mode | yes |
68 BUILD_EVE | Builds for EVE platform (ARP32CGT_ROOT and EVE_SW_PATH required to be set for this build) | no |
69 BUILD_SDK | Builds for SDK SW platform <BR> Valid values are, <BR> psdkra for Processor SDK RTOS J7 platform | psdkra |
70 BUILD_IGNORE_LIB_ORDER | When set to yes, it ignores the static library order listed in makefiles when building on the PC. | yes |
71 BUILD_CT_KHR | Builds and includes the Khronos OpenVX 1.1 conformance tests suite. | yes |
72 BUILD_CT_TIOVX | Builds and includes the TI-added tests suite (for TI extensions and additional rohbustness testing). | yes |
73 BUILD_CT_TIOVX_TEST_KERNELS | Builds and includes the TI-added tests suite (for testing custom kernel interface). | yes |
74 BUILD_CT_TIOVX_IVISION | Builds and includes the tests for IVISION kernels test suite. | no |
75 BUILD_CT_TIOVX_TIDL | Builds and includes the tests for TIDL kernel test suite. | yes |
76 BUILD_CT_TIOVX_HWA | Builds and includes the tests for HWA kernels test suite. | yes |
77 BUILD_CT_TIOVX_HWA_NEGATIVE_TESTS | Builds and includes a large set of negative tests for HWA kernels | yes |
78 BUILD_CT_TIOVX_HWA_DISPLAY_TESTS | Builds and includes display test cases <BR> Note: in order to run on J7 platform, a display must be connected | no |
79 BUILD_CT_TIOVX_HWA_CAPTURE_TESTS | Builds and includes a large set of negative tests for HWA kernels <BR> Note: in order to run on J7 platform, 4 IMX390 cameras must be connected to a Fusion board which is connected to the EVM| no |
80 BUILD_CT_TIOVX_HWA_CSITX_TESTS | Builds and includes csitx test cases <BR> Note: in order to run on J7 platform, the following setup is required: <ul><li> EVM Board Configuration: By default DPHY is connected to FPD Panel (DSI-TX), it has to be changed to DSI FPC(CSI-TX). </li><li> J7X LI(Leopard Imaging) Serial Capture Board </li><li> FPC Cable: Connect Csitx to Csirx. </li></ul> This test uses CSIRX to receive the data transmitted by CSITX, hence lane speed for both modules should be same. This tests confgiures the CSITX lane speed to 800 Mbps.| no |
84 # Deleting all generated files {#BUILD_CLEAN}
86 - To do a clean build, do "make clean"
87 - To manually delete generated files do below