Release Notes

Overview

The Sitara PROFINET^® Device Stack SDK enables end users to quickly integrate into their application and hardware based on supported Texas Instruments Sitara processors with PRU-ICSS sub-modules.

Licensing

Copyright (c) 2021, KUNBUS GmbH

All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Release Version 1.04.00

Features Added

• AM243x Support
  • [DTKPNIOD-996] Migrate PN application code to AM243x
  • AM243x ALV Support
    • [DTKPNIOD-979] Create Cmake and CCS projects for AM243x ALV (EVM)
    • [DTKPNIOD-984] Adapt submodules to AM243x ALV (EVM)
  • [DTKPNIOD-930] Port to AM243x Launchpad
    • [DTKPNIOD-999] Create CMake Configuration for AM243x LP FreeRTOS
    • [DTKPNIOD-981] Create Sysconfig for AM243x ALX (Launchpad)
    • [DTKPNIOD-982] Adapt submodules to AM243x ALX (Launchpad)
• [DTKPNIOD-997] Port sysconfig files to MCU SDK 08.01

Addressed Bugs

• ART Tests on Standard Test Setup failed for: DCP - DCP_Access Dcp-Set Name: setting the name of the DUT was not answered by the DUT.

Known Issues

• [DTKPNIOD-1042] UDP communication and Connect Request
  Sporadically observed that NetLoad Test fails for NetLoad Class 3.
  DUT didn't respond to IP/UDP read request.
• [DTKPNIOD-1013] PROFINET stack stop after a DCP Set IP request
  Device can get stuck when DCP Set IP request is been issued.
  Observed with PRONETA v3.01.00
• ART Tests on Standard Test Setup failed for:
  • IP_UDP_RPC_I&M_EPM
    Stack doesn't support fragmented connect request.
  • Behavior - Scenario 10
    Behavior of ResetToFactory mode:
    ResetCommunicationParameter expects that the writeable SNMP entries are reset.
    (SNMP entry: sysContact)

Release Version 1.03.02

Features Added

• supported functionality list updated

Release Version 1.03.01

Features Added

• Integrate Conformance Class B mand. Feature - SNMP
  • [DTKPNIOD-608,947] Support for SNMP
    Added support for SNMP.
  • [DTKPNIOD-168] Port Statistic counters
    The ability to read statistic counters from PRU and provide for SNMP and acyclic records is now supported.
  • [DTKPNIOD-916] IEEE 802.1AB
    Support for IEEE 802.1AB has been introduced.
• [DTKPNIOD-937] Adjust GSDML to PNIO v 2.41 and CC-B
  Introduce CC-B parameters for GSDML file.
  Adjust GSDML according to v 2.41 spec.
• [DTKPNIOD-952] Process Data and BUS State LEDs
  Implement I2C Access to I/O Expander LEDs for Process Data.
  Implement Bus State LEDs.

Addressed Bugs

• [DTKPNIOD-945] Incorrect UDP port number in application ready request

Known Issues

• [DTKPNIOD-974] Missing response to write request after parameter end control request
• ART Tests on Standard Test Setup failed for:
  • DCP - DCP_Access
    Dcp-Set Name: setting the name of the DUT was not answered by the DUT.
  • Behavior - Scenario 10
    Behavior of ResetToFactory mode:
    ResetCommunicationParameter expects that the writeable SNMP entries are reset.
    (SNMP entry: sysContact)

Release Version 1.03.00

Major Changes

• [DTKPNIOD-894] MCU+ SDK V8.0.0.8 support

Minor Changes

• [DTKPNIOD-8] introduce TI branding
• [DTKPNIOD-905] introduce I&M API Functionality in order to support Factory Reset
• [DTKPNIOD-881] Clean-Up, restructure and document Example Project
• [DTKPNIOD-909] remove StartUserIPSuite-Callback from PN_ETH_API
• [DTKPNIOD-920] remove PN_IP_API

Known Issues

• ART Tests on Standard Test Setup failed for:
  • [DTKPNIOD-925] SM_Legacy - mixed startup of an AR started (sporadically)
• ART Tests issued Warnings for:
  • [DTKPNIOD-926] Alarm - first scenario 'ALPMR' (inconclusive)
  • [DTKPNIOD-927] AR-ASE - third scenario 'delete NameOfStation' (Passed with Hint)
• [DTKPNIOD-921] Permanent Data - Instability when stored data structure is NOT identical to expected data structure.

Release Version 1.02.02

Major Changes

• none

Minor Changes

• Application Process Identifier
  • PNC_API_MAX define is now dependent on Subslot Number
  • connection establishment and cyclic data exchange possible, service record requests are not respecting all possible APIs yet
  • Addressing [DTKPNIOD-876] Application Process Identifier currently limited

