Release Note

SSP v1.7.12
Release Note

Renesas Synergy™ Platform

Synergy Software
Synergy Software Package

All information contained in these materials, including products and product specifications, represents
information on the product at the time of publication and is subject to change by Renesas Electronics
Corp. without notice. Please review the latest information published by Renesas Electronics Corp.
through various means, including the Renesas Electronics Corp. website (http://www.renesas.com).

www.renesas.com Rev.1.00 Nov 2020

Notice
1. Descriptions of circuits, software and other related information in this document are provided only to illustrate the operation of semiconductor products
and application examples. You are fully responsible for the incorporation or any other use of the circuits, software, and information in the design of your
product or system. Renesas Electronics disclaims any and all liability for any losses and damages incurred by you or third parties arising from the use
of these circuits, software, or information.
2. Renesas Electronics hereby expressly disclaims any warranties against and liability for infringement or any other claims involving patents, copyrights,
or other intellectual property rights of third parties, by or arising from the use of Renesas Electronics products or technical information described in this
document, including but not limited to, the product data, drawings, charts, programs, algorithms, and application examples.
3. No license, express, implied or otherwise, is granted hereby under any patents, copyrights or other intellectual property rights of Renesas Electronics
or others.
4. You shall not alter, modify, copy, or reverse engineer any Renesas Electronics product, whether in whole or in part. Renesas Electronics disclaims any
and all liability for any losses or damages incurred by you or third parties arising from such alteration, modification, copying or reverse engineering.
5. Renesas Electronics products are classified according to the following two quality grades: “Standard” and “High Quality”. The intended applications for
each Renesas Electronics product depends on the product’s quality grade, as indicated below.
"Standard": Computers; office equipment; communications equipment; test and measurement equipment; audio and visual equipment; home
electronic appliances; machine tools; personal electronic equipment; industrial robots; etc.
"High Quality": Transportation equipment (automobiles, trains, ships, etc.); traffic control (traffic lights); large-scale communication equipment; key
financial terminal systems; safety control equipment; etc.
Unless expressly designated as a high reliability product or a product for harsh environments in a Renesas Electronics data sheet or other Renesas
Electronics document, Renesas Electronics products are not intended or authorized for use in products or systems that may pose a direct threat to
human life or bodily injury (artificial life support devices or systems; surgical implantations; etc.), or may cause serious property damage (space
system; undersea repeaters; nuclear power control systems; aircraft control systems; key plant systems; military equipment; etc.). Renesas Electronics
disclaims any and all liability for any damages or losses incurred by you or any third parties arising from the use of any Renesas Electronics product
that is inconsistent with any Renesas Electronics data sheet, user’s manual or other Renesas Electronics document.
6. When using Renesas Electronics products, refer to the latest product information (data sheets, user’s manuals, application notes, “General Notes for
Handling and Using Semiconductor Devices” in the reliability handbook, etc.), and ensure that usage conditions are within the ranges specified by
Renesas Electronics with respect to maximum ratings, operating power supply voltage range, heat dissipation characteristics, installation, etc.
Renesas Electronics disclaims any and all liability for any malfunctions, failure or accident arising out of the use of Renesas Electronics products
outside of such specified ranges.
7. Although Renesas Electronics endeavors to improve the quality and reliability of Renesas Electronics products, semiconductor products have specific
characteristics, such as the occurrence of failure at a certain rate and malfunctions under certain use conditions. Unless designated as a high reliability
product or a product for harsh environments in a Renesas Electronics data sheet or other Renesas Electronics document, Renesas Electronics
products are not subject to radiation resistance design. You are responsible for implementing safety measures to guard against the possibility of bodily
injury, injury or damage caused by fire, and/or danger to the public in the event of a failure or malfunction of Renesas Electronics products, such as
safety design for hardware and software, including but not limited to redundancy, fire control and malfunction prevention, appropriate treatment for
aging degradation or any other appropriate measures. Because the evaluation of microcomputer software alone is very difficult and impractical, you
are responsible for evaluating the safety of the final products or systems manufactured by you.
8. Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental compatibility of each Renesas
Electronics product. You are responsible for carefully and sufficiently investigating applicable laws and regulations that regulate the inclusion or use of
controlled substances, including without limitation, the EU RoHS Directive, and using Renesas Electronics products in compliance with all these
applicable laws and regulations. Renesas Electronics disclaims any and all liability for damages or losses occurring as a result of your noncompliance
with applicable laws and regulations.
9. Renesas Electronics products and technologies shall not be used for or incorporated into any products or systems whose manufacture, use, or sale is
prohibited under any applicable domestic or foreign laws or regulations. You shall comply with any applicable export control laws and regulations
promulgated and administered by the governments of any countries asserting jurisdiction over the parties or transactions.
10. It is the responsibility of the buyer or distributor of Renesas Electronics products, or any other party who distributes, disposes of, or otherwise sells or
transfers the product to a third party, to notify such third party in advance of the contents and conditions set forth in this document.
11. This document shall not be reprinted, reproduced or duplicated in any form, in whole or in part, without prior written consent of Renesas Electronics.
12. Please contact a Renesas Electronics sales office if you have any questions regarding the information contained in this document or Renesas
Electronics products.
(Note1) “Renesas Electronics” as used in this document means Renesas Electronics Corporation and also includes its directly or indirectly controlled
subsidiaries.
(Note2) “Renesas Electronics product(s)” means any product developed or manufactured by or for Renesas Electronics.

(Rev.4.0-1 November 2017)

Corporate Headquarters Contact information

TOYOSU FORESIA, 3-2-24 Toyosu, For further information on a product, technology, the most up-to-date
Koto-ku, Tokyo 135-0061, Japan version of a document, or your nearest sales office, please visit:
www.renesas.com www.renesas.com/contact/.

Trademarks
Renesas and the Renesas logo are trademarks of Renesas Electronics
Corporation. All trademarks and registered trademarks are the property
of their respective owners.

© 2019 Renesas Electronics Corporation. All rights reserved.

 Release Note

Renesas Synergy™ Platform

SSP v1.7.12 Release Note
Contents

1. Introduction ..............................................................................................................................2

2. Release Information.................................................................................................................2

3. Synergy MCU Groups Supported ............................................................................................ 2

4. Software Tools and Hardware Kits Supported with this SSP Release ...................................... 2

5. Installing SSP v1.7.12 Release Package ................................................................................. 3

6. Migrating Existing SSP v1.7.8 Projects to SSP v1.7.12 ........................................................... 5

7. Issue Addressed in SSP v1.7.12.............................................................................................. 6

8. NetX Applications ....................................................................................................................6

8.1 Revision History for NetX DHCP Client ................................................................................................... 6
8.2 Revision History for NetX DHCP Server ................................................................................................. 6
8.3 Revision History for NetX DNS ................................................................................................................ 6
8.4 Revision History for NetX HTTP .............................................................................................................. 6
8.5 Revision History for NetX SNMP Agent .................................................................................................. 6
8.6 Revision History for NetX SNTP.............................................................................................................. 6

9. NetX Secure ............................................................................................................................7

9.1 Revision History for NetX Secure ............................................................................................................ 7

10. NetX Duo .................................................................................................................................8

11. NetX Duo Applications .............................................................................................................8

11.1 Revision History for NetX Duo DHCP (IPv4) Client ................................................................................ 8
11.2 Revision History for NetX Duo DHCP (IPv4) Server ............................................................................... 8
11.3 Revision History for NetX Duo DHCPv6 Client ....................................................................................... 9
11.4 Revision History for NetX Duo DHCPv6 Server ...................................................................................... 9
11.5 Revision History for NetX Duo DNS ........................................................................................................ 9
11.6 Revision History for NetX Duo HTTP Client and NetX Duo Server ........................................................ 9
11.7 Revision History for NetX Duo MQTT ..................................................................................................... 9
11.8 Revision History for NetX Duo SNMP Agent ........................................................................................... 9
11.9 Revision History for NetX Duo SNTP ...................................................................................................... 9
11.10 Revision History for NetX Duo Web HTTP .............................................................................................. 9

12. Additional Technical Notes .................................................................................................... 10

R11UT0081EU0100 Rev.1.00 Page 1 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
Revision History ............................................................................................................................ 12
1. Introduction
This document describes the release notes for Synergy Software Package (SSP) version 1.7.12.
This release improves the robustness of NetX, NetX Duo, TLS, MQTT and NetX/NetX Duo applications in
SSP v1.7.8.

2. Release Information
SSP Release Version v1.7.12
Release Date November 05, 2020

Notes: 1. The intended audience for this release is all SSP users who use NetX, NetX Duo, NetX Secure,
MQTT and NetX/NetX Duo Applications.
2. This patch intended for SSP v1.7.8.

3. Synergy MCU Groups Supported

All supported MCU Series.

4. Software Tools and Hardware Kits Supported with this SSP Release
Tool Version Description
e2 studio 7.5.1 Software development environment.
Link: www.renesas.com/synergy/tools
IAR Embedded 8.23.3 Software development environment.
Workbench® for Link: www.renesas.com/synergy/tools
Renesas Synergy™
SSC 7.5.1 Synergy Standalone Configurator. Used in combination with
IAR EW for Synergy.
Link: www.renesas.com/synergy/tools
GNU ARM Compiler 7.2.1 and 4.9.3 GNU ARM® compiler GCC_4.9.3.20150529
J-Link Software 6.34e SEGGER J-Link® debug probe is the quasi standard for
Arm® Cortex®-M based MCUs.
SSP distribution 1.7.8* Synergy Software Package.
package Link: www.renesas.com/synergy/software
*Note: SSP v1.7.8 must be installed prior to the installation of SSP v1.7.12.

R11UT0081EU0100 Rev.1.00 Page 2 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
5. Installing SSP v1.7.12 Release Package
Installing the SSP release pack is a one-time procedure that consists of the following steps:
1. Download SSP_Distribution_1.7.12_hf.zip and extract SSP_Distribution_1.7.12_hf.exe
2. Install the SSP_Distribution_1.7.12_hf.exe

Notes: 1. Select e2 studio 7.5.1 install root folder to install SSP v1.7.12.
2. Make sure that the path provided to install v1.7.12 is the same path where SSP v1.7.8 is installed.

When the installation procedure completes, e2 studio launches and brings up a confirmation dialog to reload
each project. Once confirmed, the new pack Renesas.Synergy.1.7.12.pack file becomes available for
selection on the BSP tab of the Synergy Configurator.
1. It is recommended to close e2 studio before installing SSP v1.7.12.
2. Launch e2 studio v7.5.1.
3. Navigate to the Components tab to verify if the SSP v1.7.12 is installed for NetX, NetX Duo support
shown as follows.

R11UT0081EU0100 Rev.1.00 Page 3 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note

R11UT0081EU0100 Rev.1.00 Page 4 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
6. Migrating Existing SSP v1.7.8 Projects to SSP v1.7.12
1. Navigate to the BSP tab in e2 studio Synergy Configurator.
Select the SSP version combo box to display the installed SSP versions. The following example shows a
project currently created with SSP v1.7.8.

2. Change the selection to SSP version 1.7.12.

A message will pop-up to describe the migration process. Confirm and wait for the new version to display
as active. The configuration display should look like the following screenshot.

3. Click the Generate Project Content button and then rebuild the project. This step concludes the
migration process.

Notes: 1. A warning sign will appear next to the selected SSP version because the SSP v1.7.12 is not a full
release — it only includes the NetX, NetX Duo and NetX Secure 5.12 Sp2 components. As a result,
the new project includes a mix of components from the previous version and the newly installed
one.
2. Selecting SSP v1.7.12 only includes the NetX, NetX Duo and NetX secure components. The
Synergy Configurator will include the other referenced components from the older SSP v1.7.8
release.

R11UT0081EU0100 Rev.1.00 Page 5 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
7. Issue Addressed in SSP v1.7.12
Issue ID: 16132
Description:
Improved robustness of the NetX, NetX Duo, TLS, MQTT and NetX/NetX Duo Applications to enhance
security of the implementation.
Applies to:
S3, S5 and S7 synergy MCUs
Note: Please refer to the NetX Readme sections (section 8 through section 11 of this document) for
additional information on changes included in this patch release.

8. NetX Applications
8.1 Revision History for NetX DHCP Client
Release 5.12 SP2 09-01-2020
nx_dhcp.c Restored the gateway address in _nx_dhcp_client_interface_restore_record().
Improved buffer length verification in _nx_dhcp_interface_user_option_retrieve().

8.2 Revision History for NetX DHCP Server

Release 5.12 SP2 09-01-2020
nx_dhcp_server.c Fixed the issue of infinite recursion in _nx_dhcp_process_option_data().
Fixed the issue of read and write overflow in
_nx_dhcp_server_extract_information().

8.3 Revision History for NetX DNS

Release 5.12 SP2 09-01-2020
nx_dns.c Improved buffer size verification in _nx_dns_process_soa_type().

8.4 Revision History for NetX HTTP

Release 5.12 SP2 09-01-2020
nx_http_server.c Fixed write underflow.

8.5 Revision History for NetX SNMP Agent

Release 5.12 SP2 09-01-2020
nx_snmp.c Improved buffer length verification.

8.6 Revision History for NetX SNTP

Release 5.12 SP2 09-01-2020
nx_sntp_client.c Fixed leap year calculation.

R11UT0081EU0100 Rev.1.00 Page 6 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
9. NetX Secure
9.1 Revision History for NetX Secure
09/01/2020 NetX Secure generic code version 5.12 SP2.
This release includes the following major features:
Files are modified to properly select ciphersuites and ECC curves based on preference order:
• nx_secure_tls.h
• nx_secure_dtls_process_clienthello.c
• nx_secure_tls_ciphersuite_lookup.c
• nx_secure_tls_generate_premaster_secret.c
• nx_secure_tls_process_certificate_verify.c
• nx_secure_tls_process_client_key_exchange.c
• nx_secure_tls_process_clienthello.c
• nx_secure_tls_process_server_key_exchange.c
• nx_secure_tls_process_serverhello.c
• nx_secure_tls_send_certificate_verify.c

Files are modified to fix a padding oracle problem with AES-CBC:

• nx_secure_tls_record_payload_decrypt.c
• nx_secure_tls_verify_mac.c

Files are modified to fix insecure renegotiation bug:

• nx_secure_dtls_process_clienthello.c
• nx_secure_dtls_server_handshake.c
• nx_secure_dtls_session_start.c
• nx_secure_tls.h
• nx_secure_tls_client_handshake.c
• nx_secure_tls_map_error_to_alert.c
• nx_secure_tls_process_clienthello.c
• nx_secure_tls_process_clienthello_extensions.c
• nx_secure_tls_process_finished.c
• nx_secure_tls_process_serverhello.c
• nx_secure_tls_process_serverhello_extensions.c
• nx_secure_tls_send_clienthello_extensions.c
• nx_secure_tls_send_finished.c
• nx_secure_tls_send_hellorequest.c
• nx_secure_tls_send_serverhello_extensions.c
• nx_secure_tls_session_create.c
• nx_secure_tls_session_receive.c
• nx_secure_tls_session_renegotiate.c
• nx_secure_tls_session_renegotiate_callback_set.c
• nx_secure_tls_session_reset.c
• nxe_secure_tls_session_renegotiate.c
• nxe_secure_tls_session_renegotiate_callback_set.c

Files are modified to improve tls protocol version negotiation logic:

• nx_secure_tls_newest_supported_version.c
• nx_secure_dtls_process_clienthello.c
• nx_secure_tls_process_clienthello.c
• nx_secure_tls.h

R11UT0081EU0100 Rev.1.00 Page 7 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
Files are modified to fix race condition for multithread transmission:
• nx_secure_tls.h
• nx_secure_tls_send_record.c
• nx_secure_tls_session_delete.c

File is modified to fix certificate allocation bug:

• nx_secure_tls_remote_certificate_free.c

Other modified files:

• nx_secure_tls_process_record.c

Fix static analysis warning

• nx_secure_tls_session_delete.c

Fix session count delete error

• nx_secure_x509_pkcs7_decode.c

10. NetX Duo

For installation and usage please see the readme_netx.txt file included in your distribution. For port-specific
version information, please refer to the bottom of readme_netx.txt. The NetX Duo generic code version
information is as follows:
09-01-2020 NetX Duo generic code version 5.12 SP2. This release includes the following major features:
Other modified files:
nx_ip_dispatch_process.c Fixed destination header check.
nx_icmpv6_process_ra.c Fixed option length check.
nx_ipv6_process_fragment_option.c Improved packet length check.
nx_ipv6_process_routing_option.c Improved packet length check.

11. NetX Duo Applications

11.1 Revision History for NetX Duo DHCP (IPv4) Client
Release 5.12 SP2 09-01-2020
nxd_dhcp_client.c Restored the gateway address in _nx_dhcp_client_interface_restore_record().
Improved buffer length verification in _nx_dhcp_interface_user_option_retrieve().

11.2 Revision History for NetX Duo DHCP (IPv4) Server

Release 5.12 SP2 09-01-2020
nxd_dhcp_server.c Fixed the issue of infinite recursion in _nx_dhcp_process_option_data().
Fixed the issue of read and write overflow in
_nx_dhcp_server_extract_information().

R11UT0081EU0100 Rev.1.00 Page 8 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
11.3 Revision History for NetX Duo DHCPv6 Client
Release 5.12 SP2 09-01-2020
nxd_dhcpv6_client.c Improved packet length verification.
Corrected the logic of processing DUID type in _nx_dhcpv6_process_duid().
Corrected the length of identifier in _nx_dhcpv6_retrieve_client_record().
nxd_dhcpv6_client.h Improved packet length verification.

11.4 Revision History for NetX Duo DHCPv6 Server

Release 5.12 SP2 09-01-2020
nxd_dhcpv6_server.c Improved packet length verification.
nxd_dhcpv6_server.h Improved packet length verification.

11.5 Revision History for NetX Duo DNS

Release 5.12 SP2 09-01-2020
nxd_dns.c Improved buffer size verification in _nx_dns_process_soa_type().

11.6 Revision History for NetX Duo HTTP Client and NetX Duo Server
Release 5.12 SP2 09-01-2020
nxd_http_server.c Fixed write underflow.

11.7 Revision History for NetX Duo MQTT

Release 5.12 SP2 09-01-2020
nxd_mqtt_client.c Fixed the issue of incorrect TLS session deleting in _nxd_mqtt_client_connect().
Fixed the issue of duplicate disconnecting in _nxd_mqtt_process_disconnect().
Cleared flags if keep alive is enabled in _nxd_mqtt_process_disconnect().
Fixed return value when it is set in CONNACK.

11.8 Revision History for NetX Duo SNMP Agent

Release 5.12 SP2 09-01-2020
nxd_snmp.c Improved buffer length verification.

11.9 Revision History for NetX Duo SNTP

Release 5.12 SP2 09-01-2020
nxd_sntp_client.c Fixed leap year calculation.

11.10 Revision History for NetX Duo Web HTTP

Release 5.12 SP2 09-01-2020
nx_tcpserver.c Fixed packet leak issue.
nx_tcpserver.h Fixed packet leak issue.
nx_web_http_server.c Fixed write underflow.

R11UT0081EU0100 Rev.1.00 Page 9 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
12. Additional Technical Notes
• Subscribe to the Synergy Technical Bulletin Board to receive the latest technical news and notifications
about new features, known issues, workarounds, and release announcements. To subscribe, visit
www.renesasrulz.com/synergy/synergy_tech_notes/f/214.aspx. Sign in to Renesas Rulz, and press
Email Subscribe to this forum.
• Additional technical information, including informative papers and articles on SSP and Synergy can be
found at Synergy Knowledge Base:
Link: www.renesas.com/synergy/knowledgebase

R11UT0081EU0100 Rev.1.00 Page 10 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
Website and Support
Visit the following vanity URLs to learn about key elements of the Synergy Platform, download components
and related documentation, and get support.

Synergy Software www.renesas.com/synergy/software

Synergy Software Package www.renesas.com/synergy/ssp
Software add-ons www.renesas.com/synergy/addons
Software glossary www.renesas.com/synergy/softwareglossary
Development tools www.renesas.com/synergy/tools

Synergy Hardware www.renesas.com/synergy/hardware

Microcontrollers www.renesas.com/synergy/mcus
MCU glossary www.renesas.com/synergy/mcuglossary
Parametric search www.renesas.com/synergy/parametric
Kits www.renesas.com/synergy/kits

Synergy Solutions Gallery www.renesas.com/synergy/solutionsgallery

Partner projects www.renesas.com/synergy/partnerprojects
Application projects www.renesas.com/synergy/applicationprojects

Self-service support resources:

Documentation www.renesas.com/synergy/docs
Knowledgebase www.renesas.com/synergy/knowledgebase
Forums www.renesas.com/synergy/forum
Training www.renesas.com/synergy/training
Videos www.renesas.com/synergy/videos
Chat and web ticket www.renesas.com/synergy/resourcelibrary

R11UT0081EU0100 Rev.1.00 Page 11 of 12

Nov.05.20
Renesas Synergy™ Platform SSP v1.7.12 Release Note
Revision History
Description
Rev. Date Page Summary
1.00 Nov.05.20 - Initial release

R11UT0081EU0100 Rev.1.00 Page 12 of 12

Nov.05.20
SSP v1.7.12 Release Note

Publication Date: Nov.05.20

Published by: Renesas Electronics Corporation

Renesas Synergy™ Platform
SSP v1.7.12 Release Note

R11UT0081EU0100