How pepperdash/essentials works
PepperDash Essentials is a configuration-driven Crestron control framework for standalone systems, SIMPL Windows partner applications, and hybrids. Its principal workflow is to load configuration, construct and activate devices, then expose room/device control and feedback through routing, bridges, or mobile clients. The tree and README document those product capabilities; source excerpts show selected device lifecycle, monitoring, and mobile-controller relationships. Several major subsystems are represented by their existing directories because their implementation files were not sampled.
Main entry points: DeviceManager.cs Device manager · MobileControlSystemController.cs Mobile controller · EssentialsDeviceFactory.cs Device factories · EssentialsDevice.cs Essentials device
Components 22
Configuration
- Device configuration
src/PepperDash.Essentials.Core/Config/DeviceConfig.cs - Config reader
src/PepperDash.Essentials.Core/Config/Essentials/ConfigReader.cs - Config writer
src/PepperDash.Essentials.Core/Config/Essentials/ConfigWriter.cs
Device Runtime
- Device factories
src/PepperDash.Essentials.Core/Devices/EssentialsDeviceFactory.cs - Device manager
src/PepperDash.Essentials.Core/Devices/DeviceManager.cs - Essentials device
src/PepperDash.Essentials.Core/Devices/EssentialsDevice.cs - Core device lifecycle
src/PepperDash.Core/Device.cs
Control Features
- Common device types
src/PepperDash.Essentials.Devices.Common - Room behaviors
src/PepperDash.Essentials.Core/Room - Signal routing
src/PepperDash.Essentials.Core/Routing/RoutingFeedbackManager.cs - Device feedback
src/PepperDash.Essentials.Core/Feedbacks/BoolFeedback.cs
Integration Interfaces
- Mobile controller
src/PepperDash.Essentials.MobileControl/MobileControlSystemController.cs - Mobile API services
src/PepperDash.Essentials.MobileControl/Services/MobileControlApiService.cs - Mobile WebSocket
src/PepperDash.Essentials.MobileControl/WebSocketServer - Touchpanel control
src/PepperDash.Essentials.MobileControl/Touchpanel/MobileControlTouchpanelController.cs - SIMPL bridges
src/PepperDash.Essentials.Core/Bridges/BridgeBase.cs
Platform Services
- System monitoring
src/PepperDash.Essentials.Core/Monitoring/SystemMonitorController.cs - Communications
src/PepperDash.Essentials.Core/Comm and IR - Logging
src/PepperDash.Core/Logging/Debug.cs - Data conversion
src/PepperDash.Core/Conversion/Convert.cs
Other components
- System designer
- SIMPL Windows
Connections 23
- System designer → Device configuration: defines system
README.md - Device configuration → Config reader: loads
- Config reader → Device factories: configures creation
- Device factories → Device manager: registers devices
- Device manager → Essentials device: tracks devices
src/PepperDash.Essentials.Core/Devices/DeviceManager.cs - Essentials device → Device manager: waits for activation
src/PepperDash.Essentials.Core/Devices/EssentialsDevice.cs - Essentials device → Core device lifecycle: inherits lifecycle
src/PepperDash.Essentials.Core/Devices/EssentialsDevice.cs - Device manager → Logging: logs events
src/PepperDash.Essentials.Core/Devices/DeviceManager.cs - Device manager → Data conversion: converts values
src/PepperDash.Essentials.Core/Devices/DeviceManager.cs - Device manager → Room behaviors: manages configured system
- Device manager → Signal routing: coordinates routes
src/PepperDash.Essentials.Core/Routing/RoutingFeedbackManager.cs - Device factories → Common device types: creates device types
src/PepperDash.Essentials.Devices.Common/Displays/ScreenLiftController.cs - Common device types → Device feedback: publishes state
src/PepperDash.Essentials.Devices.Common/Displays/ScreenLiftController.cs - System designer → Mobile controller: uses controls
- Mobile controller → Room behaviors: exposes room control
src/PepperDash.Essentials.MobileControl/MobileControlSystemController.cs - Mobile controller → Mobile API services: uses services
src/PepperDash.Essentials.MobileControl/MobileControlSystemController.cs - Mobile controller → Mobile WebSocket: registers server
src/PepperDash.Essentials.MobileControl/MobileControlSystemController.cs - Mobile controller → Touchpanel control: supports panels
src/PepperDash.Essentials.MobileControl/Touchpanel/MobileControlTouchpanelController.cs - SIMPL Windows → SIMPL bridges: exchanges control
README.md - SIMPL bridges → Device manager: bridges runtime devices
- System monitoring → Device feedback: updates feedback
src/PepperDash.Essentials.Core/Monitoring/SystemMonitorController.cs - Room behaviors → Signal routing: coordinates room routes
src/PepperDash.Essentials.Core/Routing/RoutingFeedbackManager.cs - Communications → Common device types: communicates with devices