Nut/OS  4.10.3
API Reference
confos.c
Go to the documentation of this file.
00001 /*
00002  * Copyright (C) 2001-2006 by egnite Software GmbH. All rights reserved.
00003  *
00004  * Redistribution and use in source and binary forms, with or without
00005  * modification, are permitted provided that the following conditions
00006  * are met:
00007  *
00008  * 1. Redistributions of source code must retain the above copyright
00009  *    notice, this list of conditions and the following disclaimer.
00010  * 2. Redistributions in binary form must reproduce the above copyright
00011  *    notice, this list of conditions and the following disclaimer in the
00012  *    documentation and/or other materials provided with the distribution.
00013  * 3. Neither the name of the copyright holders nor the names of
00014  *    contributors may be used to endorse or promote products derived
00015  *    from this software without specific prior written permission.
00016  *
00017  * THIS SOFTWARE IS PROVIDED BY EGNITE SOFTWARE GMBH AND CONTRIBUTORS
00018  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
00019  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
00020  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL EGNITE
00021  * SOFTWARE GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
00022  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
00023  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
00024  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
00025  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00026  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
00027  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00028  * SUCH DAMAGE.
00029  *
00030  * For additional information see http://www.ethernut.de/
00031  *
00032  */
00033 
00034 /*
00035  * $Log$
00036  * Revision 1.10  2009/01/16 17:03:02  haraldkipp
00037  * Configurable host name length. The *nix conditional is
00038  * no longer required as this will be handled in the nvmem
00039  * routines. NutLoadConfig will now set the virgin host
00040  * name, if no valid configuration is available. Cookie
00041  * and virgin host name are configurable too, but disabled
00042  * in the Configurator until we fixed the string value
00043  * problem. You may use UserConf.mk instead.
00044  *
00045  * Revision 1.9  2006/05/25 09:18:28  haraldkipp
00046  * API documentation updated and corrected.
00047  *
00048  * Revision 1.8  2006/01/23 19:50:48  haraldkipp
00049  * Dummy NVMEM configuration for GBA added.
00050  *
00051  * Revision 1.7  2006/01/23 17:26:17  haraldkipp
00052  * Platform independant routines added, which provide generic access to
00053  * non-volatile memory.
00054  *
00055  * Revision 1.6  2005/07/26 15:49:59  haraldkipp
00056  * Cygwin support added.
00057  *
00058  * Revision 1.5  2004/09/08 10:24:34  haraldkipp
00059  * No EEPROM support for AT91
00060  *
00061  * Revision 1.4  2004/04/07 12:13:58  haraldkipp
00062  * Matthias Ringwald's *nix emulation added
00063  *
00064  * Revision 1.3  2004/03/16 16:48:45  haraldkipp
00065  * Added Jan Dubiec's H8/300 port.
00066  *
00067  * Revision 1.2  2004/03/03 17:42:19  drsung
00068  * Bugfix in NutSaveConfig. Write only to eeprom if actual byte in
00069  * eeprom differs from byte to write.
00070  *
00071  * Revision 1.1.1.1  2003/05/09 14:41:46  haraldkipp
00072  * Initial using 3.2.1
00073  *
00074  * Revision 1.1  2003/02/04 18:17:07  harald
00075  * Version 3 released
00076  *
00077  */
00078 
00079 #include <cfg/arch.h>
00080 #include <sys/nutdebug.h>
00081 #include <sys/confos.h>
00082 #include <dev/nvmem.h>
00083 
00084 #include <string.h>
00085 
00090 
00097 CONFOS confos;
00098 
00114 int NutLoadConfig(void)
00115 {
00116     /* Sanity check. */
00117     NUTASSERT(sizeof(CONFOS) <= 255);
00118 
00119     if (NutNvMemLoad(CONFOS_EE_OFFSET, &confos, sizeof(CONFOS)) == 0 /* If loaded... */
00120         && confos.size == sizeof(CONFOS) /* ...check magic size and cookie. */
00121         && memcmp(confos.magic, CONFOS_EE_MAGIC, sizeof(CONFOS_EE_MAGIC) - 1) == 0) {
00122             return 0;
00123     }
00124 
00125     /* No valid configuration, set virgin hostname. */
00126     NUTASSERT(sizeof(confos.hostname) > strlen(CONFOS_VIRGIN_HOSTNAME));
00127     strcpy(confos.hostname, CONFOS_VIRGIN_HOSTNAME);
00128 
00129     return -1;
00130 }
00131 
00142 int NutSaveConfig(void)
00143 {
00144     /* Sanity checks. */
00145     NUTASSERT(sizeof(CONFOS) <= 255);
00146     NUTASSERT(strlen(confos.hostname) <= MAX_HOSTNAME_LEN);
00147 
00148     /* Update the magic part. */
00149     confos.size = sizeof(CONFOS);
00150     memcpy(confos.magic, CONFOS_EE_MAGIC, sizeof(CONFOS_EE_MAGIC) - 1);
00151 
00152     return NutNvMemSave(CONFOS_EE_OFFSET, &confos, sizeof(CONFOS));
00153 }
00154