Skip to content

Commit f8e089a

Browse files
committed
Release 3.0.0
Documentation updated for release
1 parent 69beff5 commit f8e089a

16 files changed

Lines changed: 124 additions & 8 deletions

.vitepress/config.mts

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,15 @@ export default defineConfig({
2929
{ text: "Extensions", link: "/development/extensions" },
3030
],
3131
},
32+
{
33+
text: "Display",
34+
items: [
35+
{ text: "Generic HDMI", link: "/display/generic-hdmi" },
36+
{ text: "SSD1322 OLED (256×64)", link: "/display/ssd1322-oled" },
37+
{ text: "SSD1306 OLED (128×64)", link: "/display/ssd1306-oled" },
38+
{ text: 'Waveshare 2.8" DSI LCD (480×640)', link: "/display/waveshare-28-dsi-lcd" },
39+
],
40+
},
3241

3342
{
3443
text: "Extensions",

development/architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@ aside: false
55
# Architecture
66

77
<br>
8-
<img src="/images/architecture.svg" class="full-width-img" />
8+
<img src="/images/architecture.png" class="full-width-img" />

display/generic-hdmi.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
outline: deep
3+
4+
---
5+
# Generic HDMI
6+
7+
The built-in HDMI display extension enables high-quality video output and display management for supported devices.
8+
While berryaudio supports all displays with HDMI inputs. Please let us know on the community if your specific display is not supported.

display/ssd1306-oled.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
outline: deep
3+
4+
---
5+
# SSD1306 OLED Display
6+
7+
The SSD1306 is a 128×64 pixel monochrome OLED display driver, commonly found in compact 0.96" and 1.3" modules. It connects via I2C on address on <b>0x3c</b>. and is one of the most popular displays in the maker community due to its affordability and sharp contrast.
8+
9+
10+
<img src="/images/ssd1306_front.png" />
11+
<br>
12+
13+
## Connections
14+
15+
<img src="/images/ssd1306_pin.png" />
16+
17+
18+
## Pin Assignments
19+
<img src="/images/pi_pinouts.png" />

display/ssd1322-oled.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
outline: deep
3+
aside: false
4+
---
5+
# SSD1322 OLED Display
6+
7+
The SSD1322 is a 256×64 pixel grayscale OLED display driver that supports 16 levels of gray scale, making it ideal for displaying detailed graphics and smooth gradients. Unlike simpler monochrome displays, its grayscale capability allows for richer visual presentations. The display connects via SPI interface and is commonly found in 3.2" modules, offering excellent contrast and viewing angles thanks to OLED technology. Its relatively high resolution and grayscale support make it popular for berryaudio projects where visual quality matters compared to commercial ones
8+
9+
Demo: https://youtu.be/ijRanBypx6A
10+
11+
<img src="/images/ssd1322_front.png" />
12+
<br>
13+
14+
## Connections
15+
Make sure the Resistors are connected as seen the picture below.
16+
You may need to move the R6 resistor to R5
17+
18+
<img src="/images/ssd1322_back.png" />
19+
20+
21+
## Pin Assignments
22+
<img src="/images/pi_pinouts.png" />

display/waveshare-28-dsi-lcd.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
outline: deep
3+
---
4+
# Waveshare 2.8inch Capacitive Touch Display
5+
The built-in display extension enables high-quality touch display output and screen management for this display on Raspberry Pi devices. It supports a 480×640 IPS panel with optical bonding for enhanced clarity and up to 60Hz refresh rate over the native DSI interface. The display features five-point capacitive touch control with a 6H hardened toughened glass panel, and can manage backlight brightness programmatically via software. Compatible with Pi 5, CM5, 4B, CM4, 3B+, 3A+, 3B, CM3+, and CM3.
6+
7+
Just connect the display using the DSI ribbon cable as shown in the picture below and select it from the display settings in BerryAudio — no additional configuration required.
8+
9+
For further more information can be found on https://www.waveshare.com/wiki/2.8inch_DSI_LCD
10+
11+
Demo: https://youtu.be/UTv22oXzdd4?si=LcFwvi-BHtpjuOQB
12+
13+
## Connections
14+
15+
<img src="/images/ws_28_dsi_lcd_front.jpeg" />

getting-started/installation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ To avoid any complex configurations and keep the setup simple, the easiest way t
2727
## Connecting to Network
2828

2929
- After the Pi finishes booting, it will start in AP mode.
30-
- You should see a Wi-Fi hotspot named `berryaudio`. Connect to this network from your device.
30+
- You should see a Wi-Fi hotspot named `berryaudio` password `goberryaudio`. Connect to this network from your device.
3131
- Incase your connected via Ethernet, you can skip the above step and continue to the next section.
3232
- If everything went well, you can now access Berryaudio from your browse on http://berryaudio.local
3333
- Optionally you may go to Settings → Network, scan for available networks, and connect to your Wi-Fi SSID.

getting-started/supported-hardware.md

Lines changed: 49 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,12 +60,11 @@ Berryaudio has been tested on the following Raspberry Pi (Bookworm OS). While it
6060
<td>Raspberry Pi 5</td>
6161
<td>CPU: Quad‑core Cortex‑A76 Memory: 1/2/4/8/16 GB Wi‑Fi: 802.11ac Bluetooth: 5/BLE</td>
6262
<td><a href="https://www.raspberrypi.com/products/raspberry-pi-5/">Link</a></td>
63-
<td>-</td>
63+
<td>Tested</td>
6464
</tr>
6565
</tbody>
6666
</table>
6767

68-
6968
## Audio Boards
7069

7170
Below are the list of DACs that have been tested and are confirmed to work out of the box. More will be added as testing progresses. If you have a DAC you’d like to see supported, or are able to provide a board for testing, we’d be happy to include it on the platform—your contributions are always welcome!
@@ -123,4 +122,51 @@ Below are the list of DACs that have been tested and are confirmed to work out o
123122
<td>Tested</td>
124123
</tr>
125124
</tbody>
126-
</table>
125+
</table>
126+
127+
## Displays
128+
129+
Below are the list of Displays that have been tested and are confirmed to work out of the box. More will be added as testing progresses. If you have a Display you’d like to see supported, or are able to provide a board for testing, we’d be happy to include it on the platform—your contributions are always welcome!
130+
131+
<table>
132+
<thead>
133+
<tr>
134+
<th width="30%">Display Name</th>
135+
<th width="20%">Resolution</th>
136+
<th width="10%">Type</th>
137+
<th width="10%">Protocol</th>
138+
<th width="10%">Setup</th>
139+
<th width="5%">Link</th>
140+
<th width="5%">Status</th>
141+
</tr>
142+
</thead>
143+
<tbody>
144+
<tr>
145+
<td>SSD1322</td>
146+
<td>256x64</td>
147+
<td>OLED</td>
148+
<td>SPI</td>
149+
<td><a href="/display/ssd1322-oled.html">Setup</a></td>
150+
<td><a href="https://www.amazon.de/Gvvsjgdbis-Display-SSD1322-Parallel-Lötstift/dp/B0DSZCTGF9/">Link</a></td>
151+
<td>Tested</td>
152+
</tr>
153+
<tr>
154+
<td>SSD1306</td>
155+
<td>128x64</td>
156+
<td>OLED</td>
157+
<td>I2C</td>
158+
<td><a href="/display/ssd1306-oled.html">Setup</a></td>
159+
<td><a href="https://www.amazon.de/-/en/AZDelivery-OLED-Parent-Pixel-Inches/dp/B01L9GC470/">Link</a></td>
160+
<td>Tested</td>
161+
</tr>
162+
<tr>
163+
<td>Waveshare 2.8" DSI LCD</td>
164+
<td>640x480</td>
165+
<td>LCD</td>
166+
<td>DSI</td>
167+
<td><a href="/display/waveshare-28-dsi-lcd.html">Setup</a></td>
168+
<td><a href="https://www.waveshare.com/2.8inch-dsi-lcd.htm">Link</a></td>
169+
<td>Tested</td>
170+
</tr>
171+
</tbody>
172+
</table>

public/images/architecture.png

66.5 KB
Loading

public/images/architecture.svg

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)