doc: update the list of supported devices

[libam7xxx.git] / examples / picoproj.c

diff --git a/examples/picoproj.c b/examples/picoproj.c
index c3b199c..8503612 100644 (file)
--- a/examples/picoproj.c
+++ b/examples/picoproj.c
@@ -16,10 +16,14 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 

+/**
+ * @example examples/picoproj.c
+ * A minimal example to show how to use libam7xxx to display a static image.
+ */
+

 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>

-#include <sys/mman.h>

 #include <sys/types.h>
 #include <sys/stat.h>
 #include <fcntl.h>
 #include <sys/types.h>
 #include <sys/stat.h>
 #include <fcntl.h>


@@ -32,14 +36,18 @@ static void usage(char *name)
        printf("usage: %s [OPTIONS]\n\n", name);
        printf("OPTIONS:\n");
        printf("\t-f <filename>\t\tthe image file to upload\n");
        printf("usage: %s [OPTIONS]\n\n", name);
        printf("OPTIONS:\n");
        printf("\t-f <filename>\t\tthe image file to upload\n");

-       printf("\t-F <format>\t\tthe image format to use (default is JPEG).\n");
+       printf("\t-F <format>\t\tthe image format to use (default is JPEG)\n");

        printf("\t\t\t\tSUPPORTED FORMATS:\n");
        printf("\t\t\t\t\t1 - JPEG\n");
        printf("\t\t\t\tSUPPORTED FORMATS:\n");
        printf("\t\t\t\t\t1 - JPEG\n");

-       printf("\t\t\t\t\t2 - YUV - NV12\n");
+       printf("\t\t\t\t\t2 - NV12\n");

        printf("\t-l <log level>\t\tthe verbosity level of libam7xxx output (0-5)\n");
        printf("\t-l <log level>\t\tthe verbosity level of libam7xxx output (0-5)\n");

+       printf("\t-p <power level>\tpower level of device, between %x (off) and %x (maximum)\n", AM7XXX_POWER_OFF, AM7XXX_POWER_TURBO);
+       printf("\t\t\t\tWARNING: Level 2 and greater require the master AND\n\t\t\t\t\t the slave connector to be plugged in.\n");

        printf("\t-W <image width>\tthe width of the image to upload\n");
        printf("\t-H <image height>\tthe height of the image to upload\n");
        printf("\t-h \t\t\tthis help message\n");
        printf("\t-W <image width>\tthe width of the image to upload\n");
        printf("\t-H <image height>\tthe height of the image to upload\n");
        printf("\t-h \t\t\tthis help message\n");

+       printf("\n\nEXAMPLE OF USE:\n");
+       printf("\t%s -f file.jpg -F 1 -l 5 -W 800 -H 480\n", name);

 }
 
 int main(int argc, char *argv[])
 }
 
 int main(int argc, char *argv[])


@@ -49,11 +57,12 @@ int main(int argc, char *argv[])
        int opt;
 
        char filename[FILENAME_MAX] = {0};
        int opt;
 
        char filename[FILENAME_MAX] = {0};

-       int image_fd;
+       FILE *image_fp;

        struct stat st;
        am7xxx_context *ctx;
        am7xxx_device *dev;
        int log_level = AM7XXX_LOG_INFO;
        struct stat st;
        am7xxx_context *ctx;
        am7xxx_device *dev;
        int log_level = AM7XXX_LOG_INFO;

+       am7xxx_power_mode power_mode = AM7XXX_POWER_LOW;

        int format = AM7XXX_IMAGE_FORMAT_JPEG;
        int width = 800;
        int height = 480;
        int format = AM7XXX_IMAGE_FORMAT_JPEG;
        int width = 800;
        int height = 480;


@@ -61,9 +70,11 @@ int main(int argc, char *argv[])
        unsigned int size;
        am7xxx_device_info device_info;
 
        unsigned int size;
        am7xxx_device_info device_info;
 

