DR-0001 - Revision history

Yoyojacky: /* 3. Files Created / Modified */

2026-08-21T06:17:30Z

3. Files Created / Modified

← Older revision		Revision as of 14:17, 21 August 2026
Line 610:		Line 610:
	splitting), rewritten as one <code>--key=value</code> per line; demo.py then ran		splitting), rewritten as one <code>--key=value</code> per line; demo.py then ran
	successfully		successfully
	\|-
	~~\| <code>ssd1306_raw.py</code> \|\| Created \|\| Library-free SSD1306 driver; writes~~
	~~registers directly via smbus2 (PIL used only for pixel rendering)~~
	\|-
	~~\| <code>OLED_128x32_I2C_manual.md</code> \|\| Created / updated \|\| Bilingual~~
	~~operation manual; added the regulator/supply-voltage rule and the hardware-failure~~
	~~criterion~~
	\|-
	~~\| <code>SSD1306_Debug_Report_EN.md</code> \|\| Created \|\| Full English debugging~~
	~~report and operation guide~~
	\|}		\|}


	No files in luma.oled / luma.core or the example scripts were modified.		No files in luma.oled / luma.core or the example scripts were modified.

Yoyojacky: /* Run the library-free raw driver */

2026-08-21T06:15:46Z

Run the library-free raw driver

← Older revision		Revision as of 14:15, 21 August 2026
Line 649:		Line 649:


	~~===Run the library-free raw driver===~~
	~~<pre>~~
	~~python ssd1306_raw.py # 0.96" 128x64~~
	~~python ssd1306_raw.py --height 32 # 0.91" 128x32 (this panel)~~
	~~python ssd1306_raw.py --addr 0x3D # modules with address 0x3D~~
	~~</pre>~~
	=== Minimal code (luma)===		=== Minimal code (luma)===

Yoyojacky: /* 6. Black-Screen Decision Tree (for future modules) */

2026-08-21T06:15:07Z

6. Black-Screen Decision Tree (for future modules)

← Older revision		Revision as of 14:15, 21 August 2026
Line 678:		Line 678:
	<strong>Yes</strong> → software/parameter issue; use the matching parameters (`-d ssd1306 --width 128 --height 32 --i2c-address 0x3c`).		<strong>Yes</strong> → software/parameter issue; use the matching parameters (`-d ssd1306 --width 128 --height 32 --i2c-address 0x3c`).
	<strong>No</strong> → continue.		<strong>No</strong> → continue.

	* Status-register test: does bit 6 flip after `0xAF`/`0xAE`?
	<strong>Yes</strong> (chip executes commands, panel still dark) → charge pump/panel hardware. Check whether the module has a regulator: AMS1117 → power with 5 V; no regulator → power with 3.3 V. Still dark at the correct voltage → defective module, return it.
	~~<strong>No</strong> → module-level fault (reset circuit / dead IC), return it.~~

	==Keywords==		==Keywords==
	* 1U Rackmount for Raspberry Pi 5 with M.2 NVMe SSD support.		* 1U Rackmount for Raspberry Pi 5 with M.2 NVMe SSD support.

Yoyojacky: /* 2. What Was Done, Step by Step (Method and Basis) */

2026-08-21T06:14:45Z

2. What Was Done, Step by Step (Method and Basis)

← Older revision		Revision as of 14:14, 21 August 2026
Line 597:		Line 597:
	\| 5 consecutive bus scans + 10 consecutive status reads \|\| All values stable and		\| 5 consecutive bus scans + 10 consecutive status reads \|\| All values stable and
	identical — ruled out loose wiring and parasitic power		identical — ruled out loose wiring and parasitic power
	\|-
	~~\| 3.3V / 5V supply switching test \|\| Modules with an AMS1117 regulator require 5V;~~
	~~bare modules without a regulator require 3.3V. The working module lit at 3.3V~~
	\|}		\|}


	===3. Files Created / Modified===		===3. Files Created / Modified===

Yoyojacky: /* 1. Executive Summary — What Was Actually Wrong */

2026-08-19T05:33:04Z

1. Executive Summary — What Was Actually Wrong

@@ Line 550: / Line 550: @@
 <strong>Nothing was wrong with the code, the luma library, or the SSD1306 register configuration.</strong>
 No library or example source code was modified. The failures came from hardware and
-configuration, in three layers:
+configuration, in one layers:
-. <strong>Two defective display modules.</strong>  The driver IC responded on I2C and executed
+<strong>A parameter mismatch in the examples.</strong>  The examples in this directory default to
    `ssd1305 / 128×64`; this panel is `ssd1306 / 128×32`. Running without parameters
    produces a black or garbled screen. The fix is to pass the correct display, interface,
    geometry and address — done via the config file `ssd1306_128x32.conf`.
 === 2. What Was Done, Step by Step (Method and Basis)===

Yoyojacky: /* FAQ */

2026-08-19T05:18:30Z

FAQ

← Older revision		Revision as of 13:18, 19 August 2026
Line 540:		Line 540:

	==FAQ==		==FAQ==
	* SSD1306 OLED Black-Screen Debugging Report & Operation Guide		=== SSD1306 OLED Black-Screen Debugging Report & Operation Guide===

	<strong>Target hardware:</strong> 0.91" OLED, 128×32 px, SSD1306, I2C, address 0x3C, Raspberry Pi 5		<strong>Target hardware:</strong> 0.91" OLED, 128×32 px, SSD1306, I2C, address 0x3C, Raspberry Pi 5

Yoyojacky: /* Keywords */

2026-08-19T05:18:09Z

Keywords

Show changes

Yoyojacky: /* Install SSD1306 driver libarary for OLED 0.91 */

2026-08-19T03:00:52Z

Install SSD1306 driver libarary for OLED 0.91

← Older revision		Revision as of 11:00, 19 August 2026
Line 159:		Line 159:
	source bin/activate		source bin/activate
	</pre>		</pre>
	===Install SSD1306 driver ~~libarary~~ for OLED 0.91===		===Install SSD1306 driver and library for OLED 0.91===
	<pre>		<pre>
	pip install luma.oled		pip install luma.oled

Yoyojacky: /* Install SSD1306 driver libarary for OLED 0.91 */

2026-04-20T05:22:11Z

Install SSD1306 driver libarary for OLED 0.91

← Older revision		Revision as of 13:22, 20 April 2026
Line 161:		Line 161:
	===Install SSD1306 driver libarary for OLED 0.91===		===Install SSD1306 driver libarary for OLED 0.91===
	<pre>		<pre>
	~~pip install luma~~		pip install luma.oled
	pip install luma.~~core~~
	pip install psutil		pip install psutil
	</pre>		</pre>

Yoyojacky at 06:35, 14 March 2025

2025-03-14T06:35:38Z

