Context Navigation

source: rtems/c/src/lib/libbsp/m68k/uC5282/README @ 728e177

4.104.114.84.95

Last change on this file since 728e177 was d0f01d2, checked in by Eric Norum <WENorum@…>, on 06/30/05 at 11:53:12
Add description of external interrupt request assignments.
Property mode set to `100644`
File size: 17.8 KB

Line
1	#
2	# $Id$
3	#
4
5	Description: Arcturus Networks uC DIMM ColdFire 5282
6	============
7	CPU: MCF5282, 64MHz
8	RAM: 16M
9	SRAM: 64k (BSP places FEC buffer descriptors here)
10	ROM: 4M
11
12	This is a credit-card sized board in a DIMM format. It is part of a family
13	which includes Dragonball and Coldfire CPUs, with a standardized DIMM-based bus.
14
15	ACKNOWLEDGEMENTS:
16	=================
17	This BSP is based on the work of:
18	D. Peter Siddons
19	Till Straumann
20	Brett Swimley
21	Jay Monkman
22
23	TODO:
24	=====
25	Make a clean exit routine to return to Arcturus monitor
26
27	The bsp relies on the Arcturus monitor to set up DRAM and all chip selects.
28	This seems OK to me, but others may find it lame.....
29
30	I/O pin restrictions make simultaneous operation
31	of I2C, CAN and UART2 impossible.
32
33	BSP NAME: uC5282
34	BOARD: Arcturus Netrworks uCdimm 5282
35	BUS: Arcturus DIMM bus, A24/D16, plus peripherals.
36	CPU FAMILY: ColdFire 5282
37	CPU: MCF5282
38	COPROCESSORS: N/A
39
40	DEBUG MONITOR: Arcturus bootloader
41
42	PERIPHERALS
43	===========
44	TIMERS: Four PIT (RTEMS clock is PIT3), Four Timers
45	RESOLUTION: 1 microsecond
46	SERIAL PORTS: Internal UART 0, 1 and 2
47	REAL-TIME CLOCK: none
48	DMA: none
49	VIDEO: none
50	SCSI: none
51	NETWORKING: Internal 10/100Mbs FEC, 100 Mb/s, full/half-duplex
52
53	DRIVER INFORMATION
54	==================
55	CLOCK DRIVER: PIT3
56	IOSUPP DRIVER: none
57	SHMSUPP: none
58	TIMER DRIVER: TIMER3
59	TTY DRIVER: UART0, 1 and 2
60
61	STDIO
62	=====
63	PORT: UART0 Terminal
64	ELECTRICAL: RS-232
65	BAUD: 9600
66	BITS PER CHARACTER: 8
67	PARITY: None
68	STOP BITS: 1
69
70	Downloading the image to the board.
71	===================================
72	The bootable image is generated by the make-exe target in the bsp makefile. It
73	generates a simple stripped binary file which is downloaded over the ethernet
74	port into RAM then executed or programmed into flash memory.
75
76	1) Power up the uC5282 board. A dump of some memory maps is produced
77	followed by a prompt.
78
79	2) (first time only)
80	Set the uC5282 board Internet configuration:
81	setenv IPADDR0 www.xxx.yyy.zzz (Your board's address)
82	setenv NETMASK ppp.qqq.rrr.sss (Your local network address mask)
83	setenv HOSTNAME somename (Your board's name)
84
85	3) Type 'tftp<CR>'
86
87	4) Run 'tftp' on your host machine:
88	tftp> binary
89	tftp> connect www.xxx.yyy.zzz (Your ucDIMM's address)
90	tftp> put someFile.exe (someFile.boot for the EPICS build system)
91
92	5) When the file has downloaded press the <ESC> key to terminate
93	the uCDIMM tftp command.
94
95	6) Type 'goram<CR>' to start the downloaded program, or type 'program<CR>'
96	to burn the code onto the uCDIMM flash.
97
98	EPICS Bootstrap Information
99	===========================
100	The EPICS startup code uses the following environment variables. If an
101	optional environment variable is missing the value in parentheses will be used.
102	All Internet addresses must be given in 'dotted-decimal' format.
103	HWADDR0 - Ethernet hardware address.
104	IPADDR0 - Internet address (192.168.0.2).
105	NETMASK - Local network address mask (255.255.252.0).
106	HOSTNAME - Internet host name (iocNobody).
107	GATEWAY - Internet address of gateway machine (NULL).
108	SERVER - Internet address of NFS server (192.168.0.1).
109	NAMESERVER - Internet address of DNS server (SERVER).
110	DOMAIN - DNS domain name (precompiled value from CONFIG_SITE).
111	NTPSERVER - Internet address of NTP server (SERVER).
112	BOOTFILE - Path to executable (epics/iocNobody/bin/RTEMS-uC5282/myApp.boot).
113	CMDLINE - Path to startup script (epics/iocBoot/iocNobody/st.cmd).
114	NFSMOUNT - NFS information: www.xxx.yyy.zzz:/remote/path /localpath
115	A : can also be used to separate the remote and local paths.
116	If NFSMOUNT is not set, SERVER will be used as the NFS server,
117	and the remote and local paths will be taken from the first
118	component of CMDLINE. If CMDLINE does not begin with a /
119	then '/tftpboot' is prepended to the remote path. This allows
120	a remote TFTP and NFS server to be handled transaparently.
121
122
123	============================================================================
124
125	Memory map as set up by dBUG bootstrap and BSP initialization
126
127	+--------------------------------------------------+
128	0000 0000 \| 16 MByte SDRAM \| 00FF FFFF
129	0100 0000 \| --------------------------------------------- \|
130	\| Address space for future SDRAM expansion \|
131	. .
132	. .
133	. .
134	\| \| 0FFF FFFF
135	+--------------------------------------------------+
136	1000 0000 \| External 4 MByte flash memory \|
137	. .
138	. .
139	. .
140	\| \| 1FFF FFFF
141	+--------------------------------------------------+
142	2000 0000 \| 64 kByte on-chip SRAM (RAMBAR) \|
143	. .
144	. .
145	. .
146	\| \| 2FFF FFFF
147	+--------------------------------------------------+
148	3000 0000 \| CS1* (devLib 'VME' A24 space) \| 30FF FFFF
149	3100 0000 \| CS2* (devLib 'VME' A32 and A16 space) x\| 31FF FFFF
150	. .
151	. .
152	. .
153	\| \| 3FFF FFFF
154	+--------------------------------------------------+
155	4000 0000 \| Internal peripheral system (IPSBAR) \|
156	. .
157	4400 0000 \| Backdoor access to on-chip flash \|
158	. .
159	. .
160	. .
161	\| \| 4FFF FFFF
162	+--------------------------------------------------+
163	. .
164	. .
165	. .
166	+--------------------------------------------------+
167	f000 0000 \| 512 kByte on-chip flash (FLASHBAR) \|
168	. .
169	. .
170	. .
171	\| \| fFFF FFFF
172	+--------------------------------------------------+
173
174	x - Final 16-bit location of CS2* space is reserved for FPGA interrupt status.
175
176	============================================================================
177
178	Interrupt map
179
180	External interrupt lines (priority is fixed between 3 and 4):
181	IRQ7* - Ethernet Transceiver interrupts
182	IRQ1* - FPGA ('VME') interrupts.
183	+-----+-----------------------------------------------------------------------+
184	\| \| PRIORITY \|
185	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
186	\|LEVEL\| 7 \| 6 \| 5 \| 4 \| 3 \| 2 \| 1 \| 0 \|
187	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
188	\| 7 \| \| \| \| \| \| \| \| \|
189	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
190	\| 6 \| \| \| \| \| \| \| \| \|
191	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
192	\| 5 \| \| \| \| \| \| \| \| \|
193	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
194	\| 4 \| FEC RX \| FEC TX \| \| \| \| \| \| PIT \|
195	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
196	\| 3 \| UART 0 \| UART 1 \| UART 2 \| \| \| \| \| \|
197	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
198	\| 2 \| \| \| \| \| \| \| \| \|
199	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
200	\| 1 \| \| \| \| \| \| \| \| \|
201	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
202
203	============================================================================
204
205	TIMING TESTS 2005-01-28
206	========================
207
208	* TIME TEST 1 *
209	rtems_semaphore_create 19
210	rtems_semaphore_delete 21
211	rtems_semaphore_obtain: available 4
212	rtems_semaphore_obtain: not available -- NO_WAIT 5
213	rtems_semaphore_release: no waiting tasks 12
214	* END OF TEST 1 *
215
216	* TIME TEST 2 *
217	rtems_semaphore_obtain: not available -- caller blocks 34
218	* END OF TEST 2 *
219
220	* TIME TEST 3 *
221	rtems_semaphore_release: task readied -- preempts caller 27
222	* END OF TEST 3 *
223
224	* TIME TEST 4 *
225	rtems_task_restart: blocked task -- preempts caller 54
226	rtems_task_restart: ready task -- preempts caller 52
227	rtems_semaphore_release: task readied -- returns to caller 18
228	rtems_task_create 87
229	rtems_task_start 24
230	rtems_task_restart: suspended task -- returns to caller 27
231	rtems_task_delete: suspended task 66
232	rtems_task_restart: ready task -- returns to caller 28
233	rtems_task_restart: blocked task -- returns to caller 38
234	rtems_task_delete: blocked task 69
235	* END OF TEST 4 *
236
237	* TIME TEST 5 *
238	rtems_task_suspend: calling task 23
239	rtems_task_resume: task readied -- preempts caller 22
240	* END OF TEST 5 *
241
242	* TIME TEST 6 *
243	rtems_task_restart: calling task 30
244	rtems_task_suspend: returns to caller 9
245	rtems_task_resume: task readied -- returns to caller 12
246	rtems_task_delete: ready task 69
247	* END OF TEST 6 *
248
249	* TIME TEST 7 *
250	rtems_task_restart: suspended task -- preempts caller 44
251	* END OF TEST 7 *
252
253	* TIME TEST 8 *
254	rtems_task_set_priority: obtain current priority 6
255	rtems_task_set_priority: returns to caller 17
256	rtems_task_mode: obtain current mode 3
257	rtems_task_mode: no reschedule 3
258	rtems_task_mode: reschedule -- returns to caller 8
259	rtems_task_mode: reschedule -- preempts caller 22
260	rtems_task_set_note 6
261	rtems_task_get_note 6
262	rtems_clock_set 22
263	rtems_clock_get 1
264	* END OF TEST 8 *
265
266	* TIME TEST 9 *
267	rtems_message_queue_create 55
268	rtems_message_queue_send: no waiting tasks 20
269	rtems_message_queue_urgent: no waiting tasks 21
270	rtems_message_queue_receive: available 20
271	rtems_message_queue_flush: no messages flushed 8
272	rtems_message_queue_flush: messages flushed 12
273	rtems_message_queue_delete 29
274	* END OF TEST 9 *
275
276	* TIME TEST 10 *
277	rtems_message_queue_receive: not available -- NO_WAIT 10
278	rtems_message_queue_receive: not available -- caller blocks 38
279	* END OF TEST 10 *
280
281	* TIME TEST 11 *
282	rtems_message_queue_send: task readied -- preempts caller 37
283	* END OF TEST 11 *
284
285	* TIME TEST 12 *
286	rtems_message_queue_send: task readied -- returns to caller 23
287	* END OF TEST 12 *
288
289	* TIME TEST 13 *
290	rtems_message_queue_urgent: task readied -- preempts caller 35
291	* END OF TEST 13 *
292
293	* TIME TEST 14 *
294	rtems_message_queue_urgent: task readied -- returns to caller 24
295	* END OF TEST 14 *
296
297	* TIME TEST 15 *
298	rtems_event_receive: obtain current events 0
299	rtems_event_receive: not available -- NO_WAIT 5
300	rtems_event_receive: not available -- caller blocks 28
301	rtems_event_send: no task readied 5
302	rtems_event_receive: available 9
303	rtems_event_send: task readied -- returns to caller 16
304	* END OF TEST 15 *
305
306	* TIME TEST 16 *
307	rtems_event_send: task readied -- preempts caller 27
308	* END OF TEST 16 *
309
310	* TIME TEST 17 *
311	rtems_task_set_priority: preempts caller 39
312	* END OF TEST 17 *
313
314	* TIME TEST 18 *
315	rtems_task_delete: calling task 83
316	* END OF TEST 18 *
317
318	* TIME TEST 19 *
319	rtems_signal_catch 5
320	rtems_signal_send: returns to caller 12
321	rtems_signal_send: signal to self 20
322	exit ASR overhead: returns to calling task 15
323	exit ASR overhead: returns to preempting task 18
324	* END OF TEST 19 *
325
326	* TIME TEST 20 *
327	rtems_partition_create 20
328	rtems_region_create 40
329	rtems_partition_get_buffer: available 11
330	rtems_partition_get_buffer: not available 7
331	rtems_partition_return_buffer 12
332	rtems_partition_delete 11
333	rtems_region_get_segment: available 28
334	rtems_region_get_segment: not available -- NO_WAIT 29
335	rtems_region_return_segment: no waiting tasks 29
336	rtems_region_get_segment: not available -- caller blocks 55
337	rtems_region_return_segment: task readied -- preempts caller 72
338	rtems_region_return_segment: task readied -- returns to caller 58
339	rtems_region_delete 25
340	rtems_io_initialize 1
341	rtems_io_open 1
342	rtems_io_close 1
343	rtems_io_read 1
344	rtems_io_write 1
345	rtems_io_control 1
346	* END OF TEST 20 *
347
348	* TIME TEST 21 *
349	rtems_task_ident 60
350	rtems_message_queue_ident 60
351	rtems_semaphore_ident 69
352	rtems_partition_ident 59
353	rtems_region_ident 60
354	rtems_port_ident 59
355	rtems_timer_ident 61
356	rtems_rate_monotonic_ident 60
357	* END OF TEST 21 *
358
359	* TIME TEST 22 *
360	rtems_message_queue_broadcast: task readied -- returns to caller 32
361	rtems_message_queue_broadcast: no waiting tasks 14
362	rtems_message_queue_broadcast: task readied -- preempts caller 39
363	* END OF TEST 22 *
364
365	* TIME TEST 23 *
366	rtems_timer_create 8
367	rtems_timer_fire_after: inactive 12
368	rtems_timer_fire_after: active 12
369	rtems_timer_cancel: active 9
370	rtems_timer_cancel: inactive 8
371	rtems_timer_reset: inactive 14
372	rtems_timer_reset: active 15
373	rtems_timer_fire_when: inactive 21
374	rtems_timer_fire_when: active 21
375	rtems_timer_delete: active 12
376	rtems_timer_delete: inactive 11
377	rtems_task_wake_when 35
378	* END OF TEST 23 *
379
380	* TIME TEST 24 *
381	rtems_task_wake_after: yield -- returns to caller 3
382	rtems_task_wake_after: yields -- preempts caller 18
383	* END OF TEST 24 *
384
385	* TIME TEST 25 *
386	rtems_clock_tick 7
387	* END OF TEST 25 *
388
389	* TIME TEST 26 *
390	_ISR_Disable 1
391	_ISR_Flash 0
392	_ISR_Enable 0
393	_Thread_Disable_dispatch 1
394	_Thread_Enable_dispatch 3
395	_Thread_Set_state 7
396	_Thread_Disptach (NO FP) 16
397	context switch: no floating point contexts 12
398	context switch: self 2
399	context switch: to another task 1
400	fp context switch: restore 1st FP task 14
401	fp context switch: save idle, restore initialized 3
402	fp context switch: save idle, restore idle 13
403	fp context switch: save initialized, restore initialized 2
404	_Thread_Resume 7
405	_Thread_Unblock 6
406	_Thread_Ready 5
407	_Thread_Get 1
408	_Semaphore_Get 1
409	_Thread_Get: invalid id 0
410	* END OF TEST 26 *
411
412	* TIME TEST 27 *
413	interrupt entry overhead: returns to interrupted task 3
414	interrupt exit overhead: returns to interrupted task 3
415	interrupt entry overhead: returns to nested interrupt 2
416	interrupt exit overhead: returns to nested interrupt 2
417	interrupt entry overhead: returns to preempting task 4
418	interrupt exit overhead: returns to preempting task 20
419	* END OF TEST 27 *
420
421	* TIME TEST 28 *
422	rtems_port_create 12
423	rtems_port_external_to_internal 5
424	rtems_port_internal_to_external 6
425	rtems_port_delete 12
426	* END OF TEST 28 *
427
428	* TIME TEST 29 *
429	rtems_rate_monotonic_create 13
430	rtems_rate_monotonic_period: initiate period -- returns to caller 20
431	rtems_rate_monotonic_period: obtain status 10
432	rtems_rate_monotonic_cancel 13
433	rtems_rate_monotonic_delete: inactive 17
434	rtems_rate_monotonic_delete: active 16
435	rtems_rate_monotonic_period: conclude periods -- caller blocks 24
436	* END OF TEST 29 *
437
438	* TIME CHECKER *
439	Units may not be in microseconds for this test!!!
440	0 100000
441	Total time = 0
442	Average time = 0
443	NULL timer stopped at 0
444	LOOP (1000) timer stopped at 188
445	LOOP (10000) timer stopped at 1875
446	LOOP (50000) timer stopped at 9375
447	LOOP (100000) timer stopped at 18750
448	* END OF TIME CHECKER *
449
450	* TIME TEST OVERHEAD *
451	rtems_initialize_executive 0
452	rtems_shutdown_executive 0
453	rtems_task_create 0
454	rtems_task_ident 0
455	rtems_task_start 0
456	rtems_task_restart 0
457	rtems_task_delete 0
458	rtems_task_suspend 0
459	rtems_task_resume 0
460	rtems_task_set_priority 0
461	rtems_task_mode 0
462	rtems_task_get_note 0
463	rtems_task_set_note 0
464	rtems_task_wake_when 1
465	rtems_task_wake_after 0
466	rtems_interrupt_catch 0
467	rtems_clock_get 1
468	rtems_clock_set 1
469	rtems_clock_tick 0
470	rtems_timer_create 0
471	rtems_timer_delete 0
472	rtems_timer_ident 0
473	rtems_timer_fire_after 1
474	rtems_timer_fire_when 1
475	rtems_timer_reset 0
476	rtems_timer_cancel 0
477	rtems_semaphore_create 0
478	rtems_semaphore_delete 0
479	rtems_semaphore_ident 0
480	rtems_semaphore_obtain 0
481	rtems_semaphore_release 0
482	rtems_message_queue_create 0
483	rtems_message_queue_ident 0
484	rtems_message_queue_delete 0
485	rtems_message_queue_send 0
486	rtems_message_queue_urgent 0
487	rtems_message_queue_broadcast 0
488	rtems_message_queue_receive 0
489	rtems_message_queue_flush 0
490	rtems_event_send 0
491	rtems_event_receive 0
492	rtems_signal_catch 0
493	rtems_signal_send 0
494	rtems_partition_create 0
495	rtems_partition_ident 0
496	rtems_partition_delete 0
497	rtems_partition_get_buffer 0
498	rtems_partition_return_buffer 0
499	rtems_region_create 0
500	rtems_region_ident 0
501	rtems_region_delete 0
502	rtems_region_get_segment 0
503	rtems_region_return_segment 0
504	rtems_port_create 0
505	rtems_port_ident 0
506	rtems_port_delete 0
507	rtems_port_external_to_internal 0
508	rtems_port_internal_to_external 0
509	rtems_io_initialize 0
510	rtems_io_open 0
511	rtems_io_close 0
512	rtems_io_read 0
513	rtems_io_write 0
514	rtems_io_control 0
515	rtems_fatal_error_occurred 0
516	rtems_rate_monotonic_create 0
517	rtems_rate_monotonic_ident 0
518	rtems_rate_monotonic_delete 0
519	rtems_rate_monotonic_cancel 0
520	rtems_rate_monotonic_period 0
521	rtems_multiprocessing_announce 0
522	* END OF TIME OVERHEAD *

Note: See TracBrowser for help on using the repository browser.

Download in other formats: