Add a test to determine if you can read data from an LCD correctly

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3974 42af7a65-404d-4744-a932-0658087f49c3

2 files changed, 367 insertions, 0 deletions

diff --git a/apps/examples/lcdrw/Makefile b/apps/examples/lcdrw/Makefile
new file mode 100644
index 000000000..053c62670
--- /dev/null
+++ b/apps/examples/lcdrw/Makefile
@@ -0,0 +1,105 @@
+############################################################################
+# apps/examples/lcdrw/Makefile
+#
+#   Copyright (C) 2011 Gregory Nutt. All rights reserved.
+#   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in
+#    the documentation and/or other materials provided with the
+#    distribution.
+# 3. Neither the name NuttX nor the names of its contributors may be
+#    used to endorse or promote products derived from this software
+#    without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+# OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+############################################################################
+
+-include $(TOPDIR)/.config
+-include $(TOPDIR)/Make.defs
+include $(APPDIR)/Make.defs
+
+# LCD Read/Write Test
+
+ASRCS		=
+CSRCS		= lcdrw_main.c
+
+AOBJS		= $(ASRCS:.S=$(OBJEXT))
+COBJS		= $(CSRCS:.c=$(OBJEXT))
+
+SRCS		= $(ASRCS) $(CSRCS)
+OBJS		= $(AOBJS) $(COBJS)
+
+ifeq ($(WINTOOL),y)
+  BIN		= "${shell cygpath -w  $(APPDIR)/libapps$(LIBEXT)}"
+else
+  BIN		= "$(APPDIR)/libapps$(LIBEXT)"
+endif
+
+ROOTDEPPATH	= --dep-path .
+
+# LCD R/W built-in application info
+ 
+APPNAME		= lcdrw
+PRIORITY	= SCHED_PRIORITY_DEFAULT
+STACKSIZE	= 2048
+
+# Common build
+
+VPATH		= 
+
+all: .built
+.PHONY: clean depend distclean
+
+$(AOBJS): %$(OBJEXT): %.S
+	$(call ASSEMBLE, $<, $@)
+
+$(COBJS): %$(OBJEXT): %.c
+	$(call COMPILE, $<, $@)
+
+.built: $(OBJS)
+	@( for obj in $(OBJS) ; do \
+		$(call ARCHIVE, $(BIN), $${obj}); \
+	done ; )
+	@touch .built
+
+.context:
+ifeq ($(CONFIG_EXAMPLES_LCDRW_BUILTIN),y)
+	$(call REGISTER,$(APPNAME),$(PRIORITY),$(STACKSIZE),$(APPNAME)_main)
+	@touch $@
+endif
+
+context: .context
+
+.depend: Makefile $(SRCS)
+	@$(MKDEP) $(ROOTDEPPATH) $(CC) -- $(CFLAGS) -- $(SRCS) >Make.dep
+	@touch $@
+
+depend: .depend
+
+clean:
+	@rm -f *.o *~ .*.swp .built
+	$(call CLEAN)
+
+distclean: clean
+	@rm -f Make.dep .depend
+
+-include Make.dep
diff --git a/apps/examples/lcdrw/lcdrw_main.c b/apps/examples/lcdrw/lcdrw_main.c
new file mode 100644
index 000000000..4b717666f
--- /dev/null
+++ b/apps/examples/lcdrw/lcdrw_main.c
@@ -0,0 +1,262 @@
+/****************************************************************************
+ * examples/lcdrw/lcdrw_main.c
+ *
+ *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ * 3. Neither the name NuttX nor the names of its contributors may be
+ *    used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ ****************************************************************************/
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <stdio.h>
+#include <stdlib.h>
+
+#include <nuttx/lcd/lcd.h>
+#include <nuttx/nx/nxglib.h>
+
+/****************************************************************************
+ * Definitions
+ ****************************************************************************/
+/* Configuration ************************************************************/
+/* Most of the NX configuration settings are probbably *not* needed by this
+ * example.  But, presumeably you are using NX too and so the checks might
+ * be good for you.
+ */
+
+#ifndef CONFIG_NX
+#  error "CONFIG_NX must be defined to use this test"
+#endif
+
+#ifndef CONFIG_NX_LCDDRIVER
+#  error "CONFIG_NX_LCDDRIVER must be defined to use this test"
+#endif
+
+#ifndef CONFIG_EXAMPLES_LCDRW_BPP
+#  define CONFIG_EXAMPLES_LCDRW_BPP 16
+#endif
+
+#if CONFIG_EXAMPLES_LCDRW_BPP != 16
+#  error "Currently only RGB565 is supported -- feel free to extend"
+#endif
+
+#ifdef CONFIG_NX_DISABLE_16BPP
+#  error "CONFIG_NX_DISABLE_16BPP disables 16-bit support"
+#endif
+
+#ifndef CONFIG_EXAMPLES_LDCRW_DEVNO
+#  define CONFIG_EXAMPLES_LDCRW_DEVNO 0
+#endif
+
+#ifndef CONFIG_EXAMPLES_LDCRW_XRES
+#  define CONFIG_EXAMPLES_LDCRW_XRES 240
+#endif
+
+#ifndef CONFIG_EXAMPLES_LDCRW_YRES
+#  define CONFIG_EXAMPLES_LDCRW_YRES 320
+#endif
+
+/****************************************************************************
+ * Private Types
+ ****************************************************************************/
+
+struct lcdrw_instance_s
+{
+  /* LCD device handle and planeinfo */
+
+  FAR struct lcd_dev_s *dev;
+  struct lcd_planeinfo_s pinfo;
+};
+
+/****************************************************************************
+ * Private Data
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+/****************************************************************************
+ * Name: lcdrw_initialize
+ ****************************************************************************/
+
+static inline int lcdrw_initialize(FAR struct lcdrw_instance_s *inst)
+{
+  int ret;
+
+  /* Initialize the LCD device */
+
+  printf("screens_initialize: Initializing LCD\n");
+  ret = up_lcdinitialize();
+  if (ret < 0)
+    {
+      fprintf(stderr, "screens_initialize: up_lcdinitialize failed: %d\n", -ret);
+      return ret;
+    }
+
+  /* Get the device instance. */
+
+  printf("Get LCD instance\n");
+  inst->dev = up_lcdgetdev(CONFIG_EXAMPLES_LDCRW_DEVNO);
+  if (!inst->dev)
+    {
+      fprintf(stderr, "up_lcdgetdev failed, devno=%d\n", CONFIG_EXAMPLES_LDCRW_DEVNO);
+      return ret;
+    }
+
+  /* Turn the LCD on at 75% power.  This should not be necessary. */
+
+  (void)inst->dev->setpower(inst->dev, ((3*CONFIG_LCD_MAXPOWER + 3)/4));
+
+  /* Get the planeinfo structure */
+
+  ret = inst->dev->getplaneinfo(inst->dev, 0, &inst->pinfo);
+  if (ret < 0)
+    {
+      fprintf(stderr, "getplaneinfo failed: %d\n", ret);
+    }
+  return ret;
+}
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: lcdrw_main/user_start
+ ****************************************************************************/
+
+#ifdef CONFIG_EXAMPLES_LCDRW_BUILTIN
+#  define MAIN_NAME lcdrw_main
+#else
+#  define MAIN_NAME user_start
+#endif
+
+int MAIN_NAME(int argc, char *argv[])
+{
+  struct lcdrw_instance_s inst;
+  nxgl_coord_t row;
+  nxgl_coord_t col;
+  uint16_t value;
+  uint32_t offset;
+  FAR uint16_t *ptr;
+  int ret;
+
+  /* Initialize the LCD driver */
+
+  ret = lcdrw_initialize(&inst);
+  if (ret < 0)
+    {
+      exit(1);
+    }
+
+  /* Then read each line from the LCD and write to the TIFF file */
+
+  value = 0;
+  for (row = 0; row < CONFIG_EXAMPLES_LDCRW_YRES; row++)
+    {
+      /* Create a dummy row.  The important thing is to try all
+       * bit combinations in a predictable way.
+       */
+  
+       ptr = (FAR uint16_t*)inst.pinfo.buffer;
+       for (col = 0; col < CONFIG_EXAMPLES_LDCRW_XRES; col++)
+         {
+           *ptr++ = value++;
+         }
+
+      /* Write the row to the LCD */
+
+      ret = inst.pinfo.putrun(row, 0, inst.pinfo.buffer,
+                              CONFIG_EXAMPLES_LDCRW_XRES);
+      if (ret < 0)
+        {
+          fprintf(stderr, "putrun failed: %d\n", ret);
+          exit(1);
+        }
+    }
+
+  /* Print a header */
+
+  printf("       ");
+  for (col = 0; col < 15; col++)
+    {
+      printf("---%x ", col);
+    }
+  printf("---f\n");
+
+   /* Then read each line back from the LCD (this would hook into
+    * the TIFF file creation library *very* easily to create a 
+    * TIFF file of the returned values).
+    */
+
+  offset = 0;
+  for (row = 0; row < CONFIG_EXAMPLES_LDCRW_YRES; row++)
+    {
+      /* Read the row */
+ 
+      ret = inst.pinfo.getrun(row, 0, inst.pinfo.buffer,
+                              CONFIG_EXAMPLES_LDCRW_XRES);
+      if (ret < 0)
+        {
+          fprintf(stderr, "getrun failed: %d\n", ret);
+          exit(1);
+        }
+
+      /* Then dump the row to the display */
+
+      ptr = (FAR uint16_t*)inst.pinfo.buffer;
+      for (col = 0; col < CONFIG_EXAMPLES_LDCRW_XRES; col++)
+        {
+          if ((offset & 15) == 0)
+            {
+              printf("%06x ", offset);
+            }
+
+          value = *ptr++;
+          offset++;
+
+          if ((offset & 15) == 0)
+            {
+              printf("%04x\n", value);
+            }
+          else
+            {
+              printf("%04x ", value);
+            }
+        }
+    }
+  fflush(stdout);
+
+  return 0;
+}
+