summaryrefslogtreecommitdiffstatshomepage
path: root/src/lib/formats/p2000t_cas.cpp
blob: 6a858e486c40b2335da17e6c47c4066da675a367 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
// license:BSD-3-Clause
// copyright-holders:Curt Coder

#include <cassert>

#include "cassimg.h"
#include "p2000t_cas.h"
#include <ostream>

// This code will reproduce the timing of a P2000 mini cassette tape.
constexpr double P2000_CLOCK_PERIOD = 0.000084;
constexpr double P2000_BOT_GAP      = 1;
constexpr double P2000_BOB_GAP      = 0.515;
constexpr double P2000_MARK_GAP     = 0.085;
constexpr double P2000_END_GAP      = 0.155;
constexpr double P2000_EOT_GAP      = 1.8;
constexpr int P2000_HIGH            = 0x7FFFFFFF;
constexpr int P2000_LOW             = -1 * 0x7FFFFFFF;


#define CHR(x)                                 \
	err = (x);                                 \
	if (err != cassette_image::error::SUCCESS) \
		return err;

/*
Here's a description on how the P2000t stores data on tape.

## Tape Format

Each track (or side) of a cassette is divided into 40 block of information. A
file may comprise between 1 and 40 blocks, depending on its length.

## Blocks, Gaps, Marks and Records

At the start of the tape is an area of clear (erased) tape, the BOT (beginning
of tape) gap; to read pas this gap takes approximately 1 second. After this, the
first block starts, followed directly by the second, third and so on. After the
last block on the track comes the EOT (end of tape) gap; if all 40 blocks on the
tracks are used, this area of erased tape has a length equivalent to 1.8 seconds
of reading time.

 | BOT | BLOCK 1 | BLOCK 2 | BLOCK ... | EOT |

### BLOCK

Each tape block is made up of five sections of tape:

| START GAP | MARK | MARK GAP | DATA RECORD | END GAP |

- Start gap: A section of erased tape separating the start of one block from the
             end of the previous block. This takes approx. 515ms to read over.
- Mark: Four bytes of recorded information (described below)
- Mark Gap: A section of erased tape separating the mark from the data record;
            length about 85ms.
- Data Record: 1056 bytes of recorded data (described below)
- End Gap: A section of erased tape of around 155 ms.

### MARK

The mark is made up of four bytes with the following bit patterns:

  - preamble syncronization pattern (0xAA)
  - 0000 0000 (0x00)
  - 0000 0000 (0x00)
  - postamble syncronization pattern (0xAA)

The function of the synchronisation byte is to make sure the RDC clock is set
properly.

### DATA RECORD

The data record contains the information which has been written onto the tape.
It compromises five sections:

| sync byte | header | data | check sum | post sync |

- sync byte: Preamble synchronisation pattern 0xAA
- header: 32 bytes which specify the contents and type of the data section. (See below)
- data section: 1024 bytes of information.
- checksum: 2 bytes that contain checksum
- post sync: 0xAA

### HEADER

See the struct declaration below for details on what is contained.

### DATA

The data section consists of 1024 bytes written in serial form, least
significant byte first.

### Checksum

The checksum is only calculated for the header and data section. The algorithm
is not documented, an implementation can be found below.
*/

// Specifies the type of data stored in the tape block
enum P2000_File_Type : uint8_t
{
	Basic          = 'B',
	Program        = 'P',
	Viewdata       = 'V',
	WordProcessing = 'W',
	Other          = 'O',
};

// Represents the internal code for data, differrent codes are used in different countries
// only relevant when P2000_File_Type is Program.
enum P2000_Data_Type : uint8_t
{
	German        = 'D',
	Swedish       = 'S',
	Dutch_English = 'U',
};


