https://github.com/victornpb/evc_pt2257

Arduino C++ Library for using PT2257 - Electronic Volume Controller IC
https://github.com/victornpb/evc_pt2257

arduino arduino-library cpp digital-potentiometer i2c

Last synced: 3 months ago
JSON representation

Arduino C++ Library for using PT2257 - Electronic Volume Controller IC

• Host: GitHub
• URL: https://github.com/victornpb/evc_pt2257
• Owner: victornpb
• Created: 2015-03-19T03:35:46.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2019-06-04T03:17:39.000Z (over 5 years ago)
• Last Synced: 2024-10-04T15:51:27.114Z (4 months ago)
• Topics: arduino, arduino-library, cpp, digital-potentiometer, i2c
• Language: C
• Homepage:
• Size: 489 KB
• Stars: 14
• Watchers: 10
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Evc_pt2257

Arduino Library for using PT2257 - Electronic Volume Controller IC (a.k.a Digital Potentiometer)

Connect the IC to the following pins, you can change it in the .c file.  

Pull-up resistors are required on both pins (4K7 or 10K should be fine).  

> `SCL => A0`   

> `SDA => A1`   

 

 Datasheet - http://www.princeton.com.tw/Portals/0/Product/PT2257.pdf

```

Pinout

   |----._.----|

1 -| Lin   Rin |- 8

2 -| Lout Rout |- 7

3 -| Gnd    V+ |- 6

4 -| SDA   SCL |- 5

   |-----------|

```

## API

Volume Attenuation are expressed as **unsigned** integers  

e.g. : to set the attenuation to -21dB express it as `21`

- `void evc_init();`  

  Start the I2C communication  

  *Call this on setup(); to ensure a reliable initialization, this will delay for 200ms.*

- `void evc_setVolume(uint8_t dB);`  

  Set the attenuation on both channels (between 0dB and -79dB)

- `void evc_setVolumeLeft(uint8_t dB);`  

  Set the attenuation on the Left channel (between 0dB and -79dB)  

  Use this for implementing left/right balance offset.

- `void evc_setVolumeRight(uint8_t dB);`  

  Set the attenuation on the right channel (between 0dB and -79dB)  

  Use this for implementing left/right balance offset.

- `void evc_mute(bool toggle);`  

  **toggle**:

    - *true*: Mute both channels.  

      This mode have an effective attenuation of -95dB (+5/-2dB) 

    - *false*: Unmute both channels.

    

  **Note:** It will preserve the set Volume when mute is toggled 

  (This behavior is not documented on the datasheet).  

- `void evc_off();`  

  Function OFF (-79dB)  

  *The exact purpose of this instruction is not clear on the datasheet.*

----

## Initialization

The datasheet does not mention anything about it being volatile or not, but it seems to hold state after power cycle, I'm not sure about about if it's just an artifact, but I recommend setting it to a known state just after initialization, so you will not be in a situation that you are changing volume but nothing happens because you have mute on, after a power cycle. So does not expect it to be in a known state just after power on, handle it yourself.

```

void setup(){

    evc_init();

    

    //ensure power on consistency

    evc_setVolume(79);

    evc_mute(false);

	...

    /* recover state from arduino eeeprom if desired */

	//set the volume to stored state.

}

```

----

## Suggestions / Questions

File a [issue](https://github.com/victornpb/Evc_pt2257/issues) on this repository.