Context Navigation

source: rtems/c/src/lib/libbsp/m68k/uC5282/README @ 81291a0

4.104.114.84.95

Last change on this file since 81291a0 was f077cc96, checked in by Eric Norum <WENorum@…>, on 06/20/05 at 20:48:48
Clean up transmit buffer realignment. Many thanks to Mr. Kolja Waschk for identifying the problem.
Property mode set to `100644`
File size: 17.6 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, locked at 100 Mbs, full-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	+-----+-----------------------------------------------------------------------+
181	\| \| PRIORITY \|
182	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
183	\|LEVEL\| 7 \| 6 \| 5 \| 4 \| 3 \| 2 \| 1 \| 0 \|
184	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
185	\| 7 \| \| \| \| \| \| \| \| \|
186	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
187	\| 6 \| \| \| \| \| \| \| \| \|
188	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
189	\| 5 \| \| \| \| \| \| \| \| \|
190	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
191	\| 4 \| FEC RX \| FEC TX \| \| \| \| \| \| PIT \|
192	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
193	\| 3 \| UART 0 \| UART 1 \| UART 2 \| \| \| \| \| \|
194	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
195	\| 2 \| \| \| \| \| \| \| \| \|
196	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
197	\| 1 \| \| \| \| \| \| \| \| \|
198	+-----+--------+--------+--------+--------+--------+--------+--------+--------+
199
200	============================================================================
201
202	TIMING TESTS 2005-01-28
203	========================
204
205	* TIME TEST 1 *
206	rtems_semaphore_create 19
207	rtems_semaphore_delete 21
208	rtems_semaphore_obtain: available 4
209	rtems_semaphore_obtain: not available -- NO_WAIT 5
210	rtems_semaphore_release: no waiting tasks 12
211	* END OF TEST 1 *
212
213	* TIME TEST 2 *
214	rtems_semaphore_obtain: not available -- caller blocks 34
215	* END OF TEST 2 *
216
217	* TIME TEST 3 *
218	rtems_semaphore_release: task readied -- preempts caller 27
219	* END OF TEST 3 *
220
221	* TIME TEST 4 *
222	rtems_task_restart: blocked task -- preempts caller 54
223	rtems_task_restart: ready task -- preempts caller 52
224	rtems_semaphore_release: task readied -- returns to caller 18
225	rtems_task_create 87
226	rtems_task_start 24
227	rtems_task_restart: suspended task -- returns to caller 27
228	rtems_task_delete: suspended task 66
229	rtems_task_restart: ready task -- returns to caller 28
230	rtems_task_restart: blocked task -- returns to caller 38
231	rtems_task_delete: blocked task 69
232	* END OF TEST 4 *
233
234	* TIME TEST 5 *
235	rtems_task_suspend: calling task 23
236	rtems_task_resume: task readied -- preempts caller 22
237	* END OF TEST 5 *
238
239	* TIME TEST 6 *
240	rtems_task_restart: calling task 30
241	rtems_task_suspend: returns to caller 9
242	rtems_task_resume: task readied -- returns to caller 12
243	rtems_task_delete: ready task 69
244	* END OF TEST 6 *
245
246	* TIME TEST 7 *
247	rtems_task_restart: suspended task -- preempts caller 44
248	* END OF TEST 7 *
249
250	* TIME TEST 8 *
251	rtems_task_set_priority: obtain current priority 6
252	rtems_task_set_priority: returns to caller 17
253	rtems_task_mode: obtain current mode 3
254	rtems_task_mode: no reschedule 3
255	rtems_task_mode: reschedule -- returns to caller 8
256	rtems_task_mode: reschedule -- preempts caller 22
257	rtems_task_set_note 6
258	rtems_task_get_note 6
259	rtems_clock_set 22
260	rtems_clock_get 1
261	* END OF TEST 8 *
262
263	* TIME TEST 9 *
264	rtems_message_queue_create 55
265	rtems_message_queue_send: no waiting tasks 20
266	rtems_message_queue_urgent: no waiting tasks 21
267	rtems_message_queue_receive: available 20
268	rtems_message_queue_flush: no messages flushed 8
269	rtems_message_queue_flush: messages flushed 12
270	rtems_message_queue_delete 29
271	* END OF TEST 9 *
272
273	* TIME TEST 10 *
274	rtems_message_queue_receive: not available -- NO_WAIT 10
275	rtems_message_queue_receive: not available -- caller blocks 38
276	* END OF TEST 10 *
277
278	* TIME TEST 11 *
279	rtems_message_queue_send: task readied -- preempts caller 37
280	* END OF TEST 11 *
281
282	* TIME TEST 12 *
283	rtems_message_queue_send: task readied -- returns to caller 23
284	* END OF TEST 12 *
285
286	* TIME TEST 13 *
287	rtems_message_queue_urgent: task readied -- preempts caller 35
288	* END OF TEST 13 *
289
290	* TIME TEST 14 *
291	rtems_message_queue_urgent: task readied -- returns to caller 24
292	* END OF TEST 14 *
293
294	* TIME TEST 15 *
295	rtems_event_receive: obtain current events 0
296	rtems_event_receive: not available -- NO_WAIT 5
297	rtems_event_receive: not available -- caller blocks 28
298	rtems_event_send: no task readied 5
299	rtems_event_receive: available 9
300	rtems_event_send: task readied -- returns to caller 16
301	* END OF TEST 15 *
302
303	* TIME TEST 16 *
304	rtems_event_send: task readied -- preempts caller 27
305	* END OF TEST 16 *
306
307	* TIME TEST 17 *
308	rtems_task_set_priority: preempts caller 39
309	* END OF TEST 17 *
310
311	* TIME TEST 18 *
312	rtems_task_delete: calling task 83
313	* END OF TEST 18 *
314
315	* TIME TEST 19 *
316	rtems_signal_catch 5
317	rtems_signal_send: returns to caller 12
318	rtems_signal_send: signal to self 20
319	exit ASR overhead: returns to calling task 15
320	exit ASR overhead: returns to preempting task 18
321	* END OF TEST 19 *
322
323	* TIME TEST 20 *
324	rtems_partition_create 20
325	rtems_region_create 40
326	rtems_partition_get_buffer: available 11
327	rtems_partition_get_buffer: not available 7
328	rtems_partition_return_buffer 12
329	rtems_partition_delete 11
330	rtems_region_get_segment: available 28
331	rtems_region_get_segment: not available -- NO_WAIT 29
332	rtems_region_return_segment: no waiting tasks 29
333	rtems_region_get_segment: not available -- caller blocks 55
334	rtems_region_return_segment: task readied -- preempts caller 72
335	rtems_region_return_segment: task readied -- returns to caller 58
336	rtems_region_delete 25
337	rtems_io_initialize 1
338	rtems_io_open 1
339	rtems_io_close 1
340	rtems_io_read 1
341	rtems_io_write 1
342	rtems_io_control 1
343	* END OF TEST 20 *
344
345	* TIME TEST 21 *
346	rtems_task_ident 60
347	rtems_message_queue_ident 60
348	rtems_semaphore_ident 69
349	rtems_partition_ident 59
350	rtems_region_ident 60
351	rtems_port_ident 59
352	rtems_timer_ident 61
353	rtems_rate_monotonic_ident 60
354	* END OF TEST 21 *
355
356	* TIME TEST 22 *
357	rtems_message_queue_broadcast: task readied -- returns to caller 32
358	rtems_message_queue_broadcast: no waiting tasks 14
359	rtems_message_queue_broadcast: task readied -- preempts caller 39
360	* END OF TEST 22 *
361
362	* TIME TEST 23 *
363	rtems_timer_create 8
364	rtems_timer_fire_after: inactive 12
365	rtems_timer_fire_after: active 12
366	rtems_timer_cancel: active 9
367	rtems_timer_cancel: inactive 8
368	rtems_timer_reset: inactive 14
369	rtems_timer_reset: active 15
370	rtems_timer_fire_when: inactive 21
371	rtems_timer_fire_when: active 21
372	rtems_timer_delete: active 12
373	rtems_timer_delete: inactive 11
374	rtems_task_wake_when 35
375	* END OF TEST 23 *
376
377	* TIME TEST 24 *
378	rtems_task_wake_after: yield -- returns to caller 3
379	rtems_task_wake_after: yields -- preempts caller 18
380	* END OF TEST 24 *
381
382	* TIME TEST 25 *
383	rtems_clock_tick 7
384	* END OF TEST 25 *
385
386	* TIME TEST 26 *
387	_ISR_Disable 1
388	_ISR_Flash 0
389	_ISR_Enable 0
390	_Thread_Disable_dispatch 1
391	_Thread_Enable_dispatch 3
392	_Thread_Set_state 7
393	_Thread_Disptach (NO FP) 16
394	context switch: no floating point contexts 12
395	context switch: self 2
396	context switch: to another task 1
397	fp context switch: restore 1st FP task 14
398	fp context switch: save idle, restore initialized 3
399	fp context switch: save idle, restore idle 13
400	fp context switch: save initialized, restore initialized 2
401	_Thread_Resume 7
402	_Thread_Unblock 6
403	_Thread_Ready 5
404	_Thread_Get 1
405	_Semaphore_Get 1
406	_Thread_Get: invalid id 0
407	* END OF TEST 26 *
408
409	* TIME TEST 27 *
410	interrupt entry overhead: returns to interrupted task 3
411	interrupt exit overhead: returns to interrupted task 3
412	interrupt entry overhead: returns to nested interrupt 2
413	interrupt exit overhead: returns to nested interrupt 2
414	interrupt entry overhead: returns to preempting task 4
415	interrupt exit overhead: returns to preempting task 20
416	* END OF TEST 27 *
417
418	* TIME TEST 28 *
419	rtems_port_create 12
420	rtems_port_external_to_internal 5
421	rtems_port_internal_to_external 6
422	rtems_port_delete 12
423	* END OF TEST 28 *
424
425	* TIME TEST 29 *
426	rtems_rate_monotonic_create 13
427	rtems_rate_monotonic_period: initiate period -- returns to caller 20
428	rtems_rate_monotonic_period: obtain status 10
429	rtems_rate_monotonic_cancel 13
430	rtems_rate_monotonic_delete: inactive 17
431	rtems_rate_monotonic_delete: active 16
432	rtems_rate_monotonic_period: conclude periods -- caller blocks 24
433	* END OF TEST 29 *
434
435	* TIME CHECKER *
436	Units may not be in microseconds for this test!!!
437	0 100000
438	Total time = 0
439	Average time = 0
440	NULL timer stopped at 0
441	LOOP (1000) timer stopped at 188
442	LOOP (10000) timer stopped at 1875
443	LOOP (50000) timer stopped at 9375
444	LOOP (100000) timer stopped at 18750
445	* END OF TIME CHECKER *
446
447	* TIME TEST OVERHEAD *
448	rtems_initialize_executive 0
449	rtems_shutdown_executive 0
450	rtems_task_create 0
451	rtems_task_ident 0
452	rtems_task_start 0
453	rtems_task_restart 0
454	rtems_task_delete 0
455	rtems_task_suspend 0
456	rtems_task_resume 0
457	rtems_task_set_priority 0
458	rtems_task_mode 0
459	rtems_task_get_note 0
460	rtems_task_set_note 0
461	rtems_task_wake_when 1
462	rtems_task_wake_after 0
463	rtems_interrupt_catch 0
464	rtems_clock_get 1
465	rtems_clock_set 1
466	rtems_clock_tick 0
467	rtems_timer_create 0
468	rtems_timer_delete 0
469	rtems_timer_ident 0
470	rtems_timer_fire_after 1
471	rtems_timer_fire_when 1
472	rtems_timer_reset 0
473	rtems_timer_cancel 0
474	rtems_semaphore_create 0
475	rtems_semaphore_delete 0
476	rtems_semaphore_ident 0
477	rtems_semaphore_obtain 0
478	rtems_semaphore_release 0
479	rtems_message_queue_create 0
480	rtems_message_queue_ident 0
481	rtems_message_queue_delete 0
482	rtems_message_queue_send 0
483	rtems_message_queue_urgent 0
484	rtems_message_queue_broadcast 0
485	rtems_message_queue_receive 0
486	rtems_message_queue_flush 0
487	rtems_event_send 0
488	rtems_event_receive 0
489	rtems_signal_catch 0
490	rtems_signal_send 0
491	rtems_partition_create 0
492	rtems_partition_ident 0
493	rtems_partition_delete 0
494	rtems_partition_get_buffer 0
495	rtems_partition_return_buffer 0
496	rtems_region_create 0
497	rtems_region_ident 0
498	rtems_region_delete 0
499	rtems_region_get_segment 0
500	rtems_region_return_segment 0
501	rtems_port_create 0
502	rtems_port_ident 0
503	rtems_port_delete 0
504	rtems_port_external_to_internal 0
505	rtems_port_internal_to_external 0
506	rtems_io_initialize 0
507	rtems_io_open 0
508	rtems_io_close 0
509	rtems_io_read 0
510	rtems_io_write 0
511	rtems_io_control 0
512	rtems_fatal_error_occurred 0
513	rtems_rate_monotonic_create 0
514	rtems_rate_monotonic_ident 0
515	rtems_rate_monotonic_delete 0
516	rtems_rate_monotonic_cancel 0
517	rtems_rate_monotonic_period 0
518	rtems_multiprocessing_announce 0
519	* END OF TIME OVERHEAD *

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

Download in other formats: