VMware Workstation

On Time RTOS-32 programs can be executed as a guest under VMware Workstation. However, since VMware does not fully emulate a real PC, some On Time RTOS-32 features may not be available or do not work as expected. On Time RTOS-32 was not designed to run on emulated hardware. Using a real target computer has none of the restrictions listed below and is therefore recommended.

The following settings are recommended if you would like to run the RTTarget-32 Debug Monitor as a guest under VMware.

Create a virtual machine with at least 16M of RAM. All demo programs included with On Time RTOS-32 need 16M of RAM. With a customized .cfg file, most demos will also work with less.
To work around a bug in VMware's emulated interrupt controller, apply Bootflag BF_NO_FNESTED.
Configure the virtual machine's COM1 port to be implemented as a pipe, for example "\\.\pipe\vcom". Select This end is the server and The other end is an application. Use the same pipe name for the Port parameter in Rttarget.ini and use COM1 in the COMPort command. Alternatively, you can cross debug over Ethernet.
For improved download performance, instruct the Debug Monitor to execute Halt when waiting for data from the host. This is achieved using option Halt in the COMPort command.
To improve host performance, instruct your application to execute Halt when it is idle. For programs not using RTKernel-32, this can be achieved by executing:
```
RTIdleHandler = (void(*)(void))RTHaltCPL3;
```
Programs using RTKernel-32 should set RTKConfig.DriverFlags DF_IDLE_HALT and enable preemptions by setting RTKConfig.Flags flag RF_PREEMPTIVE before calling RTKernelInit.
If your program uses file I/O, configure a virtual hard disk for the virtual machine. Note that such virtual disks are initially unpartitioned and unformatted and RTFiles-32 will not mount them in this state (use Partdemo to prepare such disks).
An attempt to use a CD-ROM or DVD drive in the virtual machine may crash VMware and the host.
If your program uses RTIP-32, set the Ethernet device type to LANCE_DEVICE and enable one network adapter in the virtual machine.
If your program uses RTUSB-32, set RTUSBConfig.ControlTimeout to 5000 to accommodate for the slow emulation of the USB host controller. Do not plug more than two USB devices into the host PC's USB ports while the VM has the focus. When more than two USB devices are present, VMware may crash. VMware does not emulate USB hubs. USB hubs will not be visible to the virtual machine.
Use Bootdisk to create a floppy boot image file of the Monitor. Boot the target from that floppy image.

An On Time RTOS-32 program executing on a virtual target does not exhibit real-time behavior.

Technical support for VMware is available from VMware, Inc and not from On Time.

Left Running on a Virtual Target

Virtual PC