← Older revision		Revision as of 14:35, 14 March 2025
Line 1:		Line 1:
	==1U Rackmount for Raspberry Pi 5~~/4B~~ ==		==1U Rackmount for Raspberry Pi 5 ==
	* Purchase URL: [ https://52pi.com ] or [ https://deskpi.com ]		* Purchase URL: [ https://52pi.com ] or [ https://deskpi.com ]
	[[File:DR-0001-1.jpg\|right\|320px]]		[[File:DR-0001-1.jpg\|right\|320px]]

	==Description==		==Description==
	This is an upgraded version of a 1U Rackmount designed for compatibility with both Raspberry Pi 5 ~~and Raspberry Pi 4B~~. It features a motherboard that supports PCIe expansion, allowing the PCIe interface of the Raspberry Pi 5 to be extended to accommodate an M.2 NVMe SSD in 2230/2242/2260/2280 form factors. The expansion board also routes the Raspberry Pi's 5V and GND, SDA, and SCL pins to the rear through PogoPin connectors, providing I2C interface peripherals in a Grove format. Additionally, a red LED is included on the board for the Raspberry Pi ID signal pin, which can be programmed to indicate the current device by controlling the GPIO4 pin's high or low level, acting as a programmable device ID signal light.		This is an upgraded version of a 1U Rackmount designed for compatibility with both Raspberry Pi 5 . It features a motherboard that supports PCIe expansion, allowing the PCIe interface of the Raspberry Pi 5 to be extended to accommodate an M.2 NVMe SSD in 2230/2242/2260/2280 form factors. The expansion board also routes the Raspberry Pi's 5V and GND, SDA, and SCL pins to the rear through PogoPin connectors, providing I2C interface peripherals in a Grove format. Additionally, a red LED is included on the board for the Raspberry Pi ID signal pin, which can be programmed to indicate the current device by controlling the GPIO4 pin's high or low level, acting as a programmable device ID signal light.

	The Rackmount supports the connection of up to five Raspberry Pi devices and can also be configured with an OLED display frame in place of one of the Raspberry Pi slots. These components can be easily adjusted and removed due to the use of hand-tightened screws. The OLED display features a 0.91-inch screen and communicates with the Raspberry Pi via I2C protocol, displaying real-time information such as CPU status, memory status, IP information, and serial numbers. The content displayed on the OLED can be fully customized.		The Rackmount supports the connection of up to five Raspberry Pi devices and can also be configured with an OLED display frame in place of one of the Raspberry Pi slots. These components can be easily adjusted and removed due to the use of hand-tightened screws. The OLED display features a 0.91-inch screen and communicates with the Raspberry Pi via I2C protocol, displaying real-time information such as CPU status, memory status, IP information, and serial numbers. The content displayed on the OLED can be fully customized.
	==Features==		==Features==
	* <strong>Compatibility:</strong> Designed to work with both Raspberry Pi 5 ~~and Raspberry Pi 4B models~~.		* <strong>Compatibility:</strong> Designed to work with both Raspberry Pi 5.
	* <strong>PCIe Expansion Support:</strong> Includes a motherboard that enables PCIe expansion, allowing the connection of M.2 NVMe SSDs in various form factors (2230/2242/2260/2280).		* <strong>PCIe Expansion Support:</strong> Includes a motherboard that enables PCIe expansion, allowing the connection of M.2 NVMe SSDs in various form factors (2230/2242/2260/2280).
	* <strong>I2C Interface: </strong> The board routes the Raspberry Pi's 5V, GND, SDA, and SCL pins to the rear through PogoPin connectors, offering I2C interface peripherals in a Grove format.		* <strong>I2C Interface: </strong> The board routes the Raspberry Pi's 5V, GND, SDA, and SCL pins to the rear through PogoPin connectors, offering I2C interface peripherals in a Grove format.
Line 20:		Line 20:
	===Specifications===		===Specifications===
	* Form Factor: 1U Rackmount design suitable for standard 19-inch racks.		* Form Factor: 1U Rackmount design suitable for standard 19-inch racks.
	* Raspberry Pi Compatibility: Specifically designed for Raspberry Pi 5 ~~and Raspberry Pi 4B models~~.		* Raspberry Pi Compatibility: Specifically designed for Raspberry Pi 5.
	* PCIe Expansion:Supports M.2 NVMe SSDs in 2230, 2242, 2260, and 2280 form factors. Provides a PCIe interface for high-speed data transfer.		* PCIe Expansion:Supports M.2 NVMe SSDs in 2230, 2242, 2260, and 2280 form factors. Provides a PCIe interface for high-speed data transfer.
	* I/O Connectivity: Rear I2C interface via PogoPin connectors for external peripherals.		* I/O Connectivity: Rear I2C interface via PogoPin connectors for external peripherals.
Line 83:		Line 83:
	[[File:DR-0001-11.jpg\|left\|800px]]		[[File:DR-0001-11.jpg\|left\|800px]]
	<br style="clear:both":>		<br style="clear:both":>

	* Compatibility
	<font color=red>NOTE: please note that Raspberry Pi 4B has no PCIe slot, so if you connected the PCIe expansion board to Raspberry Pi 4B, only Grove I2C and UART, UID LED indicator and OLED display are available, the M.2 NVMe SSD Sock will not work properly!!!</font><br>

	==How to assemble it? ==		==How to assemble it? ==
Line 487:		Line 484:

	==How to light up identical LED? ==		==How to light up identical LED? ==
	To light up UID LED indicator on a Raspberry Pi ~~4B or~~ 5, you'll make sure the GPIO Pin of the UID LED connected to.		To light up UID LED indicator on a Raspberry Pi 5, you'll make sure the GPIO Pin of the UID LED connected to.
	<pre>		<pre>
	GPIO (General Purpose Input/Output) pins on the Raspberry Pi.		GPIO (General Purpose Input/Output) pins on the Raspberry Pi.
Line 544:		Line 541:

	==Keywords==		==Keywords==
	* 1U Rackmount for Raspberry Pi 5~~/4B~~ with M.2 NVMe SSD support.		* 1U Rackmount for Raspberry Pi 5 with M.2 NVMe SSD support.