TeleDisk decoder library targetting LIF format images only. More...

#include <string.h>
#include <stdlib.h>
#include <stdio.h>
#include <inttypes.h>
#include <time.h>
#include "user_config.h"
#include "lifsup.h"
#include "lifutils.h"
#include "td02lif.h"
#include "td0_lzss.h"

Functions
void	td0_B2S (uint8_t B, int index, uint8_t name, int size)
	Create a string from data that has no EOS but known size. More...

uint16_t	td0_crc16 (uint8_t *B, uint16_t crc, uint16_t poly, int size)
	Compute CRC16 of 8bit data. More...

void	td0_hexdump (uint8_t *data, int size)
	hex listing of data More...

int	td0_unpack_disk_header (uint8_t B, td_header_t p)
	Extract TeleDisk image header data in architecture nutral way. More...

int	td0_unpack_comment_header (uint8_t B, td_comment_t p)
	Extract TeleDisk comment header data in architecture nutral way. More...

int	td0_unpack_track_header (uint8_t B, td_track_t p)
	Extract TeleDisk track header data in architecture nutral way. More...

int	td0_unpack_sector_header (uint8_t B, td_sector_t p)
	Extract TeleDisk sector header data in architecture nutral way. More...

void	td0_compressed (int flag)
	Enable TeleDisk image compression mode. More...

int	td0_read (void p, int osize, int size, FILE fp)
	Read TeleDisk image data block Optionally decompress the data if decompression is enabled. More...

int	td0_rle (uint8_t dst, uint8_t src, int max)
	Expand a Run Length encoded TeleDisk sector Notes: the source length is encoded in the source data Credits based on work (C) 2006-2014 Jean-Fran�ois DEL NERO Part of the HxCFloppyEmulator library GNU GPL version 2 or later Rewitten for clarity,to enforce size limits, provide error reporting and to avoid word order dependent assumptions,. More...

void	td0_trackinfo (disk_t *disk, int trackind, int index)
	Display TeleDisk track sector values. More...

void	td0_sectorinfo (td_sector_t *P)
	Display TeleDisk sector data. More...

long	td0_density2bitrate (uint8_t density)
	Convert Denisity to bitrate @We don't care about the density except as a possible filter. More...

int	td0_open (disk_t disk, char name)
	Opne TeleDisk image file process header and optional comment block. More...

int	td0_read_disk (disk_t *disk)
	Read TeleDisk image file and save all sector data. More...

int	td0_analize_format (disk_t *disk)
	Analize TeleDisk disk sector data Problem: We may have a disk that was reformatted multiple times Each format may have used differing sector sizes, number of tracks, sides For example: First format 80 track disk, two sided, and 9 512 byte sectors per track Second format 35 tracks, single sided, 16 sectors 256 bytes size per track Clearly we only want the 35 tracks on the first side. More...

int	td0_save_lif (disk_t disk, lif_t LIF)
	save remaining sectors as LIF data More...

int	td0_save_lif_sector (disk_t disk, uint8_t data, int size, lif_t *LIF)
	Process all sectors on a track from TeleDisk image. More...

void	td0_help (int full)

void	td0_init_liftel ()
	TeleDisk image Analisis structure Find attributes of LIF image stored in TeleDisk image. More...

void	td0_init_sectors (disk_t *disk)
	Initialize track sector information Optionally decompress the data if decompression is enabled. More...

int	td02lif (int argc, char *argv[])
	Convert a Teledisk LIF formatted disk image into a pure LIF image. More...

Variables
disk_t	disk
	Dave Dunfiled LZSS expander. More...

liftel_t	liftel
	Teledisk liftel analysis and user overrides. More...

Detailed Description

TeleDisk decoder library targetting LIF format images only.

Copyright © 2014-2020 Mike Gore, Inc. All rights reserved. GPL

See also: http://github.com/magore/hp85disk; http://github.com/magore/hp85disk/COPYRIGHT.md for Copyright details

@help LIF command help lif td02lif image.td0 image.lif Convert TeleDisk encoded LIF disk image into to pure LIF image TELEDISK command help td02lif file.td0 file.lif Convert TeleDisk encoded LIF disk image into to pure LIF image

