Posts with «read» label

CH376S USB Read/Write module

Have you ever wondered if there was a way to store and retrieve data from a USB stick with an Arduino UNO? Most people choose SD cards to store their project data, but you may be surprised there IS a way!
IC Station have a nice little module which allows you store and retrieve your Arduino (or other MCU) project data to a USB stick.

I am not too sure why USB storage is not widely used in Arduino projects? These modules are not expensive, they have been around for quite a while, and are relatively simple to use. You do not need any libraries to get them to work, however, I must say that documentation for this module is not that easy to find. This site and this document proved to be very useful in my endevour to get this module working, and I hope my tutorial below will help you get started and bridge some of the information gaps.

The "CH376S USB read/write module" has a CH376S chip onboard which does most of the hard work for you. All you have to do is send the module some commands from the Arduino and the CH376S chip will do the rest. You can communicate with the module in three different ways:

Parallel communication
SPI communication
and Serial (UART) communication.

This project will show you the connections and code for the Serial (UART) communication method only.

Parts Required:

Remove the Jumper

When the CH376S USB module arrives in it's package, it will have a jumper between the TXD pin and GND. You will need to remove this jumper to make the necessary connections between the Arduino UNO and the CH376S USB module.

Fritzing Sketch

Please note, that the Arduino Sketch makes use of the Arduino UNO's onboard LED on digital pin 13. The Fritzing sketch below shows an LED + 300 ohm resistor on a breadboard. This is optional. The LED is not a necessary component of CH376S module communication.

Also be aware that the CH376S USB module has an onboard LED just above the TXD and GND pins near the USB port. This LED will only turn on providing the CH376S module is in USB mode AND a USB device has been inserted into the USB port. Both conditions must be met before the module's onboard LED will illuminate. You will not see the LED turn on just by powering the board.

The wire diagram below is the correct setup for Serial communication between an Arduino UNO and the CH376S module. If you wish to use SPI or Parallel communication, you will need to refer to the datasheet.

Arduino Sketch


/* ===============================================================
      Project: CH376S USB Read/Write Module testing ground
       Author: Scott C
      Created: 1st May 2015
  Arduino IDE: 1.6.2
      Website: http://arduinobasics.blogspot.com/p/arduino-basics-projects-page.html
  Description: This project will allow you to perform many of the functions available on the CH376S module.
               Checking connection to the module, putting the module into USB mode, resetting the module, 
               reading, writing, appending text to files on the USB stick. This is very useful alternative to
               SD card modules, plus it doesn't need any libraries.
================================================================== */

#include <SoftwareSerial.h>

byte computerByte;           //used to store data coming from the computer
byte USB_Byte;               //used to store data coming from the USB stick
int LED = 13;                //the LED is connected to digital pin 13 
int timeOut = 2000;          //TimeOut is 2 seconds. This is the amount of time you wish to wait for a response from the CH376S module.
String wrData = "What is the meaning of life ?";     //We will write this data to a newly created file.
String wrData2 = "42";                                   //We will append this data to an already existing file.

SoftwareSerial USB(10, 11);                           // Digital pin 10 on Arduino (RX) connects to TXD on the CH376S module
                                                      // Digital pin 11 on Arduino (TX) connects to RXD on the CH376S module
                                                      // GND on Arduino to GND on CH376S module
                                                      // 5V on Arduino to 5V on CH376S module
//==============================================================================================================================================
void setup() {
  Serial.begin(9600);                                 // Setup serial communication with the computer (using a baud rate of 9600 on serial monitor)
  USB.begin(9600);                                    // Setup serial communication with the CH376S module (using the default baud rate of 9600)
  pinMode(LED,OUTPUT);                                // Define digital pin 13 as an OUTPUT pin - so that we can use it with an LED
  digitalWrite(LED,LOW);                              // Turn off the LED
}

//================================================================================================================================================
void loop() {
  if(Serial.available()){
    computerByte = Serial.read();                      //read any incoming bytes from the Serial monitor, and store this byte in the variable called computerByte
    if(computerByte==49){               //1            //If you send the number 1 from the serial monitor, the arduino will read it as digital number 49. Google "ascii table" for more info.
      printCommandHeader("COMMAND1: CHECK CONNECTION");
      checkConnection(0x01);                           // Check for successful connection and communication with the CH376S module.
    } 
    if(computerByte==50){               //2
     printCommandHeader("COMMAND2: set_USB_Mode");
      set_USB_Mode(0x06);                              // Code used to enable read/write communication and monitoring of the USB stick
    }
    if(computerByte==51){               //3
      printCommandHeader("COMMAND3: resetALL");
      resetALL();                                      // Reset the USB device
    }
    if(computerByte==52){               //4
      printCommandHeader("COMMAND4: Create and Write to File : TEST4.TXT");
      writeFile("TEST4.TXT", wrData);                  // Create a file called TEST4.TXT and then Write the contents of wrData to this file
    }
    if(computerByte==53){               //5
      printCommandHeader("COMMAND5: Read File: TEST4.TXT");
      readFile("TEST4.TXT");                           // Read the contents of this file on the USB disk, and display contents in the Serial Monitor
    }
    if(computerByte==54){               //6
      printCommandHeader("COMMAND6: Append data to file: TEST4.TXT");
      appendFile("TEST4.TXT", wrData2);                // Append data to the end of the file.
    }
    if(computerByte==55){               //7
      printCommandHeader("COMMAND7: Delete File: TEST4.TXT");
      fileDelete("TEST4.TXT");                         // Delete the file named TEST4.TXT
    }
    if(computerByte==56){               //8
      printCommandHeader("COMMAND8: Read File: TEST2.TXT");
      readFile("TEST2.TXT");                           // Read the contents of the TEST2.TXT file on the USB disk, and display contents in the Serial Monitor
    }
    if(computerByte==57){               //9
      printCommandHeader("COMMAND9: Read File: TEST3.TXT");
      readFile("TEST3.TXT");                           // Read the contents of the TEST3.TXT file on the USB disk, and display contents in the Serial Monitor
    }
  }
  
  if(USB.available()){                                 // This is here to capture any unexpected data transmitted by the CH376S module
    Serial.print("CH376S has just sent this code:");
    Serial.println(USB.read(), HEX);
  }
}

//END OF LOOP FUNCTION ========================================================================================================================================

//print Command header
void printCommandHeader(String header){
   Serial.println("======================");
   Serial.println("");
   Serial.println(header);
   Serial.println("----------------------");
}

//checkConnection==================================================================================
//This function is used to check for successful communication with the CH376S module. This is not dependant of the presence of a USB stick.
//Send any value between 0 to 255, and the CH376S module will return a number = 255 - value. 
void checkConnection(byte value){
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x06);
  USB.write(value);
  
  if(waitForResponse("checking connection")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==(255-value)){
       Serial.println(">Connection to CH376S was successful.");
       blinkLED();                               //blink the LED for 1 second if the connection was successful
    } else {
      Serial.print(">Connection to CH376S - FAILED.");
    }
  }
}

//set_USB_Mode=====================================================================================
//Make sure that the USB is inserted when using 0x06 as the value in this specific code sequence
void set_USB_Mode (byte value){
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x15);
  USB.write(value);
  
  delay(20);
  
  if(USB.available()){
    USB_Byte=USB.read();
    //Check to see if the command has been successfully transmitted and acknowledged.
    if(USB_Byte==0x51){                                   // If true - the CH376S has acknowledged the command.
        Serial.println("set_USB_Mode command acknowledged"); //The CH376S will now check and monitor the USB port
        USB_Byte = USB.read();
        
        //Check to see if the USB stick is connected or not.
        if(USB_Byte==0x15){                               // If true - there is a USB stick connected
          Serial.println("USB is present");
          blinkLED();                                     // If the process was successful, then turn the LED on for 1 second 
        } else {
          Serial.print("USB Not present. Error code:");   // If the USB is not connected - it should return an Error code = FFH
          Serial.print(USB_Byte, HEX);
          Serial.println("H");
        }
        
    } else {
        Serial.print("CH3765 error!   Error code:");
        Serial.print(USB_Byte, HEX);
        Serial.println("H");
    }   
  }
  delay(20);
}

//resetALL=========================================================================================
//This will perform a hardware reset of the CH376S module - which usually takes about 35 msecs =====
void resetALL(){
    USB.write(0x57);
    USB.write(0xAB);
    USB.write(0x05);
    Serial.println("The CH376S module has been reset !");
    delay(200);
}

