void sample_code(void) {
INT32 i, j, k; /* Index & counters */
long Value;
INT32 disk_id, sector; /* Used for disk requests */
char disk_buffer_write[PGSIZE ];
char disk_buffer_read[PGSIZE ];
char physical_memory_write[PGSIZE ];
char physical_memory_read[PGSIZE ];
void *context_pointer; /* Used for context commands*/
void *starting_address;
BOOL kernel_or_user;
short random_buckets[NUM_RAND_BUCKETS];
INT32 LockResult;
INT32 Status;
INT32 Temp, Temp1;
/*********************************************************************
Show the interface to the delay timer.
Eventually the timer will interrupt ( in base.c there's a handler for
this ), but here in sample_code.c we're merely showing the interface
to start the call.
*********************************************************************/
MEM_READ(Z502TimerStatus, &Status);
if (Status == DEVICE_FREE)
printf("Got expected result for Status of Timer\n");
else
printf("Got erroneous result for Status of Timer\n");
Temp = 777; /* You pick the time units */
MEM_WRITE(Z502TimerStart, &Temp);
MEM_READ(Z502TimerStatus, &Status);
if (Status == DEVICE_IN_USE)
printf("Got expected result for Status of Timer\n");
else
printf("Got erroneous result for Status of Timer\n");
printf("The next output from the Interrupt Handler should report that \n");
printf(" interrupt of device 4 has occurred with no error.\n");
Z502Idle(); // Let the interrupt for this timer occur
// Now we're going to try an illegal time and ensure that the fault
// handler reports an illegal status.
Temp = -77; /* You pick the time units */
printf("The next output from the Interrupt Handler should report that \n");
printf(
" interrupt of device 4 has occurred with an ERR_BAD_PARAM = 1.\n");
MEM_WRITE(Z502TimerStart, &Temp);
MEM_READ(Z502TimerStatus, &Status);
if (Status == DEVICE_FREE) // Bogus value shouldn't start timer
printf("Got expected result for Status of Timer\n");
else
printf("Got erroneous result for Status of Timer\n");
fflush(stdout);
// ZCALL( Z502_IDLE() ); // Let the interrupt for this timer occur
/* The interrupt handler will have exercised the code doing
Z502InterruptDevice, Z502InterruptStatus, and Z502InterruptClear.
But they will have been tested only for "correct" usage.
Let's try a few erroneous/illegal operations. */
// Set an illegal device as target of our query
Temp = LARGEST_STAT_VECTOR_INDEX + 1;
MEM_WRITE(Z502InterruptDevice, &Temp);
// Now read the status of this device
MEM_READ(Z502InterruptStatus, &Status);
if (Status == ERR_BAD_DEVICE_ID)
printf("Got expected result for Status of Illegal Device\n");
else
printf("Got erroneous result for Status of Illegal Device\n");
/*********************************************************************
Show the interface to the Z502_CLOCK.
This is easy - all we're going to do is read it twice and make sure
the time is incrementing.
*********************************************************************/
MEM_READ(Z502ClockStatus, &Temp);
MEM_READ(Z502ClockStatus, &Temp1);
if (Temp1 > Temp)
printf("The clock time incremented correctly - %d1, %d2\n", Temp,
Temp1);
else
printf("The clock time did NOT increment correctly - %d1, %d2\n", Temp,
Temp1);
/*********************************************************************
Show the interface to the disk read and write.
Eventually the disk will interrupt ( in base.c there's a handler for
this ), but here in sample_code.c we're merely showing the interface
to start the call.
*********************************************************************/
disk_id = 1; /* Pick arbitrary disk location */
sector = 3;
/* Put data into the buffer being written */
strncpy(disk_buffer_write, "123456789abcdef", 15);
/* Do the hardware call to put data on disk */
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_READ(Z502DiskStatus, &Temp);
if (Temp == DEVICE_FREE) // Disk hasn't been used - should be free
printf("Got expected result for Disk Status\n");
else
printf("Got erroneous result for Disk Status - Device not free.\n");
MEM_WRITE(Z502DiskSetSector, §or);
MEM_WRITE(Z502DiskSetBuffer, (INT32 * )disk_buffer_write);
Temp = 1; // Specify a write
MEM_WRITE(Z502DiskSetAction, &Temp);
Temp = 0; // Must be set to 0
MEM_WRITE(Z502DiskStart, &Temp);
// Disk should now be started - let's see
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_READ(Z502DiskStatus, &Temp);
if (Temp == DEVICE_IN_USE) // Disk should report being used
printf("Got expected result for Disk Status\n");
else
printf("Got erroneous result for Disk Status\n");
/* Wait until the disk "finishes" the write. the write is an
"unpended-io", meaning the call returns before the work is
completed. By doing the IDLE here, we wait for the disk
action to complete. */
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_READ(Z502DiskStatus, &Temp);
while (Temp != DEVICE_FREE) {
Z502Idle();
MEM_READ(Z502DiskStatus, &Temp);
}
/* Now we read the data back from the disk. If we're lucky,
we'll read the same thing we wrote! */
MEM_WRITE(Z502DiskSetSector, §or);
MEM_WRITE(Z502DiskSetBuffer, (INT32 * )disk_buffer_read);
Temp = 0; // Specify a read
MEM_WRITE(Z502DiskSetAction, &Temp);
Temp = 0; // Must be set to 0
MEM_WRITE(Z502DiskStart, &Temp);
/* wait for the disk action to complete. */
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_READ(Z502DiskStatus, &Temp);
while (Temp != DEVICE_FREE) {
Z502Idle();
MEM_READ(Z502DiskStatus, &Temp);
}
printf("\n\nThe disk data written is: %s\n", disk_buffer_write);
printf("The disk data read is: %s\n", disk_buffer_read);
/*********************************************************************
Let's try some intentional errors to see what happens
*********************************************************************/
Temp = 0; // Must be set to 0
MEM_WRITE(Z502DiskStart, &Temp);
// Try reading the status without setting an ID
MEM_READ(Z502DiskStatus, &Temp);
if (Temp == ERR_BAD_DEVICE_ID)
printf("Got expected result for Disk Status when using no ID\n");
else
printf("Got erroneous result for Disk Status when using no ID\n");
// Try entering a bad ID and then reading the status
disk_id = 999;
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_READ(Z502DiskStatus, &Temp);
if (Temp == ERR_BAD_DEVICE_ID)
printf("Got expected result for Disk Status when using bad ID\n");
else
printf("Got erroneous result for Disk Status when using bad ID\n");
// Try doing everything right EXCEPT entering the buffer address,
disk_id = 1; /* Pick arbitrary disk location */
sector = 3;
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_WRITE(Z502DiskSetSector, §or);
// Don't do this -> MEM_WRITE( Z502DiskSetBuffer, (INT32 *)disk_buffer_write );
Temp = 1; // Specify a write
MEM_WRITE(Z502DiskSetAction, &Temp);
Temp = 0; // Must be set to 0
MEM_WRITE(Z502DiskStart, &Temp);
// Disk should now not be started - it was missing vital info
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_READ(Z502DiskStatus, &Temp);
if (Temp == DEVICE_FREE) // Disk should report being free
printf("Got expected result for Disk Status when missing data\n");
else
printf("Got erroneous result for Disk Status when missing data\n");
/*********************************************************************
Some of the tests put thousands of pages of data on the disk. Let's
see if we can do that here. The pages ARE being written to the disk,
but the interrupt handler doesn't show all of them happening because
it's not catching multiple interrupts.
*********************************************************************/
disk_id = 1;
sector = 0;
printf("The following section will take a few seconds\n");
for (j = 0; j < VIRTUAL_MEM_PGS + 100 /* arbitrary # */; j++) {
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_WRITE(Z502DiskSetSector, §or);
MEM_WRITE(Z502DiskSetBuffer, (INT32 * )disk_buffer_write);
Temp = 1; // Specify a write
MEM_WRITE(Z502DiskSetAction, &Temp);
Temp = 0; // Start the disk
MEM_WRITE(Z502DiskStart, &Temp);
MEM_WRITE(Z502DiskSetID, &disk_id);
MEM_READ(Z502DiskStatus, &Temp);
while (Temp == DEVICE_IN_USE) // Disk should report being used
{
//printf( "Got erroneous result for Disk Status when writing lots of blocks\n" );
Temp = 5; /* You pick the time units */
MEM_WRITE(Z502TimerStart, &Temp);
MEM_READ(Z502DiskStatus, &Temp);
}
sector++;
if (sector >= NUM_LOGICAL_SECTORS) {
sector = 0;
disk_id++;
}
}
/*********************************************************************
Do a physical memory access to check out that it works.
*********************************************************************/
printf("\nStarting test of physical memory write and read.\n");
for (i = 0; i < PGSIZE ; i++) {
physical_memory_write[i] = i;
}
Z502WritePhysicalMemory(17, (char *) physical_memory_write);
Z502ReadPhysicalMemory(17, (char *) physical_memory_read);
for (i = 0; i < PGSIZE ; i++) {
if (physical_memory_write[i] != physical_memory_read[i])
printf("Error in Physical Memory Access\n");
}
printf("Completed test of physical memory write and read.\n");
/*********************************************************************
Start all of the disks at the same time and see what happens.
*********************************************************************/
/*
sector = 0;
for ( disk_id = 1; disk_id <= MAX_NUMBER_OF_DISKS ; disk_id++ )
{
MEM_WRITE( Z502DiskSetID, &disk_id );
MEM_WRITE( Z502DiskSetSector, §or );
MEM_WRITE( Z502DiskSetBuffer, (INT32 *)disk_buffer_write );
Temp = 1; // Specify a write
MEM_WRITE( Z502DiskSetAction, &Temp );
Temp = 0; // Start the disk
MEM_WRITE( Z502DiskStart, &Temp );
sector++;
}
// Now wait until all disks have finished
for ( disk_id = 1; disk_id <= MAX_NUMBER_OF_DISKS ; disk_id++ )
{
MEM_WRITE( Z502DiskSetID, &disk_id );
MEM_READ( Z502DiskStatus, &Temp );
while ( Temp == DEVICE_IN_USE ) // Disk should report being used
{
//ZCALL( Z502_IDLE() );
DoSleep(50);
}
}
*/
printf("Disk multiple-block test is complete\n\n");
/*********************************************************************
Show the interface to read and write of real memory
It turns out, that though these are hardware calls, the Z502
assumes the calls are being made in user mode. Because the
process we're running here in "sample" is in kernel mode,
the calls don't work correctly. For working examples of
these calls, see test2a.
*********************************************************************/
Z502_PAGE_TBL_LENGTH = 64;
Z502_PAGE_TBL_ADDR = (UINT16 *) calloc(sizeof(UINT16),
Z502_PAGE_TBL_LENGTH);
i = PTBL_VALID_BIT;
Z502_PAGE_TBL_ADDR[0] = (UINT16) i;
i = 73;
MEM_WRITE(0, &i);
MEM_READ(0, &j);
/* WE expect the data read back to be the same as what we wrote */
if (i == j)
printf("Memory write and read completed successfully\n");
else
printf("Memory write and read were NOT successful.\n");
/*********************************************************************
This is the interface to the locking mechanism. These are hardware
interlocks. We need to test that they work here. This is the
interface we'll be using.
void Z502_READ_MODIFY( INT32 VirtualAddress, INT32 NewLockValue,
INT32 Suspend, INT32 *LockResult )
We've defined these above to help remember them.
#define DO_LOCK 1
#define DO_UNLOCK 0
#define SUSPEND_UNTIL_LOCKED TRUE
#define DO_NOT_SUSPEND FALSE
*********************************************************************/
printf("++++ Starting Hardware Interlock Testing ++++\n");
// TRY A SERIES OF CALLS AS DESCRIBED HERE
printf("These tests map into the matrix describing the Z502_READ_MODIFY\n");
printf(" described in Appendix A\n\n");
printf(
"1. Start State = Unlocked: Action (Thread 1) = Lock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"2. Start State = locked(1): Action (Thread 1) = unLock: End State = UnLocked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"3. Start State = Unlocked: Action (Thread 1) = unLock: End State = UnLocked\n");
printf(" An Error is Expected\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"4. Start State = unlocked: Action (Thread 1) = tryLock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, DO_NOT_SUSPEND, &LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"5. Start State = Locked(1): Action (Thread 1) = tryLock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, DO_NOT_SUSPEND, &LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"6. Start State = locked(1): Action (Thread 1) = unLock: End State = UnLocked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"7. Start State = Unlocked: Action (Thread 1) = Lock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
// A thread that locks an item it has already locked will succeed
printf(
"8. Start State = locked(1): Action (Thread 1) = Lock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
// Locking a thread that's already locked - but do it with a thread
// other than the one that did the locking.
printf(
"9. Start State = Locked(1): Action (Thread 2) = tryLock: End State = Locked\n");
printf(" An Error is Expected\n");
Status = CreateAThread((int *) DoOnelock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
// Unlock a thread that's already locked - but unlock it with a thread
// other than the one that did the locking.
printf(
"10. Start State = Locked(1): Action (Thread 2) = unLock: End State = Locked\n");
printf(" An Error is Expected\n");
Status = CreateAThread((int *) DoOneUnlock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
// The second thread will try to get the lock held by the first thread. This is OK
// but the second thread will suspend until the first thread releases the lock.
printf(
"11. Start State = Locked(1): Action (Thread 2) = Lock: End State = Locked\n");
Status = CreateAThread((int *) DoOneTrylock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
// The first thread does an unlock. This means the second thread is now able to get
// the lock so there is a "relock" when thread two succeeds.
printf(
"12. Start State = locked(1): Action (Thread 1) = unLock: End State = Locked(by 2)\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
DoSleep(100); /* Wait for locking action of 2nd thread to finish */
printf(
"13. Start State = Locked(2): Action (Thread 3) = unLock: End State = Locked(2)\n");
printf(" An Error is Expected\n");
Status = CreateAThread((int *) DoOneUnlock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
printf(
"14. Start State = Locked(2): Action (Thread 1) = tryLock: End State = Locked(2)\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, DO_NOT_SUSPEND, &LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"15. Start State = locked(2): Action (Thread 1) = unLock: End State = Locked(2)\n");
printf(" An Error is Expected\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf("++++ END of hardware interlock code ++++\n\n");
/*********************************************************************
Show the interface to the CONTEXT calls. We aren't going to do a
SWITCH_CONTEXT here, because that would cause us to start a
process in a strange place and we might never return here.
But we do all the setup required.
*********************************************************************/
/* The context_pointer is returned by the MAKE_CONTEXT call. */
starting_address = (void *) starting_point_for_new_context;
kernel_or_user = USER_MODE;
Z502MakeContext(&context_pointer, starting_address, kernel_or_user);
Z502DestroyContext(&context_pointer);
/*********************************************************************
Show the interface to the scheduler printer.
*********************************************************************/
CALL(SP_setup( SP_TIME_MODE, 99999 ));
CALL(SP_setup_action( SP_ACTION_MODE, "CREATE" ));
CALL(SP_setup( SP_TARGET_MODE, 99L ));
CALL(SP_setup( SP_RUNNING_MODE, 99L ));
for (j = 0; j < SP_MAX_NUMBER_OF_PIDS ; j++)
CALL(SP_setup( SP_READY_MODE, j ));
for (j = 0; j < SP_MAX_NUMBER_OF_PIDS ; j++)
CALL(SP_setup( SP_WAITING_MODE, j+20 ));
for (j = 0; j < SP_MAX_NUMBER_OF_PIDS ; j++)
CALL(SP_setup( SP_SUSPENDED_MODE, j+40 ));
for (j = 0; j < SP_MAX_NUMBER_OF_PIDS ; j++)
CALL(SP_setup( SP_SWAPPED_MODE, j+60 ));
for (j = 0; j < SP_MAX_NUMBER_OF_PIDS ; j++)
CALL(SP_setup( SP_TERMINATED_MODE, j+80 ));
for (j = 0; j < SP_MAX_NUMBER_OF_PIDS ; j++)
CALL(SP_setup( SP_NEW_MODE, j+50 ));
CALL(SP_print_header());
CALL(SP_print_line());
/*********************************************************************
Show the interface to the memory_printer.
*********************************************************************/
for (j = 0; j < 64; j = j + 2) {
MP_setup((INT32) (j), (INT32) (j / 2) % 10, (INT32) j * 16 + 10,
(INT32) (j / 2) % 8);
}
MP_print_line();
/*********************************************************************
Show how the skewed random numbers work on this platform.
*********************************************************************/
for (j = 0; j < NUM_RAND_BUCKETS; j++)
random_buckets[j] = 0;
for (j = 0; j < 100000; j++) {
get_skewed_random_number(&Value, NUM_RAND_BUCKETS);
random_buckets[Value]++;
}
printf("\nTesting that your platform produces correctly skewed random\n");
printf("numbers. Each row should have higher count than the previous.\n");
printf(" Range: Counts in this range.\n");
for (j = 0; j < NUM_RAND_BUCKETS; j = j + 8) {
k = 0;
for (i = j; i < j + 8; i++)
k += random_buckets[i];
printf("%3d - %3d: %d\n", j, j + 7, k);
}
/*********************************************************************
Show the interface to the Z502Halt.
Note that the program will end NOW, since we don't return
from the command.
*********************************************************************/
Z502Halt();
}
void SampleCode(void) {
INT32 i, j, k; // Index & counters
INT32 Counter = 0;
long Value;
MEMORY_MAPPED_IO mmio; // Structure used for hardware interface
short *PAGE_TBL_ADDR;
INT32 disk_id, sector; /* Used for disk requests */
char disk_buffer_write[PGSIZE ];
char disk_buffer_read[PGSIZE ];
char physical_memory_write[PGSIZE ];
char physical_memory_read[PGSIZE ];
short random_buckets[NUM_RAND_BUCKETS];
INT32 LockResult;
SP_INPUT_DATA SPData; // Used to feed SchedulerPrinter
MP_INPUT_DATA MPData; // Used to feed MemoryPrinter
INT32 Status;
INT32 Temp, Temp1;
// INT32 mode;
/*********************************************************************
Show the interface to the delay timer.
Eventually the timer will interrupt ( in base.c there's a handler for
this ), but here in sample.c we're merely showing the interface
to start the call.
*********************************************************************/
// Check the status of the timer - is it running or not
mmio.Mode = Z502Status;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Timer, &mmio);
Status = mmio.Field1;
if (Status == DEVICE_FREE)
printf("Got expected (DEVICE_FREE) result for Status of Timer\n");
else
printf("Got erroneous result for Status of Timer\n");
// Start the timer - here's the sequence to use
mmio.Mode = Z502Start;
mmio.Field1 = 777; // You pick the time units
mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502Timer, &mmio);
// Check the status of the timer - is it running or not
mmio.Mode = Z502Status;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Timer, &mmio);
Status = mmio.Field1;
if (Status == DEVICE_IN_USE)
printf("Got expected result (DEVICE_IN_USE) for Status of Timer\n");
else
printf("Got erroneous result for Status of Timer\n");
printf(
"\nThe next output from the Interrupt Handler should report that \n");
printf(" interrupt of device 4 has occurred with no error.\n");
// Go idle until the interrupt occurs
mmio.Mode = Z502Action;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502Idle, &mmio); // Let the interrupt for this timer occur
DoSleep(10); // Give it a little more time
// Now we're going to try an illegal time and ensure that the fault
// handler reports an illegal status. It's important to try to start the time
// and then do the printf here. That gives the interrupt handler a chance to
// run before we get the status here.
mmio.Mode = Z502Start;
mmio.Field1 = -77; // You pick the time units - but it's illegal
mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502Timer, &mmio);
printf(
"\nThe next output from the Interrupt Handler should report that \n");
printf(" the interrupt handler found device ID 4 with status %d.\n",
(int) ERR_BAD_PARAM);
DoSleep(10); // Give it a little more time
printf("\n");
// Check the status of the timer - is it running or not
mmio.Mode = Z502Status;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Timer, &mmio);
Status = mmio.Field1;
if (Status == DEVICE_FREE)
printf("Got expected result for Status of Timer\n");
else
printf("Got erroneous result for Status of Timer\n");
fflush(stdout);
/* The interrupt handler will have exercised the code doing
Z502InterruptDevice - getting information about the interrupt and
then clearing it. But they will have been tested only for
"correct" usage.
Let's try a few erroneous/illegal operations. */
// Get cause of interrupt - there should be no interrupt that
// is waiting so we should get an error. Check it.
mmio.Mode = Z502GetInterruptInfo;
MEM_READ(Z502InterruptDevice, &mmio);
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
if (mmio.Field4 == ERR_NO_DEVICE_FOUND)
printf("Got expected result for Status when no DeviceFound \n");
else
printf("Got erroneous result for Status when no DeviceFound\n");
// Set an illegal device as target of our query
mmio.Mode = Z502ClearInterruptStatus;
mmio.Field1 = LARGEST_STAT_VECTOR_INDEX + 1;
mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502InterruptDevice, &mmio);
if (mmio.Field4 == ERR_BAD_DEVICE_ID)
printf("Got expected result for Status of Illegal Device\n");
else
printf("Got erroneous result for Status of Illegal Device\n");
/*********************************************************************
Show the interface to the Z502_CLOCK.
This is easy - all we're going to do is read it twice and make sure
the time is incrementing.
*********************************************************************/
mmio.Mode = Z502ReturnValue;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Clock, &mmio);
Temp = mmio.Field1;
mmio.Mode = Z502ReturnValue;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Clock, &mmio);
Temp1 = mmio.Field1;
if (Temp1 > Temp)
printf("\nThe clock time incremented correctly - %d1, %d2\n", Temp,
Temp1);
else
printf("\nThe clock time did NOT increment correctly - %d1, %d2\n",
Temp, Temp1);
/*********************************************************************
Show the interface to the disk read and write.
Eventually the disk will interrupt ( in base.c there's a handler for
this ), but here in sample.c we're merely showing the interface
to start the call.
*********************************************************************/
#define SAMPLE_LEGAL_DISK_ID 1
#define SAMPLE_LEGAL_SECTOR_LOCATION 3
// Now see that the disk IS NOT running
mmio.Mode = Z502Status;
mmio.Field1 = SAMPLE_LEGAL_DISK_ID;
mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Disk, &mmio);
if (mmio.Field2 == DEVICE_FREE) // Disk hasn't been used - should be free
printf("Disk Test 1: Got expected result for Disk Status\n");
else
printf(
"Disk Test 1: Got erroneous result for Disk Status - Device not free.\n");
// Start the disk by writing a block of data
mmio.Mode = Z502DiskWrite;
mmio.Field1 = SAMPLE_LEGAL_DISK_ID;
mmio.Field2 = SAMPLE_LEGAL_SECTOR_LOCATION;
mmio.Field3 = (long) disk_buffer_write;
// Put data into the buffer being written
strncpy(disk_buffer_write, "123456789abcdef", 15);
// Do the hardware call to put data on disk
MEM_WRITE(Z502Disk, &mmio);
// Now see that the disk IS running
mmio.Mode = Z502Status;
mmio.Field1 = SAMPLE_LEGAL_DISK_ID;
mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Disk, &mmio);
if (mmio.Field2 == DEVICE_IN_USE) // Disk should report being used
printf("Disk Test 2: Got expected result for Disk Status\n");
else
printf("Disk Test 2: Got erroneous result for Disk Status\n");
/* Wait until the disk "finishes" the write. the write is an
"unpended-io", meaning the hardware call returns before the work is
completed. By doing the IDLE here, we wait for the disk
action to complete. */
// Go idle until the interrupt occurs
mmio.Mode = Z502Action;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502Idle, &mmio);
// The disk should now be done. Make sure it's idle
mmio.Mode = Z502Status;
mmio.Field1 = SAMPLE_LEGAL_DISK_ID;
mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Disk, &mmio);
if (mmio.Field2 == DEVICE_FREE) // Disk should be free
printf("Disk Test 3: Got expected result for Disk Status\n");
else
printf(
"Disk Test 3: Got erroneous result for Disk Status - Device not free.\n");
/* Now we read the data back from the disk. If we're lucky,
we'll read the same thing we wrote! */
// Start the disk by reading a block of data
mmio.Mode = Z502DiskRead;
mmio.Field1 = SAMPLE_LEGAL_DISK_ID; // Pick same disk location
mmio.Field2 = SAMPLE_LEGAL_SECTOR_LOCATION;
mmio.Field3 = (long) disk_buffer_read;
// Do the hardware call to read data from disk
MEM_WRITE(Z502Disk, &mmio);
// Wait for the disk action to complete.
// (Note - students should NEVER write OS code this way, but
// instead should use the Z502Idle hardware request
mmio.Field2 = DEVICE_IN_USE;
while (mmio.Field2 != DEVICE_FREE) {
mmio.Mode = Z502Status;
mmio.Field1 = SAMPLE_LEGAL_DISK_ID;
mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Disk, &mmio);
}
printf("\nThe disk data written is: %s\n", disk_buffer_write);
printf("The disk data read is: %s\n", disk_buffer_read);
/*********************************************************************
Let's try some intentional errors to see what happens
*********************************************************************/
#define SAMPLE_ILLEGAL_DISK_ID MAX_NUMBER_OF_DISKS + 2
#define SAMPLE_ILLEGAL_SECTOR_LOCATION NUM_LOGICAL_SECTORS + 1
// Try an illegal Disk ID
mmio.Mode = Z502DiskWrite;
mmio.Field1 = SAMPLE_ILLEGAL_DISK_ID;
mmio.Field2 = SAMPLE_LEGAL_SECTOR_LOCATION;
mmio.Field3 = (long) disk_buffer_write;
MEM_WRITE(Z502Disk, &mmio);
if (mmio.Field4 == ERR_BAD_PARAM)
printf(
"Disk Test 4: Got expected result for Disk when using illegal ID\n");
else
printf(
"Disk Test 4: Got erroneous result for Disk when using illegal ID\n");
mmio.Mode = Z502DiskWrite;
mmio.Field1 = SAMPLE_LEGAL_DISK_ID;
mmio.Field2 = SAMPLE_ILLEGAL_SECTOR_LOCATION;
mmio.Field3 = (long) disk_buffer_write;
MEM_WRITE(Z502Disk, &mmio);
if (mmio.Field4 == ERR_BAD_PARAM)
printf(
"Disk Test 5: Got expected result for Disk when using bad parameter\n");
else
printf(
"Disk Test 5: Got erroneous result for Disk when using bad parameter\n");
mmio.Mode = Z502Status;
mmio.Field1 = SAMPLE_ILLEGAL_DISK_ID;
mmio.Field2 = 0;
mmio.Field3 = 0;
MEM_WRITE(Z502Disk, &mmio);
if (mmio.Field4 == ERR_BAD_DEVICE_ID)
printf(
"Disk Test 6: Expected result for Disk Status when using bad ID\n");
else
printf(
"Disk Test 6: Erroneous result for Disk Status when using bad ID\n");
/*********************************************************************
Some of the tests put thousands of pages of data on the disk. Let's
see if we can do that here. The pages ARE being written to the disks,
but the interrupt handler doesn't show all of them happening because
it's not catching multiple interrupts.
NOTE: This test should have all the disks in action at the same time
*********************************************************************/
disk_id = 0;
sector = 1;
printf("\nThe following section tests multiple disks in operation\n");
printf("at the same time. It will take a few seconds\n");
for (j = 0; j < VIRTUAL_MEM_PAGES + 100 /* arbitrary # */; j++) {
if (disk_id > MAX_NUMBER_OF_DISKS - 1) {
disk_id = 0;
sector++;
}
disk_id++;
// First make sure the disk is free - it may be in use from
// a previous request.
mmio.Field2 = DEVICE_IN_USE;
Counter = 0;
while (mmio.Field2 == DEVICE_IN_USE) {
mmio.Mode = Z502Action;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502Idle, &mmio);
// Now go back and see if disk is done
mmio.Mode = Z502Status;
mmio.Field1 = disk_id;
mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Disk, &mmio);
if (Counter > 100) {
printf("PANIC 1: Error in multiple disk test in sample.c\n");
}
Counter++;
}
mmio.Mode = Z502DiskWrite;
mmio.Field1 = disk_id;
mmio.Field2 = sector;
mmio.Field3 = (long) disk_buffer_write;
MEM_WRITE(Z502Disk, &mmio);
if (mmio.Field4 != ERR_SUCCESS) {
printf("PANIC 2: Error in multiple disk test in sample.c\n");
}
} // End of for j
// Give things a chance to settle down - any last interrupts left?
mmio.Mode = Z502Action;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502Idle, &mmio);
mmio.Mode = Z502Action;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_WRITE(Z502Idle, &mmio);
printf("End of multi-disk test\n");
/*********************************************************************
Do a physical memory access to check out that it works.
This is a mechanism that allows the OS to access physical memory
directly without using a page table.
*********************************************************************/
printf("\nStarting test of physical memory write and read.\n");
for (i = 0; i < PGSIZE ; i++) {
physical_memory_write[i] = i;
}
Z502WritePhysicalMemory(17, (char *) physical_memory_write);
Z502ReadPhysicalMemory(17, (char *) physical_memory_read);
for (i = 0; i < PGSIZE ; i++) {
if (physical_memory_write[i] != physical_memory_read[i])
printf("Error in Physical Memory Access\n");
}
printf("Completed test of physical memory write and read.\n");
/*********************************************************************
Show the interface to read and write of real memory
It turns out, that though these are hardware calls, the Z502
assumes the calls are being made in user mode. Remember that this
code Sample is running in Kernel Mode so the results will look different
from a memory request that is initiated in User Mode in Test2a.
What you see here IS the way that the OS can manipulate page tables
and access memory.
*********************************************************************/
mmio.Mode = Z502GetPageTable;
mmio.Field1 = mmio.Field2 = mmio.Field3 = 0;
MEM_READ(Z502Context, &mmio);
PAGE_TBL_ADDR = (short *) mmio.Field1; // Gives us the page table
// Set to VALID the logical page 0 and have it point at physical
// frame 0.
i = PTBL_VALID_BIT;
PAGE_TBL_ADDR[0] = (UINT16) i;
i = 73; // Data to be written
MEM_WRITE(0, &i);
MEM_READ(0, &j); // Now read it back
// WE expect the data read back to be the same as what we wrote
if (i == j)
printf("Memory write and read completed successfully\n");
else
printf("Memory write and read were NOT successful.\n");
/*********************************************************************
This is the interface to the locking mechanism. These are hardware
interlocks. We need to test that they work here. This is the
interface we'll be using.
void Z502_READ_MODIFY( INT32 VirtualAddress, INT32 NewLockValue,
INT32 Suspend, INT32 *LockResult )
We've defined these above to help remember them.
#define DO_LOCK 1
#define DO_UNLOCK 0
#define SUSPEND_UNTIL_LOCKED TRUE
#define DO_NOT_SUSPEND FALSE
*********************************************************************/
printf("++++ Starting Hardware Interlock Testing ++++\n");
// TRY A SERIES OF CALLS AS DESCRIBED HERE
printf("These tests map into the matrix describing the Z502_READ_MODIFY\n");
printf(" described in Appendix A\n\n");
printf(
"1. Start State = Unlocked: Action (Thread 1) = Lock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"2. Start State = locked(1): Action (Thread 1) = unLock: End State = UnLocked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"3. Start State = Unlocked: Action (Thread 1) = unLock: End State = UnLocked\n");
printf(" An Error is Expected\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"4. Start State = unlocked: Action (Thread 1) = tryLock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, DO_NOT_SUSPEND, &LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"5. Start State = Locked(1): Action (Thread 1) = tryLock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, DO_NOT_SUSPEND, &LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"6. Start State = locked(1): Action (Thread 1) = unLock: End State = UnLocked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"7. Start State = Unlocked: Action (Thread 1) = Lock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
// A thread that locks an item it has already locked will succeed
printf(
"8. Start State = locked(1): Action (Thread 1) = Lock: End State = Locked\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
// Locking a thread that's already locked - but do it with a thread
// other than the one that did the locking.
printf(
"9. Start State = Locked(1): Action (Thread 2) = tryLock: End State = Locked\n");
printf(" An Error is Expected\n");
Status = CreateAThread((int *) DoOnelock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
// Unlock a thread that's already locked - but unlock it with a thread
// other than the one that did the locking.
printf(
"10. Start State = Locked(1): Action (Thread 2) = unLock: End State = Locked\n");
printf(" An Error is Expected\n");
Status = CreateAThread((int *) DoOneUnlock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
// The second thread will try to get the lock held by the first thread. This is OK
// but the second thread will suspend until the first thread releases the lock.
printf(
"11. Start State = Locked(1): Action (Thread 2) = Lock: End State = Locked\n");
Status = CreateAThread((int *) DoOneTrylock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
// The first thread does an unlock. This means the second thread is now able to get
// the lock so there is a "relock" when thread two succeeds.
printf(
"12. Start State = locked(1): Action (Thread 1) = unLock: End State = Locked(by 2)\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
DoSleep(100); /* Wait for locking action of 2nd thread to finish */
printf(
"13. Start State = Locked(2): Action (Thread 3) = unLock: End State = Locked(2)\n");
printf(" An Error is Expected\n");
Status = CreateAThread((int *) DoOneUnlock, &Temp);
DoSleep(100); /* Wait for that thread to finish */
printf(
"14. Start State = Locked(2): Action (Thread 1) = tryLock: End State = Locked(2)\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_LOCK, DO_NOT_SUSPEND, &LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf(
"15. Start State = locked(2): Action (Thread 1) = unLock: End State = Locked(2)\n");
printf(" An Error is Expected\n");
READ_MODIFY(MEMORY_INTERLOCK_BASE, DO_UNLOCK, SUSPEND_UNTIL_LOCKED,
&LockResult);
printf("%s\n", &(Success[SPART * LockResult]));
printf("++++ END of hardware interlock code ++++\n\n");
/*********************************************************************
Show the interface to the CONTEXT calls.
The best place to see this usage is in os_init in base.c
*********************************************************************/
/*********************************************************************
Show the interface to the scheduler printer.
The main job here is to fill in the structure that is passed
to the printer.
*********************************************************************/
memset(&SPData, 0, sizeof(SP_INPUT_DATA));
strcpy(SPData.TargetAction, "Create");
SPData.CurrentlyRunningPID = 2;
SPData.TargetPID = 3;
// The NumberOfRunningProcesses as used here is for a future implementation
// when we are running multiple processors. For right now, set this to 0
// so it won't be printed out.
SPData.NumberOfRunningProcesses = 0;
SPData.NumberOfReadyProcesses = 3; // Processes ready to run
for (i = 0; i <= SPData.NumberOfReadyProcesses; i++) {
SPData.ReadyProcessPIDs[i] = i;
}
SPData.NumberOfProcSuspendedProcesses = 4;
for (i = 0; i <= SPData.NumberOfProcSuspendedProcesses; i++) {
SPData.ProcSuspendedProcessPIDs[i] = i + 3;
}
SPData.NumberOfMessageSuspendedProcesses = 2;
for (i = 0; i <= SPData.NumberOfMessageSuspendedProcesses; i++) {
SPData.MessageSuspendedProcessPIDs[i] = i + 16;
}
SPData.NumberOfTimerSuspendedProcesses = 6;
for (i = 0; i <= SPData.NumberOfTimerSuspendedProcesses; i++) {
SPData.TimerSuspendedProcessPIDs[i] = i + 8;
}
SPData.NumberOfDiskSuspendedProcesses = 1;
for (i = 0; i <= SPData.NumberOfDiskSuspendedProcesses; i++) {
SPData.DiskSuspendedProcessPIDs[i] = i + 15;
}
SPData.NumberOfTerminatedProcesses = 0; // Not used at this time
CALL(SPPrintLine(&SPData));
/*********************************************************************
Show the interface to the memory_printer.
We're just inputting random values here to show the interface.
*********************************************************************/
memset(&MPData, 0, sizeof(MP_INPUT_DATA)); // Good practice - clean up
for (j = 0; j < PHYS_MEM_PGS ; j = j + 2) {
MPData.frames[j].InUse = TRUE;
MPData.frames[j].Pid = (j / 2) % 10;
MPData.frames[j].LogicalPage = j * 16 + 10;
MPData.frames[j].State = (j / 2) % 8;
}
MPPrintLine(&MPData);
/*********************************************************************
Show how the skewed random numbers work on this platform.
*********************************************************************/
for (j = 0; j < NUM_RAND_BUCKETS; j++)
random_buckets[j] = 0;
for (j = 0; j < 100000; j++) {
GetSkewedRandomNumber(&Value, NUM_RAND_BUCKETS);
random_buckets[Value]++;
}
printf("\nTesting that your platform produces correctly skewed random\n");
printf("numbers. Each row should have higher count than the previous.\n");
printf(" Range: Counts in this range.\n");
for (j = 0; j < NUM_RAND_BUCKETS; j = j + 8) {
k = 0;
for (i = j; i < j + 8; i++)
k += random_buckets[i];
printf("%3d - %3d: %d\n", j, j + 7, k);
}
/*********************************************************************
Show the interface to the Z502Halt.
Note that the program will end NOW, since we don't return
from the command.
*********************************************************************/
MEM_WRITE(Z502Halt, 0);
}
