DC-SWAT Forum - Programming

Automatically generated documentation based on repository code

Mon, 28 Apr 2025 17:49:16 +0000

Automatically generated documentation based on repository code.

https://deepwiki.com/DC-SWAT/DreamShell

XDP Browser с ярлыком на рабочий стол DreamShell

Tue, 04 Mar 2025 20:39:01 +0000

XDP Browser с ярлыком на рабочий стол DreamShell. Вырезано лишнее меню, стартует прямиком в сам браузер. Поддерживает настройки модема и BBA. Есть встроенные мелодии, игры, небольшие программы. Папку из архива нужно положить в папку DS\apps\

  ds_scr_001.png (Размер: 83.25 Кб / Загрузок: 9)
  2.png (Размер: 302.99 Кб / Загрузок: 8)
  1.png (Размер: 336.99 Кб / Загрузок: 6)

Spoiler (Click to View)

MainMenu Retrodream icon app

Sun, 19 Jan 2025 02:09:23 +0000

Собрал небольшой скриптик с иконкой в виде приложения для запуска Retrodream с рабочего стола. В фале main.lua прописан путь /ide/RD/retrodream.bin по умолчанию, для того что бы из Retrodream можно было обратно вернутся в DreamShell скопируйте dc_core.bin в ту же папку DS с названием ds.bin.
По такой же схеме можно создать и другие ярлыки заменив иконку и пути к файлам.
Надеюсь кому то пригодится

retrodream.zip (Размер: 8.01 Кб / Загрузок: 6)

Help with LUA scripting.

Wed, 07 Aug 2024 08:31:24 +0000

Hi threre gang,

I'd like to offer my Dreamcast for helping out with some automated test cases.
For that I'd like DreamShell to download an iso file from a plain http server and run it at startup instead of showing the main menu.

So I'm trying to edit the DS/lua/startup.lua file:

Код:

-----------------------------------------

--                                     --

-- @name:     Startup script           --

-- @author:   SWAT                       --

-- @url:      http://www.dc-swat.ru    --

--                                     --

-----------------------------------------

--

-- Internal DreamShell lua functions:

-- 

--    OpenModule             Open module file and return ID

--    CloseModule            Close module by ID

--    GetModuleByName        Get module ID by module NAME

--

--    AddApp                 Add app by XML file, return app NAME

--    OpenApp                Open app by NAME (second argument for args)

--    CloseApp               Close app by NAME (second argument for change unload flag)

--

--    ShowConsole

--    HideConsole

--    SetDebugIO             Set the debug output (scif, dclsocket, fb, ds, sd). By default is ds.

--    Sleep                  Sleep in current thread (in ms)

--    MapleAttached          Check for attached maple device

--

--    Bit library:           bit.or, bit.and, bit.not, bit.xor

--    File system library:   lfs.chdir, lfs.currentdir, lfs.dir, lfs.mkdir, lfs.rmdir

--    

------------------------------------------

