Pages: [1]   Go Down
Author Topic: NewTone Library - Plug-in replacement for Tone library - Better, smaller, faster  (Read 4840 times)
0 Members and 1 Guest are viewing this topic.
Toledo, OH
Offline Offline
Sr. Member
****
Karma: 19
Posts: 455
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Why another tone library?
I'd already written a highly optimized toneAC library because I needed higher volume, volume control, higher frequency, and better quality.  However, toneAC uses fixed timer 1 PWM pins so it's not as flexible.  Making toneAC work like tone was simple and there would be several advantages over the tone library, so I spent an hour and made NewTone from the toneAC library.

What does it do better/differently?
  • About 1,200 bytes smaller code size than the Tone library.
  • Faster execution time.
  • Exclusive use of port registers for fastest and smallest code.
  • Higher quality sound output than tone library.
  • Uses timer 1 which may free up conflicts with the tone library.

How do I use it?
It's a plug-in replacement for the standard tone library.  Add the include, use NewTone() instead of tone() and noNewTone() instead of noTone() to enjoy the benefits.  If you're running out of program space or have a timer conflict with the tone library, this is the library for you.  See the sketch below for an example.

Download: NewTone v1.0

If you're looking to save even more space and more features like almost twice as loud output and volume control, check out my toneAC library as well.

Example sketch
Code:
#include <NewTone.h>

#define TONE_PIN 2 // Pin you have speaker/piezo connected to (be sure to include a 100 ohm resistor).

// Melody (liberated from the toneMelody Arduino example sketch by Tom Igoe).
int melody[] = { 262, 196, 196, 220, 196, 0, 247, 262 };
int noteDurations[] = { 4, 8, 8, 4, 4, 4, 4, 4 };

void setup() {} // Nothing to setup, just start playing!

void loop() {
  for (unsigned long freq = 125; freq <= 15000; freq += 10) {  
    NewTone(TONE_PIN, freq); // Play the frequency (125 Hz to 15 kHz sweep in 10 Hz steps).
    delay(1); // Wait 1 ms so you can hear it.
  }
  noNewTone(TONE_PIN); // Turn off the tone.

  delay(1000); // Wait a second.

  for (int thisNote = 0; thisNote < 8; thisNote++) { // Loop through the notes in the array.
    int noteDuration = 1000/noteDurations[thisNote];
    NewTone(TONE_PIN, melody[thisNote], noteDuration); // Play thisNote for noteDuration.
    delay(noteDuration * 4 / 3); // Wait while the tone plays in the background, plus another 33% delay between notes.
  }

  while(1); // Stop (so it doesn't repeat forever driving you crazy--you're welcome).
}

Tim
« Last Edit: January 21, 2013, 01:55:54 am by teckel » Logged

Arduino Uno - Teensy 2.0 - Teensy 3.0 - Raspberry Pi Model B w/512MB RAM
My libraries: NewPing library - LCDBitmap library - toneAC library - NewTone library

SE USA
Offline Offline
Faraday Member
**
Karma: 40
Posts: 3783
@ssh0le
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

does it work with mega?
Logged


Toledo, OH
Offline Offline
Sr. Member
****
Karma: 19
Posts: 455
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

does it work with mega?

Yup, should work with all ATmega microcontrollers.  Tested on my Uno and Teensy 2.0, which are totally different.  Doesn't hard code port register values so it should work on all platforms.  I use the same technique with NewPing and compatibility is universal for any ATmega microcontroller.  Will be simple to confirm it works.

Tim
« Last Edit: January 21, 2013, 01:57:15 am by teckel » Logged

Arduino Uno - Teensy 2.0 - Teensy 3.0 - Raspberry Pi Model B w/512MB RAM
My libraries: NewPing library - LCDBitmap library - toneAC library - NewTone library

0
Offline Offline
Newbie
*
Karma: 0
Posts: 35
Arduino rocks
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

Hi have been trying to adapt to use it on Timer "4" on the mega
As i can not use it on Timer 1 as it then conflicts width my PWM signals on the MEGA 2560  ;-(
I am trying to drive a speedometer
as you see i have just tryed to change the 1 to 4 not sure i know what i am doing
Any reply greatly appriciatet ;-)

I have changed here

NewTone.h

#define TIMSK4 TIMSK //#define TIMSK1 TIMSK

NewTone.cpp

