Enhance logging functionality across multiple scripts, enabling debug mode checks and detailed communication logs for serial connections and firmware updates.

2025-11-14 16:38:05 +01:00
parent bd27bab30f
commit 04b9814c07
6 changed files with 214 additions and 19 deletions
--- a/assets/scripts.js
+++ b/assets/scripts.js
@@ -1,5 +1,58 @@
 const serialResultsDiv = document.getElementById("serialResults");

+// Buffer for accumulating received data before logging
+let receivedDataBuffer = '';
+
+// Function to log communication to API
+async function logCommunication(data, direction) {
+    // Only log if debug mode is enabled
+    if (typeof DEBUG === 'undefined' || !DEBUG) {
+        return;
+    }
+    
+    // Log all communication including connection/disconnection events
+    try {
+        // Get service token for API authentication
+        const serviceToken = document.getElementById("servicetoken")?.innerHTML || '';
+
+        // Get serial number if available
+        let serialNumber = '';
+        if (typeof serial !== 'undefined' && serial) {
+            serialNumber = serial;
+        }
+
+        const logData = {
+            data: data,
+            direction: direction, // 'sent', 'received', 'connected', 'disconnected', 'handshake'
+            timestamp: new Date().toISOString(),
+            serial_number: serialNumber,
+            maintenance_run: 0 // Not used in scripts.js, set to 0
+        };
+
+        // Get base URL for API calls (assuming 'link' variable is defined globally)
+        const url = link + '/v2/com_log/log';
+
+        const bearer = 'Bearer ' + serviceToken;
+
+        const response = await fetch(url, {
+            method: 'POST',
+            withCredentials: true,
+            credentials: 'include',
+            headers: {
+                'Authorization': bearer,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(logData)
+        });
+
+        if (!response.ok) {
+            console.warn('Failed to log communication:', response.status);
+        }
+    } catch (error) {
+        console.warn('Error logging communication:', error);
+    }
+}
+
 function progressBar(percentage, message, color){
    var readbar = document.getElementById("readBar");
    readBar.style.background = color;
@@ -7,16 +60,13 @@ function progressBar(percentage, message, color){
    readBar.innerHTML = message;
 }

-async function getServiceID(){
-    var data = document.getElementById("servicetoken").innerHTML;
-    return data
-}
-
 async function connectDevice() {

        //clear input
        readBar.innerHTML = '';
        serialResultsDiv.innerHTML = '';
+        // Reset received data buffer for new connection
+        receivedDataBuffer = '';

        //set prgress bar
        progressBar("1", "", "");
@@ -25,17 +75,45 @@ async function connectDevice() {
        // Prompt user to select any serial port.
        const filters = [{ usbVendorId: 1027, usbProductId: 24597 }];
        port = await navigator.serial.requestPort({ filters });
+        
+        // Log selected port details
+        const portInfo = port.getInfo();
+        const portDetails = {
+            processStep: 'Firmware',
+            usbVendorId: portInfo.usbVendorId,
+            usbProductId: portInfo.usbProductId,
+            readable: !!port.readable,
+            writable: !!port.writable,
+            opened: port.readable !== null && port.writable !== null
+        };
+        await logCommunication(`Selected USB device - ${JSON.stringify(portDetails)}`, 'connected');
+        
        await port.open({ baudRate: 56700 });
        progressBar("10", "Connecting", "#04AA6D");

+        // Log successful connection with details
+        const portInfoSuccess = port.getInfo();
+        const portDetailsSuccess = {
+            processStep: 'Firmware',
+            usbVendorId: portInfoSuccess.usbVendorId,
+            usbProductId: portInfoSuccess.usbProductId,
+            readable: !!port.readable,
+            writable: !!port.writable,
+            opened: port.readable !== null && port.writable !== null
+        };
+        await logCommunication(`Serial port opened successfully (baudRate: 56700) - ${JSON.stringify(portDetailsSuccess)}`, 'connected');
+
        listenToPort();

        textEncoder = new TextEncoderStream();
        writableStreamClosed = textEncoder.readable.pipeTo(port.writable);

        writer = textEncoder.writable.getWriter();
-    } catch {
-      if (openPort = 1){
+    } catch (error) {
+        // Log connection failure details
+        await logCommunication(`Serial connection failed: ${error.message || 'Unknown error'}`, 'disconnected');
+        
+        if (openPort = 1){
          closePort();
          console.log("Closing port");
          alert("System is still trying to close the serial port. If this message continues to come up please refresh this page.");
@@ -52,6 +130,9 @@ async function listenToPort() {
    reader = textDecoder.readable.getReader();
    openPort = 1;

+    // Log starting to listen to port
+    await logCommunication('Starting to listen to serial port', 'connected');
+
    while (true) {
        const { value, done } = await reader.read();
        if (done) {
@@ -67,6 +148,10 @@ async function listenToPort() {
        if (x.indexOf("SN=") > 0 && x.indexOf("HW=") > 0 && x.indexOf("FW=") >0 && x.indexOf("STATE=") > 0)
        {
          progressBar("60", "Reading device completed", "#04AA6D");
+          // Log combined received data when device identification is complete
+          await logCommunication(`Device identification data received: ${receivedDataBuffer.trim()}`, 'handshake');
+          // Reset buffer for next connection
+          receivedDataBuffer = '';
          setTimeout(getDeviceData, 4000);
          return;
        }
@@ -76,8 +161,15 @@ async function listenToPort() {

 async function appendToTerminal(newStuff) {
    serialResultsDiv.innerHTML += newStuff;
+
+    // Log received data
+    await logCommunication(newStuff.trim(), 'received');
 }

+async function getServiceID(){
+    var data = document.getElementById("servicetoken").innerHTML;
+    return data
+}

 async function getDeviceData(){
  var item = serialResultsDiv.innerHTML;
@@ -91,6 +183,8 @@ async function getDeviceData(){
    serial = x.substring(b,c);
    progressBar("65", "Retrieving device data", "#04AA6D");
    console.log(serial);
+    // Log serial number retrieval
+    await logCommunication(`Serial number retrieved: ${serial}`, 'handshake');
  
    if (x.indexOf("FW=") > 0){
      var a = x.indexOf("FW=");
@@ -98,6 +192,8 @@ async function getDeviceData(){
      var c = b + 8;
      fw = x.substring(b,c);
      fw = fw.replace(/^0+/, '');
+      // Log firmware version
+      await logCommunication(`Firmware version retrieved: ${fw}`, 'handshake');
    }

    //Check if HW is retrieved from device
@@ -121,6 +217,8 @@ async function getDeviceData(){

    //GET THE COMMITCODE
    commitCode = compareCommitCodes("",fw);
+    // Log hardware version and commit code
+    await logCommunication(`Hardware version retrieved: ${hw}, Commit code: ${commitCode}`, 'handshake');
        
    getServiceID().then(firmwareUpdate);
    progressBar("80", "checking for available firmware", "#04AA6D");
@@ -129,9 +227,12 @@ async function getDeviceData(){
    else {
      progressBar("80", "Reading of device not successful, please try again", "#ff6666");
      console.log('Reading of device not successful');
+      // Log failure to read device data
+      await logCommunication('Failed to retrieve complete device data (HW and FW)', 'disconnected');
    } 
  }
 }
+
 function firmwareUpdate(data){

    var serialnumber = serial;
@@ -140,6 +241,9 @@ function firmwareUpdate(data){
  
    var bearer = 'Bearer ' + data;
  
+    // Log firmware update request
+    logCommunication(`Requesting firmware update for SN: ${serialnumber}, Version: ${commitCode}, HW: ${hw}`, 'sent');
+
    fetch(url, {
            method: 'GET',
            withCredentials: true,
@@ -153,11 +257,15 @@ function firmwareUpdate(data){
        .then(firmware=> {
                firmwarelocation = './firmware/'+firmware['software'];
                upgraded_version = firmware['version'];
+                // Log firmware response
+                logCommunication(`Firmware update response: ${firmware['software']}, Version: ${firmware['version']}`, 'received');
                return firmwarelocation;
                    })
  
            .catch(error => {
             console.log(error)
+             // Log firmware fetch error
+             logCommunication(`Firmware update fetch error: ${error.message}`, 'disconnected');
            })
  
  
@@ -210,6 +318,8 @@ function checkAvailableFirmware(){
        if (hex_fw == 'null' || hex_fw == ''){
          //document.getElementById("updateAvailabe").style.display = "none";
          progressBar("100", "No firmware found for this device", "#ff6666");
+          // Log no firmware found
+          logCommunication('No firmware found for this device', 'disconnected');
        }
        else {
          var element = document.getElementById("Device_output");
@@ -217,6 +327,8 @@ function checkAvailableFirmware(){
          //COMPARE commitCODE from DEVICE with RETURNED CODE FROM API
          if (commitCode.toUpperCase() == upgraded_version.toUpperCase()){
              readBar.innerHTML = 'Latest Firmware already on device';
+              // Log firmware up to date
+              logCommunication(`Firmware is up to date: ${commitCode}`, 'received');

              if (typeof(element) != 'undefined' && element != null)
              {
@@ -225,6 +337,8 @@ function checkAvailableFirmware(){
            }
            else {
              readBar.innerHTML = 'Firmware available';
+              // Log firmware available
+              logCommunication(`Firmware update available: Current ${commitCode}, Available ${upgraded_version}`, 'received');
              
              if (typeof(element) != 'undefined' && element != null){
                document.getElementById("Device_output").style.display = "block";
@@ -235,20 +349,42 @@ function checkAvailableFirmware(){
  else{
    document.getElementById("updateAvailabe").style.display = "none";
    readBar.innerHTML = 'No firmware found for this device';
+    // Log no firmware location
+    logCommunication('No firmware location available', 'disconnected');
  }
  closePort();
 }

 async function closePort(){
-        reader.cancel();
-        await readableStreamClosed.catch(() => { /* Ignore the error */ });
+        
+        try {
+            // Log port closure start
+            const portInfo = port.getInfo();
+            const portDetails = {
+                processStep: 'Firmware',
+                usbVendorId: portInfo.usbVendorId,
+                usbProductId: portInfo.usbProductId,
+                readable: !!port.readable,
+                writable: !!port.writable,
+                opened: port.readable !== null && port.writable !== null
+            };
+            await logCommunication(`Starting port closure - ${JSON.stringify(portDetails)}`, 'disconnected');
+            
+            reader.cancel();
+            await readableStreamClosed.catch(() => { /* Ignore the error */ });
+            writer.close();
+            await writableStreamClosed;
+            console.log('Device connection closed');
+            await port.close();

-        writer.close();
-        await writableStreamClosed;
+            // Log successful port closure
+            await logCommunication(`Serial port closed successfully - VendorID: ${portInfo.usbVendorId}, ProductID: ${portInfo.usbProductId}`, 'disconnected');
+        } catch (error) {
+            // Log port closure failure
+            await logCommunication(`Serial port closure failed: ${error.message || 'Unknown error'}`, 'disconnected');
+        }

-        await port.close();
        openPort = 0;
-        console.log('Device connection closed');
        readBar.style.width = "100%";
 }