Context Navigation

source: rtems/c/src/lib/libbsp/m68k/uC5282/README @ 46fa1f64

4.104.114.84.95

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

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

Download in other formats: