Gramado OS

GramadoOS is a graphical operating system for x86_64 computers.

Gramado is a hobby operating system, not a commercial operating system, because it is a small system and has only some few features, not all the features needed by a commercial operating system.

• hw - cpu: Intel and AMD. 64bit only.
• hw - mm: Paging. Chunck of 2MB, using 4KB pages.
• hw - blk device: IDE PATA.
• hw - char device: ps/2 keyboard.
• hw - char device: ps/2 mouse works fine only on qemu.
• hw - char device: Serial port. (COM). Used for debug.
• hw - network device: e1000 Intel NIC. Works on Oracle virtual box.

• sw - Processes: Process structure and Thread structure.
• sw - Scheduler: Round robin. (Threads only).
• sw - Syscalls using software interrups. (Traps).
• sw - IPC: sockets.
• sw - IPC: System messages using a queue in the thread structure.
• sw - tty: It has 4 ring 0 kernel virtual consoles in fullscreen raw mode.
• sw - tty: General use ttys and ptys for ring3 virtual terminals.
• sw - fs: FAT16 file system for boot partition. No system partition yet.
• sw - posix libc: Ring0 implementation of libc functions called by the ring3 libraries.
• sw - network: Small support for sockets.
• sw - network: Small ring0 implementation of protocol stack. (ETHERNET, ARP, IP, UDP, TCP and DHCP).
• sw - display: Bootloader display device. VESA.
• sw - user: Very small implementation of user structure.
• sw - APIs: See zcall/ folder.
• sw - One loadable ring0 module, using static address.

• Display Server. See: userland/services/gramland/
• Unix-like commands running in the virtual console.
• Some few clients connected to the display server via unix-sockets.
• Ring3 processes can access the i/o ports via syscall. (For ring3 drivers only).

• zing/graminit/ - The init process.
• zing/gramlan0/ - Gramland, the display server.
• zing/netd/ - The network server.

• posix libc - (rtl)
• Client-sie library for GUI applications - (libgws)
• see: zz/omega1/libs/ for all the libraries, toolkits and apis.

• see: zz/omega2/apps/ for Client-side GUI application.
• see: zz/omega2/commands/ for posix commands.
• see: zz/omega2/drivers/ for ring3 drivers.
• see: zz/omega2/servers/ for ring3 servers.

• zz/omega3/assets - Icons for the User Interface.
• zz/omega3/base - All binaries go here to build the final virtual disk.

You can find the source code on Github in the internet, where you can clone the repository, contribute to the project or download the code. The address is https://github.com/gramado/gramado.

There are only two main subdirectories: core/ and desktop/. core/ is a place for the low level code and desktop/ is a place for the graphical user interface.

Gramado Kernel - core/
Gramado DE     - userland/

The next few lines has a brief description of the subdirectories:

 * `aa/` - Ring 0 first loadable module.
   * `cancun/` - Running gramado commands on Linux host.

 * `ama/` - Low level basic components of the system.  
   * `boot` - The boot loader.
   * `kernel` - The Gramado OS kernel.
   * `kmods` - Kernel module.
   * `xciting` - init process and data.

 * `boring/docs/` - Documentation.

 * `zing/` - Desktop Environment (DE).
   * `gramland` - Display server. (GRAMLAND.BIN)
   * `netd` - The network server.

 * `zz` - 
   * `omega1` - Libraries, toolkits and apis. 
   * `omega2` - apps, commands, drivers and servers. 
   * `omega3` - data 

The main developer is Fred Nora, a brazilian developer. Fred Nora is the creator and main maintainer of the project. Contributions are welcome.

$ make
$ cd ama
$ ./run

$ cd core
$ make clean-all

For now the system has been compiled on Ubuntu operating system, LTS releases.

    Host machine: Ubuntu 20.04.5 LTS
    Linux 5.4.0-146-generic x86_64
    gcc (Ubuntu) 9.4.0 
    GNU ld (GNU Binutils for Ubuntu) 2.34
    NASM version 2.14.02

    Host machine: Ubuntu 22.04.2 LTS
    Linux 5.15.0-78-generic x86_64
    gcc (Ubuntu) 11.4.0 
    GNU ld (GNU Binutils for Ubuntu) 2.38
    NASM version 2.15.05

    Host machine: Ubuntu 22.04.2 LTS
    Linux 5.15.0-83-generic x86_64
    gcc (Ubuntu) 11.4.0 
    GNU ld (GNU Binutils for Ubuntu) 2.38
    NASM version 2.15.05

    Host machine: Ubuntu 22.04.2 LTS
    Linux 5.15.0-84-generic x86_64
    gcc (Ubuntu) 11.4.0 
    GNU ld (GNU Binutils for Ubuntu) 2.38
    NASM version 2.15.05

Yes, you can test the system on a virtual machine. The system has been tested by Fred Nora on qemu, qemu with kvm and virtualbox. Now, Fred Nora is testing the system only on qemu and virtualbox.

Yes, we can test the system in the real machines. This way we can improve the system. The older versions of the system were tested for a long period of time on a real machine. That machine was a Gigabyte machine with an Intel Core 2 Duo processor and a VIA chipset.

Yes, we need some feedback. Please make some comments on Github or send messages to Fred Nora.

• Fred Nora - Fred Nora's Twitter account
• Fred Nora - Fred Nora's Facebook account

• Fred Nora - Fred Nora's Facebook account
• Fred Nora 2 - Fred Nora's Facebook account

You're reaching the boring area of this document!

See the Gramado OS build instructions

The project has a folder for documentation and design notes. The folder is docs/.

See the docs.

The project is looking for some people to create a better documentation, for free, as a contribuition to the open source community. To create this new documentation we can use the documentation in docs/ and the design notes found all over the project.

Gramado is a Free and Open Source operating system. The source code uses the BSD license.

  * "Close to the borders and beyond."
  * "Exciting"
  * "(  spontaneous)"