//readFile=====================================================================================
//This will send a series of commands to read data from a specific file (defined by fileName)
void readFile(String fileName){
  resetALL();                     //Reset the module
  set_USB_Mode(0x06);             //Set to USB Mode
  diskConnectionStatus();         //Check that communication with the USB device is possible
  USBdiskMount();                 //Prepare the USB for reading/writing - you need to mount the USB disk for proper read/write operations.
  setFileName(fileName);          //Set File name
  fileOpen();                     //Open the file for reading
  int fs = getFileSize();         //Get the size of the file
  fileRead();                     //***** Send the command to read the file ***
  fileClose(0x00);                //Close the file
}

//writeFile========================================================================================
//is used to create a new file and then write data to that file. "fileName" is a variable used to hold the name of the file (e.g TEST.TXT). "data" should not be greater than 255 bytes long. 
void writeFile(String fileName, String data){
  resetALL();                     //Reset the module
  set_USB_Mode(0x06);             //Set to USB Mode
  diskConnectionStatus();         //Check that communication with the USB device is possible
  USBdiskMount();                 //Prepare the USB for reading/writing - you need to mount the USB disk for proper read/write operations.
  setFileName(fileName);          //Set File name
  if(fileCreate()){               //Try to create a new file. If file creation is successful
    fileWrite(data);              //write data to the file.
  } else {
    Serial.println("File could not be created, or it already exists");
  }
  fileClose(0x01);
}

//appendFile()====================================================================================
//is used to write data to the end of the file, without erasing the contents of the file.
void appendFile(String fileName, String data){
    resetALL();                     //Reset the module
    set_USB_Mode(0x06);             //Set to USB Mode
    diskConnectionStatus();         //Check that communication with the USB device is possible
    USBdiskMount();                 //Prepare the USB for reading/writing - you need to mount the USB disk for proper read/write operations.
    setFileName(fileName);          //Set File name
    fileOpen();                     //Open the file
    filePointer(false);             //filePointer(false) is to set the pointer at the end of the file.  filePointer(true) will set the pointer to the beginning.
    fileWrite(data);                //Write data to the end of the file
    fileClose(0x01);                //Close the file using 0x01 - which means to update the size of the file on close. 
}
  
//setFileName======================================================================================
//This sets the name of the file to work with
void setFileName(String fileName){
  Serial.print("Setting filename to:");
  Serial.println(fileName);
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x2F);
  USB.write(0x2F);         // Every filename must have this byte to indicate the start of the file name.
  USB.print(fileName);     // "fileName" is a variable that holds the name of the file.  eg. TEST.TXT
  USB.write((byte)0x00);   // you need to cast as a byte - otherwise it will not compile.  The null byte indicates the end of the file name.
  delay(20);
}

//diskConnectionStatus================================================================================
//Check the disk connection status
void diskConnectionStatus(){
  Serial.println("Checking USB disk connection status");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x30);

  if(waitForResponse("Connecting to USB disk")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x14){               //CH376S will send 0x14 if this command was successful
       Serial.println(">Connection to USB OK");
    } else {
      Serial.print(">Connection to USB - FAILED.");
    }
  }
}

//USBdiskMount========================================================================================
//initialise the USB disk and check that it is ready - this process is required if you want to find the manufacturing information of the USB disk
void USBdiskMount(){
  Serial.println("Mounting USB disk");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x31);

  if(waitForResponse("mounting USB disk")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x14){               //CH376S will send 0x14 if this command was successful
       Serial.println(">USB Mounted - OK");
    } else {
      Serial.print(">Failed to Mount USB disk.");
    }
  }
}

//fileOpen========================================================================================
//opens the file for reading or writing
void fileOpen(){
  Serial.println("Opening file.");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x32);
  if(waitForResponse("file Open")){                 //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x14){                 //CH376S will send 0x14 if this command was successful  
       Serial.println(">File opened successfully.");
    } else {
      Serial.print(">Failed to open file.");
    }
  }
}

//setByteRead=====================================================================================
//This function is required if you want to read data from the file. 
boolean setByteRead(byte numBytes){
  boolean bytesToRead=false;
  int timeCounter = 0;
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x3A);
  USB.write((byte)numBytes);   //tells the CH376S how many bytes to read at a time
  USB.write((byte)0x00);
  if(waitForResponse("setByteRead")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x1D){         //read the CH376S message. If equal to 0x1D, data is present, so return true. Will return 0x14 if no data is present.
      bytesToRead=true;
    }
  }
  return(bytesToRead);
} 

//getFileSize()===================================================================================
//writes the file size to the serial Monitor.
int getFileSize(){
  int fileSize=0;
  Serial.println("Getting File Size");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x0C);
  USB.write(0x68);
  delay(100);
  Serial.print("FileSize =");
  if(USB.available()){
    fileSize = fileSize + USB.read();
  } 
  if(USB.available()){
    fileSize = fileSize + (USB.read()*255);
  } 
  if(USB.available()){
    fileSize = fileSize + (USB.read()*255*255);
  } 
  if(USB.available()){
    fileSize = fileSize + (USB.read()*255*255*255);
  }     
  Serial.println(fileSize);
  delay(10);
  return(fileSize);
}