// This is the 32 byte header definition used by the P2000, it is mainly
// here for documentation.
struct P2000T_Header
{
	// Starting address in ram where data should go. This address is supplied by
	// the application program when calling the monitor cassette routine to write
	// the data on cassette in the first place.
	uint16_t data_transfer_address;
	// Total # of bytes which make up the file (can be spread over many blocks).
	// The monitor uses this to determine how many blocks to read.
	uint16_t file_length;
	// # bytes in this record that are actually used. For example if this is 256
	// only 256 bytes will be loaded in ram
	uint16_t data_section_length;
	// The eight character file name identifies the file to which the record
	// belongs; it will be the same in all records making up the file. Each record
	// except the first is considered an extension.
	char file_name[8];
	// Addition file extension.
	char ext[3];
	// This file type specifies the type of data stored.
	P2000_File_Type file_type;
	// Code and region information.
	P2000_Data_Type data_code;
	// Start address where program should start. (if type = Program)
	uint16_t start_addr;
	// Address in ram where the program should load (if type = Program)
	uint16_t load_addr;
	// Unused.
	char reserved[8];
	// Record number (i.e. which block)
	uint8_t rec_nr;
};

std::ostream &operator<<(std::ostream &os, P2000T_Header const &hdr)
{
	return os << "File: " << std::string(hdr.file_name, 8) << '.'
			  << std::string(hdr.ext, 3) << "  " << hdr.file_length;
}

static cassette_image::error p2000t_cas_identify(cassette_image *cass, struct CassetteOptions *opts)
{
	opts->bits_per_sample  = 32;
	opts->channels         = 1;
	opts->sample_frequency = 44100;
	return cassette_image::error::SUCCESS;
}

uint16_t rotr16a(uint16_t x, uint16_t n)
{
	return (x >> n) | (x << (16 - n));
}

void update_chksum(uint16_t *de, bool bit)
{
	// Reverse engineered from monitor.rom
	// code is at: [0x07ac, 0x07c5]
	uint8_t e = *de & 0xff;
	uint8_t d = (*de >> 8) & 0xff;
	e         = e ^ (bit ? 1 : 0);
	if (e & 0x01)
	{
		e = e ^ 2;
		d = d ^ 0x40;
	}
	else
	{
		d = d ^ 0x00;
	}
	*de = rotr16a((d << 8) | e, 1);
}

/*
    A transition on a clock boundary from low to high is a 1.
    A transition on a clock boundary from high to low is a 0
    An intermediate transition halfway between the clock boundary
    can occur when there are consecutive 0s or 1s. See the example
    below where the clock is marked by a |


            1    0    1    1    0    0
    RDA:  _|----|____|--__|----|__--|__--
    RDC:  _|-___|-___|-___|-___|-___|-___
            ^                     ^
            |-- clock signal      |-- intermediate transition.

    This signal can be written by a simple algorithm where the first bit
    is always false (transition to low, half clock).  Now only one bit is needed
    to determine what the next partial clock should look like.

    This works because we are always guaranteed that a block starts with 0xAA,
    and hence will ALWAYS find a signal like this on tape: _-- (low, high, high)
    after a gap. This is guaranteed when the tape is moving forward as well as
    backwards.
*/
cassette_image::error p2000t_put_bit(cassette_image *cass, double *time_index, bool bit)
{
	const int channel         = 0;
	cassette_image::error err = cassette_image::error::SUCCESS;
	CHR(cassette_put_sample(cass, channel, *time_index, P2000_CLOCK_PERIOD, bit ? P2000_HIGH : P2000_LOW));
	*time_index += P2000_CLOCK_PERIOD;

	CHR(cassette_put_sample(cass, channel, *time_index, P2000_CLOCK_PERIOD, bit ? P2000_LOW : P2000_HIGH));
	*time_index += P2000_CLOCK_PERIOD;
	return err;
}

