Finish documenting trainer hill

Trainer hill isn't anywhere close to done, but I figured out enough
to name the VAR. That's all this PR should do.

include/constants/trainer_hill.h

@@ -1,13 +1,13 @@
 #ifndef GUARD_CONSTANTS_TRAINER_HILL_H
 #define GUARD_CONSTANTS_TRAINER_HILL_H
 
-#define TRAINER_HILL_FUNC_0 0
+#define TRAINER_HILL_FUNC_START 0
 #define TRAINER_HILL_FUNC_1 1
 #define TRAINER_HILL_FUNC_2 2
 #define TRAINER_HILL_FUNC_3 3
-#define TRAINER_HILL_FUNC_4 4
-#define TRAINER_HILL_FUNC_5 5
-#define TRAINER_HILL_FUNC_6 6
+#define TRAINER_HILL_FUNC_RESUME_TIMER 4
+#define TRAINER_HILL_FUNC_SET_LOST 5
+#define TRAINER_HILL_FUNC_GET_CHALLENGE_STATUS 6
 #define TRAINER_HILL_FUNC_7 7
 #define TRAINER_HILL_FUNC_8 8
 #define TRAINER_HILL_FUNC_9 9
@@ -18,6 +18,12 @@
 #define TRAINER_HILL_FUNC_14 14
 #define TRAINER_HILL_FUNC_15 15
 #define TRAINER_HILL_FUNC_16 16
-#define TRAINER_HILL_FUNC_17 17
+#define TRAINER_HILL_FUNC_SET_TAG 17
+
+// Values returned by the TrainerHillGetChallengeStatus
+// function.
+#define TRAINER_HILL_PLAYER_STATUS_LOST 0
+#define TRAINER_HILL_PLAYER_STATUS_ECARD_SCANNED 1
+#define TRAINER_HILL_PLAYER_STATUS_NORMAL 2
 
 #endif

include/constants/vars.h

@@ -230,7 +230,7 @@
 #define VAR_0x40D3                           0x40D3
 #define VAR_SS_TIDAL_SCOTT_STATE             0x40D4 // Always equal to FLAG_MET_SCOTT_ON_SS_TIDAL
 #define VAR_ROAMER_POKEMON                   0x40D5 // 0 = Latias, 1 = Latios
-#define VAR_0x40D6                           0x40D6
+#define VAR_TRAINER_HILL_IS_ACTIVE           0x40D6
 #define VAR_0x40D7                           0x40D7
 #define VAR_0x40D8                           0x40D8
 #define VAR_0x40D9                           0x40D9

include/global.h

@@ -796,14 +796,14 @@ struct TrainerNameRecord
 struct SaveTrainerHill
 {
     /*0x3D64*/ u32 timer;
-    /*0x3D68*/ u32 field_3D68;
+    /*0x3D68*/ u32 bestTime;
     /*0x3D6C*/ u8 field_3D6C;
     /*0x3D6D*/ u8 unused;
     /*0x3D6E*/ u16 field_3D6E_0a:1; // 1
     /*0x3D6E*/ u16 field_3D6E_0b:1; // 2
     /*0x3D6E*/ u16 field_3D6E_0c:1; // 4
     /*0x3D6E*/ u16 hasLost:1; // 8
-    /*0x3D6E*/ u16 field_3D6E_0e:1; // x10
+    /*0x3D6E*/ u16 maybeECardScanDuringChallenge:1; // x10
     /*0x3D6E*/ u16 field_3D6E_0f:1; // x20
     /*0x3D6E*/ u16 tag:2; // x40, x80 = xC0
 };