MAX may already be defined. Also, fix smaller cosmetics (trivial).
[coreboot.git] / util / flashrom / flash.h
index b4ad94b7eeca5106125c53dcdc8682f9d7bc5fe4..59c6c479be22f786d2bd25f5cbebfd93980cbd9f 100644 (file)
 #include <stdint.h>
 #include <stdio.h>
 
+#if (defined(__MACH__) && defined(__APPLE__))
+#define __DARWIN__
+#endif
+
+#if defined(__FreeBSD__)
+  #include <machine/cpufunc.h>
+  #define off64_t off_t
+  #define lseek64 lseek
+  #define OUTB(x, y) do { u_int tmp = (y); outb(tmp, (x)); } while (0)
+  #define OUTW(x, y) do { u_int tmp = (y); outw(tmp, (x)); } while (0)
+  #define OUTL(x, y) do { u_int tmp = (y); outl(tmp, (x)); } while (0)
+  #define INB(x) __extension__ ({ u_int tmp = (x); inb(tmp); })
+  #define INW(x) __extension__ ({ u_int tmp = (x); inw(tmp); })
+  #define INL(x) __extension__ ({ u_int tmp = (x); inl(tmp); })
+#else
+#if defined(__DARWIN__)
+    #include <DirectIO/darwinio.h>
+    #define off64_t off_t
+    #define lseek64 lseek
+#endif
+  #define OUTB outb
+  #define OUTW outw
+  #define OUTL outl
+  #define INB  inb
+  #define INW  inw
+  #define INL  inl
+#endif
+
+static inline void chip_writeb(uint8_t b, volatile void *addr)
+{
+       *(volatile uint8_t *) addr = b;
+}
+
+static inline void chip_writew(uint16_t b, volatile void *addr)
+{
+       *(volatile uint16_t *) addr = b;
+}
+
+static inline void chip_writel(uint32_t b, volatile void *addr)
+{
+       *(volatile uint32_t *) addr = b;
+}
+
+static inline uint8_t chip_readb(const volatile void *addr)
+{
+       return *(volatile uint8_t *) addr;
+}
+
+static inline uint16_t chip_readw(const volatile void *addr)
+{
+       return *(volatile uint16_t *) addr;
+}
+
+static inline uint32_t chip_readl(const volatile void *addr)
+{
+       return *(volatile uint32_t *) addr;
+}
+
 #define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
 
 struct flashchip {
        const char *vendor;
        const char *name;
-       /* With 32bit manufacture_id and model_id we can cover IDs up to
+       /*
+        * With 32bit manufacture_id and model_id we can cover IDs up to
         * (including) the 4th bank of JEDEC JEP106W Standard Manufacturer's
         * Identification code.
         */
@@ -45,7 +104,8 @@ struct flashchip {
        int total_size;
        int page_size;
 
-       /* Indicate if flashrom has been tested with this flash chip and if
+       /*
+        * Indicate if flashrom has been tested with this flash chip and if
         * everything worked correctly.
         */
        uint32_t tested;
@@ -66,13 +126,15 @@ struct flashchip {
 #define TEST_OK_READ   (1<<1)
 #define TEST_OK_ERASE  (1<<2)
 #define TEST_OK_WRITE  (1<<3)
-#define TEST_OK_PREW   (TEST_OK_PROBE|TEST_OK_READ|TEST_OK_ERASE|TEST_OK_WRITE)        
+#define TEST_OK_PR     (TEST_OK_PROBE|TEST_OK_READ)
+#define TEST_OK_PREW   (TEST_OK_PROBE|TEST_OK_READ|TEST_OK_ERASE|TEST_OK_WRITE)
 #define TEST_OK_MASK   0x0f
 
 #define TEST_BAD_PROBE (1<<4)
 #define TEST_BAD_READ  (1<<5)
 #define TEST_BAD_ERASE (1<<6)
 #define TEST_BAD_WRITE (1<<7)
+#define TEST_BAD_PREW  (TEST_BAD_PROBE|TEST_BAD_READ|TEST_BAD_ERASE|TEST_BAD_WRITE)
 #define TEST_BAD_MASK  0xf0
 
 extern struct flashchip flashchips[];
@@ -84,7 +146,7 @@ extern struct flashchip flashchips[];
  *
  * All LPC/FWH parts (parallel flash) have 8-bit device IDs if there is no
  * continuation code.
- * All SPI parts have 16-bit device IDs.
+ * SPI parts have 16-bit device IDs if they support RDID.
  */
 
 #define GENERIC_DEVICE_ID      0xffff  /* Only match the vendor ID */
@@ -92,25 +154,76 @@ extern struct flashchip flashchips[];
 #define ALLIANCE_ID            0x52    /* Alliance Semiconductor */
 
 #define AMD_ID                 0x01    /* AMD */
+#define AM_29F002BT            0xB0
+#define AM_29F002BB            0x34
 #define AM_29F040B             0xA4
 #define AM_29LV040B            0x4F
 #define AM_29F016D             0xAD
 
 #define AMIC_ID                        0x7F37  /* AMIC */
 #define AMIC_ID_NOPREFIX       0x37    /* AMIC */
+#define AMIC_A25L40P           0x2013
+#define AMIC_A29002B           0x0d
+#define AMIC_A29002T           0x8c
+#define AMIC_A29040B           0x86
+#define AMIC_A49LF040A         0x9d
 
 #define ASD_ID                 0x25    /* ASD, not listed in JEP106W */
 #define ASD_AE49F2008          0x52
 
 #define ATMEL_ID               0x1F    /* Atmel */
+#define AT_25DF021             0x4300
+#define AT_25DF041A            0x4401
+#define AT_25DF081             0x4502
+#define AT_25DF161             0x4602
+#define AT_25DF321             0x4700  /* also 26DF321 */
+#define AT_25DF321A            0x4701
+#define AT_25DF641             0x4800
+#define AT_25F512A             0x65 /* Needs special RDID. AT25F512A_RDID 15 1d */
+#define AT_25F512B             0x6500
+#define AT_25FS010             0x6601
+#define AT_25FS040             0x6604
+#define AT_26DF041             0x4400
+#define AT_26DF081             0x4500  /* guessed, no datasheet available */
+#define AT_26DF081A            0x4501
+#define AT_26DF161             0x4600
+#define AT_26DF161A            0x4601
+#define AT_26DF321             0x4700  /* also 25DF321 */
+#define AT_26F004              0x0400
 #define AT_29C040A             0xA4
 #define AT_29C020              0xDA
+#define AT_45BR3214B           /* No ID available */
+#define AT_45CS1282            0x2920
+#define AT_45D011              /* No ID available */
+#define AT_45D021A             /* No ID available */
+#define AT_45D041A             /* No ID available */
+#define AT_45D081A             /* No ID available */
+#define AT_45D161              /* No ID available */
+#define AT_45DB011             /* No ID available */
+#define AT_45DB011B            /* No ID available */
+#define AT_45DB011D            0x2200
+#define AT_45DB021A            /* No ID available */
+#define AT_45DB021B            /* No ID available */
+#define AT_45DB021D            0x2300
+#define AT_45DB041A            /* No ID available */
+#define AT_45DB041D            0x2400
+#define AT_45DB081A            /* No ID available */
+#define AT_45DB081D            0x2500
+#define AT_45DB161             /* No ID available */
+#define AT_45DB161B            /* No ID available */
+#define AT_45DB161D            0x2600
+#define AT_45DB321             /* No ID available */
+#define AT_45DB321B            /* No ID available */
+#define AT_45DB321C            0x2700
+#define AT_45DB321D            0x2701 /* Buggy data sheet */
+#define AT_45DB642             /* No ID available */
+#define AT_45DB642D            0x2800
 #define AT_49F002N             0x07    /* for AT49F002(N)  */
 #define AT_49F002NT            0x08    /* for AT49F002(N)T */
 
 #define CATALYST_ID            0x31    /* Catalyst */
 
-#define EMST_ID                        0x8C    /* EMST / EFST Elite Flash Storage*/
+#define EMST_ID                        0x8C    /* EMST / EFST Elite Flash Storage */
 #define EMST_F49B002UA         0x00
 
 /*
@@ -140,12 +253,10 @@ extern struct flashchip flashchips[];
 #define EN_29F002B             0x7F97
 
 #define FUJITSU_ID             0x04    /* Fujitsu */
-/* MBM29F400TC_STRANGE has a value not mentioned in the data sheet and we
- * try to read it from a location not mentioned in the data sheet.
- */
-#define MBM29F400TC_STRANGE    0x23
-#define MBM29F400BC            0x7B
-#define MBM29F400TC            0x77
+#define MBM29F400BC            0xAB
+#define MBM29F400TC            0x23
+#define MBM29F004BC            0x7B
+#define MBM29F004TC            0x77
 
 #define HYUNDAI_ID             0xAD    /* Hyundai */
 
@@ -157,14 +268,11 @@ extern struct flashchip flashchips[];
 
 #define ISSI_ID                        0xD5    /* ISSI Integrated Silicon Solutions */
 
-#define MSYSTEMS_ID            0x156F  /* M-Systems, not listed in JEP106W */
-#define MSYSTEMS_MD2200                0xDB
-#define MSYSTEMS_MD2800                0x30    /* hmm -- both 0x30 */
-#define MSYSTEMS_MD2802                0x30    /* hmm -- both 0x30 */
-
 /*
  * MX25 chips are SPI, first byte of device ID is memory type,
  * second byte of device ID is log(bitsize)-9.
+ * Generalplus SPI chips seem to be compatible with Macronix
+ * and use the same set of IDs.
  */
 #define MX_ID                  0xC2    /* Macronix (MX) */
 #define MX_25L512              0x2010  /* 2^19 kbit or 2^16 kByte */
@@ -175,12 +283,43 @@ extern struct flashchip flashchips[];
 #define MX_25L1605             0x2015  /* MX25L1605{,A,D} */
 #define MX_25L3205             0x2016  /* MX25L3205{,A} */
 #define MX_25L6405             0x2017  /* MX25L3205{,D} */
+#define MX_25L12805            0x2018  /* MX25L12805 */
 #define MX_25L1635D            0x2415
-#define MX_25L3235D            0x2416
-#define MX_29F002              0xB0
+#define MX_25L3235D            0x5E16  /* MX25L3225D/MX25L3235D/MX25L3237D */
+#define MX_29F002B             0x34
+#define MX_29F002T             0xB0
+#define MX_29LV002CB           0x5A
+#define MX_29LV002CT           0x59
+#define MX_29LV004CB           0xB6
+#define MX_29LV004CT           0xB5
+#define MX_29LV008CB           0x37
+#define MX_29LV008CT           0x3E
+#define MX_29F040C             0xA4
+#define MX_29F200CB            0x57
+#define MX_29F200CT            0x51
+#define MX_29F400CB            0xAB
+#define MX_29F400CT            0x23
+#define MX_29LV040C            0x4F
+#define MX_29LV128DB           0x7A
+#define MX_29LV128DT           0x7E
+#define MX_29LV160DB           0x49    /* Same as MX29LV161DB/MX29LV160CB */
+#define MX_29LV160DT           0xC4    /* Same as MX29LV161DT/MX29LV160CT */
+#define MX_29LV320DB           0xA8    /* Same as MX29LV321DB */
+#define MX_29LV320DT           0xA7    /* Same as MX29LV321DT */
+#define MX_29LV400CB           0xBA
+#define MX_29LV400CT           0xB9
+#define MX_29LV800CB           0x5B
+#define MX_29LV800CT           0xDA
+#define MX_29LV640DB           0xCB    /* Same as MX29LV640EB */
+#define MX_29LV640DT           0xC9    /* Same as MX29LV640ET */
+#define MX_29SL402CB           0xF1
+#define MX_29SL402CT           0x70
+#define MX_29SL800CB           0x6B    /* Same as MX29SL802CB */
+#define MX_29SL800CT           0xEA    /* Same as MX29SL802CT */
 
-/* Programmable Micro Corp is listed in JEP106W in bank 2, so it should have
- * a 0x7F continuation code prefix.
+/*
+ * Programmable Micro Corp is listed in JEP106W in bank 2, so it should
+ * have a 0x7F continuation code prefix.
  */
 #define PMC_ID                 0x7F9D  /* PMC */
 #define PMC_ID_NOPREFIX                0x9D    /* PMC, missing 0x7F prefix */
@@ -219,12 +358,35 @@ extern struct flashchip flashchips[];
 #define SST_25WF010            0x2502
 #define SST_25WF020            0x2503
 #define SST_25WF040            0x2504
-#define SST_25VF016B           0x2541
-#define SST_25VF032B           0x254A
+#define SST_25VF512A_REMS      0x48    /* REMS or RES opcode */
+#define SST_25VF010_REMS       0x49    /* REMS or RES opcode */
+#define SST_25VF020_REMS       0x43    /* REMS or RES opcode */
+#define SST_25VF040_REMS       0x44    /* REMS or RES opcode */
 #define SST_25VF040B           0x258D
+#define SST_25VF040B_REMS      0x8D    /* REMS or RES opcode */
+#define SST_25VF080_REMS       0x80    /* REMS or RES opcode */
 #define SST_25VF080B           0x258E
-#define SST_29EE020A           0x10
+#define SST_25VF080B_REMS      0x8E    /* REMS or RES opcode */
+#define SST_25VF016B           0x2541
+#define SST_25VF032B           0x254A
+#define SST_25VF032B_REMS      0x4A    /* REMS or RES opcode */
+#define SST_26VF016            0x2601
+#define SST_26VF032            0x2602
+#define SST_27SF512            0xA4
+#define SST_27SF010            0xA5
+#define SST_27SF020            0xA6
+#define SST_27VF010            0xA9
+#define SST_27VF020            0xAA
 #define SST_28SF040            0x04
+#define SST_29EE512            0x5D
+#define SST_29EE010            0x07
+#define SST_29LE010            0x08    /* also SST29VE010 */
+#define SST_29EE020A           0x10
+#define SST_29LE020            0x12    /* also SST29VE020 */
+#define SST_29SF020            0x24
+#define SST_29VF020            0x25
+#define SST_29SF040            0x13
+#define SST_29VF040            0x14
 #define SST_39SF010            0xB5
 #define SST_39SF020            0xB6
 #define SST_39SF040            0xB7
@@ -234,6 +396,7 @@ extern struct flashchip flashchips[];
 #define SST_39VF040            0xD7
 #define SST_49LF040B           0x50
 #define SST_49LF040            0x51
+#define SST_49LF020            0x61
 #define SST_49LF020A           0x52
 #define SST_49LF080A           0x5B
 #define SST_49LF002A           0x57
@@ -254,6 +417,7 @@ extern struct flashchip flashchips[];
 #define ST_M25P10A             0x2011
 #define ST_M25P20              0x2012
 #define ST_M25P40              0x2013
+#define ST_M25P40_RES          0x12
 #define ST_M25P80              0x2014
 #define ST_M25P16              0x2015
 #define ST_M25P32              0x2016
@@ -263,6 +427,7 @@ extern struct flashchip flashchips[];
 #define ST_M50FLW040B          0x28
 #define ST_M50FLW080A          0x80
 #define ST_M50FLW080B          0x81
+#define ST_M50FW002            0x29
 #define ST_M50FW040            0x2C
 #define ST_M50FW080            0x2D
 #define ST_M50FW016            0x2E
@@ -292,6 +457,9 @@ extern struct flashchip flashchips[];
 #define W_25X20                        0x3012
 #define W_25X40                        0x3013
 #define W_25X80                        0x3014
+#define W_25X16                        0x3015
+#define W_25X32                        0x3016
+#define W_25X64                        0x3017
 #define W_29C011               0xC1
 #define W_29C020C              0x45
 #define W_29C040P              0x46
@@ -316,8 +484,12 @@ struct pci_dev *pci_dev_find(uint16_t vendor, uint16_t device);
 struct pci_dev *pci_card_find(uint16_t vendor, uint16_t device,
                              uint16_t card_vendor, uint16_t card_device);
 
-
 /* board_enable.c */
+void w836xx_ext_enter(uint16_t port);
+void w836xx_ext_leave(uint16_t port);
+unsigned char wbsio_read(uint16_t index, uint8_t reg);
+void wbsio_write(uint16_t index, uint8_t reg, uint8_t data);
+void wbsio_mask(uint16_t index, uint8_t reg, uint8_t data, uint8_t mask);
 int board_flash_enable(const char *vendor, const char *part);
 void print_supported_boards(void);
 
@@ -325,46 +497,62 @@ void print_supported_boards(void);
 int chipset_flash_enable(void);
 void print_supported_chipsets(void);
 
-/* Physical memory mapping device */
-#if defined (__sun) && (defined(__i386) || defined(__amd64))
-#  define MEM_DEV "/dev/xsvc"
-#else
-#  define MEM_DEV "/dev/mem"
-#endif
+extern unsigned long flashbase;
 
-extern int fd_mem;
+typedef enum {
+       BUS_TYPE_LPC,
+       BUS_TYPE_ICH7_SPI,
+       BUS_TYPE_ICH9_SPI,
+       BUS_TYPE_IT87XX_SPI,
+       BUS_TYPE_SB600_SPI,
+       BUS_TYPE_VIA_SPI,
+       BUS_TYPE_WBSIO_SPI
+} flashbus_t;
 
-/* debug.c */
-extern int verbose;
-#define printf_debug(x...) { if (verbose) printf(x); }
+extern flashbus_t flashbus;
+extern void *spibar;
+
+/* physmap.c */
+void *physmap(const char *descr, unsigned long phys_addr, size_t len);
+void physunmap(void *virt_addr, size_t len);
 
 /* flashrom.c */
-int map_flash_registers(struct flashchip *flash);
+extern int verbose;
+#define printf_debug(x...) { if (verbose) printf(x); }
+void map_flash_registers(struct flashchip *flash);
 
 /* layout.c */
-int show_id(uint8_t *bios, int size);
+int show_id(uint8_t *bios, int size, int force);
 int read_romlayout(char *name);
 int find_romentry(char *name);
 int handle_romentries(uint8_t *buffer, uint8_t *content);
 
-/* lbtable.c */
+/* cbtable.c */
 int coreboot_init(void);
 extern char *lb_part, *lb_vendor;
 
 /* spi.c */
-int probe_spi(struct flashchip *flash);
-int it87xx_probe_spi_flash(const char *name);
-int spi_command(unsigned int writecnt, unsigned int readcnt, const unsigned char *writearr, unsigned char *readarr);
-void spi_write_enable();
-void spi_write_disable();
+int probe_spi_rdid(struct flashchip *flash);
+int probe_spi_rdid4(struct flashchip *flash);
+int probe_spi_rems(struct flashchip *flash);
+int probe_spi_res(struct flashchip *flash);
+int spi_command(unsigned int writecnt, unsigned int readcnt,
+               const unsigned char *writearr, unsigned char *readarr);
+int spi_write_enable();
+int spi_write_disable();
+int spi_chip_erase_60(struct flashchip *flash);
 int spi_chip_erase_c7(struct flashchip *flash);
+int spi_chip_erase_60_c7(struct flashchip *flash);
+int spi_chip_erase_d8(struct flashchip *flash);
+int spi_block_erase_52(const struct flashchip *flash, unsigned long addr);
+int spi_block_erase_d8(const struct flashchip *flash, unsigned long addr);
 int spi_chip_write(struct flashchip *flash, uint8_t *buf);
 int spi_chip_read(struct flashchip *flash, uint8_t *buf);
 uint8_t spi_read_status_register();
-void spi_disable_blockprotect(void);
+int spi_disable_blockprotect(void);
 void spi_byte_program(int address, uint8_t byte);
-void spi_page_program(int block, uint8_t *buf, uint8_t *bios);
-void spi_nbyte_read(int address, uint8_t *bytes, int len);
+int spi_nbyte_read(int address, uint8_t *bytes, int len);
+int spi_aai_write(struct flashchip *flash, uint8_t *buf);
 
 /* 82802ab.c */
 int probe_82802ab(struct flashchip *flash);
@@ -376,14 +564,36 @@ int probe_29f040b(struct flashchip *flash);
 int erase_29f040b(struct flashchip *flash);
 int write_29f040b(struct flashchip *flash, uint8_t *buf);
 
+/* en29f002a.c */
+int probe_en29f002a(struct flashchip *flash);
+int erase_en29f002a(struct flashchip *flash);
+int write_en29f002a(struct flashchip *flash, uint8_t *buf);
+
+/* ichspi.c */
+int ich_init_opcodes();
+int ich_spi_command(unsigned int writecnt, unsigned int readcnt,
+                   const unsigned char *writearr, unsigned char *readarr);
+int ich_spi_read(struct flashchip *flash, uint8_t * buf);
+int ich_spi_write(struct flashchip *flash, uint8_t * buf);
+
 /* it87spi.c */
 extern uint16_t it8716f_flashport;
-int it8716f_spi_command(unsigned int writecnt, unsigned int readcnt, const unsigned char *writearr, unsigned char *readarr);
+int it87xx_probe_spi_flash(const char *name);
+int it8716f_spi_command(unsigned int writecnt, unsigned int readcnt,
+                       const unsigned char *writearr, unsigned char *readarr);
 int it8716f_spi_chip_read(struct flashchip *flash, uint8_t *buf);
 int it8716f_spi_chip_write(struct flashchip *flash, uint8_t *buf);
-void it8716f_spi_page_program(int block, uint8_t *buf, uint8_t *bios);
+
+/* sb600spi.c */
+int sb600_spi_command(unsigned int writecnt, unsigned int readcnt,
+                     const unsigned char *writearr, unsigned char *readarr);
+int sb600_spi_read(struct flashchip *flash, uint8_t *buf);
+int sb600_spi_write(struct flashchip *flash, uint8_t *buf);
+uint8_t sb600_read_status_register(void);
+extern uint8_t volatile *sb600_spibar;
 
 /* jedec.c */
+uint8_t oddparity(uint8_t val);
 void toggle_ready_jedec(volatile uint8_t *dst);
 void data_polling_jedec(volatile uint8_t *dst, uint8_t data);
 void unprotect_jedec(volatile uint8_t *bios);
@@ -398,6 +608,11 @@ int erase_block_jedec(volatile uint8_t *bios, unsigned int page);
 int write_sector_jedec(volatile uint8_t *bios, uint8_t *src,
                       volatile uint8_t *dst, unsigned int page_size);
 
+/* m29f002.c */
+int erase_m29f002(struct flashchip *flash);
+int write_m29f002t(struct flashchip *flash, uint8_t *buf);
+int write_m29f002b(struct flashchip *flash, uint8_t *buf);
+
 /* m29f400bt.c */
 int probe_m29f400bt(struct flashchip *flash);
 int erase_m29f400bt(struct flashchip *flash);
@@ -416,10 +631,10 @@ int probe_29f002(struct flashchip *flash);
 int erase_29f002(struct flashchip *flash);
 int write_29f002(struct flashchip *flash, uint8_t *buf);
 
-/* pm49fl004.c */
-int probe_49fl004(struct flashchip *flash);
-int erase_49fl004(struct flashchip *flash);
-int write_49fl004(struct flashchip *flash, uint8_t *buf);
+/* pm49fl00x.c */
+int probe_49fl00x(struct flashchip *flash);
+int erase_49fl00x(struct flashchip *flash);
+int write_49fl00x(struct flashchip *flash, uint8_t *buf);
 
 /* sharplhf00l04.c */
 int probe_lhf00l04(struct flashchip *flash);
@@ -452,6 +667,11 @@ int probe_sst_fwhub(struct flashchip *flash);
 int erase_sst_fwhub(struct flashchip *flash);
 int write_sst_fwhub(struct flashchip *flash, uint8_t *buf);
 
+/* w39v040c.c */
+int probe_w39v040c(struct flashchip *flash);
+int erase_w39v040c(struct flashchip *flash);
+int write_w39v040c(struct flashchip *flash, uint8_t *buf);
+
 /* w39V080fa.c */
 int probe_winbond_fwhub(struct flashchip *flash);
 int erase_winbond_fwhub(struct flashchip *flash);
@@ -463,8 +683,15 @@ int probe_w29ee011(struct flashchip *flash);
 /* w49f002u.c */
 int write_49f002(struct flashchip *flash, uint8_t *buf);
 
+/* wbsio_spi.c */
+int wbsio_check_for_spi(const char *name);
+int wbsio_spi_command(unsigned int writecnt, unsigned int readcnt, const unsigned char *writearr, unsigned char *readarr);
+int wbsio_spi_read(struct flashchip *flash, uint8_t *buf);
+int wbsio_spi_write(struct flashchip *flash, uint8_t *buf);
+
 /* stm50flw0x0x.c */
 int probe_stm50flw0x0x(struct flashchip *flash);
 int erase_stm50flw0x0x(struct flashchip *flash);
 int write_stm50flw0x0x(struct flashchip *flash, uint8_t *buf);
+
 #endif                         /* !__FLASH_H__ */