ZealOS/docs/Demo/Asm/AsmHelloWorld.html
2021-07-03 02:47:45 -04:00

79 lines
6.7 KiB
HTML
Executable file

<!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=US-ASCII">
<meta name="generator" content="ZealOS V0.05">
<style type="text/css">
body {background-color:#000000;}
.cF0{color:#ffffff;background-color:#000000;}
.cF1{color:#3465a4;background-color:#000000;}
.cF2{color:#4e9a06;background-color:#000000;}
.cF3{color:#06989a;background-color:#000000;}
.cF4{color:#a24444;background-color:#000000;}
.cF5{color:#75507b;background-color:#000000;}
.cF6{color:#ce982f;background-color:#000000;}
.cF7{color:#bcc0b9;background-color:#000000;}
.cF8{color:#555753;background-color:#000000;}
.cF9{color:#729fcf;background-color:#000000;}
.cFA{color:#82bc49;background-color:#000000;}
.cFB{color:#34e2e2;background-color:#000000;}
.cFC{color:#ac3535;background-color:#000000;}
.cFD{color:#ad7fa8;background-color:#000000;}
.cFE{color:#fce94f;background-color:#000000;}
.cFF{color:#000000;background-color:#000000;}
</style>
</head>
<body>
<pre style="font-family:courier;font-size:10pt">
<a name="l1"></a><span class=cF2>/*Asm labels can only be defined once</span><span class=cF0>
<a name="l2"></a></span><span class=cF2>in a task. &lt;F5&gt; will spawn a new task</span><span class=cF0>
<a name="l3"></a></span><span class=cF2>each time, so you don't get redefine</span><span class=cF0>
<a name="l4"></a></span><span class=cF2>error, like when repeatedly #including</span><span class=cF0>
<a name="l5"></a></span><span class=cF2>it from the cmd line.</span><span class=cF0>
<a name="l6"></a>
<a name="l7"></a></span><span class=cF2>These are many useful kernel</span><span class=cF0>
<a name="l8"></a></span><span class=cF2>routines </span><a href="https://www.tomawezome.github.io/ZealOS/Kernel/StrA.html#l56"><span class=cF4>::/Kernel/StrA.CC</span></a><span class=cF0>
<a name="l9"></a></span><span class=cF2>intended to be called from</span><span class=cF0>
<a name="l10"></a></span><span class=cF2>asm. Generally, they preserve</span><span class=cF0>
<a name="l11"></a></span><span class=cF2>regs.</span><span class=cF0>
<a name="l12"></a>
<a name="l13"></a></span><span class=cF2>You can call any routine you</span><span class=cF0>
<a name="l14"></a></span><span class=cF2>like, C or asm, if you import it.</span><span class=cF0>
<a name="l15"></a></span><span class=cF2>Be aware that C routines do not</span><span class=cF0>
<a name="l16"></a></span><span class=cF2>preserve RAX,RBX,RCX,RDX,R8,R9.</span><span class=cF0>
<a name="l17"></a></span><span class=cF2>When calling from the shell or</span><span class=cF0>
<a name="l18"></a></span><span class=cF2>from C, preserve all other regs.</span><span class=cF0>
<a name="l19"></a>
<a name="l20"></a></span><span class=cF2>*/</span><span class=cF0>
<a name="l21"></a>
<a name="l22"></a></span><span class=cF1>asm</span><span class=cF0> {
<a name="l23"></a></span><span class=cF2>//Opcodes are slightly different to make writing the x86_64 assembler easier.</span><span class=cF0>
<a name="l24"></a></span><span class=cF2>//See </span><a href="https://www.tomawezome.github.io/ZealOS/Compiler/OpCodes.html#l1"><span class=cF4>::/Compiler/OpCodes.DD</span></a><span class=cF2>.</span><span class=cF0>
<a name="l25"></a>
<a name="l26"></a>MY_WORLD_MESSAGE:
<a name="l27"></a></span><span class=cF2>//Define U8 does not put terminating zeros</span><span class=cF0>
<a name="l28"></a></span><span class=cF2>//on strings.</span><span class=cF0>
<a name="l29"></a> </span><span class=cF1>DU8</span><span class=cF0> </span><span class=cF6>&quot;World\n&quot;</span><span class=cF0>, </span><span class=cFE>0</span><span class=cF0>;
<a name="l30"></a>
<a name="l31"></a></span><span class=cF2>//The convention is to put an underscore</span><span class=cF0>
<a name="l32"></a></span><span class=cF2>//on C callable asm routines.</span><span class=cF0>
<a name="l33"></a>_HELLO_WORLD::
<a name="l34"></a> </span><span class=cF1>PUSH</span><span class=cF0> </span><span class=cFC>RSI</span><span class=cF0> </span><span class=cF2>//See </span><a href="https://www.tomawezome.github.io/ZealOS/Kernel/KernelA.html#l1938"><span class=cF4>REGG_LOCAL_VARS</span></a><span class=cF2> &amp; </span><a href="https://www.tomawezome.github.io/ZealOS/Kernel/KernelA.html#l1939"><span class=cF4>REGG_LOCAL_NON_PTR_VARS</span></a><span class=cF0>
<a name="l35"></a> </span><span class=cF1>MOV</span><span class=cF0> </span><span class=cFC>RCX</span><span class=cF0>, </span><span class=cFE>10</span><span class=cF0>
<a name="l36"></a>@@05: </span><span class=cF1>MOV</span><span class=cF0> </span><span class=cFC>RAX</span><span class=cF0>, </span><span class=cFC>RCX</span><span class=cF0>
<a name="l37"></a> </span><span class=cF1>CALL</span><span class=cF0> </span><span class=cFD>PUT_HEX_U8</span><span class=cF0>
<a name="l38"></a> </span><span class=cF1>MOV</span><span class=cF0> </span><span class=cFC>RAX</span><span class=cF0>, </span><span class=cF3>CH_SPACE</span><span class=cF0>
<a name="l39"></a> </span><span class=cF1>CALL</span><span class=cF0> </span><span class=cFD>PUT_CHARS</span><span class=cF0>
<a name="l40"></a> </span><span class=cF1>MOV</span><span class=cF0> </span><span class=cFC>RAX</span><span class=cF0>, </span><span class=cF6>'Hello '</span><span class=cF0> </span><span class=cF2>//Supports multi-byte char consts</span><span class=cF0>
<a name="l41"></a> </span><span class=cF1>CALL</span><span class=cF0> </span><span class=cFD>PUT_CHARS</span><span class=cF0>
<a name="l42"></a></span><span class=cF2>//We broke it in two pieces to show different ways.</span><span class=cF0>
<a name="l43"></a> </span><span class=cF1>MOV</span><span class=cF0> </span><span class=cFC>RSI</span><span class=cF0>, MY_WORLD_MESSAGE
<a name="l44"></a> </span><span class=cF1>CALL</span><span class=cF0> </span><span class=cFD>PUT_STR</span><span class=cF0>
<a name="l45"></a> </span><span class=cF1>LOOP</span><span class=cF0> @@05
<a name="l46"></a> </span><span class=cF1>POP</span><span class=cF0> </span><span class=cFC>RSI</span><span class=cF0>
<a name="l47"></a> </span><span class=cF1>RET</span><span class=cF0>
<a name="l48"></a>};
<a name="l49"></a>
<a name="l50"></a></span><span class=cF5>Call</span><span class=cF0>(_HELLO_WORLD);
</span></pre></body>
</html>