Adafruit audio FX - Code - Beginner question

Using Arduino Audio
1

Is there someplace where the code commands are listed for calling a specific track to play? In the library, there is a line like this boolean playTrack(uint8_t n);

How would I translate that into code to play a file?

Here is the whole library code:

/*************************************************** 
  This is a library for the Adafruit Sound Boards in UART mode
  ----> http://www.adafruit.com/products/2342
  ----> http://www.adafruit.com/products/2341
  ----> http://www.adafruit.com/products/2217
  ----> http://www.adafruit.com/products/2210
  ----> http://www.adafruit.com/products/2133
  ----> http://www.adafruit.com/products/2220
  Check out the links above for our tutorials and wiring diagrams
  This sound fx driver uses TTL Serial to communicate
  Adafruit invests time and resources providing this open source code,
  please support Adafruit and open-source hardware by purchasing
  products from Adafruit!
  Written by Limor Fried/Ladyada for Adafruit Industries.
  MIT license, all text above must be included in any redistribution
 ****************************************************/

#ifndef _ADAFRUIT_SOUNDBOARD_H_
#define _ADAFRUIT_SOUNDBOARD_H_

#include "Arduino.h"

#define LINE_BUFFER_SIZE  80
#define MAXFILES 25

class Adafruit_Soundboard : public Print {
 public:
  Adafruit_Soundboard(Stream *s, Stream *d, int8_t r);

  boolean reset(void);

  int     readLine(void);
  uint8_t listFiles(void);

  char *fileName(uint8_t n);
  uint32_t fileSize(uint8_t n);


  uint8_t volUp(void);
  uint8_t volDown(void);

  boolean playTrack(uint8_t n);
  boolean playTrack(char *name);
  boolean pause(void);
  boolean unpause(void);
  boolean stop(void);

  boolean trackTime(uint32_t *current, uint32_t *total);
  boolean trackSize(uint32_t *current, uint32_t *total);

 private:
  Stream   *stream;     // -> sound board, e.g. SoftwareSerial or Serial1
  Stream    *debug;      // -> host, e.g. Serial
  
  int8_t reset_pin;
  char line_buffer[LINE_BUFFER_SIZE];
  boolean writing;

  // File name & size caching
  uint8_t files;
  char filenames[MAXFILES][12];
  uint32_t filesizes[MAXFILES];


  virtual size_t write(uint8_t); // Because Print subclass
};
#endif

Also wondering if anyone can help me understand what this part of the code is saying:

// File name & size caching
  uint8_t files;
  char filenames[MAXFILES][12];
  uint32_t filesizes[MAXFILES];
2

Here is the whole library code:

No it is not, it is just the header file, with a dot h file type. The real code is in the .CCP file. There you will find the function definition of the call.

The boolean playTrack(uint8_t n);
Line is just telling the compiler that the code for the method is coming up later in the .cpp file.

That last bit of code is just declaring variables to use later. With the one with square brackets then this variable is an array, with two lots of brackets it is a two dimensional array.

3

Thanks

4

Still wondering how to figure out what commands to use in the code to call an audio file. Is there a list of commands and how do they work?

5

Is there a list of commands

Yes it is in the .h file you posted at fiirst.

how do they work?

Well you can look at the example files in any of the product pages listed at the start of the .h file.
Or you can read the data sheet for the exact type of chip you have. Downloads | Adafruit Audio FX Sound Board | Adafruit Learning System