sejo
/
compudanzas
2
3
Fork 3
Code Issues Pull Requests Projects Releases Wiki Activity

updated usage, installation and toolchain section

This commit is contained in:
sejo 2024-03-09 13:35:02 +01:00
parent f7783b9e0e
commit dd87cd2837
2 changed files with 21 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
src/roadmap.gmo
View File

@ -29,7 +29,6 @@ implement the following concepts as {coloring computers}:
## tutorial
* check links / update links
* (re)download uxn, set up dev pipeline
* check new instructions? and check changes in opcodes - for assembled rom in day 1
* check current color theme: Background/alpha, Selection, Foreground, Application
* update images if needed

39
src/uxn_tutorial_day_1.gmo
View File

@ -157,20 +157,29 @@ once the cpu reads a byte, it decodes it as an instruction and performs it.
the instruction will normally imply a change in the stack(s), and sometimes it may imply a change of the normal flow of the program counter: instead of pointing to the next byte in memory, it can be made to point elsewhere, "jumping" from a place in memory to another.
# installation and toolchain
# usage, installation and toolchain
to run varvara, you have several options: running it from your (web)browser, downloading it as a pre-built application, or building it from source yourself.
## online: learn-uxn site
you can experiment with all the materials in the tutorial using the learn-uxn site by metasyn:
=> https://metasyn.srht.site/learn-uxn/ learn-uxn by metasyn
## desktop bundles
in order to run varvara locally and off the grid we need to get an appropriate emulator.
the 100R website allows you to download the emulators for major desktop systems; these come bundled with a selection of program in the form of "roms":
the 100R website allows you to download the emulators for major desktop systems; these come bundled with a selection of programs in the form of "roms":
=> https://100r.co/site/uxn.html 100R — uxn
depending on your system, you might be able to launch the emulator (uxnemu) with a double-click, or you might need to use a console to navigate to its location and run it:
depending on your system, you might be able to launch the emulator (Uxn32.exe or uxnemu) with a double-click, or you might need to use a console to navigate to its location and run it:
```
$ ./uxnemu
# in Linux/Unix:
$ ./uxnemu launcher.rom
```
that's it! you will be greeted by a screen corresponding to the launcher rom.
@ -181,10 +190,10 @@ from there you will be able to run the other roms by clicking them, pressing Ent
these are the controls you can use within uxnemu, regardless of the rom that you are running:
* F1 circles between different zoom levels
* F2 toggles the debugger
* F3 takes a screenshot of the window
* F4 loads the launcher.rom that lets you browse and open roms in the current directory
* F1 circles between different zoom levels.
* F2 toggles the debugger.
* F3 takes a screenshot of the window.
* F4 loads the launcher.rom that lets you browse and open roms in the current directory.
## building from source
@ -192,19 +201,13 @@ alternatively, you can get the sources from the uxn git repository, where you wi
=> https://git.sr.ht/~rabbits/uxn ~rabbits/uxn - sourcehut git
## online: learn-uxn site
finally, you can try and experiment with all the materials in the tutorial with the learn-uxn site by metasyn:
=> https://metasyn.srht.site/learn-uxn/ learn-uxn by metasyn
## the toolchain
depending on your system, you might see that besides uxnemu there are a couple of other programs, uxnasm and uxncli.
depending on your system, you might see that besides uxnemu or uxn32 there are a couple of other programs, uxnasm and uxncli.
* uxnemu is the full-featured emulator
* uxncli is a console-based emulator
* uxnasm is an uxntal assembler
* uxnemu or uxn32 are the full-featured emulators.
* uxncli is a console-based emulator.
* uxnasm is an uxntal assembler.
during this journey we will be writing our programs in uxntal, the assembly language for uxn machines.