local DreamShell = {

    initialized = false,

    modules = {

        --"tolua",

        --"tolua_2plus",

        --"luaDS",            -- Depends: tolua

        --"luaKOS",           -- Depends: tolua

        --"luaSDL",           -- Depends: tolua

        --"luaGUI",           -- Depends: tolua

        --"luaMXML",          -- Depends: tolua

        --"luaSTD",           -- Depends: tolua

        --"sqlite3",

        --"luaSQL",           -- Depends: sqlite3

        "luaSocket",

        --"luaTask",

        --"bzip2",

        "minilzo",

        --"zip",              -- Depends: bzip2

        "http",

        --"httpd",

        --"telnetd",

        --"mongoose",

        --"ppp",

        --"mpg123",

        --"oggvorbis",

        --"adx",

        --"s3m",

        --"wav",

        --"xvid",

        --"SDL_mixer",        -- Depends: oggvorbis

        --"ffmpeg",           -- Depends: oggvorbis, mpg123, bzip2

        --"opengl",

        "isofs",            -- Depends: minilzo

        "isoldr"            -- Depends: isofs

        --"SDL_net",

        --"opkg",             -- Depends: minilzo

        --"aicaos",

        --"gumbo",

        --"ini",

        --"bflash",

        --"openssl",

        --"bitcoin",

        --"quirc",

        --"ftpd"

    },

    Initialize = function(self)

        os.execute("env USER Default");

        local path = os.getenv("PATH");

        print(os.getenv("HOST") .. " " .. os.getenv("VERSION") .. "\n");

        print(os.getenv("ARCH") .. ": " .. os.getenv("BOARD_ID") .. "\n");

        print("Date: " .. os.date() .. "\n");

        print("Base path: " .. path .. "\n");

        print("User: " .. os.getenv("USER") .. "\n");

        local emu = os.getenv("EMU");

        if emu ~= nil then

            print("Emulator: " .. emu .. "\n");

        end

        print("\n");

        if not MapleAttached("Keyboard") then

            table.insert(self.modules, "vkb");

        end

        table.foreach(self.modules, function(k, name)  

            print("DS_PROCESS: Loading module " .. name .. "...\n");

            if not OpenModule(path .. "/modules/" .. name .. ".klf") then

                print("DS_ERROR: Can't load module " .. path .. "/modules/" .. name .. ".klf\n");

            end

        end);

        self:InstallingApps(path .. "/apps");

        self.initialized = true;

        # Setup network

        os.execute("net --init");

        # disable FTP server for now

        --os.execute("ftpd -s -p 21 -d /");

        # try and download my file

        socket = require("socket")

        http = require("socket.http")

        ltn12 = require("ltn12")

        local file = ltn12.sink.file(io.open('/ide/GAMES/mygame/game.iso', 'w'))

        http.request {

                url = 'http://myserver/myfile.iso',

                sink = file,

        }

        # Run isoloader but I don't know how...

        OpenApp(os.getenv("APP"));

    end,

    InstallingApps = function(self, path)

        print("DS_PROCESS: Installing apps...\n");

        local name = nil;

        local list = {};

        for ent in lfs.dir(path) do

            if ent ~= nil and ent.name ~= ".." and ent.name ~= "." and ent.attr ~= 0 then

                table.insert(list, ent.name);

            end

        end

        table.sort(list, function(a, b) return a > b end);

        for index, directory in ipairs(list) do

            name = AddApp(path .. "/" .. directory .. "/app.xml");

            if not name then

                print("DS_ERROR: " .. directory .. "\n");

            else

                print("DS_OK: " .. name .. "\n");

            end

        end

        return true;

    end

};

if not DreamShell.initialized then

    DreamShell:Initialize();

end

As you can see I didn't got very far.

Any help would be greatly appreciated.

Need help building Dreamshell

Tue, 25 Jun 2024 20:30:43 +0000

Привет Сват! Long time no see, надеюсь у тебя все в порядке!

Пытаюсь собрать дримшел.
Все делал по инструкции, валится на линковке символов, но порт libbzip2 собран.

