Device Attributes

import org.aesh.terminal.DeviceAttributes;
import org.aesh.terminal.tty.TerminalConnection;

TerminalConnection connection = new TerminalConnection();
connection.openNonBlocking();

// Query device attributes (500ms timeout)
DeviceAttributes da = connection.queryDeviceAttributes(500);

if (da != null) {
    System.out.println("Device class: " + da.getDeviceClass());
    System.out.println("Supports Sixel: " + da.supportsSixel());
    System.out.println("Supports ANSI color: " + da.supportsAnsiColor());
    System.out.println("Supports mouse: " + da.supportsMouse());
}

connection.close();

DeviceAttributes da = connection.queryPrimaryDeviceAttributes(500);

if (da != null && da.hasDA1()) {
    // Device class indicates conformance level
    int deviceClass = da.getDeviceClass();
    // 1 or 2 = VT100
    // 62 = VT220
    // 63 = VT320
    // 64 = VT420

    // Check specific features
    boolean hasSixel = da.supportsSixel();
    boolean hasAnsiColor = da.supportsAnsiColor();
    boolean hasMouse = da.supportsMouse();
    boolean hasRectEdit = da.supportsRectangularEditing();
    boolean has132Cols = da.supports132Columns();

    // Get all features
    Set<DeviceAttributes.Feature> features = da.getFeatures();
}

DeviceAttributes da = connection.querySecondaryDeviceAttributes(500);

if (da != null && da.hasDA2()) {
    // Terminal type
    DeviceAttributes.TerminalType type = da.getTerminalType();
    System.out.println("Terminal: " + type.getName());

    // Firmware version
    int version = da.getFirmwareVersion();
    System.out.println("Version: " + version);

    // ROM cartridge (rarely used)
    int rom = da.getRomCartridge();
}

DeviceAttributes da = connection.queryDeviceAttributes(500);

if (da != null) {
    // Has data from both queries
    if (da.hasDA1()) {
        System.out.println("Class: " + da.getDeviceClass());
        System.out.println("Features: " + da.getFeatures());
    }
    if (da.hasDA2()) {
        System.out.println("Type: " + da.getTerminalType().getName());
        System.out.println("Version: " + da.getFirmwareVersion());
    }
}

// Convenience methods
da.supportsSixel();          // Feature.SIXEL
da.supportsAnsiColor();      // Feature.ANSI_COLOR
da.supportsMouse();          // Feature.LOCATOR or ANSI_TEXT_LOCATOR
da.supportsRectangularEditing();  // Feature.RECTANGULAR_EDITING
da.supports132Columns();     // Feature.COLUMNS_132

// Generic check
da.hasFeature(DeviceAttributes.Feature.DRCS);

// Get all features
Set<Feature> features = da.getFeatures();

// Get raw parameter codes (includes unknown codes)
Set<Integer> rawParams = da.getRawParameters();

DeviceAttributes.TerminalType type = da.getTerminalType();
System.out.println("Terminal: " + type.getName());
System.out.println("Type code: " + type.getCode());

DeviceAttributes da1 = connection.queryPrimaryDeviceAttributes(500);
DeviceAttributes da2 = connection.querySecondaryDeviceAttributes(500);

// Merge the results
DeviceAttributes merged = da1.merge(da2);

// Or use the combined query method
DeviceAttributes combined = connection.queryDeviceAttributes(500);

DeviceAttributes da = connection.queryPrimaryDeviceAttributes(500);

if (da != null && da.supportsSixel()) {
    // Terminal definitively supports Sixel
    displaySixelImage(imageData);
} else {
    // Fall back to text-based display
    displayAsciiArt(imageData);
}

DeviceAttributes da = connection.queryPrimaryDeviceAttributes(500);

if (da != null && da.likelySupportsOscQueries()) {
    // Terminal likely supports OSC 10/11 color queries
    int[] bgColor = connection.queryBackgroundColor(500);
    if (bgColor != null) {
        boolean isDark = (bgColor[0] + bgColor[1] + bgColor[2]) / 3 < 128;
    }
}

