TIOVX Release Notes

Version: 01.05.00.00


Contents

  1. Introduction
  2. Licensing
  3. Getting Started
  4. Documentation
  5. What's New
  6. Upgrade and Compatibility Information
  7. Device Support
  8. Validation Information
  9. Fixed Issues
  10. Known Issues
  11. Technical Support
  12. Package Versioning


Introduction

The TIOVX package consists of the Texas Instruments OpenVX conformant implementation for J7 Pre-Silicon platform


Licensing

The licensing information of this library, as well as any third-party components included which are made available under a number of other open-source licenses are enumerated as part of the manifest. A complete manifest along with export control information is detailed here [HTML].


Getting Started

The TIOVX User Guide [HTML] provides the documentation and references necessary to begin development on TI's platforms using TIOVX.


Documentation

Refer to following documentation for further details:

TIOVX User Guide Build instructions, API Guide [HTML]
TIOVX User Guide for J7 PreSi Build instructions, additional information related to J7 Pre Si platform [HTML]
TIOVX Tutorial Guide Step by step tutorials to get started with OpenVX and TIOVX [HTML]
PyTIOVX User Guide OpenVX application code generator tool [HTML]
Test Reports Misra C reports, conformance test reports, TI platform test reports [FOLDER]
Software Manifest Licenses, terms of use [HTML]


What's New

Here are a few of the new features supported in this release:

  1. TIOVX-584: Added new API for sending a command to a node: tivxNodeSendCommand


Upgrade and Compatibility Information

File Change description User application change required User application recompile required
\ Global replace of tda4x and TDA4X strings in filenames and within files to j7 and J7, respectively YES YES
kernels_j7\include\TI\j7.h VPAC_LDC node API interface has changed YES YES
include\TI\tivx.h Changed name of streaming related APIs from tivx_ -> vx_: tivxSetKernelPipeupDepth, tivxEnableGraphStreaming and moved into include/VX/vx_khr_pipelining.h YES YES
include\TI\tivx_target_kernel.h Changed name and location of tivx_target_kernel_instance_state_e and moved into include/VX/vx_khr_pipelining.h YES YES
include\TI\tivx.h Added new API for sending a command to a node: tivxNodeSendCommand NO NO
include\TI\tivx_target_kernel.h Added new callback function for executing a command sent to a node: tivx_target_kernel_control_f YES YES
include\VX\vx_khr_pipelining.h Updated khronos extension header file for supporting streaming pipeup depth YES YES


Device Support

SoC HOST (OS) Target (OS) Test Plaform
J7 PreSi x86_64 (Linux) x86_64 (Linux) x86_64 Linux with Ubuntu 18.04
J7 PreSi x86_64 (Linux) R5F, C6x, C7x, A72 running TI-RTOS VLAB J7ES Simulator on Linux Ubuntu 18.04
J7 PreSi x86_64 (Linux) R5F, C6x, C7x running TI-RTOS
A72 running Linux v4.19
VLAB J7ES Simulator on Linux Ubuntu 18.04

Validation Information

This release was built and validated using the following tools:

Build Tools (included in Processor SDK RTOS Automotive):

Dependencies (included in Processor SDK RTOS Automotive):

Dependencies (NOT included in Processor SDK RTOS Automotive):

Refer user guide [HTML] for instructions to install and setup above dependancies.

Fixed Issues

  1. TIOVX-539: Framework should provide image as input to display node when actual input is object array
  2. TIOVX-547: Generated kernels with array parameters use item size rather than type for error checking
  3. TIOVX-553: PyTIOVX LUT query fails
  4. TIOVX-554: PyTIOVX generates two different incrementers when Pyramid and object array types are used
  5. TIOVX-573: Graph verify does not detect in and out nodes for replicated parameters


Known Issues

  1. VXLIB-371: Multiply iS16 iS16 oS16 with 1/255 as scaling factor fails for X86 target
  2. TIOVX-24: Some Harris Corners test cases fails for when running entire test suite
  3. TIOVX-164: In x86_64, some replicate with Pyramid testcases fail
  4. TIOVX-207: tivxMaxNodes test case is failing in x86_64 PC emulation
  5. TIOVX-519: tivxGraphPipelining.testLoopCarriedDependency is failing
  6. TIOVX-569: Bmp utils does not load RGBX properly


Technical Support

For technical support and additional assistance, contact local TI Field Application Engineer


Package Versioning

Each package version is composed of 4 period-delimited numbers - represented here by the letters M, m, p and b [M.m.p.b]. The table below provides a descriptive reference regarding package version numbering.

Digit Meaning Description
1 (M=Major) Major revision Incremented when the new version is substantially different from the previous For example, a new module added or an existing module's algorithm significantly altered.
2 (m=minor) Minor revision Incremented when the new version has changed but not in a major way. For example, some minor changes in the API or feature set.
3 (p=patch) Patch number Incremented for all other source code changes. This include any packaging support code.
4 (b=build) Build number Incremented for each release delivery to CM. Reset for any change to M, m or p

Copyright 2018, Texas Instruments Incorporated