Blame view

kernel/linux-imx6_3.14.28/drivers/mtd/devices/ms02-nv.h 3.92 KB
6b13f685e   김민수   BSP 최초 추가
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
  /*
   *	Copyright (c) 2001, 2003  Maciej W. Rozycki
   *
   *	DEC MS02-NV (54-20948-01) battery backed-up NVRAM module for
   *	DECstation/DECsystem 5000/2x0 and DECsystem 5900 and 5900/260
   *	systems.
   *
   *	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; either version
   *	2 of the License, or (at your option) any later version.
   */
  
  #include <linux/ioport.h>
  #include <linux/mtd/mtd.h>
  
  /*
   * Addresses are decoded as follows:
   *
   * 0x000000 - 0x3fffff	SRAM
   * 0x400000 - 0x7fffff	CSR
   *
   * Within the SRAM area the following ranges are forced by the system
   * firmware:
   *
   * 0x000000 - 0x0003ff	diagnostic area, destroyed upon a reboot
   * 0x000400 - ENDofRAM	storage area, available to operating systems
   *
   * but we can't really use the available area right from 0x000400 as
   * the first word is used by the firmware as a status flag passed
   * from an operating system.  If anything but the valid data magic
   * ID value is found, the firmware considers the SRAM clean, i.e.
   * containing no valid data, and disables the battery resulting in
   * data being erased as soon as power is switched off.  So the choice
   * for the start address of the user-available is 0x001000 which is
   * nicely page aligned.  The area between 0x000404 and 0x000fff may
   * be used by the driver for own needs.
   *
   * The diagnostic area defines two status words to be read by an
   * operating system, a magic ID to distinguish a MS02-NV board from
   * anything else and a status information providing results of tests
   * as well as the size of SRAM available, which can be 1MiB or 2MiB
   * (that's what the firmware handles; no idea if 2MiB modules ever
   * existed).
   *
   * The firmware only handles the MS02-NV board if installed in the
   * last (15th) slot, so for any other location the status information
   * stored in the SRAM cannot be relied upon.  But from the hardware
   * point of view there is no problem using up to 14 such boards in a
   * system -- only the 1st slot needs to be filled with a DRAM module.
   * The MS02-NV board is ECC-protected, like other MS02 memory boards.
   *
   * The state of the battery as provided by the CSR is reflected on
   * the two onboard LEDs.  When facing the battery side of the board,
   * with the LEDs at the top left and the battery at the bottom right
   * (i.e. looking from the back side of the system box), their meaning
   * is as follows (the system has to be powered on):
   *
   * left LED		battery disable status: lit = enabled
   * right LED		battery condition status: lit = OK
   */
  
  /* MS02-NV iomem register offsets. */
  #define MS02NV_CSR		0x400000	/* control & status register */
  
  /* MS02-NV CSR status bits. */
  #define MS02NV_CSR_BATT_OK	0x01		/* battery OK */
  #define MS02NV_CSR_BATT_OFF	0x02		/* battery disabled */
  
  
  /* MS02-NV memory offsets. */
  #define MS02NV_DIAG		0x0003f8	/* diagnostic status */
  #define MS02NV_MAGIC		0x0003fc	/* MS02-NV magic ID */
  #define MS02NV_VALID		0x000400	/* valid data magic ID */
  #define MS02NV_RAM		0x001000	/* user-exposed RAM start */
  
  /* MS02-NV diagnostic status bits. */
  #define MS02NV_DIAG_TEST	0x01		/* SRAM test done (?) */
  #define MS02NV_DIAG_RO		0x02		/* SRAM r/o test done */
  #define MS02NV_DIAG_RW		0x04		/* SRAM r/w test done */
  #define MS02NV_DIAG_FAIL	0x08		/* SRAM test failed */
  #define MS02NV_DIAG_SIZE_MASK	0xf0		/* SRAM size mask */
  #define MS02NV_DIAG_SIZE_SHIFT	0x10		/* SRAM size shift (left) */
  
  /* MS02-NV general constants. */
  #define MS02NV_ID		0x03021966	/* MS02-NV magic ID value */
  #define MS02NV_VALID_ID		0xbd100248	/* valid data magic ID value */
  #define MS02NV_SLOT_SIZE	0x800000	/* size of the address space
  						   decoded by the module */
  
  
  typedef volatile u32 ms02nv_uint;
  
  struct ms02nv_private {
  	struct mtd_info *next;
  	struct {
  		struct resource *module;
  		struct resource *diag_ram;
  		struct resource *user_ram;
  		struct resource *csr;
  	} resource;
  	u_char *addr;
  	size_t size;
  	u_char *uaddr;
  };