User Tools

Site Tools


en:unicard:uniutil

UNIUTIL


     Program for CP/M written with Turbo Pascal using the Unicard MZFRepo interface. It works with Unicard RTC and CP/M clock, can save and load RAMDisk (RRD) to/from an SD card and can copy files bewteen CP/M and the SD card. The program is run under CP/M using a UNIUTIL command (or UU, depending on how it is renamed) and its functions are controlled by parameters. The program by itself with no parameters will give a short guide.


Working with RTC and CP/M time

  • UNIUTIL /GETRTCTIME – shows RTC time on the Unicard
  • UNIUTIL /GRTR – shows RTC time on the Unicard until a key is pressed (used for testing and comparing to the CP/M time)
  • UNIUTIL /SETRTCTIME HH:MM:SS – sets RTC on the Unicard, does not set time in CP/M, for that you would also have to use /SETCPMTIME
  • UNIUTIL /SETCPMTIME – sets time on CP/M according to the Unicard RTC (this is best placed in AUTOEXEC.SUB)

Working with the RAM Disk (RRD)

  • UNIUTIL /SAVERD page(0-1) bank(0-16) size(0-16) [filename] – will save the size of pages of 64kB from RAM Disk on the SD card starting from the set page and bank. To save the entire RRD you have to run it 2x, one save has a maximum of 1024kB.
    • for example, to save CP/M RAM disk 1024 kB to the SD card root use command:
      UNIUTIL /SAVERD 0 0 16 /rd.bin
  • UNIUTIL /LOADRD page(0-1) bank(0-16) size(0-16) [filename] – will load the size of pages of 64kB from the SD card on the RAM Disk starting from the set page and bank. To load the entire RRD you have to run it 2x, one load has a maximum of 1024kB.
    • for example, to load CP/M RAM disk 1024 kB from the SD card root use command:
      UNIUTIL /LOADRD 0 0 16 /rd.bin
    • before overwriting the RAMDisk, the program will ask for a confirmation by entering ‚Yes‘

Moving a file between an SD card and CP/M (in a DSK emulated floppy disk)

  • UNIUTIL /FILETOSD [filename|ASK] – will copy a file from CP/M to the SD Card
  • UNIUTIL /FILEFROMSD [filename|ASK] – will copy a file from an SD card to the CP/M
    • if you include the file name, this file is copied to/from the SD card root, if you include ASK, the program will ask for the names of the source and target files
    • for example, to save a UU.PAS file on the SD card use command:
      UNIUTIL /FILETOSD UU.PAS
    • there is an error in the officially released version of the program, which was later fixed by NOBOMI, that prevented moving files larger than 32kB

     It is very likely, that the program contains errors, therefore use it with care. It is written in Turbo Pascal 3.0 and on the author's webpage you can also download the source code of the program. If you encounter and report any errors, the author will surely fix them. He promises to eventually expand the program to include additional functions. The same applies also for optimization. The program was written “so it works” and its optimization will require a lot of work. Some functions work on a byte so they are currently a bit slow.


en/unicard/uniutil.txt · Last modified: 2018/10/14 22:47 (external edit)