//fileRead========================================================================================
//read the contents of the file
void fileRead(){
  Serial.println("Reading file:");
  byte firstByte = 0x00;                     //Variable to hold the firstByte from every transmission.  Can be used as a checkSum if required.
  byte numBytes = 0x40;                      //The maximum value is 0x40  =  64 bytes
 
  while(setByteRead(numBytes)){              //This tells the CH376S module how many bytes to read on the next reading step. In this example, we will read 0x10 bytes at a time. Returns true if there are bytes to read, false if there are no more bytes to read.
    USB.write(0x57);
    USB.write(0xAB);
    USB.write(0x27);                          //Command to read ALL of the bytes (allocated by setByteRead(x))
    if(waitForResponse("reading data")){      //Wait for the CH376S module to return data. TimeOut will return false. If data is being transmitted, it will return true.
        firstByte=USB.read();                 //Read the first byte
        while(USB.available()){
          Serial.write(USB.read());           //Send the data from the USB disk to the Serial monitor
          delay(1);                           //This delay is necessary for successful Serial transmission
        }
    }
    if<!continueRead()){><span>//prepares the module for further reading. If false, stop reading.</span><br  />      <span>break</span>;                                   <span>//You need the continueRead() method if the data to be read from the USB device is greater than numBytes.</span><br  />    }<br  />  }<br  />  <span><b>Serial</b></span>.<span>println</span>();<br  />  <span><b>Serial</b></span>.<span>println</span>(<span>"NO MORE DATA"</span>);<br  />}<br  /><br  /><span>//fileWrite=======================================================================================</span><br  /><span>//are the commands used to write to the file</span><br  /><span>void</span> fileWrite(<span>String</span> data){<br  />  <span><b>Serial</b></span>.<span>println</span>(<span>"Writing to file:"</span>);<br  />  <span>byte</span> dataLength = (<span>byte</span>) data.<span>length</span>();         <span>// This variable holds the length of the data to be written (in bytes)</span><br  />  <span><b>Serial</b></span>.<span>println</span>(data);<br  />  <span><b>Serial</b></span>.<span>print</span>(<span>"Data Length:"</span>);<br  />  <span><b>Serial</b></span>.<span>println</span>(dataLength);<br  />  <span>delay</span>(100);<br  />  <span>// This set of commands tells the CH376S module how many bytes to expect from the Arduino.  (defined by the "dataLength" variable)</span><br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x3C);<br  />  USB.<span>write</span>((<span>byte</span>) dataLength);<br  />  USB.<span>write</span>((<span>byte</span>) 0x00);<br  />  <span>if</span>(waitForResponse(<span>"setting data Length"</span>)){      <span>// Wait for an acknowledgement from the CH376S module before trying to send data to it</span><br  />    <span>if</span>(getResponseFromUSB()==0x1E){                <span>// 0x1E indicates that the USB device is in write mode.</span><br  />      USB.<span>write</span>(0x57);<br  />      USB.<span>write</span>(0xAB);<br  />      USB.<span>write</span>(0x2D);<br  />      USB.<span>print</span>(data);                             <span>// write the data to the file</span><br  />  <br  />      <span>if</span>(waitForResponse(<span>"writing data to file"</span>)){   <span>// wait for an acknowledgement from the CH376S module</span><br  />      }<br  />      <span><b>Serial</b></span>.<span>print</span>(<span>"Write code (normally FF and 14): "</span>);<br  />      <span><b>Serial</b></span>.<span>print</span>(USB.<span>read</span>(),<span>HEX</span>);                <span>// code is normally 0xFF</span><br  />      <span><b>Serial</b></span>.<span>print</span>(<span>","</span>);<br  />      USB.<span>write</span>(0x57);<br  />      USB.<span>write</span>(0xAB);<br  />      USB.<span>write</span>(0x3D);                             <span>// This is used to update the file size. Not sure if this is necessary for successful writing.</span><br  />      <span>if</span>(waitForResponse(<span>"updating file size"</span>)){   <span>// wait for an acknowledgement from the CH376S module</span><br  />      }<br  />      <span><b>Serial</b></span>.<span>println</span>(USB.<span>read</span>(),<span>HEX</span>);              <span>//code is normally 0x14</span><br  />    }<br  />  }<br  />}<br  /><br  /><span>//continueRead()==================================================================================</span><br  /><span>//continue to read the file : I could not get this function to work as intended.</span><br  /><span>boolean</span> continueRead(){<br  />  <span>boolean</span> readAgain = <span>false</span>;<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x3B);<br  />  <span>if</span>(waitForResponse(<span>"continueRead"</span>)){       <span>//wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.</span><br  />     <span>if</span>(getResponseFromUSB()==0x14){         <span>//CH376S will send 0x14 if this command was successful</span><br  />       readAgain=<span>true</span>;<br  />     }<br  />  }<br  />  <span>return</span>(readAgain);<br  />} <br  /><br  /><span>//fileCreate()========================================================================================</span><br  /><span>//the command sequence to create a file</span><br  /><span>boolean</span> fileCreate(){<br  />  <span>boolean</span> createdFile = <span>false</span>;<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x34);<br  />  <span>if</span>(waitForResponse(<span>"creating file"</span>)){       <span>//wait for a response from the CH376S. If file has been created successfully, it will return true.</span><br  />     <span>if</span>(getResponseFromUSB()==0x14){          <span>//CH376S will send 0x14 if this command was successful</span><br  />       createdFile=<span>true</span>;<br  />     }<br  />  }<br  />  <span>return</span>(createdFile);<br  />}<br  /><br  /><br  /><span>//fileDelete()========================================================================================</span><br  /><span>//the command sequence to delete a file</span><br  /><span>void</span> fileDelete(<span>String</span> fileName){<br  />  setFileName(fileName);<br  />  <span>delay</span>(20);<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x35);<br  />  <span>if</span>(waitForResponse(<span>"deleting file"</span>)){       <span>//wait for a response from the CH376S. If file has been created successfully, it will return true.</span><br  />     <span>if</span>(getResponseFromUSB()==0x14){          <span>//CH376S will send 0x14 if this command was successful</span><br  />       <span><b>Serial</b></span>.<span>println</span>(<span>"Successfully deleted file"</span>);<br  />     }<br  />  }<br  />}<br  />  <br  /><br  /><span>//filePointer========================================================================================</span><br  /><span>//is used to set the file pointer position. true for beginning of file, false for the end of the file.</span><br  /><span>void</span> filePointer(<span>boolean</span> fileBeginning){<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x39);<br  />  <span>if</span>(fileBeginning){<br  />    USB.<span>write</span>((<span>byte</span>)0x00);             <span>//beginning of file</span><br  />    USB.<span>write</span>((<span>byte</span>)0x00);<br  />    USB.<span>write</span>((<span>byte</span>)0x00);<br  />    USB.<span>write</span>((<span>byte</span>)0x00);<br  />  } <span>else</span> {<br  />    USB.<span>write</span>((<span>byte</span>)0xFF);             <span>//end of file</span><br  />    USB.<span>write</span>((<span>byte</span>)0xFF);<br  />    USB.<span>write</span>((<span>byte</span>)0xFF);<br  />    USB.<span>write</span>((<span>byte</span>)0xFF);<br  />  }<br  />  <span>if</span>(waitForResponse(<span>"setting file pointer"</span>)){       <span>//wait for a response from the CH376S. </span><br  />     <span>if</span>(getResponseFromUSB()==0x14){                 <span>//CH376S will send 0x14 if this command was successful</span><br  />       <span><b>Serial</b></span>.<span>println</span>(<span>"Pointer successfully applied"</span>);<br  />     }<br  />  }<br  />}<br  /><br  /><br  /><span>//fileClose=======================================================================================</span><br  /><span>//closes the file</span><br  /><span>void</span> fileClose(<span>byte</span> closeCmd){<br  />  <span><b>Serial</b></span>.<span>println</span>(<span>"Closing file:"</span>);<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x36);<br  />  USB.<span>write</span>((<span>byte</span>)closeCmd);                                <span>// closeCmd = 0x00 = close without updating file Size, 0x01 = close and update file Size</span><br  /><br  />  <span>if</span>(waitForResponse(<span>"closing file"</span>)){                      <span>// wait for a response from the CH376S. </span><br  />     <span>byte</span> resp = getResponseFromUSB();<br  />     <span>if</span>(resp==0x14){                                        <span>// CH376S will send 0x14 if this command was successful</span><br  />       <span><b>Serial</b></span>.<span>println</span>(<span>">File closed successfully."</span>);<br  />     } <span>else</span> {<br  />       <span><b>Serial</b></span>.<span>print</span>(<span>">Failed to close file. Error code:"</span>);<br  />       <span><b>Serial</b></span>.<span>println</span>(resp, <span>HEX</span>);<br  />     }  <br  />  }<br  />}<br  /><br  /><span>//waitForResponse===================================================================================</span><br  /><span>//is used to wait for a response from USB. Returns true when bytes become available, false if it times out.</span><br  /><span>boolean</span> waitForResponse(<span>String</span> errorMsg){<br  />  <span>boolean</span> bytesAvailable = <span>true</span>;<br  />  <span>int</span> counter=0;<br  />  <span>while</span><!USB><span>available</span>()){     <span>//wait for CH376S to verify command</span><br  />    <span>delay</span>(1);<br  />    counter++;<br  />    <span>if</span>(counter>timeOut){<br  />      <span><b>Serial</b></span>.<span>print</span>(<span>"TimeOut waiting for response: Error while: "</span>);<br  />      <span><b>Serial</b></span>.<span>println</span>(errorMsg);<br  />      bytesAvailable = <span>false</span>;<br  />      <span>break</span>;<br  />    }<br  />  }<br  />  <span>delay</span>(1);<br  />  <span>return</span>(bytesAvailable);<br  />}<br  /><br  /><span>//getResponseFromUSB================================================================================</span><br  /><span>//is used to get any error codes or messages from the CH376S module (in response to certain commands)</span><br  /><span>byte</span> getResponseFromUSB(){<br  />  <span>byte</span> response = <span>byte</span>(0x00);<br  />  <span>if</span> (USB.<span>available</span>()){<br  />    response = USB.<span>read</span>();<br  />  }<br  />  <span>return</span>(response);<br  />}<br  /><br  /><br  /><br  /><span>//blinkLED==========================================================================================</span><br  /><span>//Turn an LED on for 1 second</span><br  /><span>void</span> blinkLED(){<br  />  <span>digitalWrite</span>(LED, <span>HIGH</span>);<br  />  <span>delay</span>(1000);<br  />  <span>digitalWrite</span>(LED,<span>LOW</span>);<br  />}<br  /><br  /></pre> </td> </tr> </table></div></p> <br  /> <p>  If you copy and paste this code directly into the Arduino IDE;  you may get a warning like this when you compile the code:<br  />     <br  />           "Low memory available, stability problems may occur". <br  />          <br  />  I managed to run the sketch without any issues, however, I did experience problems with some of the methods when I had   made further memory hungry modifications. If you do encounter problems, I would recommend that you eliminate any   methods which you do not plan to use, and perhaps reduce the number of Serial.print statements throughout the code.   However, please note that some of the methods will not work unless the module is in the correct state, so be careful which methods you delete.   For example, I found that I could get some simple functionality without the "USBdiskMount()" method. However, I could not   read/write data beyond a certain length without this method.<br  />           <br  />         Also please note, that some of the methods called within the reading and writing sequence   do not need to be called every time. They can be called once in setup, while other methods within the sequence will need to be called every time.   I grouped them all together for simplicity.  </p> <!--separator --><img src="https://images-blogger-opensocial.googleusercontent.com/gadgets/proxy?url=http%3A%2F%2F1.bp.blogspot.com%2F-XQiwNpdqOxk%2FT_rKCzDh4nI%2FAAAAAAAAAQY%2FOfYBljhU6Lk%2Fs1600%2FSeparator.jpg&container=blogger&gadget=a&rewriteMime=image%2F*"  /><br  /> <p><h4>Serial Commands</h4>  Have a look at the following presentation for a summary of the Serial commands used in this tutorial: <br  />     <br  /> <div> </div> </p> </div><p> <div> <!-- Concluding Comments --> </div> <br  />   <br  />   <div> <p> <!--separator --> <img src="https://images-blogger-opensocial.googleusercontent.com/gadgets/proxy?url=http%3A%2F%2F1.bp.blogspot.com%2F-XQiwNpdqOxk%2FT_rKCzDh4nI%2FAAAAAAAAAQY%2FOfYBljhU6Lk%2Fs1600%2FSeparator.jpg&container=blogger&gadget=a&rewriteMime=image%2F*"  /><br  /> <br  /> </p> </div> </p><p> <div>   If you like this page, please do me a favour and show your appreciation : <br  /> <br  />     <br  />   Visit my <a href="https://plus.google.com/u/0/b/107402020974762902161/107402020974762902161/posts">ArduinoBasics Google + page</a>.<br  />   Follow me on Twitter by looking for <a href="https://twitter.com/ArduinoBasics">ScottC @ArduinoBasics</a>.<br  />   I can also be found on <a href="https://www.pinterest.com/ArduinoBasics/">Pinterest</a> and <a href="https://instagram.com/arduinobasics">Instagram</a>. <br  />   Have a look at my videos on my <a href="https://www.youtube.com/user/ScottCMe/videos">YouTube channel</a>.<br  /> </div> </p> <br  /> <div> <p> <!--separator --> <img src="https://images-blogger-opensocial.googleusercontent.com/gadgets/proxy?url=http%3A%2F%2F1.bp.blogspot.com%2F-XQiwNpdqOxk%2FT_rKCzDh4nI%2FAAAAAAAAAQY%2FOfYBljhU6Lk%2Fs1600%2FSeparator.jpg&container=blogger&gadget=a&rewriteMime=image%2F*"  /><br  /> <br  /> </p> </div> <p>  However, if you do not have a google profile... <br  />Feel free to share this page with your friends in any way you see fit.  </p>

CH376S USB Read/Write module

Parallel communication
SPI communication
and Serial (UART) communication.

This project will show you the connections and code for the Serial (UART) communication method only.

Parts Required:

Remove the Jumper

Fritzing Sketch

Arduino Sketch


/* ===============================================================
      Project: CH376S USB Read/Write Module testing ground
       Author: Scott C
      Created: 1st May 2015
  Arduino IDE: 1.6.2
      Website: http://arduinobasics.blogspot.com/p/arduino-basics-projects-page.html
  Description: This project will allow you to perform many of the functions available on the CH376S module.
               Checking connection to the module, putting the module into USB mode, resetting the module, 
               reading, writing, appending text to files on the USB stick. This is very useful alternative to
               SD card modules, plus it doesn't need any libraries.
================================================================== */

#include <SoftwareSerial.h>

byte computerByte;           //used to store data coming from the computer
byte USB_Byte;               //used to store data coming from the USB stick
int LED = 13;                //the LED is connected to digital pin 13 
int timeOut = 2000;          //TimeOut is 2 seconds. This is the amount of time you wish to wait for a response from the CH376S module.
String wrData = "What is the meaning of life ?";     //We will write this data to a newly created file.
String wrData2 = "42";                                   //We will append this data to an already existing file.

SoftwareSerial USB(10, 11);                           // Digital pin 10 on Arduino (RX) connects to TXD on the CH376S module
                                                      // Digital pin 11 on Arduino (TX) connects to RXD on the CH376S module
                                                      // GND on Arduino to GND on CH376S module
                                                      // 5V on Arduino to 5V on CH376S module
//==============================================================================================================================================
void setup() {
  Serial.begin(9600);                                 // Setup serial communication with the computer (using a baud rate of 9600 on serial monitor)
  USB.begin(9600);                                    // Setup serial communication with the CH376S module (using the default baud rate of 9600)
  pinMode(LED,OUTPUT);                                // Define digital pin 13 as an OUTPUT pin - so that we can use it with an LED
  digitalWrite(LED,LOW);                              // Turn off the LED
}

//================================================================================================================================================
void loop() {
  if(Serial.available()){
    computerByte = Serial.read();                      //read any incoming bytes from the Serial monitor, and store this byte in the variable called computerByte
    if(computerByte==49){               //1            //If you send the number 1 from the serial monitor, the arduino will read it as digital number 49. Google "ascii table" for more info.
      printCommandHeader("COMMAND1: CHECK CONNECTION");
      checkConnection(0x01);                           // Check for successful connection and communication with the CH376S module.
    } 
    if(computerByte==50){               //2
     printCommandHeader("COMMAND2: set_USB_Mode");
      set_USB_Mode(0x06);                              // Code used to enable read/write communication and monitoring of the USB stick
    }
    if(computerByte==51){               //3
      printCommandHeader("COMMAND3: resetALL");
      resetALL();                                      // Reset the USB device
    }
    if(computerByte==52){               //4
      printCommandHeader("COMMAND4: Create and Write to File : TEST4.TXT");
      writeFile("TEST4.TXT", wrData);                  // Create a file called TEST4.TXT and then Write the contents of wrData to this file
    }
    if(computerByte==53){               //5
      printCommandHeader("COMMAND5: Read File: TEST4.TXT");
      readFile("TEST4.TXT");                           // Read the contents of this file on the USB disk, and display contents in the Serial Monitor
    }
    if(computerByte==54){               //6
      printCommandHeader("COMMAND6: Append data to file: TEST4.TXT");
      appendFile("TEST4.TXT", wrData2);                // Append data to the end of the file.
    }
    if(computerByte==55){               //7
      printCommandHeader("COMMAND7: Delete File: TEST4.TXT");
      fileDelete("TEST4.TXT");                         // Delete the file named TEST4.TXT
    }
    if(computerByte==56){               //8
      printCommandHeader("COMMAND8: Read File: TEST2.TXT");
      readFile("TEST2.TXT");                           // Read the contents of the TEST2.TXT file on the USB disk, and display contents in the Serial Monitor
    }
    if(computerByte==57){               //9
      printCommandHeader("COMMAND9: Read File: TEST3.TXT");
      readFile("TEST3.TXT");                           // Read the contents of the TEST3.TXT file on the USB disk, and display contents in the Serial Monitor
    }
  }
  
  if(USB.available()){                                 // This is here to capture any unexpected data transmitted by the CH376S module
    Serial.print("CH376S has just sent this code:");
    Serial.println(USB.read(), HEX);
  }
}

//END OF LOOP FUNCTION ========================================================================================================================================

//print Command header
void printCommandHeader(String header){
   Serial.println("======================");
   Serial.println("");
   Serial.println(header);
   Serial.println("----------------------");
}

//checkConnection==================================================================================
//This function is used to check for successful communication with the CH376S module. This is not dependant of the presence of a USB stick.
//Send any value between 0 to 255, and the CH376S module will return a number = 255 - value. 
void checkConnection(byte value){
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x06);
  USB.write(value);
  
  if(waitForResponse("checking connection")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==(255-value)){
       Serial.println(">Connection to CH376S was successful.");
       blinkLED();                               //blink the LED for 1 second if the connection was successful
    } else {
      Serial.print(">Connection to CH376S - FAILED.");
    }
  }
}

