Skip to content

Serve denial page on SystemCore #2302

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
samfreund wants to merge 3 commits into
base: 2027
Choose a base branch
from
+88 −1
Open

Serve denial page on SystemCore #2302

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
368f40d
docs
samfreund Jan 15, 2026
c5a89fb
serve static on SC
samfreund Jan 15, 2026
28459e3
lint
samfreund Jan 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/source/docs/quick-start/common-setups.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,11 @@ PhotonVision requires dedicated hardware, above and beyond a roboRIO. This page
The Orange Pi 5 is the only currently supported device for object detection.
:::

## SystemCore Support

The SystemCore is not supported by PhotonVision. PhotonVision is designed to utilize the entirety of the coprocessor's resources, and this could prove to be dangerous if attempted on the main robot controller.
There are no current plans to support running on SystemCore alongside robot code, and any attempts to do so are entirely at your own risk and will require a separate fork of PhotonVision.

## SD Cards

- 8GB or larger micro SD card
Expand Down
68 changes: 68 additions & 0 deletions photon-server/src/main/java/org/photonvision/Main.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -165,7 +165,75 @@ private static void addTestModeSources() {
VisionSourceManager.getInstance().registerLoadedConfigs(cameraConfigs);
}

private static void serveDenialPage() {
String docsLink =
"https://docs.photonvision.org/en/latest/docs/quick-start/common-setups.html#systemcore-support";

logger.error(
"SystemCore is not a supported platform for PhotonVision!\n "
+ "Please visit "
+ docsLink
+ " for more information.");

try {
int port = 5800;
io.javalin.Javalin app = null;
try {
app = io.javalin.Javalin.create(cfg -> cfg.showJavalinBanner = false).start(port);
} catch (Exception e) {
logger.warn("Failed to bind to port 5800, exiting: " + e.getMessage());
port = DEFAULT_WEBPORT;
app = io.javalin.Javalin.create(cfg -> cfg.showJavalinBanner = false).start(port);
}

final int boundPort = port;
final String html =
"<!doctype html>"
+ "<html><head><meta charset=\"utf-8\"><title>Unsupported platform</title></head><body>"
+ "<p>Main Robot Controllers shouldn't run PhotonVision, but yours does! "
+ "Please <a href=\"https://github.com/PhotonVision/photonvision/blob/main/scripts/uninstall.sh\" "
+ "target=\"_blank\" rel=\"noopener noreferrer\">uninstall</a> PhotonVision. "
+ "If you choose to modify PhotonVision so that it functions on SystemCore, "
+ "you do so entirely at your own risk and without any support. "
+ "For more information, see <a href=\""
+ docsLink
+ "\" target=\"_blank\" rel=\"noopener noreferrer\">"
+ docsLink
+ "</a>.</p></body></html>";

app.get(
"/",
ctx -> {
ctx.contentType("text/html; charset=utf-8");
ctx.result(html);
});

logger.info(
"Served SystemCore warning page on port "
+ boundPort
+ " - process will remain running to serve the page.");

// Prevent main from exiting so the page remains available.
final Object lock = new Object();
synchronized (lock) {
try {
lock.wait();
} catch (InterruptedException ignored) {
}
}
} catch (Exception e) {
logger.error("Failed to start static warning page server", e);
}

// Exit
System.exit(1);
}

public static void main(String[] args) {
if (Platform.isSystemCore()) {
serveDenialPage();
}

logger.info(
"Starting PhotonVision version "
+ PhotonVersion.versionString
Expand Down
16 changes: 15 additions & 1 deletion photon-targeting/src/main/java/org/photonvision/common/hardware/Platform.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,13 @@ public enum Platform {
true,
OSType.LINUX,
true), // Raspberry Pi 3/4 with a 64-bit image
LINUX_SYSTEMCORE(
"Linux Systemcore 64-bit NOT SUPPORTED",
Platform::getUnknownModel,
"linuxarm64",
false,
OSType.LINUX,
false), // SystemCore 64-bit
LINUX_RK3588_64(
"Linux AARCH 64-bit with RK3588",
Platform::getLinuxDeviceTreeModel,
Expand Down Expand Up @@ -127,6 +134,11 @@ public static boolean isLinux() {
return currentPlatform.osType == OSType.LINUX;
}

public static boolean isSystemCore() {
File sysCore = new File("/home/systemcore");
return sysCore.exists() | fileHasText("/etc/os-release", "systemcore");
}

public static boolean isRK3588() {
return Platform.isOrangePi() || Platform.isCoolPi4b() || Platform.isRock5C();
}
Expand Down Expand Up @@ -205,7 +217,9 @@ public static Platform getCurrentPlatform() {
}

if (OS_NAME.startsWith("Linux")) {
if (isPiSBC()) {
if (isSystemCore()) {
return LINUX_SYSTEMCORE;
} else if (isPiSBC()) {
if (OS_ARCH.equals("arm") || OS_ARCH.equals("arm32")) {
return LINUX_RASPBIAN32;
} else if (OS_ARCH.equals("aarch64") || OS_ARCH.equals("arm64")) {
Expand Down
Loading