Subversion Repositories openrisc_me

#

#  $Id: README,v 1.2 2001-09-27 12:00:07 chris Exp $

#

#

# This package requires a version of GCC that supports the `-mcpu32' option.

#

#

# Please send any comments, improvements, or bug reports to:

#       W. Eric Norum

#       Saskatchewan Accelerator Laboratory

#       107 North Road

#       University of Saskatchewan

#       Saskatoon, Saskatchewan, CANADA

#       S7N 5C6

# eric@skatter.usask.ca

#

#

# This board support package works with several different versions of

# MC68360 systems.  See the conditional-compile tests in startup/init68360.c

# for examples.

#

# Decisions made at compile time include:

#       - If the CPU is a member of the 68040 family, the BSP is

#         compiled for a generic 68040/68360 system as described

#         in Chapter 9 of the MC68360 User's Manual.  This version

#         can be used with the Arnewsh SBC360 card.

#       - If the preprocessor symbol M68360_ATLAS_HSB is defined,

#         the BSP is compiled for an Atlas HSB card.

#       - Otherwise, the BSP is compiled for a generic 68360 system

#         as described in Chapter 9 of the MC68360 User's Manual.  This

#         version works with the Atlas ACE360 card.

#

# Decisions to be made a link-edit time are:

#     - The size of the memory allocator heap.  The default value is

#       64 kbytes.  If the network package is used the heap

#       should be at least 256 kbytes.  If your network is large, or

#       busy, the heap should be even larger.

#       To choose a heap size of 256 kbytes,

#       CFLAGS_LD += -Wl,--defsym -Wl,HeapSize=0x40000

BSP NAME:           gen68360 or gen68360_040

BOARD:              Generic 68360 as described in Motorola MC68360 User's Manual

BOARD:              Atlas Computer Equipment Inc. High Speed Bridge (HSB)

BOARD:              Atlas Computer Equipment Inc. Advanced Communication Engine (ACE)

BOARD:              Arnewsh SBC360 68040/68360 card

BUS:                none

CPU FAMILY:         Motorola CPU32+, Motorola 68040

COPROCESSORS:       none

MODE:               not applicable

DEBUG MONITOR:      none (Hardware provides BDM)

PERIPHERALS

===========

TIMERS:             PIT, Watchdog, 4 general purpose, 16 RISC

  RESOLUTION:       one microsecond

SERIAL PORTS:       4 SCC, 2 SMC, 1 SPI

REAL-TIME CLOCK:

DMA:                Each serial port, 2 general purpose

VIDEO:              none

SCSI:               none

NETWORKING:         Ethernet on SCC1.

DRIVER INFORMATION

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

CLOCK DRIVER:       Programmable Interval Timer

IOSUPP DRIVER:      Serial Management Controller 1

SHMSUPP:            none

TIMER DRIVER:       Timer 1

STDIO

=====

PORT:               SMC1

ELECTRICAL:         EIA-232 (if board supplies level shifter)

BAUD:               9600

BITS PER CHARACTER: 8

PARITY:             None

STOP BITS:          1

NOTES

=====

Board description

-----------------

clock rate:     25 MHz

bus width:      8-bit PROM, 32-bit DRAM

ROM:            To 1 MByte, 180 nsec (3 wait states), chip select 0

RAM:            4 or 16 MBytes of 60 nsec parity DRAM (1Mx36) to RAS1*/CAS1*

Host System

-----------

OPENSTEP 4.2 (Intel and Motorola), Solaris 2.5, Linux 2.0.29

Verification (Standalone 68360)

-------------------------------

Single processor tests:  Passed

Multi-processort tests:  not applicable

