RELEASE NOTES ============= Silicon Labs USBXpress Host SDK for USB bridge products for macOS (OS X) Package version: 6.7.7 Release date: 2022-04-20 This package is the macOS Software Development Kit (SDK) for Silicon Labs USBXpress and Classic USB bridge products. It includes support for the following products: * CP2102N (VCP UART) * CP2102 (VCP UART) * CP2104 (VCP UART) * CP2105 (Dual VCP UART) * CP2108 (Quad VCP UART) * CP2110 (HID UART) * CP2112 (HID I2C) * CP2114 (USB Audio) * CP2130 (USB SPI) * CP2615 (USB Audio) The SDK is intended for application developers using the above Silicon Labs products. The SDK provides interface libraries, header files, documentation and examples. This package does not contain the VCP driver or Direct Access Driver (USBXpress driver). These drivers can be found in their own installer packages, downloaded from the Silicon Labs web site. All host software support for Silicon Labs classic and USBXpress USB bridge devices has been combined into this single Software Development Kit. This combined SDK package now replaces the individual, per-device installer packages. The SDK is organized according to device. During installation you can choose to install support for any or all of the devices. Each device directory contains the following subdirectories: * bin - executables * include - header files used for compiling programs against the libraries * lib - libraries and language bindings * Documentation - Data sheets, application notes, user guides and misc. * Examples - example programs using the interface libraries OS VERSIONS ----------- This package is supported on macOS versions 12, 11. It may work on older versions of macOS (OS X). It supports both Mac Intel and Mac M1 architectures. INSTALLING ---------- To install the macOS SDK, mount the .dmg and then drag the USBXpressHostSDK folder to any place you wish such as your home directory. UNINSTALLING ------------ Drag the USBXpressHostSDK folder to the Trash. ****************************************************************************** RELEASE NOTES FOR 6.7.7 (2022-04-20) Changes for HID SmBus library ============================================================================== MCUSW-1101 | Fix memory leak and crash on SLABHIDtoSMBus lib with CP2112 MCUSW-1114 | Fix bug for HidSmbusExample crashed if build in Release mode in | Xcode Changes for Host side example code ============================================================================== MCUSW-894 | Supporting Apple M1 MCUSW-963 | Examples can be built for Universal Mac MCUSW-1009 | Fix bug for HidSmbusExample with error related to clicking on | connect button on the app interface with CP2112 MCUSW-1012 | Fix bug for HidUartExample when setting pin control of cp2110 | for only GPIO.0, the led for GPIO.8,9 are turned on together. MCUSW-1029 | Fix issue on HidSmbus example: compile error, lacking header | files MCUSW-1030 | Fix issue on HidSmbus example: lacking .dylib library MCUSW-1103 | Fix "get config" function for HidSmbusExample with CP2112 MCUSW-1105 | Fix error for HidSmbusExample when building MCUSW-1106 | Fix bug for HidSmbusExample execute error MCUSW-1114 | Fix bug for HidSmbusExample crashed if build in Release mode in | Xcode Changes for manufacturing and config tools ============================================================================== MCUSW-1007 | Fix cp210xsmt error incompatible architecture (have 'arm64', | need 'x86_64')) on Mac 12 M1 MCUSW-1010 | Improve cp210xsmt and others smt app to auto exit after running MCUSW-1102 | Improve cp2615smt to show working status on terminal MCUSW-1104 | Fix bug for cp2110smt application with error | "HidUart_SetPinConfig" and "HidUart_GetPinConfig" function | returned 0x16 MCUSW-1116 | Fix bug for "cp210xsmt" and "cp2130smt" crash on mac 12_Mac M1 MCUSW-1127 | Fix bugs for CP2615smt application with error related to "-- | list" command Changes for CP210x Manufacturing library ============================================================================== MCUSW-1007 | Fix cp210xsmt error incompatible architecture (have 'arm64', | need 'x86_64')) on Mac 12 M1 MCUSW-1128 | Fix bug for ChangeVIDPID.py file in CP210x library Changes for HID Device library ============================================================================== MCUSW-1129 | Fix bug for SLABHIDDevice.py file in CP2110 library with error | "HidDevice_SetupOutputReport_Control: symbol not found" Changes for USB SPI library (CP2130) ============================================================================== MCUSW-1131 | Fix bug for SLAB_USB_SPI.py in CP2130 library with error | "CP213x_TransferWriteRead/CP213x_TransferReadSync : symbol not | found" MCUSW-1135 | Fix bug for "SLAB_USB_SPI.py" and "SLAB_USB_SPIAPI_Test.py" | file in CP2130 library with error "CP213x_Open err 0x20" and | "Unhandled exception" Changes for HID UART library ============================================================================== MCUSW-1130 | Fix bug for SLABHIDtoUART.py file in CP2110 library with error | "No ModuleNotFoundError: 'ComPortTestSuite' " ****************************************************************************** RELEASE NOTES FOR 6.7.6 (2018-11-15) Changes for CP210x Manufacturing library ============================================================================== MCUSW-374 | GetFirmwareVersion() is now supported in the Manufacturing | library for the CP2105 and CP2108. Changes for HID UART library ============================================================================== MCUSW-180 | Fix device indexing problem for CP2114 devices configured as | OUT-only or IN-only (for which the HID interface is MI_02). Changes for SiUSBXp Direct Access Library ============================================================================== MCUSW-179 | Reduce the timeout for the "Get Part Library version" command | only, called in SI_Open() to 50milliseconds. This means old | firmware will experience this timeout. Changes for manufacturing and config tools ============================================================================== MCUSW-94 | Corrects a problem where the VID of the part was being | overwritten when setting other configurable fields. MCUSW-114 | Changed the format of the smt-operation guide to PDF. MCUSW-115 | Removed unnecessary link commands for libslabhidtouart, | libslabhidtosmbus, libslabhiddevice, and libslab_usb_spi from | the makefile for cp210xsmt. MCUSW-121 | Mac/Linux smt binaries are now statically linked with Silicon | Labs libraries. MCUSW-150 | Resolved an issue whereby CP2615[smt,cfg].exe failed to start | if Microsoft redistributable DLLs were not present on the | machine. MCUSW-295 | Fixed an issue where non-programable bits in the QuadPortConfig | field of a CP2108 configuration file corresponding to the state | of the suspend pin were being incorrectly compared during | verification. MCUSW-344 | Fixed a problem where the CP2615 utility cp2615smt did not | correctly erase previous configuration when programming a new | configuration. Changes for Installer packages ============================================================================== MCUSW-116 | Removed data sheets, data shorts, errata and user guide | documents for deprecated VCP parts CP2101 and CP2103. MCUSW-117 | Added a QuickStart Guide and a User Guide for the CP2114. MCUSW-253 | Add "RCP App" customizer to USBXpress SDK package. MCUSW-286 | Add CP2114 customizer to host SDK package. MCUSW-375 | Added HTML API documentation to Docs directory. MCUSW-378 | MacOS - Removed 32 bit code from binaries. Changes for Library language wrappers ============================================================================== MCUSW-125 | Added the function HidSmbus_CancelIo to the HidtoSMBUS library | on MacOS X. Changes for USB SPI library (CP2130) ============================================================================== MCUSW-15 | Fix USB "direction" bug for CP213x_GetLock() (Windows | SLAB_USB_SPI.DLL CP2130 interface library), which put the | device into a Stall situation and subsequent API calls failed. MCUSW-126 | Fix a bug where a file descriptor had not been properly closed | in CP213x_TransferWriteRead. MCUSW-128 | SLAB_USB_SPI.h is now a single file for Windows, Mac, and | Linux. Changes for CP210x Runtime library ============================================================================== MCUSW-237 | CP210x Runtime library no longer needs/requires to also be | linked to CP210x Manufacturing library, with the newly added | "discovery" APIs CP210xRT_GetNumDevices(), CP210xRT_Open() and | CP210xRT_Close(). Changes for Host side example code ============================================================================== MCUSW-118 | Added header and library search paths to the libusb_example | xcode project for the CP2130 in order to pick up libusb from | the default location used by homebrew. MCUSW-159 | Added an example program called MacGPIOExample to show how to | use the GPIO pins on the Mac using the 5.x Mac VCP Driver. MCUSW-163 | Added the HidUartExample.tar.gz source package to the | CP2110_4/Examples folder. MCUSW-233 | Added cp2130_libusb_writeread_example(). All example operations | read the TransferPriority byte to determine endpoint | assignments. Changes for HID SmBus library ============================================================================== MCUSW-203 | On Linux, libslabhidtosmbus and libslabhidtouart now have a | dependency on libslabhiddevice so that your Linux apps no | longer need to explicitly link to libslabhiddevice. ****************************************************************************** RELEASE NOTES FOR 6.7.5 (2017-05-26) Changes for manufacturing and config tools ============================================================================== MCUSW-13 | Fixed a bug that prevented the programming of serial numbers on | the CP2102N using the cp210xsmt utility. Changes for CP210x Manufacturing library ============================================================================== MCUSW-76 | Fixed a bug in manufacturing library | CP210x_GetDeviceInterfaceString() function which presented on | being called for CP2105/CP2108 devices configured with the | USBXpress PID 0xEA61. MCUSW-96 | CP210xManufacturingDLL.h has been fully SAL-annotated | (https://docs.microsoft.com/en-us/visualstudio/code- | quality/using-sal-annotations-to-reduce-c-cpp-code-defects). Changes for Host side example code ============================================================================== MCUSW-9 | The HidUartExample is now available for MacOS X. MCUSW-10 | hidUARTExample now available for Linux. MCUSW-11 | The libusb example is now available for Mac and Linux in the | CP2130 package. Changes for Installer packages ============================================================================== MCUSW-8 | SiLabs USBXpress SDK is now available as a debian package. MCUSW-86 | CP2615 added to the SDK. MCUSW-92 | Added a quick start guide and a user guide for the CP2102N to | the SDK package. MCUSW-99 | This is the first release of our combined host SDK. All host | software support for Silicon Labs classic and USBXpress USB | bridge devices has been combined into this single Software | Development Kit. This combined SDK package now replaces the | individual, per-device installer packages. Changes for CP210x Runtime library ============================================================================== MCUSW-95 | CP210xRuntimeDLL.h has been fully SAL-annotated | (https://docs.microsoft.com/en-us/visualstudio/code- | quality/using-sal-annotations-to-reduce-c-cpp-code-defects).