Author SHA1 Message Date
esilva e07f7f42de feat: putting device into user config mode when tool is opened 2026-11-08 22:34:00 +00:00
10 changed files with 78 additions and 36 deletions
+25 -31
View File
@@ -8,54 +8,47 @@ available peripheral: [CDashDisplay](https://github.com/ESilva15/CDashDisplay).
If anyone finds this project useful for anything at all it would be pretty cool.
My main goal is to learn and have some fun.
## Usage
To launch the software, compile (TBD) or just run it with: `go run . tui`
You should see something like this:
Currently it can read from a `.ibt` file or live telemetry from iRacing.
It can only be ran from the terminal:
`go run . offline -p <port> -i <ibt-file>`
![example output in the terminal](./images/terminal_output.png)
The current behaviour is very opaque.
What is happening in the background is the software looks up for the configured
devices and for available telemetry providers.
Once it finds a device, in this case the CDashDisplay, it will try to configure
it against the available telemetry provider.
After configuring it it will automatically start streaming data from the
telemetry provider into the CDashDisplay.
Using the `arrows` you can navigate to the `stream` item on the list and then
go to the update button and press `s` to see the output on the terminal.
I upgraded the backend significantly and there's plenty of work to be done on
the frontend. I know its quite bad right now.
or to view the live data:
`go run . live -p <port>`
## Compatibility:
Games implemented so far:
- [iRacing](https://www.iracing.com/) using the [goirsdk](https://github.com/ESilva15/goirsdk)
- [BeamNG.drive](https://www.beamng.com/game/) using the [gobngsdk](https://github.com/ESilva15/gobngsdk)
Peripherals:
- [CDashDisplay](https://github.com/ESilva15/CDashDisplay)
<!-- Games being implemented: -->
<!-- - [BeamNG.drive](https://www.beamng.com/game/) using the [gobngsdk](https://github.com/ESilva15/gobngsdk) -->
<!---->
<!-- Games to be implemented: -->
<!-- - [Assetto Corsa](https://assettocorsa.gg/) -->
## Roadmap
- [X] Implement the interface for a data source
- [ ] Configuration of the peripherals via ESDI
- [ ] Detection of the display
- [ ] LapTime Calculator
- [ ] A very long list useful stuff like flags, position, more info about
other drivers, track conditions and so on so forth
- [ ] Telemetry analysis tool
- [ ] Better user interface
## Development
### Mockservers
I'm using a mockserver developed by myself that pretty much mimicks the telemetry
output from the actual simulators. It uses the SDKs I developed to do so with the
added bonus of being able to run the project on Linux and mainly develop it.
Just go to [TelemetryMockserver on GitHub](https://github.com/ESilva15/TelemetryMockserver) and follow
the instructions there.
To mock [BeamNG.drive](https://www.beamng.com/game/), I built
[BeaMNGMockOg](https://github.com/ESilva15/BeamNGMockOg) (should have though longer
about the name).
You create a recording by launching the BeamNG and then launching the mockserver with:
`BeamNGMockOg record -a 127.0.0.1 -p 4443 -o output.bin`.
To replay the recording:
`BeamNGMockOg replay [--loop] -a 127.0.0.1 -p 4443 -i input.bin`
### Troubleshooting
#### Can't see BeamNG data coming through
@@ -81,3 +74,4 @@ pprof:
## Shameless begging
Hey, doesn't hurt to try, its free either way:
[Buy me a coffee!](buymeacoffee.com/ESilva_15)
+6
View File
@@ -1,5 +1,11 @@
package constants
// Peripheral Names
const (
CDashDisplay = "CDashDisplay"
UIView = "UIView"
)
// Provider Names
const (
IRacingProviderName = "iRacing"
+2 -1
View File
@@ -1,6 +1,7 @@
package uidevice
import (
"esdi/constants"
"esdi/peripheral"
"esdi/telemetry"
)
@@ -9,7 +10,7 @@ type UIDevice struct {
dataChan chan telemetry.TelemetryData
}
const NAME = "UIView"
const NAME = constants.UIView
func NewUIDevice() (peripheral.Peripheral, error) {
return &UIDevice{
Binary file not shown.

Before

Width:  |  Height:  |  Size: 113 KiB

After

Width:  |  Height:  |  Size: 64 KiB

+5 -2
View File
@@ -1,13 +1,16 @@
// Package devices will define the available devices we can communicate with
package devices
import "esdi/peripheral/types"
import (
"esdi/constants"
"esdi/peripheral/types"
)
// IDs for our devices. They need to be correctly mapped on the devices
// themselves so we can discover them
const (
CDashDisplayDevID = 0x01
CDashDisplayDevName = "CDashDisplay"
CDashDisplayDevName = constants.CDashDisplay
ESBtnBoxDevID = 0x02
)
+5
View File
@@ -107,6 +107,11 @@ func (ds *DeviceService) StopStream() {
ds.streamCancel = nil
}
func (ds *DeviceService) SetPeripheralUserConfigMode(pname string) error {
ds.PSS.setDeviceBeingConfiguredByUser(pname)
return nil
}
// SetTelemetryChannel sets the TelemCh to the passed channel
func (ds *DeviceService) SetTelemetryChannel(ch <-chan telemetry.TelemetryData) {
ds.TelemCh = ch
+13
View File
@@ -30,6 +30,7 @@ const (
DeviceIsConnected
DeviceIsUnconfigured
DeviceIsConfiguring
DeviceBeingConfiguredByUser
DeviceIsConfigured
DeviceIsStreaming
)
@@ -50,6 +51,8 @@ func DeviceStateToStr(state DeviceState) string {
return "DeviceIsUnconfigured"
case DeviceIsConfiguring:
return "DeviceIsConfiguring"
case DeviceBeingConfiguredByUser:
return "DeviceBeingConfiguredByUser"
case DeviceIsConfigured:
return "DeviceIsConfigured"
case DeviceIsStreaming:
@@ -294,6 +297,14 @@ func (pss *PeripheralStateStore) setDeviceIsConfiguring(pname string) {
pss.store[pname].State = DeviceIsConfiguring
}
func (pss *PeripheralStateStore) setDeviceBeingConfiguredByUser(pname string) {
pss.Logger.Info("device is being configured by the user", "device", pname)
pss.mu.Lock()
defer pss.mu.Unlock()
pss.store[pname].State = DeviceBeingConfiguredByUser
}
func (pss *PeripheralStateStore) setDeviceConfigured(pname string) {
pss.Logger.Info("device is configured and ready for data", "device", pname)
@@ -457,6 +468,8 @@ func (pss *PeripheralStateStore) HandleDeviceState() {
case DeviceIsConfigured:
// Nothing to do here
pss.handleDeviceIsConfigured(pName)
case DeviceBeingConfiguredByUser:
// Nothing to do here, need to wait for the user to finish
case DeviceIsStreaming:
//
case DeviceReconnected:
+1 -1
View File
@@ -31,7 +31,7 @@ func (t *TelemetryService) onFindProvider(prov telem.TelemetryProvider) {
ch := t.StartStream()
t.startedStreaming(ch)
t.Messages <- "provider switch completed"
t.Messages <- "provider switch completed\n"
}
func (t *TelemetryService) onProviderStopsMidStream() {
@@ -5,6 +5,7 @@ import (
"os"
"strconv"
"esdi/constants"
"esdi/devices/cdashdisplay"
"esdi/services"
"esdi/tui/internal/views"
@@ -585,3 +586,21 @@ func (lc *LayoutController) changeSelectedLoadout() {
lc.LayoutToolView.ShowLayoutList()
lc.App.SetFocus(lc.LayoutToolView.LayoutActions.LayoutSelection.Tree)
}
// ##### Event Listener
// OnLayoutToolOpen we need to change focus to the layout tool and move the
// device out of streaming mode or whatever.
// - start by making sure that device is able to be configured
func (lc *LayoutController) OnLayoutToolOpen() {
// Get the device from somewhere
cdash, err := lc.DevService.GetPeripheral(constants.CDashDisplay)
if err != nil {
lc.Messages <- "failed to acquire CDashDisplay " + err.Error() + "\n"
return
}
lc.DevService.SetPeripheralUserConfigMode(cdash.Name())
// Change focus to the layout tree
lc.App.SetFocus(lc.LayoutToolView.LayoutTree.Tree)
}
+2 -1
View File
@@ -77,7 +77,8 @@ func (mc *DeviceController) AddDeviceAPIListItems() {
"layout-tool",
mc.LayoutCtrl.LayoutToolView.Flex,
)
mc.App.SetFocus(mc.LayoutCtrl.LayoutToolView.LayoutTree.Tree)
mc.LayoutCtrl.OnLayoutToolOpen()
})
mc.DeviceAPIView.DevAPIList.
AddItem("stream", "stream data to the display", func() {