Document the main function better

src/main.c

 
 
 /*
- * RC5 timing macros (microseconds)
+ * RC5 timing macros (microseconds, unless otherwise specified)
  */
 #define RC5_PULSE_LENGTH 889
+#define RC5_CODE_SPACE_MS 90 /* Milliseconds */
 
 /*
  * NEC timing macros (tenths of a millisecond)
     /* Configure GPT */
     gptStart(&GPTD4, &gpt4cfg);
 
-    /* Send a continuous stream of power off signals to the TV */
     while (true) {
+        /* If an NEC power signal was received */
         if (nec_addr == 0x80 && nec_data == 0x18) {
+            /* Turn on the LED */
             palClearPad(GPIOC, GPIOC_LED);
+
+            /* Wait to see if another code arrives */
             if (chEvtWaitAnyTimeout(ALL_EVENTS, MS2ST(200))) {
+                /* If one does, keep waiting so as not to interfere */
                 continue;
             }
+
+            /* Send the RC5 power signal */
             for (int i = 0; i < 3; i++) {
                 rc5_frame(false, 0x00, 0x0C);
-                chThdSleepMilliseconds(90);
+                chThdSleepMilliseconds(RC5_CODE_SPACE_MS);
             }
+
+            /* Turn off the LED */
             palSetPad(GPIOC, GPIOC_LED);
         }
+        /* Wait for a signal */
         chEvtWaitAny(ALL_EVENTS);
     }
 }