Skip to content

Latest commit

 

History

History
79 lines (52 loc) · 3.1 KB

advanced_setup.md

File metadata and controls

79 lines (52 loc) · 3.1 KB

Advanced Setup

Docker based setup for X86_PC

The following environment variables must be exported to configure the docker based setup (export ENV_VAR:Option):

No Environment Variable Default Available Options Notes
1 SOC Unset am62a, am67a, am68a, am69a, am68pa Must be set to the appropriate device
2 TIDL_TOOLS_TYPE Unset Unset, GPU Setting TIDL_TOOLS_TYPE=GPU sets up the docker image for tidl tools built with OpenACC based acceleration
GPU tools require a NVIDIA GPU with CUDA Support [^1]
3 REPO_LOCATION Unset ANY Repo location for pulling docker image
4 PROXY Unset ANY PROXY to be used

Steps to build and run the docker image:

  1. Clone Github repo

     user@pc:~$ git clone https://github.com/TexasInstruments/edgeai-tidl-tools.git
     user@pc:~/edgeai-tidl-tools$ cd edgeai-tidl-tools
     user@pc:~/edgeai-tidl-tools$ git checkout <TAG Compatible with your SDK version>
    
  2. One time setup for Docker:

     user@pc:~/edgeai-tidl-tools$ source ./scripts/docker/setup_docker.sh
    
  3. Build the docker image:

     user@pc:~/edgeai-tidl-tools$ source ./scripts/docker/build_docker.sh
    
  4. Run the docker image:

       user@pc:~/edgeai-tidl-tools$ source ./scripts/docker/run_docker.sh
    
  5. After running the docker container, run the setup script:

     root@container:/home/root$ export SOC=<Your SOC name>
     root@container:/home/root$ export TIDL_TOOLS_TYPE=<Your Tools Type (CPU|GPU)>
     root@container:/home/root$ source ./setup.sh
    

    NOTE: The setup scripts need to be run everytime user re-runs the container

Troubleshooting GPU Docker Setup Issues:

  • In case Docker is not able to detect your GPU during the run_docker step, you need to install the nvidia-container-toolkit

  • After installing the above, restart Docker:

      sudo systemctl restart docker
    
  • Above steps have been validated on a 2080 TI GPU with CUDA Version 12.2 & Driver versions 535.86

Advanced Setup Options

  • To validate only python examples and avoid running CPP examples, invoke the setup script with below option
 source ./setup.sh --skip_cpp_deps
  • To use existing ARM GCC tools chain installed and avoid downloading, invoke the setup script with below option and set "ARM64_GCC_PATH" environment variable
export ARM64_GCC_PATH=$(pwd)/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu
source ./setup.sh --skip_arm_gcc_download
  • If you are building the PSDK-RTOS/FIRMWARE-BUILDER from source and updating any of the TIDL tools during the development, then set "TIDL_TOOLS_PATH" environment variable before starting setup script
export TIDL_TOOLS_PATH=$PSDKR_INSTALL_PATH/tidl_xxx_xx_xx_xx_xx/tidl_tools
source ./setup.sh