APPLICATION NOTE 4140

Updating Rowley Associates' CrossWorks for MAXQ to Support the DS2790


Abstract: Rowley Associates' CrossWorks for MAXQ—an integrated development environment (IDE) for Maxim's MAXQ® microcontrollers—does not fully support the DS2790 microcontroller in its downloadable form. This application note describes how to obtain full functionality by installing the DS2790 device-specific configuration files on top of the base installation. This procedure gives the user full access to the C code compiler, assembler, simulator, and in-circuit debugging.

Introduction

Rowley Associates' CrossWorks for MAXQ does not currently offer full support for the DS2790. In order to fully support the DS2790, additional files must be installed on the user computer. In addition, the CrossWorks linker must be given the addresses of the Utility ROM routines to support function calls. This document details the steps necessary to upgrade Rowley Associates' CrossWorks to support the DS2790. Before following the procedure outlined in this document, please visit Rowley Associates to download and install the most recent version of CrossWorks for MAXQ.

Copying and Replacing Files

The file Rowley_DS279X_Files.zip includes all the files necessary to upgrade CrossWorks for MAXQ. This zip file can be requested from Maxim Tech Support. The files contained in the zip file need to be copied over to the user computer. Close all Rowley Associates' programs before copying these files.

After copying the zip files to the user computer, follow the procedure below for updating CrossWorks for MAXQ to support the DS2790.
  1. Open Windows® Explorer and find the directory where Rowley Associates' CrossWorks is installed, and open this directory in Windows Explorer. Generally, this directory is C:\Program Files\Rowley Associates Limited\CrossWorks MAXQ 1.1\. Next, open the zip file Rowley_DS279X_Files.zip. A similar setup is shown in Figure 1.

    Figure 1. Use Windows Explorer to locate the directory in which Rowley Associates' Crossworks is installed.
    Figure 1. Use Windows Explorer to locate the directory in which Rowley Associates' Crossworks is installed.

  2. Open the bin folder in Rowley_DS279X_Files.zip and copy all the files to the folder CrossWorks MAXQ 1.1\bin, as shown in Figure 2. Replace any existing files with the new files from the zip file.

    Figure 2. Copy the contents of the Rowley_DS279X_Files.zip bin folder to the CrossWorks MAXQ 1.1/bin folder.
    Figure 2. Copy the contents of the Rowley_DS279X_Files.zip bin folder to the CrossWorks MAXQ 1.1/bin folder.

  3. Open the include folder in Rowley_DS279X_Files.zip and copy all the files to the folder CrossWorks MAXQ 1.1\include, as shown in Figure 3. Replace any existing files with the new files from the zip file.

    Figure 3. Copy the contents of the Rowley_DS279X_Files.zip include folder to the CrossWorks MAXQ 1.1/include folder.
    Figure 3. Copy the contents of the Rowley_DS279X_Files.zip include folder to the CrossWorks MAXQ 1.1/include folder.

  4. Open the src folder in the zip file and copy all files to the folder CrossWorks MAXQ 1.1\src, as shown in Figure 4. Replace any existing files with the new files from the zip folder.

    Figure 4. Copy the contents of the Rowley_DS279X_Files.zip src folder to the CrossWorks MAXQ 1.1/src folder.
    Figure 4. Copy the contents of the Rowley_DS279X_Files.zip src folder to the CrossWorks MAXQ 1.1/src folder.

  5. Lastly, open the targets folder in Rowley_DS279X_Files.zip and copy all the files to the folder CrossWorks MAXQ 1.1\targets, as shown in Figure 5. Replace any existing files with the new files from the zip file.

    Figure 5. Copy the contents of the Rowley_DS279X_Files.zip targets folder to the CrossWorks MAXQ 1.1/targets folder.
    Figure 5. Copy the contents of the Rowley_DS279X_Files.zip targets folder to the CrossWorks MAXQ 1.1/targets folder.

Updating the Linker Options

After all the files have been copied to the CrossWorks MAXQ 1.1 directory, the next step is to start the CrossStudio program. Once the program has been started, follow the procedure below to update the linker options.
  1. Open the solution UserCode2.hzp by selecting File -> Open Solution. The example solution UserCode2 is shown in Figure 6.

    Figure 6. After starting the CrossStudio program, open the solution UserCode2.hzp.
    Figure 6. After starting the CrossStudio program, open the solution UserCode2.hzp.

  2. With the solution open, click on the Project menu and then Properties, as shown in Figure 7.

    Figure 7. To set project properties, choose Project -> Properties from the menu bar.
    Figure 7. To set project properties, choose Project -> Properties from the menu bar.

  3. After selecting Properties, the Project Options window should appear. In this window, the user should select Debug in the Configuration box and Solution in the Project box, as shown in Figure 8.

    Figure 8. In the Project Options window, set the Configuration box to Debug and select Solution in the Project box.
    Figure 8. In the Project Options window, set the Configuration box to Debug and select Solution in the Project box.

  4. In the Project Options box, select the Linker tab and then select Additional Linker Options, as shown in Figure 9. Next, click the "..." button in the Additional Linker Options box.

    Figure 9. In the Linker tab, select Additional Linker Options and the
    Figure 9. In the Linker tab, select Additional Linker Options and the "..." button to set the addresses of the Utility ROM routines.

  5. Clicking the "..." button in the Additional Linker Options box opens the window shown in Figure 10. The final step is to use a text editor to open the file DS2790_UROM_listing.txt contained in the Rowley_DS279X_Files.zip file. This file contains addresses that the CrossStudio linker needs to locate Utility ROM routines. Copy the contents of the text file and paste it into the Additional Linker Options box, as shown below in Figure 10. When finished, click OK in the Additional Linker Options and the Project Options boxes. The project can now be built successfully.

    Figure 10. Update the contents of the Additional Linker Options with the addresses in the DS2790_UROM_listing.txt file.
    Figure 10. Update the contents of the Additional Linker Options with the addresses in the DS2790_UROM_listing.txt file.

Conclusion

The downloadable version of Rowley Associates' CrossWorks for MAXQ does not fully support the DS2790 at this time. However, Maxim can provide additional files to upgrade the development environment free of charge. These upgrades include device configuration files and linker options. Once the additional files have been added, full functionality of the tool is achieved.

Next Steps
EE-Mail Subscribe to EE-Mail and receive automatic notice of new documents in your areas of interest.
© , Maxim Integrated Products, Inc.
The content on this webpage is protected by copyright laws of the United States and of foreign countries. For requests to copy this content, contact us.
APP 4140:
APPLICATION NOTE 4140,AN4140, AN 4140, APP4140, Appnote4140, Appnote 4140