Context Navigation

source: rtems/c/src/lib/libbsp/m68k/uC5282/README @ 4c5212e

4.104.115

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

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

Download in other formats: