Differences

This shows you the differences between two versions of the page.

--- server_status_oled_display [2025/03/23 00:35] – kenson
+++ server_status_oled_display [2026/05/06 04:56] (current) – kenson
@@ Line 2: / Line 2: @@
 ===== Displayinator v1.0 =====
-This is a device you can shove into a spare USB connector on say a server rack system to display info like IP/Hostname/etc.
+This is a device you can shove into a spare USB connector on say a server rack system to display info like IP/Hostname/etc. It has an accelerometer so it can determine orientation (for racks which have sideways USB) and a simple font compression selection so it can dynamically fit information on one line.
 {{ :displayinator.jpg?direct&400 |}}
-This is a old school project using a ATMEGA32U4.
+This is a old school project using a ATMEGA32U4. Hindsight being 20/20 I should have chosen a more modern microcontroller as the 2.5K of RAM was a significant limitation requiring excessive use of PROGMEM in places you ordinarily wouldn't.
+Notes:
   * The board is a clone of an Arduino Micro, and I2C is connnected to the OLED (SSD1315) and the Accelerometer (MMA8451).
   * The OLED's I2C address 0x3C, and I'm using adafruit's 1306 driver, mainly for display rotation support.
   * The Accelerometer's address is 0x1C and the adafruit MMA8541 driver is basic but functional. Note that the more advanced features (e.g. tap to click) built into the chip are unavailable with this library.
+====== TLDR; ======
+Probe the port.
+<code>
+sudo tee ./probe_displayinator.py >/dev/null <<'EOF'
+#!/usr/bin/env bash
+set -u
+BAUD=115200
+for PORT in /dev/ttyUSB* /dev/ttyACM*; do
+    [ -e "$PORT" ] || continue
+    echo "========================================"
+    echo "Probing $PORT"
+    if ! stty -F "$PORT" "$BAUD" raw -echo -echoe -echok -echoctl -echoke 2>/dev/null; then
+        echo "Could not configure $PORT"
+        continue
+    fi
+    # Some Arduino/32U4-style boards reset when serial opens
+    sleep 4
+    # Wake / clear any stale output
+    printf '\n' > "$PORT"
+    sleep 0.2
+    timeout 1 cat "$PORT" >/dev/null 2>&1
+    # Ask version
+    printf '!VER\n' > "$PORT"
+    echo "Response from $PORT:"
+    timeout 2 cat "$PORT" || true
+    echo
+done
+EOF
+chmod +x probe_displayinator.py
+./probe_displayinator.py
+</code>
+Download the agent: {{ :displayinatorhostip.zip |}}
+<code>
+wget 'https://mehngineering.com/wiki/lib/exe/fetch.php?media=displayinatorhostip.zip' -O displayinatorhostip.zip
+unzip displayinatorhostip.zip
+</code>
+Insert the service to autostart
+<code>
+sudo tee /etc/systemd/system/displayinator.service >/dev/null <<'EOF'
+[Unit]
+Description=Displayinator Host IP Sender
+Wants=network-online.target
+After=network-online.target multi-user.target
+[Service]
+Type=oneshot
+WorkingDirectory=/root
+ExecStartPre=/bin/sleep 10
+ExecStart=/usr/bin/python3 /root/DisplayinatorHostIP.py --port /dev/ttyACM0
+StandardOutput=append:/var/log/displayinator-hostip.log
+StandardError=append:/var/log/displayinator-hostip.log
+[Install]
+WantedBy=multi-user.target
+EOF
+</code>
+Edit /etc/systemd/system/displayinator.service and change the port to whatever device the probe finds, usually /dev/ttyACM0 or /dev/ttyUSB0
+<code>ExecStart=/usr/bin/python3 /root/DisplayinatorHostIP.py --port /dev/ttyACM0
+</code>
+Start the service.
+<code>
+systemctl daemon-reload
+systemctl enable --now displayinator.service
+systemctl status displayinator.service
+</code>
 ==== Loading the Arduino Bootloader ====
@@ Line 18: / Line 103: @@
 avrdude will complain about older firmware but my recommendation is to ignore it.
-The TLDR; is the chinese firmware is modified and does some automagic stuff and in general works more reliably than the publicly available open source code version.
+The [[USBasp flash|TLDR;]] is the chinese firmware is modified and does some automagic stuff and in general works more reliably than the publicly available open source code version.
 Use zadig to make it (USBasp) use libusb-win32
-Copy avrdude to the arduino avrdude location. (You can "Show verbose output during [X] compile [X] upload" in File->Preferences to try to upload to see where it is)
+Copy avrdude v8 (The one that ships with arduino is v5 and doesn't work.) to the arduino avrdude location. (You can "Show verbose output during [X] compile [X] upload" in File->Preferences to try to upload to see where it is)
 Then from Arduino, select USBasp in Tools->Programmer and burn using Tools->Burn Bootloader
@@ Line 47: / Line 132: @@
 The command protocol is simple:
-Commands are prepended with an '!' and terminated with a newline '\n'.
+  * Commands are prepended with an '!' and terminated with a newline '\n'.
-Key-Value pairs are prepended with a '@', space ' ' delimited and terminated with a newline '\n'
+  * Key-Value pairs are prepended with a '@', space ' ' delimited and terminated with a newline '\n'
-You can also indicate not to store values in EEPROM by putting a caret '^' after the @ symbol
+  * You can also indicate not to store values in EEPROM by putting a caret '^' after the @ symbol
 ==== Commands ====
@@ Line 123: / Line 208: @@
   * It also likes to reset when you connect via serial so I wait 3 to 5 seconds for it to boot up before poking it.
   * Python raises DTR, and for whatever reason it breaks things, so I set ser.dtr = False.
+  * You never know whats in a serial buffer when you connect so send a '\n' and read the buffer to make sure everything is sane when you connect.
 ==== TrueNAS =====