Edit History

[1.0] [Mike Gore] Initial revision of file.

@Credits lif/teledisk My TELEDISK LIF extracter Note: The TeleDisk image MUST contain a LIF image - we do NOT translate it README.txt Credits Important Contributions (My converted would not have been possible without these) Dave Dunfield, LZSS Code and TeleDisk documentation Copyright 2007-2008 Dave Dunfield All rights reserved. td0_lzss.h td0_lzss.c LZSS decoder td0notes.txt Teledisk Documentation Jean-Franois DEL NERO, TeleDisk Documentation Copyright (C) 2006-2014 Jean-Franois DEL NERO wteledsk.htm TeleDisk documenation See his github project https://github.com/jfdelnero/libhxcfe

Definition in file td02lif.c.

Function Documentation

◆ td02lif()

int td02lif	(	int	argc,
		char *	argv[]
	)

Convert a Teledisk LIF formatted disk image into a pure LIF image.

Parameters

[in]	telediskname	TELEDISK image name
[in]	lifname	LIF file name to write

Returns: 1 on success, 0 on error

Write LIF file

LIF summary

Close LIF file

Definition at line 1650 of file td02lif.c.

Referenced by lif_tests().

◆ td0_analize_format()

int td0_analize_format ( disk_t * disk )

Analize TeleDisk disk sector data Problem: We may have a disk that was reformatted multiple times Each format may have used differing sector sizes, number of tracks, sides For example: First format 80 track disk, two sided, and 9 512 byte sectors per track Second format 35 tracks, single sided, 16 sectors 256 bytes size per track Clearly we only want the 35 tracks on the first side.

What we do is examine the first 30 tracks (note: 30 is just a safe number less then 35) On side 1, on 30 tracks Find first sector and save its size Reject sectors that do not match size Find Last sector matching size Count sectors matching size On side 2, on 30 tracks Reject sectors that do not match size Find first sector and save its size Find Last sector matching size Count sectors matching size

If the disk had two sides recorded in the header Reject second side if side sector counts do NOT match Reject second side if NO remaining sectors Reject second side if sector ranges do not match or continue in range

Parameters

[in] dist TD0 image data @retrun 1 if OK, 0 on error

Definition at line 896 of file td02lif.c.

Referenced by td02lif().

◆ td0_B2S()

void td0_B2S	(	uint8_t *	B,
		int	index,
		uint8_t *	name,
		int	size
	)

Create a string from data that has no EOS but known size.

Parameters

[in]	*B	source
[in]	index	index offset into source data
[out]	*name	target string
[in]	size	size of string to write - not including EOS

Returns: void

Definition at line 68 of file td02lif.c.

Referenced by td0_unpack_disk_header().

◆ td0_compressed()

void td0_compressed ( int flag )

Enable TeleDisk image compression mode.

Parameters

[in] flag compression anable/disable

Returns: void

Definition at line 250 of file td02lif.c.

Referenced by td0_open().

◆ td0_crc16()

uint16_t td0_crc16	(	uint8_t *	B,
		uint16_t	crc,
		uint16_t	poly,
		int	size
	)

Compute CRC16 of 8bit data.

See also: https://en.wikipedia.org/wiki/Cyclic_redundancy_check FYI normal CRC16 typically use 0x1021 for ploy Note: You can do a CRC16 of data in blocks by passing the result as the crc initial value for the next call

Parameters

[in]	*B	8 bit binary data
[in]	crc	initial crc value
[out]	poly	ploynomial
[in]	size	number of bytes

Returns: crc16 of result

Definition at line 87 of file td02lif.c.

Referenced by td0_open(), td0_read_disk(), td0_unpack_comment_header(), td0_unpack_disk_header(), and td0_unpack_track_header().

◆ td0_density2bitrate()

long td0_density2bitrate ( uint8_t density )

Convert Denisity to bitrate @We don't care about the density except as a possible filter.

Parameters

[in] Density

Returns: bitrate

Definition at line 472 of file td02lif.c.

