console-frontend: add settings management UI and device API integration

Signed-off-by: YoungSoo Shin <shinys000114@gmail.com>

example/console-frontend/go.mod

@@ -0,0 +1,35 @@
+module console-frontend
+
+go 1.24.0
+
+toolchain go1.24.11
+
+require (
+	github.com/charmbracelet/bubbles v0.21.0
+	github.com/charmbracelet/bubbletea v1.3.10
+	github.com/charmbracelet/lipgloss v1.1.0
+	github.com/gorilla/websocket v1.5.3
+	google.golang.org/protobuf v1.36.10
+)
+
+require (
+	github.com/atotto/clipboard v0.1.4 // indirect
+	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc // indirect
+	github.com/charmbracelet/x/ansi v0.10.1 // indirect
+	github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd // indirect
+	github.com/charmbracelet/x/term v0.2.1 // indirect
+	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
+	github.com/hinshun/vt10x v0.0.0-20220301184237-5011da428d02 // indirect
+	github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-localereader v0.0.1 // indirect
+	github.com/mattn/go-runewidth v0.0.16 // indirect
+	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
+	golang.org/x/sys v0.36.0 // indirect
+	golang.org/x/text v0.3.8 // indirect
+)

example/console-frontend/go.sum

@@ -0,0 +1,55 @@
+github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4=
+github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/charmbracelet/bubbles v0.21.0 h1:9TdC97SdRVg/1aaXNVWfFH3nnLAwOXr8Fn6u6mfQdFs=
+github.com/charmbracelet/bubbles v0.21.0/go.mod h1:HF+v6QUR4HkEpz62dx7ym2xc71/KBHg+zKwJtMw+qtg=
+github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
+github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc/go.mod h1:X4/0JoqgTIPSFcRA/P6INZzIuyqdFY5rm8tb41s9okk=
+github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
+github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
+github.com/charmbracelet/x/ansi v0.10.1 h1:rL3Koar5XvX0pHGfovN03f5cxLbCF2YvLeyz7D2jVDQ=
+github.com/charmbracelet/x/ansi v0.10.1/go.mod h1:3RQDQ6lDnROptfpWuUVIUG64bD2g2BgntdxH0Ya5TeE=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd h1:vy0GVL4jeHEwG5YOXDmi86oYw2yuYUGqz6a8sLwg0X8=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs=
+github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
+github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
+github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/hinshun/vt10x v0.0.0-20220301184237-5011da428d02 h1:AgcIVYPa6XJnU3phs104wLj8l5GEththEw6+F79YsIY=
+github.com/hinshun/vt10x v0.0.0-20220301184237-5011da428d02/go.mod h1:Q48J4R4DvxnHolD5P8pOtXigYlRuPLGl6moFx3ulM68=
+github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=
+github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
+github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
+github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
+github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561 h1:MDc5xs78ZrZr3HMQugiXOAkSZtfTpbJLDr/lwfgO53E=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561/go.mod h1:cyybsKvd6eL0RnXn6p/Grxp8F5bW7iYuBgsNCOHpMYE=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.36.0 h1:KVRy2GtZBrk1cBYA7MKu5bEZFxQk4NIDV6RLVcC8o0k=
+golang.org/x/sys v0.36.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY=
+golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=
+google.golang.org/protobuf v1.36.10 h1:AYd7cD/uASjIL6Q9LiTjz8JLcrh/88q5UObnmY3aOOE=
+google.golang.org/protobuf v1.36.10/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=

example/console-frontend/main.go

