1 Topic by Luzie (edited by Luzie 2019-10-19 15:33:07)

  • Luzie
  • esxDOS Guru
  • Offline
  • Registered: 2013-09-26
  • Posts: 382

Topic: HOWTO right exiting .DOT commands which are started with parameters?

Hi,

sorry, but I´m new into programming Z80 and esxDOS, so this is a Newbie question.

I struggle about exiting a selfprogrammed .DOT-command which started with parameters.
Starting the .DOT-command without any parameters runs it OK with 0 OK, 0:1

But when running passing a parameter, it shows me this on esxDOS 0.8.6: !q, 0:1
or on esxDOS 0.8.7: M, 0:1
or similar strings.

On: http://board.esxdos.org/viewtopic.php?pid=969#p969
I find something about howto right exiting a .DOT-command. But it´s too complicated for me as beginner to understand.
Can someone please give me a source-piece to add to my .dot-command to exit it right with 0 OK, 0:1

I´m on esxDOS 0.8.7 or esxDOS 0.8.6 under DivIDE-Emulation (SpecEmu).

Or should try to use Z88DK as "Assembler only" as I find it hard for me to get into programming C. And Z88DK´s .DOT-command compiling options may fix me problems?

Regards,

Luzie

2 Reply by aowen

  • aowen
  • esxDOS Fan
  • Offline
  • Registered: 2014-03-26
  • Posts: 96

Re: HOWTO right exiting .DOT commands which are started with parameters?

Luzie wrote:

Can someone please give me a source-piece to add to my .dot-command to exit it right with 0 OK, 0:1

or a;
ret;

Here's an example dot command using the esxDOS 0.8.5 API that behaves differently depending on parameters / no parameters:

https://github.com/cheveron/unodos3/blo … c/help.asm

ColdSnap Audio | DerbyPro | SE Basic IV 4.2 Cordelia | ULAplus

3 Reply by Luzie (edited by Luzie 2019-10-21 16:42:53)

  • Luzie
  • esxDOS Guru
  • Offline
  • Registered: 2013-09-26
  • Posts: 382

Re: HOWTO right exiting .DOT commands which are started with parameters?

aowen wrote:
Luzie wrote:

Can someone please give me a source-piece to add to my .dot-command to exit it right with 0 OK, 0:1

or a;
ret;

Here's an example dot command using the esxDOS 0.8.5 API that behaves differently depending on parameters / no parameters:

https://github.com/cheveron/unodos3/blo … c/help.asm

Thank you very much! 

or a;
ret;

works OK for me!

4 Reply by Luzie (edited by Luzie 2019-10-23 16:58:50)

  • Luzie
  • esxDOS Guru
  • Offline
  • Registered: 2013-09-26
  • Posts: 382

Re: HOWTO right exiting .DOT commands which are started with parameters?

Now, thanks to aowen, I got my first .DOT-command working which utilize parameters (here just for displaying help or not):

It´s called .checkerb

From help:
.checkerb DOT-command Version: v1.0 by Luzie

Display a Checkerboard of Attributes over your Screen.
Helps you to find hidden content in loading screens like those on:
http://www.worldofspectrum.org/equinox/eggs/screens.php

Usage:
Without Parameters: Displays Checkerboard
With Parameters: Displays this help-screen. Press any key to quit!

Download Package with ASM-Source-Code and compiled .checkerb here: https://www.magentacloud.de/lnk/O8gGDSLV

5 Reply by Luzie

  • Luzie
  • esxDOS Guru
  • Offline
  • Registered: 2013-09-26
  • Posts: 382

Re: HOWTO right exiting .DOT commands which are started with parameters?

aowen wrote:
Luzie wrote:

Can someone please give me a source-piece to add to my .dot-command to exit it right with 0 OK, 0:1

or a;
ret;

Here's an example dot command using the esxDOS 0.8.5 API that behaves differently depending on parameters / no parameters:

https://github.com/cheveron/unodos3/blo … c/help.asm

Hi,

the link is not valid anymore/this GitHub-Site is gone?!

6 Reply by Luzie

  • Luzie
  • esxDOS Guru
  • Offline
  • Registered: 2013-09-26
  • Posts: 382

Re: HOWTO right exiting .DOT commands which are started with parameters?

Luzie wrote:
aowen wrote:
Luzie wrote:

Can someone please give me a source-piece to add to my .dot-command to exit it right with 0 OK, 0:1

or a;
ret;

Here's an example dot command using the esxDOS 0.8.5 API that behaves differently depending on parameters / no parameters:

https://github.com/cheveron/unodos3/blo … c/help.asm

Hi,

the link is not valid anymore/this GitHub-Site is gone?!

This can now be found here: https://github.com/nagydani/unodos3/blo … c/help.asm

7 Reply by aowen

  • aowen
  • esxDOS Fan
  • Offline
  • Registered: 2014-03-26
  • Posts: 96

Re: HOWTO right exiting .DOT commands which are started with parameters?

Luzie wrote:

This can now be found here: https://github.com/nagydani/unodos3/blo … c/help.asm

Hi. Thanks for posting the link. The only part of UnoDOS3 I'm still developing is the kernel (which is used in the Chloe 280SE). I've handed off the 3.0 repo to Daniel as folks might find the open source dot commands useful for developing their own commands for esxDOS. The kernel still works as a drop in replacement for the esxDOS 0.8.5 kernel, but esxDOS has moved on, and most folks don't seem to care that it's closed source. Also, while UnoDOS3 offered some usability advantages over esxDOS 0.8.5, with the release of 0.8.7 that's no-longer the case. I'm grateful to Miguel for all his hard work on esxDOS and for publishing under a sufficiently liberal license that it was possible to reverse engineer the kernel to create an open source replacement. As of time of writing, esxDOS 0.8.7 is still sufficiently compatible with version 0.8.5 that it can be used in place of the UnoDOS3 kernel if you want to use the Chloe firmware and a Spectrum firmware on the same machine, for example on a ZX Uno. It was getting harder to maintain compatibility with the Dr. Slump NMI menu though. I'm pleased to report that I've been contributing to a LFN browser for esxDOS that won't require native LFN support. Details in the divIDE / divMMC Facebook group, but I'll post here when it's available.

ColdSnap Audio | DerbyPro | SE Basic IV 4.2 Cordelia | ULAplus

8 Reply by Luzie (edited by Luzie 2020-04-15 17:23:05)

  • Luzie
  • esxDOS Guru
  • Offline
  • Registered: 2013-09-26
  • Posts: 382

Re: HOWTO right exiting .DOT commands which are started with parameters?

aowen wrote:

I'm pleased to report that I've been contributing to a LFN browser for esxDOS that won't require native LFN support. Details in the divIDE / divMMC Facebook group, but I'll post here when it's available.

Thanks for all informations. Sounds very interesting! I look forward to it.