◆ td0_help()

void td0_help ( int full )

Definition at line 1556 of file td02lif.c.

Referenced by help(), lif_tests(), and td02lif().

◆ td0_hexdump()

void td0_hexdump	(	uint8_t *	data,
		int	size
	)

hex listing of data

Parameters

[in]	*data	date to dump
[in]	size	size of data to dump @retrun void

Definition at line 110 of file td02lif.c.

Referenced by td0_save_lif_sector().

◆ td0_init_liftel()

void td0_init_liftel ( )

TeleDisk image Analisis structure Find attributes of LIF image stored in TeleDisk image.

Definition at line 1577 of file td02lif.c.

Referenced by td02lif().

◆ td0_init_sectors()

void td0_init_sectors ( disk_t * disk )

Initialize track sector information Optionally decompress the data if decompression is enabled.

Parameters

[out]	p	data buffer for read
[out]	osize	size of object
[out]	size	number of objects to read

Returns: size of dataactually read

Definition at line 1614 of file td02lif.c.

Referenced by td02lif().

◆ td0_open()

int td0_open	(	disk_t *	disk,
		char *	name
	)

Opne TeleDisk image file process header and optional comment block.

Parameters

[in]	*disk	TeleDisk information structure
[in]	*name	image file name

Returns: 1 on success 0 on error Note: on success disk->fi has the file handle disk->td0_name has the file name disk->compresssed if image is compressed disk->td_header has teledisk header disk->td_comment has optional teledisk comment header or zeroed If disk.td_comment.Size > 0 disk->comment has optional comment string or empty string If disk.td_comment.Size > 0

@process TeleDisk disk image header

we expect "TD" (uncompressed) or "td" (compressed) format

We only accept TeleDisk versions >= 10 && version <= 21

Time to Unix format

Definition at line 506 of file td02lif.c.

Referenced by td02lif().

◆ td0_read()

int td0_read	(	void *	p,
		int	osize,
		int	size,
		FILE *	fp
	)

Read TeleDisk image data block Optionally decompress the data if decompression is enabled.

Parameters

[out]	p	data buffer for read
[out]	osize	size of object
[out]	size	number of objects to read

Returns: 1 on success all bytes read, 0 on failure not all bytes read

Definition at line 264 of file td02lif.c.

Referenced by td0_open(), and td0_read_disk().

◆ td0_read_disk()

int td0_read_disk ( disk_t * disk )

Read TeleDisk image file and save all sector data.

Parameters

[in] dist TD0 image data

Returns: 1 on success 0 on error

Process all image Data

EOF? TeleDisk specification says EOF is 255 sectors

Process all track sectors

Sector Header

first test verifies sector < 2K in size second test verifies no data or address mark errors

Compute how much data to read

td0_rle does not use len internal data in the buffer does this We limit the expansion to sector size

=========================================

Definition at line 643 of file td02lif.c.

Referenced by td02lif().

◆ td0_rle()

int td0_rle	(	uint8_t *	dst,
		uint8_t *	src,
		int	max
	)

Expand a Run Length encoded TeleDisk sector Notes: the source length is encoded in the source data Credits based on work (C) 2006-2014 Jean-Fran�ois DEL NERO Part of the HxCFloppyEmulator library GNU GPL version 2 or later Rewitten for clarity,to enforce size limits, provide error reporting and to avoid word order dependent assumptions,.

Parameters

[out]	dst	destination expanded data
[in]	src	source data
[in]	max	maximum size of destination data

Returns: size of expanded data, negative if size > max

@actual length

block size

repeat count

Definition at line 307 of file td02lif.c.

Referenced by td0_read_disk().

◆ td0_save_lif()

int td0_save_lif	(	disk_t *	disk,
		lif_t *	LIF
	)

save remaining sectors as LIF data

Parameters

[in]	data	sector data
[in]	LIF	LIF structure @retrun 1 if OK, 0 on error

Definition at line 1303 of file td02lif.c.

Referenced by td02lif().

◆ td0_save_lif_sector()

int td0_save_lif_sector	(	disk_t *	disk,
		uint8_t *	data,
		int	size,
		lif_t *	LIF
	)