@@ -0,0 +1,909 @@
+package main
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+	"os"
+	"strconv"
+	"strings"
+	"time"
+
+	"console-frontend/pb"
+
+	"github.com/charmbracelet/bubbles/textinput"
+	"github.com/charmbracelet/bubbles/viewport"
+	tea "github.com/charmbracelet/bubbletea"
+	"github.com/charmbracelet/lipgloss"
+	"github.com/gorilla/websocket"
+	"github.com/hinshun/vt10x"
+	"google.golang.org/protobuf/proto"
+)
+
+// --- Configuration ---
+const DefaultBaseURL = "http://192.168.4.1"
+
+// Global HTTP Client for reuse
+var httpClient = &http.Client{
+	Timeout: 5 * time.Second,
+}
+
+// --- Styles ---
+var (
+	titleStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color("#FFFDF5")).
+			Background(lipgloss.Color("#25A065")).
+			Padding(0, 1)
+
+	infoStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color("#FFFDF5")).
+			Padding(0, 1)
+
+	headerStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color("205")).
+			Bold(true)
+
+	statusBarStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color("#FFFDF5")).
+			Background(lipgloss.Color("#3C3C3C")).
+			Padding(0, 1)
+
+	commandModeStyle = lipgloss.NewStyle().
+				Foreground(lipgloss.Color("#000000")).
+				Background(lipgloss.Color("#D75F00")).
+				Padding(0, 1).
+				Bold(true)
+
+	errorStyle = lipgloss.NewStyle().Foreground(lipgloss.Color("196"))
+
+	// Help Window Style
+	helpBoxStyle = lipgloss.NewStyle().
+			Border(lipgloss.RoundedBorder()).
+			BorderForeground(lipgloss.Color("#874BFD")).
+			Padding(1, 2).
+			Background(lipgloss.Color("#1e1e1e"))
+
+	// Settings Style
+	settingItemStyle  = lipgloss.NewStyle().PaddingLeft(2)
+	selectedItemStyle = lipgloss.NewStyle().PaddingLeft(0).Foreground(lipgloss.Color("170")).Bold(true).SetString("> ")
+)
+
+// --- Messages ---
+type sessionMsg struct {
+	token string
+}
+
+type initStatusMsg struct {
+	mainOn bool
+	usbOn  bool
+}
+
+type settingsMsg struct {
+	settings DeviceSettings
+}
+
+type errMsg error
+
+type wsMsg *pb.StatusMessage
+
+// --- Data Structures ---
+
+// DeviceSettings maps to GET/POST /api/setting
+type DeviceSettings struct {
+	VinCurrentLimit  float64 `json:"vin_current_limit,omitempty"`
+	MainCurrentLimit float64 `json:"main_current_limit,omitempty"`
+	UsbCurrentLimit  float64 `json:"usb_current_limit,omitempty"`
+	BaudRate         int     `json:"baud_rate,omitempty"`
+	SensorPeriod     int     `json:"sensor_period,omitempty"`
+}
+
+// --- API Client ---
+type LoginRequest struct {
+	Username string `json:"username"`
+	Password string `json:"password"`
+}
+
+type LoginResponse struct {
+	Token string `json:"token"`
+}
+
+type ControlRequest struct {
+	Load12vOn    *bool `json:"load_12v_on,omitempty"`
+	Load5vOn     *bool `json:"load_5v_on,omitempty"`
+	PowerTrigger *bool `json:"power_trigger,omitempty"`
+	ResetTrigger *bool `json:"reset_trigger,omitempty"`
+}
+
+type ControlStatusResponse struct {
+	Load12vOn bool `json:"load_12v_on"`
+	Load5vOn  bool `json:"load_5v_on"`
+}
+
+func login(baseURL, username, password string) tea.Cmd {
+	return func() tea.Msg {
+		baseURL = strings.TrimRight(baseURL, "/")
+		reqBody, _ := json.Marshal(LoginRequest{Username: username, Password: password})
+		resp, err := httpClient.Post(baseURL+"/login", "application/json", bytes.NewBuffer(reqBody))
+		if err != nil {
+			return errMsg(err)
+		}
+		defer resp.Body.Close()
+
+		if resp.StatusCode != 200 {
+			body, _ := io.ReadAll(resp.Body)
+			return errMsg(fmt.Errorf("login failed: %s", string(body)))
+		}
+
+		var loginResp LoginResponse
+		if err := json.NewDecoder(resp.Body).Decode(&loginResp); err != nil {
+			return errMsg(err)
+		}
+		return sessionMsg{token: loginResp.Token}
+	}
+}
+
+func fetchControlStatus(baseURL, token string) tea.Cmd {
+	return func() tea.Msg {
+		baseURL = strings.TrimRight(baseURL, "/")
+		req, _ := http.NewRequest("GET", baseURL+"/api/control", nil)
+		req.Header.Set("Authorization", "Bearer "+token)
+
+		resp, err := httpClient.Do(req)
+		if err != nil {
+			return errMsg(err)
+		}
+		defer resp.Body.Close()
+
+		if resp.StatusCode != 200 {
+			return errMsg(fmt.Errorf("failed to fetch status: %d", resp.StatusCode))
+		}
+
+		var statusResp ControlStatusResponse
+		if err := json.NewDecoder(resp.Body).Decode(&statusResp); err != nil {
+			return errMsg(err)
+		}
+
+		return initStatusMsg{
+			mainOn: statusResp.Load12vOn,
+			usbOn:  statusResp.Load5vOn,
+		}
+	}
+}
+
+func fetchDeviceSettings(baseURL, token string) tea.Cmd {
+	return func() tea.Msg {
+		baseURL = strings.TrimRight(baseURL, "/")
+		req, _ := http.NewRequest("GET", baseURL+"/api/setting", nil)
+		req.Header.Set("Authorization", "Bearer "+token)
+
+		resp, err := httpClient.Do(req)
+		if err != nil {
+			return errMsg(err)
+		}
+		defer resp.Body.Close()
+
+		if resp.StatusCode != 200 {
+			return errMsg(fmt.Errorf("failed to fetch settings: %d", resp.StatusCode))
+		}
+
+		var s DeviceSettings
+		if err := json.NewDecoder(resp.Body).Decode(&s); err != nil {
+			return errMsg(err)
+		}
+		return settingsMsg{settings: s}
+	}
+}
+
+func saveDeviceSetting(baseURL, token string, setting DeviceSettings) tea.Cmd {
+	return func() tea.Msg {
+		baseURL = strings.TrimRight(baseURL, "/")
+		reqBody, _ := json.Marshal(setting)
+		req, _ := http.NewRequest("POST", baseURL+"/api/setting", bytes.NewBuffer(reqBody))
+		req.Header.Set("Authorization", "Bearer "+token)
+		req.Header.Set("Content-Type", "application/json")
+
+		resp, err := httpClient.Do(req)
+		if err != nil {
+			return errMsg(err)
+		}
+		defer resp.Body.Close()
+
+		if resp.StatusCode != 200 {
+			return errMsg(fmt.Errorf("save failed: %d", resp.StatusCode))
+		}
+		// Refresh settings after save
+		return fetchDeviceSettings(baseURL, token)()
+	}
+}
+
+func rebootDevice(baseURL, token string) tea.Cmd {
+	return func() tea.Msg {
+		baseURL = strings.TrimRight(baseURL, "/")
+		req, _ := http.NewRequest("POST", baseURL+"/api/reboot", nil)
+		req.Header.Set("Authorization", "Bearer "+token)
+		httpClient.Do(req) // Don't wait for response too strictly as device reboots
+		return nil
+	}
+}
+
+func sendControl(baseURL, token string, payload ControlRequest) tea.Cmd {
+	return func() tea.Msg {
+		baseURL = strings.TrimRight(baseURL, "/")
+		reqBody, _ := json.Marshal(payload)
+		req, _ := http.NewRequest("POST", baseURL+"/api/control", bytes.NewBuffer(reqBody))
+		req.Header.Set("Authorization", "Bearer "+token)
+		req.Header.Set("Content-Type", "application/json")
+
+		resp, err := httpClient.Do(req)
+		if err != nil {
+			return errMsg(err)
+		}
+		defer resp.Body.Close()
+
+		if resp.StatusCode != 200 {
+			body, _ := io.ReadAll(resp.Body)
+			return errMsg(fmt.Errorf("control failed (%d): %s", resp.StatusCode, string(body)))
+		}
+
+		return nil
+	}
+}
+
+// --- WebSocket Handling ---
+func connectWebSocket(baseURL, token string, sendChan <-chan []byte) tea.Cmd {
+	return func() tea.Msg {
+		u, err := url.Parse(baseURL)
+		if err != nil {
+			return errMsg(err)
+		}
+		scheme := "ws"
+		if u.Scheme == "https" {
+			scheme = "wss"
+		}
+		wsURL := fmt.Sprintf("%s://%s/ws?token=%s", scheme, u.Host, token)
+
+		c, _, err := websocket.DefaultDialer.Dial(wsURL, nil)
+		if err != nil {
+			return errMsg(err)
+		}
+
+		go func() {
+			for data := range sendChan {
+				err := c.WriteMessage(websocket.BinaryMessage, data)
+				if err != nil {
+					return
+				}
+			}
+			c.Close()
+		}()
+
+		go func() {
+			defer c.Close()
+			for {
+				_, message, err := c.ReadMessage()
+				if err != nil {
+					return
+				}
+				var statusMsg pb.StatusMessage
+				if err := proto.Unmarshal(message, &statusMsg); err == nil {
+					program.Send(wsMsg(&statusMsg))
+				}
+			}
+		}()
+		return nil
+	}
+}
+
+var program *tea.Program
+
+// --- Model ---
+type state int
+
+const (
+	stateLogin state = iota
+	stateDashboard
+	stateSettings
+)
+
+// Setting Item Types
+const (
+	SetVinLimit = iota
+	SetMainLimit
+	SetUsbLimit
+	SetBaudRate
+	SetPeriod
+	SetReboot
+)
+
+type model struct {
+	state       state
+	baseURL     string
+	token       string
+	width       int
+	height      int
+	err         error
+
+	wsSend chan []byte
+
+	// Login
+	serverInput   textinput.Model
+	usernameInput textinput.Model
+	passwordInput textinput.Model
+	focusIndex    int
+
+	// Dashboard
+	sensorData      *pb.SensorData
+	wifiStatus      *pb.WifiStatus
+	swStatus        *pb.LoadSwStatus
+	term            vt10x.Terminal
+	logViewport     viewport.Model
+	awaitingCommand bool
+	lastStatusMsg   string
+
+	// Settings
+	deviceSettings DeviceSettings
+	settingCursor  int
+	settingEditing bool            // True if currently typing a value
+	settingInput   textinput.Model // Shared input for editing values
+}
+
+func initialModel() model {
+	s := textinput.New()
+	s.Placeholder = "http://192.168.4.1"
+	s.SetValue(DefaultBaseURL)
+	s.Focus()
+
+	u := textinput.New()
+	u.Placeholder = "Username"
+
+	p := textinput.New()
+	p.Placeholder = "Password"
+	p.EchoMode = textinput.EchoPassword
+
+	vp := viewport.New(80, 24)
+	vp.SetContent("Waiting for data...")
+
+	// vt10x 초기화 (Writer는 필요 없으므로 Discard)
+	term := vt10x.New(vt10x.WithWriter(io.Discard))
+	term.Resize(80, 24)
+
+	si := textinput.New()
+	si.CharLimit = 10
+
+	return model{
+		state:         stateLogin,
+		serverInput:   s,
+		usernameInput: u,
+		passwordInput: p,
+		logViewport:   vp,
+		term:          term,
+		swStatus:      &pb.LoadSwStatus{Main: false, Usb: false},
+		wsSend:        make(chan []byte, 100),
+		settingInput:  si,
+	}
+}
+
+func (m model) Init() tea.Cmd {
+	return textinput.Blink
+}
+
+func (m model) renderVt10x() string {
+	var sb strings.Builder
+	rows := m.logViewport.Height
+	cols := m.logViewport.Width
+	sb.Grow(rows * cols * 4)
+
+	cursor := m.term.Cursor()
+	curFG := vt10x.DefaultFG
+	curBG := vt10x.DefaultBG
+
+	sb.WriteString("\x1b[0m")
+
+	for y := 0; y < rows; y++ {
+		for x := 0; x < cols; x++ {
+			cell := m.term.Cell(x, y)
+
+			fg := cell.FG
+			bg := cell.BG
+			char := cell.Char
+			isCursor := (x == cursor.X && y == cursor.Y)
+
+			if fg != curFG || bg != curBG || isCursor {
+				sb.WriteString("\x1b[0m")
+				if isCursor {
+					sb.WriteString("\x1b[7m")
+				}
+				if fg != vt10x.DefaultFG {
+					fmt.Fprintf(&sb, "\x1b[38;5;%dm", fg)
+				}
+				if bg != vt10x.DefaultBG {
+					fmt.Fprintf(&sb, "\x1b[48;5;%dm", bg)
+				}
+				curFG = fg
+				curBG = bg
+
+				if isCursor {
+					curFG = vt10x.Color(65535)
+					curBG = vt10x.Color(65535)
+				}
+			}
+			sb.WriteRune(char)
+		}
+		if y < rows-1 {
+			sb.WriteString("\x1b[0m\n")
+			curFG = vt10x.DefaultFG
+			curBG = vt10x.DefaultBG
+		}
+	}
+	return sb.String()
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+	var cmd tea.Cmd
+	var cmds []tea.Cmd
+
+	switch msg := msg.(type) {
+	case tea.KeyMsg:
+		if m.state == stateLogin {
+			if msg.Type == tea.KeyCtrlC {
+				return m, tea.Quit
+			}
+			switch msg.String() {
+			case "tab":
+				m.focusIndex = (m.focusIndex + 1) % 3
+				m.serverInput.Blur()
+				m.usernameInput.Blur()
+				m.passwordInput.Blur()
+				switch m.focusIndex {
+				case 0:
+					m.serverInput.Focus()
+				case 1:
+					m.usernameInput.Focus()
+				case 2:
+					m.passwordInput.Focus()
+				}
+				return m, textinput.Blink
+			case "enter":
+				m.baseURL = m.serverInput.Value()
+				if m.baseURL == "" {
+					m.baseURL = DefaultBaseURL
+				}
+				return m, login(m.baseURL, m.usernameInput.Value(), m.passwordInput.Value())
+			case "esc":
+				return m, tea.Quit
+			default:
+				if m.focusIndex == 0 {
+					m.serverInput, cmd = m.serverInput.Update(msg)
+					cmds = append(cmds, cmd)
+				} else if m.focusIndex == 1 {
+					m.usernameInput, cmd = m.usernameInput.Update(msg)
+					cmds = append(cmds, cmd)
+				} else {
+					m.passwordInput, cmd = m.passwordInput.Update(msg)
+					cmds = append(cmds, cmd)
+				}
+				return m, tea.Batch(cmds...)
+			}
+		} else if m.state == stateSettings {
+			// SETTINGS STATE
+			if m.settingEditing {
+				switch msg.Type {
+				case tea.KeyEnter:
+					// Save value
+					m.settingEditing = false
+					val := m.settingInput.Value()
+					var cmd tea.Cmd
+
+					switch m.settingCursor {
+					case SetVinLimit:
+						v, _ := strconv.ParseFloat(val, 64)
+						cmd = saveDeviceSetting(m.baseURL, m.token, DeviceSettings{VinCurrentLimit: v})
+					case SetMainLimit:
+						v, _ := strconv.ParseFloat(val, 64)
+						cmd = saveDeviceSetting(m.baseURL, m.token, DeviceSettings{MainCurrentLimit: v})
+					case SetUsbLimit:
+						v, _ := strconv.ParseFloat(val, 64)
+						cmd = saveDeviceSetting(m.baseURL, m.token, DeviceSettings{UsbCurrentLimit: v})
+					case SetBaudRate:
+						v, _ := strconv.Atoi(val)
+						cmd = saveDeviceSetting(m.baseURL, m.token, DeviceSettings{BaudRate: v})
+					case SetPeriod:
+						v, _ := strconv.Atoi(val)
+						cmd = saveDeviceSetting(m.baseURL, m.token, DeviceSettings{SensorPeriod: v})
+					}
+					return m, cmd
+				case tea.KeyEsc:
+					m.settingEditing = false
+					return m, nil
+				default:
+					m.settingInput, cmd = m.settingInput.Update(msg)
+					return m, cmd
+				}
+			} else {
+				// Navigation
+				switch msg.String() {
+				case "q", "esc":
+					m.state = stateDashboard
+					return m, nil
+				case "up":
+					if m.settingCursor > 0 {
+						m.settingCursor--
+					}
+				case "down":
+					if m.settingCursor < 5 { // items count - 1
+						m.settingCursor++
+					}
+				case "enter":
+					if m.settingCursor == SetReboot {
+						return m, rebootDevice(m.baseURL, m.token)
+					}
+					// Start editing
+					m.settingEditing = true
+					m.settingInput.Focus()
+					// Pre-fill value
+					switch m.settingCursor {
+					case SetVinLimit:
+						m.settingInput.SetValue(fmt.Sprintf("%.1f", m.deviceSettings.VinCurrentLimit))
+					case SetMainLimit:
+						m.settingInput.SetValue(fmt.Sprintf("%.1f", m.deviceSettings.MainCurrentLimit))
+					case SetUsbLimit:
+						m.settingInput.SetValue(fmt.Sprintf("%.1f", m.deviceSettings.UsbCurrentLimit))
+					case SetBaudRate:
+						m.settingInput.SetValue(fmt.Sprintf("%d", m.deviceSettings.BaudRate))
+					case SetPeriod:
+						m.settingInput.SetValue(fmt.Sprintf("%d", m.deviceSettings.SensorPeriod))
+					}
+					return m, textinput.Blink
+				}
+			}
+		} else if m.state == stateDashboard {
+			// DASHBOARD STATE
+			keyStr := msg.String()
+
+			if keyStr == "ctrl+a" {
+				m.awaitingCommand = !m.awaitingCommand
+				if m.awaitingCommand {
+					m.lastStatusMsg = "Press '?' for help"
+				} else {
+					m.lastStatusMsg = ""
+				}
+				return m, nil
+			}
+
+			if m.awaitingCommand {
+				m.awaitingCommand = false
+				m.lastStatusMsg = ""
+				switch keyStr {
+				case "m":
+					m.lastStatusMsg = "Toggling Main Power..."
+					newState := !m.swStatus.Main
+					payload := ControlRequest{Load12vOn: &newState}
+					return m, sendControl(m.baseURL, m.token, payload)
+				case "u":
+					m.lastStatusMsg = "Toggling USB Power..."
+					newState := !m.swStatus.Usb
+					payload := ControlRequest{Load5vOn: &newState}
+					return m, sendControl(m.baseURL, m.token, payload)
+				case "r":
+					m.lastStatusMsg = "Sending Reset Signal..."
+					t := true
+					payload := ControlRequest{ResetTrigger: &t}
+					return m, sendControl(m.baseURL, m.token, payload)
+				case "p":
+					m.lastStatusMsg = "Sending Power Action..."
+					t := true
+					payload := ControlRequest{PowerTrigger: &t}
+					return m, sendControl(m.baseURL, m.token, payload)
+				case "a":
+					m.wsSend <- []byte{1}
+					return m, nil
+				case "o": // Open Settings
+					m.state = stateSettings
+					return m, fetchDeviceSettings(m.baseURL, m.token)
+				case "x": // Quit Program
+					return m, tea.Quit
+				case "q": // Close Command Window
+					m.lastStatusMsg = "Command mode closed."
+					return m, nil
+				default:
+					m.lastStatusMsg = "Command cancelled."
+					return m, nil
+				}
+			}
+
+			// Send to UART
+			var data []byte
+			switch msg.Type {
+			case tea.KeyRunes:
+				data = []byte(string(msg.Runes))
+			case tea.KeyEnter:
+				data = []byte{'\r'}
+			case tea.KeySpace:
+				data = []byte{' '}
+			case tea.KeyBackspace:
+				data = []byte{127}
+			case tea.KeyTab:
+				data = []byte{'\t'}
+			case tea.KeyEsc:
+				data = []byte{27}
+			case tea.KeyUp:
+				data = []byte("\x1b[A")
+			case tea.KeyDown:
+				data = []byte("\x1b[B")
+			case tea.KeyRight:
+				data = []byte("\x1b[C")
+			case tea.KeyLeft:
+				data = []byte("\x1b[D")
+			case tea.KeyHome:
+				data = []byte("\x1b[H")
+			case tea.KeyEnd:
+				data = []byte("\x1b[F")
+			case tea.KeyPgUp:
+				data = []byte("\x1b[5~")
+			case tea.KeyPgDown:
+				data = []byte("\x1b[6~")
+			case tea.KeyDelete:
+				data = []byte("\x1b[3~")
+			case tea.KeyInsert:
+				data = []byte("\x1b[2~")
+			default:
+				if len(keyStr) == 6 && strings.HasPrefix(keyStr, "ctrl+") {
+					c := keyStr[5]
+					if c >= 'a' && c <= 'z' {
+						data = []byte{byte(c - 'a' + 1)}
+					} else if c == '@' {
+						data = []byte{0}
+					} else if c == '[' {
+						data = []byte{27}
+					} else if c == '\\' {
+						data = []byte{28}
+					} else if c == ']' {
+						data = []byte{29}
+					} else if c == '^' {
+						data = []byte{30}
+					} else if c == '_' {
+						data = []byte{31}
+					}
+				} else if len(msg.Runes) > 0 {
+					data = []byte(string(msg.Runes))
+				}
+			}
+			if len(data) > 0 {
+				m.wsSend <- data
+			}
+			return m, nil
+		}
+
+	case tea.MouseMsg:
+		if m.state == stateDashboard {
+			var data []byte
+			switch msg.Type {
+			case tea.MouseWheelUp:
+				data = []byte("\x1b[A")
+			case tea.MouseWheelDown:
+				data = []byte("\x1b[B")
+			}
+			if len(data) > 0 {
+				m.wsSend <- data
+			}
+		}
+
+	case tea.WindowSizeMsg:
+		m.width = msg.Width
+		m.height = msg.Height
+		headerHeight := 10
+		termW := msg.Width - 2
+		termH := msg.Height - headerHeight
+		if termH < 5 {
+			termH = 5
+		}
+
+		m.logViewport.Width = termW
+		m.logViewport.Height = termH
+		m.term.Resize(termW, termH)
+
+	case sessionMsg:
+		m.token = msg.token
+		m.state = stateDashboard
+		return m, tea.Batch(
+			connectWebSocket(m.baseURL, m.token, m.wsSend),
+			fetchControlStatus(m.baseURL, m.token),
+		)
+
+	case settingsMsg:
+		m.deviceSettings = msg.settings
+		return m, nil
+
+	case initStatusMsg:
+		m.swStatus.Main = msg.mainOn
+		m.swStatus.Usb = msg.usbOn
+		return m, nil
+
+	case errMsg:
+		m.err = msg
+		return m, nil
+
+	case wsMsg:
+		switch payload := msg.Payload.(type) {
+		case *pb.StatusMessage_SensorData:
+			m.sensorData = payload.SensorData
+		case *pb.StatusMessage_WifiStatus:
+			m.wifiStatus = payload.WifiStatus
+		case *pb.StatusMessage_SwStatus:
+			m.swStatus = payload.SwStatus
+		case *pb.StatusMessage_UartData:
+			m.term.Write(payload.UartData.Data)
+			m.logViewport.SetContent(m.renderVt10x())
+		}
+	}
+
+	return m, tea.Batch(cmds...)
+}
+
+func (m model) View() string {
+	if m.err != nil {
+		return fmt.Sprintf("\nError: %v\n\nPress q to quit", errorStyle.Render(m.err.Error()))
+	}
+
+	if m.state == stateLogin {
+		return m.loginView()
+	} else if m.state == stateSettings {
+		return m.settingsView()
+	}
+
+	return m.dashboardView()
+}
+
+func (m model) loginView() string {
+	var b strings.Builder
+	b.WriteString("\n\n")
+	b.WriteString(titleStyle.Render(" ODROID Power Mate Login "))
+	b.WriteString("\n\n")
+
+	b.WriteString("Server Address:\n")
+	b.WriteString(m.serverInput.View())
+	b.WriteString("\n\n")
+
+	b.WriteString("Username:\n")
+	b.WriteString(m.usernameInput.View())
+	b.WriteString("\n\nPassword:\n")
+	b.WriteString(m.passwordInput.View())
+	b.WriteString("\n\n(Press Tab to switch, Enter to login, Ctrl+C to quit)")
+	return lipgloss.Place(m.width, m.height, lipgloss.Center, lipgloss.Center, b.String())
+}
+
+func (m model) settingsView() string {
+	var s strings.Builder
+	s.WriteString(titleStyle.Render(" Device Settings ") + "\n\n")
+
+	items := []struct {
+		label string
+		value string
+	}{
+		{"VIN Current Limit (A)", fmt.Sprintf("%.1f", m.deviceSettings.VinCurrentLimit)},
+		{"Main Current Limit (A)", fmt.Sprintf("%.1f", m.deviceSettings.MainCurrentLimit)},
+		{"USB Current Limit (A)", fmt.Sprintf("%.1f", m.deviceSettings.UsbCurrentLimit)},
+		{"UART Baud Rate", fmt.Sprintf("%d", m.deviceSettings.BaudRate)},
+		{"Sensor Period (ms)", fmt.Sprintf("%d", m.deviceSettings.SensorPeriod)},
+		{"[ Reboot Device ]", ""},
+	}
+
+	for i, item := range items {
+		label := item.label
+		value := item.value
+
+		if i == m.settingCursor {
+			s.WriteString(selectedItemStyle.Render(label))
+			if m.settingEditing {
+				s.WriteString(": " + m.settingInput.View())
+			} else {
+				s.WriteString(": " + value)
+			}
+		} else {
+			s.WriteString(settingItemStyle.Render(label + ": " + value))
+		}
+		s.WriteString("\n")
+	}
+
+	s.WriteString("\n(Enter to edit, Esc/q to back)")
+	return lipgloss.Place(m.width, m.height, lipgloss.Center, lipgloss.Center, s.String())
+}
+
+func (m model) dashboardView() string {
+	// Base Dashboard
+	header := titleStyle.Render(" ODROID Power Mate ")
+	if m.wifiStatus != nil {
+		ssid := m.wifiStatus.Ssid
+		if ssid == "" {
+			ssid = "Disconnected"
+		}
+		header += infoStyle.Render(fmt.Sprintf(" WiFi: %s (%s)", ssid, m.wifiStatus.IpAddress))
+	} else {
+		header += infoStyle.Render(" WiFi: --")
+	}
+
+	var statusText string
+	var statusStyle lipgloss.Style
+	if m.awaitingCommand {
+		statusText = " COMMAND MODE (Ctrl-A) >> Press: M(Main) U(USB) P(Power) R(Reset) O(Settings) A(Ctrl+A) Q(Close) X(Quit)"
+		statusStyle = commandModeStyle
+	} else {
+		statusText = " TERMINAL MODE >> Press Ctrl-A for Commands "
+		if m.lastStatusMsg != "" {
+			statusText += "| " + m.lastStatusMsg
+		}
+		statusStyle = statusBarStyle
+	}
+	bar := statusStyle.Width(m.width).Render(statusText)
+
+	metrics := ""
+	if m.sensorData != nil {
+		metrics = fmt.Sprintf(
+			"USB:  %.2f V / %.2f A / %.2f W\nMAIN: %.2f V / %.2f A / %.2f W\nVIN:  %.2f V / %.2f A / %.2f W\nUptime: %ds",
+			m.sensorData.Usb.Voltage, m.sensorData.Usb.Current, m.sensorData.Usb.Power,
+			m.sensorData.Main.Voltage, m.sensorData.Main.Current, m.sensorData.Main.Power,
+			m.sensorData.Vin.Voltage, m.sensorData.Vin.Current, m.sensorData.Vin.Power,
+			m.sensorData.UptimeMs/1000,
+		)
+	} else {
+		metrics = "Waiting for sensor data..."
+	}
+	metricsBox := lipgloss.NewStyle().Border(lipgloss.RoundedBorder()).Padding(0, 1).Width(m.width/2 - 2).Render(metrics)
+
+	switches := "States:\n"
+	mainState := "[OFF]"
+	if m.swStatus.Main {
+		mainState = "[ON ]"
+	}
+	usbState := "[OFF]"
+	if m.swStatus.Usb {
+		usbState = "[ON ]"
+	}
+	switches += fmt.Sprintf("Main: %s\n", mainState)
+	switches += fmt.Sprintf("USB : %s\n", usbState)
+	switchBox := lipgloss.NewStyle().Border(lipgloss.RoundedBorder()).Padding(0, 1).Width(m.width/2 - 2).Render(switches)
+
+	topSection := lipgloss.JoinHorizontal(lipgloss.Top, metricsBox, switchBox)
+
+	termView := lipgloss.NewStyle().
+		Border(lipgloss.NormalBorder()).
+		BorderForeground(lipgloss.Color("240")).
+		Width(m.width - 2).
+		Height(m.logViewport.Height).
+		Render(m.logViewport.View())
+
+	baseView := lipgloss.JoinVertical(lipgloss.Left, header, topSection, bar, termView)
+
+	// --- Help Overlay ---
+	if m.awaitingCommand {
+		helpText := `
+COMMAND MODE (Ctrl+A)
+
+  m : Toggle Main Power
+  u : Toggle USB Power
+  p : Power Trigger (Long Press)
+  r : Reset Trigger
+  o : Open Settings
+  a : Send 'Ctrl+A'
+  q : Close Command Window
+  x : Quit Program
+		`
+		helpWindow := helpBoxStyle.Render(helpText)
+
+		// Overlay help window on top of base view using lipgloss.Place
+		return lipgloss.Place(m.width, m.height, lipgloss.Center, lipgloss.Center, helpWindow, lipgloss.WithWhitespaceChars(" "), lipgloss.WithWhitespaceForeground(lipgloss.NoColor{}))
+	}
+
+	return baseView
+}
+
+func main() {
+	program = tea.NewProgram(initialModel(), tea.WithAltScreen(), tea.WithMouseCellMotion())
+	if _, err := program.Run(); err != nil {
+		fmt.Printf("Error running program: %v\n", err)
+		os.Exit(1)
+	}
+}

