Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 © 2016 Analog Devices, Inc. http://www.analog.com [email protected] Contents 1 Release Dependencies 4 2 Release Testing 5 3 License Checking 6 4 Release Content 7 5 Source files for drivers and services 8 6 Toolchain Support Files 9 6.1 IAR Tool Chain Configuration files 9 7 Additional Utilities 10 8 Documentation 11 9 Examples 12 9.1 Power_On_Self_Test 12 9.2 Examples for Drivers 13 9.3 Examples for Services 14 10 Location 15 11 Contacting Technical Support 16 12 Known issues with the ADSP-CM41x EZ-Kit Lite Board Support Package 17 12.1 ADUCS06-437: Inconsistent IAR revision used for projects 17 12.2 ADUCS06-237: No utility to convert M0 exe into M4 data 17 12.3 ADUCS06-433: JLinkScripts interfering with NoFlash projects 17 12.4 ADUCS06-438: Flash loader sources not included in BSP 18 Thank you for installing the ADSP-CM41x EZ-Kit Lite® Board Support Package (BSP). The BSP provides software and documentation in support of the ADSP-CM41x EZ-Kit Lite. The Board Support Package is designed to work with IAR embedded workbench software development tools. For more details on IAR, please visit http://www.iar.com The ADSP-CM41x EZ-Kit Lite BSP provides comprehensive software support for the ADSPCM41x EZ-Kit Lite which includes drivers and services. The BSP also provides comprehensive examples which demonstrate the on-chip drivers and services. The documentation for the device drivers and services is included in the BSP. Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 3 1 Release Dependencies Requires IAR embedded workbench version 7.40 or later. Requires Segger J-Link USB drivers version 5.0j or later. Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 4 2 Release Testing The BSP has been tested with the ADSP-CM419F EZ-KIT Lite BOM 1.1 Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 5 3 License Checking The BSP software does not perform any license checking. Use of the BSP software is subject to the Software License Agreement presented during installation. Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 6 4 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 ADSP-CM41x processor. Examples for device drivers and services. These components are authored by Analog Devices, and demonstrate the use of the device drivers and services. Toolchain support. These components are authored by Analog Devices, and are installed into the toolchain to configure it to recognize the ADSP-CM41x processor family. Additional utilities. These components are authored by Analog Devices, and assist in the generation of applications for the ADSP-CM41x processor family. Documentation Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 7 5 Source files for drivers and services The majority of source files and include files are generic, and apply to both the Cortex-M4 core and the Cortex-M0 core. There are some core-specific files. src /drivers Source files and include files for drivers inc /drivers src /services Source files and include files for services. inc /services src/M0 System and startup files for the Cortex-M0 core. src/M4 System and startup files for the Cortex-M4 core. inc/M0 System, startup, device and typedef include files for the Cortex-M0 core. inc/M4 System, startup, device and typedef include files for the Cortex-M4 core. osal /noos Operating System Abstraction Layer source files and include files for the no-OS and Micrium uC/OS-III environments. osal /ucos-III Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 8 6 Toolchain Support Files The following common system infrastructure framework files are installed in the toolchain and should be used in all projects. 6.1 IAR Tool Chain Configuration files CM41x_M0.ddf Debugger register display CM41x_M4.ddf CM41x_M0.i79 Device Database CM41x_M4.i79 CM41x_M0.JLinkScript J-Link LITE configuration CM41x_M4.JLinkScript FlashCM41x.* Flash loader file Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 9 7 Additional Utilities This utility is installed into the tools subdirectory PinMuxUI Graphical pin mux configuration and code generation utility Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 10 8 Documentation ADSPCM41x_Software_for_IAR_ReleaseNotes. pdf Release Notes (this file) 2016-02-09-CM41x Click Thru SLA.pdf Software License Agreement ADSP-CM41x_EZKit_Lite_BSP_UsersGuide.pdf How to use the BSP with the IAR Embedded Workbench IDE. CM41x_Device_Drivers_User_Guide.pdf Describes general principles behind the operation and usage of the Device Drivers and System Services adsp-cm41x-ezkit-manual.pdf Manual for the ADSP-CM419F EZ-KIT evaluation board adsp-cm41x-ezkit-schematic.pdf Schematics for the ADSP-CM419F EZ-KIT evaluation board adsp-cm41x-ezkit-bom.pdf Bill of materials for the ADSP-CM419F EZKIT evaluation board html/index.html Reference material for the Device Drivers and System Services APIs for each peripheral Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 11 9 Examples ADSP-CM41x processors are dual-core processors, with both a Cortex-M4 core and a Cortex-M0 core. The majority of examples are single-core examples, configured to be built for one core or the other; several of the examples are supplied in two configurations, one for each core. The “mbox” examples are dual-core examples: there is a project for each core, and the complete example consists of both projects, running simultaneously on different cores of the same processor. 9.1 Power_On_Self_Test This example allows you to test the many peripherals of the ADSP-CM41x EZ-Kit Lite. This example is also pre-programmed into the on-board flash memory. By following the instruction in the Readme_post.html file, you can also program this example into the EZ-Kit flash. This POST was designed so that you can use the ADSP-CM41x push buttons to select a specific test to run. The POST example is located in the examples directory: ADSP-CM41x-EZ-KIT\Examples\Power_On_Self_Test\M4 Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 12 9.2 Examples for Drivers 1 ADCC CortexM0 CortexM4 Demonstrates ADC Controller, in linear and circular modes 2 CRC CortexM4 Uses on-chip CRC controller 3 DACC CortexM4 Demonstrates DAC Controller with on-chip DAC, in linear and circular modes 4 LCD CortexM4 Demonstrates the LCD display, for graphics and text 5 Math Unit CortexM4 Demonstrates math acceleration. 6 ProgramInfoSpace CortexM4 Demonstrates updating the Info Space area of onchip flash 7 SPI CortexM4 Demonstrates data loop-back 8 SPORT CortexM4 Demonstrates SPORT loop-back 9 TRU CortexM0 CortexM4 Demonstrates triggers 10 TTU CortexM4 Demonstrates trigger timing Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 13 11 UART CortexM0 Demonstrates loop-back of data between Tx and Rx CortexM4 9.3 Examples for Services 1 GPIO Cortex-M0 Cortex-M4 Demonstrates General-purpose I/O Demonstrates Multi-core applications 2 MBOX Cortex-M0 Cortex-M4 Demonstrates the mailbox between the two cores. 3 MDMA Cortex-M4 Demonstrates the memory-to-memory DMA service 4 SMPU Cortex-M0 Cortex-M4 Demonstrates System Memory Protection Unit 5 SysTick Cortex-M0 Cortex-M4 Demonstrates the System Tick 6 Timer Cortex-M0 Cortex-M4 Demonstrates the timer service Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 14 10 Location By default, the BSP software will be installed at the following location: C:\Analog Devices\ADSP-CM41x\ADSP-CM41x_EZ_Kit_Lite Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 15 11 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 ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 16 12 Known issues with the ADSP-CM41x EZ-Kit Lite Board Support Package 12.1 ADUCS06-437: Inconsistent IAR revision used for projects The majority of example projects in the BSP were saved with version 7.40.1 of the IAR EWARM product. The following example projects were saved with version 7.40.3, and so require at least that version to open them. gpio/LED-M4-M0/M0 gpio/LED-M4-M0/M4 lcd/adafruit1480/lcd_graphics lcd/adafruit1480/lcd_text ProgramInfoSpace/M4/reportiar ProgramInfoSpace/M4/trimiar ProgramInfoSpace/M4/unlockiar SysTick/M4 12.2 ADUCS06-237: No utility to convert M0 exe into M4 data The recommended approach for multicore applications is that the Cortex-M0 application image is loaded into the shared SRAM space at runtime, by the Cortex-M4 application. The gpio/LED-M4M0 multi-core example demonstrates this. However, in order to do this, it is necessary to convert the Cortex-M0 executable into loadable data. This BSP does not contain any utility to perform this operation. Please contact ADI at [email protected] for details on how to do this conversion. 12.3 ADUCS06-433: JLinkScripts interfering with NoFlash projects Applications mapped into SRAM rather than on-chip flash, such as the SysTick/M4-NoFlash example, do not download successfully when using the default JLinkScripts. The symptoms are that SRAM is blank after "download", and the fault LED light is illuminated. This problem can be worked around by editing the *.i79 file and commenting out the JLinkScript line. For Cortex-M4 projects, this would mean editing arm/config/devices/AnalogDevices/CM41x_M4.i79 in the IAR installation, and commenting out this line: Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 17 JLinkScriptFile=$TOOLKIT_DIR$\config\debugger\AnalogDevices\CM41x_M4.JLinkScript 12.4 ADUCS06-438: Flash loader sources not included in BSP The BSP includes a flash loader executable for programming the flash when downloading applications in the IDE. The sources for this flash loader should be included in the BSP so that it may be rebuilt, but they are missing. Release Notes for ADSP-CM41x EZ-KIT® Board Support Package 1.0.0 May 2016 18