[LinuxBIOS] r338 - LinuxBIOSv3/lib

Author: uwe
Date: 2007-05-28 16:34:05 +0200 (Mon, 28 May 2007)
New Revision: 338

Added:
   LinuxBIOSv3/lib/ram.c
Log:
Initial version of a generic RAM initialization framework.

Signed-off-by: Ronald G. Minnich 
Signed-off-by: Uwe Hermann 
Acked-by: Peter Stuge 
Acked-by: Stefan Reinauer

Added: LinuxBIOSv3/lib/ram.c
===================================================================
--- LinuxBIOSv3/lib/ram.c	                        (rev 0)
+++ LinuxBIOSv3/lib/ram.c	2007-05-28 14:34:05 UTC (rev 338)
@@ -0,0 +1,74 @@
+/*
+ * This file is part of the LinuxBIOS project.
+ *
+ * Copyright (C) 2007 Ronald G. Minnich 
+ * Copyright (C) 2007 Uwe Hermann 
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; version 2 of the License.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
+ */
+
+#include <hlt.h>
+
+/**
+ * Print an error message which says why the RAM initialization failed,
+ * then halt the processor(s).
+ *
+ * @param why The reason why the RAM initialization failed.
+ */
+void ram_failure(const char *why)
+{
+	printk(BIOS_EMERG, "RAM failure: %s: Halting\n", why);
+	hlt();
+}
+
+/**
+ * ram_initialize() is is the main RAM init function.
+ *
+ * It sets basic registers that can not be detected, then does the SPD step.
+ * Mainboards and other code can skip one of these steps by the expedient
+ * of making it an empty function.
+ *
+ * @param controllers How many memory controllers there are.
+ * @param ctrl Pointer to the mem control structure.
+ * @param sysinfo Not used on all targets. NULL if not used. This function
+ * 	  does nothing with sysinfo but pass it on.
+ */
+void ram_initialize(int controllers, const struct mem_controller *ctrl,
+		    void *sysinfo)
+{
+	int i;
+
+	/* Set the registers we can set once to reasonable values. */
+	for (i = 0; i < controllers; i++) {
+		printk(BIOS_INFO,
+		       "Setting registers of RAM controller %d\n", i);
+		ram_set_registers(ctrl + i, sysinfo);
+	}
+
+	/* Now setup those things we can auto detect. */
+	for (i = 0; i < controllers; i++) {
+		printk(BIOS_INFO,
+		  "Setting SPD based registers of RAM controller %d\n", i);
+		ram_set_spd_registers(ctrl + i, sysinfo);
+	}
+
+	/* Now that everything is setup enable the RAM. Some chipsets do
+	 * the work for us while on others we need to it by hand.
+	 */
+	printk(BIOS_DEBUG, "Enabling RAM\n");
+	ram_enable(controllers, ctrl, sysinfo);
+
+	/* RAM initialization is done. */
+	printk(BIOS_DEBUG, "RAM enabled successfully\n");
+}