Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
Jede Jede authored and Jede Jede committed Feb 14, 2024
1 parent fb08748 commit 6aa4e6b
Show file tree
Hide file tree
Showing 13 changed files with 10,325 additions and 267 deletions.
4 changes: 2 additions & 2 deletions developer_manual/buildrom/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5284,7 +5284,7 @@ <h2 id="guideline">Guideline</h2>
<p>C language can be used for bank, but the 16KB of a bank is quickly filled with C code.</p>
</li>
<li>
<p><a href="/home/orixsdk/">orix-sdk</a> must be intensively used, and if it can't be used, kernel primitives must be used. If a universal feature is missing in kernel, it's better to insert into kernel than develop only for the ROM.</p>
<p><a href="/developer_manual/orixsdk_macros/overview/">orix-sdk</a> must be intensively used, and if it can't be used, kernel primitives must be used. If a universal feature is missing in kernel, it's better to insert into kernel than develop only for the ROM.</p>
</li>
<li>
<p>Each rom contains 1 or X commands.</p>
Expand Down Expand Up @@ -5312,7 +5312,7 @@ <h3 id="rom-definition">Rom definition</h3>
<h2 id="zero-page">Zero page</h2>
<p>userzp is equal to $8C. It's a range from $8C to $8C+16 which is saved for each process, when a process is forked</p>
<p>Kernel uses some address in zero page. But userzp to userzp+16 offset are reserved for binary, Orix banks. Address below userzp can be used, but kernel could erase it when IRQ or Kernels calls are performed</p>
<p>Kernel saves 16 bytes (zeropage) when a binary is forked. It means that, a <a href="../../kernel/primitives/xexec">XEXEC</a> calls in a binary, kernel will save PPID offset from userzp to userzp+16, and kernel will restore theses offsets when the PID has finished. In the future, multitasking will work in the same ways, and there is no guarantee that a binary will have its values restores when offset are greater than userzp+16</p>
<p>Kernel saves 16 bytes (zeropage) when a binary is forked. It means that, a <a href="/kernel/primitives/xexec">XEXEC</a> calls in a binary, kernel will save PPID offset from userzp to userzp+16, and kernel will restore theses offsets when the PID has finished. In the future, multitasking will work in the same ways, and there is no guarantee that a binary will have its values restores when offset are greater than userzp+16</p>
<h2 id="launch-the-rom">Launch the ROM</h2>
<h3 id="oricutron">Oricutron</h3>
<p>If it's a rom which must be in a ram slot, the config file (twilighte.cfg) must be set it in in bankram section or else insert it in bankrom section.</p>
Expand Down
4 changes: 2 additions & 2 deletions docs/developer_manual/buildrom.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Some existing roms are in a eeprom slot (kernel, shell, monitor, forth ..). Syst

* C language can be used for bank, but the 16KB of a bank is quickly filled with C code.

* [orix-sdk](/home/orixsdk/) must be intensively used, and if it can't be used, kernel primitives must be used. If a universal feature is missing in kernel, it's better to insert into kernel than develop only for the ROM.
* [orix-sdk](/developer_manual/orixsdk_macros/overview/) must be intensively used, and if it can't be used, kernel primitives must be used. If a universal feature is missing in kernel, it's better to insert into kernel than develop only for the ROM.

* Each rom contains 1 or X commands.

Expand Down Expand Up @@ -44,7 +44,7 @@ userzp is equal to $8C. It's a range from $8C to $8C+16 which is saved for each

Kernel uses some address in zero page. But userzp to userzp+16 offset are reserved for binary, Orix banks. Address below userzp can be used, but kernel could erase it when IRQ or Kernels calls are performed

Kernel saves 16 bytes (zeropage) when a binary is forked. It means that, a [XEXEC](../../kernel/primitives/xexec) calls in a binary, kernel will save PPID offset from userzp to userzp+16, and kernel will restore theses offsets when the PID has finished. In the future, multitasking will work in the same ways, and there is no guarantee that a binary will have its values restores when offset are greater than userzp+16
Kernel saves 16 bytes (zeropage) when a binary is forked. It means that, a [XEXEC](/kernel/primitives/xexec) calls in a binary, kernel will save PPID offset from userzp to userzp+16, and kernel will restore theses offsets when the PID has finished. In the future, multitasking will work in the same ways, and there is no guarantee that a binary will have its values restores when offset are greater than userzp+16

## Launch the ROM

Expand Down
1 change: 1 addition & 0 deletions docs/kernel/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
test
45 changes: 0 additions & 45 deletions index.md~

This file was deleted.

Loading

0 comments on commit 6aa4e6b

Please sign in to comment.