//set_USB_Mode=====================================================================================
//Make sure that the USB is inserted when using 0x06 as the value in this specific code sequence
void set_USB_Mode (byte value){
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x15);
  USB.write(value);
  
  delay(20);
  
  if(USB.available()){
    USB_Byte=USB.read();
    //Check to see if the command has been successfully transmitted and acknowledged.
    if(USB_Byte==0x51){                                   // If true - the CH376S has acknowledged the command.
        Serial.println("set_USB_Mode command acknowledged"); //The CH376S will now check and monitor the USB port
        USB_Byte = USB.read();
        
        //Check to see if the USB stick is connected or not.
        if(USB_Byte==0x15){                               // If true - there is a USB stick connected
          Serial.println("USB is present");
          blinkLED();                                     // If the process was successful, then turn the LED on for 1 second 
        } else {
          Serial.print("USB Not present. Error code:");   // If the USB is not connected - it should return an Error code = FFH
          Serial.print(USB_Byte, HEX);
          Serial.println("H");
        }
        
    } else {
        Serial.print("CH3765 error!   Error code:");
        Serial.print(USB_Byte, HEX);
        Serial.println("H");
    }   
  }
  delay(20);
}

//resetALL=========================================================================================
//This will perform a hardware reset of the CH376S module - which usually takes about 35 msecs =====
void resetALL(){
    USB.write(0x57);
    USB.write(0xAB);
    USB.write(0x05);
    Serial.println("The CH376S module has been reset !");
    delay(200);
}

