pavelkalas/aster-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Rozšíření Aster API, ať se s tím líp dělá

Browse Source 
Přidal jsem hromadu user-friendly funkcí do API (konzole, čas, paměť, vstup, procesy, AsterFS, string helpery), plus jsem to celé napojil i do syscall vrstvy, aby to drželo pohromadě i do budoucna pro user-space.\n\nDělal jsem to ve stejném stylu komentářů jako zbytek projektu a nechal jsem tam praktické helpery, které pokryjí většinu běžných app use-casů bez zbytečného boilerplate.
This commit is contained in:
pavelkalas
2026-07-12 19:08:31 +02:00
parent 549ce1f7c0
commit 644f659284
4 changed files with 511 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
include/aster_api.h
+101 -2
View File
@@ -15,21 +15,120 @@
#define ASTER_API_H
#include "types.h"
#include "storage.h"
#define ASTER_APP_API_VERSION 1
#define ASTER_APP_API_VERSION 2
#define ASTER_API_CAP_CONSOLE (1U << 0)
#define ASTER_API_CAP_TIME (1U << 1)
#define ASTER_API_CAP_MEMORY (1U << 2)
#define ASTER_API_CAP_INPUT (1U << 3)
#define ASTER_API_CAP_STORAGE (1U << 4)
#define ASTER_API_CAP_PROCESS (1U << 5)
#define ASTER_API_OK 0
#define ASTER_API_ERR_INVALID -1
#define ASTER_API_ERR_NOT_FOUND -2
#define ASTER_API_ERR_NO_SPACE -3
#define ASTER_API_ERR_ALREADY -4
typedef struct {
usize total_pages;
usize free_pages;
usize used_pages;
} aster_api_memory_info_t;
typedef struct {
u32 pid;
u8 state;
u8 priority;
const char *name;
} aster_api_process_info_t;
typedef struct {
char name[ASTERFS_NAME_LEN];
u8 is_dir;
u16 size;
} aster_api_dirent_t;
typedef void (*aster_api_dirent_cb)(const aster_api_dirent_t *entry, void *user);
typedef struct {
u32 api_version;
u32 reserved;
u32 capabilities;
u64 boot_ticks;
} aster_app_context_t;
/*
* Inicializuje kontext aplikace a vyplni verzi API, capability masku
* a aktualni hodnotu boot tiku. Vraci ASTER_API_OK nebo chybu.
*/
int aster_api_context_init(aster_app_context_t *ctx);
/*
* Konzolove API pro vypis textu, cisteni obrazovky a praci s kurzorem.
*/
int aster_api_print(const char *text);
int aster_api_print_line(const char *text);
int aster_api_clear(void);
int aster_api_set_color(u8 fg, u8 bg);
int aster_api_get_cursor(usize *out_row, usize *out_col);
int aster_api_set_cursor(usize row, usize col);
/*
* Casove API. Tick je globalni casovac jadra od bootu.
*/
int aster_api_ticks(u64 *out_ticks);
u64 aster_api_ticks_now(void);
int aster_api_sleep_ms(u32 ms);
/*
* Pametove API a jednoduche utility nad pameti bez zavislosti na libc.
*/
void *aster_api_alloc(usize size);
void aster_api_memset(void *dst, u8 value, usize size);
void aster_api_memcpy(void *dst, const void *src, usize size);
int aster_api_memory_info(aster_api_memory_info_t *out_info);
/*
* Vstupni API pro klavesnici.
* read_key blokuje, try_read_key je neblokujici, read_line cte cely radek.
*/
int aster_api_read_key(void);
int aster_api_try_read_key(void);
int aster_api_read_line(char *buffer, int max_len);
/*
* AsterFS API pokryvajici bezne operace nad soubory a adresari.
* Textove helpery zajistuji nulovy terminator pri cteni textu.
*/
int aster_api_file_create(const char *path);
int aster_api_dir_create(const char *path);
int aster_api_file_remove(const char *path);
int aster_api_dir_remove(const char *path);
int aster_api_path_exists(const char *path);
int aster_api_file_exists(const char *path);
int aster_api_dir_exists(const char *path);
int aster_api_file_read(const char *path, u8 *out, u16 max_len);
int aster_api_file_write(const char *path, const u8 *data, u16 len);
int aster_api_file_read_text(const char *path, char *out, u16 max_len);
int aster_api_file_write_text(const char *path, const char *text);
int aster_api_list_dir(const char *path, aster_api_dirent_cb cb, void *user);
/*
* Procesove API pro spawn, introspekci tabulky procesu a voluntary yield.
*/
int aster_api_process_spawn(void (*entry)(void), const char *name, u8 priority);
int aster_api_process_count(usize *out_count);
int aster_api_process_current(aster_api_process_info_t *out_info);
int aster_api_process_get(usize index, aster_api_process_info_t *out_info);
int aster_api_yield(void);
/*
* String utility API urcene pro aplikace bez standardni knihovny C.
*/
usize aster_api_str_len(const char *text);
int aster_api_str_equal(const char *a, const char *b);
int aster_api_str_starts_with(const char *text, const char *prefix);
#endif
include/syscall.h
+30
View File
@@ -19,6 +19,21 @@
#define SYSCALL_WRITE 0
#define SYSCALL_ALLOC 1
#define SYSCALL_PROCESS_CREATE 2
#define SYSCALL_CLEAR 3
#define SYSCALL_TICKS 4
#define SYSCALL_SLEEP_MS 5
#define SYSCALL_READ_KEY 6
#define SYSCALL_TRY_READ_KEY 7
#define SYSCALL_READ_LINE 8
#define SYSCALL_FS_CREATE_FILE 9
#define SYSCALL_FS_READ_FILE 10
#define SYSCALL_FS_WRITE_FILE 11
#define SYSCALL_FS_CREATE_DIR 12
#define SYSCALL_FS_REMOVE_FILE 13
#define SYSCALL_FS_REMOVE_DIR 14
#define SYSCALL_PROCESS_COUNT 15
#define SYSCALL_PROCESS_CURPID 16
#define SYSCALL_YIELD 17
void syscall_init(void);
u64 syscall_dispatch(u64 id, u64 a1, u64 a2, u64 a3, u64 a4);
@@ -26,5 +41,20 @@ u64 syscall_dispatch(u64 id, u64 a1, u64 a2, u64 a3, u64 a4);
u64 aster_write(const char *text);
void *aster_alloc(usize size);
i64 aster_process_create(void (*entry)(void), const char *name, u8 priority);
u64 aster_clear(void);
u64 aster_ticks(void);
u64 aster_sleep_ms(u64 ms);
i64 aster_read_key(void);
i64 aster_try_read_key(void);
i64 aster_read_line(char *buffer, i64 max_len);
i64 asterfs_create_file_sys(const char *path);
i64 asterfs_read_file_sys(const char *path, u8 *out, u16 max_len);
i64 asterfs_write_file_sys(const char *path, const u8 *data, u16 len);
i64 asterfs_create_dir_sys(const char *path);
i64 asterfs_remove_file_sys(const char *path);
i64 asterfs_remove_dir_sys(const char *path);
i64 aster_process_count_sys(void);
i64 aster_process_current_pid(void);
u64 aster_yield(void);
#endif