// Or use the convenience method
if (connection.supportsOscQueries(da)) {
    // Safe to use OSC queries
}

// Query-based detection uses DA1 for Sixel
ImageProtocol protocol = connection.queryImageProtocol(500);

// The ImageProtocolDetector combines:
// 1. Environment variables (for Kitty/iTerm2)
// 2. TERM type string
// 3. DA1 attributes (for authoritative Sixel detection)

DeviceAttributes da = connection.queryDeviceAttributes(500);

if (da != null) {
    StringBuilder report = new StringBuilder();
    report.append("Terminal Capabilities Report\n");
    report.append("============================\n\n");

    if (da.hasDA1()) {
        report.append("Device Class: ").append(da.getDeviceClass()).append("\n");
        report.append("Features:\n");
        for (DeviceAttributes.Feature f : da.getFeatures()) {
            report.append("  - ").append(f.name()).append("\n");
        }
    }

    if (da.hasDA2()) {
        report.append("\nTerminal Type: ").append(da.getTerminalType().getName()).append("\n");
        report.append("Firmware Version: ").append(da.getFirmwareVersion()).append("\n");
    }

    connection.write(report.toString());
}

import org.aesh.terminal.Device;
import org.aesh.terminal.utils.TerminalEnvironment;

// Heuristic detection (fast, always available)
Device.TerminalType heuristicType = TerminalEnvironment.detectTerminalType();

// Authoritative detection from DA1/DA2
DeviceAttributes da = connection.queryDeviceAttributes(500);
if (da != null) {
    Device.TerminalType authType = da.inferTerminalType();
    System.out.println("Inferred type: " + authType.getIdentifier());
}

Device.TerminalType envType = TerminalEnvironment.detectTerminalType();
DeviceAttributes da = connection.queryDeviceAttributes(500);

if (da != null && !da.matchesTerminalType(envType)) {
    System.out.println("Warning: Terminal capabilities differ from expected for " +
                       envType.getIdentifier());
}

DeviceAttributes da = connection.queryDeviceAttributes(500);
if (da != null) {
    ColorDepth depth = da.inferColorDepth();
    System.out.println("Color depth: " + depth);
}

Device.TerminalType envType = TerminalEnvironment.detectTerminalType();
DeviceAttributes da = connection.queryDeviceAttributes(500);

if (da != null) {
    String summary = da.getCapabilitySummary(envType);
    System.out.println(summary);
}

// Get expected features for a terminal type
Set<DeviceAttributes.Feature> expected = Device.TerminalType.KITTY.getExpectedFeatures();
// Contains: SIXEL, ANSI_COLOR, ANSI_TEXT_LOCATOR

// Convenience methods
boolean expectsSixel = Device.TerminalType.KITTY.expectsSixel();  // true
boolean expectsMouse = Device.TerminalType.XTERM.expectsMouse();  // true

DeviceAttributes da = connection.queryPrimaryDeviceAttributes(500);

if (da == null) {
    // Query failed or timed out
    // Possible reasons:
    // - Terminal doesn't support DA queries
    // - Connection not actively reading input
    // - Timeout too short

    // Fall back to heuristic detection
    ImageProtocol protocol = connection.device().getImageProtocol();
}

// Good: Query once at startup
public class MyApp {
    private static DeviceAttributes terminalCapabilities;

    public static void main(String[] args) {
        TerminalConnection conn = new TerminalConnection();
        conn.openNonBlocking();

        // Query once
        terminalCapabilities = conn.queryDeviceAttributes(500);

        // Use throughout application
        if (terminalCapabilities != null && terminalCapabilities.supportsSixel()) {
            // Use Sixel graphics
        }
    }
}

// Debug: print raw response codes
Set<Integer> raw = da.getRawParameters();
System.out.println("Raw DA1 parameters: " + raw);