example/console-frontend/pb/status.pb.go

@@ -0,0 +1,647 @@
+// Code generated by protoc-gen-go. DO NOT EDIT.
+// versions:
+// 	protoc-gen-go v1.32.0
+// 	protoc        v3.21.12
+// source: status.proto
+
+package pb
+
+import (
+	protoreflect "google.golang.org/protobuf/reflect/protoreflect"
+	protoimpl "google.golang.org/protobuf/runtime/protoimpl"
+	reflect "reflect"
+	sync "sync"
+)
+
+const (
+	// Verify that this generated code is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
+	// Verify that runtime/protoimpl is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
+)
+
+// Represents data for a single sensor channel
+type SensorChannelData struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	Voltage float32 `protobuf:"fixed32,1,opt,name=voltage,proto3" json:"voltage,omitempty"`
+	Current float32 `protobuf:"fixed32,2,opt,name=current,proto3" json:"current,omitempty"`
+	Power   float32 `protobuf:"fixed32,3,opt,name=power,proto3" json:"power,omitempty"`
+}
+
+func (x *SensorChannelData) Reset() {
+	*x = SensorChannelData{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_status_proto_msgTypes[0]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *SensorChannelData) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*SensorChannelData) ProtoMessage() {}
+
+func (x *SensorChannelData) ProtoReflect() protoreflect.Message {
+	mi := &file_status_proto_msgTypes[0]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use SensorChannelData.ProtoReflect.Descriptor instead.
+func (*SensorChannelData) Descriptor() ([]byte, []int) {
+	return file_status_proto_rawDescGZIP(), []int{0}
+}
+
+func (x *SensorChannelData) GetVoltage() float32 {
+	if x != nil {
+		return x.Voltage
+	}
+	return 0
+}
+
+func (x *SensorChannelData) GetCurrent() float32 {
+	if x != nil {
+		return x.Current
+	}
+	return 0
+}
+
+func (x *SensorChannelData) GetPower() float32 {
+	if x != nil {
+		return x.Power
+	}
+	return 0
+}
+
+// Contains data for all sensor channels and system info
+type SensorData struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	Usb         *SensorChannelData `protobuf:"bytes,1,opt,name=usb,proto3" json:"usb,omitempty"`
+	Main        *SensorChannelData `protobuf:"bytes,2,opt,name=main,proto3" json:"main,omitempty"`
+	Vin         *SensorChannelData `protobuf:"bytes,3,opt,name=vin,proto3" json:"vin,omitempty"`
+	TimestampMs uint64             `protobuf:"varint,4,opt,name=timestamp_ms,json=timestampMs,proto3" json:"timestamp_ms,omitempty"`
+	UptimeMs    uint64             `protobuf:"varint,5,opt,name=uptime_ms,json=uptimeMs,proto3" json:"uptime_ms,omitempty"`
+}
+
+func (x *SensorData) Reset() {
+	*x = SensorData{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_status_proto_msgTypes[1]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *SensorData) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*SensorData) ProtoMessage() {}
+
+func (x *SensorData) ProtoReflect() protoreflect.Message {
+	mi := &file_status_proto_msgTypes[1]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use SensorData.ProtoReflect.Descriptor instead.
+func (*SensorData) Descriptor() ([]byte, []int) {
+	return file_status_proto_rawDescGZIP(), []int{1}
+}
+
+func (x *SensorData) GetUsb() *SensorChannelData {
+	if x != nil {
+		return x.Usb
+	}
+	return nil
+}
+
+func (x *SensorData) GetMain() *SensorChannelData {
+	if x != nil {
+		return x.Main
+	}
+	return nil
+}
+
+func (x *SensorData) GetVin() *SensorChannelData {
+	if x != nil {
+		return x.Vin
+	}
+	return nil
+}
+
+func (x *SensorData) GetTimestampMs() uint64 {
+	if x != nil {
+		return x.TimestampMs
+	}
+	return 0
+}
+
+func (x *SensorData) GetUptimeMs() uint64 {
+	if x != nil {
+		return x.UptimeMs
+	}
+	return 0
+}
+
+// Contains WiFi connection status
+type WifiStatus struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	Connected bool   `protobuf:"varint,1,opt,name=connected,proto3" json:"connected,omitempty"`
+	Ssid      string `protobuf:"bytes,2,opt,name=ssid,proto3" json:"ssid,omitempty"`
+	Rssi      int32  `protobuf:"varint,3,opt,name=rssi,proto3" json:"rssi,omitempty"`
+	IpAddress string `protobuf:"bytes,4,opt,name=ip_address,json=ipAddress,proto3" json:"ip_address,omitempty"`
+}
+
+func (x *WifiStatus) Reset() {
+	*x = WifiStatus{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_status_proto_msgTypes[2]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *WifiStatus) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*WifiStatus) ProtoMessage() {}
+
+func (x *WifiStatus) ProtoReflect() protoreflect.Message {
+	mi := &file_status_proto_msgTypes[2]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use WifiStatus.ProtoReflect.Descriptor instead.
+func (*WifiStatus) Descriptor() ([]byte, []int) {
+	return file_status_proto_rawDescGZIP(), []int{2}
+}
+
+func (x *WifiStatus) GetConnected() bool {
+	if x != nil {
+		return x.Connected
+	}
+	return false
+}
+
+func (x *WifiStatus) GetSsid() string {
+	if x != nil {
+		return x.Ssid
+	}
+	return ""
+}
+
+func (x *WifiStatus) GetRssi() int32 {
+	if x != nil {
+		return x.Rssi
+	}
+	return 0
+}
+
+func (x *WifiStatus) GetIpAddress() string {
+	if x != nil {
+		return x.IpAddress
+	}
+	return ""
+}
+
+// Contains raw UART data
+type UartData struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	Data []byte `protobuf:"bytes,1,opt,name=data,proto3" json:"data,omitempty"`
+}
+
+func (x *UartData) Reset() {
+	*x = UartData{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_status_proto_msgTypes[3]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *UartData) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*UartData) ProtoMessage() {}
+
+func (x *UartData) ProtoReflect() protoreflect.Message {
+	mi := &file_status_proto_msgTypes[3]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use UartData.ProtoReflect.Descriptor instead.
+func (*UartData) Descriptor() ([]byte, []int) {
+	return file_status_proto_rawDescGZIP(), []int{3}
+}
+
+func (x *UartData) GetData() []byte {
+	if x != nil {
+		return x.Data
+	}
+	return nil
+}
+
+// Contains load sw status
+type LoadSwStatus struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	Main bool `protobuf:"varint,1,opt,name=main,proto3" json:"main,omitempty"`
+	Usb  bool `protobuf:"varint,2,opt,name=usb,proto3" json:"usb,omitempty"`
+}
+
+func (x *LoadSwStatus) Reset() {
+	*x = LoadSwStatus{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_status_proto_msgTypes[4]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *LoadSwStatus) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*LoadSwStatus) ProtoMessage() {}
+
+func (x *LoadSwStatus) ProtoReflect() protoreflect.Message {
+	mi := &file_status_proto_msgTypes[4]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use LoadSwStatus.ProtoReflect.Descriptor instead.
+func (*LoadSwStatus) Descriptor() ([]byte, []int) {
+	return file_status_proto_rawDescGZIP(), []int{4}
+}
+
+func (x *LoadSwStatus) GetMain() bool {
+	if x != nil {
+		return x.Main
+	}
+	return false
+}
+
+func (x *LoadSwStatus) GetUsb() bool {
+	if x != nil {
+		return x.Usb
+	}
+	return false
+}
+
+// Top-level message for all websocket communication
+type StatusMessage struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// Types that are assignable to Payload:
+	//
+	//	*StatusMessage_SensorData
+	//	*StatusMessage_WifiStatus
+	//	*StatusMessage_SwStatus
+	//	*StatusMessage_UartData
+	Payload isStatusMessage_Payload `protobuf_oneof:"payload"`
+}
+
+func (x *StatusMessage) Reset() {
+	*x = StatusMessage{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_status_proto_msgTypes[5]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *StatusMessage) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*StatusMessage) ProtoMessage() {}
+
+func (x *StatusMessage) ProtoReflect() protoreflect.Message {
+	mi := &file_status_proto_msgTypes[5]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use StatusMessage.ProtoReflect.Descriptor instead.
+func (*StatusMessage) Descriptor() ([]byte, []int) {
+	return file_status_proto_rawDescGZIP(), []int{5}
+}
+
+func (m *StatusMessage) GetPayload() isStatusMessage_Payload {
+	if m != nil {
+		return m.Payload
+	}
+	return nil
+}
+
+func (x *StatusMessage) GetSensorData() *SensorData {
+	if x, ok := x.GetPayload().(*StatusMessage_SensorData); ok {
+		return x.SensorData
+	}
+	return nil
+}
+
+func (x *StatusMessage) GetWifiStatus() *WifiStatus {
+	if x, ok := x.GetPayload().(*StatusMessage_WifiStatus); ok {
+		return x.WifiStatus
+	}
+	return nil
+}
+
+func (x *StatusMessage) GetSwStatus() *LoadSwStatus {
+	if x, ok := x.GetPayload().(*StatusMessage_SwStatus); ok {
+		return x.SwStatus
+	}
+	return nil
+}
+
+func (x *StatusMessage) GetUartData() *UartData {
+	if x, ok := x.GetPayload().(*StatusMessage_UartData); ok {
+		return x.UartData
+	}
+	return nil
+}
+
+type isStatusMessage_Payload interface {
+	isStatusMessage_Payload()
+}
+
+type StatusMessage_SensorData struct {
+	SensorData *SensorData `protobuf:"bytes,1,opt,name=sensor_data,json=sensorData,proto3,oneof"`
+}
+
+type StatusMessage_WifiStatus struct {
+	WifiStatus *WifiStatus `protobuf:"bytes,2,opt,name=wifi_status,json=wifiStatus,proto3,oneof"`
+}
+
+type StatusMessage_SwStatus struct {
+	SwStatus *LoadSwStatus `protobuf:"bytes,3,opt,name=sw_status,json=swStatus,proto3,oneof"`
+}
+
+type StatusMessage_UartData struct {
+	UartData *UartData `protobuf:"bytes,4,opt,name=uart_data,json=uartData,proto3,oneof"`
+}
+
+func (*StatusMessage_SensorData) isStatusMessage_Payload() {}
+
+func (*StatusMessage_WifiStatus) isStatusMessage_Payload() {}
+
+func (*StatusMessage_SwStatus) isStatusMessage_Payload() {}
+
+func (*StatusMessage_UartData) isStatusMessage_Payload() {}
+
+var File_status_proto protoreflect.FileDescriptor
+
+var file_status_proto_rawDesc = []byte{
+	0x0a, 0x0c, 0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x06,
+	0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x22, 0x5d, 0x0a, 0x11, 0x53, 0x65, 0x6e, 0x73, 0x6f, 0x72,
+	0x43, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x44, 0x61, 0x74, 0x61, 0x12, 0x18, 0x0a, 0x07, 0x76,
+	0x6f, 0x6c, 0x74, 0x61, 0x67, 0x65, 0x18, 0x01, 0x20, 0x01, 0x28, 0x02, 0x52, 0x07, 0x76, 0x6f,
+	0x6c, 0x74, 0x61, 0x67, 0x65, 0x12, 0x18, 0x0a, 0x07, 0x63, 0x75, 0x72, 0x72, 0x65, 0x6e, 0x74,
+	0x18, 0x02, 0x20, 0x01, 0x28, 0x02, 0x52, 0x07, 0x63, 0x75, 0x72, 0x72, 0x65, 0x6e, 0x74, 0x12,
+	0x14, 0x0a, 0x05, 0x70, 0x6f, 0x77, 0x65, 0x72, 0x18, 0x03, 0x20, 0x01, 0x28, 0x02, 0x52, 0x05,
+	0x70, 0x6f, 0x77, 0x65, 0x72, 0x22, 0xd5, 0x01, 0x0a, 0x0a, 0x53, 0x65, 0x6e, 0x73, 0x6f, 0x72,
+	0x44, 0x61, 0x74, 0x61, 0x12, 0x2b, 0x0a, 0x03, 0x75, 0x73, 0x62, 0x18, 0x01, 0x20, 0x01, 0x28,
+	0x0b, 0x32, 0x19, 0x2e, 0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x2e, 0x53, 0x65, 0x6e, 0x73, 0x6f,
+	0x72, 0x43, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x44, 0x61, 0x74, 0x61, 0x52, 0x03, 0x75, 0x73,
+	0x62, 0x12, 0x2d, 0x0a, 0x04, 0x6d, 0x61, 0x69, 0x6e, 0x18, 0x02, 0x20, 0x01, 0x28, 0x0b, 0x32,
+	0x19, 0x2e, 0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x2e, 0x53, 0x65, 0x6e, 0x73, 0x6f, 0x72, 0x43,
+	0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x44, 0x61, 0x74, 0x61, 0x52, 0x04, 0x6d, 0x61, 0x69, 0x6e,
+	0x12, 0x2b, 0x0a, 0x03, 0x76, 0x69, 0x6e, 0x18, 0x03, 0x20, 0x01, 0x28, 0x0b, 0x32, 0x19, 0x2e,
+	0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x2e, 0x53, 0x65, 0x6e, 0x73, 0x6f, 0x72, 0x43, 0x68, 0x61,
+	0x6e, 0x6e, 0x65, 0x6c, 0x44, 0x61, 0x74, 0x61, 0x52, 0x03, 0x76, 0x69, 0x6e, 0x12, 0x21, 0x0a,
+	0x0c, 0x74, 0x69, 0x6d, 0x65, 0x73, 0x74, 0x61, 0x6d, 0x70, 0x5f, 0x6d, 0x73, 0x18, 0x04, 0x20,
+	0x01, 0x28, 0x04, 0x52, 0x0b, 0x74, 0x69, 0x6d, 0x65, 0x73, 0x74, 0x61, 0x6d, 0x70, 0x4d, 0x73,
+	0x12, 0x1b, 0x0a, 0x09, 0x75, 0x70, 0x74, 0x69, 0x6d, 0x65, 0x5f, 0x6d, 0x73, 0x18, 0x05, 0x20,
+	0x01, 0x28, 0x04, 0x52, 0x08, 0x75, 0x70, 0x74, 0x69, 0x6d, 0x65, 0x4d, 0x73, 0x22, 0x71, 0x0a,
+	0x0a, 0x57, 0x69, 0x66, 0x69, 0x53, 0x74, 0x61, 0x74, 0x75, 0x73, 0x12, 0x1c, 0x0a, 0x09, 0x63,
+	0x6f, 0x6e, 0x6e, 0x65, 0x63, 0x74, 0x65, 0x64, 0x18, 0x01, 0x20, 0x01, 0x28, 0x08, 0x52, 0x09,
+	0x63, 0x6f, 0x6e, 0x6e, 0x65, 0x63, 0x74, 0x65, 0x64, 0x12, 0x12, 0x0a, 0x04, 0x73, 0x73, 0x69,
+	0x64, 0x18, 0x02, 0x20, 0x01, 0x28, 0x09, 0x52, 0x04, 0x73, 0x73, 0x69, 0x64, 0x12, 0x12, 0x0a,
+	0x04, 0x72, 0x73, 0x73, 0x69, 0x18, 0x03, 0x20, 0x01, 0x28, 0x05, 0x52, 0x04, 0x72, 0x73, 0x73,
+	0x69, 0x12, 0x1d, 0x0a, 0x0a, 0x69, 0x70, 0x5f, 0x61, 0x64, 0x64, 0x72, 0x65, 0x73, 0x73, 0x18,
+	0x04, 0x20, 0x01, 0x28, 0x09, 0x52, 0x09, 0x69, 0x70, 0x41, 0x64, 0x64, 0x72, 0x65, 0x73, 0x73,
+	0x22, 0x1e, 0x0a, 0x08, 0x55, 0x61, 0x72, 0x74, 0x44, 0x61, 0x74, 0x61, 0x12, 0x12, 0x0a, 0x04,
+	0x64, 0x61, 0x74, 0x61, 0x18, 0x01, 0x20, 0x01, 0x28, 0x0c, 0x52, 0x04, 0x64, 0x61, 0x74, 0x61,
+	0x22, 0x34, 0x0a, 0x0c, 0x4c, 0x6f, 0x61, 0x64, 0x53, 0x77, 0x53, 0x74, 0x61, 0x74, 0x75, 0x73,
+	0x12, 0x12, 0x0a, 0x04, 0x6d, 0x61, 0x69, 0x6e, 0x18, 0x01, 0x20, 0x01, 0x28, 0x08, 0x52, 0x04,
+	0x6d, 0x61, 0x69, 0x6e, 0x12, 0x10, 0x0a, 0x03, 0x75, 0x73, 0x62, 0x18, 0x02, 0x20, 0x01, 0x28,
+	0x08, 0x52, 0x03, 0x75, 0x73, 0x62, 0x22, 0xee, 0x01, 0x0a, 0x0d, 0x53, 0x74, 0x61, 0x74, 0x75,
+	0x73, 0x4d, 0x65, 0x73, 0x73, 0x61, 0x67, 0x65, 0x12, 0x35, 0x0a, 0x0b, 0x73, 0x65, 0x6e, 0x73,
+	0x6f, 0x72, 0x5f, 0x64, 0x61, 0x74, 0x61, 0x18, 0x01, 0x20, 0x01, 0x28, 0x0b, 0x32, 0x12, 0x2e,
+	0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x2e, 0x53, 0x65, 0x6e, 0x73, 0x6f, 0x72, 0x44, 0x61, 0x74,
+	0x61, 0x48, 0x00, 0x52, 0x0a, 0x73, 0x65, 0x6e, 0x73, 0x6f, 0x72, 0x44, 0x61, 0x74, 0x61, 0x12,
+	0x35, 0x0a, 0x0b, 0x77, 0x69, 0x66, 0x69, 0x5f, 0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x18, 0x02,
+	0x20, 0x01, 0x28, 0x0b, 0x32, 0x12, 0x2e, 0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x2e, 0x57, 0x69,
+	0x66, 0x69, 0x53, 0x74, 0x61, 0x74, 0x75, 0x73, 0x48, 0x00, 0x52, 0x0a, 0x77, 0x69, 0x66, 0x69,
+	0x53, 0x74, 0x61, 0x74, 0x75, 0x73, 0x12, 0x33, 0x0a, 0x09, 0x73, 0x77, 0x5f, 0x73, 0x74, 0x61,
+	0x74, 0x75, 0x73, 0x18, 0x03, 0x20, 0x01, 0x28, 0x0b, 0x32, 0x14, 0x2e, 0x73, 0x74, 0x61, 0x74,
+	0x75, 0x73, 0x2e, 0x4c, 0x6f, 0x61, 0x64, 0x53, 0x77, 0x53, 0x74, 0x61, 0x74, 0x75, 0x73, 0x48,
+	0x00, 0x52, 0x08, 0x73, 0x77, 0x53, 0x74, 0x61, 0x74, 0x75, 0x73, 0x12, 0x2f, 0x0a, 0x09, 0x75,
+	0x61, 0x72, 0x74, 0x5f, 0x64, 0x61, 0x74, 0x61, 0x18, 0x04, 0x20, 0x01, 0x28, 0x0b, 0x32, 0x10,
+	0x2e, 0x73, 0x74, 0x61, 0x74, 0x75, 0x73, 0x2e, 0x55, 0x61, 0x72, 0x74, 0x44, 0x61, 0x74, 0x61,
+	0x48, 0x00, 0x52, 0x08, 0x75, 0x61, 0x72, 0x74, 0x44, 0x61, 0x74, 0x61, 0x42, 0x09, 0x0a, 0x07,
+	0x70, 0x61, 0x79, 0x6c, 0x6f, 0x61, 0x64, 0x42, 0x06, 0x5a, 0x04, 0x2e, 0x2f, 0x70, 0x62, 0x62,
+	0x06, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x33,
+}
+
+var (
+	file_status_proto_rawDescOnce sync.Once
+	file_status_proto_rawDescData = file_status_proto_rawDesc
+)
+
+func file_status_proto_rawDescGZIP() []byte {
+	file_status_proto_rawDescOnce.Do(func() {
+		file_status_proto_rawDescData = protoimpl.X.CompressGZIP(file_status_proto_rawDescData)
+	})
+	return file_status_proto_rawDescData
+}
+
+var file_status_proto_msgTypes = make([]protoimpl.MessageInfo, 6)
+var file_status_proto_goTypes = []interface{}{
+	(*SensorChannelData)(nil), // 0: status.SensorChannelData
+	(*SensorData)(nil),        // 1: status.SensorData
+	(*WifiStatus)(nil),        // 2: status.WifiStatus
+	(*UartData)(nil),          // 3: status.UartData
+	(*LoadSwStatus)(nil),      // 4: status.LoadSwStatus
+	(*StatusMessage)(nil),     // 5: status.StatusMessage
+}
+var file_status_proto_depIdxs = []int32{
+	0, // 0: status.SensorData.usb:type_name -> status.SensorChannelData
+	0, // 1: status.SensorData.main:type_name -> status.SensorChannelData
+	0, // 2: status.SensorData.vin:type_name -> status.SensorChannelData
+	1, // 3: status.StatusMessage.sensor_data:type_name -> status.SensorData
+	2, // 4: status.StatusMessage.wifi_status:type_name -> status.WifiStatus
+	4, // 5: status.StatusMessage.sw_status:type_name -> status.LoadSwStatus
+	3, // 6: status.StatusMessage.uart_data:type_name -> status.UartData
+	7, // [7:7] is the sub-list for method output_type
+	7, // [7:7] is the sub-list for method input_type
+	7, // [7:7] is the sub-list for extension type_name
+	7, // [7:7] is the sub-list for extension extendee
+	0, // [0:7] is the sub-list for field type_name
+}
+
+func init() { file_status_proto_init() }
+func file_status_proto_init() {
+	if File_status_proto != nil {
+		return
+	}
+	if !protoimpl.UnsafeEnabled {
+		file_status_proto_msgTypes[0].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*SensorChannelData); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_status_proto_msgTypes[1].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*SensorData); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_status_proto_msgTypes[2].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*WifiStatus); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_status_proto_msgTypes[3].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*UartData); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_status_proto_msgTypes[4].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*LoadSwStatus); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_status_proto_msgTypes[5].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*StatusMessage); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+	}
+	file_status_proto_msgTypes[5].OneofWrappers = []interface{}{
+		(*StatusMessage_SensorData)(nil),
+		(*StatusMessage_WifiStatus)(nil),
+		(*StatusMessage_SwStatus)(nil),
+		(*StatusMessage_UartData)(nil),
+	}
+	type x struct{}
+	out := protoimpl.TypeBuilder{
+		File: protoimpl.DescBuilder{
+			GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
+			RawDescriptor: file_status_proto_rawDesc,
+			NumEnums:      0,
+			NumMessages:   6,
+			NumExtensions: 0,
+			NumServices:   0,
+		},
+		GoTypes:           file_status_proto_goTypes,
+		DependencyIndexes: file_status_proto_depIdxs,
+		MessageInfos:      file_status_proto_msgTypes,
+	}.Build()
+	File_status_proto = out.File
+	file_status_proto_rawDesc = nil
+	file_status_proto_goTypes = nil
+	file_status_proto_depIdxs = nil
+}