ICR4    = top;                     // Set the top.
  if (TCNT4 > top) TCNT4 = top;      // Counter over the top, put within range.
  TCCR4B  = _BV(WGM40)  | prescaler; // Set PWM, phase and frequency corrected (ICR1) and prescaler.
  TCCR4A  = _BV(COM4B0);
  TIMSK4 |= _BV(OCIE4A);             // Activate the timer interrupt.

TIMSK4 &= ~_BV(OCIE4A);   // Remove the timer interrupt.
  TCCR4B  = _BV(CS40);      // Default clock prescaler of 8.
  TCCR4A  = _BV(WGM40);     // Set to defaults so PWM can work like normal (PWM, phase corrected, 8bit).

ISR(TIMER4_COMPA_vect) { // Timer interrupt vector.
Logged

Toledo, OH
Offline Offline
Sr. Member
****
Karma: 19
Posts: 455
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Hi have been trying to adapt to use it on Timer "4" on the mega
As i can not use it on Timer 1 as it then conflicts width my PWM signals on the MEGA 2560  ;-(
I am trying to drive a speedometer
as you see i have just tryed to change the 1 to 4 not sure i know what i am doing
Any reply greatly appriciatet ;-)

I have changed here

NewTone.h

#define TIMSK4 TIMSK //#define TIMSK1 TIMSK

NewTone.cpp

ICR4    = top;                     // Set the top.
  if (TCNT4 > top) TCNT4 = top;      // Counter over the top, put within range.
  TCCR4B  = _BV(WGM40)  | prescaler; // Set PWM, phase and frequency corrected (ICR1) and prescaler.
  TCCR4A  = _BV(COM4B0);
  TIMSK4 |= _BV(OCIE4A);             // Activate the timer interrupt.

TIMSK4 &= ~_BV(OCIE4A);   // Remove the timer interrupt.
  TCCR4B  = _BV(CS40);      // Default clock prescaler of 8.
  TCCR4A  = _BV(WGM40);     // Set to defaults so PWM can work like normal (PWM, phase corrected, 8bit).

ISR(TIMER4_COMPA_vect) { // Timer interrupt vector.


It doesn't just conflict with the PWM signals, it replaces them.  It's by design.  Instead, why not just use PWM for timer 4 for whatever else you're doing?

One of the main purposes of NewTone is to use a different timer than the standard tone library.

In any case, I don't really know the ATmega2560 to know off the top of my head if there's any differences between timer 1 and timer 4.  Are they identical?  For example, if timer 4 doesn't have all the features of timer 1, it won't work.  It doesn't appear it's identical as it has 3 pins tied to timer 4 while timer 1 only has 2.

Without diving into the ATmega2560 technical documentation, I'll be hard-pressed to help.

Instead, I would suggest using my ToneAC library (there's an alternate version which uses timer 2).  It's superior to NewTone anyway and is already written to use timer 2 and can be assigned to any pins.

Tim
« Last Edit: April 11, 2013, 05:02:39 pm by teckel » Logged

Arduino Uno - Teensy 2.0 - Teensy 3.0 - Raspberry Pi Model B w/512MB RAM
My libraries: NewPing library - LCDBitmap library - toneAC library - NewTone library

0
Offline Offline
Newbie
*
Karma: 0
Posts: 35
Arduino rocks
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

Hi Thanks for you reply
but i have solved it

Width great help from this Forum :-)

http://arduino.cc/forum/index.php/topic,157602.0.html

Thanks
Ole
Logged

US
Offline Offline
Full Member
***
Karma: 4
Posts: 182
Electronics are the new Legos
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

this could be awesome if the library was also Due compatible
Logged

Toledo, OH
Offline Offline
Sr. Member
****
Karma: 19
Posts: 455
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

this could be awesome if the library was also Due compatible

I don't find the Due relevant, so I don't consider support for it.  Also, as NewTone uses port registers and direct timer calls, it doesn't really work well for the Due which is totally different than the ATmega.

Tim
Logged

Arduino Uno - Teensy 2.0 - Teensy 3.0 - Raspberry Pi Model B w/512MB RAM
My libraries: NewPing library - LCDBitmap library - toneAC library - NewTone library

US
Offline Offline
Full Member
***
Karma: 4
Posts: 182
Electronics are the new Legos
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

I don't find the Due relevant, so I don't consider support for it. 

Supposedly it is the future as they did not stick with a compatible processor.  Many have written suitable timer control libraries so the work would not be from datasheet scratch.
Logged

Offline Offline
Newbie
*
Karma: 0
Posts: 34
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

Hi,
i've some problems using the cool NewTone Library together with RCSwitch-Library (using interrupt on pin 2)

I can play sound several times correctly (always using the same function), and than it suddenly stopps playing any sound, while everything else is working fine.
Shure both libs use timers and this will harm the sound quality, but why isn't it working any more?
PLZ gibe advice what i'm doing wrong or if there's an workaround.

i'm still on arduino 1.0.1 and i'm using an arduino nano V3. The code isn't pretty..sorry for that.

MANY MANY thanks for your replys

Code:
#include <RemoteReceiver.h>
#include <RemoteTransmitter.h>
#include <NewRemoteReceiver.h>
#include <InterruptChain.h>
#include <SerialCommand.h>

#include <NewTone.h>

int *currentMelody;
int *currentMelodyDurations;
int currentMelodyPosition = 0;
int currentMelodyLength = 0;
int pace = 1150; // music speed

int melodyBeep[] = {NOTE_C5, NOTE_C6};
int noteDurationsBeep[] = {8, 16};
int melodyBeepLength = 2;

int melodyUp[] = {NOTE_C4, NOTE_D4, NOTE_G4};
int noteDurationsUp[] = {4, 8, 16}; 
int melodyUpLength = 3;

int melodyDown[] = {NOTE_G4, NOTE_D4, NOTE_C4};
int noteDurationsDown[] = {4, 8, 16}; 
int melodyDownLength = 3;

int melodyAlarm[] = {NOTE_C6, NOTE_G6, NOTE_C6, NOTE_G5, NOTE_C7, NOTE_C6};
int noteDurationsAlarm[] = {16, 16, 8, 8, 4, 8}; 
int melodyAlarmLength = 6;

// pin for the piezzo buzzer
const int BuzzerPin = 3;
 
// set the pin where the RF transmitter is connected to
const int transmitterPin = 4;

//duration of a RF command
const unsigned int period = 326;

boolean playsound = false;
boolean playloop = false;

// amount of identical codes to receiver before trigger showCode function
int CodeRepetitions = 5;

SerialCommand SCmd;   // initialise the SerialCommand object

void setup() {
  // Initialise the serial port
  Serial.begin(9600);
  Serial.println("HomeSecurityRFbridge running on Arduino Nano V3.0");
  // Initialize receiver on interrupt 0 (= digital pin 2), calls the callback "showCode"
  // after CodeRepetitions (3) identical codes have been received in a row. (thus, keep the button pressed
  // for a moment)


  // And once more, interrupt -1 to indicate you will call the interrupt handler with InterruptChain

  // Interrupt -1 to indicate you will call the interrupt handler with InterruptChain
  RemoteReceiver::init(-1, 2, showOldCode);

  // Again, interrupt -1 to indicate you will call the interrupt handler with InterruptChain
  NewRemoteReceiver::init(-1, 2, showNewCode);


  // On interrupt, call the interrupt handlers of remote and sensor receivers
  InterruptChain::addInterruptCallback(0, RemoteReceiver::interruptHandler);
  InterruptChain::addInterruptCallback(0, NewRemoteReceiver::interruptHandler);


 // Serial.print("Setting up callbacks for SerialCommands...");
  // Setup callbacks for SerialCommand commands
  //Serial.print("hello [optional arg] (replys welcome string or RE:arg) ");
  SCmd.addCommand("hello",SayHello);     // Echos the string argument back
  //Serial.print("|P [arg1] [arg2] (processes two arg commands) ");
  SCmd.addCommand("P",process_command);  // Converts two arguments to integers and echos them back
  //Serial.print("|S [arg] (sends arg) ");
  SCmd.addCommand("S",process_switch_command);  // Converts two arguments to integers and echos them back
  SCmd.addCommand("BU",BeepUp);  // Converts two arguments to integers and echos them back
  SCmd.addCommand("BD",BeepDown);  // Converts two arguments to integers and echos them back
  SCmd.addCommand("STOP",StopAudio);  // Converts two arguments to integers and echos them back
  SCmd.addCommand("BEEP",Beep);  // Converts two arguments to integers and echos them back
  SCmd.addCommand("ALARM",Alarm);  // Converts two arguments to integers and echos them back
  SCmd.setDefaultHandler(unrecognized);  // Handler for command that isn't matched  (says "What?")
  //Serial.println("...ok");

}

void loop() {
  while (playsound && currentMelodyPosition<currentMelodyLength) {
      int duration = pace/currentMelodyDurations[currentMelodyPosition];//Adjust duration with the pace of music
      NewTone(BuzzerPin,currentMelody[currentMelodyPosition],duration);
      int time = millis() + duration*1.2;
      while (millis()<time) {
        SCmd.readSerial();     // We don't do much, just process serial commands
      }
      currentMelodyPosition++;
      if (playloop && currentMelodyPosition==currentMelodyLength) {
          currentMelodyPosition=0;
      }
  }
  SCmd.readSerial();     // We don't do much, just process serial commands
}


void BeepUp() {
  currentMelody = &melodyUp[0];
  currentMelodyDurations = &noteDurationsUp[0];
  currentMelodyLength = melodyUpLength;
  currentMelodyPosition = 0;
  playsound = true;
  playloop = false;
  //tone(BuzzerPin,NOTE_C5,1000/2);
}

void BeepDown() {
  currentMelody = &melodyDown[0];
  currentMelodyDurations = &noteDurationsDown[0];
  currentMelodyLength = melodyDownLength;
  currentMelodyPosition = 0;
  playsound = true;
  playloop = false;
//  tone(BuzzerPin,NOTE_C1,1000/2);
}

void Beep() {
  currentMelody = &melodyBeep[0];
  currentMelodyDurations = &noteDurationsBeep[0];
  currentMelodyLength = melodyBeepLength;
  currentMelodyPosition = 0;
  playsound = true;
  playloop = false;
//  tone(BuzzerPin,NOTE_C3,1000/2);
}

void Alarm() {
  currentMelody = &melodyAlarm[0];
  currentMelodyDurations = noteDurationsAlarm;
  currentMelodyLength = melodyAlarmLength;
  currentMelodyPosition = 0;
  playsound = true;
  playloop = true;
}

void StopAudio() {
  playsound = false;
  playloop = false;
  currentMelodyLength = 0;
  currentMelodyPosition = 0;
  noNewTone(BuzzerPin);
}


// shows the received code sent from an old-style remote switch
void showOldCode(unsigned long receivedCode, unsigned int period) {
  // Print the received code.
  Serial.print("@OC,C:");
  Serial.print(receivedCode);
  Serial.print(",P:");
  Serial.print(period);
  Serial.println("#");
}

// Shows the received code sent from an new-style remote switch
void showNewCode(NewRemoteCode receivedCode) {
  // Print the received code.
  Serial.print("@NC,A:");
  Serial.print(receivedCode.address);

  if (receivedCode.groupBit) {
    Serial.print(",G:");
  }
  else {
    Serial.print(",U");
    Serial.print(receivedCode.unit);
  }

  switch (receivedCode.switchType) {
  case 0:
    Serial.print(",S:0");
    break;
  case 1:
    Serial.print(",S:1");
    break;
  case 2:
    Serial.print(",D:");
    Serial.print(receivedCode.dimLevel);
    break;
  }

  Serial.print(",P:");
  Serial.print(receivedCode.period);
  Serial.println("#");
}




// process the HELLO command from USB
void SayHello()
{
  char *arg; 
  arg = SCmd.next();    // Get the next argument from the SerialCommand object buffer
  if (arg != NULL)      // As long as it existed, take it
  {
    Serial.print("RE:");
    Serial.println(arg);
  }
  else {
    Serial.println("HomeSecurityRFbridge running on Arduino Nano V3.0");
  }
}


// process the serial data from USB
void process_command()   
{
  long aNumber; 
  char *arg;

  //Serial.println("arduino is in process_command");
  arg = SCmd.next();
  if (arg != NULL)
  {
    aNumber=atoi(arg);    // Converts a char string to an integer
    //Serial.print("First argument was: ");
    //Serial.println(aNumber);
  }
  else {
    //Serial.println("No arguments");
  }

  arg = SCmd.next();
  if (arg != NULL)
  {
    aNumber=atol(arg);
    //Serial.print("Second argument was: ");
    //Serial.println(aNumber);
  }
  else {
    //Serial.println("No second argument");
  }

}


// process the switch command from USB
void process_switch_command()   
{
  unsigned long CodeToSend; 
  char *arg1;
  int PeriodToSend; 
  char *arg2;

  //Serial.println("arduino is in process_switch_command");
  arg1 = SCmd.next();
  if (arg1 != NULL)
  {
    CodeToSend=atol(arg1);    // Converts a char string to an integer
    //Serial.print("code to send: ");
    //Serial.println(CodeToSend);

    arg2 = SCmd.next();
    if (arg2 != NULL)
    {
      PeriodToSend=atol(arg2);
      //Serial.print("period: ");
      //Serial.println(PeriodToSend);
    }
    else {
      //Serial.println("using standard period");
      PeriodToSend = period;
    }
    send_switch(CodeToSend,PeriodToSend);
  }
  else {
    //Serial.println("No arguments -> no send!");
  }



}


// This gets set as the default handler, and gets called when no other command matches.
void unrecognized(const char *command) {
  Serial.println("What?");
}





void send_switch(unsigned long CodeToSend, unsigned int PeriodToSend)   
{
  // Disable the receiver; otherwise it might pick up the retransmit as well.
  RemoteReceiver::disable();

  // Need interrupts for delay()
  interrupts();

  // Retransmit the signal 8 times ( == 2^3) on pin 11. Note: no object was created!
  RemoteTransmitter::sendCode(transmitterPin, CodeToSend, PeriodToSend, 3);

  RemoteReceiver::enable();
}
Logged

Offline Offline
Newbie
*
Karma: 0
Posts: 1
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

Hi,

I am trying to generate a freq of 1hz till 600khz. I think toneAC can do it but what is the max freq that newtone can generate?

Also can it be used on a Arduino Nano?

Thanks

Roy
Logged

Belgium
Offline Offline
Newbie
*
Karma: 0
Posts: 1
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Hi,

This new tone lib is very cool

Thanks a lot !

Here below a sample of french movie picture melody.



Code:
#define o3C 262
#define o3Cd 277
#define o3D 294
#define o3Dd 311
#define o3E 330
#define o3F 349
#define o3Fd 370
#define o3G 392
#define o3Gd 415
#define o3A 440
#define o3Ad 466
#define o3B 494
#define o4C 523
#define o4Cd 554
#define o4D 587
#define o4Dd 622
#define o4E 659
#define o4F 698
#define o4Fd 740
#define o4G 784
#define o4Gd 830
#define o4A 880
#define o4Ad 932
#define o4B 988
#define ooo 0

#include <NewTone.h>
#define TONE_PIN 12
int tempo = 650;

// freq,duration, etc ..
int measures[] =
{
o3A,4,o3A,4,o3A,4,o3A,4,
o3A,8,o3Gd,8,o3A,8,o3B,8,o4C,2,
o3B,8,o4D,8,o4C,3,o3B,8,o3A,8,o3Gd,8,
o3A,8,o4E,8,o4C,8,o4E,8,o3A,8,o3E,8,o3Fd,8,o3Gd,8,
o3A,4,o3A,4,o3A,4,o3A,4,
o3A,8,o3Gd,8,o3A,8,o3B,8,o4C,2,
o3B,8,o4D,8,o4C,3,o3B,8,o3A,8,o3Gd,8,
o3A,8,o4E,8,o4C,8,o4E,8,o3A,2,
o4D,4,o4D,4,o4D,4,o4D,4,
o4D,8,o4Cd,8,o4D,8,o4E,8,o4F,2,
o4C,4,o4C,4,o4C,4,o4C,4,
o4C,8,o3B,8,o4C,8,o4D,8,o4E,2,
o3Ad,4,o3Ad,4,o3Ad,4,o3Ad,4,
o3Ad,8,o3A,8,o3B,8,o4C,8,o4D,8,o4C,8,o3B,8,o4D,8,
o3A,8,o3E,8,o3Fd,8,o3Gd,8,o3A,8,o4E,8,o4C,8,o4E,8,
o3A,2,ooo,4
};

void setup() {}

void loop()
{
for (int i = 0; i < sizeof(measures)/2; i=i+2)
{
if (measures[i]>0) NewTone(TONE_PIN, measures[i], tempo/measures[i+1]);
delay(tempo/measures[i+1] * 1.333);
}
noNewTone(TONE_PIN);

}

I would like to made some music to my robot, but I can't use virtualwire lib with new tone lib because timers is sames for both libraries.
I've found another servo lib than original who have same problem. This is fixed.
( it is sofware servo: http://playground.arduino.cc/ComponentLib/Servo)

But not with virtual wire.

Virtual wire use timer1 (16 bits resolution). NewTone lib too.

some informations found about timers here:
http://letsmakerobots.com/node/28278

It is possible to unusable or change timer ?

thx
Logged

ef!

Pages: [1]   Go Up
Jump to: