Renesas Synergy Software Package (SSP) v1.2.0-b.1

Transcription

1 Release Note Renesas Synergy Platform Renesas Synergy Software Package (SSP) v1.2.0-b.1 R11UT0004EU0101 Rev.1.01 Introduction This document describes the release notes for SSP release version b.1. Contents 1. Introduction Release information MCUs supported Compatible and tested tools (software and hardware environment) Express Logic, Inc. component version information Information for upgrading existing projects General Information Applications with GUIX Configuration Support for X-Ware Release package and installation information Changes from v1.1.3 to v1.2.0-b.1 release New features bsp (Board Support Package) C++ support fx (FileX) fx_src (FileX Source) gx (GUIX) gx_src (GUIX Source) NetX and NetX Applications Bundle Configuration Support r_ctsu (Capacitive Touch Sensing Unit) r_flash_hp (Flash Memory, High Performance) r_flash_lp (Flash Memory, Low Power) r_qspi (Quad Serial Peripheral Interface) r_riic (IIC) r_riic_slave (IIC) r_rspi (Serial Peripheral Interface) r_sce (Secure Crypto Engine) r_sci_i2c (Serial Communication Interface I2C) R11UT0004EU0101 Rev.1.01 Page 1 of 40

2 r_sci_spi (Serial Communication Interface SPI) r_sci_uart (Serial Communication Interface UART) r_ssi ((Inter IC Sound) interface [old: Serial Sound Int.] or r_i2s) sf_audio_record_adc (Audio Record) sf_el_nx (Synergy NetX Interface) sf_el_ux (Synergy USBX Interface) USBX Configuration Support Updated features Common update to all modules bsp (Board Support Package) NetX (HTTP, DNS, DHCP, FTP, TFTP, Telnet) r_agt (Asynchronous General Purpose Timer) r_cgc (Clock Generation Circuit) r_dmac (Direct Memory Access Controller) r_dtc (Data Transfer Controller) r_flash_hp (Flash Memory, High Performance) r_flash_lp (Flash Memory, Low Power) r_lpmv2 (Low-Power Mode) r_sce (Crypto Library) r_sdmmc (SDHI driver for SDIO and SD/MMC memory devices) sf_el_nx_comms (Synergy NetX Communication Interface) sf_el_ux (Synergy USBX Interface) sf_message (Inter-Thread Messaging) sf_touch_panel_i2c (Touch Panel I2C) ux (USBX) ux_device_class_cdc_acm (USBX Device Class CDC-ACM) ux_src (USBX (Source) Summary of bug fixes since SSP v BSP (Board Support Package) r_adc (A/D converter) r_agt (Asynchronous General Purpose Timer) r_cgc (Clock Generation Circuit) r_dac (Digital to Analog Converter) r_dtc (Data Transfer Controller) r_flash_hp (Flash Memory, High Performance) r_flash_lp (Flash Memory, Low Power) r_gpt_input_capture (General Input Timer) r_ioport (General Purpose I/O Ports) r_lpm (Low-Power Mode) r_ssi ((Inter-IC Sound) interface [old: Serial Sound Int.] or r_i2s) R11UT0004EU0101 Rev.1.01 Page 2 of 40

3 9.13 sf_el_gx (Synergy GUIX Interface) sf_el_nx_comms (Synergy NetX Communication Interface) sf_el_ux (Synergy USBX Interface) sf_el_ux_comms (Synergy USBX Communication Interface) sf_power_profiles (Power Mode Profile) sf_touch_panel_i2c (Touch Panel I2C) ux (USBX (Device Mode)) gx (GUIX) Known issues and limitations in SSP v1.2.0-b.1 that are also present in SSP v Issues Common to all of SSP modules (generic): bsp (Board Support Package) DSP (CMSIS DSP Library) gx (GUIX) nx_http_client (NetX HTTP Client) nxd_dhcp (NetX Duo DHCP Client) r_adc (A/D Converter) r_agt (Asynchronous General Purpose Timer) r_cgc (Clock Generation Circuit) r_ctsu (Capacitive Touch Sensing Unit) r_dtc (Data Transfer Controller) r_gpt (General Purpose Timer) r_gpt_input_capture (General Input Capture) r_ioport (General Purpose I/O Ports) r_qspi (Quad Serial Peripheral Interface) r_rspi (Serial Peripheral Interface) r_sce (Crypto Library) r_sci_i2c (Serial Communication Interface I2C) r_sci_spi (Serial Communication Interface SPI) r_sci_uart (Serial Communication Interface UART) r_sdmmc (SDHI driver for SDIO and SD/MMC memory devices) sf_audio_playback (Audio Playback) sf_el_nx (Synergy NetX Interface) sf_el_nx_comms (Synergy NetX Communication Interface) sf_el_ux (Synergy USBX Interface) sf_message (Messaging Framework) tx (ThreadX) tx_src (ThreadX Source) ux (USBX) ux_host_class_hid (USBX Host Storage HID) ux_host_class_prolific (USBX Host Prolific Class) R11UT0004EU0101 Rev.1.01 Page 3 of 40

4 10.32 ux_network_driver (USBX Network Driver) New issues and limitations in SSP v1.2.0-b.1 release Issues Common to all of SSP modules (generic): Limitations connecting to boards C++ support GCC ARM Embedded Toolchain gx (GUIX) fx (FileX) nx (NetX (HTTP, DNS, DHCP, FTP, TFTP, Telnet)) nx_http_server (NetX HTTP Server) nx_pop3 (Applications Bundle - pop3 Client) nxd (NetX Duo) r_dtc (Data Transfer Controller) r_flash_lp (Flash Memory, Low Power) r_riic_slave (IIC) r_sci_uart (Serial Communication Interface UART) r_sdmmc (SDHI driver for SDIO and SD/MMC memory devices) r_slcdc (Segment LCD Controller) r_ssi (Serial Sound Interface or r_i2s) sf_audio_playback (Audio Playback) sf_console (Console) sf_el_gx (GUIX Synergy Port) sf_el_nx (Synergy NetX Interface) sf_el_nx_comms (Synergy NetX Communication Interface) sf_el_ux_comms (Synergy USBX Communication Interface) sf_i2c (I2C Framework) sf_spi (SPI Framework) Additional Technical Notices Website and Support R11UT0004EU0101 Rev.1.01 Page 4 of 40

5 1. Introduction This document describes the release notes for SSP release version b Release information SSP Release Version b.1 Release Date December 2 nd, 2016 Important notice for this release: The intended audience for this release is Renesas Synergy customers, prospective customers, partners, and support staff. 3. MCUs supported S7G2, S3A7, S124, S5D9 groups. R11UT0004EU0101 Rev.1.01 Page 5 of 40

6 4. Compatible and tested tools (software and hardware environment) Tool Version e2 studio IAR EW for Synergy SSC GNU ARM Compiler eabi-4_9-2015q win32 Software development and debugging tool. Link: Software development and debugging tool. Link: Synergy Standalone Configurator. Used in combination with IAR EW for Synergy. Link: GNU ARM compiler GCC_ IAR Compiler and IAR ARM compiler toolchain PE-HMI1 2.0 DK-S DK-S7G2 3.1 SK-S7G2 3.1 DK-S3A7 2.0 ASK-S5D9 3.1 DK-S5D9 1.0 J-Link Software 6.00h or later Product Example (PE) for Human Machine Interface to evaluate the Renesas Synergy S7G2 240 MHz ARM Cortex -M4 microcontroller. Development Kit for Renesas Synergy S124, 32 MHz ARM Cortex -M0+ microcontroller in a LQFP64 package. Development Kit for Renesas Synergy S7G2, 240 MHz ARM Cortex -M4 microcontroller in a BGA224 package. Starter Kit for Renesas Synergy S7G2, 240 MHz ARM Cortex -M4 microcontroller in a LQFP176 package. Development Kit for Renesas Synergy S3A7, 48 MHz ARM Cortex -M4 microcontroller in a LQFP144 package. Alpha Starter Kit for Renesas Synergy S5D9 Currently this platform is used for Renesas internal development and testing only, and is not available for general distribution. Development Kit for Renesas Synergy S5D9, 120MHz Cortex M4, a 176-pin LQFP package, 2MB Flash, 640KB SRAM. Segger J-Link debug probe is the quasi standard for ARM Cortex -M based MCUs. R11UT0004EU0101 Rev.1.01 Page 6 of 40

7 5. Express Logic, Inc. component version information Component Version ThreadX 5.7 NetX 5.9 NetX Duo 5.9 SP1 NetX Application bundle 5.9 SP1 USBX TM Host 5.7 USBX TM Device 5.7 SP4 FileX 5.4 GUIX TraceX GUIX Studio Information for upgrading existing projects 6.1 General Information IMPORTANT NOTICE: This release is a Beta release of SSP, meaning all features have been completed (although there may be some limitations on some functions). Our intention with this release is to provide you with a preview of our latest platform, Synergy Software Package (SSP) v1.2.0-b.1. While we do not recommend taking this version into production of your own products, it will provide an early look at the basis of our future products. IMPORTANT NOTICE: At this time it is recommended that SSP v1.2.0-b.1 be used for new projects and evaluation of Synergy Platform only. Documents providing information and process for upgrading existing projects based on SSP v1.1.z to SSP v1.2.0-b.1, using either the auto-upgrade feature in e2studio and IAR EW, or manual/user-intervened upgrade, are still under development and are expected to be made available on Synergy Gallery in January However, developers who still want to upgrade their existing projects from 1.1.z releases to SSP v1.2.0-b.1 prior to the planned release of upgrade documents should note that at this time all projects that include NetX and USBX will require manual recreating of the projects and module configurations in e2studio or IAR IMPORTANT NOTICE: The pre-built library for USBX Host Mass Storage class v5.7 (libux_host_class_storage) in SSP release versions 1.1.z cannot be used with FileX v5.4 pre-built library (fx) or the Source code (fx_src) provided with SSP v1.2.0-b.1. If they are used together, your application will not work properly and cause unpredictable behavior since some of FileX structure members have been updated for FileX internal use. Make sure you use the pre-built library for USBX Host Mass Storage class v5.7 in SSP v1.2.0-b.1. The FileX Library provided with SSP releases prior to SSP v1.2.0-b.1 are not compatible with the new FileX module provided in this release. If you are using source code modules for both FileX and USBX Host Mass Storage classes, this does not apply. R11UT0004EU0101 Rev.1.01 Page 7 of 40

8 Summary: FileX 5.2 in SSP1.1.3 FileX 5.4 in SSP1.2.0-b.1 USBX Host MSC v5.7 in SSP1.1.3 USBX Host MSC v5.7 in SSP1.2.0-b.1 ux_host_class_storage ux_host_class_storage_src ux_host_class_storage ux_host_class_storage_src fx VALID VALID NOT VALID NOT VALID fx_src VALID VALID NOT VALID VALID fx NOT VALID NOT VALID VALID VALID fx_src NOT VALID VALID VALID VALID 6.2 Applications with GUIX IMPORTANT NOTICE: GUIX Studio auto-generated code (resources.c/.h and specifications.c/.h) must be regenerated from GUIX Studio v To upgrade your GUIX Studio project developed with GUIX Studio v , follow the steps below: 1. Open your existing GUIX Studio project with GUIX Studio v Go to Configure menu and open Configure Project window. Set GUIX Library Version to and click Save to close the window. 3. Go to Project menu and select Generate All Output Files. No change is required, click Generate. 6.3 Configuration Support for X-Ware IMPORTANT NOTICE: X-Ware related components have been relocated to the X-Ware category in the graphical view in the Synergy Configurator, and redesigned to improve configurability. To maintain backward compatibility for existing user applications, existing projects using SSP v1.1.z with manually created configurations from the component window will be retained without change at the time of upgrading existing projects in e2studio and IAR EW. However, these configurations will be tagged as [DEPRECATED] in the upgraded projects. In future, even while SSP will continue supporting these manual configurations, but they will not be further enhanced or maintained in SSP releases made after It is recommended that existing projects based on SSP v1.1.z with manual configurations for NetX and USBX use the new Synergy configurators for these modules while upgrading to SSP v1.2.0-b.1, however this would require recreating of the project and reconfiguring the modules using Synergy configurators without using the auto-upgrade feature provided with e2studio and IAR EW. More information on project upgrade is expected to be released on Synergy Gallery in January IMPORTANT NOTICE: Only the manually created configurations for NetX and USBX are being deprecated, to be clear, the NetX and USBX modules are not being deprecated and will continue to be supported and enhanced in future SSP releases. 7. Release package and installation information Before installing SSP, ensure that the following items are installed on your PC: Renesas e 2 studio ISDE v (download from Renesas Gallery GNU ARM Compiler (included in Renesas e 2 studio ISDE v installer) To install the SSP, follow these steps: 1. Download the following items for the SSP Release from Synergy Gallery: SSP_Distribution_1.2.0-b.1.zip (SSP Package Installer, including SSP Package, SSP User s Manual and readme_ssp.txt) R11UT0004EU0101 Rev.1.01 Page 8 of 40

9 Release Note r11ut0004eu0101-synergy-ssp-120-b1- relnote.pdf 2. Unzip the package and run the SSP_Distribution_1.2.0-b.1.exe installer. 3. Install the SSP in the root folder of a compatible e 2 studio installation. Note: The default installation folder for the SSP is C:\Renesas\e2_studio. The SSP documentation installs by default to ~Renesas\Synergy\SSP Documentation. You can change the default location during the installation. The following documents will be installed: ssp-user-manual-html-v0.96-sspv1.2.0-b1.zip (HTML version of the SSP user s manual) readme_ssp.txt (critical information and last-minute updates) 8. Changes from v1.1.3 to v1.2.0-b.1 release 8.1 New features bsp (Board Support Package) BSP and peripheral support has been added for the DK-S5D9 and ASK-S5D9 boards. Currently the ASK-S5D9 is used for Renesas internal development and testing only, and is not available for general distribution. Applies to: DK-S5D C++ support SSP modules shall support C++ application environment now, SSP modules can be configured and used in a C++ language environment supported by the e 2 studio. Both GCC and IAR compilers can be used for C++ support. The following are the configurations and other technical details of the SSP C++ support. ISDE version: e 2 studio v or later 1. ISDE e 2 studio v5.2 and later will support Synergy C Project and Synergy C++ project. Synergy C++ project will have all the tool chain supports required for C++ applications. 2. For GCC compiler, the default C++ programming language standard supported by the tool is ISO 2011 C++ (- std=c++11). 3. For IAR, the default C++ programing language standard by the tool is ISO/IEC 14882:2003 (C++) Please refer SSP C++ Usage Guide for more usage details fx (FileX) FileX is upgraded to version 5.4, which includes a new feature, Fault Tolerance. Existing user applications will not be impacted by this upgrade. But note important information provided in Section 6.2 of this Release Note fx_src (FileX Source) FileX is upgraded to version 5.4, which includes a new feature, Fault Tolerance. Existing user applications will not be impacted by this upgrade. But note important information provided in Section 6.2 of this Release Note gx (GUIX) GUIX is upgraded to version (v5.3 Service Pack 2) and GUIX Studio version , which include a new feature, 8-bit CLUT format support. Existing user applications will not be impacted by this upgrade. But note important information provided in Section 6.3 of this Release Note. R11UT0004EU0101 Rev.1.01 Page 9 of 40

10 Applies to: DK-S7G2, SK-S7G2, PE-HMI1, ASK-S5D gx_src (GUIX Source) GUIX is upgraded to version (v5.3 Service Pack 2) and GUIX Studio version , which include new feature - 8-bit CLUT format support. Existing user applications will not be impacted by this upgrade. But note important information provided in Section 6.2 of this Release Notes Applies to: DK-S7G2, SK-S7G2, PE-HMI1, ASK-S5D NetX and NetX Applications Bundle Configuration Support New configurators have been added for NetX and NetX Applications Bundle. Previously, all NetX and NetX applications modules were required to be added and configured using a component window. This improvement does the following: Allows you add NetX modules using thread stack window. Auto-resolves all the dependencies by bringing in required modules. Allows you specify and configure all the run time and compile time options using a configuration window. Allows you share the modules that can be shared. Allows you choose different options available for an interface. Create an instance of all the required low-level modules and create an instance of a top-level module with userspecified parameters by generating the appropriate C codes. This is applicable to: nx(netx) nx_auto_ip (NetX Auto IP) nx_bsd (NetX BSD) nx_dhcp (NetX DHCP Client) nx_dhcp_server (NetX DHCP Server) nx_dns (NetX DNS) nx_ftp_client (NetX FTP Client) nx_ftp_server (NetX FTP Server) nx_http_client (NetX HTTP Client) nx_http_server (NetX HTTP Server) nx_pop3 (NetX POP3) nx_smtp (NetX SMTP) nx_sntp (NetX SNTP) nx_src (NetX Source) nx_telnet_client (NetX Telnet Client) nx_telnet_server (NetX Telnet Server) nx_tftp_client (NetX TFTP Client) nx_tftp_server (NetX TFTP Server) r_ctsu (Capacitive Touch Sensing Unit) Workbench is updated to read MCU information directly from the project configuration instead of manual entry. Applies to: DK-S3A7, DK_S124, DK_S7G r_flash_hp (Flash Memory, High Performance) Implemented Infoget() API function for the flash HP driver, which will return information about the underlying highperformance flash memory. This information includes the number of flash regions, minimum erase and write sizes for both code and data flash. Applies to: All S7G2 and S5D9 boards R11UT0004EU0101 Rev.1.01 Page 10 of 40

11 r_flash_lp (Flash Memory, Low Power) Implemented Infoget() API function for the flash LP driver, which will return information about the underlying lowpower flash memory. This information includes the number of flash regions, minimum erase and write sizes for both code and data flash. Applies to: All S3A7, S124 boards r_qspi (Quad Serial Peripheral Interface) New API added to provide different erase sizes as well as information about the underline flash APIs 1. Added new API R_QSPI_Erase to r_qspi driver, which will erase block of memory depending on the input argument byte_count passed to the API (Typical byte_count value-4096,32768) 2. Added new API R_QSPI_InfoGet to r_qspi driver, which will provide information about the underlying flash like supported erase sizes, size of Flash, flash program size etc. Applies to: DK-S7G2, SK-S7G2, DK-S3A r_riic (IIC) Added DTC transfer support for SCI I2C. Addition of this feature would provide the user with the ability to use DTC to transfer data from receive buffer to user memory and from user memory to transfer memory without using CPU cycles. Applies to: All MCUs Added DTC transfer support for RIIC. Addition of this feature would provide the user with the ability to use DTC to transfer data from receive buffer to user memory and from user memory to transfer memory without loading the CPU for data transfer operations. Applies to: All MCUs r_riic_slave (IIC) Added I2C Slave support to MCU so that Synergy board can communicate with other devices as slave. Applies to: All MCUs r_rspi (Serial Peripheral Interface) Added SPI slave support to MCU so that Synergy board can communicate with other devices as slave. Applies to: All MCUs r_sce (Secure Crypto Engine) RNG and AES cryptographic modules are now supported on the S124 device. Applies to: DK-S124 v2.0 Adds ability to use r_sce module from Synergy C++ projects. Applies to: PE-HMI1, DK-S3A7, DK-S5D9, and DK-S124 Added support for crypto libraries for the S5D9 device. Applies to: DK-S5D9 v1.0 R11UT0004EU0101 Rev.1.01 Page 11 of 40

12 r_sci_i2c (Serial Communication Interface I2C) Added bit-rate modulation function on all SCI modules to improve the accuracy of the baud-rate generation. Using the bit-rate modulation function, the bit rate can be evenly corrected using the number specified in the MDDR register. This will help to reduce % error on baud rates in data communications. Note that this function is more beneficial for boards with odd frequency crystals and for lower baud-rate communications r_sci_spi (Serial Communication Interface SPI) Added bit-rate modulation function on all SCI modules to improve the accuracy of the baud-rate generation. Using the bit-rate modulation function, the bit rate can be evenly corrected using the number specified in the MDDR register. This will help to reduce % error on baud rates in data communications. Note that this function is more beneficial for boards with odd frequency crystals and for lower baud-rate communications r_sci_uart (Serial Communication Interface UART) Added bit-rate modulation function on all SCI modules to improve the accuracy of the baud-rate generation. Using the bit-rate modulation function, the bit rate can be evenly corrected using the number specified in the MDDR register. This will help to reduce % error on baud rates in data communications. Note that this function is more beneficial for boards with odd frequency crystals and for lower baud-rate communications r_ssi ((Inter IC Sound) interface [old: Serial Sound Int.] or r_i2s) The SSI driver supports the new SSI v2 (SSIE) hardware in S5D9. Applies to: S5D sf_audio_record_adc (Audio Record) Added new audio recording ADC framework. Using this framework, the user can record audio from an analog device and get the digital recorded data into the buffer configured by user. Applies to: PE-HMI sf_el_nx (Synergy NetX Interface) Added callback support to configure MAC address to network interface at run time. To use this feature, follow the steps below. Define user callback function void (*p_callback)(nx_mac_address_t *) to return the Ethernet MAC address through the argument. Set the name of your callback function to the "Callback" property in the NetX Port ETHER on sf_el_nx component properties in the Synergy Configuration tool. Note that there is a known issue relevant to this feature. Refer to section 10, Known issues and limitations in SSP v1.2.0-b.1 that are also present in SSP v1.1.3, for more information. Applies to: S7G2, S5D9 R11UT0004EU0101 Rev.1.01 Page 12 of 40

13 sf_el_ux (Synergy USBX Interface) Added the feature to force the USBHS hardware to run in USB Host, FS mode. To enable the feature, set Enable High Speed configuration in the USBX Port HCD on sf_el_ux for USBHS component to Disable. Applies to: All S7G2 boards The category of Synergy USBX Interface (USBX Port HS and FS on sf_el_ux) component on the Stacks view in "Threads" tab on Synergy Configurator was moved from Framework > USB to X-ware > USBX > Device>Synergy Port or Framework > USB to X-ware > USBX > Host > Synergy Port. All the X-Ware related components will be organized/placed/located at in this location in all future SSP releases. In addition of that, be aware of the component being split to 4 components in this release. USBX Port DCD on sf_el_ux for USBFS (USBX Device Controller Driver for USBFS hardware) USBX Port DCD on sf_el_ux for USBHS (USBX Device Controller Driver for USBHS hardware) USBX Port HCD on sf_el_ux for USBFS (USBX Host Controller Driver for USBFS hardware) USBX Port HCD on sf_el_ux for USBHS (USBX Host Controller Driver for USBHS hardware) Applies to: DK-S7G2, SK-S7G2, DK-S3A7, DK-S USBX Configuration Support USBX Host and Device Class stacks are now configurable through Synergy Configurator. By this feature addition, USBX Host/Device Mass Storage Class, HID Class and CDC-ACM Class stack configuration is supported and stack initialization is taken care of in the auto-generated code. For more details, see the SSP Usage Notes. It s applicable to: ux_host_class_cdc_acm (USBX Host CDC-ACM) ux_host_class_cdc_acm_src (USBX Host CDC-ACM Source) ux_host_class_hid (USBX Host HID Class) ux_host_class_hid_src (USBX Host HID Class Source) ux_host_class_storage (USBX Host Mass Storage Class) ux_host_class_storage_src (USBX Host Mass Storage Class Source) ux_host_class_hub (USBX Host HUB Class) ux_host_class_hub_src (USBX Host HUB Class Source) ux_device_class_cdc_acm (USBX Device CDC-ACM) ux_device_class_cdc_acm_src (USBX Device CDC-ACM Source) ux_device_class_hid (USBX Device HID Class) ux_device_class_hid_src (USBX Device HID Class Source) ux_device_class_storage (USBX Device Mass Storage Class) ux_device_class_storage_src (USBX Device Mass Storage Class Source) ux (USBX) ux_src (USBX Source) Note that ux_device_class_cdc_acm and ux(usbx) have been supported in the Synergy Configurator in SSP v1.1.z but those are marked as [DEPRECATED] in this version, which means not recommended for new development. Applies to: S7G2, S5D9, S3A7, S Updated features Common update to all modules The following architecture updates were made to all modules to improve portability between MCUs: - A new API productfeatureget has been added to the FMI to query the factory flash for MCU specific features and capabilities. All SSP modules now use this API to query the capabilities and features available in the MCU. R11UT0004EU0101 Rev.1.01 Page 13 of 40

14 - The vector table and an associated vector information array are now built at link time from SSP_VECTOR_DEFINE macros instead of being a fixed list of pre-named vectors. This is handled by the Synergy Configuration tool when interrupts are enabled. - Interrupt priorities are passed into each module during open() instead of being set once during initialization. - Weak links to internal callbacks defined in the SSP generated code are no longer provided. If a user callback is used, it must be defined in the application code or a linker error will occur. - The functions R_BSP_HardwareLock and R_BSP_HardwareUnlock now take ssp_feature_t as an argument instead of the bsp_hw_lock_t enumerated list. - All control structures (<interface>_ctrl_t) have been moved from the interface header files (ssp/inc/api/<interface>_api.h) to the instance header file (ssp/inc/instances/<instance>.h). This change is transparent in code generated by the e 2 studio Synergy Configuration tool. If a control structure is allocated in application code outside the Synergy Configuration tool, the typedef name used in the declaration must be changed from <interface>_ctrl_t to <instance>_instance_ctrl_t. - A new API eventinfoget has been added to the FMI to get the ELC event (elc_event_t) and IRQ number (IRQn_Type) for a given feature and signal. Module initialization code for shared/common modules used by multiple threads is run from the first thread to execute instead of being run before the RTOS has started. Added the feature in all framework XMLs to incorporate the following improvements: 1. To catch the failures in the initialization function in the generated code. 2. This feature is about creation of weak function in the generated code which can be overridden by the user in the application in a user defined function. If required. 3. Whenever the initialization function fails in the generated code, it calls the user defined function, if it is defined in the application. If these steps are not followed, weak function will be called which has a break point macro BSP_CFG_HANDLE_UNRECOVERABLE_ERROR(0). All non-ssp externals drivers that goes alongside SSP are now moved to a new directory structure under renesas_sybd directory. Contents under renesas_sybd are in non-encrypted format and user can update existing drivers or add new custom drivers in to this folder. This folder will be visible only if your project contains any module using an external driver, for example the touch i2c framework. See the SSP User s Manual to learn how to add custom drivers to the framework bsp (Board Support Package) When ThreadX is added to a project, BSP_CFG_RTOS (in bsp_cfg.h) is now automatically set, no longer requiring you to do so. Applies to: DK-S7G2, SK-S7G2, DK-S3A7, DK-S NetX (HTTP, DNS, DHCP, FTP, TFTP, Telnet) All X-Ware user manual/guide documents are distributed through the Synergy Gallery. In case of inconsistency with the available document in the SSP pack, the user is advised to refer to the corresponding document available from the Synergy Gallery. R11UT0004EU0101 Rev.1.01 Page 14 of 40

15 Applies to: All MCUs r_agt (Asynchronous General Purpose Timer) Added set duty cycle support to AGT timer r_cgc (Clock Generation Circuit) XML is created to create a cgc_clocks_cfg_t structure. Applies to: All Synergy MCUs A new clockscfg API is added to the CGC module. This API enables the application to start and stop multiple clocks and switch the clock source in a single API. Operating power control is now integrated into CGC. The user no longer needs to explicitly control the operating power control mode of the MCU. The only exception is if they need to use the operating power control mode "low voltage" r_dmac (Direct Memory Access Controller) Added support of blockreset() in DMA driver, to support run time reset of configuration parameters in a block transfer. Applies to: DK-S7G2, SK-S7G2, DK-S3A r_dtc (Data Transfer Controller) Added support of blockreset() in dtc driver, to support run time reset of configuration parameters in a block transfer. Applies to: DK-S7G2, SK-S7G2, DK-S3A7, DK-S r_flash_hp (Flash Memory, High Performance) Flash HP module now supports the S5D9 MCU in addition to the S7G2. Applies to: S5D9 r_flash_hp and r_flash_lp use 'f' suffix with floating point constants. Applies to: All the S7G2 and S5D9 boards r_flash_lp (Flash Memory, Low Power) r_flash_hp and r_flash_lp use 'f' suffix with floating point constants. Applies to: All the S7G2 and S5D9 boards r_lpmv2 (Low-Power Mode) LPM V2 is a new Low-Power Modes peripheral driver with enhanced configuration support available in the Threads tab of the e 2 studio Synergy Configurator. Applies to: All Synergy MCUs R11UT0004EU0101 Rev.1.01 Page 15 of 40

16 r_sce (Crypto Library) Added support for RNG and AES in Crypto Library for S124. Applies to: DK-S124 v r_sdmmc (SDHI driver for SDIO and SD/MMC memory devices) Made transfer module a required option for SDIO transfer, whereas earlier it was optional. Also SDIO block overrides all the options in DMAC/DTC except for the name. Applies to: DK-S7G2, DK-S3A7 Added new control command SSP_COMMAND_SET_BLOCK_SIZE to change the block size of the SDMMC. Applies to: DK-S7G2, DK-S3A sf_el_nx_comms (Synergy NetX Communication Interface) Modified Error handling in Read API as it returning SSP_ERR_INTERNAL instead of SSP_ERR_TIMEOUT whenever time out occurs. Applies to: S7G2, S5D sf_el_ux (Synergy USBX Interface) Changed the implementation of the USBX Port Device Controller Driver (DCD) to utilize the Block Reset API if the Transfer Module is used. Applies to: DK-S7G2, SK-S7G2, DK-S3A7, DK-S124 Double buffer feature is implemented in the USB Port Host Controller Driver (HCD). Applies to: S7G2, S5D9, S3A7, S sf_message (Inter-Thread Messaging) Fixed issue of using keyword "class" in the st_sf_message_header. Member 'class' is now changed to 'class_code'. This change is made to make the module compatible with C++ language sf_touch_panel_i2c (Touch Panel I2C) There has been a feature to rotate a GUIX screen in GUIX Synergy Port module (sf_el_gx) in SSP However, there was no function to rotate touch coordinates data in the Touch Panel I2C Framework module, so you were required to rotate the coordinates manually. With this update, you are able to rotate the touch coordinate data through the Synergy Configurator. You can configure the module property "Touch Coordinate Rotation Angle (Clockwise)" to apply degree coordinate rotation. Applies to: All S7G2 boards Touch chip drivers for ft5x06 and sx8654 are moved out from sf_touch_panel_i2c module. All external drivers are now placed under renesas_sybd folder. With this change, the external device drivers are in non-encrypted format. Note: For existing projects using sf_touch_panel_i2c, you need to select the touch chip driver in the configuration (use the "Add Touch Driver" box to select the touch driver) and generate project content. You will see an additional directory structure for touch drivers when generating the project. See the SSP User s Manual to learn how to add custom drivers to the framework. R11UT0004EU0101 Rev.1.01 Page 16 of 40

17 Applies to: DK-S7G2, DK-S5D9, ASK-S5D9, PE-HMI ux (USBX) The category of USBX (USB on ux) component on the Stacks view in the "Threads" tab on Synergy Configurator was moved from Framework > USB to X-ware > USBX. All the X-Ware related components will be placed at this location in future SSP releases. Note that we still have USBX (USB on ux) at Framework > USB but marked as [DEPRECATED] in this version, which means not recommended for new development. Applies to: S7G2, S5D9, S3A7, S ux_device_class_cdc_acm (USBX Device Class CDC-ACM) The category of USBX Device Class CDC-ACM (ux_device_class_cdc_acm) component on the Stacks view in "Threads" tab on Synergy Configurator was moved from Framework > USB to X-ware > USBX > Classes. All the X- Ware related components will be placed at this location in future SSP releases. In addition to the category change, the USBX Device Class stack configuration is updated. When adding the module, all relevant modules, which the USBX Device Class stack relies on are automatically added to the project (auto-fill-in function). Note that we still have USBX Device Class CDC-ACM (ux_device_class_cdc_acm) at Framework > USB but marked as [DEPRECATED] in this version, which means not recommended for new development. Applies to: S7G2, S5D9, S3A7, S ux_src (USBX (Source) The category of USBX Source (ux_src) component on the Stacks view in "Threads" tab on Synergy Configurator was moved from Framework > USB to X-ware > USBX. All the X-Ware related components will be placed at this location in future SSP releases. Applies to: S7G2, S5D9, S3A7, S Summary of bug fixes since SSP v BSP (Board Support Package) Added Critical Section around update for individual MCU Register protections. Applies to: ASK-S5D9, DK-S7G2, SK-S7G2, DK-S3A7, DK-S124 Typo in system_s124.h fixed. Applies to: All S124 boards The IOPORT write function was not reentrant and as a result might not actually write the expected value because another thread could lock the register before the write occurs. This has been fixed. Applies to: All S7G2, S124 and S3A7, S5D9 boards 9.2 r_adc (A/D converter) r_adc API is updated to support 16 sample addition. Applies to: All S3A7, S7G2, S124 boards 9.3 r_agt (Asynchronous General Purpose Timer) AGTCR flags no longer cleared during start and stop. R11UT0004EU0101 Rev.1.01 Page 17 of 40

18 9.4 r_cgc (Clock Generation Circuit) The Systick timer interrupt priority was changed if the application changed the system clock source at runtime. This prevented the RTOS scheduler from running after the system source clock was changed. Applies to: All Synergy MCUs 9.5 r_dac (Digital to Analog Converter) Added test cases to verify structural hole. Applies to: DK-S7G2, SK-S7G2, DK-S3A7 9.6 r_dtc (Data Transfer Controller) The DTC HAL driver limits the transfer size in normal mode to In synergy/ssp/src/driver/r_dtc.c, in the function R_DTC_Enable(): if (TRANSFER_MODE_NORMAL == p_local_info->mode) { SSP_ASSERT(p_local_info->length <= DTC_NORMAL_MAX_LENGTH); } Where (from synergy/ssp/inc/driver/instances/r_dtc.h) /** Length limited to 1024 transfers for normal mode */ #define DTC_NORMAL_MAX_LENGTH (0x400) But the DTC HW can do up to transfers in normal mode (if CRA is set to 0xFFFF). In repeat mode the maximum data transfer size is 256 x 32 bits = 1024 bytes, or in Block transfer mode the maximum block size is 256 X 32 bits = 1024 bytes. Applies to: All S7G2, S3A7 and S124, S5D9 boards The DTC xml buf fix for software event vector assignment completed. Applies to: DK-S7G2, SK-S7G2 9.7 r_flash_hp (Flash Memory, High Performance) Removed global variable g_flash_api_open and used available control structure member. Applies to: DK-S7G2 9.8 r_flash_lp (Flash Memory, Low Power) The API 'opened' flag has been moved into the flash_ctrl_t structure, and it s no longer a global variable. Applies to: DK-S3A7, DK-S r_gpt_input_capture (General Input Timer) Typo in GPT XML display drop down for clock divisors fixed. Applies to: All S7G2 boards Typo in GPT XML display drop-down for clock divisors fixed. R11UT0004EU0101 Rev.1.01 Page 18 of 40

19 9.10 r_ioport (General Purpose I/O Ports) Ensures that the PWPR register is protected and under control of a reference counter so that in a multithreaded system, its contents cannot be altered by another thread while executing an HW_IOPORT_PFSWrite() call. Applies to: All S7G2, S124 and S3A7, S5D9 boards 9.11 r_lpm (Low-Power Mode) An application using the LPM driver and ThreadX should revert the low-power mode to sleep immediately after wake from standby. The LPM driver usage notes in SSP User s manual were updated to describe how to do this. This is not needed if Power Profiles framework is used. Applies to: All Synergy MCUs 9.12 r_ssi ((Inter-IC Sound) interface [old: Serial Sound Int.] or r_i2s) Typo in I2S XML configuration, Enabled should be I2S_WS_CONTINUE_ON. Applies to: All S7G2 boards Fixed receive typo transfer pointer in SSI XML. Applies to: All S7G2 boards The SSI DTC activation source calculation for channel 1 was incorrect. This is fixed, and SSI channel 1 can be used with DTC. Applies to: All S7G2 and S3A7 boards 9.13 sf_el_gx (Synergy GUIX Interface) There was an issue in GUI Synergy Port module to cause slow rendering and tearing on LCD panel screen if you have following configurations: Rotate screen 90 or 270 degree. Enable 2DG engine (DRW module) With this fix, the rendering speed got faster and tearing would not happen. Applies to: All S7G2 boards 9.14 sf_el_nx_comms (Synergy NetX Communication Interface) Chained Packet support was added in SSP v1.1.0 but one compiler warning remained unresolved. The warning is resolved. Applies to: S7G2, S5D sf_el_ux (Synergy USBX Interface) Assigned proper fifo Index for USBX HCD Interrupt transfer, so that the driver use DFIFO for DMA Interrupt transfer, instead using CFIFO every time. Applies to: DK-S7G2, SK-S7G2, DK-S3A7 R11UT0004EU0101 Rev.1.01 Page 19 of 40

20 On Synergy Configurator Stacks view, there is a constraint for the USBX Port (sf_el_ux) component to warn users to enable the USBFS interrupt if not enabled. However, the constraint was not functional for S3A7 parts. With this fix, the constraint works as designed. In addition of that, please be aware of the component USBX Port (sf_el_ux) being split to four components in this release described in For S3A7 device, you can choose USBX Port HCD for USBFS for USB Host classes or USBX Port DCD for USBFS for USB Device classes. Applies to: DK-S3A7 USBHS hardware on S7G2 or S5D9 have a BUSWAIT register, which is used for adjusting access cycles to the USBHS registers from bus masters (CPU/DMAC or DTC). In SSP release 1.1.0, the setting was hard-coded to 7 cycles but it was only appropriate when the PCLKA frequency is 120 MHz. The access cycle calculation has been made configurable at run-time based on the PCLKA frequency configuration that is selected. Applies to: All S7G2 boards USB data throughput is improved for USB HCD (Host Controller Driver) for bulk transfer, by adding continuous transfer, configurable FIFO size and optimized read (IN) and write (OUT) transfer logic. The FIFO size can be configured using the macro UX_SYNERGY_MAX_BULK_PAYLOAD as a preprocessing option in your project. The valid values start from 64 bytes to 2K for Bulk transfer, recommend to configure the macro value to 2048, if we need to achieve maximum throughput. The FIFO size configuration is valid in the case of High Speed Host and not valid for Full speed. Applies to: DK-S7G2, SK-S7G2, DK-S3A sf_el_ux_comms (Synergy USBX Communication Interface) The USB CDC class initialization is moved from the open function call of sf_el_ux_comms framework to the code auto-generated by the USBx CDC XML configurator. Applies to: All the Synergy boards Fixed coding standard violation in the underlying hcd and cdc ux driver sf_power_profiles (Power Mode Profile) The clock configuration was not being verified before changing the operating power control mode of the MCU. The clock configuration is now verified to be compatible with the Subosc-speed operating power control mode. Applies to: All Synergy MCUs Power Profiles was updated to revert the low-power mode after wake from standby when ThreadX is part of a project sf_touch_panel_i2c (Touch Panel I2C) The issue was found in getting a NAK return from SX8654 touch chip controller in the I2C communication. It resulted in the hang up of the Touch Panel I2C Framework module since the touch chip continue to hold the IRQ signal line to low. The framework module needs the IRQ signal line to be back high to handle the next touch event, so it need to have R11UT0004EU0101 Rev.1.01 Page 20 of 40

21 the touch chip set the IRQ signal high. With this update, the SX8654 touch controller driver performs retry communications (up to 10 times) if the chip returned NAK and tries to return the IRQ signal back to high. Applies to: DK-S7G2, SK-S7G ux (USBX (Device Mode)) USBX Device CDC-ACM Class could stall in the service call ux_device_class_cdc_acm_read() when it met the following conditions: "requested_length" argument of ux_device_class_cdc_acm_read() is larger than wmaxpacketsize (*see note below). Reception data in bytes from USB Host CDC-ACM device was exactly the same number as wmaxpacketsize. USB Host CDC-ACM device did not send consequent data after sending bytes with wmaxpacketsize for some reason. Note * wmaxpacketsize: Max payload size specified in BULK-OUT Endpoint Descriptor in the USB Device Descriptor (it is 64 in FS mode or 512 in HS mode in general). This issue no longer happens in this release since the ux_device_class_cdc_acm_read() was updated to return back to the caller application when receiving data equal to wmaxpacketsize in bytes. IMPORTANT NOTICE: The ux_device_class_cdc_acm_read() returns to caller when receiving data equal to wmaxpacketsize in bytes, regardless of the number specified to "requested_length". It is your responsibility to check the "actual_length" argument returned back from the service call to find out if the total reception bytes reached the "requested_length". Applies to: All S7G2 boards, DK-S3A7, DK-S124 Resolves an issue where ux_host_class_hub.h file has duplicate entries in synergy project and caused compilation errors in some situations gx (GUIX) Resolved bug in GUIX API _gx_system_timer_expiration() not to set a member named 'gx_event_target' of the timer_event structure. Applies to: DK-S7G2, SK-S7G2, PE-HMI1, DK-S5D9 10. Known issues and limitations in SSP v1.2.0-b.1 that are also present in SSP v Issues Common to all of SSP modules (generic): If control structures are not all zeros, then function calls other than the open() may incorrectly determine that the Module has already been opened. If this occurs, then the Module may cause undefined behavior since it has not been properly initialized. Statically allocated control structures will be zeroed-out as part of the C runtime initialization by the BSP. An example of when a control structure should be explicitly zeroed-out is if it was allocated off the stack. Workaround: Ensure that control structures are all zeros before first use. Applies to: All the Synergy parts Information in the column of the Components pane of the Synergy Configurator in e 2 studio might be invalid. R11UT0004EU0101 Rev.1.01 Page 21 of 40

22 Workaround: Ignore the information in the column of the Components pane. Applies to: All SSP modules Customers should use version 4.9 or greater of the GCC ARM Embedded Toolchain. Otherwise the build might fail to build due to _sbrk function duplication (original exists in the GCC library). Improved version of _sbrk has been added to the SSP to fix the malloc() issue, however the compiler reports function duplicate on build and generates an error. Here's the workaround for GCC Toolchain 4.8: In the project settings, the default linker flag: --specs=rdimon.specs should be changed to: --specs=nosys.specs Applies to: Projects using GCC ARM Embedded Toolchain When building a project using GCC, it is possible that not all of the requested Heap area is made available to the application. As part of a fix for a prior issue with GCC which would allocate areas outside of the heap, we now provide our own _sbrk() function for Heap allocation. The library version of malloc() in use requires a minimum 4K pagesize. As a result, an request for memory via malloc() may fail even though there is sufficient space available for the request. Workaround: If malloc() requests are failing and indicating no memory available, then increasing the Heap size would be necessary. Applies to: All MCU The registers defined for the PWM Delay Generation Circuit (R_GPT_ODC) in S7G2.h and S5D9.h are not correct and should not be used to create custom drivers. This does not affect any existing SSP driver. Workaround: Access the registers using the register addresses in the hardware manual. Applies to: S7G2, S5D9 When using ThreadX applications with IAR compiler and use functions which relies on the fact that the static variables are zero initialized (For eg: standard library time functions) will cause application to cause run time failures Workaround: Add the following lines to the linker script for building applications which are multi-threaded initialize by copy with packing = none { section DLIB_PERTHREAD } Applies to: All MCU 10.2 bsp (Board Support Package) On the boards listed, the setup of the QSPI interface by the BSP does not set all unused bits to a known value. This will not break any functionality of QSPI and does not impact the QSPI module itself. It is mentioned only in the event that someone is writing code to use/test the QSPI that is on the development boards. Workaround: NONE Applies to: DK_S3A7, DK_S7G2, SK_S7G2, DK_S5D9, ASK_S5D DSP (CMSIS DSP Library) A linker error may occur when DSP library functions are used. Workaround: Download the DSP library from ARM and add the file CMSIS\DSP_Lib\Source\CommonTables\arm_const_structs.c to your project. The CMSIS DSP library can be downloaded here: Applies to: S7G2, S5D9, S3A7, S124 R11UT0004EU0101 Rev.1.01 Page 22 of 40

23 10.4 gx (GUIX) A macro named GX_TICKS_SECOND defined in gx_port.h does not represent 1 second but 400 ms if ThreadX system tick time is set to 10 ms (default). Workaround: Define the macro GX_TICKS_SECOND=50 as a C Compiler Preprocessor. Applies to: DK-S7G2, SK-S7G2, PE-HMI1, DK-S5D9, DK-S3A7 The IS_SIGNAL() macro is wrongly defined in gx_api.h and uses the label 'LAST_SIGNAL', which is not defined within GUIX but a typo of 'GX_LAST_SIGNAL'. The use of IS_SIGNAL() results in a build error. Workaround: Define LAST_SIGNAL=0x00ffffff as a C Compiler Preprocessor. Applies to: DK-S7G2, SK-S7G2, PE-HMI1, DK-S5D9, DK-S3A7 Multi-line texts drawn by _gx_multi_line_text_view_text_set() API may be gone from the widget if the widget is once hided under the other widget. This issue fix has been addressed in GUIX5.3.2 by Express Logic but it has yet to be tested in this version. Workaround: Not required. Applies to: DK-S7G2, SK-S7G2, PE-HMI1, DK-S5D nx_http_client (NetX HTTP Client) NetX HTTP Client is hard coded to support HTTP 1.0 only. Some HTTP servers reject HTTP 1.0 GET requests so the HTTP client shall be made configurable in future SSP releases. Workaround: None, supports HTTP 1.0 only in this release. Applies to: DK-S7G2, SK-S7G2, PE-HMI1, DK-S5D9 Memory leak may happen in nx_http_client_get_start() if we received a GOOD request without Content-Length. This issue has been fixed according to the code inspection but not tested yet in this version. Workaround: Not required. Applies to: DK-S7G2, SK-S7G2, PE-HMI1, DK-S5D nxd_dhcp (NetX Duo DHCP Client) nx_dhcp_user_option_retrieve() in NetX v5.9 SP1 returns an IP address of the DHCP server that is byte-swapped compared to NetX v5.9. Workaround: Swap bytes of the IP address which is obtained by nx_dhcp_user_option_retrieve() in application code. Applies to: DK-S7G2, SK-S7G2, PE-HMI1, DK-S5D r_adc (A/D Converter) Temperature readings may not be accurate if the PCLK value is not 60 MHz on the S7G2 and 24 MHz on the S3A7 and 8MHz on the S124. Workaround: Use the SetSampleState APi call to set the sample state count when changing ADC operating clock frequency. Applies to: S7G2, S3A7, S r_agt (Asynchronous General Purpose Timer) R11UT0004EU0101 Rev.1.01 Page 23 of 40