@nataliapc/mcp-openmsx
Version:
Model context protocol server for openMSX automation and control
62 lines (38 loc) • 2.31 kB
Markdown
# 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",&HC000,&HD0FF,&HC020
```
```basic
BSAVE "A:TEST.BIN",&HC000,&HD0FF,&HC020
```
```basic
BSAVE "PICTURE.SC2",&H0,&H3FFF,S
```
## Related to
`BLOAD`
## Compatibility
MSX-BASIC 1.0 or higher
## Source
Retrieved from "https://www.msx.org/wiki/BSAVE"