TIOVX Release Notes
Version: 01.04.00.00
Contents
- Introduction
- Licensing
- Getting Started
- Documentation
- What's New
- Upgrade and Compatibility Information
- Device Support
- Validation Information
- Fixed Issues
- Known Issues
- Technical Support
- 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:
- [TIOVX-73] - Graph Pipe and Stream: Framework shall support graph streaming feature
- [TIOVX-74] - Graph Pipe and Stream: TIOVX supported kernels shall include VIP capture as streaming source node
- [TIOVX-75] - Graph Pipe and Stream: TIOVX supported kernels shall include DSS display as streaming sink node
- [TIOVX-76] - Graph Pipe and Stream: TIOVX package shall include sample use case demonstrating VIP capture, DSS display with nodes running on DSP1 and DSP2
- [TIOVX-278] - Tiovx framework shall support the host running on A72 Linux
- [TIOVX-497] - Tiovx framework shall support OpenVX User Data Object extension
- [TIOVX-505] - BAM: Support BAM DMA functionality for a single function within a single OpenVX kernel
- [TIOVX-506] - BAM: Support BAM DMA functionality for multiples functions within a single OpenVX kernel
- [TIOVX-512] - Tiovx framework shall support Raw Image Object TI Extension
Upgrade and Compatibility Information
File | Change description | User application change required | User application recompile required |
include\TI\tivx.h | Added new APIs for reporting/exporting/querying static resource usage: tivxQueryResourceStats, tivxPrintAllResourceStats, tivxExportAllResourceMaxUsedValueToFile | NO | NO |
include\TI\tivx.h | Added new APIs for performance reporting and pipelining support: tivxPlatformGetTimeInUsecs, tivxExportGraphToDot, tivxLogRtTrace, tivxSetNodeParameterNumBufByIndex, tivxSetGraphPipelineDepth | NO | NO |
include\TI\tivx.h | Added new color format TI extension: TIVX_DF_IMAGE_P12 | NO | NO |
include\TI\tivx_config.h | Added this new file for user to customize the static resource max values | NO | YES |
include\TI\tivx_mem.h | Added TIVX_MEMORY_TYPE_DMA memory type enum Removed target_ptr from shared memory ptr structure in tivx_shared_mem_ptr_t Changed name of mem_type to mem_heap_region in tivx_shared_mem_ptr_t |
YES | YES |
include\TI\tivx_obj_desc.h | Added several new object descriptor types related to tensors, queues, graphs | NO | YES |
include\TI\tivx_tensor.h | Added new APIs for supporting a subset of OpenVX 1.2 tensor object | NO | NO |
include\VX/vx_khr_pipelining.h | Added new khronos extension header file for supporting pipelining | NO | NO |
Device Support
SoC | HOST (OS) | Target (OS) | Test Plaform |
---|---|---|---|
J7 PreSi | x86_64 (Linux) | x86_64 (Linux) | x86_64 Linux with Ubuntu 16.04 |
J7 PreSi | x86_64 (Linux) | R5F, C6x, C7x, A72 running TI-RTOS | VLAB J7ES Simulator on Linux Ubuntu 16.04 |
J7 PreSi | x86_64 (Linux) | R5F, C6x, C7x running TI-RTOS A72 running Linux v4.19 |
VLAB J7ES Simulator on Linux Ubuntu 16.04 |
Validation Information
This release was built and validated using the following tools:
Build Tools (included in Processor SDK RTOS Automotive):
- C7000 Code Generation Tools version: 1.0.0A18263
- C6000 Code Generation Tools version: 8.4.2
Dependencies (included in Processor SDK RTOS Automotive):
- VXLIB version: 1.1.3.0
- TIDL version: 0.5.0.0
- Processor SDK RTOS Automotive version: 0.5.0.0
Dependencies (NOT included in Processor SDK RTOS Automotive):
- GCC: 5.4.0
- libpng: 1.2
- OpenCV: 2.4.9
Fixed Issues
- [TIOVX-501] - Pipelining breaks when Replicate Node is called
- [TIOVX-502] - Some kernels not run when using tivxBamCreateHandleMultiNode
- [TIOVX-517] - tivxEventClear is not implemented in TDA2/3 BIOS
- [TIOVX-518] - tivxEventClear is not implemented in J7 BIOS
Known Issues
- VXLIB-371: Multiply iS16 iS16 oS16 with 1/255 as scaling factor fails for X86 target
- TIOVX-24: Some Harris Corners test cases fails for when running entire test suite
- TIOVX-155: Test case failures on TDA2 without BAM for Harris Corner test
- TIOVX-164: In x86_64, some replicate with Pyramid testcases fail
- TIOVX-207: tivxMaxNodes test case is failing in x86_64 PC emulation
- TIOVX-519: tivxGraphPipelining.testLoopCarriedDependency is failing
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