Release notes for emLoad

New Features

1. ST STM32F2/F4 flash driver now supports devices with dual flash banks.

New Features

1. New API added:
   • BTL_Exec()
   • BTL_IF_UART_ExecIF(), to be used instead of previously used internal BTL_COM_ExecIF() .
   • BTL_IF_USB_HID_ExecIF(), to be used instead of previously used internal BTL_COM_ExecIF() .
   • BTL_IF_USB_HID_Read(), to be used instead of previously used internal BTL_COM_Read() .
2. New optional BTL_NET_API function pointers added:
   • pfExec() added.
3. Define BTL_SKIP_CRC_BOOT_CHECK added.
4. Define BTL_DISABLE_FW_CRC_CHECK added.
5. New status codes added:
   • Status code BTL_STATUS_VERIFY_SIGNATURE added.

Improvements

1. Improved compatibility with old architectures that support different memory models.

Program corrections

1. The PrepareFW[PRO].exe parameter "-multirange" might produce ranges that overflow the original address space (more than the allowed 16 byte internal alignment) given from the input file. Fixed.

Improvements

1. Improved USB-HID stability by adding a recovery mechanism to the USB_HID_Loader and embedded side in case the protocol got out of sync upon any failure.

Program corrections

1. A memory leak in the USB_HID_Loader executable leads to error outputs and the application needs to be restartet when called with parameter -wait and no emLoad target is found within a couple of minutes. Fixed.
2. Some interfaces and flash drivers are not resetting everything necessary when using BTL_ConfigRetryUpdateOnFail() to stay in the bootloader and retry updating. Fixed.

Program corrections

1. With pre-flash verification enabled (default), if _MakeValid() fails or gets interrupted (e.g by a power loss) writing the content CRC, starting the firmware fails and updating with the very same image fails as the same content is already in flash. Updating with different images is still possible. Fixed by checking against the FirmwareInfoArea CRC in case of similar flash content to check if the FirmwareInfoArea CRC already matches the content.
2. In case a USB-HID read transfer aborts and is not recognized (should not happen and might be caused by a hardware/controller problem), the read request is not executed again. Fixed.

Improvements

1. Updated emUSB-Device to v3.26 .
2. Updated emSecure to v2.42 .

Program corrections

1. No busy indicator for pre-flash verification mode. Fixed.

New Features

1. New API added:
   • BTL_SetFlashProgProgressHook()

New Features

1. Optional pre-flash verification (feature added in v4.06b) now checks if all content to program is the same and skips flash writing for better flash endurance.

Improvements

1. Renamed all PC tools that use the word "Updater" to "Loader" to prevent Windows UAC dialog interaction.

New Features

1. Cypress PSoC 5 CY8CKIT-050 PSoC 5LP Development Kit port for PSoC Creator 4.2 added for FS MMC/SD interface.

Improvements

1. Better timing in case SD/MMC has no card detect pin by allowing the system tick to be provided by interrupt instead of timer polling.

Program corrections

1. Skipping the CRC check on boot with BTL_ConfigSkipBootCrcCheck() does not work with the new peripheral reset strategy. Fixed.

New Features

1. BTL_FIRMWARE_INFO_SIZE can now be set to zero to disable usage of the firmware info area and usage of valid markers.

New Features

1. Soft-reset CPU for peripheral reset option added.
   New status codes added:
   • Status code BTL_STATUS_REBOOTED_START_FW added.
   • Status code BTL_STATUS_REBOOTING added.
   New optional BTL_NET_API function pointers added:
   • pfSetMarkerReboot() added.
   • pfCheckMarker() added.

Program corrections

1. The UART Updater tool does not correctly handle pre-flash verification of the update. If used, the update fails. Fixed.

Program corrections

1. The start firmware code makes the Cortex-M BASEPRI register dirty after it has been cleaned for firmware start. Fixed.

Improvements

1. Updated emUSB Host to v2.06a.

Program corrections

1. The progress values for a BTL_SetFlashCrcProgressHook() callback gets incorrect parameter values for multi flash bank updates. Fixed.

New Features

1. Optional pre-flash verification (feature added in v4.06b) added for USB Device HID and UART interface. Now available for all existing interfaces.