// Store byte of data, updating the checksum
cassette_image::error p2000t_put_byte(cassette_image *cass, double *time_index, uint16_t *chksum, uint8_t byte)
{
	cassette_image::error err = cassette_image::error::SUCCESS;
	for (int i = 0; i < 8 && err == cassette_image::error::SUCCESS; i++)
	{
		update_chksum(chksum, util::BIT(byte, i));
		CHR(p2000t_put_bit(cass, time_index, util::BIT(byte, i)));
	}
	return err;
}

// Store a sequence of bytes, updating the checksum
cassette_image::error p2000t_put_bytes(cassette_image *cass, double *time_index, uint16_t *chksum, const uint8_t *bytes, const uint16_t cByte)
{
	cassette_image::error err = cassette_image::error::SUCCESS;
	for (int i = 0; i < cByte && err == cassette_image::error::SUCCESS; i++)
	{
		CHR(p2000t_put_byte(cass, time_index, chksum, bytes[i]));
	}
	return err;
}

// Insert time seconds of silence.
cassette_image::error p2000t_silence(cassette_image *cassette,
double *time_index,
double time)
{
	auto err = cassette_put_sample(cassette, 0, *time_index, time, 0);
	*time_index += time;
	return err;
}

static cassette_image::error p2000t_cas_load(cassette_image *cassette)
{
	cassette_image::error err = cassette_image::error::SUCCESS;
	uint64_t image_size       = cassette_image_size(cassette);
	constexpr int CAS_BLOCK   = 1280;

	/*
	    The cas format is pretty simple. it consists of a sequence of blocks,
	    where a block consists of the following:

	    [0-256]   P2000 memory address 0x6000 - 0x6100
	    ....   Nonsense (keyboard status etc.)
	    0x30   P200T_Header
	    0x50
	    ...    Nonsense..
	    [0-1024] Data block

	    This means that one block gets stored in 1280 bytes.
	*/
	if (image_size % CAS_BLOCK != 0)
	{
		return cassette_image::error::INVALID_IMAGE;
	}

	uint8_t block[CAS_BLOCK];
	constexpr uint8_t BLOCK_MARK[4] = { 0xAA, 0x00, 0x00, 0xAA };
	auto blocks                     = image_size / CAS_BLOCK;
	double time_idx                 = 0;

	// Beginning of tape marker
	CHR(p2000t_silence(cassette, &time_idx, P2000_BOT_GAP));
	for (int i = 0; i < blocks; i++)
	{
		uint16_t crc = 0, unused = 0;
		cassette_image_read(cassette, &block, CAS_BLOCK * i, CAS_BLOCK);

		// Insert sync header.. 0xAA, 0x00, 0x00, 0xAA
		CHR(p2000t_silence(cassette, &time_idx, P2000_BOB_GAP));
		CHR(p2000t_put_bytes(cassette, &time_idx, &unused, BLOCK_MARK, ARRAY_LENGTH(BLOCK_MARK)));
		CHR(p2000t_silence(cassette, &time_idx, P2000_MARK_GAP));

		// Insert data block
		CHR(p2000t_put_byte(cassette, &time_idx, &unused, 0xAA));
		CHR(p2000t_put_bytes(cassette, &time_idx, &crc, block + 0x30, 32));
		CHR(p2000t_put_bytes(cassette, &time_idx, &crc, block + 256, 1024));
		CHR(p2000t_put_bytes(cassette, &time_idx, &unused, ( uint8_t * )&crc, 2));
		CHR(p2000t_put_byte(cassette, &time_idx, &unused, 0xAA));

		// Block finished.
		CHR(p2000t_silence(cassette, &time_idx, P2000_END_GAP));
	}

	// End of tape marker
	return p2000t_silence(cassette, &time_idx, P2000_EOT_GAP);
}

static const struct CassetteFormat p2000t_cas = {
	"cas", p2000t_cas_identify, p2000t_cas_load, nullptr /* no save */
};

CASSETTE_FORMATLIST_START(p2000t_cassette_formats)
CASSETTE_FORMAT(p2000t_cas)
CASSETTE_FORMATLIST_END