Known Issues

• [DTKPNIOD-879] Investigate into Stability Issues - high priority queue
• [DTKPNIOD-759] I&M Data Consistency / RPC annotation / chassis ID
  • RPC annotation is providing incorrect data, as I&M Data Consistency is to be implemented

Release Version 1.02.01

Major Changes

• FreeRTOS support on AM64x, based on MCU+ SDK V7.03.02.04
  • [DTKPNIOD-843] FreeRTOS Integration PROFINET Stack
• [DTKPNIOD-869] Optimizing memory footprint for FreeRTOS
• [DTKPNIOD-755] Implement I&M Data class (ASE)
  • Register I&M Data Set functionality for Submodule is relocated to PN_API_IM_addImCarrier
  • PN_API_IM_addImCarrier is to be executed after the Submodule has been plugged

Minor Changes

• Reworked timers
  • [DTKPNIOD-723] Review that all timer resources are freed after usage
  • [DTKPNIOD-724] Enhance all projects to allocate timer resources dynamically
  • [DTKPNIOD-726] Test if all timer resources are freed after usage (DTK)
• [DTKPNIOD-72] Fix state mismatch in abort process
• Fixes for receiving RTC frames
• Reworked RT scheduler
  • [DTKPNIOD-98] Process high priority alarms in high priority event queue
  • Removed dispatch queue, added queues for Ethernet frames

Known Issues

• [DTKPNIOD-879] Investigate into Stability Issues - high priority queue
• [DTKPNIOD-876] Application Process Identifier currently limited

System requirements

• Operating system support: FreeRTOS
• Development environment: Code Composer Studio
• Supported processors:

Release Version 1.02.00

Major Changes

• Support for AM64x based on TI-RTOS SDK 7.02.01.11

Minor Changes

• preparation of SNMP API for upcoming releases

System requirements

• Operating system support: TI-RTOS
• Development environment: Code Composer Studio
• Supported processors:

Release Version 1.01.03

Major Changes

• further ART Test Conditions passed

Minor Changes

• dynamic Module API documentation in place
  • PN_API_DEV_applyEquipmentConfiguration
  • PN_API_DEV_plugModule
  • PN_API_DEV_pullModule
  • PN_API_DEV_plugSubmodule
  • PN_API_DEV_pullSubmodule
  • #PN_API_DEV_registerIMDataSet
  • PN_API_DEV_registerModuleSubstitutes
  • PN_API_DEV_registerSubmoduleSubstitutes
• Updating PN_API_DEV Error Type Descriptions. PN_API_DEV_EError_t

Known Issues

ART testing failed at

• DiffAccessWays - 0x8072 PDPortStatistic
• Diagnosis
• Alarm
• Pdev_Record
• AR-ASE

Release Version 1.01.02

Major Changes

• stability improvement
• dynamic Module API implemented

Minor Changes

• task priority handling improved

Known Issues

ART testing failed at

• DiffAccessWays
• Diagnosis
• Alarm
• Pdev_Record
• AR-ASE

System requirements

• Operating system support: TI-RTOS
• Development environment: Code Composer Studio (tested with 10.1.0)
• Supported processors: AM65x

Release Version 1.01.01

Major Changes

• Stability Improvements
• release build target
• improved memory footprint

Minor Changes

• Corrected Issue: PRU FW - Packet Corruption when forwarded through PRU
• Scheduling Improvements

Release Version 1.01.00

Description

Standards supported by this Release are:

PROFINET^® Device Stack according to PROFINET Specification V2.4

Functions supported by this Release are:

PROFINET Device Stack
Static Module Pluging
Connection Setup via upto one PRU based Ethernet Port
DeviceName Setup by the PROFINET Controller

NetLoad Classes supported are:

not yet successfully tested

Major Changes

• Initial Release

Minor Change

• Initial Release

Known Issues

• forwarded packets become corrupted
• Performance of Data Exchange between Application and PRU is to be optimized
• experienced Stack hangup when reestablishing ethernet links

Limitations

THIS IS A BETA RELEASE AND SHALL BE TREATED AS SUCH.
THERE ARE FEATURES WHICH AT THIS TIME REMAIN UNTESTED DUE TO OBSERVED ISSUES.
NETLOAD AS WELL AS COMPLIANCE TESTS HAVE NOT BEEN DONE/SUCCESSFULLY COMPLETED YET.

System requirements

• Operating system support: TI-RTOS v07.00.00.05
• Development environment: Code Composer Studio (tested with 10.1.1)
• Supported processors: AM65x