Process all sectors on a track from TeleDisk image.

Parameters

[in]	data	sector data
[in]	size	sector size
[in]	LIF	LIF structure @retrun 1 if OK, 0 on error

==================================================== Write sectors from Teledisk track to LIF file

We continue until the last last file sector

Definition at line 1366 of file td02lif.c.

Referenced by td0_save_lif().

◆ td0_sectorinfo()

void td0_sectorinfo ( td_sector_t * P )

Display TeleDisk sector data.

Parameters

[in] P td_sector pointer

Returns: void

Definition at line 458 of file td02lif.c.

Referenced by td0_read_disk().

◆ td0_trackinfo()

void td0_trackinfo	(	disk_t *	disk,
		int	trackind,
		int	index
	)

Display TeleDisk track sector values.

Parameters

[in]	sector	track sector structure
[in]	index	sector index (not sector number)

Returns: void

Definition at line 443 of file td02lif.c.

Referenced by td0_analize_format(), and td0_read_disk().

◆ td0_unpack_comment_header()

int td0_unpack_comment_header	(	uint8_t *	B,
		td_comment_t *	p
	)

Extract TeleDisk comment header data in architecture nutral way.

Parameters

[in]	B	source data
[out]	p	TeleDisk comment header structure

Returns: TeleDisk comment header size (not structure size)

Definition at line 178 of file td02lif.c.

Referenced by td0_open().

◆ td0_unpack_disk_header()

int td0_unpack_disk_header	(	uint8_t *	B,
		td_header_t *	p
	)

Extract TeleDisk image header data in architecture nutral way.

Parameters

[in]	B	source data
[out]	p	TeleDisk image header structure

Returns: TeleDisk image header size (not structure size)

Definition at line 151 of file td02lif.c.

Referenced by td0_open().

◆ td0_unpack_sector_header()

int td0_unpack_sector_header	(	uint8_t *	B,
		td_sector_t *	p
	)

Extract TeleDisk sector header data in architecture nutral way.

Parameters

[in]	B	source data
[out]	p	TeleDisk sector header structure

Returns: TeleDisk sector header size (not structure size)

Definition at line 232 of file td02lif.c.

Referenced by td0_read_disk().

◆ td0_unpack_track_header()

int td0_unpack_track_header	(	uint8_t *	B,
		td_track_t *	p
	)

Extract TeleDisk track header data in architecture nutral way.

Parameters

[in]	B	source data
[out]	p	TeleDisk track header structure

Returns: TeleDisk track header size (not structure size)

Definition at line 201 of file td02lif.c.

Referenced by td0_read_disk().

Variable Documentation

◆ disk

disk_t disk

Dave Dunfiled LZSS expander.

Definition at line 57 of file td02lif.c.

Referenced by td02lif(), td0_analize_format(), td0_compressed(), td0_init_sectors(), td0_open(), td0_read(), td0_read_disk(), td0_save_lif(), and td0_trackinfo().

◆ liftel

liftel_t liftel

Teledisk liftel analysis and user overrides.

Definition at line 60 of file td02lif.c.

Referenced by td02lif(), td0_analize_format(), td0_init_liftel(), td0_save_lif(), and td0_save_lif_sector().

Functions

Variables

Detailed Description

Function Documentation

◆ td02lif()

◆ td0_analize_format()

◆ td0_B2S()

◆ td0_compressed()

◆ td0_crc16()

◆ td0_density2bitrate()

◆ td0_help()

◆ td0_hexdump()

◆ td0_init_liftel()

◆ td0_init_sectors()

◆ td0_open()

◆ td0_read()

◆ td0_read_disk()

◆ td0_rle()

◆ td0_save_lif()

◆ td0_save_lif_sector()

We continue until the last last file sector

◆ td0_sectorinfo()

◆ td0_trackinfo()

◆ td0_unpack_comment_header()

◆ td0_unpack_disk_header()

◆ td0_unpack_sector_header()

◆ td0_unpack_track_header()

Variable Documentation

◆ disk

◆ liftel