example/console-frontend/status.proto

@@ -0,0 +1,49 @@
+syntax = "proto3";
+
+package status;
+option go_package = "./pb";
+
+// Represents data for a single sensor channel
+message SensorChannelData {
+  float voltage = 1;
+  float current = 2;
+  float power = 3;
+}
+
+// Contains data for all sensor channels and system info
+message SensorData {
+  SensorChannelData usb = 1;
+  SensorChannelData main = 2;
+  SensorChannelData vin = 3;
+  uint64 timestamp_ms = 4;
+  uint64 uptime_ms = 5;
+}
+
+// Contains WiFi connection status
+message WifiStatus {
+  bool connected = 1;
+  string ssid = 2;
+  int32 rssi = 3;
+  string ip_address = 4;
+}
+
+// Contains raw UART data
+message UartData {
+  bytes data = 1;
+}
+
+// Contains load sw status
+message LoadSwStatus {
+  bool main = 1;
+  bool usb = 2;
+}
+
+// Top-level message for all websocket communication
+message StatusMessage {
+   oneof payload {
+    SensorData sensor_data = 1;
+    WifiStatus wifi_status = 2;
+     LoadSwStatus sw_status = 3;
+     UartData uart_data = 4;
+  }
+}

example/logger/README.md

@@ -1,41 +1,140 @@
-# Power Consumption Logger Example
+# Odroid PowerMate Logger and Plotter
 
