D80D82 specific functions

Functions
static uint16_t	cbmimage_i_d80_d82_get_sectors_in_track (cbmimage_image_settings *settings, uint16_t track)
static int	cbmimage_i_d80_d82_ts_to_blockaddress (cbmimage_image_settings *settings, cbmimage_blockaddress *block)
static int	cbmimage_i_d80_d82_lba_to_blockaddress (cbmimage_image_settings *settings, cbmimage_blockaddress *block)
static void	cbmimage_i_d80_d82_calculate_track_lba_start_table (cbmimage_image_settings *settings)
static void	cbmimage_i_d80_d82_image_create (cbmimage_fileimage *image, cbmimage_imagetype imagetype, unsigned char *imagetype_name, uint8_t maxtracks)
void	cbmimage_i_d80_image_open (cbmimage_fileimage *image)
void	cbmimage_i_d82_image_open (cbmimage_fileimage *image)

Variables
static const cbmimage_fileimage_functions	d80_d82_fileimage_functions

Detailed Description

Function Documentation

cbmimage_i_d80_d82_calculate_track_lba_start_table()

static void cbmimage_i_d80_d82_calculate_track_lba_start_table ( cbmimage_image_settings * settings )

static

create the "LBA start table"

In order to ease the calculation of LBA to T/S or vice versa (cf. cbmimage_i_d80_d82_ts_to_blockaddress(), cbmimage_i_d80_d82_lba_to_blockaddress()) an internal table of the first LBA on a track is used internally.
This function initializes this table.

Parameters

[in]

settings

pointer to the image data internal settings

cbmimage_i_d80_d82_get_sectors_in_track()

static uint16_t cbmimage_i_d80_d82_get_sectors_in_track ( cbmimage_image_settings * settings, uint16_t track )

static

get the number of sectors on a specific track of the D80 and D82 image

Parameters

[in]	settings	pointer to the image data internal settings
[in]	track	the track number for which to obtain the number of sectors

Returns

Number of sectors on this specific track in the image

Remarks

• This is the number of sectors on this specific track. Due to the nature of many CBM disk images, including D80 and D82 images, the number of sectors can vary from track to track.
  To obtain the maximum number of sectors on any track, use cbmimage_get_max_sectors() instead!
• As the CBM sector numbering goes, the sector range is from 0 to the result of this call minus 1.
  For example, for D64 images on the first speed zone (i.e., tracks 1 to 17), this function will return 21, giving a range of 0 .. 20.

cbmimage_i_d80_d82_image_create()

static void cbmimage_i_d80_d82_image_create ( cbmimage_fileimage * image, cbmimage_imagetype imagetype, unsigned char * imagetype_name, uint8_t maxtracks )

static

create a D80 or D82 image

Parameters

[in]	image	pointer to the image data
[in]	imagetype	The type of image that should be created
[in]	imagetype_name	The name of the image type that should be stored in the images. This value is only informational and can be asked for by the user; it is not used internally.
[in]	maxtracks	The maximum number of tracks of this image

cbmimage_i_d80_d82_lba_to_blockaddress()

static int cbmimage_i_d80_d82_lba_to_blockaddress ( cbmimage_image_settings * settings, cbmimage_blockaddress * block )

static

convert the LBA to T/S block address

Parameters

[in]	settings	pointer to the image data internal settings
[in,out]	block	pointer to a block address with an initialized LBA address

Returns

• 0 if no error occurred
• != 0 if an error occurred

Remarks

• the block address is completely created from the lba parameter
• an error occurs if the lba block does not exist on this type of image

cbmimage_i_d80_d82_ts_to_blockaddress()

static int cbmimage_i_d80_d82_ts_to_blockaddress ( cbmimage_image_settings * settings, cbmimage_blockaddress * block )

static

convert the T/S to LBA block address

Parameters

[in]	settings	pointer to the image data internal settings
[in,out]	block	pointer to a block address witn an initialized T/S address

Returns

• 0 if no error occurred
• != 0 if an error occurred

Remarks

• the block address is completely created from the ts parameter
• an error occurs if the track/sector combination does not exist on this type of image

cbmimage_i_d80_image_open()

void cbmimage_i_d80_image_open

(

cbmimage_fileimage *

image

)

create structures for a D80 image

Parameters

[in]

image

pointer to the image data

cbmimage_i_d82_image_open()

void cbmimage_i_d82_image_open

(

cbmimage_fileimage *

image

)

create structures for a D82 image

Parameters

[in]

image

pointer to the image data

Variable Documentation

d80_d82_fileimage_functions

const cbmimage_fileimage_functions d80_d82_fileimage_functions

static

Initial value:

= {
  .get_sectors_in_track = cbmimage_i_d80_d82_get_sectors_in_track,
  .ts_to_blockaddress = cbmimage_i_d80_d82_ts_to_blockaddress,
  .lba_to_blockaddress = cbmimage_i_d80_d82_lba_to_blockaddress,
}

template for the file image functions for D80 and D82 images

This is a template that is copied into the image specific data.