TIOVX Release Notes

Version: 01.06.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 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-247: J7 DMPAC.SDE nodes shall support calling into hardware drivers in silicon environment
  2. TIOVX-248: J7 DMPAC.DOF nodes shall support calling into hardware drivers in silicon environment
  3. TIOVX-249: J7 VPAC.NF nodes shall support calling into hardware drivers in silicon environment
  4. TIOVX-252: J7 VPAC.VISS nodes shall support calling into hardware drivers in silicon environment
  5. TIOVX-283: OpenVX regressions tested on J7-EVM platform
  6. TIOVX-540: Capture Node shall support multi-channel capture
  7. TIOVX-541: Capture node shall support raw image capture
  8. TIOVX-549: TIOVX shall support custom BAM plugins without needing to change TIOVX framework files
  9. TIOVX-593: Framework shall support TI extension image data type TIVX_DF_IMAGE_NV12_P12 (packed 12 bit)
  10. TIOVX-597: TIOVX shall support a mechanism for nodes to "allocate" or request scratch memory that can be shared by multiple nodes running on same target
  11. TIOVX-598: vx_tensor object shall have new attributes: scaling_divisor and scaling_divisor_fixed_point_position


Upgrade and Compatibility Information

File Change description User application change required User application recompile required
kernels_j7\include\TI\*.h Several changes to HWA interfaces YES YES


Device Support

SoC Target (OS) Test Plaform
J7 x86_64 (Linux) x86_64 Linux with Ubuntu 18.04
J7 R5F, C6x, C7x, A72 running TI-RTOS J7 EVM
J7 R5F, C6x, C7x running TI-RTOS
A72 running Linux v4.19
J7 EVM

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-650: Pipelining using object arrays WITHOUT replicate node is not working
  2. TIOVX-649: vxCreateImageFromROI doesn't maintain graph dependency
  3. TIOVX-624: Replicating nodes with NULL output reference returns error
  4. TIOVX-621: Need to add comments about vxSetNodeTarget() in documentation
  5. TIOVX-620: Need to update PC build documentation with dependent package expectations
  6. TIOVX-607: Verify graph does not detect connection between two nodes with vx_image and vx_obj_array without replication
  7. TIOVX-595: Khronos color convert to IYUV test cases are failing on target
  8. TIOVX-594: GraphStreaming test cases failing on target
  9. TIOVX-591: PyTIOVX code modify fails in Windows
  10. TIOVX-586: testScalarCtrlCmd fails on TDA2/3 target
  11. TIOVX-519: tivxGraphPipelining.testLoopCarriedDependency is failing


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-569: Bmp utils does not load RGBX properly
  6. TIOVX-630: tivxHwaVpacViss.testMux fails on target
  7. TIOVX-656: tivxGraphPipeline.DontReplicateImage fails
  8. TIOVX-657: Pipelining doesn't work with vxCreateImageFromROI
  9. TIOVX-652: Some apps sometimes hangs during exit
  10. Usage of object arrays while pipelining is not yet fully tested
  11. Not all valid VISS outputs are fully tested yet
  12. Test coverage for HWA nodes still work in progress


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