Fresh import of the PX4 firmware sources.

5 files changed, 1060 insertions, 0 deletions

diff --git a/apps/include/apps.h b/apps/include/apps.h
new file mode 100644
index 000000000..520128203
--- /dev/null
+++ b/apps/include/apps.h
@@ -0,0 +1,149 @@
+/****************************************************************************
+ * apps/include/apps.h
+ *
+ *   Copyright(C) 2011 Uros Platise. All rights reserved.
+ *   Author: Uros Platise <uros.platise@isotel.eu>
+ *
+ * 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.
+ *
+ ****************************************************************************/
+
+#ifndef __APPS_INCLUDE_APPS_H
+#define __APPS_INCLUDE_APPS_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+#include <sys/types.h>
+#include <stdint.h>
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Types
+ ****************************************************************************/
+
+struct namedapp_s
+{
+  const char *name;         /* Invocation name and as seen under /sbin/ */
+  int         priority;     /* Use: SCHED_PRIORITY_DEFAULT */
+  int         stacksize;    /* Desired stack size */
+  main_t      main;         /* Entry point: main(int argc, char *argv[]) */
+};
+
+/****************************************************************************
+ * Public Data
+ ****************************************************************************/
+
+/* The "bindir" is file system that supports access to the named applications.
+ * It is typically mounted under /bin.
+ */
+
+#ifdef CONFIG_APPS_BINDIR
+struct mountpt_operations;
+extern const struct mountpt_operations binfs_operations;
+#endif
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+#undef EXTERN
+#if defined(__cplusplus)
+#define EXTERN extern "C"
+extern "C" {
+#else
+#define EXTERN extern
+#endif
+
+/****************************************************************************
+ * Name: namedapp_isavail
+ *
+ * Description:
+ *   Checks for availabiliy of application registerred during compile time.
+ *
+ * Input Parameter:
+ *   filename - Name of the linked-in binary to be started.
+ *
+ * Returned Value:
+ *   This is an end-user function, so it follows the normal convention:
+ *   Returns index of builtin application. If it is not found then it
+ *   returns -1 (ERROR) and sets errno appropriately.
+ *
+ ****************************************************************************/
+
+EXTERN int namedapp_isavail(FAR const char *appname);
+
+/****************************************************************************
+ * Name: namedapp_getname
+ *
+ * Description:
+ *   Returns pointer to a name of built-in application pointed by the
+ *   index.
+ *
+ * Input Parameter:
+ *   index, from 0 and on ...
+ *
+ * Returned Value:
+ *   Returns valid pointer pointing to the app name if index is valid.
+ *   Otherwise NULL is returned.
+ *
+ ****************************************************************************/
+
+EXTERN const char *namedapp_getname(int index);
+
+/****************************************************************************
+ * Name: exec_namedapp
+ *
+ * Description:
+ *   Executes builtin named application registered during compile time.
+ *   New application is run in a separate task context (and thread).
+ *
+ * Input Parameter:
+ *   filename - Name of the linked-in binary to be started.
+ *   argv     - Argument list
+ *
+ * Returned Value:
+ *   This is an end-user function, so it follows the normal convention:
+ *   Returns the PID of the exec'ed module.  On failure, it.returns
+ *   -1 (ERROR) and sets errno appropriately.
+ *
+ ****************************************************************************/
+
+EXTERN int exec_namedapp(FAR const char *appname, FAR const char **argv);
+
+#undef EXTERN
+#if defined(__cplusplus)
+}
+#endif
+
+#endif /* __APPS_INCLUDE_APPS_H */
diff --git a/apps/include/ftpc.h b/apps/include/ftpc.h
new file mode 100644
index 000000000..f9a73676a
--- /dev/null
+++ b/apps/include/ftpc.h
@@ -0,0 +1,225 @@
+/****************************************************************************
+ * apps/include/ftpc.h
+ *
+ *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
+ *
+ * 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.
+ *
+ ****************************************************************************/
+
+#ifndef __APPS_INCLUDE_FTPC_H
+#define __APPS_INCLUDE_FTPC_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <sys/types.h>
+#include <stdbool.h>
+#include <signal.h>
+#include <time.h>
+
+#include <netinet/in.h>
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+/* Configuration ************************************************************/
+
+#ifndef CONFIG_FTP_DEFTIMEO
+#  define CONFIG_FTP_DEFTIMEO 30
+#endif
+
+#ifndef CONFIG_FTP_ANONPWD
+#  define CONFIG_FTP_ANONPWD ""
+#endif
+
+#ifndef CONFIG_FTP_DEFPORT
+#  define CONFIG_FTP_DEFPORT 21
+#endif
+
+#ifndef CONFIG_FTP_MAXREPLY
+#  define CONFIG_FTP_MAXREPLY 256
+#endif
+
+#ifndef CONFIG_FTP_TMPDIR
+#  define CONFIG_FTP_TMPDIR "/tmp"
+#endif
+
+#ifndef CONFIG_FTP_BUFSIZE
+#  define CONFIG_FTP_BUFSIZE 1024
+#endif
+
+#ifndef CONFIG_FTP_MAXPATH
+#  define CONFIG_FTP_MAXPATH 256
+#endif
+
+#ifndef CONFIG_FTP_SIGNAL
+#  define CONFIG_FTP_SIGNAL SIGUSR1
+#endif
+
+/* Interface arguments ******************************************************/
+/* These definitions describe how a put operation should be performed */
+
+#define FTPC_PUT_NORMAL      0  /* Just PUT the file on the server */
+#define FTPC_PUT_APPEND      1  /* Append file to an existing file on the server */
+#define FTPC_PUT_UNIQUE      2  /* Create a uniquely named file on the server */
+#define FTPC_PUT_RESUME      3  /* Resume a previously started PUT transfer */
+
+/* These definitions describe how a get operation should be performed */
+
+#define FTPC_GET_NORMAL      0  /* Just GET the file from the server */
+#define FTPC_GET_APPEND      1  /* Append new file to an existing file */
+#define FTPC_GET_RESUME      3  /* Resume a previously started GET transfer */
+
+/* Transfer mode encoding */
+
+#define FTPC_XFRMODE_UNKNOWN  0 /* Nothing has been transferred yet */
+#define FTPC_XFRMODE_ASCII    1 /* Last transfer was ASCII mode */
+#define FTPC_XFRMODE_BINARY   2 /* Last transfer was binary mode */
+
+/****************************************************************************
+ * Public Types
+ ****************************************************************************/
+/* This "handle" describes the FTP session */
+
+typedef FAR void *SESSION;
+
+/* This structure provides information to connect to a host FTP server.
+ *
+ * addr - The IPv4 address of the FTP server (or the proxy) for the FTP
+ *        server.
+ * port - The port number on the FTP server to connect to (in host byte
+ *        order).  This is usually port 21 for FTP.  You may set this
+ *        value to zero to let FTPC select the default port number for
+ *        you (it will use CONFIG_FTP_DEFPORT).
+ */
+
+struct ftpc_connect_s
+{
+  struct in_addr  addr;    /* Server/proxy IP address */
+  uint16_t        port;    /* Server/proxy port number (usually 21) in network order */
+};
+
+/* This structure provides FTP login information */
+
+struct ftpc_login_s
+{
+  FAR const char *uname;   /* Login uname */
+  FAR const char *pwd;     /* Login pwd  */
+  FAR const char *rdir;    /* Initial remote directory */
+  bool            pasv;    /* true: passive connection mode */
+};
+
+/* This structure describes one simple directory listing.  The directory
+ * list container as well the individual filename strings are allocated.
+ * The number of names in tha actual allocated array is variable, given
+ * by the nnames field.
+ *
+ * Since the structure and file names are allocated, they must be freed
+ * by calling ftpc_dirfree() when they are no longer needed.  Allocated
+ * name strings maby be "stolen" from the array but the pointer int the
+ * array should be nullified so that the string is not freed by
+ * ftpc_dirfree().
+ */
+
+struct ftpc_dirlist_s
+{
+  unsigned int    nnames;  /* Number of entries in name[] array */
+  FAR char       *name[1]; /* Filename with absolute path */
+};
+
+#define SIZEOF_FTPC_DIRLIST(n) \
+  (sizeof(struct ftpc_dirlist_s) + ((n)-1)*sizeof(FAR char *))
+
+/****************************************************************************
+ * Public Data
+ ****************************************************************************/
+
+#ifdef __cplusplus
+#define EXTERN extern "C"
+extern "C" {
+#else
+#define EXTERN extern
+#endif
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+/* Connection management ****************************************************/
+
+EXTERN SESSION ftpc_connect(FAR struct ftpc_connect_s *server);
+EXTERN void ftpc_disconnect(SESSION handle);
+
+/* FTP commands *************************************************************/
+
+EXTERN int ftpc_login(SESSION handle, FAR struct ftpc_login_s *login);
+EXTERN int ftpc_quit(SESSION handle);
+
+EXTERN int ftpc_chdir(SESSION handle, FAR const char *path);
+EXTERN FAR char *ftpc_rpwd(SESSION handle);
+EXTERN int ftpc_cdup(SESSION handle);
+EXTERN int ftpc_mkdir(SESSION handle, FAR const char *path);
+EXTERN int ftpc_rmdir(SESSION handle, FAR const char *path);
+
+EXTERN int ftpc_unlink(SESSION handle, FAR const char *path);
+EXTERN int ftpc_chmod(SESSION handle, FAR const char *path, FAR const char *mode);
+EXTERN int ftpc_rename(SESSION handle, FAR const char *oldname, FAR const char *newname);
+EXTERN off_t ftpc_filesize(SESSION handle, FAR const char *path);
+EXTERN time_t ftpc_filetime(SESSION handle, FAR const char *filename);
+
+EXTERN int ftpc_idle(SESSION handle, unsigned int idletime);
+EXTERN int ftpc_noop(SESSION handle);
+EXTERN int ftpc_help(SESSION handle, FAR const char *arg);
+
+/* Directory listings *******************************************************/
+
+EXTERN FAR struct ftpc_dirlist_s *ftpc_listdir(SESSION handle,
+                                               FAR const char *dirpath);
+EXTERN void ftpc_dirfree(FAR struct ftpc_dirlist_s *dirlist);
+
+/* File transfers ***********************************************************/
+
+EXTERN int ftpc_getfile(SESSION handle, FAR const char *rname,
+                        FAR const char *lname, uint8_t how, uint8_t xfrmode);
+EXTERN int ftp_putfile(SESSION handle, FAR const char *lname,
+                       FAR const char *rname, uint8_t how, uint8_t xfrmode);
+
+/* FTP response *************************************************************/
+
+EXTERN FAR char *ftpc_response(SESSION handle);
+
+#undef EXTERN
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __APPS_INCLUDE_FTPC_H */
diff --git a/apps/include/nsh.h b/apps/include/nsh.h
new file mode 100644
index 000000000..4b5a3cd31
--- /dev/null
+++ b/apps/include/nsh.h
@@ -0,0 +1,121 @@
+/****************************************************************************
+ * apps/include/nsh.h
+ *
+ *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
+ *
+ * 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.
+ *
+ ****************************************************************************/
+
+#ifndef __APPS_INCLUDE_NSH_H
+#define __APPS_INCLUDE_NSH_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+/****************************************************************************
+ * Pre-Processor Definitions
+ ****************************************************************************/
+
+#if CONFIG_RR_INTERVAL > 0
+# define SCHED_NSH SCHED_RR
+#else
+# define SCHED_NSH SCHED_FIFO
+#endif
+
+/****************************************************************************
+ * Public Data
+ ****************************************************************************/
+
+#ifdef __cplusplus
+#define EXTERN extern "C"
+extern "C" {
+#else
+#define EXTERN extern
+#endif
+
+/****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: nsh_initialize
+ *
+ * Description:
+ *   This nterfaces is used to initialize the NuttShell (NSH).
+ *   nsh_initialize() should be called one during application start-up prior
+ *   to executing either nsh_consolemain() or nsh_telnetstart().
+ *
+ * Input Parameters:
+ *   None
+ *
+ * Returned Value:
+ *   None
+ *
+ ****************************************************************************/
+
+EXTERN void nsh_initialize(void);
+
+/****************************************************************************
+ * Name: nsh_consolemain
+ *
+ * Description:
+ *   This interfaces maybe to called or started with task_start to start a
+ *   single an NSH instance that operates on stdin and stdout (/dev/console).
+ *   This function does not return.
+ *
+ * Input Parameters:
+ *   Standard task start-up arguements.  These are not used.  argc may be
+ *   zero and argv may be NULL.
+ *
+ * Returned Values:
+ *   This function does not normally return.  exit() is usually called to
+ *   terminate the NSH session.  This function will return in the event of
+ *   an error.  In that case, a nonzero value is returned (1).
+ *  
+ ****************************************************************************/
+
+EXTERN int nsh_consolemain(int argc, char *argv[]);
+
+/* nsh_telnetstart() starts a telnet daemon that will allow multiple
+ * NSH connections via telnet.  This function returns immediately after
+ * the daemon has been started.
+ */
+
+EXTERN int nsh_telnetstart(void);
+
+#undef EXTERN
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __APPS_INCLUDE_NSH_H */
diff --git a/apps/include/readline.h b/apps/include/readline.h
new file mode 100644
index 000000000..647778210
--- /dev/null
+++ b/apps/include/readline.h
@@ -0,0 +1,100 @@
+/****************************************************************************
+ * apps/include/readline.h
+ *
+ *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
+ *
+ * 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.
+ *
+ ****************************************************************************/
+
+#ifndef __APPS_INCLUDE_READLINE_H
+#define __APPS_INCLUDE_READLINE_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+/****************************************************************************
+ * Pre-Processor Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Data
+ ****************************************************************************/
+
+#ifdef __cplusplus
+#define EXTERN extern "C"
+extern "C" {
+#else
+#define EXTERN extern
+#endif
+
+/****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: readline
+ *
+ *   readline() reads in at most one less than 'buflen' characters from
+ *   'instream' and stores them into the buffer pointed to by 'buf'.
+ *   Characters are echoed on 'outstream'.  Reading stops after an EOF or a
+ *   newline.  If a newline is read, it is stored into the buffer.  A null
+ *   terminator is stored after the last character in the buffer.
+ *
+ *   This version of realine assumes that we are reading and writing to
+ *   a VT100 console.  This will not work well if 'instream' or 'outstream'
+ *   corresponds to a raw byte steam.
+ *
+ *   This function is inspired by the GNU readline but is an entirely
+ *   different creature.
+ *
+ * Input Parameters:
+ *   buf       - The user allocated buffer to be filled.
+ *   buflen    - the size of the buffer.
+ *   instream  - The stream to read characters from
+ *   outstream - The stream to each characters to.
+ *
+ * Returned values:
+ *   On success, the (positive) number of bytes transferred is returned.
+ *   A length of zero would indicated an end of file condition. An failure,
+ *   a negated errno value is returned.
+ *
+ **************************************************************************/
+
+EXTERN ssize_t readline(FAR char *buf, int buflen, FILE *instream, FILE *outstream);
+
+#undef EXTERN
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __APPS_INCLUDE_READLINE_H */
diff --git a/apps/include/tiff.h b/apps/include/tiff.h
new file mode 100644
index 000000000..378af9fe0
--- /dev/null
+++ b/apps/include/tiff.h
@@ -0,0 +1,465 @@
+/************************************************************************************
+ * apps/include/tiff.h
+ *
+ *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
+ *
+ * Reference:
+ *   "TIFF, Revision 6.0, Final," June 3, 1992, Adobe Developers Association.
+ *
+ * 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.
+ *
+ ************************************************************************************/
+
+#ifndef __APPS_INCLUDE_TIFF_H
+#define __APPS_INCLUDE_TIFF_H
+
+/************************************************************************************
+ * Included Files
+ ************************************************************************************/
+
+#include <nuttx/config.h>
+#include <sys/types.h>
+#include <nuttx/nx/nxglib.h>
+
+/************************************************************************************
+ * Pre-Processor Definitions
+ ************************************************************************************/
+/* Configuration ********************************************************************/
+
+/* TIFF File Format Definitions *****************************************************/
+/* Values for the IFD field type */
+
+#define IFD_FIELD_BYTE              1 /* 8-bit unsigned integer */
+#define IFD_FIELD_ASCII             2 /* 8-bit byte that contains a 7-bit ASCII code.
+                                       * The last byte must be NUL */
+#define IFD_FIELD_SHORT             3 /* 16-bit (2-byte) unsigned integer */
+#define IFD_FIELD_LONG              4 /* 32-bit (4-byte) unsigned integer */
+#define IFD_FIELD_RATIONAL          5 /* Two LONGs: the first represents the
+                                       * numerator of a fraction, the second the
+                                       * denominator */
+#define IFD_FIELD_SBYTE             6 /* An 8-bit signed (twos-complement) integer */
+#define IFD_FIELD_UNDEFINED         7 /* An 8-bit byte that may contain anything,
+                                       * depending on the definition of the field */
+#define IFD_FIELD_SSHORT            8 /* A 16-bit (2-byte) signed (twos-complement)
+                                       * integer */
+#define IFD_FIELD_SLONG             9 /* A 32-bit (4-byte) signed (twos-complement)
+                                       * integer */
+#define IFD_FIELD_SRATIONAL        10 /* Two SLONG’s: the first represents the
+                                       * numerator of a fraction, the second the
+                                       * denominator */
+#define IFD_FIELD_FLOAT            11 /* Single precision (4-byte) IEEE format */
+#define IFD_FIELD_DOUBLE           12 /* Double precision (8-byte) IEEE format */
+
+/* Values for the IFD tag type */
+
+#define IFD_TAG_NEWSUBFILETYPE    254 /* NewSubfileType, LONG */
+#  define TAG_NEWSUBFILETYPE_REDUCED (1 << 0) /* Bit 0: Reduced resolution verson of image */
+#  define TAG_NEWSUBFILETYPE_SINGLE  (1 << 1) /* Bit 1: Single page of a multi-page image */
+#  define TAG_NEWSUBFILETYPE_TRANSP  (1 << 2) /* Bit 2: Defines a transparency mask for image */
+#define IFD_TAG_SUBFILETYPE       255 /* SubfileType, SHORT */
+#  define TAG_SUBFILETYPE_FULL      1 /*   Full-resolution image data */
+#  define TAG_SUBFILETYPE_REDUCED   2 /*   Reduced-resolution image data */
+#  define TAG_SUBFILETYPE_SINGLE    3 /*   Single page of a multi-page image */
+#define IFD_TAG_IMAGEWIDTH        256 /* ImageLength, SHORT or LONG (Required) */
+#define IFD_TAG_IMAGELENGTH       257 /* ImageWidth, SHORT or LONG (Required) */
+#define IFD_TAG_BITSPERSAMPLE     258 /* BitsPerSample, SHORT (Required
+                                       * in greyscale and pallette-color image files) */ 
+#define IFD_TAG_COMPRESSION       259 /* Compression, SHORT (Required) */
+#  define TAG_COMP_NONE             1 /*   No compression */
+#  define TAG_COMP_CCITT            2 /*   CCITT Group 3 1-Dimensional Modified Huffman
+                                       *   run length encoding */
+#  define TAG_COMP_T4               3 /*   CCITT T.4 bi-level encoding */
+#  define TAG_COMP_T6               4 /*   CCITT T.6 bi-level encoding */
+#  define TAG_COMP_LZW              5 /*   LZW */
+#  define TAG_COMP_JPEG             6 /*   LZW */
+#  define TAG_COMP_PACKBITS     32773 /*   PackBits compression */
+#define IFD_TAG_PMI               262 /* PhotometricInterpretation, SHORT (Required) */
+#  define TAG_PMI_WHITE             0 /*   WhiteIsZero */
+#  define TAG_PMI_BLACK             1 /*   BlackIsZero */
+#  define TAG_PMI_RGB               2 /*   RGB */
+#  define TAG_PMI_PALETTE           3 /*   Palette color */
+#  define TAG_PMI_TRANSP            4 /*   Transparency mask */
+#  define TAG_PMI_CMYK              5 /*   CMYK */
+#  define TAG_PMI_YCbCr             6 /*   YCbCr */
+#  define TAG_PMI_CIELAB            8 /*   1976 CIE L*a*b* */
+#define IFD_TAG_THRESHHOLDING     263 /* Threshholding, SHORT */
+#  define TAG_THRESHHOLD_NONE       1 /*   No dithering or halftoning has been applied */
+#  define TAG_THRESHHOLD_ORDERED    2 /*   Ordered dither or halftone technique has been applied */
+#  define TAG_THRESHHOLD_RANDOM     3 /*   Randomized process has been applied */
+#define IFD_TAG_CELLWIDTH         264 /* CellWidth, SHORT */
+#define IFD_TAG_CELLLENGTH        265 /* CellLength, SHORT */
+#define IFD_TAG_FILLORDER         266 /* FillOrder, SHORT */
+#  define TAG_FILLORDER_HIGH        1 /*   Lower column values are stored in the
+                                       *   higher-order bits */
+#  define TAG_FILLORDER_LOW         2 /*   Lower column values are stored in the
+                                       *   lower-order bits */
+#define IFD_TAG_DOCUMENTNAME      269 /* DocumentName, ASCII */
+#define IFD_TAG_IMAGEDESCRIPTION  270 /* ImageDescription, ASCII */
+#define IFD_TAG_MAKE              271 /* Make, ASCII */
+#define IFD_TAG_MODEL             272 /* Model, ASCII */
+#define IFD_TAG_STRIPOFFSETS      273 /* StripOffsets, SHORT or LONG (Required) */
+#define IFD_TAG_ORIENTATION       274 /* Orientation, SHORT */
+#  define TAG_ORIENTATION_TL        1 /*   (0,0)=top left */
+#  define TAG_ORIENTATION_TR        2 /*   (0,0)=top right */
+#  define TAG_ORIENTATION_BR        3 /*   (0,0)=bottom right */
+#  define TAG_ORIENTATION_BL        4 /*   (0,0)=bottom left */
+#  define TAG_ORIENTATION_LT        5 /*   (0,0)=left top */
+#  define TAG_ORIENTATION_RT        6 /*   (0,0)=right top */
+#  define TAG_ORIENTATION_RB        7 /*   (0,0)=right bottom */
+#  define TAG_ORIENTATION_LB        8 /*   (0,0)=left bottom */
+#define IFD_TAG_SAMPLESPERPIXEL   277 /* SamplesPerPixel, SHORT (Required in
+                                       * RGB full color files) */
+#define IFD_TAG_ROWSPERSTRIP      278 /* RowsPerStrip, SHORT or LONG (Required) */
+#define IFD_TAG_STRIPCOUNTS       279 /* StripByteCounts, SHORT or LONG (Required) */
+#define IFD_TAG_MINSAMPLEVALUE    280 /* MinSampleValue, SHORT */
+#define IFD_TAG_MAXSAMPLEVALUE    281 /* MaxSampleValue, SHORT */
+#define IFD_TAG_XRESOLUTION       282 /* XResolution, RATIONAL (Required) */
+#define IFD_TAG_YRESOLUTION       283 /* YResolution, RATIONAL (Required) */
+#define IFD_TAG_PLANARCONFIG      284 /* PlanarConfiguration, SHORT */
+#  define TAG_PLCONFIG_CHUNKY       1 /*   Chunky format */
+#  define TAG_PLCONFIG_PLANAR       2 /*   Planar format */
+#define IFD_TAG_PAGENAME          285 /* PageName, ASCII */
+#define IFD_TAG_XPOSITION         286 /* XPosition, RATIONAL */
+#define IFD_TAG_YPOSITION         287 /* YPosition, RATIONAL */
+#define IFD_TAG_FREEOFFSETS       288 /* FreeOffsets, LONG */
+#define IFD_TAG_FREEBYTECOUNTS    289 /* FreeByteCounts, LONG */
+#define IFD_TAG_GRAYRESPONSEUNIT  290 /* GrayResponseUnit, SHORT */
+#  define TAG_GRAYRESPUNIT_10THS    1 /*   Number represents tenths of a unit */
+#  define TAG_GRAYRESPUNIT_100THS   2 /*   Number represents hundredths of a unit */
+#  define TAG_GRAYRESPUNIT_1KTHS    3 /*   Number represents thousandths of a unit */
+#  define TAG_GRAYRESPUNIT_10KTHS   4 /*   Number represents ten-thousandths of a unit */
+#  define TAG_GRAYRESPUNIT_100KTHS  5 /*   Number represents hundred-thousandths of a unit */
+#define IFD_TAG_GRAYRESPONSECURVE 291 /* GrayResponseCurve, SHORT */
+#define IFD_TAG_T4OPTIONS         292 /* T4Options, LONG */
+#  define TAG_T4OPTIONS_2D        (1 << 0) /*   2-dimensional coding */
+#  define TAG_T4OPTIONS_NONE      (1 << 1) /*   Uncompressed mode */
+#  define TAG_T4OPTIONS_FILL      (1 << 2) /*   Fill bits have been added */
+#define IFD_TAG_T6OPTIONS         293 /* T6Options, LONG */
+#  define TAG_T6OPTIONS_NONE      (1 << 1) /*   Uncompressed mode allowed */
+#define IFD_TAG_RESUNIT           296 /* ResolutionUnit, SHORT (Required) */
+#  define TAG_RESUNIT_NONE          1 /* No absolute unit of measurement */
+#  define TAG_RESUNIT_INCH          2 /* Inch (default) */
+#  define TAG_RESUNIT_CENTIMETER    3 /* Centimeter */
+#define IFD_TAG_PAGENUMBER        297 /* PageNumber, SHORT */
+#define IFD_TAG_TRANSFERFUNCTION  301 /* TransferFunction, SHORT */
+#define IFD_TAG_SOFTWARE          305 /* Software, ASCII */
+#define IFD_TAG_DATETIME          306 /* DateTime, ASCII */
+#define IFD_TAG_ARTIST            315 /* Artist, ASCII */
+#define IFD_TAG_HOSTCOMPUTER      316 /* HostComputer, ASCII */
+#define IFD_TAG_PREDICTOR         317 /* Predictor SHORT */
+#  define TAG_PREDICTOR_NONE        1 /*   No prediction scheme used before coding */
+#  define TAG_PREDICTOR_HORIZ       2 /*   Horizontal differencing */
+#define IFD_TAG_WHITEPOINT        318 /* WhitePoint, RATIONAL */
+#define IFD_TAG_PRIMARYCHROMA     319 /* PrimaryChromaticities, RATIONAL */
+#define IFD_TAG_COLORMAP          320 /* ColorMap, SHORT (Required in palette
+                                       * color image files) */
+#define IFD_TAG_HALFTONEHINTS     321 /* HalftoneHints, SHORT */
+#define IFD_TAG_TILEWIDTH         322 /* TileWidth, SHORT or LONG */
+#define IFD_TAG_TILELENGTH        323 /* TileLength, SHORT or LONG */
+#define IFD_TAG_TILEOFFSETS       324 /* TileOffsets, LONG */
+#define IFD_TAG_TILEBYTECOUNTS    325 /* TileByteCounts, SHORT or LONG */
+#define IFD_TAG_INKSET            332 /* InkSet, SHORT */
+#  define TAG_INKSET_CMYK           1 /*   CMYK */
+#  define TAG_INKSET_OTHER          2 /*   Not CMYK */
+#define IFD_TAG_INKNAMES          333 /* InkNames, ASCII */
+#define IFD_TAG_NUMBEROFINKS      334 /* NumberOfInks, SHORT */
+#define IFD_TAG_DOTRANGE          336 /* DotRange, BYTE or SHORT */
+#define IFD_TAG_TARGETPRINTER     337 /* TargetPrinter, ASCII */
+#define IFD_TAG_EXTRASAMPLES      338 /* ExtraSamples, SHORT */
+#  define TAG_EXTSAMP_UNSPEC        0 /*   Unspecified */
+#  define TAG_EXTSAMP_ASSOCALPHA    1 /*   Associated alpha data */
+#  define TAG_EXTSAMP_UNASSALPHA    2 /*   Unassociated alpha data */
+#define IFD_TAG_SAMPLEFORMAT      339 /* SampleFormat, SHORT */
+#  define TAG_SAMPLEFMT_UNSIGED     1 /*   Unsigned integer data */
+#  define TAG_SAMPLEFMT_SIGNED      2 /*   Two’s complement signed integer data */
+#  define TAG_SAMPLEFMT_FLOAT       3 /*   IEEE floating point data */
+#  define TAG_SAMPLEFMT_UNDEFINED   4 /*   Undefined data format */
+#define IFD_TAG_SMINSAMPLEVALUE   340 /* SMinSampleValue, type matches sample data */
+#define IFD_TAG_SMAXSAMPLEVALUE   341 /* SMaxSampleValue, type matches sample data */
+#define IFD_TAG_TRANSFERRANGE     342 /* TransferRange, SHORT */
+#define IFD_TAG_JPEGPROC          512 /* JPEGProc, SHORT */
+#define IFD_TAG_JPEGFMT           513 /* JPEGInterchangeFormat, LONG */
+#define IFD_TAG_JPEGLENGTH        514 /* JPEGInterchangeFormatLength, LONG */
+#define IFD_TAG_JPEGRESTART       515 /* JPEGRestartInterval, SHORT */
+#define IFD_TAG_JPEGLLPREDICTORS  517 /* JPEGLosslessPredictors, SHORT */
+#define IFD_TAG_JPEGPOINTXFORMS   518 /* JPEGPointTransforms, SHORT */
+#define IFD_TAG_JPEGQTABLES       519 /* JPEGQTables, LONG */
+#define IFD_TAG_JPEGDCTABLES      520 /* JPEGDCTables, LONG */
+#define IFD_TAG_JPEGACTABLES      521 /* JPEGACTables, LONG */
+#define IFD_TAG_YCbCrCOEFFS       529 /* YCbCrCoefficients, RATIONAL */
+#define IFD_TAG_YCbCrSUBSAMPLING  530 /* YCbCrSubSampling, SHORT */
+#define IFD_TAG_YCbCrPOSITIONING  531 /* YCbCrPositioning, SHORT */
+#define IFD_TAG_REFERENCEBW       532 /* ReferenceBlackWhite, RATIONAL */
+#define IFD_TAG_COPYRIGHT       33432 /* Copyright, ASCII */
+
+/************************************************************************************
+ * Public Types
+ ************************************************************************************/
+/* TIFF File Format Structure *******************************************************/
+/* "A TIFF file begins with an 8-byte image file header that points to an
+ *  image file directory (IFD). An image file directory contains information
+ *  about the image, as well as pointers to the actual image data."
+ */
+
+struct tiff_header_s
+{
+  uint8_t order[2];  /* 0-1: Byte order:  "II"=little endian, "MM"=big endian */
+  uint8_t magic[2];  /* 2-3: 42 in appropriate byte order */
+  uint8_t offset[4]; /* 4-7: Offset to the first IFD */
+};
+#define SIZEOF_TIFF_HEADER 8
+
+/* "An Image File Directory (IFD) consists of a 2-byte count of the number
+ *  of directory entries (i.e., the number of fields), followed by a sequence
+ *  of 12-byte field entries, followed by a 4-byte offset of the next IFD (or
+ *  0 if none).
+ *
+ * Each 12-byte IFD entry has the following format:
+ */
+
+struct tiff_ifdentry_s
+{
+  uint8_t tag[2];    /* 0-1: The Tag that identifies the field */
+  uint8_t type[2];   /* 2-3 The field Type */
+  uint8_t count[4];  /* 4-7: The number of values of the indicated type */
+  uint8_t offset[4]; /* 8-11: The Value Offset (or the value itself) */
+};
+#define SIZEOF_IFD_ENTRY 12
+
+/************************************************************************************/
+/* Structures needed to interface with the TIFF file creation library )and also 
+ * structures used only internally by the TIFF file creation library).
+ */
+
+/* This structure describes on strip in tmpfile2 */
+
+struct tiff_strip_s
+{
+  uint32_t offset; /* Offset to the strip data in tmpfile1 */
+  uint32_t count;  /* Count of pixels in the strip */
+};
+
+/* This structure is used only internally by the TIFF file creation library to
+ * manage file offsets.
+ */
+
+struct tiff_filefmt_s
+{
+  uint16_t nifdentries;    /* Number of IFD entries */
+  uint16_t soifdoffset;    /* Offset to StripOffset IFD entry */
+  uint16_t sbcifdoffset;   /* Offset to StripByteCount IFD entry */
+  uint16_t valoffset;      /* Offset to first values */
+  uint16_t xresoffset;     /* Offset to XResolution values */
+  uint16_t yresoffset;     /* Offset to yResolution values */
+  uint16_t swoffset;       /* Offset to Software string */
+  uint16_t dateoffset;     /* Offset to DateTime string */
+  uint16_t sbcoffset;      /* Offset to StripByteCount values */
+};
+
+/* These type is used to hold information about the TIFF file under
+ * construction
+ */
+
+struct tiff_info_s
+{
+  /* The first fields are used to pass information to the TIFF file creation
+   * logic via tiff_initialize().
+   *
+   * Filenames.  Three file names are required.  (1) path to the final
+   * output file and (2) two paths to temporary files.  One temporary file
+   * (tmpfile1) will be used to hold the strip image data and the other
+   * (tmpfile2) will be used to hold strip offset and count information.
+   *
+   * colorfmt  - Specifies the form of the color data that will be provided
+   *             in the strip data.  These are the FB_FMT_* definitions
+   *             provided in include/nuttx/fb.h.  Only the following values
+   *             are supported:
+   *
+   *             FB_FMT_Y1               BPP=1, monochrome, 0=black
+   *             FB_FMT_Y4               BPP=4, 4-bit greyscale, 0=black
+   *             FB_FMT_Y8               BPP=8, 8-bit greyscale, 0=black
+   *             FB_FMT_RGB16_565        BPP=16 R=6, G=6, B=5
+   *             FB_FMT_RGB24            BPP=24 R=8, G=8, B=8
+   *
+   * rps       - TIFF RowsPerStrip
+   * imgwidth  - TIFF ImageWidth, Number of columns in the image
+   * imgheight - TIFF ImageLength, Number of rows in the image
+   */
+
+  FAR const char *outfile;  /* Full path to the final output file name */
+  FAR const char *tmpfile1; /* Full path to first temporary file */
+  FAR const char *tmpfile2; /* Full path to second temporary file */
+
+  uint8_t      colorfmt;    /* See FB_FMT_* definitions in include/nuttx/fb.h */
+  nxgl_coord_t rps;         /* TIFF RowsPerStrip */
+  nxgl_coord_t imgwidth;    /* TIFF ImageWidth, Number of columns in the image */
+  nxgl_coord_t imgheight;   /* TIFF ImageLength, Number of rows in the image */
+
+  /* The caller must provide an I/O buffer as well.  This I/O buffer will
+   * used for color conversions and as the intermediate buffer for copying
+   * files.  The larger the buffer, the better the performance.
+   */
+
+  FAR uint8_t *iobuffer;    /* IO buffer allocated by the caller */
+  unsigned int iosize;      /* The size of the I/O buffer in bytes */
+
+  /* The second set of fields are used only internally by the TIFF file
+   * creation logic.  These fields must be set to zero initially by the
+   * caller of tiff_initialize().  User logic should not depend upon any
+   * definitions in the following -- they are subject to change without
+   * notice.  They are only exposed here so that the caller can allocate
+   * memory for their storage.
+   */
+
+  uint8_t      imgflags;    /* Bit-encoded image flags */
+  nxgl_coord_t nstrips;     /* Number of strips in tmpfile3 */
+  size_t       pps;         /* Pixels per strip */
+  size_t       bps;         /* Bytes per strip */
+  int          outfd;       /* outfile file descriptor */
+  int          tmp1fd;      /* tmpfile1 file descriptor */
+  int          tmp2fd;      /* tmpfile2 file descriptor */
+  off_t        outsize;     /* Current size of outfile */
+  off_t        tmp1size;    /* Current size of tmpfile1 */
+  off_t        tmp2size;    /* Current size of tmpfile2 */
+
+  /* Points to an internal constant structure of file offsets */
+  
+  FAR const struct tiff_filefmt_s *filefmt;
+};
+
+/************************************************************************************
+ * Public Function Prototypes
+ ************************************************************************************/
+
+#ifdef __cplusplus
+#define EXTERN extern "C"
+extern "C" {
+#else
+#define EXTERN extern
+#endif
+
+/************************************************************************************
+ * Name: tiff_initialize
+ *
+ * Description:
+ *   Setup to create a new TIFF file.  The overall steps to creating a TIFF file are
+ *   as follows:
+ *
+ *   1) Create an initialize a struct tiff_info_s instance
+ *   2) Call tiff_initialize() to setup the file creation
+ *   3) Call tiff_addstrip() repeatedly to add strips to the graphic image
+ *   4) Call tiff_finalize() to complete the file creation.
+ *
+ * Input Parameters:
+ *   info - A pointer to the caller allocated parameter passing/TIFF state instance.
+ *
+ * Returned Value:
+ *   Zero (OK) on success.  A negated errno value on failure.
+ *
+ ************************************************************************************/
+
+EXTERN int tiff_initialize(FAR struct tiff_info_s *info);
+
+/************************************************************************************
+ * Name: tiff_addstrip
+ *
+ * Description:
+ *   Add an image data strip.  The size of the strip in pixels must be equal to
+ *   the RowsPerStrip x ImageWidth values that were provided to tiff_initialize().
+ *
+ * Input Parameters:
+ *   info    - A pointer to the caller allocated parameter passing/TIFF state instance.
+ *   buffer  - A buffer containing a single row of data.
+ *
+ * Returned Value:
+ *   Zero (OK) on success.  A negated errno value on failure.
+ *
+ ************************************************************************************/
+
+EXTERN int tiff_addstrip(FAR struct tiff_info_s *info, FAR const uint8_t *strip);
+
+/************************************************************************************
+ * Name: tiff_finalize
+ *
+ * Description:
+ *   Finalize the TIFF output file, completing the TIFF file creation steps.
+ *
+ * Input Parameters:
+ *   info - A pointer to the caller allocated parameter passing/TIFF state instance.
+ *
+ * Returned Value:
+ *   Zero (OK) on success.  A negated errno value on failure.
+ *
+ ************************************************************************************/
+
+EXTERN int tiff_finalize(FAR struct tiff_info_s *info);
+
+/************************************************************************************
+ * Name: tiff_abort
+ *
+ * Description:
+ *   Abort the TIFF file creation and create-up resources.
+ *
+ * Input Parameters:
+ *   info - A pointer to the caller allocated parameter passing/TIFF state instance.
+ *
+ * Returned Value:
+ *   None
+ *
+ ************************************************************************************/
+
+EXTERN void tiff_abort(FAR struct tiff_info_s *info);
+
+/************************************************************************************
+ * Name: tiff_put/get16/32
+ *
+ * Description:
+ *   Put and get 16 and 32 values in the correct byte order at the specified position.
+ *
+ * Input Parameters:
+ *   dest - The location to store the multi-byte data (put only)
+ *   src - The location to get the multi-byte data (get only)
+ *
+ * Returned Value:
+ *   None (put)
+ *   The extracted value (get)
+ *
+ ************************************************************************************/
+
+EXTERN void tiff_put16(FAR uint8_t *dest, uint16_t value);
+EXTERN void tiff_put32(FAR uint8_t *dest, uint32_t value);
+EXTERN uint16_t tiff_get16(FAR uint8_t *dest);
+EXTERN uint32_t tiff_get32(FAR uint8_t *dest);
+
+#undef EXTERN
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __APPS_INCLUDE_TIFF_H */