TIOVX Release Notes

Version: 01.00.01.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.


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 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

This is the first release of TIOVX. Here are a few of the features supported in this release:

  1. Conformant to OpenVX 1.1 Specification
  2. DMA acceleration through BAM wrapper
  3. Sample EVE iVision kernel integration
  4. Sample Vision SDK camera/display use-case integration
  5. OpenVX tutorial to get started on TIOVX development
  6. Python-based tool for generating OpenVX code


Upgrade and Compatibility Information

File Change description User application change required User application recompile required
include\VX\vx_types.h Change type of vx_bool to vx_enum instead of enum, since size of enum is compiler dependant NO YES
include\TI\tivx_kernels.h
include\TI\tivx_nodes.h
Moved these files from tiovx\include\TI to tiovx_xx_xx_xx_xx\kernels\include\TI YES - add tiovx_xx_xx_xx_xx\kernels\ to application include path YES
include\TI\tivx.h Renamed TIVX_MODULE_NAME0 to TIVX_MODULE_NAME_OPENVX_CORE
Renamed TIVX_MODULE_NAME1 to TIVX_MODULE_NAME_IVISION
Moved TIVX_MODULE_NAME0, TIVX_MODULE_NAME1 to kernels\include\TI\tivx_kernels.h
YES - include TI\tivx_kernels.h in application in addition to TI\tivx.h YES


Device Support

SoC HOST (OS) Target (OS) Test Plaform
TDA2x ARM M4 (BIOS) DSP C66x (BIOS)
EVE (BIOS)
ARM A15 (BIOS)
ARM M4 (BIOS)
TDA2x TI EVM
TDA2x ARM A15 (Linux) DSP C66x (BIOS)
EVE (BIOS)
ARM A15 (Linux)
ARM M4 (BIOS)
TDA2x TI EVM
TDA2Ex ARM M4 (BIOS) DSP C66x (BIOS)
ARM A15 (BIOS)
ARM M4 (BIOS)
TDA2Ex TI EVM
TDA2Ex ARM A15 (Linux) DSP C66x (BIOS)
ARM A15 (Linux)
ARM M4 (BIOS)
TDA2Ex TI EVM
TDA3x ARM M4 (BIOS) DSP C66x (BIOS)
EVE (BIOS)
ARM M4 (BIOS)
TDA3x TI EVM

Validation Information

This release was built and validated using the following tools:

Build Tools (included in Vision SDK):

Build Tools (NOT included in Vision SDK, needs to be downloaded separately):

Dependencies (included in Vision SDK):


Fixed Issues

  1. TIOVX-160: channel combine and channel extract overflow VXLIB_bufParams2D_t in tivxInitBufParams
  2. TIOVX-150: Replicate Node does not call host side initialize callback for each replication
  3. TIOVX-151: vxMapImage when called more than 16 times fails
  4. TIOVX-154: VX_Bool is 1 byte align on target which causes failures with some alignment checks
  5. TIOVX-159: tivxQueueCreate on BIOS side does not return correct status
  6. TIOVX-156: vxGetPyramidLevel returns error object when pyramid is virtual
  7. TIOVX-142: Test: Valid region
  8. TIOVX-89: Platform: Linux x86 32b mode with GCC toolchain with Ubuntu 16.04
  9. TIOVX-153: Prebuilt PC emulation mode libaries for BAM cause segmentation fault.


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-157:"make clean" does not clean generated libs in lib folder.
  4. TIOVX-155: Test case failures on TDA2 without BAM for Harris Corner test
  5. TIOVX-148: Performance numbers errors. There are some kernels that have graph performance faster than node performance.


Technical Support

For technical support, please post your questions on TI E2E Forum for Automotive ADAS SoCs.

For 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 2017, Texas Instruments Incorporated