-Based on this script, you can monitor power consumption and implement graph plotting.
+This directory contains two Python scripts to log power data from an Odroid PowerMate device and visualize it.
 
-## How to Run the Script
+1.  `logger.py`: Connects to the device's web server, authenticates, and logs real-time power data from its WebSocket to a CSV file.
+2.  `csv_2_plot.py`: Reads the generated CSV file and creates a plot image of the power, voltage, and current data over time.
 
-### Install Python Virtual Environment
+## Prerequisites
 
-```shell
-sudo apt install virtualenv
-virtualenv venv
-source venv/bin/activate
+### 1. Clone this example
+```bash
+git clone https://github.com/hardkernel/odroid-powermate.git
+cd odroid-powermate/example/logger
 ```
 
-### Install require package
+### 2. Python and Virtual Environment
 
-```shell
-pip install grpcio-tools requests websockets protobuf pandas matplotlib
+It is highly recommended to use a Python virtual environment to manage project dependencies and avoid conflicts with other projects.
+
+Ensure you have Python 3 installed.
+
+1.  **Create a virtual environment:**
+    Open your terminal in this directory and run:
+    ```bash
+    python3 -m venv venv
+    ```
+    This will create a `venv` directory containing the Python interpreter and libraries.
+
+2.  **Activate the virtual environment:**
+    *   **On Windows:**
+        ```powershell
+        .\venv\Scripts\activate
+        ```
+    *   **On macOS and Linux:**
+        ```bash
+        source venv/bin/activate
+        ```
+    Your terminal prompt should now show `(venv)` at the beginning, indicating that the virtual environment is active.
+
+### 3. Install Required Libraries
+
+With the virtual environment activated, install the necessary Python packages:
+
+```bash
+pip3 install requests websockets protobuf pandas matplotlib python-dateutil scipy
 ```
 
-### Build `status_pb2.py`
+### 4. Protobuf Generated File
 
-```shell
-python -m grpc_tools.protoc -I ../../proto --python_out=. status.proto
+The `logger.py` script uses Google Protocol Buffers (Protobuf) to decode real-time data from the WebSocket. This requires a Python file, `status_pb2.py`, which is generated from a Protobuf definition file (`status.proto`).
+
+**How to Generate `status_pb2.py`:**
+
+1.  **Install Protobuf Compiler Tools:**
+    You need the `grpcio-tools` package, which includes the `protoc` compiler and Python plugins. You can install it via pip:
+    ```bash
+    pip3 install grpcio-tools
+    ```
+
+2.  **Locate the `.proto` file:**
+    Ensure you have the `status.proto` file in the current directory. This file defines the structure of the data messages.
+
+3.  **Run the Compiler:**
+    Execute the following command in your terminal. This command tells `protoc` to look for `status.proto` in the directory (`-I../../proto`) and generate the Python output file (`--python_out=.`) in the same place.
+    ```bash
+    python3 -m grpc_tools.protoc -I../../proto --python_out=. status.proto
+    ```
+After running this command, the `status_pb2.py` file will be created, and `logger.py` will be able to use it.
+
+## Usage
+
+The process is a two-step workflow: first log the data, then plot it.
+
+### Step 1: Log Power Data with `logger.py`
+
+Run `logger.py` to connect to your Odroid Smart Power device and save the data to a CSV file.
+
+**Syntax:**
+```bash
+python3 logger.py <host> -u <username> -p <password> -o <output_file.csv>
 ```
 
-### Execute script
+**Arguments:**
+*   `host`: The IP address or hostname of the Odroid Smart Power device (e.g., `192.168.1.50`).
+*   `-u`, `--username`: The username for logging in.
+*   `-p`, `--password`: The password for logging in.
+*   `-o`, `--output`: The path to save the output CSV file. This is required if you want to generate a plot.
 
-#### Power consumption collection
-```shell
-# python3 logger.py -u <username> -o <name.csv> -p <password> <address>
-python3 logger.py -u admin -p password -o test.csv 192.168.30.5 
+**Example:**
+
+This command will log in and save the power data to `power_log.csv`.
+
+```bash
+python3 logger.py 192.168.1.50 -u admin -p mypassword -o power_log.csv
 ```
 
-#### Plot data
+The script will continue to log data until you stop it with `Ctrl+C`.
 
