TIOVX Release Notes
Version: 01.03.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-241] - J7 DMPAC.SDE nodes shall support calling into hardware model in VLAB environment
- [TIOVX-242] - J7 DMPAC.DOF nodes shall support calling into hardware model in VLAB environment
- [TIOVX-243] - J7 VPAC.NF nodes shall support calling into hardware model in VLAB environment
- [TIOVX-244] - J7 VPAC.MSC nodes shall support calling into hardware model in VLAB environment
- [TIOVX-245] - J7 VPAC.LDC nodes shall support calling into hardware model in VLAB environment
- [TIOVX-246] - J7 VPAC.VISS nodes shall support calling into hardware model in VLAB environment
- [TIOVX-279] - Tiovx framework shall support build and run on TDA4x VLAB platform
- [TIOVX-294] - Framework shall support importing any TIDL network (with variable number of input and outputs)
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 PC |
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.0A18023
Dependencies (included in Processor SDK RTOS Automotive):
- VXLIB version: 1.1.2.0
- TIDL version: 0.2.0.0
- Processor SDK RTOS Automotive version: 0.2.0.0
Dependencies (NOT included in Processor SDK RTOS Automotive):
- GCC: 5.4.0
- libpng: 1.2
- OpenCV: 2.4.9
Fixed Issues
- [TIOVX-148]: Performance numbers errors. There are some kernels that have graph performance faster than node performance.
- [TIOVX-293]: User struct boundary boundary value set improperly.
- [TIOVX-477]: vxCreateNodeByStructure() function calls vxReleaseKernel() even if kernel != NULL.
- [TIOVX-478]: tivxCreateNodeByKernelName() function gets a kernel reference locally but doesn't release it.
- [TIOVX-479]: vxReleaseKernel() not called in auto-generated code.
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
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