-       while ((opt = getopt(argc, argv, "f:F:l:W:H:h")) != -1) {
+       while ((opt = getopt(argc, argv, "f:F:l:p:W:H:h")) != -1) {

                switch (opt) {
                case 'f':
                switch (opt) {
                case 'f':

+                       if (filename[0] != '\0')
+                               fprintf(stderr, "Warning: image file already specified\n");

                        strncpy(filename, optarg, FILENAME_MAX);
                        break;
                case 'F':
                        strncpy(filename, optarg, FILENAME_MAX);
                        break;
                case 'F':


@@ -87,6 +98,21 @@ int main(int argc, char *argv[])
                                log_level = AM7XXX_LOG_ERROR;
                        }
                        break;
                                log_level = AM7XXX_LOG_ERROR;
                        }
                        break;

+               case 'p':
+                       power_mode = atoi(optarg);
+                       switch(power_mode) {
+                       case AM7XXX_POWER_OFF:
+                       case AM7XXX_POWER_LOW:
+                       case AM7XXX_POWER_MIDDLE:
+                       case AM7XXX_POWER_HIGH:
+                       case AM7XXX_POWER_TURBO:
+                               fprintf(stdout, "Power mode: %x\n", power_mode);
+                               break;
+                       default:
+                               fprintf(stderr, "Invalid power mode value, must be between %x and %x\n", AM7XXX_POWER_OFF, AM7XXX_POWER_TURBO);
+                               exit(EXIT_FAILURE);
+                       }
+                       break;

                case 'W':
                        width = atoi(optarg);
                        if (width < 0) {
                case 'W':
                        width = atoi(optarg);
                        if (width < 0) {


@@ -117,31 +143,43 @@ int main(int argc, char *argv[])
                goto out;
        }
 
                goto out;
        }
 

-       image_fd = open(filename, O_RDONLY);
-       if (image_fd < 0) {
-               perror("open");
+       image_fp = fopen(filename, "rb");
+       if (image_fp == NULL) {
+               perror("fopen");

                exit_code = EXIT_FAILURE;
                goto out;
        }
                exit_code = EXIT_FAILURE;
                goto out;
        }

-       if (fstat(image_fd, &st) < 0) {
+       if (fstat(fileno(image_fp), &st) < 0) {

                perror("fstat");
                exit_code = EXIT_FAILURE;
                perror("fstat");
                exit_code = EXIT_FAILURE;

-               goto out_close_image_fd;
+               goto out_close_image_fp;

        }
        size = st.st_size;
 
        }
        size = st.st_size;
 

-       image = mmap(NULL, st.st_size, PROT_READ, MAP_SHARED, image_fd, 0);
+       image = malloc(size * sizeof(unsigned char));

        if (image == NULL) {
        if (image == NULL) {

-               perror("mmap");
+               perror("malloc");

                exit_code = EXIT_FAILURE;
                exit_code = EXIT_FAILURE;

-               goto out_close_image_fd;
+               goto out_close_image_fp;
+       }
+
+       ret = fread(image, size, 1, image_fp);
+       if (ret != 1) {
+               if (feof(image_fp))
+                       fprintf(stderr, "Unexpected end of file.\n");
+               else if (ferror(image_fp))
+                       perror("fread");
+               else
+                       fprintf(stderr, "Unexpected error condition.\n");
+
+               goto out_free_image;

        }
 
        ret = am7xxx_init(&ctx);
        if (ret < 0) {
                perror("am7xxx_init");
                exit_code = EXIT_FAILURE;
        }
 
        ret = am7xxx_init(&ctx);
        if (ret < 0) {
                perror("am7xxx_init");
                exit_code = EXIT_FAILURE;

-               goto out_munmap;
+               goto out_free_image;

        }
 
        am7xxx_set_log_level(ctx, log_level);
        }
 
        am7xxx_set_log_level(ctx, log_level);


@@ -170,20 +208,24 @@ int main(int argc, char *argv[])
 
        ret = am7xxx_get_device_info(dev, &device_info);
        if (ret < 0) {
 
        ret = am7xxx_get_device_info(dev, &device_info);
        if (ret < 0) {

-               perror("am7xxx_get_info");
+               perror("am7xxx_get_device_info");

                exit_code = EXIT_FAILURE;
                goto cleanup;
        }
        printf("Native resolution: %dx%d\n",
               device_info.native_width, device_info.native_height);
 
                exit_code = EXIT_FAILURE;
                goto cleanup;
        }
        printf("Native resolution: %dx%d\n",
               device_info.native_width, device_info.native_height);
 

-       ret = am7xxx_set_power_mode(dev, AM7XXX_POWER_LOW);
+       ret = am7xxx_set_power_mode(dev, power_mode);

        if (ret < 0) {
                perror("am7xxx_set_power_mode");
                exit_code = EXIT_FAILURE;
                goto cleanup;
        }
 
        if (ret < 0) {
                perror("am7xxx_set_power_mode");
                exit_code = EXIT_FAILURE;
                goto cleanup;
        }
 

+       if ((unsigned int)width > device_info.native_width ||
+           (unsigned int)height > device_info.native_height)
+               fprintf(stderr, "WARNING: image not fitting the native resolution, it may be displayed wrongly!\n");
+

        ret = am7xxx_send_image(dev, format, width, height, image, size);
        if (ret < 0) {
                perror("am7xxx_send_image");
        ret = am7xxx_send_image(dev, format, width, height, image, size);
        if (ret < 0) {
                perror("am7xxx_send_image");


@@ -196,15 +238,13 @@ int main(int argc, char *argv[])
 cleanup:
        am7xxx_shutdown(ctx);
 
 cleanup:
        am7xxx_shutdown(ctx);
 

-out_munmap:
-       ret = munmap(image, size);
-       if (ret < 0)
-               perror("munmap");
+out_free_image:
+       free(image);

 
 

-out_close_image_fd:
-       ret = close(image_fd);
-       if (ret < 0)
-               perror("close");
+out_close_image_fp:
+       ret = fclose(image_fp);
+       if (ret == EOF)
+               perror("fclose");

 
 out:
        exit(exit_code);
 
 out:
        exit(exit_code);