add MILESTONE1.md, interrupt set cursor, README.md, fix logo dikit

Author: hrshfr

MILESTONE1.md

@@ -0,0 +1,28 @@
+# Penjelasan Milestone 1 Tugas IF2230 Sistem Operasi
+## Cara kerja interrupt pada sistem operasi
+Interrupt adalah sinyal yang dikirimkan ke CPU oleh suatu entitas pada komputer sehingga CPU menghentikan seluruh aktivitasnya dan melakukan suatu eksekusi tertentu. Terdapat tiga jenis interrupt yaitu :
+### *Hardware interrupt*
+>*Hardware interrupt* dikirmkan oleh hardware eksternal sebagai sinyal penanda bahwa kini hardware tersebut membutuhkan perhatian OS. Umumnya interrupt ini dihasilkan oleh I/O *device* seperti *keyboard* ketika menerima ketikan dari pengguna. 
+### *Software interrupt*
+>*software interrupt* dikirimkan oleh suatu *software* ketika *software* tersebut ingin melakukan *system call* yaitu suatu proses yang bertujuan untuk melakukan aksi pada *hardware* komputer dengan bantuan OS.
+### *Traps*
+>*traps* merupakan suatu *interrupt* yang dihasilkan oleh CPU itu sendiri ketika menemui kondisi *error* seperti *division by zero*.
+
+Untuk dapat melakukan *interrupt* pada sistem operasi, maka digunakanlah fungsi `interrupt` dari `kernel.asm`. Fungsi `interrupt` memiliki 4 parameter yaitu `int number`, `int AX`, `int BX`, `int CX`, `int DX`. Parameter `number` diisi dengan nomor *Interrupt Request*(IRQ) dalam hexadecimal, pada milestone 1 ini kami menggunakan *interrupt* 10 dan *interrupt* 16. Kemudian, parameter `AX`, `BX`, `CX`, `DX` diisi dengan suatu nilai hexadecimal yang ingin dimasukkan ke dalam register terkait agar fungsi dalam interrupt yang terpanggil sesuai. 
+
+## Cara kerja kode pada kernel.asm
+Berikut ini adalah fungsi-fungsi yang terdapat dalam `kernel.c` dengan penjelasannya.
+### makeInterrupt21
+> Fungsi ini digunakan untuk melakukan *system call* pada sistem.
+### printString
+> Fungsi ini digunakan untuk mencetak suatu string ke dalam layar. Parameter dari fungsi ini adalah sebuah string yang akan dicetak. Kemudian untuk mencetak string, dilakukan iterasi per karakter hingga ditemukan *null terminator* untuk dilakukan pencetakan karakter oleh *interrupt* 10 dengan `AH` berisi 0Eh dan `AL` berisi karakter yang ingin ditulis.
+### readString
+> Fungsi ini digunakan untuk membaca string dari input pengguna melalui *keyboard*. Parameter dari fungsi ini adalah pointer alamat penyimpanan string. Kami membatasi panjangnya string yang dapat dibaca sepanjang 16 karakter sehingga pembacaan karakter dari input pengguna dilakukan hingga diterima input `\r` atau panjang string sudah mencapai 16 karakter. Pembacaan karakter dari *keyboard* pengguna dilakukan dengan *interrupt* 16 dengan AX bernilai 0.
+### clear
+> Fungsi ini digunakan untuk mengosongkan buffer penyimpanan string dengan cara mengeset tiap elemen array menjadi 0.  
+### lineLogo
+> Fungsi ini digunakan untuk mencetak 1 baris ASCII art logo dengan menggunakan fungsi `putInMemory` untuk mencetak tiap karakter.
+### logo
+> Fungsi ini digunakan untuk memanggil fungsi lineLogo untuk seluruh baris ASCII art logo.
+### main
+> Pada `main`, kami pertama-tama menyiapkan buffer character sepanjang 16 karakter (panjang string maksimal yang kami atur), kemudian kami memanggil `interrupt 10` untuk berpindah ke mode grafis dan mengosongkan layar. Setelah itu, kami memanggil fungsi `printLogo` untuk mencetak logo ASCII pada layat. Lalu, kami memanggil fungsi `readString` untuk membaca input dari pengguna dan menyimpannya pada buffer yang sudah kami siapkan sebelumnya. Kemudian, kami memanggil fungsi `printstring` untuk mencetak string yang tersimpan dalam buffer. Terakhir, kami memanggil fungsi `clear` untuk mengosongkan kembali isi buffer.

README.md

