Readme PN 93000614_C Digi JumpStart for Microsoft .NET Micro Framework Build 1.1.0.6 (c) 2007, Digi International http://www.digiembedded.com/ 17 November, 2007 INTRODUCTION This document contains information about installing and using Digi's JumpStart for Microsoft .NET Micro Framework. CONTENTS This document contains the following sections: 1. Supported Products 2. File and Tool Versions 3. Installation 4. Support Contact Information 5. New Features 6. Deprecated/Changed Features and Functions 7. Bugs Fixes 8. Known Issues and Limitations 1. SUPPORTED PRODUCTS Digi Support for Microsoft .NET Micro Framework supports the following products: - Digi Connect ME-MF (50000878-18) 2. FILE AND TOOL VERSIONS Software package Digi JumpStart for Microsoft .NET Micro Framework Microsoft .NET Micro Framework Connect ME Samples 40002587_C Microsoft .NET Micro Framework Connect ME Template 40002588_B Visual Studio Help Extensions 40002591_C 3. INSTALLATION Microsoft Visual Studio 2005 Standard (or better) must be installed on the PC. The Digi JumpStart Kit DOES NOT include Microsoft Visual Studio 2005 Standard, but it does include Microsoft Visual Studio 2005 Trial Version you can use for 90 days. The installation program should start automatically when you put this CD-ROM in your drive. If it does not, you can start it by running setup.exe. The CD-ROM provides the Connect ME Hardware Reference, sample applications, Microsoft Visual Studio 2005 SP1 and the Microsoft .NET Micro Framework SDK 2.0 SP1. The Microsoft .NET Micro Framework Firmware Deployment Tool (MFDeploy) is installed as part of Microsoft .NET Micro Framework SDK 2.0 SP1. If Microsoft Visual Studio 2005 SP1 is not loaded on your PC, the installer will detect you are missing it and start the Microsoft Visual Studio 2005 SP1 installer. If Microsoft .NET Micro Framework SDK 2.0 SP1 is not loaded on your PC, the installer will detect you are missing it and start the Microsoft .NET Micro Framework SDK 2.0 SP1 installer. After the Digi JumpStart for Microsoft .NET Micro Framework CD installs, open Microsoft Visual Studio 2005 and select the Help-Contents. In the Help Contents window, go to the "Digi JumpStart for Microsoft .NET Micro Framework: Connect ME" and follow the steps under the "Getting Started" topic; then proceed to the "Debugging your first application" topic. 4. SUPPORT CONTACT INFORMATION For support questions on using the Digi JumpStart for Microsoft .NET Micro Framework software with Digi Connect products, see the Online Support Request at http://www.digi.com/support/eservice/login.jsp 5. NEW FEATURES 1. Support for the Digi Connect ME secure embedded module, which is built on Digi's leading 32-bit NET+ARM processor technology, the Digi Connect ME embedded module offers flexibility of professional embedded software development provided by the easy-to-use, cost-effective and complete Digi JumpStart Kit for Microsoft .NET Micro Framework. 2. The InteruptPort class is now supported. 3. New sample application "InterruptPortTest" to demonstrate how to use the low level interrupt with Microsoft.SPOT.Hardware.InterruptPort class. 4. New sample application "MulticastEcho" to demonstrate how to send and receive multicast packets. 5. Added "Socket Error Codes" to the reference section. 6. There is a development and production version of the Connect ME. The development version allows access from Visual Studio 2005 and the production version does not for security purposes. 7. Included GPIO support for PORTC1 and PORTC4. 6. DEPRECATED/CHANGED FEATURES AND FUNCTIONS None 7. BUG FIXES The following defects were corrected from the initial limited Beta release: 1. Corrected DNS resolution for URL's consisting of an odd number of characters 2. Corrected behavior of the Connect ME Ethernet activity LED, removing support for GPIO access to the ns7520 PORTC6. 3. Changed the Auto IP aquisition time from 200 seconds to 30 seconds. 4. Corrected defects in MFDeploy that prevented the utility from locating and discovering the IP address of the Connect ME when the PC had more than one network interface. 5. Corrected defects in MFDeploy that prevented the utility from locating and discovering an Auto-IP address configured Connect ME, when the PC had a routable (non Auto-IP) IP address. 8. KNOWN ISSUES AND LIMITATIONS 1. Serial Hardware handshaking is not supported. 2. Attempting to deploy (i.e., Start Debugging) via Visual Studio will terminate a C# application running on a production Connect ME, requiring a power cycle to restart the application. To work around this issue, production modules should be secured behind protective firewalls. 3. MFDeploy will not be able to discover any devices the first time after a clean install of Visual Studio 2005. To workaround this issue, repeat the discovery process. 4. System.Net.Sockets.Socket.Connect function call blocks forever and never times out on a blocking socket, if the server to which the device is trying to connect to, is not available. As a workaround non-blocking socket should be used. 5. Documentation for Microsoft.SPOT.Hardware.SerialPort.Read function is unclear. The documentation states: "The Read method will block until the number of bytes specified in the count parameter are read, or until a 0 (zero) is read, signaling the end of the read transaction". Here 0 (zero) refers to no serial data available and not to the 0 character. As a result, the function returns when data is read up to number of bytes specified by the count argument, or when a gap occurs in the serial data stream, resulting in an internal timeout, causing the function to return with a data count less than the number of bytes specified in the count argument.