From: Thomas Jarosch <thomas.jarosch@intra2net.com>
Date: Wed, 22 Feb 2017 09:07:53 +0000 (+0100)
Subject: Add doxygen documentation for ftdi_eeprom_get_strings()
X-Git-Tag: v1.4rc1~7
X-Git-Url: http://developer.intra2net.com/git/?p=libftdi;a=commitdiff_plain;h=934173a30ae3db61369cf308e8051f9ed4643d24

Add doxygen documentation for ftdi_eeprom_get_strings()

Mostly borrowed from ftdi_usb_get_strings()
---

diff --git a/src/ftdi.c b/src/ftdi.c
index 777733a..360acf5 100644
--- a/src/ftdi.c
+++ b/src/ftdi.c
@@ -2596,6 +2596,25 @@ int ftdi_eeprom_set_strings(struct ftdi_context *ftdi, char * manufacturer,
     return 0;
 }
 
+/**
+    Return device ID strings from the eeprom. Device needs to be connected.
+
+    The parameters manufacturer, description and serial may be NULL
+    or pointer to buffers to store the fetched strings.
+
+    \param ftdi pointer to ftdi_context
+    \param manufacturer Store manufacturer string here if not NULL
+    \param mnf_len Buffer size of manufacturer string
+    \param product Store product description string here if not NULL
+    \param prod_len Buffer size of product description string
+    \param serial Store serial string here if not NULL
+    \param serial_len Buffer size of serial string
+
+    \retval   0: all fine
+    \retval  -1: ftdi context invalid
+    \retval  -2: ftdi eeprom buffer invalid
+    \retval  -3: no USB device connected
+*/
 int ftdi_eeprom_get_strings(struct ftdi_context *ftdi,
                             char *manufacturer, int mnf_len,
                             char *product, int prod_len,