UNPKG

@nataliapc/mcp-openmsx

Version:

Model context protocol server for openMSX automation and control

62 lines (38 loc) 2.31 kB
# BSAVE ## Effect Saves a specified area of memory to the specified device and/or file name. ## Syntaxes `BSAVE "<Device>:<Path>\<Filename>",<StartAddress>,<EndAddress>,<ExecutionAddress>` `BSAVE "<Device>:\<Path>\<Filename>",<StartAddress>,<EndAddress>,S` _Notes:_ - Character backslash `\` serves as a separator between the folders and the file name in MSX-DOS2. You don't have to put it after the colon of the device name. - Character backslash is replaced by the character yen `¥` on Japanese MSX or the character won `₩` on Korean MSX. - Parameters can not end with a comma alone. ## Parameters `<Device>` is device name to indicate the device to use. Here are the useful devices for BSAVE: |Device type|Device name|Remark| |---|---|---| |Disk drive|A, B, C, D, E, F, G, H|A floppy disk interface can control up to 2 drives.| |Data recorder|CAS|Not available on MSX turbo R| By default, the saving will be made to tape on a system without any disk drive, to the current active drive (generally drive A:) in the other cases. `<Path>` is used to specify the location in folders of file to be used in the copying operation. Each folder name in path are separate by a backslash `\`. This parameter is only available under MSX-DOS 2 / Nextor. `<Filename>` is the name of binary file to save. When the file is saved on tape the format of file name is case sensitive and limited to 6 characters without extension. If another device is used, then the format is 8 characters followed by a point and an extension with 3 characters. (Not case sensitive). `<StartAddress>` and `<EndAddress>` are used to specify the area of the computer RAM (or VRAM). `<ExecutionAddress>` is the address at which the saved code should start, when loaded with `BLOAD` `,R`. By default the start address is set. The parameter `S` is used to save the contents of VRAM (only to disk) - This can be done in any screen mode but only the active pages are valid when the screen mode is higher than 4. ## Examples ```basic BSAVE "CAS:test",&amp;HC000,&amp;HD0FF,&amp;HC020 ``` ```basic BSAVE "A:TEST.BIN",&amp;HC000,&amp;HD0FF,&amp;HC020 ``` ```basic BSAVE "PICTURE.SC2",&amp;H0,&amp;H3FFF,S ``` ## Related to `BLOAD` ## Compatibility MSX-BASIC 1.0 or higher ## Source Retrieved from "https://www.msx.org/wiki/BSAVE"