Цитата:root@DESKTOP-12T5EBE:/usr/local/dc/kos/kos/ds# source ../environ.sh
root@DESKTOP-12T5EBE:/usr/local/dc/kos/kos/ds# make
rm -f 1DS_CORE.BIN DS_CORE.BIN DS.elf DS.cdi
rm -f /usr/local/dc/kos/kos/ds/src/main.o
rm -f romdisk.*
rm -rf romdisk/.* 2> /dev/null || true
kos-cc -c /usr/local/dc/kos/kos/ds/src/main.c -o /usr/local/dc/kos/kos/ds/src/main.o
/usr/local/dc/kos/kos/utils/genromfs/genromfs -f romdisk.img -d romdisk -v -x .svn -x .keepme
0 rom 1719346980 [0xffffffff, 0xffffffff] 37777777777, sz 0, at 0x0
1 . [0x860 , 0x60e3 ] 0040775, sz 0, at 0x20
1 .. [0x860 , 0xbd3 ] 0040775, sz 0, at 0x40 [link to 0x20 ]
1 logo.kmg.gz [0x860 , 0x60e4 ] 0100664, sz 31403, at 0x60
1 startup.raw.gz [0x860 , 0x60e5 ] 0100664, sz 205731, at 0x7b30
/usr/local/dc/kos/kos/utils/bin2o/bin2o romdisk.img romdisk romdisk_tmp.o
/opt/toolchains/dc/sh-elf/bin/sh-elf-gcc -o romdisk.o -r romdisk_tmp.o -L/usr/local/dc/kos/kos/lib/dreamcast -L/usr/local/dc/kos/kos/addons/lib/dreamcast -L/usr/local/dc/kos/kos/../kos-ports/lib -L/usr/local/dc/kos/kos/ds/sdk/lib -Wl,--whole-archive -lromdiskbase
rm romdisk_tmp.o
/opt/toolchains/dc/sh-elf/bin/sh-elf-gcc -O2 -fomit-frame-pointer -fno-builtin -m4-single-only -ml -ffunction-sections -fdata-sections -matomic-model=soft-imask -ftls-model=local-exec -I/usr/local/dc/kos/kos/include -I/usr/local/dc/kos/kos/kernel/arch/dreamcast/include -I/usr/local/dc/kos/kos/addons/include -I/usr/local/dc/kos/kos/../kos-ports/include -D_arch_dreamcast -D_arch_sub_pristine -Wall -g -I/usr/local/dc/kos/kos/ds/sdk/include -I/usr/local/dc/kos/kos/ds/sdk/include/SDL -DTARGET_NAME=DreamShell_v4.0.0_Release -DDS_ARCH_DC -Wno-nonnull-compare -Wno-stringop-truncation -Wno-stringop-overflow -Wno-format-truncation -Wno-format-overflow -Wno-restrict -I/usr/local/dc/kos/kos/ds/include -I/usr/local/dc/kos/kos/ds/include/SDL -I/usr/local/dc/kos/kos/ds/include/fatfs -DHAVE_SDLIMAGE -DVER_MAJOR=4 -DVER_MINOR=0 -DVER_MICRO=0 -DVER_BUILD=0x30 -O2 -fomit-frame-pointer -fno-builtin -m4-single-only -ml -ffunction-sections -fdata-sections -matomic-model=soft-imask -ftls-model=local-exec -I/usr/local/dc/kos/kos/include -I/usr/local/dc/kos/kos/kernel/arch/dreamcast/include -I/usr/local/dc/kos/kos/addons/include -I/usr/local/dc/kos/kos/../kos-ports/include -D_arch_dreamcast -D_arch_sub_pristine -Wall -g -m4-single-only -ml -Wl,-Ttext=0x8c010000 -Wl,--gc-sections -T/usr/local/dc/kos/kos/utils/ldscripts/shlelf.xc -nodefaultlibs -L/usr/local/dc/kos/kos/lib/dreamcast -L/usr/local/dc/kos/kos/addons/lib/dreamcast -L/usr/local/dc/kos/kos/../kos-ports/lib -L/usr/local/dc/kos/kos/ds/lib -o DS.elf \
/usr/local/dc/kos/kos/ds/src/main.o /usr/local/dc/kos/kos/ds/src/video.o /usr/local/dc/kos/kos/ds/src/console.o /usr/local/dc/kos/kos/ds/src/gui/gui.o /usr/local/dc/kos/kos/ds/src/commands.o /usr/local/dc/kos/kos/ds/src/module.o /usr/local/dc/kos/kos/ds/src/events.o /usr/local/dc/kos/kos/ds/src/fs/fs.o /usr/local/dc/kos/kos/ds/src/lua/lua.o /usr/local/dc/kos/kos/ds/src/lua/lua_ds.o /usr/local/dc/kos/kos/ds/src/lua/packlib.o /usr/local/dc/kos/kos/ds/src/app/app.o /usr/local/dc/kos/kos/ds/src/app/load.o /usr/local/dc/kos/kos/ds/src/list.o /usr/local/dc/kos/kos/ds/src/img/pvr.o /usr/local/dc/kos/kos/ds/src/cmd_elf.o /usr/local/dc/kos/kos/ds/src/vmu/vmu.o /usr/local/dc/kos/kos/ds/src/irq/exceptions.o /usr/local/dc/kos/kos/ds/src/irq/setjmp.o /usr/local/dc/kos/kos/ds/src/settings.o /usr/local/dc/kos/kos/ds/src/sfx.o /usr/local/dc/kos/kos/ds/src/drivers/spi.o /usr/local/dc/kos/kos/ds/src/drivers/sd.o /usr/local/dc/kos/kos/ds/src/drivers/enc28j60.o /usr/local/dc/kos/kos/ds/src/drivers/asic.o /usr/local/dc/kos/kos/ds/src/drivers/rtc.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/SDL_gui.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Exception.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Object.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Surface.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Font.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Callback.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Drawable.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Screen.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Widget.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Container.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/FastFont.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/TrueTypeFont.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Layout.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Panel.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/CardStack.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/FastLabel.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Label.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Picture.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/TextEntry.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/AbstractButton.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Button.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/ToggleButton.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/ProgressBar.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/ScrollBar.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/AbstractTable.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/ListBox.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/VBoxLayout.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/RealScreen.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/ScrollPanel.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/RTF.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/Window.o /usr/local/dc/kos/kos/ds/lib/SDL_gui/FileManager.o /usr/local/dc/kos/kos/ds/lib/SDL_Console/src/SDL_console.o /usr/local/dc/kos/kos/ds/lib/SDL_Console/src/DT_drawtext.o /usr/local/dc/kos/kos/ds/lib/SDL_Console/src/internal.o /usr/local/dc/kos/kos/ds/src/utils.o /usr/local/dc/kos/kos/ds/src/utils/gmtime.o /usr/local/dc/kos/kos/ds/src/utils/strftime.o /usr/local/dc/kos/kos/ds/src/utils/debug_console.o /usr/local/dc/kos/kos/ds/src/utils/memcpy.op /usr/local/dc/kos/kos/ds/src/utils/memset.op /usr/local/dc/kos/kos/ds/src/utils/memmove.op /usr/local/dc/kos/kos/ds/src/fs/fat/utils.o /usr/local/dc/kos/kos/ds/src/fs/fat/option/ccsbcs.o /usr/local/dc/kos/kos/ds/src/fs/fat/option/syscall.o /usr/local/dc/kos/kos/ds/src/fs/fat/ff.o /usr/local/dc/kos/kos/ds/src/fs/fat/dc.o /usr/local/dc/kos/kos/ds/src/exports.o /usr/local/dc/kos/kos/ds/src/exports_gcc.o romdisk.o -lcfg -lmxml -lparallax -lSDL_1.2.13 -lSDL_image_1.2.12 -lSDL_ttf_2.0.11 -lSDL_rtf_0.1.1 -lSDL_gfx_2.0.25 -lfreetype -lkmg -ljpeg -lpng -lz -llua_5.1.4-2 -lkosext2fs -lkosutils -lstdc++ -lm -Wl,--start-group -lkallisti -lc -lgcc -Wl,--end-group
/opt/toolchains/dc/sh-elf/lib/gcc/sh-elf/13.2.0/../../../../sh-elf/bin/ld: /usr/local/dc/kos/kos/../kos-ports/lib/libfreetype.a(ftbzip2.o): in function `ft_bzip2_stream_close':
/usr/local/dc/kos/kos-ports/freetype/build/freetype-2.10.2/src/bzip2/ftbzip2.c:440.text.ft_bzip2_stream_close+0x50): undefined reference to `BZ2_bzDecompressEnd'
/opt/toolchains/dc/sh-elf/lib/gcc/sh-elf/13.2.0/../../../../sh-elf/bin/ld: /usr/local/dc/kos/kos/../kos-ports/lib/libfreetype.a(ftbzip2.o): in function `ft_bzip2_file_fill_input':
/usr/local/dc/kos/kos-ports/freetype/build/freetype-2.10.2/src/bzip2/ftbzip2.c:262.text.ft_bzip2_file_fill_output+0xd0): undefined reference to `BZ2_bzDecompress'
/opt/toolchains/dc/sh-elf/lib/gcc/sh-elf/13.2.0/../../../../sh-elf/bin/ld: /usr/local/dc/kos/kos/../kos-ports/lib/libfreetype.a(ftbzip2.o): in function `ft_bzip2_file_io':
/usr/local/dc/kos/kos-ports/freetype/build/freetype-2.10.2/src/bzip2/ftbzip2.c:376.text.ft_bzip2_stream_io+0x110): undefined reference to `BZ2_bzDecompressEnd'
/opt/toolchains/dc/sh-elf/lib/gcc/sh-elf/13.2.0/../../../../sh-elf/bin/ld: /usr/local/dc/kos/kos-ports/freetype/build/freetype-2.10.2/src/bzip2/ftbzip2.c:376.text.ft_bzip2_stream_io+0x114): undefined reference to `BZ2_bzDecompressInit'
/opt/toolchains/dc/sh-elf/lib/gcc/sh-elf/13.2.0/../../../../sh-elf/bin/ld: /usr/local/dc/kos/kos/../kos-ports/lib/libfreetype.a(ftbzip2.o): in function `FT_Stream_OpenBzip2':
/usr/local/dc/kos/kos-ports/freetype/build/freetype-2.10.2/src/bzip2/ftbzip2.c:493.text.FT_Stream_OpenBzip2+0x118): undefined reference to `BZ2_bzDecompressInit'
collect2: error: ld returned 1 exit status

Development of a new menu

Wed, 05 Jun 2024 00:09:06 +0000

Hi Swat,

I made a menu with tsunami libraries by Dan Potter, I can create the cdi and test it in the emulator but when I try to create an application in DreamShell it hits and errors, because they are "cpp" files that I have not been able to compile it, I do it with:

kos-c++ -o $(TARGET) $(OBJS) -ltsunami -lstdc++ -lparallax -lpng -ljpeg -lkmg -lz -lkosutils -lm

(I put the tsunami library and compiled it inside the libs folder, I had no problems with this, it was fast.)

but dreamshell only uses C , can you help me?

I already moved it to the Makefile application and Makefile.loadable many times.

This is the menu, it is a prototype.
https://youtu.be/cdckXFmu0Mg

DreamShell dev environment setup on macOS

Sun, 20 Aug 2023 19:27:40 +0000

Hi @Swat,

I am trying to install Dreamshell Setup Environment on MacOs but in the "Packages" and "SDK" section it shows an error.

Packages, does not exists:
genisoimage squashfs-tools, libpng-dev libjpeg-dev liblzo2-dev liblua5.2-dev
I'm trying to install them with Brew but it can't find them.

Code section it's OK
Toolchain section it's OK

SDK in this instruction: "make && cd ../kos-ports && ./utils/build-all.sh"

Building /usr/local/dc/kos/kos/../kos-ports/freetype...
freetype is not currently installed.
freetype requires zlib to be installed. Building...
zlib is not currently installed.
Finished processing dependencies for zlib.
File "zlib-1.2.13.tar.gz" is incorrect size (expected 1497445)
make[1]: *** [validate-dist] Error 1
make: *** [depends-check] Error 1

I have installed freetype with Brew manually but still the error.

Please help..

Lua 5.4

Sat, 18 Feb 2023 13:50:02 +0000

Greetings! First of all, I'm a big fan of DreamShell as both a user who has enjoyed its features and as a developer who has a lot of respect for how ambitious and impressive the project and its codebase are! The module system is really very well architected, and I find it really impressive work too.

I'm also a fellow Lua developer and enthusiast and wanted to run something by you. I noticed that the Lua version included within DreamShell is only version 5.1, I believe. I'm not sure if you've ever considered upgrading or have had any interest in it. It's true that a few things might have to change, involving how the ENV variable works for sandboxed scripts, but I wanted to make you aware of a few things that I've found really beneficial with current Lua 5.4 and Dreamcast:

1) Performance
It's actually quite hard to find any good benchmarks between Lua versions that aren't just LuaJIT, but in my research, it seems as though Lua5.4 performs the best of the modern Lua revisions, and is definitely the faster than 5.2 and 5.3: https://eklausmeier.goip.de/blog/2020/05...-5-4-vs-c/

2) Builtin Integral Types
Starting with Lua5.3, Lua now supports integers as first-party types, so all numbers no longer have to be floats. This has performance and precision implications, but for us its also very useful for when you're binding low-level code that tends to require bitwise operation and arithmetic. Bitwise operators are now supported within the language itself: https://www.lua.org/manual/5.4/manual.html#3.4.2 and don't require external libraries or bindings to do it in C.

3) List of New Features
Here's a high-level list of new features for each revision from Lua's site which you might be interested in:

Lua 5.2:

yieldable pcall and metamethods
new lexical scheme for globals
ephemeron tables
light C functions
emergency garbage collector
goto statement
finalizers for tables

Lua 5.3:

integers (64-bit by default)
official support for 32-bit numbers
bitwise operators
basic utf-8 support
functions for packing and unpacking values

Lua 5.4:

new generational mode for garbage collection
to-be-closed variables
const variables
userdata can have multiple user values
new implementation for math.random
warning system
debug information about function arguments and returns
new semantics for the integer 'for' loop
optional 'init' argument to 'string.gmatch'
new functions 'lua_resetthread' and 'coroutine.close'
string-to-number coercions moved to the string library
allocation function allowed to fail when shrinking a memory block
new format '%p' in 'string.format'
utf8 library accepts codepoints up to 2^31

4) Emergency Garbage Collection Sweep
One thing that I think is really useful and cool for us on DC and embedded devices is the "emergency GC sweeping" that as introduced in Lua5.2. Now, if the device ever runs out of memory (malloc() call fails and returns NULL), Lua will gracefully attempt to free any unused memory before trying again.

KOS actually had a problem with this not working previously, because we were always aborting the system when we ran out of memory, but we just pushed a PR to stop doing that, so that malloc() will return NULL in C, C++ will raise its std::bad_alloc exceptions, Lua will do its emergency sweeps, etc. Here's the PR on the KOS repo with the change as well as a new KOS example I wrote illustrating gracefully handling allocation failure in C++: https://github.com/KallistiOS/KallistiOS...8e8693f9ea

Anyway, I wasn't sure if you had any compelling reasons to stick to Lua 5.1, or if you just hadn't really look into what the new revisions have to offer. Definitely a few things will have to change from 5.1 to 5.2, but virtually nothing has changed from 5.2 to 5.4 in terms of the C API and user libs. I do believe it could bring you runtime performance improvements and other benefits, but I'm not sure if perhaps the binary file size for the VM might be larger now.

Thank you for your time, and as always, please keep up the amazing work! I'm both a user and a fan!

Memory Layout

Fri, 27 Nov 2020 19:55:23 +0000

Reproducing below a post by @swat
which is a treasure trove of information when it comes to memory addressing on Dreamcast.

I have a few follow up questions, but I presume many users will be uninterested by these technical details,
so it felt more appropriate in the "programmer" section.

(27.11.2020 07:42)SWAT писал(а): Loader memory usage:
params (1KB) + loader code (nKB) + buffer (32KB - params - loader). Max 32KB.

In best case, for buffer need 2KB (one sector). This buffer uses only for non-optimized images and little for CDDA (track name). So the loader should be less than 29KB.
In future this buffer I will made as *dynamic* too, but it's working not in all games yet.

Also loader uses additional memory (up to 32KB) for CDDA and/or CISO buffers.
For CDDA now supported dynamic, for CISO still not, it uses only hardcoded addresses.
And CDDA can use hardcoded addresses if dynamic disabled (not supported).
You can see here:
https://github.com/DC-SWAT/DreamShell/bl...?ts=4#L220

Application (KATANA game) memory usage:
Params: 0x8c000000 - 0x8c000100 (also here vectors for syscalls)
Syscalls: 0x8c000100 - 0x8c004000
Stack: 0x8c004000 - 0x8c00f400 (in some cases at 0x8d000000)
VBR: 0x8c00f400 - 0x8c010000 (in some cases in heap)
App binary: 0x8c010000 - ???
Heap: ??? - 0x8d000000

So we can place loader (and buffers) in the heap (carefully with stack if it's at the end) or at 0x8c000100 - 0x8c004000 because loader can emulate all syscalls.
Best choice it's a 0x8c004000, we don't touch original syscalls (just change some vectors) and don't conflict with game, because stack here is usually does not grow much and VBR code block is 3KB, so we should have ~ 32KB for free.
But some games can write in this memory area some "loaders" or stack grow so much and do damage loader code. So we should move loader at high memory (heap) and hopes we are lucky

First, thanks @swat for these details, it clarified so much.

Now, "of course", as a programmer understanding more generally means having new questions.
Many are probably well known by dreamcast programmers, and may seem basic to you, sorry in advance, they are just not obvious from a general programmer perspective with no specific knowledge of Dreamcast platform.

Цитата:b]Application (KATANA game) memory usage:[/b]
Params: 0x8c000000 - 0x8c000100 (also here vectors for syscalls)
(...)
Heap: ??? - 0x8d000000

These few lines are packed with information, much of which seems implied. So here are some questions:

- KATANA game : I presume it means games that use the KATANA game development kit from Sega. It's probably a majority of games, but it also means that games using a different toolkit and set of conventions can work quite differently when it comes to memory layout. For example, maybe Window CE games. And maybe also more modern production using KallistiOS ? Anyway, this merely helps to understand that this is not a "universal" design.
- Params: 0x8c000000 - 0x8c000100 : nit-picking here : this seems to represent 256 bytes ( < 1 KB). Still, likely large enough for parameters (I have no idea how much space "vectors for syscalls" is using, but that's probably irrelevant anyway)
- The entire memory design seems to imply an MMU-less scheme, where memory addresses are directly mapped to the physical RAM
- It seems to imply that 0x8c000000 is "address zero" ?
- The Dreamcast (normal) features 16 MB of RAM, or 0x1000000 in hexadecimal. In a direct addressing scheme, it seems it would go from 0x8c000000 to 0x8d000000. Yet, later in the list, 0x8d000000 is mentioned as a start (?) address for heap (and maybe sometimes for stack). This seems contradictory, unless heap allocation goes _down_ from 0x8d000000.

Цитата:Stack: 0x8c004000 - 0x8c00f400

This seems to represent a memory space of 64KB - 16 KB (syscalls) - 3 KB (VBR) = 45 KB .

What initially was unclear to me was "a stack space for _who_?", and I guess it means stack space for the KATANA program.

Цитата:So we can place loader (and buffers) (...)
Best choice it's a 0x8c004000, (...) because stack here is usually does not grow much and VBR code block is 3KB, so we should have ~ 32KB for free.

So the idea here is to "steal away" memory space from the stack, on the ground that it's not entirely used in most cases.
It implies that stack space growth _downward_, from 0x8c00f400 towards 0x8c004000.
I presume this is generally true : in such an environment, programmers should not "toy" with stack space limits, and keep the stack for very basic structures and variables, thus pushing any table or large structure into heap space instead. In the end, they may only need a handful for KB.
But by the very nature of this bet, it's a bit "random", meaning that some games use more stack than others, so some games will overwrite the loader during gameplay. So now it becomes a "by game" setting.

I guess it explains why 0x8c004000 is "generally fine", except in some cases.

It also explains why the loader should remain small, although I don't see any hard 32 KB limit here. It seems more like a rule of thumb : using 32 KB for the loader only leaves 13 KB for the game itself, so now it becomes more and more probable that the game will overwrite the loader during gameplay.

Is that a correct assessment ?

cso support

Wed, 18 Mar 2020 06:47:40 +0000

I've been looking for *.cso (compressed iso) support on DreamShell.
This capability is mentioned here and there, in a few places, and more importantly, there are traces of this support in many places throughout the code base.

However, every time I tried to load a .cso file, it resulted in a crash.

I was lucky enough to receive a hint from @ChristinaDreamcustDC, stating that .cso support might have been dropped in recent versions of DreamShell.
There is, indeed, one short line on the topic in the middle of RC4 release note, firmware section :

> Removed support for CSO in IDE loader to save memory =(

So that's interesting for a few reasons :

1) I'm not using IDE, but a SD Card reader on serial port. From the spelling, one could believe that it should not be impacted by the change on IDE, since after all, within `DS/firmware/isoldr`, there are distinct `ide.bin` and `sd.bin` files.

Well, the Serial Port config is clearly impacted. To confirm, I downloaded RC3, and attempted again to load the *.cso file. This time it worked.

So something broke support of *.cso files for all storage types in RC4.

2) "to save memory"

OK, this one is even more interesting. I've been looking at the code in `modules/isofs` pretty closely, and, provided that the *.cso file is using LZO compression, there is nothing that makes it consume more memory than a direct read on *.iso file. LZO decompression only costs a handful of stack variables, nothing significant.

Note that this is fairly different from zlib compression, where there is a state, which costs memory. I want to underline that I'm targeting LZO-compressed *.cso file as my primary application, precisely because it costs less memory and cpu at decompression time.

3) The code is still there.

As mentioned, I've been looking pretty closely at the code in `isofs`, and a little bit at `isoldr` and `firmware/sd`.
It's pretty clear that the ciso code is still here.
More than that, it's still active, it's not gated, and it ends in the produced binary file, meaning it consumes space, and exposes all expected symbols.

Yet, I've not found where exactly the *.cso support is disabled, if it is.

Presuming I would like to re-enable this support, is there a place to look at ?
Can this support be enabled with a simple build flag at compilation time ?

I'm interested in this topic, and may even provide some patches to improve performance of this code path. That is, if there is a way to test the code changes ....

Подтверждение запуская ярлыки на декстопе

Wed, 27 Jan 2016 19:25:55 +0000

Как добавить подтверждение запуская ярлык на декстопе? Как в Файловым менеджере когда удаляешь сейв.

Хочу копировать и останавливать вму сейвы с ярлыком, но боюсь случайно не запустить.

Приложение для DreamShell

Tue, 26 Aug 2014 18:56:27 +0000

Вопрос туповатый, но на голимом XML с подключением модулей реально написать работающую программу, которая будет работать с интерфейсом файловой системы и редактировать текстовые файлы?
Просто есть идея, и если это возможно, я могу попробовать написать мелкие программки для удобства, которые будут менять фоновую картинку, шрифт, еще что-нибудь - чисто ради удобства.

ярлыки для образов и бинарников на рабочий стол

Mon, 07 Jul 2014 07:10:00 +0000

ждём инструкции от SWAT

Визуальная модификация DS 4 rc1 filemanager

Fri, 14 Mar 2014 13:19:18 +0000

Как сделать вертикальный сплит вместо горизонтального?

Как увеличить резолюцию - чтобы всё стало по меньше?

это всё было сделано в filemanager DreamShell 4.0 Beta 4 (Form SD Loader)

скрипт для копирования всех сеивов из дц вму в сд карту

Thu, 13 Mar 2014 21:00:27 +0000

Привет любителям DC.

Нигде не могу найти как это сделать.
код:
you can dump it from VMU to SD card using Dreamshell. Just type in console following command
Code:
vmu -d -a A1 -o /sd/vmu.bin

делает думп всей партиции вму, а я хочу считать каждый отделенный сейв в сд карту.
Патом на компьютере добавить или удалить сейвы с сд карты, и скопировать обратно всё в вму.

Нужна какая то проверка хватает ли места в вму.
Сейвы с сд должны переписать сейвы на вму.
Эти скрипты хочу положит на десктопе дц (как это делается?), нажнуть на иконку, увидеть инфо что всё удалось или нет.

пробовал искать в dreamshell 4 rc1 filemanager main.lua но ничего не нашёл.

Я уже долго делаю это в ручную с dreamshell 4 rc1 filemanager, но это так долго и неудобно...
у меня только одно вму так как ... очень нужно.

вызов функции на С

Wed, 25 Dec 2013 04:30:19 +0000

Код:

#include "ds.h"

int main(int argc, char *argv[]) {

    uint32 fd;

    char *toc;

    fd=cdrom_locate_data_track (*toc);

    ds_printf("log=%d ", fd);

    return CMD_OK;

}

это одна из сотни попыток вызвать функцию cdrom_locate_data_track (CDROM_TOC *toc), подскажите как правильно

Delphi

Tue, 18 Jun 2013 10:42:13 +0000

Если я напишу программу на Delphi, то можно будет её портировать на DreamShell со всеми библиотеками(к примеру с DirectShow)?

SDL_FreeSurface ?

Tue, 01 Nov 2011 08:56:56 +0000

i still got problems getting my isoBrowser app to work.
at least i made some progress: i am pretty sure now that i fill up the ram with all the button instances i create until the app freezes.

so my question is: how to free up some ram again?
i create buttons and load images into my buttons like:

b = DS.GUI_ButtonCreate(.....);
s = DS.GUI_SurfaceLoad(self.currentpath .. appname .. "/icon.jpg");
DS.GUI_ButtonSetNormalImage(b, s);
...etc...

then i add the button to a container named 'panel' on the screen:
DS.GUI_ContainerAdd(self.apps.panel, b);

this works well.

but i got NO IDEA how to free the ram i used for loading the images.
can anyone point me to the right direction here?
is there a way to "DS.SDL_FreeSurface( s );" somehow ?

"GUI_ContainerRemove" removes the container but doesn't free the ram right?
"GUI_WidgetErase" ?
"GUI_WidgetUpdate" ?

i am lost in endless loops of trial and error.
any help is highly appreciated!!

Dreamshell BETA3/BETA4 Direct Swap

Thu, 08 Sep 2011 04:39:46 +0000

So I am not sure where to put this but I figured here and I would post in the English section as well. I use this OS quite a lot as it allows for me to fool with textures in games without wasting disc, emulation is awesome and since I have it hooked to my PC and it shares the same speakers I just use my VCD dongle and remote as a media center. Really neat stuff from my beloved DC and I will show you just how much I treasure my system by the end of this post.

Anyhow back to the topic at hand. BETA 4 works good for the most part but it did break some compatibility with games that worked on BETA 3. Kinda of something like this that Red Squirrel coded for the PSP the D3-D4 switching applicaiton.

D2-D3 Switcher

Sonic Adventure 1 works great on BETA 3 but no dice on BETA 4 so this would be ever so useful. I am attempting to see if a manual swap with my mouse and keyboard would work but I don't think so by reading the translation but then again google translation sucks.

Anyhow looking forward to anything from you guys as it is great not for emulation and some non-intensive games are very much playable if you work with them. I mean bring down bitrates in video and even mono audio and you will be surprised at what will work. I know we are very limited by the speed of the serial port but we can still get enough done.

Here are a couple quick clips of my baby and thanks for all your work and I hope something like this can be done and if easy enough just please pass it along to me so I can set it up that way please.

And I converted my NTSC-U Sega Sports system to a PAL blue swirl

[WIP] IsoBrowser DC

Sun, 04 Sep 2011 11:39:38 +0000

hi there.
first of all: THANKS A TON for DreamShell!
i am using DreamShell to power my (half baked) Dreamcast Arcade Machine. and i wanted a simple 'front end' to launch my isos and emulators easily.
So i tried my best to develop and app for DreamShell to browse folders on my SD card, show the icon.png from each folder and launch a boot.iso from that folder.

It works so far and i am quite happy with it!
it still crashes a lot though!
after about 8 pages the app freezes. it is pretty possible that i just fill up the RAM with all the icons. is it? these are my frst steps with lua and sdl and i got no idea what i am doing (wrong) here . i delete the container containing all buttons on every page refresh, recreate it and add the new buttons/icons. maybe there is a better way to accomplish that?
i attached the app. can you guys take a look at it and point me to the right direction here? i'd really appreciate your help!

isobrowser_alpha.zip (Размер: 219.76 Кб / Загрузок: 67)