Skip to content

Commit

Permalink
Deleted binary files, improved build script & README
Browse files Browse the repository at this point in the history
- Deleted binary files (This is considered bad practice to leave binary
  files to the repository. Use releases instead if you really want such
  thing.)
- Improved build script (Added messages & customizable image output path)
- Improved `README.md` file (Depending on the above changes + added
  procedure to build & test)
  • Loading branch information
alexis-belmonte committed Mar 18, 2020
1 parent 29c8e16 commit 89e1073
Show file tree
Hide file tree
Showing 5 changed files with 68 additions and 16 deletions.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Ignores binary files
bin

42 changes: 37 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,55 @@
# AtieDOS

A 16 bit operating system made by enthusiasts to enthusiasts with love.
Current version: 2.10

# How to use it
The instructions are in /disk-images/README.md.
# How to Build

## Linux

Run the script file `build-linux.sh` at the root folder of this project.
You may be required to run `chmod +x ./build-linux.sh` before running the actual script.

## Windows

Run the batch file `build-windows.bat` at the root folder of this project.

# How to Run

## QEMU

We assume that you have the binary path of QEMU set in the `$PATH` environment variable.
Run `qemu-system-x86_64 -fda bin/floppy.img`.

# Commands
About, chset, clear, echo, help, pause, prompt, restart, shutdown, stra, write

Here is a list of available commands:
- `about`: Shows an "about" message to the screen
- `chset`: Shows a grid of the current VGA character set
- `clear`: Clears the screen
- `echo`: Echoes a message
- `help`: Shows a list of commands
- `pause`: Pauses the prompt
- `prompt`: Changes the prompt
- `restart`: Restarts the computer
- `shutdown`: Shutdowns the computer
- `stra`: String command interpreter

# Screenshot
![AtieDOS 2.10 Screenshot](/atiedos2.10.png)

![AtieDOS 2.10 Screenshot](/atiedos2.10.png)

# What's Stra?

Stra is an esoteric language created by SuperLeaf1995 and me based on Brainfuck. It is used for string manupulation.
A Stra example: +++.

# How can I collaborate?

Contact me on Discord. I am AteMellow-P#5173. My server: https://discord.gg/26Dfm5e

# Acknowledgements
Thanks to Midn this operating system works. He made the bootloader. And also I got inspired to made Stra thanks to SuperLeaf1995. Their Discord servers, respectively: https://discord.gg/BX6RBYx, https://discord.gg/ShmmEXP

Thanks to Midn this operating system works. He made the bootloader.
And also I got inspired to made Stra thanks to SuperLeaf1995.
Their Discord servers, respectively: https://discord.gg/BX6RBYx, https://discord.gg/ShmmEXP
31 changes: 28 additions & 3 deletions build-linux.sh
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,4 +1,29 @@
# You will need NASM to compile this
#!/bin/sh

output_image=bin/floppy.img

# TODO: Replace this script with proper `Makefile`.
# TODO: Perform tool checks before building.

# We check if the `bin` directory exists & create it if that's not the case
# FIXME: Do out-of-source build instead.
mkdir -p bin;

# We build the boot sector
nasm -f bin -o bin/boot.bin bootloader.asm;
printf " - Built boot sector\n";

# We generate a blank floppy disk image
dd if=/dev/zero of="$output_image" bs=512 count=2880 status=none;
printf " - Generated floppy disk image\n";

# We copy the bootsector to the floppy disk image
dd if=bin/boot.bin of="$output_image" bs=512 count=1 conv=notrunc status=none;
# We copy the remaining sectors needed to the floppy disk image
# TODO: Format your disk to FAT12, program the bootsector to load a "KERNEL.BIN" file instead. That way
# it'll be much easier to read/write files and folders, and you can even see them on DOS!
dd if=bin/boot.bin of="$output_image" bs=512 skip=1 seek=1 conv=notrunc status=none;
printf " - Copied system to floppy disk image\n";

printf "$0: generated floppy disk image to \"$output_image\"\n";

echo This program assumes that you have NASM installed and it's in your path.
nasm -f bin -o atiedos-2-10.iso bootloader.asm
8 changes: 0 additions & 8 deletions disk-images/README.md

This file was deleted.

Binary file removed disk-images/atiedos-2-10.iso
Binary file not shown.

0 comments on commit 89e1073

Please sign in to comment.