Improvements

1. Updated the FS to version V4.04f.
2. Improved stability of USB Device HID interface with some USB controllers.

Program corrections

1. If the previous firmware update touched the sector of the firmware infor area and the new image does not, the first update attempt will fail. The second one will succeed. Fixed.

New Features

1. BTL_IF_UART_ConfigDelayBeforeExit() added.

Improvements

1. Improved stability of UART Updater tool.

Program corrections

1. Incomplete received UART packets can confuse the receive logic. Fixed.

New Features

1. New UART interface.

New Features

1. New FS NOR interface.

New Features

1. Firmware Signature add-on for RSA or ECDSA available.

New Features

1. New NAND interface.

Improvements

1. Updated the FS to version V4.04c.

New Features

1. BTL_NET_API structure has been extended. Filling out the new pfResetIF for a file system based update interface allows to check an update before touching the flash.

Improvements

1. Updated the USB Device stack to version v3.02c .

New Features

1. New emLoad 4 PRO Package is available with AES256 encryption.

Improvements

1. USBH MSD updated to version 1.20b .

New Features

1. ST STM32F429I-DISC1 port for IAR EWARM added for USB HID interface.

Improvements

1. Updated the USB Device stack to version v3.00 .

New Features

1. ST STM32F746G Discovery port for KEIL MDK added for MMC/SD interface.

New Features

1. Freescale/NXP Kinetis K21 TWR K21F120M port for SEGGER Embedded Studio added for USBH MSD interface.
2. Kinetis K60 flash driver now supports more Kinetis devices like K2x series.

New Features

1. NXP LPC4357 Keil MCB4300 port for Rowley CrossStudio for ARM added for USBH MSD interface.
2. Parameter -multirange adding to PrepareFW tool for CPUs with multiple flash banks.

New Features

1. ATMEL AT91SAM9X5-EK NAND/SDRAM port for IAR EWARM added for USB HID interface.
2. BTL_SetFlashCrcProgressHook() for adding a user callback on the progress of calculating the CRC over the Flash content added.

New Features

1. ST STM3240G-EVAL port for KEIL MDK added for MMC/SD interface.
2. Define BTL_CRC_BUFFER_SIZE added.

Improvements

1. MMC/SD media presence is now determined by trying to read volume size if media state is unknown (e.g. no dedicated card pin).

Program corrections

1. If no update file is found on MMC/SD the card will be read again and again causing the boot timeout to count down very slowly. Fixed. No update on the media now tries to start the firmware directly.

New Features

1. CRC check during boot can now be skipped by using BTL_ConfigSkipBootCrcCheck() .
2. Renesas YRDKRX62N port for IAR EWRX added for MMC/SD interface.

Program corrections

1. USB HID might discard data with some USB controllers due to an incorrect timebase in USB_OS_None.c . Fixed. USB_OS_None.c is now USB_OS_None_BTL.c .

New Features

1. ST STM32L152VB-SK port for IAR EWARM added for USB HID interface.

Improvements

1. USB Device updated to version 2.40l .

New Features

1. ST STM3220G-EVAL port for IAR EWARM added for MMC/SD interface.

New Features

1. USB HID interface changed to non-blocking behavior.
2. Added option "-wait" to USB HID Updater to wait for a target to be connected before executing other actions.

Improvements

1. NMI vector forwarding for Renesas RX targets added.

New Features

1. ST STM32F4-DISCOVERY port for IAR EWARM added for USB HID interface.

New Features

1. Renesas RSKRX63N port for IAR EWRX added for USB HID interface.
2. Update policy added to be configurable to always, same or newer. Was always before.
3. User can now hook into BTL tick (typically 1ms) to have a time reference.
4. User can register hooks to be notified on state changes e.g. from start => init => update => finished.
5. Retry behavior on update fail can now be configured.

New Features

1. Freescale K60 port for KEIL MDK added for MMC/SD, USB HID and USBH MSD interface.

New Features

1. emLoad now supports more up to date interfaces to update.

Improvements

1. emLoad completely revised. emLoad now is run time configurable.

Program corrections

1. First V4 release. No corrections.