Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 © 2016 Analog Devices, Inc. http://www.analog.com [email protected] Contents 1 ADuCM302x EZ Kit Lite® Board Support Package v1.0.1 Release Notes 3 1.1 Release Dependencies 3 1.2 Release Testing 3 1.3 License Checking 3 1.4 Installation 3 2 Release Content 4 2.1 Source files for drivers and services 4 2.2 Toolchain support files 4 2.3 Additional utilities 5 2.4 Documentation 5 3 Micrium Components 6 3.1 3.2 Examples 6 3.1.1 Power_On_Self_Test: 6 3.1.2 EXAMPLES FOR DRIVERS 7 3.1.3 EXAMPLES FOR SERVICES 8 Note: You may see a warning like the one below after loading the executable to the ADuCM302x-EZ-Board. Please press “NO” and proceed. 3.3 Location 4 System Services and Device Driver Thread Safety 8 8 9 5 Contacting Technical Support 10 6 Known issues with the ADuCM302x EZ Kit Lite® Board Support Package (BSP) 11 1 ADuCM302x EZ Kit Lite® Board Support Package v1.0.1 Release Notes Thank you for installing the ADuCM302x EZ Kit Lite® Board Support Package (BSP). The BSP provides software and documentation in support of the ADuCM302x EZ-Board™. The EZ Board is designed to work with IAR embedded workbench software development tools. For more details on IAR, please visit http://www.iar.com The ADuCM302x EZ Kit Lite® BSP provides comprehensive software support for the ADuCM302x EZ-Board© which includes drivers, services. The BSP also provides comprehensive examples which demonstrate the on-chip drivers and services. The device driver and services documentation is part of the BSP. 1.1 Release Dependencies Requires IAR embedded workbench version 7.40.1 or later. 1.2 Release Testing The BSP has been tested with the ADZS-UCM3029 EZLITE version 1.0, BOM 1.4 1.3 License Checking There are no license requirements for the ADuCM302x EZ Kit Lite® BSP. 1.4 Installation It is recommended that you backup or delete your older ADuCM302x EZ Kit Lite® BSP installation directory (e.g. C:\Analog Devices\ADuCM302x\ADuCM302x_EZ_Kit_Lite) before installing a newer ADuCM302x EZ Kit Lite® BSP version. The BSP installer does not currently offer an uninstall option. Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 3 2 Release Content This release contains the following sets of components: Source files for device drivers and services. These components are authored by Analog Devices, for use on the ADuCM302x processor. Examples for device drivers and services. These components are authored by Analog Devices, and demonstrate the use of the device drivers and services. Some of the examples make use of the Micrium RTOS products, so have a dependency on the Micrium products, which must be obtained separately under license from Micrium. Toolchain support. These components are authored by Analog Devices, and are installed into the toolchain to configure it to recognize the ADuCM302x processor family. Additional utilities. These components are authored by Analog Devices, and assist in the generation of applications for the ADuCM302x processor family. Documentation. 2.1 Source files for drivers and services adi_int/adi_nvic Source and include files adi_types.h Base typedefs *ADuCM302x*.h Device descriptions and macro files System Source and include files Startup Source and include files various peripheral device driver source and include files in “src” and “inc” directories. 2.2 Toolchain support files The following common system infrastructure framework files are installed into the toolchain and should be used in all projects. IAR tool chain configuration files Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 4 FlashADUCM3029.* Flash loader files and sources ioADUCM302x.ddf Debugger register display ADuCM3029.icf ADuCM302x EZ-Board linker control file 2.3 Additional utilities These utilities are installed into the tools subdirectory. PinMuxUI Java-based graphical utility for generating source code to configure pin multiplexing. Available for 32-bit and 64-bit Java Virtual Machine. UartDivCalculator Command-line utility for configuring the Baudrate for UART device. 2.4 Documentation ADuCM302x_EZKit_Lite_BSP_GettingStartedGuide.pdf Getting Started Guide ADuCM302x_EZKIT_Lite_BSP_for_IAR_ReleaseNotes.pdf (this file) Release Notes ADuCM302x_EZ-Kit_Lite_BSP_UsersGuide. pdf User's Guide ADuCM302x_EZKIT_Lite_BSP_Device_Drivers_UsersGuide. pdf Guidelines for using the Analog Devices device drivers. Html/index.html Index file for HTML-based Device Driver API documentation Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 5 3 Micrium Components The example "ucos-II" in the examples\rtos directory relies on the uC/OS-II RTOS component from Micrium - refer to the example's README file for details. To make use of this example: 1. Obtain the uC/OS-II product from Micrium. Version 2.92.08 is recommended. 2. Choose a directory where you will store the unzipped Micrium source files. 3. Set the Windows environment variable MICRIUM_DIR to the pathname of this directory. 4. Unzip all Micrium components into $MICRIUM_DIR 5. Start the IAR EWARM environment. 6. Import the appropriate example, and build it. The example is configured to make use of the $MICRIUM_DIR environment variable. Please note that the Micrium components are licensed products, and you must obtain the necessary licenses directly from Micrium to use them. 3.1 Examples 3.1.1 Power_On_Self_Test: This example allows you to test the many peripherals of the ADuCM302x EZ-Board. This example is also pre-programmed into the on-board flash memory. By following the directions in the Readme_post.html file, you can also program this example into the EZ-Board flash. This POST was designed so that you can use the ADuCM302x EZ-Board push buttons to select a specific test to run. The POST example is located in the examples directory or ADuCM302x_EZ_Kit_Lite\examples\Power_On_Self_Test\ADuCM3029 Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 6 3.1.2 EXAMPLES FOR DRIVERS 1. CRC example which uses on-chip CRC controller. 2. SPORT example which uses the on-board SPORT. 3. UART example which demonstrates loop back of data between the TX and RX. 4. SPI driver examples demonstrate the loopback of data. 5. Beep example which configures the beep controller and plays a tune. 6. Flash example to demonstrate how to read/write/erase the flash memory. 7. I2C examples which demonstrate data loop back and also reading the data from the temperature sensor. 8. Random number generation example. 9. Adxl363 accelerometer example which is interfaced with SPI. 10. Hello world examples which demonstrate how to run a program from SRAM without using flash memory. 11 ADC Example to demonstrate how to configure ADC to sample the data. The CRC, FLASH, SPI, UART and I2C examples can all be configured to support DMA mode of operation. Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 7 3.1.3 EXAMPLES FOR SERVICES 1. Timer example which demonstrates timer service. 2. Watchdog example which demonstrates the Watchdog service. 3. RTC example which demonstrates how periodically alarm can be generated. 4. Sys tick timer example. 3.2 Note: You may see a warning like the one below after loading the executable to the ADuCM302x-EZ-Board. Please press “NO” and proceed. 3.3 Location By default, ADuCM302x EZ Kit Lite® Board Support Package (BSP) will be installed C:\Analog Devices\ADuCM302x\ADuCM302x_EZ_Kit_Lite. Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 8 4 System Services and Device Driver Thread Safety All system services and device drivers (SSL/DD) use mutexes and semaphores to ensure threadsafety. If an RTOS is present then SSL/DD will use the RTOS mutex and semaphores. Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 9 5 Contacting Technical Support Submit your questions online at: http://www.analog.com/support E-mail your Processors and DSP applications and processor questions to: [email protected] OR [email protected] (Greater China support) For IAR tool chain support please visit http://www.iar.com/support Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 10 6 Known issues with the ADuCM302x EZ Kit Lite® Board Support Package (BSP) UART device driver does not support RS-485 half duplex mode. Release Notes for ADuCM302x EZ Kit Lite® Board Support Package 1.0.1 February 2016 11