Implement am7xxx_set_power_mode()

[libam7xxx.git] / src / am7xxx.h

diff --git a/src/am7xxx.h b/src/am7xxx.h
index d8d69d7..6847796 100644 (file)
--- a/src/am7xxx.h
+++ b/src/am7xxx.h
@@ -1,10 +1,10 @@
 /* am7xxx - communication with AM7XXX based USB Pico Projectors and DPFs
  *
 /* am7xxx - communication with AM7XXX based USB Pico Projectors and DPFs
  *

- * Copyright (C) 2011  Antonio Ospite <ospite@studenti.unina.it>
+ * Copyright (C) 2012  Antonio Ospite <ospite@studenti.unina.it>

  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by

- * the Free Software Foundation, either version 3 of the License, or
+ * the Free Software Foundation, either version 2 of the License, or

  * (at your option) any later version.
  *
  * This program is distributed in the hope that it will be useful,
  * (at your option) any later version.
  *
  * This program is distributed in the hope that it will be useful,


@@ -22,6 +22,10 @@
 #include <stdint.h>
 #include <libusb-1.0/libusb.h>
 
 #include <stdint.h>
 #include <libusb-1.0/libusb.h>
 

+#ifdef __cplusplus
+extern "C" {
+#endif
+

 typedef libusb_device_handle *am7xxx_device;
 
 typedef enum {
 typedef libusb_device_handle *am7xxx_device;
 
 typedef enum {


@@ -33,15 +37,24 @@ typedef enum {
 
 typedef enum {
        AM7XXX_IMAGE_FORMAT_JPEG = 1,
 
 typedef enum {
        AM7XXX_IMAGE_FORMAT_JPEG = 1,

+       AM7XXX_IMAGE_FORMAT_NV12 = 2,

 } am7xxx_image_format;
 
 typedef enum {
 } 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;
 
 } 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;
 struct am7xxx_image_header {
        uint32_t format;
        uint32_t width;


@@ -50,9 +63,9 @@ struct am7xxx_image_header {
 };
 
 struct am7xxx_power_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;

 };
 
 /*
 };
 
 /*


@@ -65,19 +78,27 @@ 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
  */
 
  * 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;
 struct am7xxx_header {
        uint32_t packet_type;
        uint8_t unknown0;

-       uint8_t header_len;
+       uint8_t header_data_len;

        uint8_t unknown2;
        uint8_t unknown3;
        union {
        uint8_t unknown2;
        uint8_t unknown3;
        union {

+               struct am7xxx_generic_header data;

                struct am7xxx_image_header image;
                struct am7xxx_power_header power;
        } header_data;
 };
 
 am7xxx_device am7xxx_init(void);
                struct am7xxx_image_header image;
                struct am7xxx_power_header power;
        } header_data;
 };
 
 am7xxx_device am7xxx_init(void);

+

 void am7xxx_shutdown(am7xxx_device dev);
 
 int am7xxx_send_image(am7xxx_device dev,
 void am7xxx_shutdown(am7xxx_device dev);
 
 int am7xxx_send_image(am7xxx_device dev,


@@ -87,4 +108,16 @@ int am7xxx_send_image(am7xxx_device dev,
                      uint8_t *image,
                      unsigned int size);
 
                      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
+

 #endif /* __AM7XXX_H */
 #endif /* __AM7XXX_H */