//readFile=====================================================================================
//This will send a series of commands to read data from a specific file (defined by fileName)
void readFile(String fileName){
  resetALL();                     //Reset the module
  set_USB_Mode(0x06);             //Set to USB Mode
  diskConnectionStatus();         //Check that communication with the USB device is possible
  USBdiskMount();                 //Prepare the USB for reading/writing - you need to mount the USB disk for proper read/write operations.
  setFileName(fileName);          //Set File name
  fileOpen();                     //Open the file for reading
  int fs = getFileSize();         //Get the size of the file
  fileRead();                     //***** Send the command to read the file ***
  fileClose(0x00);                //Close the file
}

//writeFile========================================================================================
//is used to create a new file and then write data to that file. "fileName" is a variable used to hold the name of the file (e.g TEST.TXT). "data" should not be greater than 255 bytes long. 
void writeFile(String fileName, String data){
  resetALL();                     //Reset the module
  set_USB_Mode(0x06);             //Set to USB Mode
  diskConnectionStatus();         //Check that communication with the USB device is possible
  USBdiskMount();                 //Prepare the USB for reading/writing - you need to mount the USB disk for proper read/write operations.
  setFileName(fileName);          //Set File name
  if(fileCreate()){               //Try to create a new file. If file creation is successful
    fileWrite(data);              //write data to the file.
  } else {
    Serial.println("File could not be created, or it already exists");
  }
  fileClose(0x01);
}

//appendFile()====================================================================================
//is used to write data to the end of the file, without erasing the contents of the file.
void appendFile(String fileName, String data){
    resetALL();                     //Reset the module
    set_USB_Mode(0x06);             //Set to USB Mode
    diskConnectionStatus();         //Check that communication with the USB device is possible
    USBdiskMount();                 //Prepare the USB for reading/writing - you need to mount the USB disk for proper read/write operations.
    setFileName(fileName);          //Set File name
    fileOpen();                     //Open the file
    filePointer(false);             //filePointer(false) is to set the pointer at the end of the file.  filePointer(true) will set the pointer to the beginning.
    fileWrite(data);                //Write data to the end of the file
    fileClose(0x01);                //Close the file using 0x01 - which means to update the size of the file on close. 
}
  
//setFileName======================================================================================
//This sets the name of the file to work with
void setFileName(String fileName){
  Serial.print("Setting filename to:");
  Serial.println(fileName);
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x2F);
  USB.write(0x2F);         // Every filename must have this byte to indicate the start of the file name.
  USB.print(fileName);     // "fileName" is a variable that holds the name of the file.  eg. TEST.TXT
  USB.write((byte)0x00);   // you need to cast as a byte - otherwise it will not compile.  The null byte indicates the end of the file name.
  delay(20);
}

//diskConnectionStatus================================================================================
//Check the disk connection status
void diskConnectionStatus(){
  Serial.println("Checking USB disk connection status");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x30);

  if(waitForResponse("Connecting to USB disk")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x14){               //CH376S will send 0x14 if this command was successful
       Serial.println(">Connection to USB OK");
    } else {
      Serial.print(">Connection to USB - FAILED.");
    }
  }
}

//USBdiskMount========================================================================================
//initialise the USB disk and check that it is ready - this process is required if you want to find the manufacturing information of the USB disk
void USBdiskMount(){
  Serial.println("Mounting USB disk");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x31);

  if(waitForResponse("mounting USB disk")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x14){               //CH376S will send 0x14 if this command was successful
       Serial.println(">USB Mounted - OK");
    } else {
      Serial.print(">Failed to Mount USB disk.");
    }
  }
}

//fileOpen========================================================================================
//opens the file for reading or writing
void fileOpen(){
  Serial.println("Opening file.");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x32);
  if(waitForResponse("file Open")){                 //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x14){                 //CH376S will send 0x14 if this command was successful  
       Serial.println(">File opened successfully.");
    } else {
      Serial.print(">Failed to open file.");
    }
  }
}

//setByteRead=====================================================================================
//This function is required if you want to read data from the file. 
boolean setByteRead(byte numBytes){
  boolean bytesToRead=false;
  int timeCounter = 0;
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x3A);
  USB.write((byte)numBytes);   //tells the CH376S how many bytes to read at a time
  USB.write((byte)0x00);
  if(waitForResponse("setByteRead")){       //wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.
    if(getResponseFromUSB()==0x1D){         //read the CH376S message. If equal to 0x1D, data is present, so return true. Will return 0x14 if no data is present.
      bytesToRead=true;
    }
  }
  return(bytesToRead);
} 

//getFileSize()===================================================================================
//writes the file size to the serial Monitor.
int getFileSize(){
  int fileSize=0;
  Serial.println("Getting File Size");
  USB.write(0x57);
  USB.write(0xAB);
  USB.write(0x0C);
  USB.write(0x68);
  delay(100);
  Serial.print("FileSize =");
  if(USB.available()){
    fileSize = fileSize + USB.read();
  } 
  if(USB.available()){
    fileSize = fileSize + (USB.read()*255);
  } 
  if(USB.available()){
    fileSize = fileSize + (USB.read()*255*255);
  } 
  if(USB.available()){
    fileSize = fileSize + (USB.read()*255*255*255);
  }     
  Serial.println(fileSize);
  delay(10);
  return(fileSize);
}


