blob: 6236ebd8007566298e6ae37125c5e0091f91db10 [file] [log] [blame]
Stefan Reinauerdebb11f2008-10-29 04:46:52 +00001/*
2 * This file is part of the coreboot project.
3 *
Stefan Reinauer54309d62009-01-20 22:53:10 +00004 * Copyright (C) 2008-2009 coresystems GmbH
Stefan Reinauerdebb11f2008-10-29 04:46:52 +00005 *
Stefan Reinauera8e11682009-03-11 14:54:18 +00006 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as
8 * published by the Free Software Foundation; version 2 of
9 * the License.
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000010 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000015 */
16
17#include <console/console.h>
18#include <device/device.h>
19#include <device/pci.h>
20#include <device/pci_ids.h>
21#include <pc80/mc146818rtc.h>
22#include <pc80/isa-dma.h>
Stefan Reinauer54309d62009-01-20 22:53:10 +000023#include <pc80/i8259.h>
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000024#include <arch/io.h>
Kyösti Mälkkif1b58b72019-03-01 13:43:02 +020025#include <device/pci_ops.h>
Uwe Hermann74d1a6e2010-10-12 17:34:08 +000026#include <arch/ioapic.h>
Stefan Reinauerab872542011-10-14 15:18:29 -070027#include <arch/acpi.h>
Sven Schnellef4dc1a72011-06-05 11:33:41 +020028#include <cpu/x86/smm.h>
Vladimir Serbinenko0e646172014-08-31 00:27:05 +020029#include <arch/acpigen.h>
Vladimir Serbinenkod5d94ea2014-10-18 02:13:11 +020030#include <arch/smp/mpspec.h>
Vladimir Serbinenko0e646172014-08-31 00:27:05 +020031#include <cbmem.h>
32#include <string.h>
Vladimir Serbinenkodd2bc3f2014-10-31 09:16:31 +010033#include <drivers/intel/gma/i915.h>
Arthur Heymansa8a9f342017-12-24 08:11:13 +010034#include <southbridge/intel/common/acpi_pirq_gen.h>
Elyes HAOUAS71187012019-02-10 14:58:13 +010035#include <southbridge/intel/common/pmbase.h>
Arthur Heymansb429c5b2019-05-28 13:24:15 +020036#include <southbridge/intel/common/spi.h>
Elyes HAOUAS71187012019-02-10 14:58:13 +010037
Arthur Heymans742df5a2019-06-03 16:24:41 +020038#include "chip.h"
Elyes HAOUAS71187012019-02-10 14:58:13 +010039#include "i82801gx.h"
Vladimir Serbinenko0e646172014-08-31 00:27:05 +020040#include "nvs.h"
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000041
Stefan Reinauer573f7d42009-07-21 21:50:34 +000042#define NMI_OFF 0
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000043
Stefan Reinauer573f7d42009-07-21 21:50:34 +000044#define ENABLE_ACPI_MODE_IN_COREBOOT 0
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000045
Stefan Reinauer54309d62009-01-20 22:53:10 +000046typedef struct southbridge_intel_i82801gx_config config_t;
47
Paul Menzelddddf152013-04-23 14:40:23 +020048/**
Martin Roth2ed0aa22016-01-05 20:58:58 -070049 * Set miscellaneous static southbridge features.
Paul Menzelddddf152013-04-23 14:40:23 +020050 *
51 * @param dev PCI device with I/O APIC control registers
52 */
53static void i82801gx_enable_ioapic(struct device *dev)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000054{
Paul Menzelddddf152013-04-23 14:40:23 +020055 /* Enable ACPI I/O range decode */
Kyösti Mälkki1cca3402013-02-26 19:21:39 +020056 pci_write_config8(dev, ACPI_CNTL, ACPI_EN);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000057
Kevin Paul Herbertbde6d302014-12-24 18:43:20 -080058 set_ioapic_id(VIO_APIC_VADDR, 0x02);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000059
Paul Menzelddddf152013-04-23 14:40:23 +020060 /*
61 * Select Boot Configuration register (0x03) and
62 * use Processor System Bus (0x01) to deliver interrupts.
63 */
Kevin Paul Herbertbde6d302014-12-24 18:43:20 -080064 io_apic_write(VIO_APIC_VADDR, 0x03, 0x01);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000065}
66
67static void i82801gx_enable_serial_irqs(struct device *dev)
68{
69 /* Set packet length and toggle silent mode bit for one frame. */
70 pci_write_config8(dev, SERIRQ_CNTL,
71 (1 << 7) | (1 << 6) | ((21 - 17) << 2) | (0 << 0));
72}
73
Stefan Reinauer573f7d42009-07-21 21:50:34 +000074/* PIRQ[n]_ROUT[3:0] - PIRQ Routing Control
75 * 0x00 - 0000 = Reserved
76 * 0x01 - 0001 = Reserved
77 * 0x02 - 0010 = Reserved
78 * 0x03 - 0011 = IRQ3
79 * 0x04 - 0100 = IRQ4
80 * 0x05 - 0101 = IRQ5
81 * 0x06 - 0110 = IRQ6
82 * 0x07 - 0111 = IRQ7
83 * 0x08 - 1000 = Reserved
84 * 0x09 - 1001 = IRQ9
85 * 0x0A - 1010 = IRQ10
86 * 0x0B - 1011 = IRQ11
87 * 0x0C - 1100 = IRQ12
88 * 0x0D - 1101 = Reserved
89 * 0x0E - 1110 = IRQ14
90 * 0x0F - 1111 = IRQ15
91 * PIRQ[n]_ROUT[7] - PIRQ Routing Control
92 * 0x80 - The PIRQ is not routed.
93 */
94
Elyes HAOUAS99667032018-05-13 12:47:28 +020095static void i82801gx_pirq_init(struct device *dev)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +000096{
Elyes HAOUAS99667032018-05-13 12:47:28 +020097 struct device *irq_dev;
Stefan Reinauer54309d62009-01-20 22:53:10 +000098 /* Get the chip configuration */
99 config_t *config = dev->chip_info;
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000100
Stefan Reinauer54309d62009-01-20 22:53:10 +0000101 pci_write_config8(dev, PIRQA_ROUT, config->pirqa_routing);
102 pci_write_config8(dev, PIRQB_ROUT, config->pirqb_routing);
103 pci_write_config8(dev, PIRQC_ROUT, config->pirqc_routing);
104 pci_write_config8(dev, PIRQD_ROUT, config->pirqd_routing);
105
106 pci_write_config8(dev, PIRQE_ROUT, config->pirqe_routing);
107 pci_write_config8(dev, PIRQF_ROUT, config->pirqf_routing);
108 pci_write_config8(dev, PIRQG_ROUT, config->pirqg_routing);
109 pci_write_config8(dev, PIRQH_ROUT, config->pirqh_routing);
110
111 /* Eric Biederman once said we should let the OS do this.
112 * I am not so sure anymore he was right.
113 */
114
Elyes HAOUASba28e8d2016-08-31 19:22:16 +0200115 for (irq_dev = all_devices; irq_dev; irq_dev = irq_dev->next) {
Arthur Heymans3f111b02017-03-09 12:02:52 +0100116 u8 int_pin = 0, int_line = 0;
Stefan Reinauer54309d62009-01-20 22:53:10 +0000117
118 if (!irq_dev->enabled || irq_dev->path.type != DEVICE_PATH_PCI)
119 continue;
120
121 int_pin = pci_read_config8(irq_dev, PCI_INTERRUPT_PIN);
122
123 switch (int_pin) {
Arthur Heymans3f111b02017-03-09 12:02:52 +0100124 case 1:
125 /* INTA# */ int_line = config->pirqa_routing; break;
126 case 2:
127 /* INTB# */ int_line = config->pirqb_routing; break;
128 case 3:
129 /* INTC# */ int_line = config->pirqc_routing; break;
130 case 4:
131 /* INTD# */ int_line = config->pirqd_routing; break;
Stefan Reinauer54309d62009-01-20 22:53:10 +0000132 }
133
134 if (!int_line)
135 continue;
136
137 pci_write_config8(irq_dev, PCI_INTERRUPT_LINE, int_line);
138 }
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000139}
140
Elyes HAOUAS99667032018-05-13 12:47:28 +0200141static void i82801gx_gpi_routing(struct device *dev)
Stefan Reinauera8e11682009-03-11 14:54:18 +0000142{
143 /* Get the chip configuration */
144 config_t *config = dev->chip_info;
145 u32 reg32 = 0;
146
147 /* An array would be much nicer here, or some
148 * other method of doing this.
149 */
150 reg32 |= (config->gpi0_routing & 0x03) << 0;
151 reg32 |= (config->gpi1_routing & 0x03) << 2;
152 reg32 |= (config->gpi2_routing & 0x03) << 4;
153 reg32 |= (config->gpi3_routing & 0x03) << 6;
154 reg32 |= (config->gpi4_routing & 0x03) << 8;
155 reg32 |= (config->gpi5_routing & 0x03) << 10;
156 reg32 |= (config->gpi6_routing & 0x03) << 12;
157 reg32 |= (config->gpi7_routing & 0x03) << 14;
158 reg32 |= (config->gpi8_routing & 0x03) << 16;
159 reg32 |= (config->gpi9_routing & 0x03) << 18;
160 reg32 |= (config->gpi10_routing & 0x03) << 20;
161 reg32 |= (config->gpi11_routing & 0x03) << 22;
162 reg32 |= (config->gpi12_routing & 0x03) << 24;
163 reg32 |= (config->gpi13_routing & 0x03) << 26;
164 reg32 |= (config->gpi14_routing & 0x03) << 28;
165 reg32 |= (config->gpi15_routing & 0x03) << 30;
166
Kyösti Mälkkib85a87b2014-12-29 11:32:27 +0200167 pci_write_config32(dev, GPIO_ROUT, reg32);
Stefan Reinauera8e11682009-03-11 14:54:18 +0000168}
169
Elyes HAOUAS99667032018-05-13 12:47:28 +0200170static void i82801gx_power_options(struct device *dev)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000171{
172 u8 reg8;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100173 u16 reg16;
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000174 u32 reg32;
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000175 const char *state;
Stefan Reinaueraca6ec62009-10-26 17:12:21 +0000176 /* Get the chip configuration */
177 config_t *config = dev->chip_info;
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000178
Nico Huber9faae2b2018-11-14 00:00:35 +0100179 int pwr_on = CONFIG_MAINBOARD_POWER_FAILURE_STATE;
Luc Verhaegena9c5ea02009-06-03 14:19:33 +0000180 int nmi_option;
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000181
182 /* Which state do we want to goto after g3 (power restored)?
183 * 0 == S0 Full On
184 * 1 == S5 Soft Off
Stefan Reinaueraca6ec62009-10-26 17:12:21 +0000185 *
186 * If the option is not existent (Laptops), use MAINBOARD_POWER_ON.
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000187 */
Varad Gautam06ef0462015-03-11 09:54:41 +0530188 pwr_on = MAINBOARD_POWER_ON;
189 get_option(&pwr_on, "power_on_after_fail");
Stefan Reinaueraca6ec62009-10-26 17:12:21 +0000190
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000191 reg8 = pci_read_config8(dev, GEN_PMCON_3);
192 reg8 &= 0xfe;
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000193 switch (pwr_on) {
194 case MAINBOARD_POWER_OFF:
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000195 reg8 |= 1;
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000196 state = "off";
197 break;
198 case MAINBOARD_POWER_ON:
199 reg8 &= ~1;
200 state = "on";
201 break;
202 case MAINBOARD_POWER_KEEP:
203 reg8 &= ~1;
204 state = "state keep";
205 break;
206 default:
207 state = "undefined";
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000208 }
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000209
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000210 reg8 |= (3 << 4); /* avoid #S4 assertions */
Martin Roth2ed0aa22016-01-05 20:58:58 -0700211 reg8 &= ~(1 << 3); /* minimum assertion is 1 to 2 RTCCLK */
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000212
213 pci_write_config8(dev, GEN_PMCON_3, reg8);
Stefan Reinauerc02b4fc2010-03-22 11:42:32 +0000214 printk(BIOS_INFO, "Set power %s after power failure.\n", state);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000215
216 /* Set up NMI on errors. */
217 reg8 = inb(0x61);
218 reg8 &= 0x0f; /* Higher Nibble must be 0 */
219 reg8 &= ~(1 << 3); /* IOCHK# NMI Enable */
220 // reg8 &= ~(1 << 2); /* PCI SERR# Enable */
221 reg8 |= (1 << 2); /* PCI SERR# Disable for now */
222 outb(reg8, 0x61);
223
224 reg8 = inb(0x70);
225 nmi_option = NMI_OFF;
Luc Verhaegena9c5ea02009-06-03 14:19:33 +0000226 get_option(&nmi_option, "nmi");
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000227 if (nmi_option) {
Stefan Reinauerc02b4fc2010-03-22 11:42:32 +0000228 printk(BIOS_INFO, "NMI sources enabled.\n");
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000229 reg8 &= ~(1 << 7); /* Set NMI. */
230 } else {
Stefan Reinauerc02b4fc2010-03-22 11:42:32 +0000231 printk(BIOS_INFO, "NMI sources disabled.\n");
Arthur Heymans3f111b02017-03-09 12:02:52 +0100232 reg8 |= (1 << 7); /* Can't mask NMI from PCI-E and NMI_NOW */
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000233 }
234 outb(reg8, 0x70);
235
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000236 /* Enable CPU_SLP# and Intel Speedstep, set SMI# rate down */
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000237 reg16 = pci_read_config16(dev, GEN_PMCON_1);
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000238 reg16 &= ~(3 << 0); // SMI# rate 1 minute
239 reg16 |= (1 << 2); // CLKRUN_EN - Mobile/Ultra only
240 reg16 |= (1 << 3); // Speedstep Enable - Mobile/Ultra only
241 reg16 |= (1 << 5); // CPUSLP_EN Desktop only
Sven Schnelle906f9ae2011-10-23 16:35:01 +0200242
243 if (config->c4onc3_enable)
244 reg16 |= (1 << 7);
245
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000246 // another laptop wants this?
247 // reg16 &= ~(1 << 10); // BIOS_PCI_EXP_EN - Desktop/Mobile only
248 reg16 |= (1 << 10); // BIOS_PCI_EXP_EN - Desktop/Mobile only
Stefan Reinaueraca6ec62009-10-26 17:12:21 +0000249#if DEBUG_PERIODIC_SMIS
250 /* Set DEBUG_PERIODIC_SMIS in i82801gx.h to debug using
251 * periodic SMIs.
252 */
253 reg16 |= (3 << 0); // Periodic SMI every 8s
254#endif
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000255 pci_write_config16(dev, GEN_PMCON_1, reg16);
256
Stefan Reinauera8e11682009-03-11 14:54:18 +0000257 // Set the board's GPI routing.
258 i82801gx_gpi_routing(dev);
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000259
Elyes HAOUAS71187012019-02-10 14:58:13 +0100260 write_pmbase32(GPE0_EN, config->gpe0_en);
261 write_pmbase16(ALT_GP_SMI_EN, config->alt_gp_smi_en);
Stefan Reinaueraca6ec62009-10-26 17:12:21 +0000262
263 /* Set up power management block and determine sleep mode */
Elyes HAOUAS71187012019-02-10 14:58:13 +0100264 reg32 = read_pmbase32(PM1_CNT);
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000265
266 reg32 &= ~(7 << 10); // SLP_TYP
267 reg32 |= (1 << 1); // enable C3->C0 transition on bus master
268 reg32 |= (1 << 0); // SCI_EN
Elyes HAOUAS71187012019-02-10 14:58:13 +0100269 write_pmbase32(PM1_CNT, reg32);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000270}
271
Elyes HAOUAS99667032018-05-13 12:47:28 +0200272static void i82801gx_configure_cstates(struct device *dev)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000273{
274 u8 reg8;
Stefan Reinauer109ab312009-08-12 16:08:05 +0000275
Stefan Reinauera8e11682009-03-11 14:54:18 +0000276 reg8 = pci_read_config8(dev, 0xa9); // Cx state configuration
277 reg8 |= (1 << 4) | (1 << 3) | (1 << 2); // Enable Popup & Popdown
278 pci_write_config8(dev, 0xa9, reg8);
279
280 // Set Deeper Sleep configuration to recommended values
281 reg8 = pci_read_config8(dev, 0xaa);
282 reg8 &= 0xf0;
283 reg8 |= (2 << 2); // Deeper Sleep to Stop CPU: 34-40us
284 reg8 |= (2 << 0); // Deeper Sleep to Sleep: 15us
285 pci_write_config8(dev, 0xaa, reg8);
286}
287
288static void i82801gx_rtc_init(struct device *dev)
289{
290 u8 reg8;
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000291 int rtc_failed;
292
293 reg8 = pci_read_config8(dev, GEN_PMCON_3);
294 rtc_failed = reg8 & RTC_BATTERY_DEAD;
295 if (rtc_failed) {
296 reg8 &= ~RTC_BATTERY_DEAD;
297 pci_write_config8(dev, GEN_PMCON_3, reg8);
298 }
Stefan Reinauerc02b4fc2010-03-22 11:42:32 +0000299 printk(BIOS_DEBUG, "rtc_failed = 0x%x\n", rtc_failed);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000300
Gabe Blackb3f08c62014-04-30 17:12:25 -0700301 cmos_init(rtc_failed);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000302}
303
Stefan Reinauera8e11682009-03-11 14:54:18 +0000304static void enable_hpet(void)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000305{
Stefan Reinauera8e11682009-03-11 14:54:18 +0000306 u32 reg32;
Stefan Reinauer109ab312009-08-12 16:08:05 +0000307
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000308 /* Move HPET to default address 0xfed00000 and enable it */
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000309 reg32 = RCBA32(HPTC);
Stefan Reinauera8e11682009-03-11 14:54:18 +0000310 reg32 |= (1 << 7); // HPET Address Enable
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000311 reg32 &= ~(3 << 0);
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000312 RCBA32(HPTC) = reg32;
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000313}
314
Stefan Reinauera8e11682009-03-11 14:54:18 +0000315static void enable_clock_gating(void)
316{
317 u32 reg32;
Stefan Reinauer109ab312009-08-12 16:08:05 +0000318
Stefan Reinauera8e11682009-03-11 14:54:18 +0000319 /* Enable Clock Gating for most devices */
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000320 reg32 = RCBA32(CG);
Stefan Reinauera8e11682009-03-11 14:54:18 +0000321 reg32 |= (1 << 31); // LPC clock gating
322 reg32 |= (1 << 30); // PATA clock gating
323 // SATA clock gating
324 reg32 |= (1 << 27) | (1 << 26) | (1 << 25) | (1 << 24);
325 reg32 |= (1 << 23); // AC97 clock gating
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000326 reg32 |= (1 << 19); // USB EHCI clock gating
Stefan Reinauera8e11682009-03-11 14:54:18 +0000327 reg32 |= (1 << 3) | (1 << 1); // DMI clock gating
328 reg32 |= (1 << 2); // PCIe clock gating;
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000329 reg32 &= ~(1 << 20); // No static clock gating for USB
Arthur Heymans3f111b02017-03-09 12:02:52 +0100330 reg32 &= ~((1 << 29) | (1 << 28)); // Disable UHCI clock gating
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000331 RCBA32(CG) = reg32;
Stefan Reinauera8e11682009-03-11 14:54:18 +0000332}
Stefan Reinauer269563a2009-01-19 21:20:22 +0000333
Julius Wernercd49cce2019-03-05 16:53:33 -0800334#if CONFIG(HAVE_SMI_HANDLER)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000335static void i82801gx_lock_smm(struct device *dev)
336{
Kyösti Mälkkic3ed8862014-06-19 19:50:51 +0300337 if (!acpi_is_wakeup_s3()) {
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000338#if ENABLE_ACPI_MODE_IN_COREBOOT
Sven Schnellef4dc1a72011-06-05 11:33:41 +0200339 printk(BIOS_DEBUG, "Enabling ACPI via APMC:\n");
340 outb(APM_CNT_ACPI_ENABLE, APM_CNT); // Enable ACPI mode
341 printk(BIOS_DEBUG, "done.\n");
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000342#else
Sven Schnellef4dc1a72011-06-05 11:33:41 +0200343 printk(BIOS_DEBUG, "Disabling ACPI via APMC:\n");
344 outb(APM_CNT_ACPI_DISABLE, APM_CNT); // Disable ACPI mode
345 printk(BIOS_DEBUG, "done.\n");
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000346#endif
Sven Schnellee2618072011-06-05 11:39:12 +0200347 } else {
348 printk(BIOS_DEBUG, "S3 wakeup, enabling ACPI via APMC\n");
349 outb(APM_CNT_ACPI_ENABLE, APM_CNT);
350 }
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000351}
Stefan Reinauer269563a2009-01-19 21:20:22 +0000352#endif
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000353
Stefan Reinauera8e11682009-03-11 14:54:18 +0000354#define SPIBASE 0x3020
355static void i82801gx_spi_init(void)
356{
357 u16 spicontrol;
358
359 spicontrol = RCBA16(SPIBASE + 2);
360 spicontrol &= ~(1 << 0); // SPI Access Request
361 RCBA16(SPIBASE + 2) = spicontrol;
362}
363
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000364static void i82801gx_fixups(struct device *dev)
Stefan Reinauera8e11682009-03-11 14:54:18 +0000365{
366 /* This needs to happen after PCI enumeration */
367 RCBA32(0x1d40) |= 1;
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000368
369 /* USB Transient Disconnect Detect:
370 * Prevent a SE0 condition on the USB ports from being
371 * interpreted by the UHCI controller as a disconnect
372 */
373 pci_write_config8(dev, 0xad, 0x3);
Stefan Reinauera8e11682009-03-11 14:54:18 +0000374}
375
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000376static void lpc_init(struct device *dev)
377{
Stefan Reinauerc02b4fc2010-03-22 11:42:32 +0000378 printk(BIOS_DEBUG, "i82801gx: lpc_init\n");
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000379
380 /* Set the value for PCI command register. */
381 pci_write_config16(dev, PCI_COMMAND, 0x000f);
382
383 /* IO APIC initialization. */
Paul Menzelddddf152013-04-23 14:40:23 +0200384 i82801gx_enable_ioapic(dev);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000385
386 i82801gx_enable_serial_irqs(dev);
387
388 /* Setup the PIRQ. */
389 i82801gx_pirq_init(dev);
390
391 /* Setup power options. */
392 i82801gx_power_options(dev);
393
Stefan Reinauera8e11682009-03-11 14:54:18 +0000394 /* Configure Cx state registers */
395 i82801gx_configure_cstates(dev);
396
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000397 /* Set the state of the GPIO lines. */
398 //gpio_init(dev);
399
400 /* Initialize the real time clock. */
401 i82801gx_rtc_init(dev);
402
403 /* Initialize ISA DMA. */
404 isa_dma_init();
405
406 /* Initialize the High Precision Event Timers, if present. */
Stefan Reinauera8e11682009-03-11 14:54:18 +0000407 enable_hpet();
408
409 /* Initialize Clock Gating */
410 enable_clock_gating();
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000411
412 setup_i8259();
413
Stefan Reinaueraca6ec62009-10-26 17:12:21 +0000414 /* The OS should do this? */
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000415 /* Interrupt 9 should be level triggered (SCI) */
416 i8259_configure_irq_trigger(9, 1);
Stefan Reinaueraca6ec62009-10-26 17:12:21 +0000417
Julius Wernercd49cce2019-03-05 16:53:33 -0800418#if CONFIG(HAVE_SMI_HANDLER)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000419 i82801gx_lock_smm(dev);
Stefan Reinauer269563a2009-01-19 21:20:22 +0000420#endif
Stefan Reinauera8e11682009-03-11 14:54:18 +0000421
422 i82801gx_spi_init();
423
Stefan Reinauer7a3d0952010-01-17 13:49:07 +0000424 i82801gx_fixups(dev);
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000425}
426
Vladimir Serbinenkod5d94ea2014-10-18 02:13:11 +0200427unsigned long acpi_fill_madt(unsigned long current)
428{
429 /* Local APICs */
430 current = acpi_create_madt_lapics(current);
431
432 /* IOAPIC */
433 current += acpi_create_madt_ioapic((acpi_madt_ioapic_t *) current,
434 2, IO_APIC_ADDR, 0);
435
436 /* LAPIC_NMI */
437 current += acpi_create_madt_lapic_nmi((acpi_madt_lapic_nmi_t *)
438 current, 0,
439 MP_IRQ_POLARITY_HIGH |
440 MP_IRQ_TRIGGER_EDGE, 0x01);
441 current += acpi_create_madt_lapic_nmi((acpi_madt_lapic_nmi_t *)
442 current, 1, MP_IRQ_POLARITY_HIGH |
443 MP_IRQ_TRIGGER_EDGE, 0x01);
444
445 /* INT_SRC_OVR */
446 current += acpi_create_madt_irqoverride((acpi_madt_irqoverride_t *)
447 current, 0, 0, 2, MP_IRQ_POLARITY_HIGH | MP_IRQ_TRIGGER_EDGE);
448 current += acpi_create_madt_irqoverride((acpi_madt_irqoverride_t *)
449 current, 0, 9, 9, MP_IRQ_POLARITY_HIGH | MP_IRQ_TRIGGER_LEVEL);
450
451
452 return current;
453}
454
Arthur Heymans3f111b02017-03-09 12:02:52 +0100455void acpi_fill_fadt(acpi_fadt_t *fadt)
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200456{
Kyösti Mälkkic70eed12018-05-22 02:18:00 +0300457 struct device *dev = pcidev_on_root(0x1f, 0);
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200458 config_t *chip = dev->chip_info;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100459 u16 pmbase = lpc_get_pmbase();
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200460
461 fadt->pm1a_evt_blk = pmbase;
462 fadt->pm1b_evt_blk = 0x0;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100463 fadt->pm1a_cnt_blk = pmbase + PM1_CNT;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200464 fadt->pm1b_cnt_blk = 0x0;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100465 fadt->pm2_cnt_blk = pmbase + PM2_CNT;
466 fadt->pm_tmr_blk = pmbase + PM1_TMR;
467 fadt->gpe0_blk = pmbase + GPE0_STS;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200468 fadt->gpe1_blk = 0;
469
470 fadt->pm1_evt_len = 4;
471 fadt->pm1_cnt_len = 2;
472 fadt->pm2_cnt_len = 1;
473 fadt->pm_tmr_len = 4;
474 fadt->gpe0_blk_len = 8;
475 fadt->gpe1_blk_len = 0;
476 fadt->gpe1_base = 0;
477
478 fadt->reset_reg.space_id = 1;
479 fadt->reset_reg.bit_width = 8;
480 fadt->reset_reg.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200481 fadt->reset_reg.access_size = ACPI_ACCESS_SIZE_BYTE_ACCESS;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200482 fadt->reset_reg.addrl = 0xcf9;
483 fadt->reset_reg.addrh = 0;
484
485 fadt->reset_value = 6;
486
487 fadt->x_pm1a_evt_blk.space_id = 1;
488 fadt->x_pm1a_evt_blk.bit_width = 32;
489 fadt->x_pm1a_evt_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200490 fadt->x_pm1a_evt_blk.access_size = ACPI_ACCESS_SIZE_DWORD_ACCESS;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200491 fadt->x_pm1a_evt_blk.addrl = pmbase;
492 fadt->x_pm1a_evt_blk.addrh = 0x0;
493
494 fadt->x_pm1b_evt_blk.space_id = 0;
495 fadt->x_pm1b_evt_blk.bit_width = 0;
496 fadt->x_pm1b_evt_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200497 fadt->x_pm1b_evt_blk.access_size = 0;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200498 fadt->x_pm1b_evt_blk.addrl = 0x0;
499 fadt->x_pm1b_evt_blk.addrh = 0x0;
500
501 fadt->x_pm1a_cnt_blk.space_id = 1;
502 fadt->x_pm1a_cnt_blk.bit_width = 16;
503 fadt->x_pm1a_cnt_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200504 fadt->x_pm1a_cnt_blk.access_size = ACPI_ACCESS_SIZE_WORD_ACCESS;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100505 fadt->x_pm1a_cnt_blk.addrl = pmbase + PM1_CNT;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200506 fadt->x_pm1a_cnt_blk.addrh = 0x0;
507
508 fadt->x_pm1b_cnt_blk.space_id = 0;
509 fadt->x_pm1b_cnt_blk.bit_width = 0;
510 fadt->x_pm1b_cnt_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200511 fadt->x_pm1b_cnt_blk.access_size = 0;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200512 fadt->x_pm1b_cnt_blk.addrl = 0x0;
513 fadt->x_pm1b_cnt_blk.addrh = 0x0;
514
515 fadt->x_pm2_cnt_blk.space_id = 1;
516 fadt->x_pm2_cnt_blk.bit_width = 8;
517 fadt->x_pm2_cnt_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200518 fadt->x_pm2_cnt_blk.access_size = ACPI_ACCESS_SIZE_BYTE_ACCESS;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100519 fadt->x_pm2_cnt_blk.addrl = pmbase + PM2_CNT;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200520 fadt->x_pm2_cnt_blk.addrh = 0x0;
521
522 fadt->x_pm_tmr_blk.space_id = 1;
523 fadt->x_pm_tmr_blk.bit_width = 32;
524 fadt->x_pm_tmr_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200525 fadt->x_pm_tmr_blk.access_size = ACPI_ACCESS_SIZE_DWORD_ACCESS;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100526 fadt->x_pm_tmr_blk.addrl = pmbase + PM1_TMR;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200527 fadt->x_pm_tmr_blk.addrh = 0x0;
528
529 fadt->x_gpe0_blk.space_id = 1;
530 fadt->x_gpe0_blk.bit_width = 64;
531 fadt->x_gpe0_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200532 fadt->x_gpe0_blk.access_size = ACPI_ACCESS_SIZE_DWORD_ACCESS;
Elyes HAOUAS71187012019-02-10 14:58:13 +0100533 fadt->x_gpe0_blk.addrl = pmbase + GPE0_STS;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200534 fadt->x_gpe0_blk.addrh = 0x0;
535
536 fadt->x_gpe1_blk.space_id = 0;
537 fadt->x_gpe1_blk.bit_width = 0;
538 fadt->x_gpe1_blk.bit_offset = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200539 fadt->x_gpe1_blk.access_size = 0;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200540 fadt->x_gpe1_blk.addrl = 0x0;
541 fadt->x_gpe1_blk.addrh = 0x0;
542 fadt->day_alrm = 0xd;
543 fadt->mon_alrm = 0x00;
544 fadt->century = 0x32;
545
Elyes HAOUAS0d4de2a2019-02-28 13:04:29 +0100546 fadt->reserved = 0;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200547 fadt->sci_int = 0x9;
548 fadt->smi_cmd = APM_CNT;
549 fadt->acpi_enable = APM_CNT_ACPI_ENABLE;
550 fadt->acpi_disable = APM_CNT_ACPI_DISABLE;
551 fadt->s4bios_req = 0x0;
552 fadt->pstate_cnt = APM_CNT_PST_CONTROL;
553
554 fadt->cst_cnt = APM_CNT_CST_CONTROL;
555 fadt->p_lvl2_lat = 1;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200556 fadt->p_lvl3_lat = chip->c3_latency;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200557 fadt->flush_size = 0;
558 fadt->flush_stride = 0;
559 fadt->duty_offset = 1;
Arthur Heymans3f111b02017-03-09 12:02:52 +0100560 if (chip->p_cnt_throttling_supported)
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200561 fadt->duty_width = 3;
Arthur Heymans3f111b02017-03-09 12:02:52 +0100562 else
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200563 fadt->duty_width = 0;
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200564 fadt->iapc_boot_arch = 0x03;
565 fadt->flags = (ACPI_FADT_WBINVD | ACPI_FADT_C1_SUPPORTED
566 | ACPI_FADT_SLEEP_BUTTON | ACPI_FADT_S4_RTC_WAKE
567 | ACPI_FADT_PLATFORM_CLOCK | ACPI_FADT_RESET_REGISTER
568 | ACPI_FADT_C2_MP_SUPPORTED);
Arthur Heymans3f111b02017-03-09 12:02:52 +0100569 if (chip->docking_supported)
Vladimir Serbinenkoab83ef02014-10-25 15:18:25 +0200570 fadt->flags |= ACPI_FADT_DOCKING_SUPPORTED;
Vladimir Serbinenkoc21e0732014-10-16 12:48:19 +0200571}
572
Elyes HAOUAS99667032018-05-13 12:47:28 +0200573static void i82801gx_lpc_read_resources(struct device *dev)
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000574{
575 struct resource *res;
Vladimir Serbinenkof119f082014-11-24 21:05:56 +0100576 u8 io_index = 0;
577 int i;
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000578
579 /* Get the normal PCI resources of this device. */
580 pci_dev_read_resources(dev);
581
582 /* Add an extra subtractive resource for both memory and I/O. */
Vladimir Serbinenkof119f082014-11-24 21:05:56 +0100583 res = new_resource(dev, IOINDEX_SUBTRACTIVE(io_index++, 0));
Myles Watson29cc9ed2009-07-02 18:56:24 +0000584 res->base = 0;
585 res->size = 0x1000;
586 res->flags = IORESOURCE_IO | IORESOURCE_SUBTRACTIVE |
587 IORESOURCE_ASSIGNED | IORESOURCE_FIXED;
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000588
Vladimir Serbinenkof119f082014-11-24 21:05:56 +0100589 res = new_resource(dev, IOINDEX_SUBTRACTIVE(io_index++, 0));
Myles Watson29cc9ed2009-07-02 18:56:24 +0000590 res->base = 0xff800000;
591 res->size = 0x00800000; /* 8 MB for flash */
592 res->flags = IORESOURCE_MEM | IORESOURCE_SUBTRACTIVE |
593 IORESOURCE_ASSIGNED | IORESOURCE_FIXED;
594
595 res = new_resource(dev, 3); /* IOAPIC */
Uwe Hermann74d1a6e2010-10-12 17:34:08 +0000596 res->base = IO_APIC_ADDR;
Myles Watson29cc9ed2009-07-02 18:56:24 +0000597 res->size = 0x00001000;
598 res->flags = IORESOURCE_MEM | IORESOURCE_ASSIGNED | IORESOURCE_FIXED;
Vladimir Serbinenkof119f082014-11-24 21:05:56 +0100599
600 /* Set IO decode ranges if required.*/
601 for (i = 0; i < 4; i++) {
602 u32 gen_dec;
603 gen_dec = pci_read_config32(dev, 0x84 + 4 * i);
604
605 if ((gen_dec & 0xFFFC) > 0x1000) {
606 res = new_resource(dev, IOINDEX_SUBTRACTIVE(io_index++, 0));
607 res->base = gen_dec & 0xFFFC;
608 res->size = (gen_dec >> 16) & 0xFC;
609 res->flags = IORESOURCE_IO | IORESOURCE_SUBTRACTIVE |
610 IORESOURCE_ASSIGNED | IORESOURCE_FIXED;
611 }
612 }
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000613}
614
Arthur Heymans36646472018-01-22 14:42:18 +0100615#define SPIBAR16(x) RCBA16(0x3020 + x)
616#define SPIBAR32(x) RCBA32(0x3020 + x)
617
618static void lpc_final(struct device *dev)
619{
620 u16 tco1_cnt;
621
Julius Wernercd49cce2019-03-05 16:53:33 -0800622 if (!CONFIG(INTEL_CHIPSET_LOCKDOWN))
Arthur Heymans36646472018-01-22 14:42:18 +0100623 return;
624
Arthur Heymansb429c5b2019-05-28 13:24:15 +0200625 spi_finalize_ops();
Arthur Heymans36646472018-01-22 14:42:18 +0100626
627 /* Lock SPIBAR */
628 SPIBAR16(0) = SPIBAR16(0) | (1 << 15);
629
630 /* BIOS Interface Lockdown */
631 RCBA32(0x3410) |= 1 << 0;
632
633 /* Global SMI Lock */
634 pci_or_config16(dev, GEN_PMCON_1, 1 << 4);
635
636 /* TCO_Lock */
637 tco1_cnt = inw(DEFAULT_PMBASE + 0x60 + TCO1_CNT);
638 tco1_cnt |= (1 << 12); /* TCO lock */
639 outw(tco1_cnt, DEFAULT_PMBASE + 0x60 + TCO1_CNT);
640
641 /* Indicate finalize step with post code */
642 outb(POST_OS_BOOT, 0x80);
643}
644
Elyes HAOUAS99667032018-05-13 12:47:28 +0200645static void southbridge_inject_dsdt(struct device *dev)
Vladimir Serbinenko0e646172014-08-31 00:27:05 +0200646{
Arthur Heymans3f111b02017-03-09 12:02:52 +0100647 global_nvs_t *gnvs = cbmem_add(CBMEM_ID_ACPI_GNVS, sizeof(*gnvs));
Vladimir Serbinenko0e646172014-08-31 00:27:05 +0200648
649 if (gnvs) {
Vladimir Serbinenkodd2bc3f2014-10-31 09:16:31 +0100650 const struct i915_gpu_controller_info *gfx = intel_gma_get_controller_info();
651
Vladimir Serbinenko0e646172014-08-31 00:27:05 +0200652 memset(gnvs, 0, sizeof(*gnvs));
Vladimir Serbinenko385743a2014-10-18 02:26:21 +0200653
654 gnvs->apic = 1;
655 gnvs->mpen = 1; /* Enable Multi Processing */
656
Vladimir Serbinenko0e646172014-08-31 00:27:05 +0200657 acpi_create_gnvs(gnvs);
Vladimir Serbinenkodd2bc3f2014-10-31 09:16:31 +0100658
Nico Huber744d6bd2019-01-12 14:58:20 +0100659 if (gfx) {
660 gnvs->ndid = gfx->ndid;
661 memcpy(gnvs->did, gfx->did, sizeof(gnvs->did));
662 }
Vladimir Serbinenkodd2bc3f2014-10-31 09:16:31 +0100663
Vladimir Serbinenko0e646172014-08-31 00:27:05 +0200664 /* And tell SMI about it */
665 smm_setup_structures(gnvs, NULL, NULL);
666
667 /* Add it to SSDT. */
Vladimir Serbinenko1bad88e2014-11-04 21:20:56 +0100668 acpigen_write_scope("\\");
669 acpigen_write_name_dword("NVSA", (u32) gnvs);
670 acpigen_pop_len();
Vladimir Serbinenko0e646172014-08-31 00:27:05 +0200671 }
672}
673
Arthur Heymansa8a9f342017-12-24 08:11:13 +0100674static const char *lpc_acpi_name(const struct device *dev)
675{
676 return "LPCB";
677}
678
Elyes HAOUAS38f1d132018-09-17 08:44:18 +0200679static void southbridge_fill_ssdt(struct device *device)
Arthur Heymansa8a9f342017-12-24 08:11:13 +0100680{
681 intel_acpi_gen_def_acpi_pirq(device);
682}
683
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000684static struct pci_operations pci_ops = {
Subrata Banik4a0f0712019-03-20 14:29:47 +0530685 .set_subsystem = pci_dev_set_subsystem,
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000686};
687
688static struct device_operations device_ops = {
689 .read_resources = i82801gx_lpc_read_resources,
690 .set_resources = pci_dev_set_resources,
Myles Watson7eac4452010-06-17 16:16:56 +0000691 .enable_resources = pci_dev_enable_resources,
Vladimir Serbinenko0e646172014-08-31 00:27:05 +0200692 .acpi_inject_dsdt_generator = southbridge_inject_dsdt,
693 .write_acpi_tables = acpi_write_hpet,
Arthur Heymansa8a9f342017-12-24 08:11:13 +0100694 .acpi_fill_ssdt_generator = southbridge_fill_ssdt,
695 .acpi_name = lpc_acpi_name,
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000696 .init = lpc_init,
Kyösti Mälkkid0e212c2015-02-26 20:47:47 +0200697 .scan_bus = scan_lpc_bus,
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000698 .enable = i82801gx_enable,
699 .ops_pci = &pci_ops,
Arthur Heymans36646472018-01-22 14:42:18 +0100700 .final = lpc_final,
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000701};
702
Damien Zammitef33e032015-11-14 01:03:39 +1100703/* 27b0: 82801GH (ICH7 DH) */
704/* 27b8: 82801GB/GR (ICH7/ICH7R) */
705/* 27b9: 82801GBM/GU (ICH7-M/ICH7-U) */
706/* 27bc: 82NM10 (NM10) */
707/* 27bd: 82801GHM (ICH7-M DH) */
708
709static const unsigned short pci_device_ids[] = {
710 0x27b0, 0x27b8, 0x27b9, 0x27bc, 0x27bd, 0
Stefan Reinauer573f7d42009-07-21 21:50:34 +0000711};
712
Damien Zammitef33e032015-11-14 01:03:39 +1100713static const struct pci_driver ich7_lpc __pci_driver = {
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000714 .ops = &device_ops,
715 .vendor = PCI_VENDOR_ID_INTEL,
Damien Zammitef33e032015-11-14 01:03:39 +1100716 .devices = pci_device_ids,
Stefan Reinauerdebb11f2008-10-29 04:46:52 +0000717};