| /* |
| * This file is part of the flashrom project. |
| * |
| * Copyright (c) 2010 Matthias Wenzel <bios at mazzoo dot de> |
| * Copyright (c) 2011 Stefan Tauner |
| * |
| * 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. |
| * |
| * 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. |
| */ |
| |
| #ifndef __ICH_DESCRIPTORS_H__ |
| #define __ICH_DESCRIPTORS_H__ 1 |
| |
| #include <sys/types.h> |
| #include <stdint.h> |
| #include <stdbool.h> |
| #include "programmer.h" /* for enum ich_chipset */ |
| |
| /* FIXME: Replace with generic return codes */ |
| #define ICH_RET_OK 0 |
| #define ICH_RET_ERR -1 |
| #define ICH_RET_WARN -2 |
| #define ICH_RET_PARAM -3 |
| #define ICH_RET_OOB -4 |
| |
| #define ICH9_REG_FDOC 0xB0 /* 32 Bits Flash Descriptor Observability Control */ |
| #define PCH100_REG_FDOC 0xB4 /* New offset from Sunrise Point on */ |
| /* 0-1: reserved */ |
| #define FDOC_FDSI_OFF 2 /* 2-11: Flash Descriptor Section Index */ |
| #define FDOC_FDSI (0x3f << FDOC_FDSI_OFF) |
| #define FDOC_FDSS_OFF 12 /* 12-14: Flash Descriptor Section Select */ |
| #define FDOC_FDSS (0x3 << FDOC_FDSS_OFF) |
| /* 15-31: reserved */ |
| |
| #define ICH9_REG_FDOD 0xB4 /* 32 Bits Flash Descriptor Observability Data */ |
| #define PCH100_REG_FDOD 0xB8 /* New offset from Sunrise Point on */ |
| |
| /* Field locations and semantics for LVSCC, UVSCC and related words in the flash |
| * descriptor are equal therefore they all share the same macros below. */ |
| #define VSCC_BES_OFF 0 /* 0-1: Block/Sector Erase Size */ |
| #define VSCC_BES (0x3 << VSCC_BES_OFF) |
| #define VSCC_WG_OFF 2 /* 2: Write Granularity */ |
| #define VSCC_WG (0x1 << VSCC_WG_OFF) |
| #define VSCC_WSR_OFF 3 /* 3: Write Status Required */ |
| #define VSCC_WSR (0x1 << VSCC_WSR_OFF) |
| #define VSCC_WEWS_OFF 4 /* 4: Write Enable on Write Status */ |
| #define VSCC_WEWS (0x1 << VSCC_WEWS_OFF) |
| /* 5-7: reserved */ |
| #define VSCC_EO_OFF 8 /* 8-15: Erase Opcode */ |
| #define VSCC_EO (0xff << VSCC_EO_OFF) |
| /* 16-22: reserved */ |
| #define VSCC_VCL_OFF 23 /* 23: Vendor Component Lock */ |
| #define VSCC_VCL (0x1 << VSCC_VCL_OFF) |
| /* 24-31: reserved */ |
| |
| #define ICH_FREG_BASE(flreg) (((flreg) << 12) & 0x07fff000) |
| #define ICH_FREG_LIMIT(flreg) ((((flreg) >> 4) & 0x07fff000) | 0x00000fff) |
| |
| void prettyprint_ich_reg_vscc(uint32_t reg_val, int verbosity, bool print_vcl); |
| |
| struct ich_desc_content { |
| uint32_t FLVALSIG; /* 0x00 */ |
| union { /* 0x04 */ |
| uint32_t FLMAP0; |
| struct { |
| uint32_t FCBA :8, /* Flash Component Base Address */ |
| NC :2, /* Number Of Components */ |
| :6, |
| FRBA :8, /* Flash Region Base Address */ |
| NR :3, /* Number Of Regions (reserved from Skylake on) */ |
| :5; |
| }; |
| }; |
| union { /* 0x08 */ |
| uint32_t FLMAP1; |
| struct { |
| uint32_t FMBA :8, /* Flash Master Base Address */ |
| NM :3, /* Number Of Masters */ |
| :5, |
| FISBA :8, /* Flash ICH Strap Base Address */ |
| ISL :8; /* ICH Strap Length */ |
| }; |
| }; |
| union { /* 0x0c */ |
| uint32_t FLMAP2; |
| struct { |
| uint32_t FMSBA :8, /* Flash (G)MCH Strap Base Addr. */ |
| MSL :8, /* MCH Strap Length */ |
| ICCRIBA :8, /* ICC Reg. Init Base Addr. (new since Sandy Bridge) */ |
| RIL :8; /* Register Init Length (new since Hawell) */ |
| }; |
| struct { /* new since Tiger Point */ |
| uint32_t :2, |
| CSSO :10, /* CPU Soft Strap Offset from PMC Base */ |
| :4, |
| CSSL :8, /* CPU Soft Strap Length */ |
| :8; |
| }; |
| }; |
| }; |
| |
| struct ich_desc_component { |
| union { /* 0x00 */ |
| uint32_t FLCOMP; /* Flash Components Register */ |
| /* FLCOMP encoding on various generations: |
| * |
| * Chipset/Generation max_speed dual_output density |
| * [MHz] bits max. bits |
| * ICH8: 33 N/A 5 0:2, 3:5 |
| * ICH9: 33 N/A 5 0:2, 3:5 |
| * ICH10: 33 N/A 5 0:2, 3:5 |
| * Ibex Peak/5: 50 N/A 5 0:2, 3:5 |
| * Cougar Point/6: 50 30 5 0:2, 3:5 |
| * Patsburg: 50 30 5 0:2, 3:5 |
| * Panther Point/7 50 30 5 0:2, 3:5 |
| * Lynx Point/8: 50 30 7 0:3, 4:7 |
| * Wildcat Point/9: 50 30 (multi I/O) 7 0:3, 4:7 |
| * Sunrise Point/100: 48 30 7 0:3, 4:7 |
| */ |
| struct { |
| uint32_t :17, |
| freq_read :3, |
| fastread :1, |
| freq_fastread :3, |
| freq_write :3, |
| freq_read_id :3, |
| dual_output :1, /* new since Cougar Point/6 */ |
| :1; |
| } modes; |
| struct { |
| uint32_t comp1_density :3, |
| comp2_density :3, |
| :26; |
| } dens_old; |
| struct { |
| uint32_t comp1_density :4, /* new since Lynx Point/8 */ |
| comp2_density :4, |
| :24; |
| } dens_new; |
| }; |
| union { /* 0x04 */ |
| uint32_t FLILL; /* Flash Invalid Instructions Register */ |
| struct { |
| uint32_t invalid_instr0 :8, |
| invalid_instr1 :8, |
| invalid_instr2 :8, |
| invalid_instr3 :8; |
| }; |
| }; |
| union { /* 0x08 */ |
| uint32_t FLPB; /* Flash Partition Boundary Register, until Panther Point/7 */ |
| struct { |
| uint32_t FPBA :13, /* Flash Partition Boundary Addr */ |
| :19; |
| }; |
| uint32_t FLILL1; /* Flash Invalid Instructions Register, new since Sunrise Point/100 */ |
| struct { |
| uint32_t invalid_instr4 :8, |
| invalid_instr5 :8, |
| invalid_instr6 :8, |
| invalid_instr7 :8; |
| }; |
| }; |
| }; |
| |
| #define MAX_NUM_FLREGS 16 |
| struct ich_desc_region { |
| /* |
| * Number of entries and width differ on various generations: |
| * |
| * Chipset/Generation #FLREGs width (bits) |
| * ICH8 .. Panther Point/7 5 13 |
| * Lynx Point/8 .. Wildcat Point/9 7 15 |
| * Sunrise Point/100 .. 200 Series 10 15 |
| * Lewisburg/100 .. 16 15 |
| * Cannon Point/300 .. 16 15 |
| */ |
| union { |
| uint32_t FLREGs[MAX_NUM_FLREGS]; /* Flash Descriptor Regions */ |
| |
| /* only used for bit-field check */ |
| struct { |
| uint32_t base :13, |
| :3, |
| limit :13, |
| :3; |
| } old_reg[MAX_NUM_FLREGS]; |
| }; |
| }; |
| |
| #define MAX_NUM_MASTERS 6 /* 5 prior to C620/Lewisburg PCH */ |
| struct ich_desc_master { |
| union { |
| uint32_t FLMSTRs[MAX_NUM_MASTERS]; /* Flash Masters */ |
| /* For pre-Skylake platforms */ |
| struct { |
| uint32_t BIOS_req_ID :16, |
| BIOS_descr_r :1, |
| BIOS_BIOS_r :1, |
| BIOS_ME_r :1, |
| BIOS_GbE_r :1, |
| BIOS_plat_r :1, |
| :3, |
| BIOS_descr_w :1, |
| BIOS_BIOS_w :1, |
| BIOS_ME_w :1, |
| BIOS_GbE_w :1, |
| BIOS_plat_w :1, |
| :3; |
| uint32_t ME_req_ID :16, |
| ME_descr_r :1, |
| ME_BIOS_r :1, |
| ME_ME_r :1, |
| ME_GbE_r :1, |
| ME_plat_r :1, |
| :3, |
| ME_descr_w :1, |
| ME_BIOS_w :1, |
| ME_ME_w :1, |
| ME_GbE_w :1, |
| ME_plat_w :1, |
| :3; |
| uint32_t GbE_req_ID :16, |
| GbE_descr_r :1, |
| GbE_BIOS_r :1, |
| GbE_ME_r :1, |
| GbE_GbE_r :1, |
| GbE_plat_r :1, |
| :3, |
| GbE_descr_w :1, |
| GbE_BIOS_w :1, |
| GbE_ME_w :1, |
| GbE_GbE_w :1, |
| GbE_plat_w :1, |
| :3; |
| }; |
| /* From Skylake on */ |
| struct ich_desc_master_region_access { |
| uint32_t ext_read :4, |
| ext_write :4, |
| read :12, |
| write :12; |
| } mstr[MAX_NUM_MASTERS]; |
| }; |
| }; |
| |
| struct ich_desc_north_strap { |
| union { |
| uint32_t STRPs[1]; /* current maximum: ich8 */ |
| struct { /* ich8 */ |
| struct { /* STRP2 (in the datasheet) */ |
| uint32_t MDB :1, |
| :31; |
| }; |
| } ich8; |
| }; |
| }; |
| |
| struct ich_desc_south_strap { |
| union { |
| uint32_t STRPs[23]; /* current maximum: gemini lake */ |
| struct { /* ich8 */ |
| struct { /* STRP1 */ |
| uint32_t ME_DISABLE :1, |
| :6, |
| TCOMODE :1, |
| ASD :7, |
| BMCMODE :1, |
| :3, |
| GLAN_PCIE_SEL :1, |
| GPIO12_SEL :2, |
| SPICS1_LANPHYPC_SEL :1, |
| MESM2SEL :1, |
| :1, |
| ASD2 :7; |
| }; |
| } ich8; |
| struct { /* ibex peak */ |
| struct { /* STRP0 */ |
| uint32_t :1, |
| cs_ss2 :1, |
| :5, |
| SMB_EN :1, |
| SML0_EN :1, |
| SML1_EN :1, |
| SML1FRQ :2, |
| SMB0FRQ :2, |
| SML0FRQ :2, |
| :4, |
| LANPHYPC_GP12_SEL :1, |
| cs_ss1 :1, |
| :2, |
| DMI_REQID_DIS :1, |
| :4, |
| BBBS :2, |
| :1; |
| }; |
| struct { /* STRP1 */ |
| uint32_t cs_ss3 :4, |
| :28; |
| }; |
| struct { /* STRP2 */ |
| uint32_t :8, |
| MESMASDEN :1, |
| MESMASDA :7, |
| :8, |
| MESMI2CEN :1, |
| MESMI2CA :7; |
| }; |
| struct { /* STRP3 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP4 */ |
| uint32_t PHYCON :2, |
| :6, |
| GBEMAC_SMBUS_ADDR_EN :1, |
| GBEMAC_SMBUS_ADDR :7, |
| :1, |
| GBEPHY_SMBUS_ADDR :7, |
| :8; |
| }; |
| struct { /* STRP5 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP6 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP7 */ |
| uint32_t MESMA2UDID_VENDOR :16, |
| MESMA2UDID_DEVICE :16; |
| }; |
| struct { /* STRP8 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP9 */ |
| uint32_t PCIEPCS1 :2, |
| PCIEPCS2 :2, |
| PCIELR1 :1, |
| PCIELR2 :1, |
| DMILR :1, |
| :1, |
| PHY_PCIEPORTSEL :3, |
| PHY_PCIE_EN :1, |
| :20; |
| }; |
| struct { /* STRP10 */ |
| uint32_t :1, |
| ME_BOOT_FLASH :1, |
| cs_ss5 :1, |
| VE_EN :1, |
| :4, |
| MMDDE :1, |
| MMADDR :7, |
| cs_ss7 :1, |
| :1, |
| ICC_SEL :3, |
| MER_CL1 :1, |
| :10; |
| }; |
| struct { /* STRP11 */ |
| uint32_t SML1GPAEN :1, |
| SML1GPA :7, |
| :16, |
| SML1I2CAEN :1, |
| SML1I2CA :7; |
| }; |
| struct { /* STRP12 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP13 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP14 */ |
| uint32_t :8, |
| VE_EN2 :1, |
| :5, |
| VE_BOOT_FLASH :1, |
| :1, |
| BW_SSD :1, |
| NVMHCI_EN :1, |
| :14; |
| }; |
| struct { /* STRP15 */ |
| uint32_t :3, |
| cs_ss6 :2, |
| :1, |
| IWL_EN :1, |
| :1, |
| t209min :2, |
| :22; |
| }; |
| } ibex; |
| struct { /* cougar point */ |
| struct { /* STRP0 */ |
| uint32_t :1, |
| cs_ss1 :1, |
| :5, |
| SMB_EN :1, |
| SML0_EN :1, |
| SML1_EN :1, |
| SML1FRQ :2, |
| SMB0FRQ :2, |
| SML0FRQ :2, |
| :4, |
| LANPHYPC_GP12_SEL :1, |
| LINKSEC_DIS :1, |
| :2, |
| DMI_REQID_DIS :1, |
| :4, |
| BBBS :2, |
| :1; |
| }; |
| struct { /* STRP1 */ |
| uint32_t cs_ss3 :4, |
| :4, |
| cs_ss2 :1, |
| :28; |
| }; |
| struct { /* STRP2 */ |
| uint32_t :8, |
| MESMASDEN :1, |
| MESMASDA :7, |
| MESMMCTPAEN :1, |
| MESMMCTPA :7, |
| MESMI2CEN :1, |
| MESMI2CA :7; |
| }; |
| struct { /* STRP3 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP4 */ |
| uint32_t PHYCON :2, |
| :6, |
| GBEMAC_SMBUS_ADDR_EN :1, |
| GBEMAC_SMBUS_ADDR :7, |
| :1, |
| GBEPHY_SMBUS_ADDR :7, |
| :8; |
| }; |
| struct { /* STRP5 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP6 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP7 */ |
| uint32_t MESMA2UDID_VENDOR :16, |
| MESMA2UDID_DEVICE :16; |
| }; |
| struct { /* STRP8 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP9 */ |
| uint32_t PCIEPCS1 :2, |
| PCIEPCS2 :2, |
| PCIELR1 :1, |
| PCIELR2 :1, |
| DMILR :1, |
| cs_ss4 :1, |
| PHY_PCIEPORTSEL :3, |
| PHY_PCIE_EN :1, |
| :2, |
| SUB_DECODE_EN :1, |
| :7, |
| PCHHOT_SML1ALERT_SEL :1, |
| :9; |
| }; |
| struct { /* STRP10 */ |
| uint32_t :1, |
| ME_BOOT_FLASH :1, |
| :6, |
| MDSMBE_EN :1, |
| MDSMBE_ADD :7, |
| :2, |
| ICC_SEL :3, |
| MER_CL1 :1, |
| ICC_PRO_SEL :1, |
| Deep_SX_EN :1, |
| ME_DBG_LAN :1, |
| :7; |
| }; |
| struct { /* STRP11 */ |
| uint32_t SML1GPAEN :1, |
| SML1GPA :7, |
| :16, |
| SML1I2CAEN :1, |
| SML1I2CA :7; |
| }; |
| struct { /* STRP12 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP13 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP14 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP15 */ |
| uint32_t cs_ss6 :6, |
| IWL_EN :1, |
| cs_ss5 :2, |
| :4, |
| SMLINK1_THERM_SEL :1, |
| SLP_LAN_GP29_SEL :1, |
| :16; |
| }; |
| struct { /* STRP16 */ |
| uint32_t :32; |
| }; |
| struct { /* STRP17 */ |
| uint32_t ICML :1, |
| cs_ss7 :1, |
| :30; |
| }; |
| } cougar; |
| }; |
| }; |
| |
| struct ich_desc_upper_map { |
| union { |
| uint32_t FLUMAP1; /* Flash Upper Map 1 */ |
| struct { |
| uint32_t VTBA :8, /* ME VSCC Table Base Address */ |
| VTL :8, /* ME VSCC Table Length */ |
| :8, |
| MDTBA :8; /* MIP Descr. Table Base Addr. (new since Cannon Point/300) */ |
| }; |
| }; |
| struct { |
| union { /* JEDEC-ID Register */ |
| uint32_t JID; |
| struct { |
| uint32_t vid :8, /* Vendor ID */ |
| cid0 :8, /* Component ID 0 */ |
| cid1 :8, /* Component ID 1 */ |
| :8; |
| }; |
| }; |
| union { /* Vendor Specific Component Capabilities */ |
| uint32_t VSCC; |
| struct { |
| uint32_t ubes :2, /* Upper Block/Sector Erase Size */ |
| uwg :1, /* Upper Write Granularity */ |
| uwsr :1, /* Upper Write Status Required */ |
| uwews :1, /* Upper Write Enable on Write Status */ |
| :3, |
| ueo :8, /* Upper Erase Opcode */ |
| lbes :2, /* Lower Block/Sector Erase Size */ |
| lwg :1, /* Lower Write Granularity */ |
| lwsr :1, /* Lower Write Status Required */ |
| lwews :1, /* Lower Write Enable on Write Status */ |
| :3, |
| leo :16; /* Lower Erase Opcode */ |
| }; |
| }; |
| } vscc_table[128]; |
| }; |
| |
| struct ich_descriptors { |
| struct ich_desc_content content; |
| struct ich_desc_component component; |
| struct ich_desc_region region; |
| struct ich_desc_master master; |
| struct ich_desc_north_strap north; |
| struct ich_desc_south_strap south; |
| struct ich_desc_upper_map upper; |
| }; |
| |
| ssize_t ich_number_of_regions(enum ich_chipset cs, const struct ich_desc_content *content); |
| ssize_t ich_number_of_masters(enum ich_chipset cs, const struct ich_desc_content *content); |
| |
| void prettyprint_ich_chipset(enum ich_chipset cs); |
| void prettyprint_ich_descriptors(enum ich_chipset cs, const struct ich_descriptors *desc); |
| |
| void prettyprint_ich_descriptor_content(enum ich_chipset cs, const struct ich_desc_content *content); |
| void prettyprint_ich_descriptor_component(enum ich_chipset cs, const struct ich_descriptors *desc); |
| void prettyprint_ich_descriptor_region(enum ich_chipset cs, const struct ich_descriptors *desc); |
| void prettyprint_ich_descriptor_master(enum ich_chipset cs, const struct ich_descriptors *desc); |
| |
| void prettyprint_ich_descriptor_upper_map(const struct ich_desc_upper_map *umap); |
| void prettyprint_ich_descriptor_straps(enum ich_chipset cs, const struct ich_descriptors *desc); |
| int read_ich_descriptors_from_dump(const uint32_t *dump, size_t len, enum ich_chipset *cs, struct ich_descriptors *desc); |
| |
| int read_ich_descriptors_via_fdo(enum ich_chipset cs, void *spibar, struct ich_descriptors *desc); |
| int getFCBA_component_density(enum ich_chipset cs, const struct ich_descriptors *desc, uint8_t idx); |
| |
| int layout_from_ich_descriptors(struct flashprog_layout **, const void *dump, size_t len); |
| |
| #endif /* __ICH_DESCRIPTORS_H__ */ |