//fileRead========================================================================================
//read the contents of the file
void fileRead(){
  Serial.println("Reading file:");
  byte firstByte = 0x00;                     //Variable to hold the firstByte from every transmission.  Can be used as a checkSum if required.
  byte numBytes = 0x40;                      //The maximum value is 0x40  =  64 bytes
 
  while(setByteRead(numBytes)){              //This tells the CH376S module how many bytes to read on the next reading step. In this example, we will read 0x10 bytes at a time. Returns true if there are bytes to read, false if there are no more bytes to read.
    USB.write(0x57);
    USB.write(0xAB);
    USB.write(0x27);                          //Command to read ALL of the bytes (allocated by setByteRead(x))
    if(waitForResponse("reading data")){      //Wait for the CH376S module to return data. TimeOut will return false. If data is being transmitted, it will return true.
        firstByte=USB.read();                 //Read the first byte
        while(USB.available()){
          Serial.write(USB.read());           //Send the data from the USB disk to the Serial monitor
          delay(1);                           //This delay is necessary for successful Serial transmission
        }
    }
    if<!continueRead()){><span>//prepares the module for further reading. If false, stop reading.</span><br  />      <span>break</span>;                                   <span>//You need the continueRead() method if the data to be read from the USB device is greater than numBytes.</span><br  />    }<br  />  }<br  />  <span><b>Serial</b></span>.<span>println</span>();<br  />  <span><b>Serial</b></span>.<span>println</span>(<span>"NO MORE DATA"</span>);<br  />}<br  /><br  /><span>//fileWrite=======================================================================================</span><br  /><span>//are the commands used to write to the file</span><br  /><span>void</span> fileWrite(<span>String</span> data){<br  />  <span><b>Serial</b></span>.<span>println</span>(<span>"Writing to file:"</span>);<br  />  <span>byte</span> dataLength = (<span>byte</span>) data.<span>length</span>();         <span>// This variable holds the length of the data to be written (in bytes)</span><br  />  <span><b>Serial</b></span>.<span>println</span>(data);<br  />  <span><b>Serial</b></span>.<span>print</span>(<span>"Data Length:"</span>);<br  />  <span><b>Serial</b></span>.<span>println</span>(dataLength);<br  />  <span>delay</span>(100);<br  />  <span>// This set of commands tells the CH376S module how many bytes to expect from the Arduino.  (defined by the "dataLength" variable)</span><br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x3C);<br  />  USB.<span>write</span>((<span>byte</span>) dataLength);<br  />  USB.<span>write</span>((<span>byte</span>) 0x00);<br  />  <span>if</span>(waitForResponse(<span>"setting data Length"</span>)){      <span>// Wait for an acknowledgement from the CH376S module before trying to send data to it</span><br  />    <span>if</span>(getResponseFromUSB()==0x1E){                <span>// 0x1E indicates that the USB device is in write mode.</span><br  />      USB.<span>write</span>(0x57);<br  />      USB.<span>write</span>(0xAB);<br  />      USB.<span>write</span>(0x2D);<br  />      USB.<span>print</span>(data);                             <span>// write the data to the file</span><br  />  <br  />      <span>if</span>(waitForResponse(<span>"writing data to file"</span>)){   <span>// wait for an acknowledgement from the CH376S module</span><br  />      }<br  />      <span><b>Serial</b></span>.<span>print</span>(<span>"Write code (normally FF and 14): "</span>);<br  />      <span><b>Serial</b></span>.<span>print</span>(USB.<span>read</span>(),<span>HEX</span>);                <span>// code is normally 0xFF</span><br  />      <span><b>Serial</b></span>.<span>print</span>(<span>","</span>);<br  />      USB.<span>write</span>(0x57);<br  />      USB.<span>write</span>(0xAB);<br  />      USB.<span>write</span>(0x3D);                             <span>// This is used to update the file size. Not sure if this is necessary for successful writing.</span><br  />      <span>if</span>(waitForResponse(<span>"updating file size"</span>)){   <span>// wait for an acknowledgement from the CH376S module</span><br  />      }<br  />      <span><b>Serial</b></span>.<span>println</span>(USB.<span>read</span>(),<span>HEX</span>);              <span>//code is normally 0x14</span><br  />    }<br  />  }<br  />}<br  /><br  /><span>//continueRead()==================================================================================</span><br  /><span>//continue to read the file : I could not get this function to work as intended.</span><br  /><span>boolean</span> continueRead(){<br  />  <span>boolean</span> readAgain = <span>false</span>;<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x3B);<br  />  <span>if</span>(waitForResponse(<span>"continueRead"</span>)){       <span>//wait for a response from the CH376S. If CH376S responds, it will be true. If it times out, it will be false.</span><br  />     <span>if</span>(getResponseFromUSB()==0x14){         <span>//CH376S will send 0x14 if this command was successful</span><br  />       readAgain=<span>true</span>;<br  />     }<br  />  }<br  />  <span>return</span>(readAgain);<br  />} <br  /><br  /><span>//fileCreate()========================================================================================</span><br  /><span>//the command sequence to create a file</span><br  /><span>boolean</span> fileCreate(){<br  />  <span>boolean</span> createdFile = <span>false</span>;<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x34);<br  />  <span>if</span>(waitForResponse(<span>"creating file"</span>)){       <span>//wait for a response from the CH376S. If file has been created successfully, it will return true.</span><br  />     <span>if</span>(getResponseFromUSB()==0x14){          <span>//CH376S will send 0x14 if this command was successful</span><br  />       createdFile=<span>true</span>;<br  />     }<br  />  }<br  />  <span>return</span>(createdFile);<br  />}<br  /><br  /><br  /><span>//fileDelete()========================================================================================</span><br  /><span>//the command sequence to delete a file</span><br  /><span>void</span> fileDelete(<span>String</span> fileName){<br  />  setFileName(fileName);<br  />  <span>delay</span>(20);<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x35);<br  />  <span>if</span>(waitForResponse(<span>"deleting file"</span>)){       <span>//wait for a response from the CH376S. If file has been created successfully, it will return true.</span><br  />     <span>if</span>(getResponseFromUSB()==0x14){          <span>//CH376S will send 0x14 if this command was successful</span><br  />       <span><b>Serial</b></span>.<span>println</span>(<span>"Successfully deleted file"</span>);<br  />     }<br  />  }<br  />}<br  />  <br  /><br  /><span>//filePointer========================================================================================</span><br  /><span>//is used to set the file pointer position. true for beginning of file, false for the end of the file.</span><br  /><span>void</span> filePointer(<span>boolean</span> fileBeginning){<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x39);<br  />  <span>if</span>(fileBeginning){<br  />    USB.<span>write</span>((<span>byte</span>)0x00);             <span>//beginning of file</span><br  />    USB.<span>write</span>((<span>byte</span>)0x00);<br  />    USB.<span>write</span>((<span>byte</span>)0x00);<br  />    USB.<span>write</span>((<span>byte</span>)0x00);<br  />  } <span>else</span> {<br  />    USB.<span>write</span>((<span>byte</span>)0xFF);             <span>//end of file</span><br  />    USB.<span>write</span>((<span>byte</span>)0xFF);<br  />    USB.<span>write</span>((<span>byte</span>)0xFF);<br  />    USB.<span>write</span>((<span>byte</span>)0xFF);<br  />  }<br  />  <span>if</span>(waitForResponse(<span>"setting file pointer"</span>)){       <span>//wait for a response from the CH376S. </span><br  />     <span>if</span>(getResponseFromUSB()==0x14){                 <span>//CH376S will send 0x14 if this command was successful</span><br  />       <span><b>Serial</b></span>.<span>println</span>(<span>"Pointer successfully applied"</span>);<br  />     }<br  />  }<br  />}<br  /><br  /><br  /><span>//fileClose=======================================================================================</span><br  /><span>//closes the file</span><br  /><span>void</span> fileClose(<span>byte</span> closeCmd){<br  />  <span><b>Serial</b></span>.<span>println</span>(<span>"Closing file:"</span>);<br  />  USB.<span>write</span>(0x57);<br  />  USB.<span>write</span>(0xAB);<br  />  USB.<span>write</span>(0x36);<br  />  USB.<span>write</span>((<span>byte</span>)closeCmd);                                <span>// closeCmd = 0x00 = close without updating file Size, 0x01 = close and update file Size</span><br  /><br  />  <span>if</span>(waitForResponse(<span>"closing file"</span>)){                      <span>// wait for a response from the CH376S. </span><br  />     <span>byte</span> resp = getResponseFromUSB();<br  />     <span>if</span>(resp==0x14){                                        <span>// CH376S will send 0x14 if this command was successful</span><br  />       <span><b>Serial</b></span>.<span>println</span>(<span>">File closed successfully."</span>);<br  />     } <span>else</span> {<br  />       <span><b>Serial</b></span>.<span>print</span>(<span>">Failed to close file. Error code:"</span>);<br  />       <span><b>Serial</b></span>.<span>println</span>(resp, <span>HEX</span>);<br  />     }  <br  />  }<br  />}<br  /><br  /><span>//waitForResponse===================================================================================</span><br  /><span>//is used to wait for a response from USB. Returns true when bytes become available, false if it times out.</span><br  /><span>boolean</span> waitForResponse(<span>String</span> errorMsg){<br  />  <span>boolean</span> bytesAvailable = <span>true</span>;<br  />  <span>int</span> counter=0;<br  />  <span>while</span><!USB><span>available</span>()){     <span>//wait for CH376S to verify command</span><br  />    <span>delay</span>(1);<br  />    counter++;<br  />    <span>if</span>(counter>timeOut){<br  />      <span><b>Serial</b></span>.<span>print</span>(<span>"TimeOut waiting for response: Error while: "</span>);<br  />      <span><b>Serial</b></span>.<span>println</span>(errorMsg);<br  />      bytesAvailable = <span>false</span>;<br  />      <span>break</span>;<br  />    }<br  />  }<br  />  <span>delay</span>(1);<br  />  <span>return</span>(bytesAvailable);<br  />}<br  /><br  /><span>//getResponseFromUSB================================================================================</span><br  /><span>//is used to get any error codes or messages from the CH376S module (in response to certain commands)</span><br  /><span>byte</span> getResponseFromUSB(){<br  />  <span>byte</span> response = <span>byte</span>(0x00);<br  />  <span>if</span> (USB.<span>available</span>()){<br  />    response = USB.<span>read</span>();<br  />  }<br  />  <span>return</span>(response);<br  />}<br  /><br  /><br  /><br  /><span>//blinkLED==========================================================================================</span><br  /><span>//Turn an LED on for 1 second</span><br  /><span>void</span> blinkLED(){<br  />  <span>digitalWrite</span>(LED, <span>HIGH</span>);<br  />  <span>delay</span>(1000);<br  />  <span>digitalWrite</span>(LED,<span>LOW</span>);<br  />}<br  /><br  /></pre> </td> </tr> </table></div></p> <br  /> <p>  If you copy and paste this code directly into the Arduino IDE;  you may get a warning like this when you compile the code:<br  />     <br  />           "Low memory available, stability problems may occur". <br  />          <br  />  I managed to run the sketch without any issues, however, I did experience problems with some of the methods when I had   made further memory hungry modifications. If you do encounter problems, I would recommend that you eliminate any   methods which you do not plan to use, and perhaps reduce the number of Serial.print statements throughout the code.   However, please note that some of the methods will not work unless the module is in the correct state, so be careful which methods you delete.   For example, I found that I could get some simple functionality without the "USBdiskMount()" method. However, I could not   read/write data beyond a certain length without this method.<br  />           <br  />         Also please note, that some of the methods called within the reading and writing sequence   do not need to be called every time. They can be called once in setup, while other methods within the sequence will need to be called every time.   I grouped them all together for simplicity.  </p> <!--separator --><img src="https://images-blogger-opensocial.googleusercontent.com/gadgets/proxy?url=http%3A%2F%2F1.bp.blogspot.com%2F-XQiwNpdqOxk%2FT_rKCzDh4nI%2FAAAAAAAAAQY%2FOfYBljhU6Lk%2Fs1600%2FSeparator.jpg&container=blogger&gadget=a&rewriteMime=image%2F*"  /><br  /> <p><h4>Serial Commands</h4>  Have a look at the following presentation for a summary of the Serial commands used in this tutorial: <br  />     <br  /> <div> </div> </p> </div><p> <div> <!-- Concluding Comments --> </div> <br  />   <br  />   <div> <p> <!--separator --> <img src="https://images-blogger-opensocial.googleusercontent.com/gadgets/proxy?url=http%3A%2F%2F1.bp.blogspot.com%2F-XQiwNpdqOxk%2FT_rKCzDh4nI%2FAAAAAAAAAQY%2FOfYBljhU6Lk%2Fs1600%2FSeparator.jpg&container=blogger&gadget=a&rewriteMime=image%2F*"  /><br  /> <br  /> </p> </div> </p><p> <div>   If you like this page, please do me a favour and show your appreciation : <br  /> <br  />     <br  />   Visit my <a href="https://plus.google.com/u/0/b/107402020974762902161/107402020974762902161/posts">ArduinoBasics Google + page</a>.<br  />   Follow me on Twitter by looking for <a href="https://twitter.com/ArduinoBasics">ScottC @ArduinoBasics</a>.<br  />   I can also be found on <a href="https://www.pinterest.com/ArduinoBasics/">Pinterest</a> and <a href="https://instagram.com/arduinobasics">Instagram</a>. <br  />   Have a look at my videos on my <a href="https://www.youtube.com/user/ScottCMe/videos">YouTube channel</a>.<br  /> </div> </p> <br  /> <div> <p> <!--separator --> <img src="https://images-blogger-opensocial.googleusercontent.com/gadgets/proxy?url=http%3A%2F%2F1.bp.blogspot.com%2F-XQiwNpdqOxk%2FT_rKCzDh4nI%2FAAAAAAAAAQY%2FOfYBljhU6Lk%2Fs1600%2FSeparator.jpg&container=blogger&gadget=a&rewriteMime=image%2F*"  /><br  /> <br  /> </p> </div> <p>  However, if you do not have a google profile... <br  />Feel free to share this page with your friends in any way you see fit.  </p>

Reading from a Text File and Sending to Arduino

The following tutorial will demonstrate how to Read values from a Text file (.txt, .csv) to blink 1 of 9 LEDs attached to an Arduino. It uses the combination of an Arduino and Processing program to process the file. The Processing program will read the text file in real time, only sending new information to the Arduino.

Components Required

Arduino UNO
Breadboard
9 LEDs
9 x 330 ohm resistors
Wires to connect the circuit
USB connection cable: to connect the computer to the Arduino
A computer: to run the processing sketch, and to compile / upload the Arduino sketch
Processing Program installed on computer
Arduino Program installed on the computer
A comma separated text file (*.txt).

Arduino Layout

The Text File

Open Notepad or equivalent text file editor, and paste the following data into it.

1,2,3,4,5,6,7,8,9,8,7,6,5,4,3,2,1

Save the file on your hard drive. In my case, I have chosen to save the file at this location.

D:/mySensorData.txt

It should look like the following screenshot

Additional notes regarding the Text file:

Just remember what you call it, and where you saved it, because we will be referring to this file later on in the Processing script.
Keep all values on the same line.
Separate each number with a comma.
The number 1 will blink the first LED which is attached to Pin 2 on the Arduino.
The number 9 will blink the last LED which is attached to Pin 10 on the Arduino.

Processing Code

You can download the Processing IDE from this site.


style="color: blue;">import processing.serial.*;

style="color: blue;">import java.io.*;

style="color: rgb(43, 145, 175);">int mySwitch=0;

style="color: rgb(43, 145, 175);">int counter=0;
String [] subtext;
Serial myPort;



style="color: rgb(43, 145, 175);">void setup(){
 
style="color: green;">//Create a switch that will control the frequency of text file reads.
 
style="color: green;">//When mySwitch=1, the program is setup to read the text file.
 
style="color: green;">//This is turned off when mySwitch = 0
 mySwitch=1;
 
 
style="color: green;">//Open the serial port for communication with the Arduino
 
style="color: green;">//Make sure the COM port is correct
 myPort = 
style="color: blue;">new Serial(this, 
style="color: rgb(163, 21, 21);">"COM6", 9600);
 myPort.bufferUntil(
style="color: rgb(163, 21, 21);">'\n');
}


style="color: rgb(43, 145, 175);">void draw() {
 
style="color: blue;">if (mySwitch>0){
 
style="color: green;">/*The readData function can be found later in the code.

style="color: green;"> This is the call to read a CSV file on the computer hard-drive. */
 readData(
style="color: rgb(163, 21, 21);">"D:/mySensorData.txt");
 
 
style="color: green;">/*The following switch prevents continuous reading of the text file, until

style="color: green;"> we are ready to read the file again. */
 mySwitch=0;
 }
 
style="color: green;">/*Only send new data. This IF statement will allow new data to be sent to

style="color: green;"> the arduino. */
 
style="color: blue;">if(counter<subtext.length){
 
style="color: green;">/* Write the next number to the Serial port and send it to the Arduino 

style="color: green;"> There will be a delay of half a second before the command is

style="color: green;"> sent to turn the LED off : myPort.write('0'); */
 myPort.write(subtext[counter]);
 delay(500);
 myPort.write(
style="color: rgb(163, 21, 21);">'0');
 delay(100);
 
style="color: green;">//Increment the counter so that the next number is sent to the arduino.
 counter++;
 } 
style="color: blue;">else{
 //If the text file has run out of numbers, then read the text file again in 5 seconds.
 delay(5000);
 mySwitch=1;
 }
} 



style="color: green;">/* The following function will read from a CSV or TXT file */

style="color: rgb(43, 145, 175);">void readData(String myFileName){
 
 File file=
style="color: blue;">new File(myFileName);
 BufferedReader br=
style="color: blue;">null;
 
 try{
 br=
style="color: blue;">new BufferedReader(
style="color: blue;">new FileReader(file));
 String text=
style="color: blue;">null;
 
 
style="color: green;">/* keep reading each line until you get to the end of the file */
 
style="color: blue;">while((text=br.readLine())!=
style="color: blue;">null){
 /* Spilt each line up into bits and pieces using a comma as a separator */
 subtext = splitTokens(text,
style="color: rgb(163, 21, 21);">",");
 }
 }
style="color: blue;">catch(FileNotFoundException e){
 e.printStackTrace();
 }
style="color: blue;">catch(IOException e){
 e.printStackTrace();
 }
style="color: blue;">finally{
 try {
 
style="color: blue;">if (br != null){
 br.close();
 }
 } 
style="color: blue;">catch (IOException e) {
 e.printStackTrace();
 }
 }
}

I used this site to highlight and format my code.

Once you have copied the text above into the Processing IDE, you can now start working on the Arduino code as seen below.

Arduino Code

You can download the Arduino IDE from this site.

Copy and paste the following code into the Arduino IDE.


style="color: green;">/* This program was created by ScottC on 8/5/2012 to receive serial 

style="color: green;">signals from a computer to turn on/off 1-9 LEDs */


style="color: rgb(43, 145, 175);">void setup() { 
 
style="color: green;">// initialize the digital pins as an output.
 pinMode(2, OUTPUT);
 pinMode(3, OUTPUT);
 pinMode(4, OUTPUT);
 pinMode(5, OUTPUT);
 pinMode(6, OUTPUT);
 pinMode(7, OUTPUT);
 pinMode(8, OUTPUT);
 pinMode(9, OUTPUT);
 pinMode(10, OUTPUT);

style="color: green;">// Turn the Serial Protocol ON
 Serial.begin(9600);
}


style="color: rgb(43, 145, 175);">void loop() {
 
style="color: rgb(43, 145, 175);">byte byteRead;

 
style="color: green;">/* check if data has been sent from the computer: */
 
style="color: blue;">if (Serial.available()) {
 
 
style="color: green;">/* read the most recent byte */
 byteRead = Serial.read();
 
style="color: green;">//You have to subtract '0' from the read Byte to convert from text to a number.
 byteRead=byteRead-
style="color: rgb(163, 21, 21);">'0';
 
 
style="color: green;">//Turn off all LEDs if the byte Read = 0
 
style="color: blue;">if(byteRead==0){
 
style="color: green;">//Turn off all LEDS
 digitalWrite(2, LOW);
 digitalWrite(3, LOW);
 digitalWrite(4, LOW);
 digitalWrite(5, LOW);
 digitalWrite(6, LOW);
 digitalWrite(7, LOW);
 digitalWrite(8, LOW);
 digitalWrite(9, LOW);
 digitalWrite(10, LOW);
 }
 
 
style="color: green;">//Turn LED ON depending on the byte Read.
 
style="color: blue;">if(byteRead>0){
 digitalWrite((byteRead+1), HIGH); 
style="color: green;">// set the LED on
 }
 }
 }

Additional Information:

The Arduino code will still work without the processing program. You can open the serial monitor window to send the commands to the Arduino manually. In fact, if you encounter any problems, I would suggest you do this. It will help to identify the root cause of the problem (ie Processing or Arduino Code, or physical connections).
If you choose to use the Serial Monitor feature of the Arduino IDE, you cannot use the Processing program at the same time.

Once you have assembled the Arduino with all the wires, LEDs, resistors etc, you should now be ready to put it all together and get this baby cranking!

Connecting it all together

Connect the USB cable from your computer to the Arduino, and upload the code.
Keep the USB cable connected between the Arduino and the computer, as this will become the physical connection needed by the Processing Program
Make sure that you have the text file in the correct location on your hard drive, and that it only contains numbers relevant to the code provided (separated by commas).
Run the Processing program and watch the LEDs blink in the sequence described by the text file.
You can add more numbers to the end of the line, however, the processing program will not be aware of them until you save the file. The text file does not have to be closed.

Other programs can be used to create text file, but you will need the processing program to read the file and send the values to the Arduino. The Arduino will receive each value and react appropriately.

SIMILAR PROJECT: Use a mouse to control the LEDs on your Arduino - see this post.

An alternative Processing Sketch

This Processing sketch uses the loadStrings()method instead of the FileReader method used in the first sketch. This sketch also provides better control over sending the values to the Arduino. When the sketch first loads, the application window will be red. By clicking your mouse inside the window, the background will turn green and the file will be imported and sent to the Arduino, with every value being sent at half second intervals. If you update the text file and save, only new values will be transmitted, however, if you want the entire file to transmit again, you can press the window once (to reset the counter), and then again to read the file and send the values again from the beginning of the file.
I personally like this updated version better than the first, plus I was inspired to update this blog posting due to the fact that some people were having problems with the FileReader method in the first sketch. But both sketches should work (they worked for me).


style="color: rgb(0, 128, 0);">/* TextFile Sender: Written by Scott C on 5th April 2013

style="color: rgb(0, 128, 0);"> using Processing Version 2.0b8 */

import processing.serial.*;

Serial comPort;

style="color: rgb(43, 145, 175);">int counter=0; 
style="color: rgb(0, 128, 0);">// Helps to keep track of values sent.

style="color: rgb(43, 145, 175);">int numItems=0; 
style="color: rgb(0, 128, 0);">//Keep track of the number of values in text file
boolean sendStrings=
style="color: rgb(0, 0, 255);">false; 
style="color: rgb(0, 128, 0);">//Turns sending on and off
StringLoader sLoader; 
style="color: rgb(0, 128, 0);">//Used to send values to Arduino


style="color: rgb(43, 145, 175);">void setup(){
 comPort = 
style="color: rgb(0, 0, 255);">new Serial(
style="color: rgb(0, 0, 255);">this, Serial.list()[0], 9600);
 background(255,0,0); 
style="color: rgb(0, 128, 0);">//Start with a Red background
}


style="color: rgb(43, 145, 175);">void draw(){
}



style="color: rgb(43, 145, 175);">void mousePressed() {
 
style="color: rgb(0, 128, 0);">//Toggle between sending values and not sending values
 sendStrings=!sendStrings;
 
 
style="color: rgb(0, 128, 0);">//If sendStrings is True - then send values to Arduino
 
style="color: rgb(0, 0, 255);">if(sendStrings){
 background(0,255,0); 
style="color: rgb(0, 128, 0);">//Change the background to green
 
 
style="color: rgb(0, 128, 0);">/*When the background is green, transmit

style="color: rgb(0, 128, 0);"> text file values to the Arduino */
 sLoader=
style="color: rgb(0, 0, 255);">new StringLoader();
 sLoader.start();
 }
style="color: rgb(0, 0, 255);">else{
 background(255,0,0); 
style="color: rgb(0, 128, 0);">//Change background to red
 
style="color: rgb(0, 128, 0);">//Reset the counter
 counter=0;
 }
}




style="color: rgb(0, 128, 0);">/*============================================================*/

style="color: rgb(0, 128, 0);">/* The StringLoader class imports data from a text file

style="color: rgb(0, 128, 0);"> on a new Thread and sends each value once every half second */

style="color: rgb(0, 0, 255);">public 
style="color: rgb(0, 0, 255);">class 
style="color: rgb(43, 145, 175);">StringLoader extends Thread{
 
 
style="color: rgb(0, 0, 255);">public StringLoader(){
 
style="color: rgb(0, 128, 0);">//default constructor
 }
 
 
style="color: rgb(0, 0, 255);">public 
style="color: rgb(43, 145, 175);">void run() {
 String textFileLines[]=loadStrings(
style="color: rgb(163, 21, 21);">"d:/mySensorData.txt");
 String lineItems[]=splitTokens(textFileLines[0], 
style="color: rgb(163, 21, 21);">",");
 numItems=lineItems.length;
 
style="color: rgb(0, 0, 255);">for(
style="color: rgb(43, 145, 175);">int i = counter; i<numItems; i++){
 comPort.write(lineItems[i]);
 delay(500);
 comPort.write(
style="color: rgb(163, 21, 21);">"0");
 }
 counter=numItems;
 }
}

ScottC 09 May 14:09

arduino arduinobasics best arduino blog blink code comma csv delimitted file led processing project read serial text values

Posts 1—3 from 3

ArduinoMania

Updates

Search

Add blog

Tags

Posts with «read» label

CH376S USB Read/Write module

Parts Required:

Remove the Jumper

Fritzing Sketch

Arduino Sketch

CH376S USB Read/Write module

Parts Required:

Remove the Jumper

Fritzing Sketch

Arduino Sketch

Reading from a Text File and Sending to Arduino

Components Required

Arduino Layout

The Text File

Processing Code

Arduino Code

Connecting it all together

An alternative Processing Sketch