update ata pio driver

Author: alexeev-prog

CHANGELOG.md

@@ -1,3 +1,9 @@
+commit a434b2841dc660887729e91eb9e92fb7e82e498e
+Author: Alexeev Bronislav <[email protected]>
+Date:   Thu Aug 28 22:15:29 2025 +0700
+
+    add ata-pio driver and improve lowlevel io driver
+
 commit 528cc20f905bd6803deb9861b83412baad1ed38a
 Author: Alexeev Bronislav <[email protected]>
 Date:   Thu Aug 28 22:00:25 2025 +0700

src/kernel/drivers/ata_pio.c

@@ -1,7 +1,7 @@
 #include "ata_pio.h"
 #include "lowlevel_io.h"
 
-// https://wiki.osdev.org/ATA_PIO_Mode
+// Источник: https://wiki.osdev.org/ATA_PIO_Mode
 
 static void ata_wait_ready() {
     while (port_byte_in(ATA_REG_STATUS) & ATA_SR_BSY);
@@ -16,13 +16,13 @@ static void ata_cache_flush() {
 void ata_read_sectors(u32 lba, u32 sector_count, const u8* buffer) {
     ata_wait_ready();
 
-    // Select drive (Master)
+    // Выбор диска (Master)
     port_byte_out(ATA_REG_DRIVE_SELECT, 0xE0 | ((lba >> 24) & 0x0F));
 
-    // Waste time
+    // Задержка для стабилизации контроллера
     port_byte_out(ATA_REG_ERROR, 0x00);
 
-    port_byte_out(ATA_REG_SECCOUNT, sector_count); // Read one sector
+    port_byte_out(ATA_REG_SECCOUNT, sector_count); // Количество секторов для чтения
     port_byte_out(ATA_REG_LBA0, (u8)(lba & 0xFF));
     port_byte_out(ATA_REG_LBA1, (u8)((lba >> 8) & 0xFF));
     port_byte_out(ATA_REG_LBA2, (u8)((lba >> 16) & 0xFF));
@@ -32,22 +32,22 @@ void ata_read_sectors(u32 lba, u32 sector_count, const u8* buffer) {
 
     for (u8 sector = 0; sector < sector_count; sector++) {
         while (!(port_byte_in(ATA_REG_STATUS) & ATA_SR_DRQ));
-        // NOTE: If bytes are entered in small endian, does it call it back the right way
-        rep_insw(ATA_REG_DATA, (void*)(&buffer[sector * SECTOR_BYTES]), SECTOR_WORDS); // 256 words (512 bytes)
+        // ПРИМЕЧАНИЕ: При чтении слов в little-endian порядок байт сохраняется корректно
+        rep_insw(ATA_REG_DATA, (void*)(&buffer[sector * SECTOR_BYTES]), SECTOR_WORDS); // 256 слов (512 байт)
     }
 }
 
 void ata_write_sectors(u32 lba, u32 sector_count, const u8* buffer) {
 
     ata_wait_ready();
 
-    // Select drive (Master)
+    // Выбор диска (Master)
     port_byte_out(ATA_REG_DRIVE_SELECT, 0xE0 | ((lba >> 24) & 0x0F));
 
-    // Waste time
+    // Задержка для стабилизации контроллера
     port_byte_out(ATA_REG_ERROR, 0x00);
 
-    port_byte_out(ATA_REG_SECCOUNT, (u8)sector_count); // Read one sector
+    port_byte_out(ATA_REG_SECCOUNT, (u8)sector_count); // Количество секторов для записи
     port_byte_out(ATA_REG_LBA0, (u8)(lba & 0xFF));
     port_byte_out(ATA_REG_LBA1, (u8)((lba >> 8) & 0xFF));
     port_byte_out(ATA_REG_LBA2, (u8)((lba >> 16) & 0xFF));
@@ -56,7 +56,7 @@ void ata_write_sectors(u32 lba, u32 sector_count, const u8* buffer) {
     for (u8 sector = 0; sector < sector_count; sector++) {
         while (!(port_byte_in(ATA_REG_STATUS) & ATA_SR_DRQ));
         for (u32 sw = 0; sw < SECTOR_WORDS; sw++) {
-            // looks like big endian
+            // Преобразование в big-endian для контроллера
             outsw(ATA_REG_DATA, ((u16)buffer[sector * SECTOR_BYTES + sw * 2 + 1]) << 8
             | (u16)(buffer[sector * SECTOR_BYTES + sw * 2]));
         }
@@ -70,7 +70,7 @@ void ata_select_drive(int is_master) {
 }
 
 void ata_identify() {
-    ata_select_drive(1); // Select master drive
+    ata_select_drive(1); // Выбор master-диска
 
     port_byte_out(ATA_REG_SECCOUNT, 0);
     port_byte_out(ATA_REG_LBA0, 0);
@@ -82,32 +82,32 @@ void ata_identify() {
 int ata_wait() {
     while (1) {
         u8 status = port_byte_in(ATA_REG_STATUS);
-        if (!(status & 0x80)) return 1; // Check BSY (Busy) bit
+        if (!(status & 0x80)) return 1; // Проверка бита BSY (занято)
     }
 }
 
 void ata_read_buffer(u16* buffer) {
-    // reads an entire sector, 256 words, 512 bytes
+    // Чтение всего сектора: 256 слов, 512 байт
     for (int i = 0; i < 256; i++) {
         buffer[i] = port_word_in(ATA_REG_DATA);
     }
 }
 
 u32 ata_get_disk_size() {
-    // 1024^2 = 1048576 (1 MiB)
+    // 1024^2 = 1048576 (1 МиБ)
     u16 ata_buffer[256];
     ata_identify();
     ata_wait();
     ata_read_buffer(ata_buffer);
     u32 total_sectors = ((u32)ata_buffer[61] << 16) | ata_buffer[60];
-    return (u32)total_sectors * 512; // Convert to bytes
+    return (u32)total_sectors * 512; // Конвертация в байты
 }
 
 void ata_read_blocks(u32 block_num, const u8* buffer, u32 count) {
     ata_read_sectors(block_num * SECTORS_PER_BLOCK, SECTORS_PER_BLOCK * count, buffer);
 }
 
-// these are wasteful, just writes past buffer, regardless of length
+// неэффективные методы: запись происходит поверх буфера без учета длины
 void ata_write_blocks(u32 block_num, const u8* buffer, u32 count) {
     ata_write_sectors(block_num * SECTORS_PER_BLOCK, SECTORS_PER_BLOCK * count, buffer);
 }