-```shell
-python3 csv_2_plot.py test.csv plot.png [--type power voltage current]
+### Step 2: Generate a Plot with `csv_2_plot.py`
+
+Once you have a CSV log file, you can use `csv_2_plot.py` to create a visual graph.
+You can also use the csv file recorded from PowerMate Web.
+
+**Syntax:**
+```bash
+python3 csv_2_plot.py <input.csv> <output.png> [options]
 ```
 
-![plot.png](plot.png)
+**Arguments:**
+*   `input_csv`: The path to the CSV file generated by `logger.py`.
+*   `output_image`: The path to save the output plot image (e.g., `plot.png`).
+
+**Optional Arguments:**
+*   `-t`, `--type`: Specify which plots to generate. Choices are `power`, `voltage`, `current`. Default is all three.
+*   `-s`, `--source`: Specify which power sources to include. Choices are `vin`, `main`, `usb`. Default is all three.
+
+**Example 1: Default Plot**
+
+This command reads `power_log.csv` and generates a plot containing power, voltage, and current for all sources, saving it as `power_graph.png`.
+
+```bash
+python3 csv_2_plot.py power_log.csv power_graph.png
+```
+
+**Example 2: Custom Plot**
+
+This command generates a plot showing only the **power** and **current** for the **MAIN** and **USB** sources.
+
+```bash
+# main, usb power consumption
+python csv_2_plot.py power_log.csv custom_plot.png --type power --source main usb
+```
+
+## Example Output
+
+Running the plot script will generate an image file similar to this:
+
+![plot.png](img/plot.png)
+
+The 5-unit scale is highlighted with a blue dotted line, and the 10-unit scale is highlighted with a red dotted line.

example/logger/csv_2_plot.py

@@ -1,25 +1,59 @@
 import argparse
-
+import matplotlib
+matplotlib.use('Agg')
 import matplotlib.dates as mdates
 import matplotlib.pyplot as plt
 import pandas as pd
+from dateutil.tz import gettz
+from matplotlib.ticker import MultipleLocator, FuncFormatter
+import math
+from scipy.signal import savgol_filter
+from scipy.ndimage import gaussian_filter1d
 
 
-def plot_power_data(csv_path, output_path, plot_types):
+def plot_power_data(csv_path, output_path, plot_types, sources,
+                    voltage_y_max=None, current_y_max=None, power_y_max=None,
+                    relative_time=False, time_x_line=None, time_x_label=None,
+                    filter_type=None, window_size=None):
     """
     Reads power data from a CSV file and generates a plot image.
 
     Args:
         csv_path (str): The path to the input CSV file.
         output_path (str): The path to save the output plot image.
-        plot_types (list): A list of strings indicating which plots to generate
-                           (e.g., ['power', 'voltage', 'current']).
+        plot_types (list): A list of strings indicating which plots to generate.
+        sources (list): A list of strings indicating which power sources to plot.
+        voltage_y_max (float, optional): Maximum value for the voltage plot's Y-axis.
+        current_y_max (float, optional): Maximum value for the current plot's Y-axis.
+        power_y_max (float, optional): Maximum value for the power plot's Y-axis.
+        relative_time (bool): If True, the x-axis will show elapsed time from the start.
+        time_x_line (float, optional): Interval in seconds for x-axis grid lines.
+        time_x_label (float, optional): Interval in seconds for x-axis labels.
+        filter_type (str, optional): The type of filter to apply.
+        window_size (int, optional): The window size for the filter in seconds.
     """
     try:
         # Read the CSV file into a pandas DataFrame
-        # The 'timestamp' column is parsed as dates
         df = pd.read_csv(csv_path, parse_dates=['timestamp'])
         print(f"Successfully loaded {len(df)} records from '{csv_path}'")
+
+        if df.empty:
+            print("CSV file is empty. Exiting.")
+            return
+
+        # --- Time Handling ---
+        x_axis_data = df['timestamp']
+        if relative_time:
+            start_time = df['timestamp'].iloc[0]
+            df.loc[:, 'elapsed_seconds'] = (df['timestamp'] - start_time).dt.total_seconds()
+            x_axis_data = df['elapsed_seconds']
+            print("X-axis set to relative time (elapsed seconds).")
+        else:
+            # --- Timezone Conversion for absolute time ---
+            local_tz = gettz()
+            df.loc[:, 'timestamp'] = df['timestamp'].dt.tz_convert(local_tz)
+            print(f"Timestamp converted to local timezone: {local_tz}")
+
     except FileNotFoundError:
         print(f"Error: The file '{csv_path}' was not found.")
         return
@@ -27,57 +61,211 @@ def plot_power_data(csv_path, output_path, plot_types):
         print(f"An error occurred while reading the CSV file: {e}")
         return
 
+    # --- Calculate Average Interval ---
+    avg_interval_s = 0
+    if len(df) > 1:
+        avg_interval = df['timestamp'].diff().mean()
+        avg_interval_s = avg_interval.total_seconds()
+        avg_interval_ms = avg_interval_s * 1000
+
+    # --- Auto-set window size if not provided ---
+    if filter_type and window_size is None and avg_interval_s > 0:
+        window_size = avg_interval_s * 15  # Default to 15x the average interval
+        print(f"Window size not specified. Automatically set to {window_size:.2f} seconds.")
+
+
+    # --- Calculate Average Voltages ---
+    avg_voltages = {}
+    for source in sources:
+        voltage_col = f'{source}_voltage'
+        if voltage_col in df.columns:
+            avg_voltages[source] = df[voltage_col].mean()
+
     # --- Plotting Configuration ---
-    plot_configs = {
-        'power': {'title': 'Power Consumption', 'ylabel': 'Power (W)',
-                  'cols': ['vin_power', 'main_power', 'usb_power']},
-        'voltage': {'title': 'Voltage', 'ylabel': 'Voltage (V)',
-                    'cols': ['vin_voltage', 'main_voltage', 'usb_voltage']},
-        'current': {'title': 'Current', 'ylabel': 'Current (A)', 'cols': ['vin_current', 'main_current', 'usb_current']}
+    scale_config = {
+        'power': {'steps': [5, 7, 10, 20, 50, 160]},
+        'voltage': {'steps': [5, 7, 10, 15, 20, 25]},
+        'current': {'steps': [1, 2.5, 5, 7.5, 10]}
     }
-    channel_labels = ['VIN', 'MAIN', 'USB']
-    channel_colors = ['red', 'green', 'blue']
+    plot_configs = {
+        'power': {'title': 'Power Consumption', 'ylabel': 'Power (W)', 'cols': [f'{s}_power' for s in sources]},
+        'voltage': {'title': 'Voltage', 'ylabel': 'Voltage (V)', 'cols': [f'{s}_voltage' for s in sources]},
+        'current': {'title': 'Current', 'ylabel': 'Current (A)', 'cols': [f'{s}_current' for s in sources]}
+    }
+    y_max_options = {
+        'power': power_y_max,
+        'voltage': voltage_y_max,
+        'current': current_y_max
+    }
+
+    channel_labels = [s.upper() for s in sources]
+    color_map = {'vin': 'red', 'main': 'green', 'usb': 'blue'}
+    channel_colors = [color_map[s] for s in sources]
 
     num_plots = len(plot_types)
     if num_plots == 0:
         print("No plot types selected. Exiting.")
         return
 
-    # Create a figure and a set of subplots based on the number of selected plot types.
-    # sharex=True makes all subplots share the same x-axis (time)
-    # squeeze=False ensures that 'axes' is always a 2D array, even if num_plots is 1.
-    fig, axes = plt.subplots(num_plots, 1, figsize=(15, 6 * num_plots), sharex=True, squeeze=False)
-    axes = axes.flatten()  # Flatten the 2D array to 1D for easier iteration
+    fig, axes = plt.subplots(num_plots, 1, figsize=(15, 9 * num_plots), sharex=True, squeeze=False)
+    axes = axes.flatten()
 
     # --- Loop through selected plot types and generate plots ---
     for i, plot_type in enumerate(plot_types):
         ax = axes[i]
         config = plot_configs[plot_type]
-
+        max_data_value = 0
         for j, col_name in enumerate(config['cols']):
-            ax.plot(df['timestamp'], df[col_name], label=channel_labels[j], color=channel_colors[j])
+            if col_name in df.columns:
+                max_col_value = df[col_name].max()
+                if max_col_value > max_data_value:
+                    max_data_value = max_col_value
+
+                # --- Apply and plot filtered data ---
+                if filter_type and window_size:
+                    # Plot original data (lightly)
+                    ax.plot(x_axis_data, df[col_name], label=f'{channel_labels[j]} (Raw)', color=channel_colors[j], alpha=0.5, zorder=2)
+
+                    # Calculate window size in samples
+                    if avg_interval_s > 0:
+                        window_samples = int(window_size / avg_interval_s)
+                        if window_samples < 1:
+                            window_samples = 1
+                        
+                        filtered_data = None
+                        filter_label = ""
+
+                        if filter_type == 'savgol':
+                            if window_samples % 2 == 0:
+                                window_samples += 1
+                            if window_samples > 2:
+                                filtered_data = savgol_filter(df[col_name], window_samples, 2)
+                                filter_label = "Savitzky-Golay"
+                        elif filter_type == 'moving_average':
+                            filtered_data = df[col_name].rolling(window=window_samples, center=True).mean()
+                            filter_label = "Moving Average"
+                        elif filter_type == 'ema':
+                            filtered_data = df[col_name].ewm(span=window_samples, adjust=False).mean()
+                            filter_label = "Exponential Moving Average"
+                        elif filter_type == 'gaussian':
+                            sigma = window_samples / 4.0
+                            filtered_data = gaussian_filter1d(df[col_name], sigma=sigma)
+                            filter_label = "Gaussian"
+
+                        if filtered_data is not None:
+                             ax.plot(x_axis_data, filtered_data, label=f'{channel_labels[j]} ({filter_label})', color=channel_colors[j], linestyle='-', linewidth=1.5, zorder=3)
+                else:
+                    # No filter, plot original data (boldly)
+                    ax.plot(x_axis_data, df[col_name], label=channel_labels[j], color=channel_colors[j], linewidth=1.5, zorder=2)
+
+            else:
+                print(f"Warning: Column '{col_name}' not found in CSV. Skipping.")
+
+        # --- Dynamic Y-axis Scaling ---
+        ax.set_ylim(bottom=0)
+        y_max_option = y_max_options.get(plot_type)
+        if y_max_option is not None:
+            ax.set_ylim(top=y_max_option)
+        elif plot_type in scale_config:
+            steps = scale_config[plot_type]['steps']
+            new_max = next((step for step in steps if step >= max_data_value), steps[-1])
+            ax.set_ylim(top=new_max)
 
         ax.set_title(config['title'])
         ax.set_ylabel(config['ylabel'])
         ax.legend()
-        ax.grid(True, which='both', linestyle='--', linewidth=0.5)
 
-    # --- Formatting the x-axis (Time) ---
-    # Improve date formatting on the x-axis
-    # Apply formatting to the last subplot's x-axis
+        # --- Y-Grid and Tick Configuration ---
+        y_min, y_max = ax.get_ylim()
+        
+        if y_max <= 0:
+            major_interval = 1.0 # Default for very small or zero range
+        elif plot_type == 'current' and y_max <= 2.5:
+            major_interval = 0.5 # Maintain current behavior for very small current values
+        elif y_max <= 10:
+            major_interval = 2.0 # Maintain current behavior for small ranges where 5-unit is too coarse
+        elif y_max <= 25:
+            major_interval = 5.0 # Already a multiple of 5
+        else: # y_max > 25
+            # Aim for major ticks that are multiples of 5.
+            # Calculate a rough interval to get around 5 major ticks.
+            rough_interval = y_max / 5.0
+            
+            # Find the smallest multiple of 5 that is greater than or equal to rough_interval.
+            # This ensures labels are multiples of 5.
+            major_interval = math.ceil(rough_interval / 5.0) * 5.0
+            
+            # Ensure major_interval is not 0 if y_max is small but positive.
+            if major_interval == 0 and y_max > 0:
+                major_interval = 5.0
+
+        ax.yaxis.set_major_locator(MultipleLocator(major_interval))
+        ax.yaxis.set_minor_locator(MultipleLocator(1))
+        ax.yaxis.grid(False, which='major')
+        ax.yaxis.grid(True, which='minor', linestyle='--', linewidth=0.6, zorder=0)
+
+        for y_val in range(int(y_min), int(y_max) + 1):
+            if y_val == 0: continue
+            if y_val % 10 == 0:
+                ax.axhline(y=y_val, color='maroon', linestyle='--', linewidth=1.2, zorder=1)
+            elif y_val % 5 == 0:
+                ax.axhline(y=y_val, color='midnightblue', linestyle='--', linewidth=1.2, zorder=1)
+
+        # --- X-Grid Configuration ---
+        ax.xaxis.grid(True, which='major', linestyle='--', linewidth=0.8)
+        if time_x_line is not None:
+            ax.xaxis.grid(True, which='minor', linestyle=':', linewidth=0.6)
+
+
+    # --- Formatting the x-axis ---
     last_ax = axes[-1]
-    last_ax.xaxis.set_major_formatter(mdates.DateFormatter('%H:%M:%S'))
-    last_ax.xaxis.set_major_locator(plt.MaxNLocator(15))  # Limit the number of ticks
-    plt.xlabel('Time')
+    if not df.empty:
+        last_ax.set_xlim(x_axis_data.iloc[0], x_axis_data.iloc[-1])
+
+    if relative_time:
+        plt.xlabel('Elapsed Time (seconds)')
+        if time_x_label is not None:
+            last_ax.xaxis.set_major_locator(MultipleLocator(time_x_label))
+        else:
+            last_ax.xaxis.set_major_locator(plt.MaxNLocator(15))
+        if time_x_line is not None:
+            last_ax.xaxis.set_minor_locator(MultipleLocator(time_x_line))
+    else:
+        local_tz = gettz()
+        plt.xlabel(f'Time ({local_tz.tzname(df["timestamp"].iloc[-1])})')
+        last_ax.xaxis.set_major_formatter(mdates.DateFormatter('%H:%M:%S', tz=local_tz))
+        if time_x_label is not None:
+            last_ax.xaxis.set_major_locator(mdates.SecondLocator(interval=int(time_x_label)))
+        else:
+            last_ax.xaxis.set_major_locator(plt.MaxNLocator(15))
+        if time_x_line is not None:
+            last_ax.xaxis.set_minor_locator(mdates.SecondLocator(interval=int(time_x_line)))
+
     plt.xticks(rotation=45)
 
-    # Add a main title to the figure
-    start_time = df['timestamp'].iloc[0].strftime('%Y-%m-%d %H:%M:%S')
-    end_time = df['timestamp'].iloc[-1].strftime('%H:%M:%S')
-    fig.suptitle(f'ODROID Power Log ({start_time} to {end_time})', fontsize=16, y=0.95)
+    # --- Add a main title and subtitle ---
+    if relative_time:
+        main_title = 'PowerMate Log'
+    else:
+        start_time_str = df['timestamp'].iloc[0].strftime('%Y-%m-%d %H:%M:%S')
+        end_time_str = df['timestamp'].iloc[-1].strftime('%H:%M:%S')
+        main_title = f'PowerMate Log ({start_time_str} to {end_time_str})'
 
-    # Adjust layout to prevent titles/labels from overlapping
-    plt.tight_layout(rect=[0, 0, 1, 0.94])
+
+    subtitle_parts = []
+    if avg_interval_ms > 0:
+        subtitle_parts.append(f'Avg. Interval: {avg_interval_ms:.2f} ms')
+    voltage_strings = [f'{source.upper()} Avg: {avg_v:.2f} V' for source, avg_v in avg_voltages.items()]
+    if voltage_strings:
+        subtitle_parts.extend(voltage_strings)
+    subtitle = ' | '.join(subtitle_parts)
+
+    full_title = main_title
+    if subtitle:
+        full_title += f'\n{subtitle}'
+    fig.suptitle(full_title, fontsize=14)
+
+    plt.tight_layout(rect=[0, 0, 1, 0.98])
 
     # --- Save the plot to a file ---
     try:
@@ -99,9 +287,52 @@ def main():
         help="Types of plots to generate. Choose from 'power', 'voltage', 'current'. "
              "Default is to generate all three."
     )
+    parser.add_argument(
+        "-s", "--source",
+        nargs='+',
+        choices=['vin', 'main', 'usb'],
+        default=['vin', 'main', 'usb'],
+        help="Power sources to plot. Choose from 'vin', 'main', 'usb'. "
+             "Default is to plot all three."
+    )
+    parser.add_argument("--voltage_y_max", type=float, help="Maximum value for the voltage plot's Y-axis.")
+    parser.add_argument("--current_y_max", type=float, help="Maximum value for the current plot's Y-axis.")
+    parser.add_argument("--power_y_max", type=float, help="Maximum value for the power plot's Y-axis.")
+    parser.add_argument(
+        "-r", "--relative-time",
+        action='store_true',
+        help="Display the x-axis as elapsed time from the start (in seconds) instead of absolute time."
+    )
+    parser.add_argument("--time_x_line", type=float, help="Interval in seconds for x-axis grid lines.")
+    parser.add_argument("--time_x_label", type=float, help="Interval in seconds for x-axis labels.")
+    parser.add_argument(
+        '--filter',
+        choices=['savgol', 'moving_average', 'ema', 'gaussian'],
+        help='The type of filter to apply to the data.'
+    )
+    parser.add_argument(
+        '--window_size',
+        type=float,
+        help='The window size for the filter in seconds.'
+    )
+
+
     args = parser.parse_args()
 
-    plot_power_data(args.input_csv, args.output_image, args.type)
+    plot_power_data(
+        args.input_csv,
+        args.output_image,
+        args.type,
+        args.source,
+        voltage_y_max=args.voltage_y_max,
+        current_y_max=args.current_y_max,
+        power_y_max=args.power_y_max,
+        relative_time=args.relative_time,
+        time_x_line=args.time_x_line,
+        time_x_label=args.time_x_label,
+        filter_type=args.filter,
+        window_size=args.window_size
+    )
 
 
 if __name__ == "__main__":

example/logger/logger.py

@@ -3,7 +3,10 @@ import asyncio
 import csv
 import requests
 import websockets
-from datetime import datetime
+import websockets.asyncio
+import websockets.asyncio.client
+import websockets.exceptions
+from datetime import datetime, timezone
 
 # Import the status_pb2.py file generated by `protoc`.
 # This file must be in the same directory as logger.py.
@@ -70,7 +73,7 @@ class OdroidPowerLogger:
 
                     # Write header
                     header = [
-                        'timestamp', 'uptime_sec',
+                        'timestamp', 'uptime_ms',
                         'vin_voltage', 'vin_current', 'vin_power',
                         'main_voltage', 'main_current', 'main_power',
                         'usb_voltage', 'usb_current', 'usb_power'
@@ -97,10 +100,10 @@ class OdroidPowerLogger:
                     # Process only if the payload type is 'sensor_data'
                     if status_message.WhichOneof('payload') == 'sensor_data':
                         sensor_data = status_message.sensor_data
-                        ts_dt = datetime.fromtimestamp(sensor_data.timestamp)
-                        ts_str = ts_dt.strftime('%Y-%m-%d %H:%M:%S')
+                        ts_dt = datetime.fromtimestamp(sensor_data.timestamp_ms / 1000, tz=timezone.utc)
+                        ts_str_print = ts_dt.strftime('%Y-%m-%d %H:%M:%S UTC')
 
-                        print(f"--- {ts_str} (Uptime: {sensor_data.uptime_sec}s) ---")
+                        print(f"--- {ts_str_print} (Uptime: {sensor_data.uptime_ms / 1000}s) ---")
 
                         # Print data for each channel
                         for name, channel in [('VIN', sensor_data.vin), ('MAIN', sensor_data.main),
@@ -110,11 +113,12 @@ class OdroidPowerLogger:
 
                         # Write to CSV if enabled
                         if csv_writer:
+                            ts_iso_csv = ts_dt.isoformat(timespec='milliseconds').replace('+00:00', 'Z')
                             row = [
-                                ts_dt.isoformat(), sensor_data.uptime_sec,
-                                sensor_data.vin.voltage, sensor_data.vin.current, sensor_data.vin.power,
-                                sensor_data.main.voltage, sensor_data.main.current, sensor_data.main.power,
-                                sensor_data.usb.voltage, sensor_data.usb.current, sensor_data.usb.power
+                                ts_iso_csv, sensor_data.uptime_ms,
+                                f"{sensor_data.vin.voltage:.3f}", f"{sensor_data.vin.current:.3f}", f"{sensor_data.vin.power:.3f}",
+                                f"{sensor_data.main.voltage:.3f}", f"{sensor_data.main.current:.3f}", f"{sensor_data.main.power:.3f}",
+                                f"{sensor_data.usb.voltage:.3f}", f"{sensor_data.usb.current:.3f}", f"{sensor_data.usb.power:.3f}"
                             ]
                             csv_writer.writerow(row)
 

main/include/nconfig.h

@@ -44,6 +44,7 @@ enum nconfig_type
     USB_CURRENT_LIMIT, ///< The maximum current limit for the USB out.
     PAGE_USERNAME, ///< Webpage username
     PAGE_PASSWORD, ///< Webpage password
+    SENSOR_PERIOD_MS, ///< Sensor period
     NCONFIG_TYPE_MAX,   ///< Sentinel for the maximum number of configuration types.
 };
 

main/nconfig/nconfig.c

@@ -30,6 +30,7 @@ const static char* keys[NCONFIG_TYPE_MAX] = {
     [USB_CURRENT_LIMIT] = "usb_climit",
     [PAGE_USERNAME] = "username",
     [PAGE_PASSWORD] = "password",
+    [SENSOR_PERIOD_MS] = "sensor_period",
 };
 
 struct default_value
@@ -54,6 +55,7 @@ struct default_value const default_values[] = {
     {USB_CURRENT_LIMIT, "3.0"},
     {PAGE_USERNAME, "admin"},
     {PAGE_PASSWORD, "password"},
+    {SENSOR_PERIOD_MS, "1000"},
 };
 
 esp_err_t init_nconfig()

main/proto/status.pb.h

@@ -25,8 +25,8 @@ typedef struct _SensorData {
     SensorChannelData main;
     bool has_vin;
     SensorChannelData vin;
-    uint32_t timestamp;
-    uint32_t uptime_sec;
+    uint64_t timestamp_ms;
+    uint64_t uptime_ms;
 } SensorData;
 
 /* Contains WiFi connection status */
@@ -85,8 +85,8 @@ extern "C" {
 #define SensorData_usb_tag                       1
 #define SensorData_main_tag                      2
 #define SensorData_vin_tag                       3
-#define SensorData_timestamp_tag                 4
-#define SensorData_uptime_sec_tag                5
+#define SensorData_timestamp_ms_tag              4
+#define SensorData_uptime_ms_tag                 5
 #define WifiStatus_connected_tag                 1
 #define WifiStatus_ssid_tag                      2
 #define WifiStatus_rssi_tag                      3
@@ -111,8 +111,8 @@ X(a, STATIC,   SINGULAR, FLOAT,    power,             3)
 X(a, STATIC,   OPTIONAL, MESSAGE,  usb,               1) \
 X(a, STATIC,   OPTIONAL, MESSAGE,  main,              2) \
 X(a, STATIC,   OPTIONAL, MESSAGE,  vin,               3) \
-X(a, STATIC,   SINGULAR, UINT32,   timestamp,         4) \
-X(a, STATIC,   SINGULAR, UINT32,   uptime_sec,        5)
+X(a, STATIC,   SINGULAR, UINT64,   timestamp_ms,      4) \
+X(a, STATIC,   SINGULAR, UINT64,   uptime_ms,         5)
 #define SensorData_CALLBACK NULL
 #define SensorData_DEFAULT NULL
 #define SensorData_usb_MSGTYPE SensorChannelData
@@ -172,7 +172,7 @@ extern const pb_msgdesc_t StatusMessage_msg;
 #define LoadSwStatus_size                        4
 #define STATUS_PB_H_MAX_SIZE                     SensorData_size
 #define SensorChannelData_size                   15
-#define SensorData_size                          63
+#define SensorData_size                          73
 
 #ifdef __cplusplus
 } /* extern "C" */

main/service/monitor.c

@@ -4,6 +4,7 @@
 
 #include "monitor.h"
 #include <nconfig.h>
+#include <sys/time.h>
 #include <time.h>
 #include "climit.h"
 #include "esp_log.h"
@@ -53,9 +54,9 @@ ina3221_t ina3221 = {
             .ch1 = true, // channel 1 enable
             .ch2 = true, // channel 2 enable
             .ch3 = true, // channel 3 enable
-            .avg = INA3221_AVG_64, // 64 samples average
-            .vbus = INA3221_CT_2116, // 2ms by channel (bus)
-            .vsht = INA3221_CT_2116, // 2ms by channel (shunt)
+            .avg = INA3221_AVG_16, // 16 samples average
+            .vbus = INA3221_CT_140, // 140us by channel (bus)
+            .vsht = INA3221_CT_1100, // 1.1ms by channel (shunt)
         },
 };
 
@@ -89,9 +90,10 @@ static void send_pb_message(const pb_msgdesc_t* fields, const void* src_struct)
 
 static void sensor_timer_callback(void* arg)
 {
-    int64_t uptime_us = esp_timer_get_time();
-    uint32_t uptime_sec = (uint32_t)(uptime_us / 1000000);
-    uint32_t timestamp = (uint32_t)time(NULL);
+    struct timeval tv;
+    gettimeofday(&tv, NULL);
+    uint64_t timestamp_ms = (uint64_t)tv.tv_sec * 1000 + (uint64_t)tv.tv_usec / 1000;
+    uint64_t uptime_ms = (uint64_t)esp_timer_get_time() / 1000;
 
     StatusMessage message = StatusMessage_init_zero;
     message.which_payload = StatusMessage_sensor_data_tag;
@@ -120,8 +122,8 @@ static void sensor_timer_callback(void* arg)
 
     // datalog_add(timestamp, channel_data_log);
 
-    sensor_data->timestamp = timestamp;
-    sensor_data->uptime_sec = uptime_sec;
+    sensor_data->timestamp_ms = timestamp_ms;
+    sensor_data->uptime_ms = uptime_ms;
 
     send_pb_message(StatusMessage_fields, &message);
 }
@@ -289,6 +291,25 @@ void init_status_monitor()
     xTaskCreate(shutdown_load_sw_task, "shutdown_sw_task", configMINIMAL_STACK_SIZE * 3, NULL, 15,
                 &shutdown_task_handle);
 
-    ESP_ERROR_CHECK(esp_timer_start_periodic(sensor_timer, 1000000));
+    nconfig_read(SENSOR_PERIOD_MS, buf, sizeof(buf));
+    ESP_ERROR_CHECK(esp_timer_start_periodic(sensor_timer, strtol(buf, NULL, 10) * 1000));
     ESP_ERROR_CHECK(esp_timer_start_periodic(wifi_status_timer, 1000000 * 5));
 }
+
+esp_err_t update_sensor_period(int period)
+{
+    if (period < 100 || period > 10000) // 0.1 sec ~ 10 sec
+    {
+        return ESP_ERR_INVALID_ARG;
+    }
+
+    char buf[10];
+    sprintf(buf, "%d", period);
+    esp_err_t err = nconfig_write(SENSOR_PERIOD_MS, buf);
+    if (err != ESP_OK) {
+        return err;
+    }
+
+    esp_timer_stop(sensor_timer);
+    return esp_timer_start_periodic(sensor_timer, period * 1000);
+}

main/service/monitor.h

@@ -20,5 +20,6 @@ typedef struct
 } sensor_data_t;
 
 void init_status_monitor();
+esp_err_t update_sensor_period(int period);
 
 #endif // ODROID_REMOTE_HTTP_MONITOR_H

main/service/setting.c

@@ -6,6 +6,7 @@
 #include "esp_log.h"
 #include "esp_netif.h"
 #include "esp_timer.h"
+#include "monitor.h"
 #include "nconfig.h"
 #include "webserver.h"
 #include "wifi.h"
@@ -47,6 +48,11 @@ static esp_err_t setting_get_handler(httpd_req_t* req)
         cJSON_AddStringToObject(root, "baudrate", buf);
     }
 
+    if (nconfig_read(SENSOR_PERIOD_MS, buf, sizeof(buf)) == ESP_OK)
+    {
+        cJSON_AddStringToObject(root, "period", buf);
+    }
+
     // Add current limits to the response
     if (nconfig_read(VIN_CURRENT_LIMIT, buf, sizeof(buf)) == ESP_OK)
     {
@@ -174,6 +180,7 @@ static esp_err_t setting_post_handler(httpd_req_t* req)
     cJSON* net_type_item = cJSON_GetObjectItem(root, "net_type");
     cJSON* ssid_item = cJSON_GetObjectItem(root, "ssid");
     cJSON* baud_item = cJSON_GetObjectItem(root, "baudrate");
+    cJSON* period_item = cJSON_GetObjectItem(root, "period");
     cJSON* vin_climit_item = cJSON_GetObjectItem(root, "vin_current_limit");
     cJSON* main_climit_item = cJSON_GetObjectItem(root, "main_current_limit");
     cJSON* usb_climit_item = cJSON_GetObjectItem(root, "usb_current_limit");
@@ -289,6 +296,13 @@ static esp_err_t setting_post_handler(httpd_req_t* req)
         change_baud_rate(strtol(baudrate, NULL, 10));
         httpd_resp_sendstr(req, "{\"status\":\"baudrate_updated\"}");
     }
+    else if (period_item && cJSON_IsString(period_item))
+    {
+        const char* period_str = period_item->valuestring;
+        ESP_LOGI(TAG, "Received period set request: %s", period_str);
+        update_sensor_period(strtol(period_str, NULL, 10));
+        httpd_resp_sendstr(req, "{\"status\":\"period_updated\"}");
+    }
     else if (vin_climit_item || main_climit_item || usb_climit_item)
     {
         char num_buf[10];

page/index.html

@@ -141,8 +141,9 @@
             <div class="card border-top-0 rounded-0 rounded-bottom">
                 <div class="card-body">
                     <div class="d-flex justify-content-end mb-3">
-                        <a class="btn btn-primary" download="datalog.csv" href="/datalog.csv" style="display: none"><i
-                                class="bi bi-download me-1"></i> Download CSV</a>
+                        <button id="record-button" class="btn btn-success me-2"><i class="bi bi-record-circle me-1"></i>Record</button>
+                        <button id="stop-button" class="btn btn-danger me-2" style="display: none;"><i class="bi bi-stop-circle me-1"></i>Stop</button>
+                        <button id="download-csv-button" class="btn btn-primary" style="display: none;"><i class="bi bi-download me-1"></i>Download CSV</button>
                     </div>
                     <h5 class="card-title text-center mb-3">Power Metrics</h5>
                     <div class="row">
@@ -359,7 +360,7 @@
                         </form>
                     </div>
                     <div class="tab-pane fade" id="device-settings-pane" role="tabpanel">
-                        <div class="mb-3">
+                        <div class="mb-3 p-3 border rounded">
                             <label for="baud-rate-select" class="form-label">UART Baud Rate</label>
                             <select class="form-select" id="baud-rate-select">
                                 <option value="9600">9600</option>
@@ -372,6 +373,16 @@
                                 <option value="921600">921600</option>
                                 <option value="1500000" selected>1500000</option>
                             </select>
+                            <div class="d-flex justify-content-end mt-2">
+                                <button type="button" class="btn btn-primary btn-sm" id="baud-rate-apply-button">Apply</button>
+                            </div>
+                        </div>
+                        <div class="mb-3 p-3 border rounded">
+                            <label for="period-slider" class="form-label">Sensor Period: <span class="fw-bold text-primary" id="period-value">...</span> ms</label>
+                            <input type="range" class="form-range" id="period-slider" min="100" max="5000" step="100">
+                            <div class="d-flex justify-content-end mt-2">
+                                <button type="button" class="btn btn-primary btn-sm" id="period-apply-button">Apply</button>
+                            </div>
                         </div>
                         <hr>
                         <div class="mb-3">
@@ -380,7 +391,6 @@
                             <button type="button" class="btn btn-danger" id="reboot-button">Reboot Now</button>
                         </div>
                         <div class="d-flex justify-content-end pt-3 border-top mt-3">
-                            <button type="button" class="btn btn-primary me-2" id="baud-rate-apply-button">Apply</button>
                             <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
                         </div>
                     </div>

page/src/api.js

@@ -104,7 +104,6 @@ export async function postNetworkSettings(payload) {
  * Posts the selected UART baud rate to the server.
  * @param {string} baudrate The selected baud rate.
  * @returns {Promise<Response>} A promise that resolves to the raw fetch response.
- * @throws {Error} Throws an error if the request fails.
  */
 export async function postBaudRateSetting(baudrate) {
     const response = await fetch('/api/setting', {
@@ -113,7 +112,24 @@ export async function postBaudRateSetting(baudrate) {
             'Content-Type': 'application/json',
             ...getAuthHeaders(),
         },
-        body: JSON.stringify({baudrate}),
+        body: JSON.stringify({ baudrate }),
+    });
+    return await handleResponse(response);
+}
+
+/**
+ * Posts the selected sensor period to the server.
+ * @param {string} period The selected period in milliseconds.
+ * @returns {Promise<Response>} A promise that resolves to the raw fetch response.
+ */
+export async function postPeriodSetting(period) {
+    const response = await fetch('/api/setting', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...getAuthHeaders(),
+        },
+        body: JSON.stringify({ period }),
     });
     return await handleResponse(response);
 }

page/src/chart.js

@@ -216,7 +216,7 @@ function updateSingleChart(chart, metric, data, timeLabel) {
  * @param {Object} data - The new sensor data object from the WebSocket.
  */
 export function updateCharts(data) {
-    const timeLabel = new Date(data.timestamp * 1000).toLocaleTimeString();
+    const timeLabel = new Date(data.timestamp).toLocaleTimeString();
 
     updateSingleChart(charts.power, 'power', data, timeLabel);
     updateSingleChart(charts.voltage, 'voltage', data, timeLabel);

page/src/dom.js

@@ -76,6 +76,9 @@ export const apPasswordInput = document.getElementById('ap-password');
 // --- Device Settings Elements ---
 export const baudRateSelect = document.getElementById('baud-rate-select');
 export const baudRateApplyButton = document.getElementById('baud-rate-apply-button');
+export const periodSlider = document.getElementById('period-slider');
+export const periodValue = document.getElementById('period-value');
+export const periodApplyButton = document.getElementById('period-apply-button');
 export const rebootButton = document.getElementById('reboot-button');
 
 // --- Current Limit Settings Elements ---

page/src/events.js

@@ -77,8 +77,9 @@ export function setupEventListeners() {
     dom.networkApplyButton.addEventListener('click', ui.applyNetworkSettings);
     dom.apModeApplyButton.addEventListener('click', ui.applyApModeSettings);
     dom.baudRateApplyButton.addEventListener('click', ui.applyBaudRateSettings);
+    dom.periodApplyButton.addEventListener('click', ui.applyPeriodSettings);
 
-    // --- Device Settings (Reboot) ---
+    // --- Device Settings (Reboot & Period Slider) ---
     if (dom.rebootButton) {
         dom.rebootButton.addEventListener('click', () => {
             if (confirm('Are you sure you want to reboot the device?')) {
@@ -101,6 +102,12 @@ export function setupEventListeners() {
         });
     }
 
+    if (dom.periodSlider) {
+        dom.periodSlider.addEventListener('input', () => {
+            dom.periodValue.textContent = dom.periodSlider.value;
+        });
+    }
+
     // --- Current Limit Settings ---
     dom.vinSlider.addEventListener('input', () => updateSliderValue(dom.vinSlider, dom.vinValueSpan));
     dom.mainSlider.addEventListener('input', () => updateSliderValue(dom.mainSlider, dom.mainValueSpan));

page/src/main.js

@@ -30,6 +30,8 @@ import {setupEventListeners} from './events.js';
 
 // --- Globals ---
 // StatusMessage is imported directly from the generated proto.js file.
+let isRecording = false;
+let recordedData = [];
 
 // --- DOM Elements ---
 const loginContainer = document.getElementById('login-container');
@@ -50,6 +52,11 @@ const newUsernameInput = document.getElementById('new-username');
 const newPasswordInput = document.getElementById('new-password');
 const confirmPasswordInput = document.getElementById('confirm-password');
 
+// Metrics Tab DOM Elements
+const recordButton = document.getElementById('record-button');
+const stopButton = document.getElementById('stop-button');
+const downloadCsvButton = document.getElementById('download-csv-button');
+
 
 // --- WebSocket Event Handlers ---
 
@@ -88,13 +95,18 @@ function onWsMessage(event) {
                         USB: sensorData.usb,
                         MAIN: sensorData.main,
                         VIN: sensorData.vin,
-                        timestamp: sensorData.timestamp
+                        timestamp: sensorData.timestampMs,
+                        uptime: sensorData.uptimeMs
                     };
                     updateSensorUI(sensorPayload);
 
+                    if (isRecording) {
+                        recordedData.push(sensorPayload);
+                    }
+
                     // Update uptime separately from the sensor data payload
-                    if (sensorData.uptimeSec !== undefined) {
-                        updateUptimeUI(sensorData.uptimeSec);
+                    if (sensorData.uptimeMs !== undefined) {
+                        updateUptimeUI(sensorData.uptimeMs / 1000);
                     }
                 }
                 break;
@@ -233,6 +245,70 @@ function setupThemeToggles() {
     });
 }
 
+// --- Recording and Downloading Functions ---
+
+function startRecording() {
+    isRecording = true;
+    recordedData = [];
+    recordButton.style.display = 'none';
+    stopButton.style.display = 'inline-block';
+    downloadCsvButton.style.display = 'none';
+    console.log('Recording started.');
+}
+
+function stopRecording() {
+    isRecording = false;
+    recordButton.style.display = 'inline-block';
+    stopButton.style.display = 'none';
+    if (recordedData.length > 0) {
+        downloadCsvButton.style.display = 'inline-block';
+    }
+    console.log('Recording stopped. Data points captured:', recordedData.length);
+}
+
+function downloadCSV() {
+    if (recordedData.length === 0) {
+        alert('No data to download.');
+        return;
+    }
+
+    const headers = [
+        'timestamp', 'uptime_ms',
+        'vin_voltage', 'vin_current', 'vin_power',
+        'main_voltage', 'main_current', 'main_power',
+        'usb_voltage', 'usb_current', 'usb_power'
+    ];
+    const csvRows = [headers.join(',')];
+
+    recordedData.forEach(data => {
+        const timestamp = new Date(data.timestamp).toISOString();
+        const row = [
+            timestamp,
+            data.uptime,
+            Number(data.VIN.voltage).toFixed(3), Number(data.VIN.current).toFixed(3), Number(data.VIN.power).toFixed(3),
+            Number(data.MAIN.voltage).toFixed(3), Number(data.MAIN.current).toFixed(3), Number(data.MAIN.power).toFixed(3),
+            Number(data.USB.voltage).toFixed(3), Number(data.USB.current).toFixed(3), Number(data.USB.power).toFixed(3)
+        ];
+        csvRows.push(row.join(','));
+    });
+
+    const blob = new Blob([csvRows.join('\n')], { type: 'text/csv;charset=utf-8;' });
+    const link = document.createElement('a');
+    const url = URL.createObjectURL(blob);
+    
+    const now = new Date();
+    const pad = (num) => num.toString().padStart(2, '0');
+    const datePart = `${now.getFullYear().toString().slice(-2)}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+    const timePart = `${pad(now.getHours())}-${pad(now.getMinutes())}`;
+    const filename = `powermate_${datePart}_${timePart}.csv`;
+
+    link.setAttribute('href', url);
+    link.setAttribute('download', filename);
+    link.style.visibility = 'hidden';
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+}
 
 // --- Application Initialization ---
 
