Platform-specific devices.

platform/msb430/dev/infomem.h

@@ -0,0 +1,85 @@
+/*
+Copyright 2006, Freie Universitaet Berlin. All rights reserved.
+
+These sources were developed at the Freie Universität Berlin, Computer
+Systems and Telematics group.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+- Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+ 
+- Neither the name of Freie Universitaet Berlin (FUB) nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+This software is provided by FUB and the contributors on an "as is"
+basis, without any representations or warranties of any kind, express
+or implied including, but not limited to, representations or
+warranties of non-infringement, merchantability or fitness for a
+particular purpose. In no event shall FUB or contributors be liable
+for any direct, indirect, incidental, special, exemplary, or
+consequential damages (including, but not limited to, procurement of
+substitute goods or services; loss of use, data, or profits; or
+business interruption) however caused and on any theory of liability,
+whether in contract, strict liability, or tort (including negligence
+or otherwise) arising in any way out of the use of this software, even
+if advised of the possibility of such damage.
+
+This implementation was developed by the CST group at the FUB.
+
+For documentation and questions please use the web site
+http://scatterweb.mi.fu-berlin.de and the mailinglist
+scatterweb@lists.spline.inf.fu-berlin.de (subscription via the Website).
+Berlin, 2006
+*/
+
+/**
+ * @file		infomem.h
+ * @addtogroup	storage
+ * @brief		MSP430 Infomemory Storage
+ * 
+ * @author	Michael Baar	<baar@inf.fu-berlin.de>
+ */
+
+#ifndef INFOMEM_H_
+#define INFOMEM_H_
+
+/* These defines might depend on the specific CPU used and have to be defined in platform:
+#define INFOMEM_START		0x1000
+#define INFOMEM_BLOCK_SIZE	128
+*/
+#if !defined(INFOMEM_START) || !defined(INFOMEM_BLOCK_SIZE)
+	#error "Infomemory position (INFOMEM_START) and blocksize (INFOMEM_BLOCK_SIZE) need to be defined for current platform"
+#endif
+
+/**
+ * @brief	Read bytes from infomemory
+ * @param[out]		buffer		Pointer to buffer for read data
+ * @param[in]		offset		Offset in infomemory (0-254)
+ * @param[in]		size		Number of bytes to read
+ */
+void infomem_read(void* buffer, unsigned int offset, unsigned char size);
+
+/**
+ * @brief	Write bytes to infomemory
+ * @param[in]		offset		Offset in infomemory (0-254)
+ * @param[in]		count		Number of items following
+ *								each item is a pair pointer, length
+ *
+ * Example: Infomem_write( 0, 2, &a,3, &b,1 );
+ *
+ * \note: The MSP430 has two consecutive blocks of infomemory. Each is 128 Bytes large.
+ *        The offset is the relative address starting at the beginning of the first block.
+ *        You can write an arbitrary number of bytes at any offse, but this 
+ *        function cannot write across the two blocks of infomemory.
+ */
+bool infomem_write(unsigned int offset, unsigned char count, ...);
+
+#endif // INFOMEM_H