Package org.emrick.project.dev

Class UnitsPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.emrick.project.dev.UnitsPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

class UnitsPanel
extends JPanel

Shows every plugged-in unit and its details (board ID, label, firmware, battery, ...). New units are read automatically when plugged in; Refresh reads them all again.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static interface	UnitsPanel.PortAction
private static class	UnitsPanel.Row	One plugged-in unit.
private static final record	UnitsPanel.SwatchIcon	Small rounded color square.
private class	UnitsPanel.UnitTableModel

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
private final JButton	blinkButton
private final DevUI.Pill	countPill
private final JPanel	details
private final DevModeHost	host
private final JPanel	listArea
private final CardLayout	listCards
private static final long	LIVE_REFRESH_MS
private final UnitsPanel.UnitTableModel	model
private static final String	OWNER
private final Timer	plugWatcher
private final List<UnitsPanel.Row>	rowList
private final Map<String,UnitsPanel.Row>	rows
private final ExecutorService	serialWorker
private final JTable	table

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
UnitsPanel(DevModeHost host)

Method Summary

Modifier and Type	Method	Description
private static void	batteryValue(DevUI.Card card, double volts, double percent)
private static void	bigValue(DevUI.Card card, String k1, String v1, String k2, String v2)	The two most important values, shown large side by side.
private static String	capitalize(String s)
private void	checkForPlugChanges()
private static void	colorValue(DevUI.Card card, String key, String rgb)
private static String	firmwareVerdict(UnitInfo info)
private static JPanel	line(String key, JComponent value)
private static void	pillValue(DevUI.Card card, String key, String text, DevUI.Tone tone)
private void	read(String port)
private void	rebuildRows()
private void	refreshDetails()
(package private) void	refreshDisplay()	Re-renders the table and details (e.g.
private void	refreshInfo(String port)	Re-reads a receiver's details without probing it again.
private void	refreshRows()	Repaints rows in place; unlike fireTableDataChanged this keeps the selection.
private void	rescanAll()
private static DevUI.Card	section(String title)
private UnitsPanel.Row	selectedRow()
(package private) void	shutdown()
(package private) void	start()
private static DevUI.Tone	statusTone(UnitsPanel.Row row)
private void	toggleBlink()
private void	update(String port, String type, UnitInfo info, String status, boolean busy)
private static void	value(DevUI.Card card, String key, String value)
private boolean	withPort(String port, UnitsPanel.PortAction action)	Claims, opens, runs, and releases a port.
private static JComponent	wrapCaption(String text)

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

OWNER

private static final String OWNER

See Also:

• Constant Field Values

LIVE_REFRESH_MS

private static final long LIVE_REFRESH_MS

See Also:

• Constant Field Values

host

private final DevModeHost host

rows

private final Map<String,UnitsPanel.Row> rows

rowList

private final List<UnitsPanel.Row> rowList

model

private final UnitsPanel.UnitTableModel model

table

private final JTable table

countPill

private final DevUI.Pill countPill

blinkButton

private final JButton blinkButton

listCards

private final CardLayout listCards

listArea

private final JPanel listArea

details

private final JPanel details

serialWorker

private final ExecutorService serialWorker

plugWatcher

private final Timer plugWatcher

Constructor Details

UnitsPanel

UnitsPanel(DevModeHost host)

Method Details

start

void start()

shutdown

void shutdown()

refreshDisplay

void refreshDisplay()

Re-renders the table and details (e.g. after the latest firmware version becomes known).

checkForPlugChanges

private void checkForPlugChanges()

refreshInfo

private void refreshInfo(String port)

Re-reads a receiver's details without probing it again. Keeps the last details if it doesn't answer.

rescanAll

private void rescanAll()

read

private void read(String port)

update

private void update(String port,
 String type,
 UnitInfo info,
 String status,
 boolean busy)

toggleBlink

private void toggleBlink()

withPort

private boolean withPort(String port,
 UnitsPanel.PortAction action)

Claims, opens, runs, and releases a port. @return false if the port is used elsewhere or can't open

statusTone

private static DevUI.Tone statusTone(UnitsPanel.Row row)

rebuildRows

private void rebuildRows()

refreshRows

private void refreshRows()

Repaints rows in place; unlike fireTableDataChanged this keeps the selection.

selectedRow

private UnitsPanel.Row selectedRow()

firmwareVerdict

private static String firmwareVerdict(UnitInfo info)

refreshDetails

private void refreshDetails()

section

private static DevUI.Card section(String title)

line

private static JPanel line(String key,
 JComponent value)

value

private static void value(DevUI.Card card,
 String key,
 String value)

pillValue

private static void pillValue(DevUI.Card card,
 String key,
 String text,
 DevUI.Tone tone)

bigValue

private static void bigValue(DevUI.Card card,
 String k1,
 String v1,
 String k2,
 String v2)

The two most important values, shown large side by side.

colorValue

private static void colorValue(DevUI.Card card,
 String key,
 String rgb)

batteryValue

private static void batteryValue(DevUI.Card card,
 double volts,
 double percent)

wrapCaption

private static JComponent wrapCaption(String text)

capitalize

private static String capitalize(String s)