@@ -263,6 +339,12 @@ function initializeMainAppContent() {
     initializeVersion();
     setupEventListeners(); // Attach main app event listeners
     logoutButton.addEventListener('click', handleLogout); // Attach logout listener
+    
+    // Attach listeners for recording/downloading
+    recordButton.addEventListener('click', startRecording);
+    stopButton.addEventListener('click', stopRecording);
+    downloadCsvButton.addEventListener('click', downloadCSV);
+
     connect();
 
     // Attach user settings form listener

page/src/ui.js

@@ -301,6 +301,24 @@ export async function applyBaudRateSettings() {
     }
 }
 
+/**
+ * Applies the selected sensor period by sending it to the server.
+ */
+export async function applyPeriodSettings() {
+    const period = dom.periodSlider.value;
+    dom.periodApplyButton.disabled = true;
+    dom.periodApplyButton.innerHTML = `<span class="spinner-border spinner-border-sm" aria-hidden="true"></span> Applying...`;
+
+    try {
+        await api.postPeriodSetting(period);
+    } catch (error) {
+        console.error('Error applying period:', error);
+    } finally {
+        dom.periodApplyButton.disabled = false;
+        dom.periodApplyButton.innerHTML = 'Apply';
+    }
+}
+
 /**
  * Fetches and displays the current network and device settings in the settings modal.
  */
@@ -338,6 +356,10 @@ export async function initializeSettings() {
         if (data.baudrate) {
             dom.baudRateSelect.value = data.baudrate;
         }
+        if (data.period) {
+            dom.periodSlider.value = data.period;
+            dom.periodValue.textContent = data.period;
+        }
 
     } catch (error) {
         console.error('Error initializing settings:', error);

page/src/utils.js

@@ -25,6 +25,7 @@ export function debounce(func, delay) {
  * @returns {string} The formatted uptime string.
  */
 export function formatUptime(totalSeconds) {
+    totalSeconds = Math.floor(totalSeconds);
     const days = Math.floor(totalSeconds / 86400);
     const hours = Math.floor((totalSeconds % 86400) / 3600);
     const minutes = Math.floor((totalSeconds % 3600) / 60);

proto/status.proto

@@ -12,8 +12,8 @@ message SensorData {
   SensorChannelData usb = 1;
   SensorChannelData main = 2;
   SensorChannelData vin = 3;
-  uint32 timestamp = 4;
-  uint32 uptime_sec = 5;
+  uint64 timestamp_ms = 4;
+  uint64 uptime_ms = 5;
 }
 
 // Contains WiFi connection status