@@ -1,9 +1,26 @@
-# Tugas Besar 1 IF2230 Sistem Operasi
-
-
-# Kelompok PushOS!
-13519116 Jeane Mikha Erwansyah
-
-13519131 Hera Shafira
-
-13519139 I Gede Govindabhakta
+# Milestone 1 Tugas Besar IF2230 Sistem Operasi
+## Cara menjalankan OS
+1. Pastikan seluruh dependensi telah ter-install di komputer.
+2. Buat disk image dengan memasukkan command `dd if=/dev/zero of=system.img bs=512 count=2880` ke dalam terminal.
+3. Kompilasi bootloader dengan command `nasm bootloader.asm -o bootloader`
+4. Masukkan bootloader ke dalam disk image dengan command `dd if=bootloader of=system.img bs=512 count=1 conv=notrunc`
+5. Buka terminal dan pindah ke folder `sistem-operasi-pushos`.
+6. Masukkan command `make run clean` ke dalam terminal.
+7. Tunggu hingga window Bochs terbuka, apabila window Bochs sudah terbuka maka OS sudah dapat digunakan.
+## Alternatif Cara menjalankan OS
+Apabila tidak berhasil menggunakan `Makefile`, ganti lah langkah 6 dengan memasukkan command berikut:
+>`bcc -ansi -c -o kernel.o kernel.c`  
+>`nasm -f as86 kernel.asm -o kernel_asm.o`  
+>`ld86 -o kernel -d kernel.o kernel_asm.o`  
+>`dd if=kernel of=system.img bs=512 conv=notrunc seek=1`  
+## Dependensi
+* Netwide Assembler
+* Bruce C Compiler
+* Id86
+* Bochs
+## File Markdown MILESTONE1
+[MILESTONE 1](./MILESTONE1.md)
+## Anggota Kelompok PushOS
+* 13519116 Jeane Mikha Erwansyah
+* 13519131 Hera Shafira
+* 13519139 I Gede Govindabhakta

bmpToBin.c renamed to src/bmpToBin.c

@@ -78,3 +78,4 @@ _interrupt21ServiceRoutine:
 	pop dx
 
 	iret
+	

src/kernel.asm

@@ -3,23 +3,20 @@ void printString(char * string);
 void readString(char * string);
 void clear(char *buffer, int length);
 void printLogo();
-void logo(char * string, int y);
+void lineLogo(char * string, int y);
 
 #define VIDMEM 0xB000
 #define OFFSET 0x8000
 
 int main() {
   char tes[16];
-  interrupt(0x10, 0x0003, 0, 0);
+  interrupt(0x10, 0x0003, 0, 0, 0);
   printLogo();
-  // makeInterrupt21();
-  // readString(tes);
-  // tes[0]='A';
-  // tes[1]='B';
-  // tes[2]='C';
-  // tes[3]='\0';
-  // printString(tes);
-  // clear(tes,16);
+  interrupt(0x10, 0x0200, 0 , 0, 0x0C00);
+  printString("Masukkan input : ");
+  readString(tes);
+  printString(tes);
+  clear(tes,16);
   while (1);
 }
 
@@ -66,20 +63,20 @@ void clear(char *buffer, int length) {
 }
 
 void printLogo() {
-  logo("      `...........`   `...`      ...`   `.....``  `..`     `..`",0);
-  logo("      `...........`   `...`      ...`   `.....``  `..`     `..`",1);
-  logo("      ..............` `....     `.... `.........` ....    `....",2);
-  logo("      .....`````..... `....     `.... ....`  ```  ....    `....",3);
-  logo("      ..--`     `.... `....     ..... .....``     ....``` `....",4);
-  logo("      //ooo+:-...-:////. -:-..     :o/:. `../+oo/.   ..-/+oo+:-",5);
-  logo("      +ooo+//:-:::.`  /oo+:     /ooo/   `-/oooo+``+ooooooooo+//",6);
-  logo("      +ooo:  ``````.  -ooo+`   `/ooo:      .+ooo:`oooo.```-ooo+",7);
-  logo("      +ooo:  -------.  /ooo+:-:+ooo/``/+/:-:+ooo.`ooo+`   -ooo+",8);
-  logo("      /ooo-  +++++:.-. `-+ooooooo+-` `+ooooooo+- `ooo+`   .ooo/",9);
-  logo("      `-:.  .++++++:--.` ``.-:-.`` `` ``.-::-.` ` `--` `.  .--`",10);
+  lineLogo("           `...........`   `...`      ...`   `.....``  `..`     `..`",0);
+  lineLogo("           `...........`   `...`      ...`   `.....``  `..`     `..`",1);
+  lineLogo("           ..............` `....     `.... `.........` ....    `....",2);
+  lineLogo("           .....`````..... `....     `.... ....`  ```  ....    `....",3);
+  lineLogo("           ..--`     `.... `....     ..... .....``     ....``` `....",4);
+  lineLogo("           //ooo+:-...-:////. -:-..     :o/:. `../+oo/.   ..-/+oo+:-",5);
+  lineLogo("           +ooo+//:-:::.`  /oo+:     /ooo/   `-/oooo+``+ooooooooo+//",6);
+  lineLogo("           +ooo:  ``````.  -ooo+`   `/ooo:      .+ooo:`oooo.```-ooo+",7);
+  lineLogo("           +ooo:  -------.  /ooo+:-:+ooo/``/+/:-:+ooo.`ooo+`   -ooo+",8);
+  lineLogo("           /ooo-  +++++:.-. `-+ooooooo+-` `+ooooooo+- `ooo+`   .ooo/",9);
+  lineLogo("           `-:.  .++++++:--.` ``.-:-.`` `` ``.-::-.` ` `--` `.  .--`",10);
 }
 
-void logo(char * string, int y) {
+void lineLogo(char * string, int y) {
   int j = 0;
   while (string[j] != '\0') {
     putInMemory(VIDMEM, OFFSET + (80 * y + j) * 2, string[j]);
@@ -92,7 +89,7 @@ void logo(char * string, int y) {
       putInMemory(VIDMEM, OFFSET + (80 * y + j) * 2 + 1, 0x9);
       break;
     default:
-      break;
+     putInMemory(VIDMEM, OFFSET + (80 * y + j) * 2 + 1, 0xF);
     }
   }
 }