Logging of clamps, saves and restores

include/helpers.h

@@ -13,7 +13,7 @@
  *    x;
  *  }
  * }*/
-#define LIGHT_CLAMP(x, y, z) ((x<y) ? y : ((x>z) ? z : x ));
+#define LIGHT_CLAMP(x, y, z) ((x<y) ? (light_logInfClamp(y)) : ((x>z) ? (light_logSupClamp(z)) : x ))
 
 #define LIGHT_LOG_FMT_BUF_SIZE 1024
 /* Verbosity levels: 
@@ -84,4 +84,8 @@ LIGHT_BOOL light_isWritable(char const * filename);
 /* Returns TRUE if file is readable, FALSE otherwise */
 LIGHT_BOOL light_isReadable(char const * filename);
 
+double light_logInfClamp(double x);
+
+double light_logSupClamp(double x);
+
 #endif /* LIGHT_HELPERS_H */

src/helpers.c

@@ -207,3 +207,15 @@ LIGHT_BOOL light_isReadable(char const * filename)
   fclose(fileHandle);
   return TRUE;
 }
+
+double light_logInfClamp(double x)
+{
+  LIGHT_NOTE_FMT("specified value is inferior to %g, so adjusting it to this mininum value", x);
+  return x;
+}
+
+double light_logSupClamp(double x)
+{
+  LIGHT_NOTE_FMT("specified value is superior to %g, so adjusting it to this maximum value", x);
+  return x;
+}

src/light.c

@@ -678,6 +678,7 @@ LIGHT_BOOL light_setBrightness(char const *controller, unsigned long v)
     return FALSE;
   }
 
+  LIGHT_NOTE_FMT("setting brightness %lu (raw) to controller", v);
   writeVal = light_writeULong(brightnessPath, v);
 
   if(!writeVal)
@@ -849,6 +850,7 @@ LIGHT_BOOL light_getMinCap(char const * controller, LIGHT_BOOL * hasMinCap, unsi
     *hasMinCap = FALSE;
     *minCap = 0;
     free(mincapPath);
+    LIGHT_NOTE("cap file doesn't exist or can't read from it, so assuming a minimum brightness of 0");
     return TRUE;
   }
 
@@ -874,6 +876,7 @@ LIGHT_BOOL light_setMinCap(char const * controller, unsigned long v)
     return FALSE;
   }
 
+  LIGHT_NOTE_FMT("setting minimum cap to %lu (raw)", v);
   if(!light_writeULong(mincapPath, v))
   {
     LIGHT_ERR("could not write to minimum cap file");
@@ -916,6 +919,7 @@ LIGHT_BOOL light_saveBrightness(char const *controller, unsigned long v){
     return FALSE;
   }
 
+  LIGHT_NOTE_FMT("saving brightness %lu (raw) to save file\n", v);
   if(!light_writeULong(savePath, v))
   {
     LIGHT_ERR("could not write to save/restore file");
@@ -937,6 +941,7 @@ LIGHT_BOOL light_restoreBrightness(char const *controller){
     return FALSE;
   }
 
+  LIGHT_NOTE("restoring brightness from saved file");
   if(!light_readULong(restorePath, &v))
   {
     LIGHT_ERR("could not read saved value");