🇧🇷 Português (Brasil)
Este repositório contém bibliotecas e macros importantes para o desenvolvimento de utilitários para o Hexagonix.
As bibliotecas da libasm são classificadas em bibliotecas Hexagonix e bibliotecas Estelar (antigas bibliotecas Andromeda). As bibliotecas Hexagonix são responsáveis por permitir o acesso dos utilitários e aplicativos à API exposta pelo sistema, seja chamadas de sistema do Hexagon (kernel) ou outras funções em ambiente de usuário. Já as bibliotecas Estelar são responsáveis por expor funções úteis para o desenvolvimento de interfces gráficas baseadas em texto (TUI) e interfaces gráficas (GUI) sobre o Hexagonix. As bibliotecas gráficas consistem de funções em modo núcleo expostas pelo Hexagon, bem como funções em modo usuário implementadas nas próprias bibliotecas. As bibliotecas podem estar disponíveis para os montadores compatíveis (flat assembler e NASM).
Para obter mais informações sobre as chamadas de sistema do Hexagon, leia a documentação aqui.
As bibliotecas Hexagonix compreendem vários componentes que permitem ao aplicativo interagir com o Hexagon, outros aplicativos e com dispositivos padrão. Até o momento, as bibliotecas Hexagonix são constituídas pelos seguintes arquivos:
hexagon.s: biblioteca que permite ao aplicativo realizar chamadas de sistema ao Hexagon, usando a API exposta pelo kernel;dev.s: fornece nomes e dados de dispositivos utilizados em chamadas de sistema;errors.s: funções e códigos para manipulação de erros, bem como definições de erros padrão;HAPP.s: funções para criação de cabeçalhos HAPP sob demanda e manipulação de imagens HAPP em modo usuário;log.s: macros e dados para enviar mensagens pelo sistema de mensagens do Hexagon;macros.s: macros úteis para uso global ao realizar chamadas de sistema em assembly, como open();verUtils.s: funções para processar arquivos no formato OCL e obter dados de versão e atualização do sistema de forma dinâmica pelos utilitários compatíveis.
Uma lista de chamadas de sistema disponíveis está disponível aqui.
As bibliotecas Estelar estão dentro do diretório Estelar, e são compostas pelos seguintes arquivos, até o momento:
estelar.s: biblioteca padrão para renderização e manipulação gráfica;bigbang.s: biblioteca padrão para manipular dispositivos de som compatíveis.
Você pode encontrar exemplos de implementação de utilitários em modo texto e gráfico para analisar sua construção. Sinta-se a vontade de abrir uma issue para sanar qualquer dívida ou relatar algum errro.
🇬🇧 English
This repository contains important libraries and macros for developing utilities for Hexagonix.
Libasm libraries are classified into Hexagonix libraries and Estelar libraries (formerly Andromeda libraries). The Hexagonix libraries are responsible for allowing utilities and applications access to the API exposed by the system, either Hexagon system calls (kernel) or other functions in the user environment. The Estelar libraries are responsible for exposing useful functions for the development of text-based graphical interfaces (TUI) and graphical interfaces (GUI) on top of Hexagonix. The graphics libraries consist of core-mode functions exposed by Hexagon, as well as user-mode functions implemented in the libraries themselves. Libraries may be available for compatible assemblers (flat assembler and NASM).
For more information on Hexagon system calls, read the documentation here.
The Hexagonix libraries comprise several components that allow the application to interact with Hexagon, other applications and standard devices. So far, Hexagonix libraries consist of the following files:
hexagon.s: library that allows the application to make system calls to Hexagon, using the API exposed by the kernel;dev.s: provides device names and data used in system calls;errors.s: functions and code for error handling, as well as standard error definitions;HAPP.s: functions for creating HAPP headers on demand and manipulating HAPP images in user mode;log.s: macros and data for sending messages through the Hexagon messaging system;macros.s: useful macros for global use when making assembly system calls, such as open();verUtils.s: functions to process files in OCL format and dynamically obtain system version and update data from supported utilities.
A list of available system calls is available here.
The Estelar libraries are inside the Estelar directory, and are composed of the following files, so far:
estelar.s: standard library for rendering and graphical manipulation;bigbang.s: standard library for handling compatible sound devices.
Licença da libasm/libasm License
Hexagonix Operating System
BSD 3-Clause License
Copyright (c) 2015-2024, Felipe Miguel Nery Lunkes
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.