Simulator Release NotesImpronto Simulator Release Notes
Introduction
Thank you for downloading the Impronto Simulator. The Impronto Simulator provides Java developers with a Bluetooth development environment based on the Java APIs for Bluetooth Wireless Technology (JABWT) standard. Developers can develop and test applications using the Simulator without the need to install a full Bluetooth stack.
System Requirements for Simulator Version 1.3
Software
JDK 1.5.0
Hardware
At least a Pentium processor with 128MB of RAM
70 MB of disk space
JDK 1.5.0Installation
Run the installer as follows, java -jar simulator-install.jar, and follow the on-screen instructions.
This will install the Impronto Simulator, example applications, and the ant build tool. Information about using ant is available from ant.apache.org.
After the installation has completed, you will need to install your license file in order to use the simulator. If you do not have a license, please contact sales@rococosoft.com. The license file must be copied into the simulator configuration directory, {simulator_home}/config.
Please refer to the Getting Started section of the User Guide, SimulatorUserGuide.pdf, in the documentation directory, {simulator_home}/docs.
Product Features
Provides full support for L2CAP, RFCOMM, OBEX, SDP, HCI, BCC
Supports both J2SE and J2ME
Provides a management console for tracking and controlling the run-time behaviour of devices and networks
Allows users to create and configure virtual devices using the management console
Has full logging capability for Bluetooth events, and can capture events for specific devices with event filtering
Known issues
The table below contains details of all known product issues.
| Rococo Identifier | Details |
| 359 | Device does not exit Limited Discoverable Mode automatically. |
| 360 | In certain circumstances, connection information dialog may contain blank data. |
| 361 | In certain circumstances, 2 device configuration tabs with the same title may exist. |
| 362 | In the 'pre-known' dialog, it is necessary to type to cause the label to be stored. |
| 310 | In certain circumstances, when using J2ME (WTK, J9 etc) on Windows, the device can hang during intense periods of communication within the test application. |
| 363 | When using J2ME (WTK, J9 etc), you must specify a "impronto.localdevice.friendlyname" and have matching .xml and .properties in the simulator config directory. |
| 364 | Device configuration files(.xml), cannot contain certain characters. |
Support
To report a bug which you may have found while using this release please send the following details to support@rococosoft.com:
A short Description of the problem.
Operating System version and any service packs applied.
JDK Version.
Severity of this bug. This rating should reflect the impact of this issue on your evaluation.
Detailed Description of the incident with any diagnostic information which may be available, for example Simulator log files or Java stack traces.
Test Case: Where appropriate a Java test case which illustrates the issue must be provided. The test case will help the support team to quickly diagnose the error.
We are very interested to hear your feedback on any aspect of the program. Please email comments to support@rococosoft.com.
Reporting a bug in the Simulator and Console:
As shipped, the Simulation Console only logs warnings and errors to the console window in which it was launched. In order for Rococo to locate the source of the bug, it would be very helpful if you could reproduce it with debugging output.
Edit the "manager" script and add the following flag to the java interpreter:
-Dlog4j.properties=etc/debugging-log4j.properties.
This will produce more debugging output allowing us to determine more exactly what was happening before the bug manifested itself.
Tips and Troubleshooting
Connecting to a simulator instance running remotely:
The most common usage of the simulator is for it, and the device VMs it supports, to be running on the same machine. How to tell a device to look for a remote instance of the simulator? As configured, devices look for the device discovery service in an RMI registry running at localhost:1099.
In order to have them contact a discovery service which is not registered at this endpoint, pass the following system properties to the device VM:
-Dimpronto.discovery.rmi.registry.host=remotehost
and/or
-Dimpronto.discovery.rmi.registry.port=1234
(Note that the Simulation Console may also connect to discovery service registered at a remote host using the Discovery Service... menu item in its Configure menu.)
Third Party Products
This product includes software developed by the Apache Software Foundation. Ant version 1.6.2, http://ant.apache.org, is shipped with this product. It is used to build and run Impronto Simulator demo applications. Log4j, http://logging.apache.org, is used internally by the Simulator.
The Apache Software License follows.
Apache Software License
Version 1.1
Copyright (c) 2000 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment: "This product includes software developed by the Apache Software Foundation()." Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear.
4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact apache@apache.org.
5. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation.
THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.