bsps: Move documentation, etc. files to bsps

This patch is a part of the BSP source reorganization.

Update #3285.

3 files changed, 96 insertions, 0 deletions

diff --git a/bsps/lm32/lm32_evr/README b/bsps/lm32/lm32_evr/README
new file mode 100644
index 0000000000..13712c91e0
--- /dev/null
+++ b/bsps/lm32/lm32_evr/README
@@ -0,0 +1,49 @@
+#  The Lattice Mico32 port uses the system_config.h generated by the Mico
+#  System Builder to retrieve the properties of the peripherals.
+#
+#   Implemented (in shared/ subdirectory)
+#     Polled console driver (uart)
+#     Clock interrupt with 10 ms tick
+#     Networking using Lattice tri-speed ethernet MAC
+#
+#   Todo
+#     Support more peripherals:
+#       - uart driver using interrupts
+#
+#  jukka.pietarinen@mrf.fi, 3.12.2008
+#    
+
+BSP NAME:           lm32_evr
+BOARD:              cRIO-EVR, Micro-Research Finland Oy
+BUS:                wishbone
+CPU FAMILY:         lm32 (Lattice Mico32)
+CPU:                small
+COPROCESSORS:       none
+MODE:               32 bit mode
+
+DEBUG MONITOR:      none
+
+PERIPHERALS
+===========
+TIMERS:             clock
+  RESOLUTION:       10 ms
+SERIAL PORTS:       uart
+REAL-TIME CLOCK:    none
+DMA:                none
+VIDEO:              none
+SCSI:               none
+NETWORKING:         tsmac
+
+To on the simulator included in lm32-gdb use these commands:
+
+tar sim --hw-device lm32cpu \
+  --hw-device "lm32uart/reg 0x80006000 0x100" \
+  --hw-device "/lm32uart > int int0 /lm32cpu" \
+  --hw-device "lm32timer/reg 0x80002000 0x80" \
+  --hw-device "/lm32timer > int int1 /lm32cpu" \
+  --memory-region 0x08000000,0x4000000
+load
+
+The simulator is VERY VERY slow when RTEMS is idle.
+To speed this up, add SIMULATOR_FAST_IDLE=1 to the
+configure command.
diff --git a/bsps/lm32/milkymist/Documentation/uart.txt b/bsps/lm32/milkymist/Documentation/uart.txt
new file mode 100644
index 0000000000..b5b93043e9
--- /dev/null
+++ b/bsps/lm32/milkymist/Documentation/uart.txt
@@ -0,0 +1,31 @@
+Initialization : 
+
+	set the CSR_UART_DIVISOR to the correct VALUE,
+	depending on the internal frequency of the LatticeMico32 softcore.
+
+	for the ML401 board, this value is calculated using this formula : clk_frequency/230400/16
+	clk_frequency  = 100000000 Hz
+	=> we must set CSR_UART_DIVISOR to 27
+
+How to send a byte to uart : 
+
+void writechar(char c)
+{
+	        CSR_UART_RXTX = c;
+		while(!(irq_pending() & IRQ_UARTTX));
+		irq_ack(IRQ_UARTTX);
+}
+
+How to receive a byte from uart : 
+
+
+char readchar()
+{
+	char c;
+	while(!(irq_pending() & IRQ_UARTRX));
+	irq_ack(IRQ_UARTRX);
+	c = CSR_UART_RXTX;
+	return c;
+}
+
+
diff --git a/bsps/lm32/milkymist/README b/bsps/lm32/milkymist/README
new file mode 100644
index 0000000000..4c77d6256c
--- /dev/null
+++ b/bsps/lm32/milkymist/README
@@ -0,0 +1,16 @@
+Full RTEMS port to the Milkymist One. Supports Milkymist SoC 1.0.x.
+
+Includes drivers for:
+- Multi-standard video input (PAL/SECAM/NTSC)
+- Two DMX512 (RS485) ports
+- MIDI IN and MIDI OUT ports
+- VGA output
+- AC'97 audio
+- NOR flash
+- 10/100 Ethernet
+- Memory card (experimental and incomplete)
+- USB host connectors (input devices only, using the softusb-input firmware)
+- RC5 infrared receiver
+- RS232 debug port
+
+For more information: http://www.milkymist.org/