Timing tests:

        Context Switch

        context switch: self 10

        context switch: to another task 11

        context switch: no floating point contexts 38

        fp context switch: restore 1st FP task 39

        fp context switch: save initialized, restore initialized 14

        fp context switch: save idle, restore initialized 15

        fp context switch: save idle, restore idle 41

        Task Manager

        rtems_task_create 202

        rtems_task_ident 390

        rtems_task_start 71

        rtems_task_restart: calling task 99

        rtems_task_restart: suspended task -- returns to caller 86

        rtems_task_restart: blocked task -- returns to caller 116

        rtems_task_restart: ready task -- returns to caller 88

        rtems_task_restart: suspended task -- preempts caller 132

        rtems_task_restart: blocked task -- preempts caller 153

        rtems_task_restart: ready task -- preempts caller 149

        rtems_task_delete: calling task 236

        rtems_task_delete: suspended task 191

        rtems_task_delete: blocked task 195

        rtems_task_delete: ready task 198

        rtems_task_suspend: calling task 78

        rtems_task_suspend: returns to caller 36

        rtems_task_resume: task readied -- returns to caller 39

        rtems_task_resume: task readied -- preempts caller 67

        rtems_task_set_priority: obtain current priority 26

        rtems_task_set_priority: returns to caller 59

        rtems_task_set_priority: preempts caller 110

        rtems_task_mode: obtain current mode 13

        rtems_task_mode: no reschedule 15

        rtems_task_mode: reschedule -- returns to caller 20

        rtems_task_mode: reschedule -- preempts caller 67

        rtems_task_get_note 28

        rtems_task_set_note 27

        rtems_task_wake_after: yield -- returns to caller 16

        rtems_task_wake_after: yields -- preempts caller 65

        rtems_task_wake_when 116

        Interrupt Manager

        interrupt entry overhead: returns to nested interrupt 10

        interrupt entry overhead: returns to interrupted task 10

        interrupt entry overhead: returns to preempting task 10

        interrupt exit overhead: returns to nested interrupt 8

        interrupt exit overhead: returns to interrupted task 10

        interrupt exit overhead: returns to preempting task 59

        Clock Manager

        rtems_clock_set 73

        rtems_clock_get 1

        rtems_clock_tick 16

        Timer Manager

        rtems_timer_create 31

        rtems_timer_ident 380

        rtems_timer_delete: inactive 43

        rtems_timer_delete: active 46

        rtems_timer_fire_after: inactive 53

        rtems_timer_fire_after: active 56

        rtems_timer_fire_when: inactive 72

        rtems_timer_fire_when: active 72

        rtems_timer_reset: inactive 47

        rtems_timer_reset: active 51

        rtems_timer_cancel: inactive 25

        rtems_timer_cancel: active 28

        Semaphore Manager

        rtems_semaphore_create 59

        rtems_semaphore_ident 438

        rtems_semaphore_delete 57

        rtems_semaphore_obtain: available 31

        rtems_semaphore_obtain: not available -- NO_WAIT 31

        rtems_semaphore_obtain: not available -- caller blocks 108

        rtems_semaphore_release: no waiting tasks 40

        rtems_semaphore_release: task readied -- returns to caller 56

        rtems_semaphore_release: task readied -- preempts caller 83

        Message Queue Manager

        rtems_message_queue_create 241

        rtems_message_queue_ident 379

        rtems_message_queue_delete 75

        rtems_message_queue_send: no waiting tasks 72

        rtems_message_queue_send: task readied -- returns to caller 72

        rtems_message_queue_send: task readied -- preempts caller 99

        rtems_message_queue_urgent: no waiting tasks 72

        rtems_message_queue_urgent: task readied -- returns to caller 72

        rtems_message_queue_urgent: task readied -- preempts caller 99

        rtems_message_queue_broadcast: no waiting tasks 43

        rtems_message_queue_broadcast: task readied -- returns to caller 82

        rtems_message_queue_broadcast: task readied -- preempts caller 109

        rtems_message_queue_receive: available 52

        rtems_message_queue_receive: not available -- NO_WAIT 34

        rtems_message_queue_receive: not available -- caller blocks 111

        rtems_message_queue_flush: no messages flushed 25

        rtems_message_queue_flush: messages flushed 34

        Event Manager

        rtems_event_send: no task readied 22

        rtems_event_send: task readied -- returns to caller 50

        rtems_event_send: task readied -- preempts caller 80

        rtems_event_receive: obtain current events -1

        rtems_event_receive: available 26

        rtems_event_receive: not available -- NO_WAIT 22

        rtems_event_receive: not available -- caller blocks 89

        Signal Manager

        rtems_signal_catch 16

        rtems_signal_send: returns to caller 32

        rtems_signal_send: signal to self 51

        exit ASR overhead: returns to calling task 42

        exit ASR overhead: returns to preempting task 58

        Partition Manager

        rtems_partition_create 74

        rtems_partition_ident 379

        rtems_partition_delete 40

        rtems_partition_get_buffer: available 29

        rtems_partition_get_buffer: not available 27

        rtems_partition_return_buffer 34

        Region Manager

        rtems_region_create 63

        rtems_region_ident 388

        rtems_region_delete 40

        rtems_region_get_segment: available 43

        rtems_region_get_segment: not available -- NO_WAIT 40

        rtems_region_get_segment: not available -- caller blocks 120

        rtems_region_return_segment: no waiting tasks 48

        rtems_region_return_segment: task readied -- returns to caller 98

        rtems_region_return_segment: task readied -- preempts caller 125

        Dual-Ported Memory Manager

        rtems_port_create 38

        rtems_port_ident 380

        rtems_port_delete 40

        rtems_port_internal_to_external 22

        rtems_port_external_to_internal 22

        IO Manager

        rtems_io_initialize 4

        rtems_io_open 1

        rtems_io_close 1

        rtems_io_read 1

        rtems_io_write 1

        rtems_io_control 1

        Rate Monotonic Manager

        rtems_rate_monotonic_create 36

        rtems_rate_monotonic_ident 380

        rtems_rate_monotonic_cancel 34

        rtems_rate_monotonic_delete: active 51

        rtems_rate_monotonic_delete: inactive 47

        rtems_rate_monotonic_period: obtain status 27

        rtems_rate_monotonic_period: initiate period -- returns to caller 50

        rtems_rate_monotonic_period: conclude periods -- caller blocks 72

Network tests:

       TCP throughput (as measured by ttcp):

               Receive: 1081 kbytes/sec

               Transmit: 953 kbytes/sec

Porting

-------

This board support package is written for a 68360 system similar to that

described in chapter 9 of the Motorola MC68360 Quad Integrated Communication

Processor Users' Manual.  The salient features of this hardware are:

        25 MHz external clock

        DRAM address multiplexing provided by 68360

        8-bit 180nsec PROM to CS0*

        4 MBytes of 60 nsec parity DRAM (1Mx36) to RAS1*/CAS1*

        Console serial port on SMC1

        Ethernet interface on SCC1

The board support package has been tested with:

        A home-built 68360 board

        An ACE360A and an HSB board produced by:

                Atlas Computer Equipment

                703 Colina Lane

                Santa Barbara, CA 93103

        A 68040/68360 board (SBC360) produced by:

                Arnewsh Inc.

                P.O. Box 270352

                Fort Collins, CO 80527-0352

Interrupt Notes

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

ckinit.c:

        Occasional network lockups have been noted when the PIT has a higher

interrupt request level than the CPM.  The SCC1 bit in the CISR is set

even though the SCC1 interrupt handler is not active.  This blocks

interrupts from SCC1 (and all other CPM sources) and locks up the

system.  It has not been determined whether the error is within the

68360 or in the RTEMS interrupt support assembler code.  The solution,

for now, is to set both PIT and CPM interrupt request levels to the same

value (4).