Implement am7xxx_set_power_mode()

[libam7xxx.git] / src / am7xxx.h

diff --git a/src/am7xxx.h b/src/am7xxx.h
index 0926d34..6847796 100644 (file)
--- a/src/am7xxx.h
+++ b/src/am7xxx.h
@@ -36,17 +36,25 @@ typedef enum {
 } am7xxx_packet_type;
 
 typedef enum {
-       AM7XXX_IMAGE_FORMAT_JPEG     = 1,
-       AM7XXX_IMAGE_FORMAT_YUV_NV12 = 2,
+       AM7XXX_IMAGE_FORMAT_JPEG = 1,
+       AM7XXX_IMAGE_FORMAT_NV12 = 2,
 } am7xxx_image_format;
 
 typedef enum {
-       AM7XXX_POWER_OFF  = 0,
-       AM7XXX_POWER_LOW  = 1,
-       AM7XXX_POWER_MID  = 2,
-       AM7XXX_POWER_HIGH = 3,
+       AM7XXX_POWER_OFF    = 0,
+       AM7XXX_POWER_LOW    = 1,
+       AM7XXX_POWER_MIDDLE = 2,
+       AM7XXX_POWER_HIGH   = 3,
+       AM7XXX_POWER_TURBO  = 4,
 } am7xxx_power_mode;
 
+struct am7xxx_generic_header {
+       uint32_t field0;
+       uint32_t field1;
+       uint32_t field2;
+       uint32_t field3;
+};
+
 struct am7xxx_image_header {
        uint32_t format;
        uint32_t width;
@@ -55,9 +63,9 @@ struct am7xxx_image_header {
 };
 
 struct am7xxx_power_header {
-       uint32_t power_low;
-       uint32_t power_mid;
-       uint32_t power_high;
+       uint32_t bit2;
+       uint32_t bit1;
+       uint32_t bit0;
 };
 
 /*
@@ -70,6 +78,12 @@ struct am7xxx_power_header {
  * 04 00 00 00 00 0c ff ff 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
  */
 
+/* The header size on the wire is known to be always 24 bytes, regardless of
+ * the memory configuration enforced by different architechtures or compilers
+ * for struct am7xxx_header
+ */
+#define AM7XXX_HEADER_WIRE_SIZE 24
+
 struct am7xxx_header {
        uint32_t packet_type;
        uint8_t unknown0;
@@ -77,6 +91,7 @@ struct am7xxx_header {
        uint8_t unknown2;
        uint8_t unknown3;
        union {
+               struct am7xxx_generic_header data;
                struct am7xxx_image_header image;
                struct am7xxx_power_header power;
        } header_data;
@@ -93,6 +108,14 @@ int am7xxx_send_image(am7xxx_device dev,
                      uint8_t *image,
                      unsigned int size);
 
+/*
+ * NOTE: if we set the mode to AM7XXX_POWER_OFF we can't turn the
+ * display on again by using only am7xxx_set_power_mode().
+ *
+ * Remember to mention that when writing the API doc.
+ */
+int am7xxx_set_power_mode(am7xxx_device dev, am7xxx_power_mode mode);
+
 #ifdef __cplusplus
 }
 #endif