#
# This demo starts QNX and Photon from a 1.44MB floppy disk
# The intention of this demo disk is to allow the customer to
# customise it's own demo disk with released tools, plus two 
# free tools (zip, unzip) available at www.qnx.com. 
# QNX4 and Photon are the only two products needed to build this demo.
# (Watcom C and PhAB could be convenient too if you want to change
# the applications running into Photon: cool, pterm, USP process 
# computer...)
#
# Author : Victor MARQUES, 07/02/2000. Version 0.3
# Email  : vmarques@qnx.com
#
# ========== INPORTANT NOTE in the chapter II. ==================

This Readme describe how to use or modify this demo disk.


I- How to use the Victor's Demo Disk (VDD ;-):
----------------------------------------------
1- Insert the floppy into the floppy drive and reboot your PC
2- When the demo is started you got a shell:
  2.1- the utilities 'ls' and 'sin' are available for you to take 
       a look at the running configuration.
  2.2- script_select is a shell scripts that you can launch 
       from the command line to start Photon with a list of choices
       (serial mouse, ps2 mouse, different graphic resolutions) 
       If the Input options I have put in this script don't work 
       with your mouse, you can always start Photon from your 
       hard disk and take a look at the Input options and change
       the scripts...
3- Once Photon is started a 'pterm' is available to take a look at the 
   demo. 'sin' and 'ls' are still the only system commands available. (Of 
   course, all the shell built-in commands are available too).
4- The graphic resolutions are 640x480x4 or 800x600x4 with a generic
   graphic driver. There isn't graphic acceleration but again you can 
   customise this demo to add the graphic driver you want and the 
   resolution you want according to your hardware (see in script_select).


II- How to customise the VDD:
-----------------------------
1- The archive VDD3.pax.gz contain the necessary files and  
   environment to customise your own demo disk. To install it:
    - mkdir $HOME/demos/
    - cd $HOME/demos/
    - install -u VDD3.pax.gz

2- This demo boots QNX almost as your hard disk does: 
    - with a boot image
    - with a sysinit file
    - with a shell script to start Photon and some applications

3- The archive VDD3.pax.gz contains the following directories:

    - $HOME/demos/VDD3/runtime      (to be copied to a 1.44MB floppy)
                  .../runtime/.boot     (boot image file. See ../src/)
                  .../runtime/.licenses (license file)
                  .../runtime/bin       (uncompressed binary files)  
                  .../runtime/etc       (sysinit and kbd definition files)
                  .../runtime/root      (compressed files...)
                  .../runtime/root/qnx4.zip (QNX files and drivers)								
                  .../runtime/root/demo.zip (Demo applications)
                  .../runtime/root/photon.zip (Photon files)
       
    - $HOME/demos/VDD3/src       
                  .../src/boot     ( sources for the boot image ) 
                  .../src/boot/build
                  .../src/boot/images
                  .../src/boot/sys
                  .../src/root/.photon (Photon config files)
                  .../src/root/bin   (QNX4 files to compress)
                  .../src/root/usr   (Photon files to compress)
                  .../src/root/demo  (Demo files to compress)
                  .../src/utils/     (Free utilities: zip, unzip)
                  .../src/Makefile   (To create a new demo disk)

4- In src/root all the files are compressed with the free utility: 

   --> zip  (see  src/Makefile)

   Look at "runtime/etc/config/sysinit" to see how to decompress
   all these files into a RAMDISK and how to execute them from there.

5- If you need to customise this demo the main config files that you 
may have to change are: 

    runtime/etc/config/sysinit   (system initialisation file)
	src/root/.photon/pwm/pwm.menu (pwm menu)
    src/root/bin/script_select   (Photon script files)
    src/root/demo                (directory to include you own Photon
                                      applications)

6- Here are the steps to copy your demo to the floppy disk, once your changes
have been made:
 
	cd src/
	make os        (to rebuild the OS image)
    make image     (to rebuild the new ZIP archives)
    make floppy    (to rebuild the floppy)
or just:
	make           (to rebuild the floppy)

NOTE: 
"make floppy" or just "make" will call "make os" and "make image" first. 


INPORTANT NOTE:
==============
With regards to the licensing, don't forget to include your own QNX and
Photon licenses into $HOME/demos/VDD3/runtime/.licenses !!!


III- Requirements:
------------------
1- One 1.44Mb floppy disk. (2 or 3 is possible too...)
2- RAM: 6 to 7 MB.
3- Serial or PS2 mouse.
4- VGA or compatible graphic card. (640x480x4)
5- HD: Not needed


IV- To be done:
---------------
1- Automatic mouse detection and graphic detection
2- Starts directly into Photon (very easy to do in the file etc/config/sysinit)
3- Optimise disk size by removing the files which aren't mandatory (fonts,...)

