Jira566 I2S DMA improvement: add two extra buffer on TX and RX side

Author: Christa03

libraries/CurieI2SDMA/examples/I2SDMA_RXCallBack/I2SDMA_RXCallBack.ino

@@ -0,0 +1,79 @@
+/**
+ * A simple sketch to test the rx channel of the i2s interface. 
+ * A callback function is used to fill up a buffer whenever data is received
+ * 
+ * To test this sketch you will need a second Arduino/Genuino 101 board with the I2S_TxCallback sketch uploaded
+ * 
+ * Connection:
+ * GND -> GND
+ * I2S_RSCK(pin 8) -> I2S_TSCK(pin 2) 
+ * I2S_RWS(pin 3) -> I2S_TWS(pin 4)
+ * I2S_RXD(pin 5) -> I2S_TXD(pin 7)
+ * 
+**/
+#include <CurieI2SDMA.h>
+
+#define BUFF_SIZE 128
+uint32_t dataBuff[BUFF_SIZE+2]; // extra 2 buffer is for the padding zero
+
+uint32_t OFFSET = 0;
+uint8_t start_flag = 0;
+uint8_t done_flag = 0;
+uint32_t loop_count = 0;
+
+void setup() 
+{
+  Serial.begin(115200);
+  while(!Serial);
+  Serial.println("CurieI2SDMA Rx Callback");
+
+  CurieI2SDMA.iniRX();
+  /*
+   * CurieI2SDMA.beginTX(sample_rate, resolution, master,mode)
+   * mode 1 : PHILIPS_MODE
+   *      2 : RIGHT_JST_MODE
+   *      3 : LEFT_JST_MODE
+   *      4 : DSP_MODE
+   */
+  CurieI2SDMA.beginRX(44100, 32,0,1);
+
+}
+
+void loop() 
+{
+  int status = CurieI2SDMA.transRX(dataBuff,sizeof(dataBuff));
+  if(status)
+    return;
+
+  if(start_flag)
+  {   
+    if( (dataBuff[OFFSET]>>16) != loop_count+1)
+      Serial.println("+++ loop_count jump +++");        
+  }
+  else
+  {
+    start_flag = 1;
+    OFFSET =  (dataBuff[0] == 0) ? 2 : 0;
+  }
+  loop_count = (dataBuff[OFFSET] >> 16);
+
+  done_flag = 1;
+  for(uint32_t i = 0 ;i < BUFF_SIZE;++i)
+  {
+    //Serial.println(dataBuff[i+OFFSET],HEX);
+    if ((dataBuff[i+OFFSET] & 0XFFFF0000) == (loop_count <<16)
+      && (dataBuff[i+OFFSET] & 0XFFFF) == (i+1))
+            ;
+    else
+    {
+      done_flag = 0;
+      Serial.println(dataBuff[i+OFFSET],HEX);
+      Serial.println("ERROR");
+      break;
+    }
+  } 
+    
+  if(done_flag)
+    Serial.println("RX done");
+  delay(100);  
+}

libraries/CurieI2SDMA/examples/I2SDMA_TXCallBack/I2SDMA_TXCallBack.ino

@@ -0,0 +1,50 @@
+//I2S_TX -> Pin 7
+//I2S_TSK -> Pin 4
+//I2S_TSCK -> pin 2
+
+#include <CurieI2SDMA.h>
+
+#define BUFF_SIZE 128
+boolean blinkState = true;          // state of the LED
+uint32_t dataBuff[BUFF_SIZE];
+uint32_t loop_count = 0;
+void setup() 
+{
+  Serial.begin(115200);
+  while(!Serial);
+  Serial.println("CurieI2SDMA Tx Callback");
+
+  CurieI2SDMA.iniTX();
+  /*
+   * CurieI2SDMA.beginTX(sample_rate, resolution, master,mode)
+   * mode 1 : PHILIPS_MODE
+   *      2 : RIGHT_JST_MODE
+   *      3 : LEFT_JST_MODE
+   *      4 : DSP_MODE
+   */
+  CurieI2SDMA.beginTX(44100, 32,1, 1);
+  digitalWrite(13, blinkState);  
+}
+
+void loop() 
+{
+  for(uint32_t i = 0; i <BUFF_SIZE; ++i)
+  {
+    dataBuff[i] = i + 1 + (loop_count<<16);
+  }
+  loop_count++;
+  int status = CurieI2SDMA.transTX(dataBuff,sizeof(dataBuff));
+  if(status)
+    return;
+   
+  blinkState = !blinkState;
+  digitalWrite(13, blinkState);
+
+  //when the TX set to be slave, the two lines below will introduce delay.
+  //Please remove them.
+  Serial.println("done transmitting");
+  delay(1000);
+  
+}
+
+

libraries/CurieI2SDMA/keywords.txt

@@ -0,0 +1,48 @@
+#######################################
+# Syntax Coloring Map For CurieI2S
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+Curie_I2S KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+begin	KEYWORD2
+start	KEYWORD2
+stop	KEYWORD2
+begin   KEYWORD2
+enableRX    KEYWORD2
+enableTX    KEYWORD2
+startRX     KEYWORD2
+startTX     KEYWORD2
+stopRX      KEYWORD2
+stopTX      KEYWORD2
+setI2SMode  KEYWORD2
+setResolution   KEYWORD2
+initRX      KEYWORD2
+initTX      KEYWORD2
+end         KEYWORD2
+pushData    KEYWORD2
+fastPushData    KEYWORD2
+write   KEYWORD2
+pullData    KEYWORD2
+read        KEYWORD2
+requestdword    KEYWORD2
+available       KEYWORD2
+availableTx     KEYWORD2
+attachRxInterrupt   KEYWORD2
+detachRxInterrupt   KEYWORD2
+attachTxInterrupt   KEYWORD2
+detachTxInterrupt   KEYWORD2
+#######################################
+# Instances (KEYWORD2)
+#######################################
+CurieI2S KEYWORD2
+#######################################
+# Constants (LITERAL1)
+#######################################

libraries/CurieI2SDMA/library.properties

@@ -0,0 +1,11 @@
+name=CurieI2SDMA
+version=1.0
+author=Intel
+maintainer=Intel
+email[email protected]
+sentence=Curie I2S DMA Library for Arduino/Genuino 101
+paragraph=
+category=Communication
+url=http://makers.intel.com
+architectures=arc32
+core-dependencies=arduino (>=1.6.3)