************************************************************ Welcome to the New QNX Realtime Platform! ************************************************************ This readme file contains the following sections: 1 - Important files 2 - Installation notes 3 - How it works 4 - Your config.sys 5 - Troubleshooting SECTION 1 - Important files ~~~~~~~~~~~~~~~~~~~~~~~~~~~ QNX realtime platform system files: These files are installed under \program files\qnx\boot\fs in windows and under /boot/fs in QNX. qnxbase.ifs The RTP boot image filesystem (DMA disabled). qnxbasedma.ifs The RTP boot image filesystem (DMA enabled). qnxbase.qfs QNX filesystem that contains everything you need to run the QNX realtime platform. root.qfs A root filesystem you create and grow to the size (max 2GB) you need. This will be your "workspace". DOS/Windows/NT installed files: These files are installed under \program files\qnx\boot\bin qmakedsk.exe Windows program to copy .dat image to floppy. dinitw32.exe Windows program to create "root.qfs". It will prompt you for how big to grow it. loadqnx.sys DOS program that reads the "qnxbase.ifs" file into memory and transfers control to it. At this point, QNX is running. DOS is gone; any memory it occupied is in our free-memory list. makecfg.exe Windows program that sets up/repairs your config.sys to boot QNX. If your config.sys gets modified and you need to fix it, try running makecfg.exe from: Start->Programs->QNX Realtime Platform->Update config.sys. uninstall.dll A special DLL used to remove the QNX entries from the config.sys. floppy.144 1.44M boot floppy image with DMA disabled. floppydma.144 1.44M boot floppy image with DMA enabled. SECTION 2 - Installation notes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To install to a partition: 1. You must have free space on your drive for a QNX partition to be installed. You can use a utility like Partition Magic or fips to resize existing partitions to make room. (600M will give you plenty of room.) 2. Copy the floppy install image to a floppy: (e.g. cp /mnt/cdrom/instflop.dat /dev/fd0H1440) If you are installing under Windows click on the 'Make Floppy' button in the DemoShield application (setup.exe on the root of the CD). 3. Boot the floppy with the CD in the drive and follow the instructions. To install in a Windows partition: * Run: ":\qnxrtp\setup.exe" Installing under Windows NT 4.0 / Millennium: -------------------------------------------- NOTE: You cannot install to a NTFS partition -- QNX will not boot from an NTFS partition. If you're installing under Windows NT/ME, then you'll need a blank formatted 1.44M floppy. If you're installing on a Windows 9x/NT dual-boot machine: 1. After the Win98 install is done, reboot your machine and boot into Win98. 2. When Win98 starts to boot, a menu appears allowing you to choose to boot into QNX or into Windows. If you're installing on an NT/ME standalone machine: 1. Format a blank 1.44M floppy. 2. Use this floppy in the install to create a boot disk. 3. Boot the machine with the floppy. You will boot directly into QNX. To install under QNX 4 (Not available on the mini-CD): 1. Login as "root". 2. Change directory to "/". 3. Run: "/etc/install -u /cd/qnxrtp.tar.F" SECTION 3 - How it works ~~~~~~~~~~~~~~~~~~~~~~~~ Here's what happens when you reboot your system and select QNX: 1. The QNX image will be loaded and in complete control. At this point, we start an IDE driver and a DOS filesystem to allow you to access your Windows filesystem. We mount the filesystem as "/fs/hd0-dos". This is where it gets interesting. 2. We next mount a QNX filesystem on the DOS file. So we're running a filesystem within a DOS file. NO NEED TO REPARTITION YOUR HARD DISK! You have access to the DOS filesystem and to the QNX filesystem. 3. If you have a CD-ROM, it will appear as "/fs/cd0". You'll see that other than the primary filesystem, we mount all other filesystems under "/fs". If you want to see the raw block devices (onto which the filesystems mount), look under "/dev". You'll see "/dev/cd0", "/dev/hd0", etc. Partitions are on top of the raw devices and have names like "/dev/hd0txx" (where xx is the partition type). 4. When you get the login prompt (ignore the verbose setup if you get this far), login as "root". SECTION 4 - Your config.sys ~~~~~~~~~~~~~~~~~~~~~~~~~~~ In order to get QNX to load, your config.sys has been set up to allow you the option to boot QNX or Windows. If your computer fails to show the boot menu with the QNX entries when you boot your computer, compare it to the sample config.sys below. If you have other menu entries or device drivers before you install QNX, they will be inserted into the correct place in the config.sys. Windows devices will be put under the [WIN] marker. Sample config.sys ----------------- [menu] menuitem=WIN, Windows menudefault=WIN,30 menuitem=QNXDMA, QNX Realtime Platform menuitem=QNX, QNX Realtime Platform (DMA Disabled) menucolor=7,0 [QNX] DEVICE=E:\PROGRA~1\QNX\boot\bin\loadqnx.sys E:\PROGRA~1\QNX\boot\fs\qnxbase.ifs [QNXDMA] DEVICE=E:\PROGRA~1\QNX\boot\bin\loadqnx.sys E:\PROGRA~1\QNX\boot\fs\qnxbas~1.ifs [WIN] [COMMON] SECTION 5 - Troubleshooting ~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Memory-detection problems. If QNX can't detect all the memory in your computer, this could be caused by the "memory hole" that some computer BIOSs use. There are two methods to get around this. One is to see if the BIOS lets you disable the memory hole. If your BIOS doesn't let you disable the memory hole (common on Compaq computers), the other method is to tell the QNX loader how much memory you really have. This is done by adding a "/Mnnn" option to QNX loader in the "config.sys" file. Here's an example for a computer with 64M of RAM: [QNX] DEVICE=C:\PROGRA~1\qnx\boot\bin\loadqnx.sys C:\PROGRA~1\qnx\boot\fs\qnxbase.ifs /M64 [QNXDMA] DEVICE=E:\PROGRA~1\QNX\boot\bin\loadqnx.sys E:\PROGRA~1\QNX\boot\fs\qnxbas~1.ifs /M64 Please be sure to specify the correct amount of memory. If you tell the loader you have 128M of RAM, the loader will believe this and try to map it. 2. Hardware-detection problems. Most hardware problems fall into these two areas: - hardware that isn't supported by QNX - older legacy hardware that runs on the ISA bus. If you have hardware that *should be* supported (as per the docs) but doesn't appear to work or be detected, please report the problem at the QNX Developer's Network (QDN). If you have ISA cards that aren't detected, you can try starting the drivers manually. For example, you could use command-line options to start an old Sound Blaster card: deva-sb -i5 -d1,5 -p0x220 3. Modems The QNX RTP supports only "real" modems at this time. If you have a winmodem or controllerless modem, you won't be able to use it. In order to get connected to the Internet, you must have a "real" modem or supported network card. Be sure to visit the QNX Developer's Network web site (http://qdn.qnx.com) for a list of supported hardware. **************************** END ***************************