Development Kits required to build

The list of softwares you required to build Ace OS.

Build Instructions

1. Download Ace OS Source Code. Click here to go to Download page
2. Extract the downloaded zip file into a directory with Folder Names
3. Go to MS-DOS Command Prompt. Do not restart windows, you should run Command.com in windows box.
4. Change to AceOS directory
. It depends on where you extracted the downloaded zip file.
5. Make sure the path variable contains all the Development kit directories
6. Type mingw32-make and press enter
7. Now all source will be compiled to produce lot of object files. Then it link all the object files into Kernel.bin. After successfull compilation, you will get a message like the following
   ld -Ttext 0x19000 -Tdata 0x258c0 --image 0x19000 --shared -entry _KernelEntry -nostartupfiles -o Kernel.exe
   Kernel.o Processor.o Timer.o CTimer.o CKernel.o MemMan.o Heap.o DeviceDriver.o IO.o TMan.o TaskMan.o MemMove.o
   VGAText.o VGACursor.o Keyboard.o CKeyboard.o PIC.o PCI.o RTC.o GSH.o Harddisk.o HMess.o Printf.o Partition.o
   FAT.o String.o Beep.o -LC:\MinGW\lib\gcc-lib\mingw32\3.2 -LC:\MinGW\lib -lmingwex -lgcc
   
8. Now you have to create boot images. Change to Boot directory. Type make and press enter. Be carefull about your letter cases.
9. Thats all. you build the system successfully.

Boot Disk Creation

1. Change to directory Boot
2. Type make and press enter.
3. Insert a DOS formatted empty good floppy disk into drive A:
4. Type mboot.bat
and press enter. Follow on screen instruction.

Emulation with Bochs

This is a little bit harder than the above two tasks. This task is only usefull to developers. You can also debug your codes through Bochs.

1. You need BOCHS and WinImage to complete this task sucessfully. Download it.
2. Install WinImage and run it
3. Create a new Image File and insert the following files using the Insert Menu or press INS, OSLoader.bin and Kernel.exe
4. Select Boot Sector Properties... from Image menu.
5. Now click the Open button select the Boot.bin in the Ace OS Directory
6. Save the file
7. Add BOCHS directory to your path
8. Change to AceOS Directory
9. Type bochs press enter
10. Now bochs will show 5 options, select 1. Read options from...
11. When it asks for Configuration file name press enter or type bochsrc.txt
12. Now bochs will again show first 5 options, select 2. Edit options
13. In the next screen select 6. Disk options
14. Select 1. Floppy Disk 0: and enter the path and file name of the image file previosuly created.
15. Return to previous menu and Select Memory options(4)
16. Type the correct location of the files VGABIOS-elpin-2.40 and BIOS-BOCHS-LATEST. These files are located in your bochs directory.
17. Return to main menu by pressing Zeros. Save the cofiguration file by pressing 3
18. Now choose option 4. Begin Simulation
19. The above settings are only once needed. Thereafter you have to Begin Simulation straigt away.
20. If you want to debug the code run bochsdbg instead of bochs