The new WiRocS code has integrated OLED (I2C) capability that is largely compatible with the RocDisplay formatting.

To use the feature, a "standard" 0.96" 128*64 (or 128*32) 4 pin I2C OLED display is connected to the WiRocS node.
When the node starts it scans its I2C bus(s) to see if any OLED displays are present (it expects Addresses 60d and/or 61d)
IF OLEDs are found, the code will display messages and clocks on the display(s).
If there are no OLEDS present, the I2C bus pins are released back so they can be used general purpose I/O use.

On the ESP8266 version, the I2C bus uses uses D3 and D4, which (when the board is on the Motor shield) are the 'Motor direction' pins. Pins D1 and D2 remain connected to the 'Motor PWM' pins. This means that the Motor Shield outputs can still be used as dimmable filament light drives (because the "direction" (being changed all the time as these pins are the OLED data) does not matter to a filament light!).

The ESP32 version uses extra pins for the Main I2C bus so none are "lost" if only one I2C bus is needed.

To allow use of two small 128*32 Oled displays, the code has an additional "secondary" I2C defined, This allows two displays with address 60 to be used together. The code expects this ONLY to be used for the smaller 128*32 displays, which do not have the ability to change addresses to 61, so if the node sees any OLED on the Secondary I2C bus, it assumes that any other address 60 OLED on the main I2C bus MUST also be a 128*32 display.

When no Roc-Display Messages are sent to the display, it defaults to show the Rocrail Power Status, RocRail Time, and WiFi Signal Strength.

The OLED will display messages to show how the node is progressing during boot. This can be helpful in diagnosing any issues. The code includes a simplified text parser that can accept RocDisplay messages and display them as a station announcements. A separate page Roc Display Lite documents how the parsing in this "Lite version" of the protocol works and goes into more detail about the displays.

Please also read Selecting OLED Types