Skip to content

Commit f16e37b

Browse files
committed
Update documentation and examples
1 parent b56a153 commit f16e37b

File tree

7 files changed

+71
-611
lines changed

7 files changed

+71
-611
lines changed

README.md

Lines changed: 15 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,9 @@ To use this library in your PlatformIO project, simply add to your `platformio.i
2222

2323
```
2424
lib_deps =
25-
baldram/ESP_VS1053_Library
25+
ESP_VS1053_Library
2626
```
27+
or `lib_deps = 1744` .
2728

2829
From your `.cpp` or `.ino` code include VS1053 library.
2930

@@ -75,23 +76,19 @@ Log.notice("Hello, this is a debug message!");
7576

7677
An example for ESP8266 based board like eg. LoLin NodeMCU V3 or WeMos D1 R2.
7778

78-
```
79-
80-
---------------------
81-
| VS1053 | ESP8266 |
82-
---------------------
83-
| SCK | D5 |
84-
| MISO | D6 |
85-
| MOSI | D7 |
86-
| XRST | RST |
87-
| CS | D1 |
88-
| DCS | D0 |
89-
| DREQ | D3 |
90-
| 5V | VU |
91-
| GND | G |
92-
---------------------
93-
94-
```
79+
| VS1053 | ESP8266 |
80+
|----------|----------|
81+
| SCK | D5 |
82+
| MISO | D6 |
83+
| MOSI | D7 |
84+
| XRST | RST |
85+
| CS | D1 |
86+
| DCS | D0 |
87+
| DREQ | D3 |
88+
| 5V | VU |
89+
| GND | G |
90+
91+
For ESP32 and other boards wiring examples please see thread [Supported hardware](https://github.com/baldram/ESP_VS1053_Library/issues/1) and [Tested boards](https://github.com/baldram/ESP_VS1053_Library/blob/master/doc/SimpleMp3Player/tested-boards.md) list.
9592

9693
<img alt="VS1053B and NodeMCU v3" title="VS1053B and NodeMCU v3" src="https://user-images.githubusercontent.com/16861531/27875071-3ead1674-61b2-11e7-9a69-02edafa7b286.jpg" width="300px" />
9794

doc/tested-boards.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
#### ESP_VS1053_Library tested and compatible boards
2+
3+
---
4+
5+
Known working targets:
6+
7+
* ESP8266 based **LoLin NodeMCU V3** (ESP-12F) with **LC Technology VS1053** MP3 Codec board<br />
8+
([click here](https://github.com/baldram/ESP_VS1053_Library/issues/1#issuecomment-313163772) for additional information and photos),
9+
* ESP8266 based **RobotDyn WiFi D1 R2** (ESP-8266 EX) with **LC Technology VS1053** MP3 Codec board<br />
10+
([click here](https://github.com/baldram/ESP_VS1053_Library/issues/1#issuecomment-313163772) for additional information and photos)
11+
* ESP32 based board **Espressif ESP32 DevKitC** / ESP32 Core Board V2 (ESP-WROOM-32) with **LC Technology VS1053** MP3 Codec board<br />
12+
([click here](https://github.com/baldram/ESP_VS1053_Library/issues/1#issuecomment-313907348) for additional information and photos)
13+
* ...
14+
15+
No information:
16+
17+
* everything else!
18+
19+
**Please report any known working combinations** so I can update this!<br />
20+
An issue to test working targets was [created here](https://github.com/baldram/ESP_VS1053_Library/issues/1), so it's possible to simply leave a comment.<br />
21+
A **pull request** to update this file is also **very welcome**!

examples/SimpleMp3Player/SimpleMp3Player.cpp

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,9 @@
2121
| GND | G |
2222
---------------------
2323
24-
Note: It's just an example, you may use a different pins definition
24+
Note: It's just an example, you may use a different pins definition.
25+
For ESP32 example, please follow the link:
26+
https://github.com/baldram/ESP_VS1053_Library/issues/1#issuecomment-313907348
2527
2628
To run this example define the platformio.ini as below.
2729
@@ -31,12 +33,17 @@
3133
framework = arduino
3234
3335
lib_deps =
34-
baldram/ESP_VS1053_Library
36+
ESP_VS1053_Library
3537
3638
*/
3739

3840
#include <Arduino.h>
39-
#include <VS1053.h> // this ESP_VS1053_Library
41+
42+
// This ESP_VS1053_Library
43+
#include <VS1053.h>
44+
45+
// Please find helloMp3.h file here:
46+
// https://github.com/baldram/ESP_VS1053_Library/blob/master/examples/SimpleMp3Player/helloMp3.h
4047
#include <helloMp3.h>
4148

4249
// Wiring of VS1053 board (SPI connected in a standard way)

examples/SimpleMp3PlayerWithDebug/SimpleMp3PlayerWithDebug.cpp

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,9 @@
2525
| GND | G |
2626
---------------------
2727
28-
Note: It's just an example, you may use a different pins definition
28+
Note: It's just an example, you may use a different pins definition.
29+
For ESP32 example, please follow the link:
30+
https://github.com/baldram/ESP_VS1053_Library/issues/1#issuecomment-313907348
2931
3032
To run this example define the platformio.ini as below.
3133
@@ -35,13 +37,20 @@
3537
framework = arduino
3638
3739
lib_deps =
38-
baldram/ESP_VS1053_Library
40+
ESP_VS1053_Library
3941
4042
*/
4143

4244
#include <Arduino.h>
43-
#include <ArduinoLog.h> // PlatformIO library id=1532
44-
#include <VS1053.h> // this ESP_VS1053_Library
45+
46+
// ArduinoLog.h is PlatformIO library id=1532
47+
#include <ArduinoLog.h>
48+
49+
// This ESP_VS1053_Library
50+
#include <VS1053.h>
51+
52+
// Please find helloMp3.h file here:
53+
// https://github.com/baldram/ESP_VS1053_Library/blob/master/examples/SimpleMp3Player/helloMp3.h
4554
#include <helloMp3.h>
4655

4756
// Wiring of VS1053 board (SPI connected in a standard way)

0 commit comments

Comments
 (0)