Better documentation for GPIO settings

src/board/system76/galp3-c/gpio.c

@@ -1,6 +1,12 @@
 #include <board/gpio.h>
 #include <common/debug.h>
 
+#define GPIO_ALT 0x00
+#define GPIO_IN 0x80
+#define GPIO_OUT 0x40
+#define GPIO_UP 0x04
+#define GPIO_DOWN 0x02
+
 void gpio_init() {
     // Enable LPC reset on GPD2
     GCR = 0x04;
@@ -18,93 +24,180 @@ void gpio_init() {
     GPDRJ = 0;
 
     // Set GPIO control
-    GPCRA0 = 0x80;
+    // EC_SSD_LED#
-    GPCRA1 = 0x00;
+    GPCRA0 = GPIO_IN;
-    GPCRA2 = 0x00;
+    // KBC_BEEP
-    GPCRA3 = 0x80;
+    GPCRA1 = GPIO_ALT;
-    GPCRA4 = 0x40;
+    // CPU_FAN
-    GPCRA5 = 0x44;
+    GPCRA2 = GPIO_ALT;
-    GPCRA6 = 0x44;
+    // PCH_DPWROK_EC
-    GPCRA7 = 0x44;
+    GPCRA3 = GPIO_IN;
-    GPCRB0 = 0x44;
+    // PCH_PWROK_EC
-    GPCRB1 = 0x44;
+    GPCRA4 = GPIO_OUT;
-    GPCRB2 = 0x84;
+    // LED_BAT_CHG
-    GPCRB3 = 0x00;
+    GPCRA5 = GPIO_OUT | GPIO_UP;
-    GPCRB4 = 0x00;
+    // LED_BAT_FULL
-    GPCRB5 = 0x44;
+    GPCRA6 = GPIO_OUT | GPIO_UP;
-    GPCRB6 = 0x84;
+    // LED_PWR
-    GPCRB7 = 0x80;
+    GPCRA7 = GPIO_OUT | GPIO_UP;
-    GPCRC0 = 0x80;
+    // NC
-    GPCRC1 = 0x84;
+    GPCRB0 = GPIO_OUT | GPIO_UP;
-    GPCRC2 = 0x84;
+    // H_PROCHOT_EC
-    GPCRC3 = 0x84;
+    GPCRB1 = GPIO_OUT | GPIO_UP;
-    GPCRC4 = 0x44;
+    // LAN_WAKEUP#
-    GPCRC5 = 0x44;
+    GPCRB2 = GPIO_IN | GPIO_UP;
-    GPCRC6 = 0x40;
+    // SMC_BAT
-    GPCRC7 = 0x44;
+    GPCRB3 = GPIO_ALT;
-    GPCRD0 = 0x84;
+    // SMD_BAT
-    GPCRD1 = 0x84;
+    GPCRB4 = GPIO_ALT;
-    GPCRD2 = 0x00;
+    // GA20
-    GPCRD3 = 0x80;
+    GPCRB5 = GPIO_OUT | GPIO_UP;
-    GPCRD4 = 0x80;
+    // AC_IN#
-    GPCRD5 = 0x44;
+    GPCRB6 = GPIO_IN | GPIO_UP;
-    GPCRD6 = 0x80;
+    // FP_RST#
-    GPCRD7 = 0x80;
+    GPCRB7 = GPIO_IN;
-    GPCRE0 = 0x44;
+    // ALL_SYS_PWRGD
-    GPCRE1 = 0x44;
+    GPCRC0 = GPIO_IN;
-    GPCRE2 = 0x80;
+    // SMC_VGA_THERM
-    GPCRE3 = 0x40;
+    GPCRC1 = GPIO_IN | GPIO_UP;
-    GPCRE4 = 0x42;
+    // SMD_VGA_THERM
-    GPCRE5 = 0x40;
+    GPCRC2 = GPIO_IN | GPIO_UP;
-    GPCRE6 = 0x44;
+    // NC
-    GPCRE7 = 0x44;
+    GPCRC3 = GPIO_IN | GPIO_UP;
-    GPCRF0 = 0x80;
+    // CNVI_DET#
-    GPCRF1 = 0x44;
+    GPCRC4 = GPIO_OUT | GPIO_UP;
-    GPCRF2 = 0x84;
+    // NC
-    GPCRF3 = 0x44;
+    GPCRC5 = GPIO_OUT | GPIO_UP;
-    GPCRF4 = 0x00;
+    // PM_PWROK
-    GPCRF5 = 0x00;
+    GPCRC6 = GPIO_OUT;
-    GPCRF6 = 0x00;
+    // LED_ACIN
-    GPCRF7 = 0x80;
+    GPCRC7 = GPIO_OUT | GPIO_UP;
-    GPCRG0 = 0x44;
+    // PWR_SW#
-    GPCRG1 = 0x44;
+    GPCRD0 = GPIO_IN | GPIO_UP;
-    GPCRG2 = 0x40;
+    // LID_SW#
-    GPCRG3 = 0x00;
+    GPCRD1 = GPIO_IN | GPIO_UP;
-    GPCRG4 = 0x00;
+    // BUF_PLT_RST#
-    GPCRG5 = 0x00;
+    GPCRD2 = GPIO_ALT;
-    GPCRG6 = 0x44;
+    // SMI#
-    GPCRG7 = 0x00;
+    GPCRD3 = GPIO_IN;
-    GPCRH0 = 0x00;
+    // SCI#
-    GPCRH1 = 0x80;
+    GPCRD4 = GPIO_IN;
-    GPCRH2 = 0x44;
+    // PWR_BTN#
-    GPCRH3 = 0x44;
+    GPCRD5 = GPIO_OUT | GPIO_UP;
-    GPCRH4 = 0x80;
+    // CPU_FANSEN
-    GPCRH5 = 0x44;
+    GPCRD6 = GPIO_IN;
-    GPCRH6 = 0x80;
+    // SUSWARN#
-    GPCRH7 = 0x80;
+    GPCRD7 = GPIO_IN;
-    GPCRI0 = 0x00;
+    // SWI#
-    GPCRI1 = 0x00;
+    GPCRE0 = GPIO_OUT | GPIO_UP;
-    GPCRI2 = 0x80;
+    // EC_EN
-    GPCRI3 = 0x00;
+    GPCRE1 = GPIO_OUT | GPIO_UP;
-    GPCRI4 = 0x00;
+    // PCH_SLP_WLAN#_R
-    GPCRI5 = 0x80;
+    GPCRE2 = GPIO_IN;
-    GPCRI6 = 0x80;
+    // VA_EC_EN
-    GPCRI7 = 0x80;
+    GPCRE3 = GPIO_OUT;
-    GPCRJ0 = 0x82;
+    // DD_ON
-    GPCRJ1 = 0x80;
+    GPCRE4 = GPIO_OUT | GPIO_DOWN;
-    GPCRJ2 = 0x40;
+    // EC_RSMRST#
-    GPCRJ3 = 0x80;
+    GPCRE5 = GPIO_OUT;
-    GPCRJ4 = 0x44;
+    // SB_KBCRST#
-    GPCRJ5 = 0x40;
+    GPCRE6 = GPIO_OUT | GPIO_UP;
-    GPCRJ6 = 0x44;
+    // AC_PRESENT / PM_PWROK
-    GPCRJ7 = 0x80;
+    GPCRE7 = GPIO_OUT | GPIO_UP;
-    GPCRM0 = 0x00;
+    // 80CLK
-    GPCRM1 = 0x00;
+    GPCRF0 = GPIO_IN;
-    GPCRM2 = 0x00;
+    // USB_CHARGE_EN
-    GPCRM3 = 0x00;
+    GPCRF1 = GPIO_OUT | GPIO_UP;
-    GPCRM4 = 0x00;
+    // 3IN1
-    GPCRM5 = 0x00;
+    GPCRF2 = GPIO_IN | GPIO_UP;
-    GPCRM6 = 0x00;
+    // BT_EN
+    GPCRF3 = GPIO_OUT | GPIO_UP;
+    // TP_CLK
+    GPCRF4 = GPIO_ALT;
+    // TP_DATA
+    GPCRF5 = GPIO_ALT;
+    // H_PECI
+    GPCRF6 = GPIO_ALT;
+    // USB_PWR_EN#
+    GPCRF7 = GPIO_IN;
+    // CCD_EN
+    GPCRG0 = GPIO_OUT | GPIO_UP;
+    // 3G_EN
+    GPCRG1 = GPIO_OUT | GPIO_UP;
+    // VDD3
+    GPCRG2 = GPIO_OUT;
+    // HSPI_CE#
+    GPCRG3 = GPIO_ALT;
+    // HSPI_MSI
+    GPCRG4 = GPIO_ALT;
+    // HSPI_MSO
+    GPCRG5 = GPIO_ALT;
+    // AIRPLAN_LED#
+    GPCRG6 = GPIO_OUT | GPIO_UP;
+    // HCPI_SCLK
+    GPCRG7 = GPIO_ALT;
+    // EC_CLKRUN#
+    GPCRH0 = GPIO_ALT;
+    // SUSC#_PCH
+    GPCRH1 = GPIO_IN;
+    // BKL_EN
+    GPCRH2 = GPIO_OUT | GPIO_UP;
+    // NC
+    GPCRH3 = GPIO_OUT | GPIO_UP;
+    // VR_ON
+    GPCRH4 = GPIO_IN;
+    // WLAN_EN
+    GPCRH5 = GPIO_OUT | GPIO_UP;
+    // SUSB#_PCH
+    GPCRH6 = GPIO_IN;
+    // Unknown
+    GPCRH7 = GPIO_IN;
+    // BAT_DET
+    GPCRI0 = GPIO_ALT;
+    // BAT_VOLT
+    GPCRI1 = GPIO_ALT;
+    // SLP_SUS#
+    GPCRI2 = GPIO_IN;
+    // THERM_VOLT
+    GPCRI3 = GPIO_ALT;
+    // TOTAL_CUR
+    GPCRI4 = GPIO_ALT;
+    // AZ_RST#_EC
+    GPCRI5 = GPIO_IN;
+    // LIGHT_KB_DET#
+    GPCRI6 = GPIO_IN;
+    // MODEL_ID
+    GPCRI7 = GPIO_IN;
+    // SUS_PWR_ACK
+    GPCRJ0 = GPIO_IN | GPIO_DOWN;
+    // KBC_MUTE#
+    GPCRJ1 = GPIO_IN;
+    // ME_WE
+    GPCRJ2 = GPIO_OUT;
+    // SOC_TYPE
+    GPCRJ3 = GPIO_IN;
+    // WLAN_PWR_EN
+    GPCRJ4 = GPIO_OUT | GPIO_UP;
+    // KBLIGHT_ADJ
+    GPCRJ5 = GPIO_OUT;
+    // 3G_PWR_EN
+    GPCRJ6 = GPIO_OUT | GPIO_UP;
+    // NC
+    GPCRJ7 = GPIO_IN;
+    // LPC_AD0
+    GPCRM0 = GPIO_ALT;
+    // LPC_AD1
+    GPCRM1 = GPIO_ALT;
+    // LPC_AD2
+    GPCRM2 = GPIO_ALT;
+    // LPC_AD3
+    GPCRM3 = GPIO_ALT;
+    // PCLK_KBC
+    GPCRM4 = GPIO_ALT;
+    // LPC_FRAME#
+    GPCRM5 = GPIO_ALT;
+    // SERIRQ
+    GPCRM6 = GPIO_ALT;
 }
 
 #if GPIO_DEBUG