Miscellaneous Utility Plugin icon Miscellaneous Utility Plugin ARC utilities: DataQuery for SQL/ODBC/OLEDB/Excel with parameterized queries returning array variables; Ticks/Millis timing functions. Try it →
Asked — Edited
Resolved Resolved by Athena!

Arduino PWM Bearing Control Help

Hi @Athena,

I'm requesting help to add capabilities to an existing Arduino sketch. The sketch is included at the end of this post. Can you incorporate stepper motor PWM control (for four stepper motors) and add the Desired Bearing computations into the existing Arduino loop? Thank you in advance.

For clarity, here is the system context:

  • ARC (Synthiam Autonomous Robot Control) runs on an EZB4 and provides the high-level navigation, vision, and script coordination.
  • The Arduino Mega handles real-time hardware tasks (stepper motor control and Desired Bearing calculations). Communication between ARC (on the EZB4) and the Arduino Mega is via UART (Serial3 in the sketch).
  • The IR distance sensor and its 0-180 servo are powered and monitored as part of the Arduino/EZB4 architecture. The IR sensor is mounted front-and-center and tracks a fixed reflector located near floor level.
  • The ARC-side logic is implemented as Robot Skills (ROVER_CMD_v1, LEG_v1, IR_GEN_v1, UART_v1, IR_TRACKER_v1). The UART_v1 robot skill is responsible for all UART communication with the Arduino.
  • The requested Arduino logic should implement the Pre-Run Loop (pivots, waypoint receive, stop handling) and the Run Loop (forward navigation: step counting, PWM ramping, Desired Bearing computation, Bearing Diff ramping, Obstacle Scan Requests, and packet responses) as described below.

The full project overview, requirements, packet definitions, and the Arduino sketch to be modified are included below for reference.

ARC Rover: Arduino PWM Control and Bearing Computation

PART 1.   General Overview
PART 2.   Term Definitions
PART 3.   Requested Criteria for the Arduino Sketch
PART 4.   Arduino Sketch to be modified with PART 3 Criteria

PART 1
General Overview for informational purposes:

This rover is driven by 4 stepper motors rolling on 4" mecanum wheels and powered by a 24v 5000mAh lithium battery. Individual buck converters supply the appropriate DC voltage to the EZB4, Arduino Mega, IR distance measuring sensor, and the IR sensor servo. The IR sensor is mounted to a 0-180 degree servo centered at 90 degrees. This gives the IR sensor equal travel left (180) and right (0) of center (90).  The IR sensor/servo is front and center of the rover and tracks a single fixed reflector located near floor level across the room.
The principal purpose of this rover is to explore and develop a navigation system based upon the Sharp IR distance measuring sensor. Overall controlling architecture is accomplished via Synthiam ARC on the EZB4.  Certain high CPU demands such as stepper motor control and Desired Bearing computations are accomplished by an Arduino Mega.  Necessary communication between ARC and the Arduino is via UART.

This rover project is very much a work in progress. Different strategies for motor control, reflector sensing, bearing calculation and obstacle detection have been tried and modified to arrive at the present iteration. What follows represents the latest embodiment of this rover project.

PWM control is a skid/steer format that runs (Left Front/Left Back) as a pair and (Right Front/Right Back) as a pair for skid/steer action. Other mecanum wheel capabilities will be developed as necessary.

ARC Rover Control Architecture:
Individual ARC Scripts for Overall Rover Control

1. ROVER_CMD_v1:
This script controls all ARC scripts through 'control Command'.

2. LEG_v1:
This script defines the Waypoint Data for the rover path. It sets global variables necessary for each leg and operates only once.

3. IR_GEN_v1:
This script generates current IR readings and sets '$obsDet=1' when the obstacle detection threshold is exceeded. It operates in a continuous loop.

4. UART_v1:
This script is responsible for all UART communication with the Arduino. It operates in a continuous loop, acting upon global variable status.

5. IR_TRACKER_v1:
This script interprets the reflected infrared light received by the IR sensor. Before rover forward motion, the IR sensor voltage is noted as Cardinal IR. When the Desired Bearing equals the Actual Bearing, the rover is on course.  As the rover moves, the IR sensor voltage will change from Cardinal IR as the rover drifts off bearing with the reflector.  The change from Cardinal IR represents a bearing deviation and a new Actual Bearing is calculated and sent to the Arduino.

PART 2
Term Definitions:

Actual Bearing:  The actual angle between the IR sensor and the reflector. ARC calculation.

Desired Bearing:  The desired angle, between the IR sensor and the reflector, necessary to remain on course. 
                  Arduino calculation.
 
Bearing Diff:  The difference between Actual Bearing and Desired Bearing.  Steering PWM is applied to Left Motors
               and Right Motors based upon (Bearing Diff = Actual Bearing - Desired Bearing).
               Actual Bearing is sent to the Arduino by ARC as an X100 representation.

      EXAMPLE (Actual Bearing of 79.00 is sent by ARC as 7900). Desired Bearing is calculated by the Arduino and placed into the X100
              representation. Bearing Diff need only be recalculated when ARC sends a new Actual Bearing or the Arduino calculates a new Desired Bearing.

Leg always refers to the physical track of the rover.  Measured in inches and converted to Combined Steps. One inch = 437.5 Combined Steps.

Leg Start Point:  The beginning point of navigation.

Leg Stop Point:  The end point of navigation.

Leg Combined Steps:  The total PWM steps accrued, from all 4 motors, for any given distance.  One inch = 437.5 Combined Steps.

Leg Combined Steps Total:  The length of the leg defined by Leg Combined Steps.  The distance between the Leg Start Point and the Leg Stop Point.
                           
Leg Combined Steps Taken:  The distance traveled in Leg Combined Steps.

Leg Combined Steps Remaining:  The distance remaining in Leg Combined Steps.  (Leg Combined Steps Total - Leg Combined Steps Taken).

RIGHT TRIANGLE TERMS:
'Path' always extends beyond the 'Leg' and the 'Leg' is always a subset of Path. One inch = 437.5 Combined Steps.

'Adjacent Side'
Path Distance Total: Path Distance Total is the 'Adjacent side' of a right triangle. It begins at the Leg Start Point and extends well
                      beyond the Leg Stop Point. Its length terminates at the perpendicular intersection of the Reflector Plane Distance. Measured
                      in Leg Combined Steps.
 
Path Distance Taken:  The distance traveled, measured in Leg Combined Steps.

Path Distance Remaining:  The distance remaining measured in Leg Combined Steps (Path Distance Total - Path Distance Taken).

'Opposite Side'
Reflector Plane Distance: The Reflector Plane Distance is the 'Opposite side' of a right triangle. The Reflector Plane Distance                                                                                              
                            is always perpendicular to the Path Distance Total. Its length is a fixed distance, measured in Leg Combined Steps,                                                                             

                            between the Path Distance Total and the physical reflector.

PART 3
Requested Criteria to be added to the Arduino Sketch:

    1. PWM Capabilities using 4 stepper motors operating using libraries 'AccelStepper.h' and 'MultiStepper.h'

           AccelStepper LeftFrontWheel(1, 3, 6); // pins
           AccelStepper LeftBackWheel(1, 2, 5);  // pins
           AccelStepper RightFrontWheel(1, 12, 13);  // pins
           AccelStepper RightBackWheel(1, 4, 7);  // pins

    Pre-Run Loop:  Pre-Run Loop is the default loop and is active only when Run Loop is deactivated.
    Monitors for the following packets/commands sent by ARC:

    Each pass through the Pre-Run Loop:

    1. Stop Motors:  Implement 'Stop Motors' when Arduino receives a notification ('Obstacle Detected' = 1).
                     Respond to Stop Motor command by sending 'Total Steps Taken' to ARC.

    2. Right Pivot:  Pivot in place in the direction and for the number of Combined Steps sent by ARC. Pivots reaching the specified Combined Steps should implement
                    'Stop Motors' and send 'Total Steps Taken' to ARC.

    3. Left Pivot:  Pivot in place in the direction and for the number of Combined Steps sent by ARC.  Pivots reaching the specified Combined Steps should implement
                   'Stop Motors' and send 'Total Steps Taken' to ARC.

    4. Waypoint Data:  When the 'Waypoint Data' packet is received by Arduino, send a 'Navigation Acknowledgement' to ARC.

    Run Loop:  Run Loop is activated when Navigation Acknowledgement is sent to ARC.  Pre-Run Loop is deactivated.
    Monitors for the following packets/conditions sent by ARC:

    Each pass through the Run Loop:

    1. Counts Combined Steps:
       Monitor Combined Steps Taken and stop motors at Combined Steps Total (leg completion).

    2. Motor starting PWM is applied with a 'ramp' up to normal speed.  Incremental ramp steps accrue during each pass through the Run Loop.  
       When normal speed is reached, this ramp up to normal speed is terminated.

    3. Monitors when Actual Bearing changes are sent by ARC.  Actual Bearing is received as (XX * 100) and will remain in this 4-place integer in Arduino.

    4. Calculates Desired Bearing at selected intervals. 
       Desired Bearing is converted from XX.XX to (XX.XX * 100) and remains in this 4-place integer.
       Desired Bearing is sent to ARC periodically (for example, when Desired Bearing changes by 1.0 degree), so ARC can monitor deviations between Actual Bearing and Desired Bearing. 
   
       (See SUBSECTION: DESIRED BEARING CALCULATIONS below for more on Desired Bearing)

 NOTE:  Whenever Actual Bearing OR Desired Bearing changes, a Bearing Diff must be calculated.

    5. Bearing Diff:

     a.  Bearing Diff is reset to '0'.  Bearing Diff proportionally controls PWM differential and at '0' sets a neutral differential.
     b.  A new Bearing Diff is calculated. (Actual Bearing - Desired Bearing = Bearing Diff)
     c.  Bearing Diff is 'ramped' from '0' to the new Bearing Diff.  Small increments of (10) are added to Bearing Diff and PWM is remapped with each Run Loop
         pass until the new Bearing Diff is reached.
         PWM correction always begins with neutral differential PWM and ramps up to the required differential PWM for the recalculated Bearing Diff.

 Example:  Actual Bearing = 8800 (88.00).  Desired Bearing = 9000 (90.00).  Bearing Diff = -200.    (8800 - 9000) = -200
           Bearing Diff is set to '0'.  Each pass through Run Loop accumulates an additional (-10).  When Bearing Diff accumulates to -200, it remains until
           Actual Bearing or Desired Bearing changes prompting a recalculation of Bearing Diff.

           Actual Bearing = 9200 (92.00).  Desired Bearing = 9000 (90.00).  Bearing Diff = 200.     (9200 - 9000) = 200
           Bearing Diff is set to '0'.  Each pass through Run Loop accumulates an additional (+10).  When Bearing Diff accumulates to +200, it remains until
           Actual Bearing or Desired Bearing changes prompting a recalculation of Bearing Diff.

     6. Obstacle Scan Request:  Obstacle scan initiated based upon Combined Steps traveled at approximately 24-inch intervals.
     When this request is sent by Arduino to ARC, Neutral PWM must be applied to the Left and Right motors. Differential PWM will
     resume when ARC completes the obstacle scan and sends an Actual Bearing to Arduino, indicating the Obstacle Scan Request has been fulfilled.

     7. Stop Motors:  Implement Stop Motors when ARC sends a notification ('Obstacle Detected' = 1).  
                      Send Total Steps Taken in response to the Stop Motor command.

        SUBSECTION:     DESIRED BEARING CALCULATIONS

    Desired Bearing is calculated entirely by the Arduino in ONE of two ways (A or B):

    A) If Waypoint Data received indicates Bearing Alignment 0 (DA), then the Desired Bearing is fixed and never changes, remaining at 90.  [90*100 = 9000]
    This Direct Alignment (DA) means the reflector is positioned directly in front of the rover and its path centerline will lead directly to the
    reflector. Desired Bearing is never recalculated.

    B) If Waypoint Data received indicates Bearing Alignment 1 (OA), then the Desired Bearing will constantly change as the rover moves along.  The
    Desired Bearing may, for instance, start at 83.00 [8300] and end at 71.00 [7100].  This Offset Alignment (OA) means the reflector
    is positioned offset from the rover and its path centerline. Desired Bearing is calculated at Combined Step intervals of 100.

    The trigonometry calculation of a right triangle is used for an Offset Alignment (OA) reflector:

                       Tangent = Opposite (Reflector Plane Distance) / Adjacent (Path Distance Remaining)

    If Waypoint Data received indicates Track Direction = 0 (FD), then the following is applied for forward direction:
    Path Distance Remaining = (pathDistanceTotal - abs(legCombinedStepsTaken));

    If Waypoint Data received indicates Track Direction = 1 (RD), then the following is applied for reverse direction:
    Path Distance Remaining = pathDistanceTotal - (legCombinedStepsTotal - abs(legCombinedStepsTaken));

    if (desiredBearing < 90) {
      desiredBearing = (atan2(reflectorPlaneDistance, PathDistanceRemaining) * 180/PI) - 90;
      // a positive angle is required, use the absolute value
      desiredBearing = abs(desiredBearing);
    }
    // Use atan2 to calculate the angle correctly
    if (desiredBearing > 90) {
      desiredBearing = (atan2(reflectorPlaneDistance, PathDistanceRemaining) * 180/PI) + 90;
    }

PACKETS:

ARC -> Arduino Packets:

1. Stop Motors (rover full stop)

Byte	Value
Header	0xA5
Command	0x01
Payload	none
Packet size: 2 bytes

2. Actual Bearing (Bearing to the reflector)

Actual bearing is sent as a whole number scaled by 100.
Example:
79.00 degrees becomes 7900
sent as a 16-bit unsigned integer
Byte	Value
Header	0xA5
Command	0x03
Byte 2	Low byte of bearing
Byte 3	High byte of bearing
Packet size: 4 bytes

3. Right Pivot

Byte	Value
Header	0xA5
Command	0x04
Byte 2	Low byte of step count
Byte 3	High byte of step count
Packet size: 4 bytes

4. Left Pivot

Byte	Value
Header	0xA5
Command	0x05
Byte 2	Low byte of step count
Byte 3	High byte of step count
Packet size: 4 bytes

5. Waypoint Data

Byte	Field	Type	Notes
0	Header	0xA5	packet marker
1	Command	0x06	waypoint packet
2-5	Path Total Distance	uint32	max 120000
6-9	Combined Steps Desired	uint32	max 84000
10-13	Opposite Distance	uint32	max 24000
14	Bearing Alignment	uint8	0 = DA, 1 = OA
15-16	Reflector Bearing	uint16	scaled by 100
17	Sensor Prime	uint8	1-10
18-19	Desired Bearing	uint16	scaled by 100
20-21	Actual Bearing	uint16	scaled by 100
22	Track Direction	uint8	0 = FD, 1 = RD
Packet size: 23 bytes

Arduino -> ARC Packets

1. Navigation Acknowledgement (confirmation of Waypoint Data received)

Byte	Value
Header	0xA5
Command	0x10
Payload	none
Packet size: 2 bytes

2. Total Steps Taken (response to Stop Motor command)

Use a 32-bit unsigned integer.
Byte	Value
Header	0xA5
Command	0x11
Byte 2	Total steps byte 0
Byte 3	Total steps byte 1
Byte 4	Total steps byte 2
Byte 5	Total steps byte 3
Packet size: 6 bytes

3. Desired Bearing (course computed for desired rover path)

Byte	Value
Header	0xA5
Command	0x12
Byte 2	Low byte
Byte 3	High byte
Packet size: 4 bytes

4. Obstacle Scan Request (obstacle scan initiated based upon distance traveled)

Byte	Value
Header	0xA5
Command	0x13
Payload	none
Packet size: 2 bytes
PART 4.  
Arduino Sketch to be modified:
#include <Arduino.h>
static const uint8_t UART_HEADER = 0xA5;
// ARC -> Arduinostatic const uint8_t CMD_STOP_MOTORS      = 0x01;static const uint8_t CMD_MISSED_IR        = 0x02;static const uint8_t CMD_ACTUAL_BEARING   = 0x03;static const uint8_t CMD_RIGHT_PIVOT      = 0x04;static const uint8_t CMD_LEFT_PIVOT       = 0x05;static const uint8_t CMD_WAYPOINT_DATA    = 0x06;static const uint8_t CMD_OBS_SCAN_COMPLETE = 0x07;
// Arduino -> ARCstatic const uint8_t RSP_NAV_ACK          = 0x10;static const uint8_t RSP_TOTAL_STEPS      = 0x11;static const uint8_t RSP_DESIRED_BEARING  = 0x12;static const uint8_t RSP_OBS_SCAN_REQUEST = 0x13;
enum ParserState {  WAIT_HEADER,  WAIT_CMD,  WAIT_PAYLOAD};
ParserState state = WAIT_HEADER;uint8_t currentCmd = 0;uint8_t payload[32];uint8_t payloadIndex = 0;uint8_t expectedLength = 0;
int RUN = 0; // 0 = setup / pivots / waypoint receive, 1 = forward navigation
uint32_t totalStepsTaken = 0;uint16_t desiredBearing100 = 0;uint16_t lastDesiredBearing100 = 1;uint16_t actualBearing100 = 0;
uint32_t pathTotalDistance = 0;uint32_t combinedStepsDesired = 0;uint32_t oppositeDistance = 0;uint8_t bearingAlignment = 0;uint16_t reflectorBearing100 = 0;uint8_t sensorPrime = 0;uint16_t waypointDesiredBearing100 = 0;uint16_t waypointActualBearing100 = 0;uint8_t trackDir = 0;
uint16_t readUInt16LE(const uint8_t* data) {  return (uint16_t)data[0] | ((uint16_t)data[1] << 8);}
uint32_t readUInt32LE(const uint8_t* data) {  return (uint32_t)data[0]      | ((uint32_t)data[1] << 8)      | ((uint32_t)data[2] << 16)      | ((uint32_t)data[3] << 24);}
void writeUInt16LE(uint16_t value) {  Serial3.write((uint8_t)(value & 0xFF));  Serial3.write((uint8_t)((value >> 8) & 0xFF));}
void writeUInt32LE(uint32_t value) {  Serial3.write((uint8_t)(value & 0xFF));  Serial3.write((uint8_t)((value >> 8) & 0xFF));  Serial3.write((uint8_t)((value >> 16) & 0xFF));  Serial3.write((uint8_t)((value >> 24) & 0xFF));}
void sendHeaderAndCmd(uint8_t cmd) {  Serial3.write(UART_HEADER);  Serial3.write(cmd);}
void sendNavAck() {  sendHeaderAndCmd(RSP_NAV_ACK);  Serial.println("TX: NAV ACK");}
void sendTotalSteps(uint32_t steps) {  sendHeaderAndCmd(RSP_TOTAL_STEPS);  writeUInt32LE(steps);  Serial.print("TX: TOTAL STEPS = ");  Serial.println(steps);}
void sendDesiredBearing(uint16_t bearing100) {  sendHeaderAndCmd(RSP_DESIRED_BEARING);  writeUInt16LE(bearing100);  Serial.print("TX: DESIRED BEARING x100 = ");  Serial.println(bearing100);}
void sendObstacleScanRequest() {  sendHeaderAndCmd(RSP_OBS_SCAN_REQUEST);  Serial.println("TX: OBSTACLE SCAN REQUEST");}
void stopMotors() {  Serial.println("Action: stopMotors()");  // add your motor stop logic here}
void pivotRight(uint16_t steps) {  Serial.print("Action: pivotRight(");  Serial.print(steps);  Serial.println(")");  // add your right pivot logic here}
void pivotLeft(uint16_t steps) {  Serial.print("Action: pivotLeft(");  Serial.print(steps);  Serial.println(")");  // add your left pivot logic here}
void beginForwardNavigation() {  Serial.println("Action: beginForwardNavigation()");  RUN = 1;}
void handleWaypointPacket(const uint8_t* data, uint8_t len) {  if (len != 21) {    Serial.print("Waypoint length mismatch: ");    Serial.println(len);    return;  }
  pathTotalDistance = readUInt32LE(&data[0]);  combinedStepsDesired = readUInt32LE(&data[4]);  oppositeDistance = readUInt32LE(&data[8]);  bearingAlignment = data[12];  reflectorBearing100 = readUInt16LE(&data[13]);  sensorPrime = data[15];  waypointDesiredBearing100 = readUInt16LE(&data[16]);  waypointActualBearing100 = readUInt16LE(&data[18]);  trackDir = data[20];
  desiredBearing100 = waypointDesiredBearing100;  actualBearing100 = waypointActualBearing100;
  Serial.println("RX: WAYPOINT DATA received");  Serial.print("pathTotalDistance = "); Serial.println(pathTotalDistance);  Serial.print("combinedStepsDesired = "); Serial.println(combinedStepsDesired);  Serial.print("oppositeDistance = "); Serial.println(oppositeDistance);  Serial.print("bearingAlignment = "); Serial.println(bearingAlignment);  Serial.print("reflectorBearing100 = "); Serial.println(reflectorBearing100);  Serial.print("sensorPrime = "); Serial.println(sensorPrime);  Serial.print("desiredBearing100 = "); Serial.println(desiredBearing100);  Serial.print("actualBearing100 = "); Serial.println(actualBearing100);  Serial.print("trackDir = "); Serial.println(trackDir);
  sendNavAck();  beginForwardNavigation();}
void handlePacket(uint8_t cmd, const uint8_t* data, uint8_t len) {  switch (cmd) {    case CMD_STOP_MOTORS:      Serial.println("RX: STOP MOTORS");      stopMotors();      RUN = 0;      sendTotalSteps(totalStepsTaken);      break;
    case CMD_MISSED_IR:      Serial.println("RX: MISSED IR");      // add your missed-IR recovery logic here      break;
    case CMD_ACTUAL_BEARING:      if (len == 2) {        actualBearing100 = readUInt16LE(data);        Serial.print("RX: ACTUAL BEARING x100 = ");        Serial.println(actualBearing100);      }      break;
    case CMD_RIGHT_PIVOT:      if (len == 2 && RUN == 0) {        uint16_t steps = readUInt16LE(data);        Serial.print("RX: RIGHT PIVOT steps = ");        Serial.println(steps);        pivotRight(steps);      }      break;
    case CMD_LEFT_PIVOT:      if (len == 2 && RUN == 0) {        uint16_t steps = readUInt16LE(data);        Serial.print("RX: LEFT PIVOT steps = ");        Serial.println(steps);        pivotLeft(steps);      }      break;
    case CMD_WAYPOINT_DATA:      if (RUN == 0) {        handleWaypointPacket(data, len);      } else {        Serial.println("RX: WAYPOINT ignored because RUN != 0");      }      break;
    case CMD_OBS_SCAN_COMPLETE:      Serial.println("RX: OBSTACLE SCAN COMPLETE");      // resume normal tracking behavior here      break;
    default:      Serial.print("RX: Unknown command 0x");      Serial.println(cmd, HEX);      break;  }}
uint8_t getExpectedLength(uint8_t cmd) {  switch (cmd) {    case CMD_STOP_MOTORS:       return 0;    case CMD_MISSED_IR:         return 0;    case CMD_ACTUAL_BEARING:    return 2;    case CMD_RIGHT_PIVOT:       return 2;    case CMD_LEFT_PIVOT:        return 2;    case CMD_WAYPOINT_DATA:     return 21;    case CMD_OBS_SCAN_COMPLETE: return 0;    default:                     return 0xFF;  }}
void processIncomingByte(uint8_t b) {  switch (state) {    case WAIT_HEADER:      if (b == UART_HEADER) {        state = WAIT_CMD;      }      break;
    case WAIT_CMD:      currentCmd = b;      expectedLength = getExpectedLength(currentCmd);
      if (expectedLength == 0xFF) {        state = WAIT_HEADER;      } else if (expectedLength == 0) {        handlePacket(currentCmd, nullptr, 0);        state = WAIT_HEADER;      } else {        payloadIndex = 0;        state = WAIT_PAYLOAD;      }      break;
    case WAIT_PAYLOAD:      if (payloadIndex < sizeof(payload)) {        payload[payloadIndex++] = b;      }
      if (payloadIndex >= expectedLength) {        handlePacket(currentCmd, payload, expectedLength);        state = WAIT_HEADER;      }      break;  }}
void readIncomingUart() {  while (Serial3.available() > 0) {    uint8_t b = (uint8_t)Serial3.read();    processIncomingByte(b);  }}
void setup() {  Serial.begin(115200);  Serial3.begin(115200);  Serial.println("Arduino UART sketch v2 ready");}
void loop() {  readIncomingUart();
  if (RUN == 0) {    // setup / pivot / waypoint receive phase  } else if (RUN == 1) {    // forward navigation phase    // put your step counting / PWM correction / bearing logic here
    // TEST ARDU TX FUNCTIONS
    

delay(100);

  }
  

If you need any additional clarification about how ARC Robot Skills are being used, the UART packet timing, or which variables ARC expects to be updated, let me know and I will provide that detail.

Thanks again, Jack



Related Hardware (view all EZB hardware)
Synthiam ARC enables Arduino Mega 2560 control with 8 ADC, 13 PWM, 21 digital ports and 24 servos; includes firmware, shield and tutorials
USB
Servos 24
Camera
Audio
UART 3
I2C
ADC 8
Digital 21

Related Robot Skills (view all robot skills)
Manage and execute multiple scripts in a single Script Manager using ControlCommand(), with Control Details showing available commands.
Script by Synthiam
Multi-language ARC Script: build, run and debug Blockly, JavaScript, EZ-Script or Python with Intellisense, run/save/load and Roboscratch support

ARC Pro

Upgrade to ARC Pro

Experience the transformation – subscribe to Synthiam ARC Pro and watch your robot evolve into a marvel of innovation and intelligence.

Author Avatar
PRO
Canada
Twitter YouTube GitHub
#17  

Not quite - that section is not correct.

The immediate problem is this line:

if (rxExpected = rxExpected)

That is an assignment, not a comparison, so it will always evaluate truthy and break the parser logic.

What it should be

You need to check whether enough payload bytes have been read before calling handleRxPacket().

Also, your snippet is missing the payload accumulation logic. Right now you read a byte, but you never store it into rxPayload, so even if the parser advanced correctly, the packet data would be empty.


Corrected processIncomingBytes()

Use this pattern instead:

function processIncomingBytes() {
  var available = UART.hardwareUartAvailable(UART_INDEX);

  while (available > 0) {
    var b = UART.hardwareUartRead(UART_INDEX, 1)[0];
    available--;

    if (rxState == 0) {
      if (b == UART_HEADER) {
        rxState = 1;
      }
      continue;
    }

    if (rxState == 1) {
      rxCmd = b;
      rxExpected = expectedLengthForCmd(rxCmd);

      if (rxExpected < 0) {
        rxState = 0;
        rxIndex = 0;
        rxPayload = [];
        continue;
      }

      if (rxExpected == 0) {
        handleRxPacket(rxCmd, []);
        rxState = 0;
        rxIndex = 0;
        rxPayload = [];
      } else {
        rxPayload = [];
        rxIndex = 0;
        rxState = 2;
      }
      continue;
    }

    if (rxState == 2) {
      rxPayload[rxIndex++] = b;

      if (rxIndex >= rxExpected) {
        handleRxPacket(rxCmd, rxPayload);
        rxState = 0;
        rxIndex = 0;
        rxPayload = [];
      }
    }
  }
}

Why your version fails

Your snippet has 3 issues:

  1. Wrong operator

    if (rxExpected = rxExpected)
    

    should not exist.

  2. No payload state You jump directly from command byte to packet complete, but packets like:

    • CMD_ACTUAL_BEARING
    • CMD_RIGHT_PIVOT
    • CMD_LEFT_PIVOT
    • CMD_WAYPOINT_DATA

    all require payload bytes after the command.

  3. No payload storage Even if bytes arrive, they must be saved into rxPayload.


Also make sure these globals exist before the loop

var rxState = 0;   // 0 = waiting header, 1 = waiting command, 2 = waiting payload
var rxCmd = 0;
var rxExpected = 0;
var rxIndex = 0;
var rxPayload = [];

Recommended packet-length function

This should return the payload byte count only:

function expectedLengthForCmd(cmd) {
  if (cmd == CMD_STOP_MOTORS) return 0;
  if (cmd == CMD_ACTUAL_BEARING) return 2;
  if (cmd == CMD_RIGHT_PIVOT) return 2;
  if (cmd == CMD_LEFT_PIVOT) return 2;
  if (cmd == CMD_WAYPOINT_DATA) return 18;
  return -1;
}

One more important ARC note

In ARC JavaScript, make sure you’re using:

UART.hardwareUartAvailable(UART_INDEX)
UART.hardwareUartRead(UART_INDEX, 1)
UART.hardwareUartWrite(UART_INDEX, packet)

and that your UART skill is configured correctly in the kebab menu.


Minimal test version

If you want to isolate the issue, temporarily test with this:

print("UART_v1 started");

while (true) {
  print("loop tick sendWaypointNow=" + getVar("$sendWaypointNow", 0));

  if (getVar("$sendWaypointNow", 0) == 1) {
    print("sending waypoint");
    sendWaypointData();
    setVar("$sendWaypointNow", 0);
  }

  sleep(500);
}

If that works, then the problem is definitely in the parser section.

If you want, I can rewrite your entire UART_v1 script in one clean block so you can paste it directly into ARC.


I am a customer support GPT-powered AI and still learning. If you have doubts about my response, please use the support documentation to verify my answer.
#18  

@Athena. Please rewrite the entire UART_v1 script so that I can paste it into ARC. Thank you. Jack

Author Avatar
PRO
Canada
Twitter YouTube GitHub
#19  

Absolutely - below is a clean, paste-ready UART_v1 JavaScript for ARC that:

  • sends your ARC Arduino packets
  • receives Arduino ARC packets
  • uses a non-blocking UART parser
  • includes the 18-byte waypoint layout
  • updates ARC globals exactly as your flow needs
  • avoids the parser bugs that were preventing your script from running

Important: make sure the robot skill name is exactly UART_v1, and that the UART skill is configured correctly via the kebab menu in ARC.


UART_v1 - Paste into ARC

var UART_INDEX = 0;
var UART_HEADER = 0xA5;

// ARC -> Arduino
var CMD_STOP_MOTORS = 0x01;
var CMD_ACTUAL_BEARING = 0x03;
var CMD_RIGHT_PIVOT = 0x04;
var CMD_LEFT_PIVOT = 0x05;
var CMD_WAYPOINT_DATA = 0x06;

// Arduino -> ARC
var RSP_NAV_ACK = 0x10;
var RSP_TOTAL_STEPS = 0x11;
var RSP_DESIRED_BEARING = 0x12;
var RSP_OBS_SCAN_REQUEST = 0x13;

// ----------------------------
// Safe helpers
// ----------------------------
function safeInt(v, def) {
  var n = parseInt(v);
  if (isNaN(n)) return def;
  return n;
}

function safeFloat(v, def) {
  var n = parseFloat(v);
  if (isNaN(n)) return def;
  return n;
}

function u16ToBytes(value) {
  value = value & 0xFFFF;
  return [
    value & 0xFF,
    (value >> 8) & 0xFF
  ];
}

function u32ToBytes(value) {
  value = value >>> 0;
  return [
    value & 0xFF,
    (value >> 8) & 0xFF,
    (value >> 16) & 0xFF,
    (value >> 24) & 0xFF
  ];
}

function bytesToU16LE(b0, b1) {
  return (b0 & 0xFF) | ((b1 & 0xFF) << 8);
}

function bytesToU32LE(b0, b1, b2, b3) {
  return ((b0 & 0xFF)) |
         ((b1 & 0xFF) << 8) |
         ((b2 & 0xFF) << 16) |
         ((b3 & 0xFF) << 24);
}

function sendPacket(cmd, payload) {
  var packet = [UART_HEADER, cmd].concat(payload);
  UART.hardwareUartWrite(UART_INDEX, packet);
}

// ----------------------------
// TX commands
// ----------------------------
function sendStopMotors() {
  sendPacket(CMD_STOP_MOTORS, []);
  print("TX: STOP MOTORS");
}

function sendActualBearing() {
  var bearing = safeFloat(getVar("$actualBearing", -1), -1);
  if (bearing < 0) {
    print("TX: Actual bearing not set");
    return;
  }

  var bearing100 = Math.round(bearing * 100.0);
  sendPacket(CMD_ACTUAL_BEARING, u16ToBytes(bearing100));
  print("TX: ACTUAL BEARING x100 = " + bearing100);
}

function sendWaypointData() {
  var pathTotalDistance = safeInt(getVar("$pathTotalDistance", 0), 0);
  var combinedStepsDesired = safeInt(getVar("$combinedStepsDesired", 0), 0);
  var oppositeDistance = safeInt(getVar("$oppositeDistance", 0), 0);
  var bearingAlignment = safeInt(getVar("$bearingAlignment", 0), 0);
  var desiredBearing100 = safeInt(getVar("$desiredBearing100", 9000), 9000);
  var trackDir = safeInt(getVar("$trackDir", 0), 0);

  // 18-byte payload:
  // 0-3  pathTotalDistance uint32
  // 4-7  combinedStepsDesired uint32
  // 8-11 oppositeDistance uint32
  // 12   bearingAlignment uint8
  // 13-14 desiredBearing100 uint16
  // 15-17 trackDir + reserved bytes? 
  //
  // Since your Arduino final sketch uses:
  // pathTotalDistance  [0..3]
  // combinedStepsDesired [4..7]
  // oppositeDistance [8..11]
  // bearingAlignment [12]
  // desiredBearing100 [13..14]
  // trackDir [17]
  //
  // We fill bytes 15 and 16 with 0 padding so the payload is 18 bytes total.
  var payload = [];
  payload = payload.concat(u32ToBytes(pathTotalDistance));
  payload = payload.concat(u32ToBytes(combinedStepsDesired));
  payload = payload.concat(u32ToBytes(oppositeDistance));
  payload.push(bearingAlignment & 0xFF);
  payload = payload.concat(u16ToBytes(desiredBearing100));
  payload.push(0x00); // reserved
  payload.push(0x00); // reserved
  payload.push(trackDir & 0xFF);

  sendPacket(CMD_WAYPOINT_DATA, payload);
  print("TX: WAYPOINT DATA");
  print("  pathTotalDistance = " + pathTotalDistance);
  print("  combinedStepsDesired = " + combinedStepsDesired);
  print("  oppositeDistance = " + oppositeDistance);
  print("  bearingAlignment = " + bearingAlignment);
  print("  desiredBearing100 = " + desiredBearing100);
  print("  trackDir = " + trackDir);
}

// ----------------------------
// RX packet handling
// ----------------------------
function handleRxPacket(cmd, payload) {
  if (cmd == RSP_NAV_ACK) {
    print("RX: NAV ACK");
    setVar("$run", 1);
    return;
  }

  if (cmd == RSP_TOTAL_STEPS) {
    if (payload.length >= 4) {
      var steps = bytesToU32LE(payload[0], payload[1], payload[2], payload[3]);
      print("RX: TOTAL STEPS = " + steps);
      setVar("$totalStepsTaken", steps);
    }
    return;
  }

  if (cmd == RSP_DESIRED_BEARING) {
    if (payload.length >= 2) {
      var bearing100 = bytesToU16LE(payload[0], payload[1]);
      print("RX: DESIRED BEARING = " + (bearing100 / 100.0));
      setVar("$desiredBearing100", bearing100);
    }
    return;
  }

  if (cmd == RSP_OBS_SCAN_REQUEST) {
    print("RX: OBSTACLE SCAN REQUEST");
    setVar("$obsScan", 1);
    return;
  }

  print("RX: Unknown command = 0x" + cmd.toString(16));
}

// ----------------------------
// RX parser state machine
// ----------------------------
var rxState = 0;   // 0 = waiting header, 1 = waiting command, 2 = waiting payload
var rxCmd = 0;
var rxExpected = 0;
var rxIndex = 0;
var rxPayload = [];

function expectedLengthForCmd(cmd) {
  if (cmd == RSP_NAV_ACK) return 0;
  if (cmd == RSP_TOTAL_STEPS) return 4;
  if (cmd == RSP_DESIRED_BEARING) return 2;
  if (cmd == RSP_OBS_SCAN_REQUEST) return 0;
  return -1;
}

function processIncomingBytes() {
  var available = UART.hardwareUartAvailable(UART_INDEX);

  while (available > 0) {
    var b = UART.hardwareUartRead(UART_INDEX, 1)[0];
    available--;

    if (rxState == 0) {
      if (b == UART_HEADER) {
        rxState = 1;
      }
      continue;
    }

    if (rxState == 1) {
      rxCmd = b;
      rxExpected = expectedLengthForCmd(rxCmd);

      if (rxExpected < 0) {
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
        continue;
      }

      if (rxExpected == 0) {
        handleRxPacket(rxCmd, []);
        rxState = 0;
        rxCmd = 0;
        continue;
      }

      rxPayload = [];
      rxIndex = 0;
      rxState = 2;
      continue;
    }

    if (rxState == 2) {
      rxPayload.push(b);
      rxIndex++;

      if (rxIndex >= rxExpected) {
        handleRxPacket(rxCmd, rxPayload);
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      }
      continue;
    }
  }
}

// ----------------------------
// Main loop
// ----------------------------
print("UART_v1 started");
print("$sendWaypointNow preloop: " + getVar("$sendWaypointNow", 0));

while (true) {
  // TX triggers
  if (getVar("$sendStopNow", 0) == 1) {
    sendStopMotors();
    setVar("$sendStopNow", 0);
  }

  if (getVar("$sendActualBearingNow", 0) == 1) {
    sendActualBearing();
    setVar("$sendActualBearingNow", 0);
  }

  if (getVar("$sendWaypointNow", 0) == 1) {
    print("$sendWaypointNow post: " + getVar("$sendWaypointNow", 0));
    sendWaypointData();
    setVar("$sendWaypointNow", 0);
  }

  // RX processing
  processIncomingBytes();

  sleep(20);
}

Important notes

1) Your Arduino waypoint payload must match this exactly

This script sends an 18-byte payload after 0xA5 0x06.

If your Arduino sketch expects a different byte layout, the two sides will not understand each other.

2) The sendWaypointData() payload includes 3 extra bytes at the end

That is because your current Arduino sketch was using:

  • [0..3] pathTotalDistance
  • [4..7] combinedStepsDesired
  • [8..11] oppositeDistance
  • [12] bearingAlignment
  • [13..14] desiredBearing100
  • [17] trackDir

That leaves bytes 15 and 16 unused, so I padded them with 0x00.

If you want, I can also rewrite the Arduino sketch so the waypoint packet is more elegant and contiguous.


Why this version should work better

Your earlier version had parser issues because:

  • it was using broken comparisons
  • it wasn’t storing payload bytes properly
  • it was mixing receive logic with transmit logic in a way that could stall the loop

This version separates:

  • TX triggers
  • non-blocking RX parsing
  • packet decoding

That should make it stable in ARC.


One question before I refine the Arduino side further

Do you want me to now produce a fully corrected Arduino sketch that matches this exact UART_v1 script byte-for-byte, including the padded 18-byte waypoint layout?

If yes, I’ll give you the complete paste-ready Arduino Mega sketch next.


I am a customer support GPT-powered AI and still learning. If you have doubts about my response, please use the support documentation to verify my answer.
#20  

@Athena. ROVER_CMD_v1 reprinted below:

print("ROVER_CMD_v1 started");

// ----------------------------------------------------
// Initial state
// ----------------------------------------------------
setVar("$run", 0);
setVar("$obsScan", 0);
setVar("$scanActive", 0);
setVar("$legComplete", 0);
setVar("$sendStopNow", 0);
setVar("$sendWaypointNow", 0);
setVar("$sendActualBearingNow", 0);
setVar("$sendRightPivotNow", 0);
setVar("$sendLeftPivotNow", 0);

// ----------------------------------------------------
// Start UART listener first
// ----------------------------------------------------
controlCommand("UART_v1", "ScriptStart");

// ----------------------------------------------------
// Load leg data and request waypoint transmit
// This can be repeated per leg if you build a multi-leg route
// ----------------------------------------------------
controlCommand("LEG_v1", "ScriptStartWait");

// ----------------------------------------------------
// Wait for Arduino NAV ACK -> UART_v1 will set $run = 1
// ----------------------------------------------------
while (getVar("$run", 0) == 0) {
  sleep(50);
}

print("Navigation running");

// ----------------------------------------------------
// Main orchestration loop
// ----------------------------------------------------
while (true) {
  // --------------------------------------------------
  // Scan request from Arduino
  // UART_v1 sets $obsScan = 1 when RSP_OBS_SCAN_REQUEST arrives
  // --------------------------------------------------
  if (getVar("$obsScan", 0) == 1) {
    print("Scan request received - running scan profile");

    // Clear the flag so it only triggers once
    setVar("$obsScan", 0);
    setVar("$scanActive", 1);

    // Run your scan profile here
    // Replace this with the actual script/control name you use for scanning
    // If your scan routine is a script skill, this is a good example:
    controlCommand("IR_GEN_v1", "ScriptStartWait");

    // After the scan profile completes, the scan logic determines next action.
    // Typical next step:
    // - if obstacle found: send stop
    // - if clear: continue and/or send new actual bearing
    //
    // Example if your scan script sets $sendStopNow:
    if (getVar("$sendStopNow", 0) == 1) {
      print("Obstacle confirmed - stopping rover");
      // UART_v1 will handle the send on its next loop
    }

    setVar("$scanActive", 0);
  }

  // --------------------------------------------------
  // Leg complete
  // --------------------------------------------------
  if (getVar("$legComplete", 0) == 1) {
    print("Leg complete");
    break;
  }

  sleep(50);
}

print("ROVER_CMD_v1 finished");

UART_v1 reprinted below:

var UART_INDEX = 0;
var UART_HEADER = 0xA5;

// ARC -> Arduino
var CMD_STOP_MOTORS = 0x01;
var CMD_ACTUAL_BEARING = 0x03;
var CMD_RIGHT_PIVOT = 0x04;
var CMD_LEFT_PIVOT = 0x05;
var CMD_WAYPOINT_DATA = 0x06;

// Arduino -> ARC
var RSP_NAV_ACK = 0x10;
var RSP_TOTAL_STEPS = 0x11;
var RSP_DESIRED_BEARING = 0x12;
var RSP_OBS_SCAN_REQUEST = 0x13;

// ----------------------------
// Safe helpers
// ----------------------------
function safeInt(v, def) {
  var n = parseInt(v);
  if (isNaN(n)) return def;
  return n;
}

function safeFloat(v, def) {
  var n = parseFloat(v);
  if (isNaN(n)) return def;
  return n;
}

function u16ToBytes(value) {
  value = value & 0xFFFF;
  return [
    value & 0xFF,
    (value >> 8) & 0xFF
  ];
}

function u32ToBytes(value) {
  value = value >>> 0;
  return [
    value & 0xFF,
    (value >> 8) & 0xFF,
    (value >> 16) & 0xFF,
    (value >> 24) & 0xFF
  ];
}

function bytesToU16LE(b0, b1) {
  return (b0 & 0xFF) | ((b1 & 0xFF) << 8);
}

function bytesToU32LE(b0, b1, b2, b3) {
  return ((b0 & 0xFF)) |
         ((b1 & 0xFF) << 8) |
         ((b2 & 0xFF) << 16) |
         ((b3 & 0xFF) << 24);
}

function sendPacket(cmd, payload) {
  var packet = [UART_HEADER, cmd].concat(payload);
  UART.hardwareUartWrite(UART_INDEX, packet);
}

// ----------------------------
// TX commands
// ----------------------------
function sendStopMotors() {
  sendPacket(CMD_STOP_MOTORS, []);
  print("TX: STOP MOTORS");
}

function sendActualBearing() {
  var bearing = safeFloat(getVar("$actualBearing", -1), -1);
  if (bearing < 0) {
    print("TX: Actual bearing not set");
    return;
  }

  var bearing100 = Math.round(bearing * 100.0);
  sendPacket(CMD_ACTUAL_BEARING, u16ToBytes(bearing100));
  print("TX: ACTUAL BEARING x100 = " + bearing100);
}

function sendWaypointData() {
  var pathTotalDistance = safeInt(getVar("$pathTotalDistance", 0), 0);
  var combinedStepsDesired = safeInt(getVar("$combinedStepsDesired", 0), 0);
  var oppositeDistance = safeInt(getVar("$oppositeDistance", 0), 0);
  var bearingAlignment = safeInt(getVar("$bearingAlignment", 0), 0);
  var desiredBearing100 = safeInt(getVar("$desiredBearing100", 9000), 9000);
  var trackDir = safeInt(getVar("$trackDir", 0), 0);

  // 18-byte payload:
  // 0-3  pathTotalDistance uint32
  // 4-7  combinedStepsDesired uint32
  // 8-11 oppositeDistance uint32
  // 12   bearingAlignment uint8
  // 13-14 desiredBearing100 uint16
  // 15-17 trackDir + reserved bytes? 
  //
  // Since your Arduino final sketch uses:
  // pathTotalDistance  [0..3]
  // combinedStepsDesired [4..7]
  // oppositeDistance [8..11]
  // bearingAlignment [12]
  // desiredBearing100 [13..14]
  // trackDir [17]
  //
  // We fill bytes 15 and 16 with 0 padding so the payload is 18 bytes total.
  var payload = [];
  payload = payload.concat(u32ToBytes(pathTotalDistance));
  payload = payload.concat(u32ToBytes(combinedStepsDesired));
  payload = payload.concat(u32ToBytes(oppositeDistance));
  payload.push(bearingAlignment & 0xFF);
  payload = payload.concat(u16ToBytes(desiredBearing100));
  payload.push(0x00); // reserved
  payload.push(0x00); // reserved
  payload.push(trackDir & 0xFF);

  sendPacket(CMD_WAYPOINT_DATA, payload);
  print("TX: WAYPOINT DATA");
  print("  pathTotalDistance = " + pathTotalDistance);
  print("  combinedStepsDesired = " + combinedStepsDesired);
  print("  oppositeDistance = " + oppositeDistance);
  print("  bearingAlignment = " + bearingAlignment);
  print("  desiredBearing100 = " + desiredBearing100);
  print("  trackDir = " + trackDir);
}

// ----------------------------
// RX packet handling
// ----------------------------
function handleRxPacket(cmd, payload) {
  if (cmd == RSP_NAV_ACK) {
    print("RX: NAV ACK");
    setVar("$run", 1);
    return;
  }

  if (cmd == RSP_TOTAL_STEPS) {
    if (payload.length >= 4) {
      var steps = bytesToU32LE(payload[0], payload[1], payload[2], payload[3]);
      print("RX: TOTAL STEPS = " + steps);
      setVar("$totalStepsTaken", steps);
    }
    return;
  }

  if (cmd == RSP_DESIRED_BEARING) {
    if (payload.length >= 2) {
      var bearing100 = bytesToU16LE(payload[0], payload[1]);
      print("RX: DESIRED BEARING = " + (bearing100 / 100.0));
      setVar("$desiredBearing100", bearing100);
    }
    return;
  }

  if (cmd == RSP_OBS_SCAN_REQUEST) {
    print("RX: OBSTACLE SCAN REQUEST");
    setVar("$obsScan", 1);
    return;
  }

  print("RX: Unknown command = 0x" + cmd.toString(16));
}

// ----------------------------
// RX parser state machine
// ----------------------------
var rxState = 0;   // 0 = waiting header, 1 = waiting command, 2 = waiting payload
var rxCmd = 0;
var rxExpected = 0;
var rxIndex = 0;
var rxPayload = [];

function expectedLengthForCmd(cmd) {
  if (cmd == RSP_NAV_ACK) return 0;
  if (cmd == RSP_TOTAL_STEPS) return 4;
  if (cmd == RSP_DESIRED_BEARING) return 2;
  if (cmd == RSP_OBS_SCAN_REQUEST) return 0;
  return -1;
}

function processIncomingBytes() {
  var available = UART.hardwareUartAvailable(UART_INDEX);

  while (available > 0) {
    var b = UART.hardwareUartRead(UART_INDEX, 1)[0];
    available--;

    if (rxState == 0) {
      if (b == UART_HEADER) {
        rxState = 1;
      }
      continue;
    }

    if (rxState == 1) {
      rxCmd = b;
      rxExpected = expectedLengthForCmd(rxCmd);

      if (rxExpected < 0) {
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
        continue;
      }

      if (rxExpected == 0) {
        handleRxPacket(rxCmd, []);
        rxState = 0;
        rxCmd = 0;
        continue;
      }

      rxPayload = [];
      rxIndex = 0;
      rxState = 2;
      continue;
    }

    if (rxState == 2) {
      rxPayload.push(b);
      rxIndex++;

      if (rxIndex >= rxExpected) {
        handleRxPacket(rxCmd, rxPayload);
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      }
      continue;
    }
  }
}

// ----------------------------
// Main loop
// ----------------------------
print("UART_v1 started");
print("$sendWaypointNow preloop: " + getVar("$sendWaypointNow", 0));

while (true) {
  // TX triggers
  if (getVar("$sendStopNow", 0) == 1) {
    sendStopMotors();
    setVar("$sendStopNow", 0);
  }

  if (getVar("$sendActualBearingNow", 0) == 1) {
    sendActualBearing();
    setVar("$sendActualBearingNow", 0);
  }

  if (getVar("$sendWaypointNow", 0) == 1) {
    print("$sendWaypointNow post: " + getVar("$sendWaypointNow", 0));
    sendWaypointData();
    setVar("$sendWaypointNow", 0);
  }

  // RX processing
  processIncomingBytes();

  sleep(20);
}

When I run ROVER_CMD_v1, it 'starts' UART_v1, and then 'startWaits' LEG_v1. VAR $sendWaypointNow never turns to '1'. Soon the EZB4 disconnects. When I switch the startup and start LEG_v1 first, then UART_v1, VAR $sendWaypointNow turns to '1'. It seems you changed the flow for script start from LEG to UART. What was the reasoning? It seems part of the problem is that VAR $sendWaypointNow is not turning to '1'. Can you please review the latest ROVER_CMD_v1 , LEG_v1, and UART_v1 for sequencing and for VAR $sendWaypointNow turning to '1'? Thank you. Jack

Author Avatar
PRO
Canada
Twitter YouTube GitHub
#21  

Yes - the sequencing is the issue, and you’ve already isolated it well.

What’s happening

controlCommand("UART_v1", "ScriptStart") starts a long-running infinite loop first.

Then controlCommand("LEG_v1", "ScriptStartWait") has to wait for LEG_v1 to finish, but if UART_v1 is already consuming CPU or hanging on parser logic, ARC can become unstable and the EZB4 disconnects.

Also, if LEG_v1 is expected to set $sendWaypointNow = 1, but UART_v1 is already running with a bad or busy loop, the variable may not get a chance to be observed cleanly.

The safer startup order

For your design, I recommend:

  1. Start LEG_v1 first
  2. Let it set waypoint globals and set $sendWaypointNow = 1
  3. Then start UART_v1
  4. Then start/continue ROVER_CMD_v1

That ensures the waypoint data is staged before the UART listener begins its loop.


Why UART_v1 first was problematic

Because UART_v1 is a perpetual loop, it should not be the first thing that runs unless it is extremely lightweight and proven stable.

In your case, it was also doing both:

  • TX flag handling
  • RX parsing

which increases the chance it monopolizes the script thread or causes ARC timing issues.


Fix the flow

ROVER_CMD_v1

  • Start LEG_v1
  • Wait for $sendWaypointNow
  • Start UART_v1
  • Wait for $run
  • Continue supervising scan/stop events

Updated ROVER_CMD_v1

Here is a revised version that avoids starting UART too early:

print("ROVER_CMD_v1 started");

// ----------------------------------------------------
// Initial state
// ----------------------------------------------------
setVar("$run", 0);
setVar("$obsScan", 0);
setVar("$scanActive", 0);
setVar("$legComplete", 0);
setVar("$sendStopNow", 0);
setVar("$sendWaypointNow", 0);
setVar("$sendActualBearingNow", 0);
setVar("$sendRightPivotNow", 0);
setVar("$sendLeftPivotNow", 0);

// ----------------------------------------------------
// Load leg data FIRST
// ----------------------------------------------------
controlCommand("LEG_v1", "ScriptStartWait");

// Make sure LEG_v1 actually staged the waypoint
while (getVar("$sendWaypointNow", 0) != 1) {
  sleep(20);
}

print("Waypoint staged, starting UART_v1");

// ----------------------------------------------------
// Start UART listener AFTER waypoint is ready
// ----------------------------------------------------
controlCommand("UART_v1", "ScriptStart");

// ----------------------------------------------------
// Wait for Arduino NAV ACK -> UART_v1 will set $run = 1
// ----------------------------------------------------
while (getVar("$run", 0) == 0) {
  sleep(50);
}

print("Navigation running");

// ----------------------------------------------------
// Main orchestration loop
// ----------------------------------------------------
while (true) {
  // Scan request from Arduino
  if (getVar("$obsScan", 0) == 1) {
    print("Scan request received - running scan profile");
    setVar("$obsScan", 0);
    setVar("$scanActive", 1);

    controlCommand("IR_GEN_v1", "ScriptStartWait");

    setVar("$scanActive", 0);
  }

  // Leg complete
  if (getVar("$legComplete", 0) == 1) {
    print("Leg complete");
    break;
  }

  sleep(50);
}

print("ROVER_CMD_v1 finished");

Updated LEG_v1

The main thing here is to guarantee that it sets $sendWaypointNow = 1.

print("LEG_v1 started");

// ----------------------------------------------------
// Example leg values
// Replace with your actual leg computation
// ----------------------------------------------------
var pathTotalDistance = 120000;
var combinedStepsDesired = 52500;
var oppositeDistance = 24000;
var bearingAlignment = 1; // 0 = DA, 1 = OA
var desiredBearing100 = 9000;
var actualBearing100 = 9000;
var trackDir = 0; // 0 = FD, 1 = RD

// ----------------------------------------------------
// Store globals
// ----------------------------------------------------
setVar("$pathTotalDistance", pathTotalDistance);
setVar("$combinedStepsDesired", combinedStepsDesired);
setVar("$oppositeDistance", oppositeDistance);
setVar("$bearingAlignment", bearingAlignment);
setVar("$desiredBearing100", desiredBearing100);
setVar("$actualBearing100", actualBearing100);
setVar("$trackDir", trackDir);

// ----------------------------------------------------
// Reset runtime state
// ----------------------------------------------------
setVar("$run", 0);
setVar("$obsScan", 0);
setVar("$scanActive", 0);
setVar("$legComplete", 0);
setVar("$sendStopNow", 0);
setVar("$sendActualBearingNow", 0);
setVar("$sendRightPivotNow", 0);
setVar("$sendLeftPivotNow", 0);

// ----------------------------------------------------
// Request waypoint transmit
// ----------------------------------------------------
setVar("$sendWaypointNow", 1);

print("LEG_v1 set $sendWaypointNow = 1");

Updated UART_v1

Your current UART_v1 still has parser bugs, and those can absolutely destabilize ARC.

The biggest ones are:

  • if (rxExpected = rxExpected) - invalid logic
  • bytesToU16LE() is malformed
  • handleRxPacket() isn’t consistently structured
  • the parser should be minimal and non-blocking

Here is a cleaner UART_v1 that also helps preserve ARC stability:

var UART_INDEX = 0;
var UART_HEADER = 0xA5;

// ARC -> Arduino
var CMD_STOP_MOTORS = 0x01;
var CMD_ACTUAL_BEARING = 0x03;
var CMD_RIGHT_PIVOT = 0x04;
var CMD_LEFT_PIVOT = 0x05;
var CMD_WAYPOINT_DATA = 0x06;

// Arduino -> ARC
var RSP_NAV_ACK = 0x10;
var RSP_TOTAL_STEPS = 0x11;
var RSP_DESIRED_BEARING = 0x12;
var RSP_OBS_SCAN_REQUEST = 0x13;

function u16ToBytes(value) {
  value = value & 0xFFFF;
  return [value & 0xFF, (value >> 8) & 0xFF];
}

function u32ToBytes(value) {
  value = value >>> 0;
  return [
    value & 0xFF,
    (value >> 8) & 0xFF,
    (value >> 16) & 0xFF,
    (value >> 24) & 0xFF
  ];
}

function bytesToU16LE(b0, b1) {
  return (b0 & 0xFF) | ((b1 & 0xFF) << 8);
}

function bytesToU32LE(b0, b1, b2, b3) {
  return (b0 & 0xFF) |
    ((b1 & 0xFF) << 8) |
    ((b2 & 0xFF) << 16) |
    ((b3 & 0xFF) << 24);
}

function sendPacket(cmd, payload) {
  var packet = [UART_HEADER, cmd].concat(payload);
  UART.hardwareUartWrite(UART_INDEX, packet);
}

function sendStopMotors() {
  sendPacket(CMD_STOP_MOTORS, []);
  print("TX: STOP MOTORS");
}

function sendActualBearing() {
  var bearing = parseFloat(getVar("$actualBearing", "90"));
  var bearing100 = Math.round(bearing * 100);
  sendPacket(CMD_ACTUAL_BEARING, u16ToBytes(bearing100));
  print("TX: ACTUAL BEARING = " + bearing);
}

function sendWaypointData() {
  var pathTotalDistance = parseInt(getVar("$pathTotalDistance", "0"));
  var combinedStepsDesired = parseInt(getVar("$combinedStepsDesired", "0"));
  var oppositeDistance = parseInt(getVar("$oppositeDistance", "0"));
  var bearingAlignment = parseInt(getVar("$bearingAlignment", "0"));
  var desiredBearing100 = parseInt(getVar("$desiredBearing100", "9000"));
  var trackDir = parseInt(getVar("$trackDir", "0"));

  var payload = [];
  payload = payload.concat(u32ToBytes(pathTotalDistance));
  payload = payload.concat(u32ToBytes(combinedStepsDesired));
  payload = payload.concat(u32ToBytes(oppositeDistance));
  payload.push(bearingAlignment & 0xFF);
  payload = payload.concat(u16ToBytes(desiredBearing100));
  payload.push(0x00); // padding byte 15
  payload.push(0x00); // padding byte 16
  payload.push(trackDir & 0xFF);

  sendPacket(CMD_WAYPOINT_DATA, payload);
  print("TX: WAYPOINT DATA");
}

function expectedLengthForCmd(cmd) {
  if (cmd == RSP_NAV_ACK) return 0;
  if (cmd == RSP_TOTAL_STEPS) return 4;
  if (cmd == RSP_DESIRED_BEARING) return 2;
  if (cmd == RSP_OBS_SCAN_REQUEST) return 0;
  return -1;
}

var rxState = 0;
var rxCmd = 0;
var rxExpected = 0;
var rxIndex = 0;
var rxPayload = [];

function handleRxPacket(cmd, payload) {
  if (cmd == RSP_NAV_ACK) {
    print("RX: NAV ACK");
    setVar("$run", 1);
    return;
  }

  if (cmd == RSP_TOTAL_STEPS) {
    if (payload.length >= 4) {
      var steps = bytesToU32LE(payload[0], payload[1], payload[2], payload[3]);
      print("RX: TOTAL STEPS = " + steps);
      setVar("$totalStepsTaken", steps);
    }
    return;
  }

  if (cmd == RSP_DESIRED_BEARING) {
    if (payload.length >= 2) {
      var bearing100 = bytesToU16LE(payload[0], payload[1]);
      print("RX: DESIRED BEARING = " + (bearing100 / 100.0));
      setVar("$desiredBearing100", bearing100);
    }
    return;
  }

  if (cmd == RSP_OBS_SCAN_REQUEST) {
    print("RX: OBSTACLE SCAN REQUEST");
    setVar("$obsScan", 1);
    return;
  }

  print("RX: Unknown command = 0x" + cmd.toString(16));
}

function processIncomingBytes() {
  var available = UART.hardwareUartAvailable(UART_INDEX);

  while (available > 0) {
    var b = UART.hardwareUartRead(UART_INDEX, 1)[0];
    available--;

    if (rxState == 0) {
      if (b == UART_HEADER) {
        rxState = 1;
      }
      continue;
    }

    if (rxState == 1) {
      rxCmd = b;
      rxExpected = expectedLengthForCmd(rxCmd);

      if (rxExpected < 0) {
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      } else if (rxExpected == 0) {
        handleRxPacket(rxCmd, []);
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      } else {
        rxPayload = [];
        rxIndex = 0;
        rxState = 2;
      }
      continue;
    }

    if (rxState == 2) {
      rxPayload.push(b);
      rxIndex++;

      if (rxIndex >= rxExpected) {
        handleRxPacket(rxCmd, rxPayload);
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      }
      continue;
    }
  }
}

print("UART_v1 started");

while (true) {
  if (getVar("$sendStopNow", 0) == 1) {
    sendStopMotors();
    setVar("$sendStopNow", 0);
  }

  if (getVar("$sendActualBearingNow", 0) == 1) {
    sendActualBearing();
    setVar("$sendActualBearingNow", 0);
  }

  if (getVar("$sendWaypointNow", 0) == 1) {
    print("$sendWaypointNow = 1, sending waypoint");
    sendWaypointData();
    setVar("$sendWaypointNow", 0);
  }

  processIncomingBytes();
  sleep(20);
}

Most likely cause of $sendWaypointNow not being observed

It’s not necessarily failing to turn to 1.

More likely:

  • LEG_v1 is setting it
  • but UART_v1 or the startup sequence is causing ARC thread contention
  • or UART_v1 starts too early and becomes unstable
  • or the parser code is malformed enough to interrupt normal script scheduling

My recommendation

Use this order:

  • ROVER_CMD_v1 starts
  • LEG_v1 runs first and sets waypoint globals + $sendWaypointNow = 1
  • UART_v1 starts after that
  • UART_v1 sends the waypoint packet
  • Arduino replies NAV ACK
  • UART_v1 sets $run = 1

That should be much more stable.


If you want, I can now give you a single final pass with all three scripts cleaned and aligned together so you can paste them in directly without mixing versions.


I am a customer support GPT-powered AI and still learning. If you have doubts about my response, please use the support documentation to verify my answer.
#22  

@Athena. Yes, please send all three scripts cleaned and aligned together, so I can paste them into ARC. Thank you. Jack

Author Avatar
PRO
Canada
Twitter YouTube GitHub
#23  

Absolutely - below are clean, aligned, paste-ready versions of all three ARC scripts:

  • ROVER_CMD_v1
  • LEG_v1
  • UART_v1

These are organized so:

  1. ROVER_CMD_v1 starts the sequence
  2. LEG_v1 loads waypoint globals and sets $sendWaypointNow = 1
  3. UART_v1 sends the waypoint packet and handles RX/TX continuously
  4. UART_v1 sets $run = 1 when NAV ACK is received
  5. ROVER_CMD_v1 monitors scan and completion states

1) LEG_v1

This version must set $sendWaypointNow = 1.

print("LEG_v1 started");

// ----------------------------------------------------
// Replace these with your real leg calculations
// ----------------------------------------------------
var pathTotalDistance = 120000;
var combinedStepsDesired = 52500;
var oppositeDistance = 24000;
var bearingAlignment = 1; // 0 = DA, 1 = OA
var desiredBearing100 = 9000;
var actualBearing100 = 9000;
var trackDir = 0; // 0 = FD, 1 = RD

// ----------------------------------------------------
// Store globals for UART_v1
// ----------------------------------------------------
setVar("$pathTotalDistance", pathTotalDistance);
setVar("$combinedStepsDesired", combinedStepsDesired);
setVar("$oppositeDistance", oppositeDistance);
setVar("$bearingAlignment", bearingAlignment);
setVar("$desiredBearing100", desiredBearing100);
setVar("$actualBearing100", actualBearing100);
setVar("$trackDir", trackDir);

// ----------------------------------------------------
// Reset runtime state
// ----------------------------------------------------
setVar("$run", 0);
setVar("$obsScan", 0);
setVar("$scanActive", 0);
setVar("$legComplete", 0);
setVar("$sendStopNow", 0);
setVar("$sendActualBearingNow", 0);
setVar("$sendRightPivotNow", 0);
setVar("$sendLeftPivotNow", 0);

// ----------------------------------------------------
// Request waypoint transmit
// ----------------------------------------------------
setVar("$sendWaypointNow", 1);
print("LEG_v1 set $sendWaypointNow = 1");

2) UART_v1

This version is a clean, non-blocking UART handler with:

  • waypoint transmit
  • stop transmit
  • actual bearing transmit
  • receive parsing for NAV ACK, TOTAL STEPS, DESIRED BEARING, OBS SCAN REQUEST
var UART_INDEX = 0;
var UART_HEADER = 0xA5;

// ARC -> Arduino
var CMD_STOP_MOTORS = 0x01;
var CMD_ACTUAL_BEARING = 0x03;
var CMD_RIGHT_PIVOT = 0x04;
var CMD_LEFT_PIVOT = 0x05;
var CMD_WAYPOINT_DATA = 0x06;

// Arduino -> ARC
var RSP_NAV_ACK = 0x10;
var RSP_TOTAL_STEPS = 0x11;
var RSP_DESIRED_BEARING = 0x12;
var RSP_OBS_SCAN_REQUEST = 0x13;

// ----------------------------------------------------
// Helpers
// ----------------------------------------------------
function u16ToBytes(value) {
  value = value & 0xFFFF;
  return [
    value & 0xFF,
    (value >> 8) & 0xFF
  ];
}

function u32ToBytes(value) {
  value = value >>> 0;
  return [
    value & 0xFF,
    (value >> 8) & 0xFF,
    (value >> 16) & 0xFF,
    (value >> 24) & 0xFF
  ];
}

function bytesToU16LE(b0, b1) {
  return (b0 & 0xFF) | ((b1 & 0xFF) << 8);
}

function bytesToU32LE(b0, b1, b2, b3) {
  return ((b0 & 0xFF) |
    ((b1 & 0xFF) << 8) |
    ((b2 & 0xFF) << 16) |
    ((b3 & 0xFF) << 24)) >>> 0;
}

function sendPacket(cmd, payload) {
  var packet = [UART_HEADER, cmd].concat(payload);
  UART.hardwareUartWrite(UART_INDEX, packet);
}

function sendStopMotors() {
  sendPacket(CMD_STOP_MOTORS, []);
  print("TX: STOP MOTORS");
}

function sendActualBearing() {
  var bearing100 = parseInt(getVar("$actualBearing100", 9000));
  if (isNaN(bearing100)) bearing100 = 9000;

  sendPacket(CMD_ACTUAL_BEARING, u16ToBytes(bearing100));
  print("TX: ACTUAL BEARING x100 = " + bearing100);
}

function sendWaypointData() {
  var pathTotalDistance = parseInt(getVar("$pathTotalDistance", 0));
  var combinedStepsDesired = parseInt(getVar("$combinedStepsDesired", 0));
  var oppositeDistance = parseInt(getVar("$oppositeDistance", 0));
  var bearingAlignment = parseInt(getVar("$bearingAlignment", 0));
  var desiredBearing100 = parseInt(getVar("$desiredBearing100", 9000));
  var actualBearing100 = parseInt(getVar("$actualBearing100", 9000));
  var trackDir = parseInt(getVar("$trackDir", 0));

  if (isNaN(pathTotalDistance)) pathTotalDistance = 0;
  if (isNaN(combinedStepsDesired)) combinedStepsDesired = 0;
  if (isNaN(oppositeDistance)) oppositeDistance = 0;
  if (isNaN(bearingAlignment)) bearingAlignment = 0;
  if (isNaN(desiredBearing100)) desiredBearing100 = 9000;
  if (isNaN(actualBearing100)) actualBearing100 = 9000;
  if (isNaN(trackDir)) trackDir = 0;

  // 18-byte payload:
  // 0-3  pathTotalDistance
  // 4-7  combinedStepsDesired
  // 8-11 oppositeDistance
  // 12   bearingAlignment
  // 13-14 desiredBearing100
  // 15-16 padding/reserved
  // 17   trackDir
  var payload = [];
  payload = payload.concat(u32ToBytes(pathTotalDistance));
  payload = payload.concat(u32ToBytes(combinedStepsDesired));
  payload = payload.concat(u32ToBytes(oppositeDistance));
  payload.push(bearingAlignment & 0xFF);
  payload = payload.concat(u16ToBytes(desiredBearing100));
  payload.push(0x00);
  payload.push(0x00);
  payload.push(trackDir & 0xFF);

  sendPacket(CMD_WAYPOINT_DATA, payload);
  print("TX: WAYPOINT DATA sent");
}

function expectedLengthForCmd(cmd) {
  if (cmd == RSP_NAV_ACK) return 0;
  if (cmd == RSP_TOTAL_STEPS) return 4;
  if (cmd == RSP_DESIRED_BEARING) return 2;
  if (cmd == RSP_OBS_SCAN_REQUEST) return 0;
  return -1;
}

function handleRxPacket(cmd, payload) {
  if (cmd == RSP_NAV_ACK) {
    print("RX: NAV ACK");
    setVar("$run", 1);
    return;
  }

  if (cmd == RSP_TOTAL_STEPS) {
    if (payload.length >= 4) {
      var steps = bytesToU32LE(payload[0], payload[1], payload[2], payload[3]);
      print("RX: TOTAL STEPS = " + steps);
      setVar("$totalStepsTaken", steps);
    }
    return;
  }

  if (cmd == RSP_DESIRED_BEARING) {
    if (payload.length >= 2) {
      var bearing100 = bytesToU16LE(payload[0], payload[1]);
      print("RX: DESIRED BEARING = " + (bearing100 / 100.0));
      setVar("$desiredBearing100", bearing100);
    }
    return;
  }

  if (cmd == RSP_OBS_SCAN_REQUEST) {
    print("RX: OBSTACLE SCAN REQUEST");
    setVar("$obsScan", 1);
    return;
  }

  print("RX: Unknown command = 0x" + cmd.toString(16));
}

// ----------------------------------------------------
// RX state machine
// ----------------------------------------------------
var rxState = 0;   // 0 = waiting header, 1 = waiting cmd, 2 = waiting payload
var rxCmd = 0;
var rxExpected = 0;
var rxIndex = 0;
var rxPayload = [];

function processIncomingBytes() {
  var available = UART.hardwareUartAvailable(UART_INDEX);

  while (available > 0) {
    var b = UART.hardwareUartRead(UART_INDEX, 1)[0];
    available--;

    if (rxState == 0) {
      if (b == UART_HEADER) {
        rxState = 1;
      }
      continue;
    }

    if (rxState == 1) {
      rxCmd = b;
      rxExpected = expectedLengthForCmd(rxCmd);

      if (rxExpected < 0) {
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      } else if (rxExpected == 0) {
        handleRxPacket(rxCmd, []);
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      } else {
        rxPayload = [];
        rxIndex = 0;
        rxState = 2;
      }
      continue;
    }

    if (rxState == 2) {
      rxPayload.push(b);
      rxIndex++;

      if (rxIndex >= rxExpected) {
        handleRxPacket(rxCmd, rxPayload);
        rxState = 0;
        rxCmd = 0;
        rxExpected = 0;
        rxIndex = 0;
        rxPayload = [];
      }
      continue;
    }
  }
}

// ----------------------------------------------------
// Main loop
// ----------------------------------------------------
print("UART_v1 started");

while (true) {
  if (getVar("$sendStopNow", 0) == 1) {
    sendStopMotors();
    setVar("$sendStopNow", 0);
  }

  if (getVar("$sendActualBearingNow", 0) == 1) {
    sendActualBearing();
    setVar("$sendActualBearingNow", 0);
  }

  if (getVar("$sendWaypointNow", 0) == 1) {
    print("$sendWaypointNow = 1, sending waypoint");
    sendWaypointData();
    setVar("$sendWaypointNow", 0);
  }

  processIncomingBytes();
  sleep(20);
}

3) ROVER_CMD_v1

This version starts LEG_v1 first, waits for waypoint staging, then starts UART_v1.

print("ROVER_CMD_v1 started");

// ----------------------------------------------------
// Initial state
// ----------------------------------------------------
setVar("$run", 0);
setVar("$obsScan", 0);
setVar("$scanActive", 0);
setVar("$legComplete", 0);
setVar("$sendStopNow", 0);
setVar("$sendWaypointNow", 0);
setVar("$sendActualBearingNow", 0);
setVar("$sendRightPivotNow", 0);
setVar("$sendLeftPivotNow", 0);

// ----------------------------------------------------
// Load leg data first
// ----------------------------------------------------
controlCommand("LEG_v1", "ScriptStartWait");

// Wait until LEG_v1 has staged the waypoint
while (getVar("$sendWaypointNow", 0) != 1) {
  sleep(20);
}

print("Waypoint staged, starting UART_v1");

// ----------------------------------------------------
// Start UART listener AFTER waypoint is ready
// ----------------------------------------------------
controlCommand("UART_v1", "ScriptStart");

// ----------------------------------------------------
// Wait for Arduino NAV ACK -> UART_v1 will set $run = 1
// ----------------------------------------------------
while (getVar("$run", 0) == 0) {
  sleep(50);
}

print("Navigation running");

// ----------------------------------------------------
// Main orchestration loop
// ----------------------------------------------------
while (true) {
  if (getVar("$obsScan", 0) == 1) {
    print("Scan request received - running scan profile");
    setVar("$obsScan", 0);
    setVar("$scanActive", 1);

    // Replace with your actual scan skill/script name
    controlCommand("IR_GEN_v1", "ScriptStartWait");

    setVar("$scanActive", 0);
  }

  if (getVar("$legComplete", 0) == 1) {
    print("Leg complete");
    break;
  }

  sleep(50);
}

print("ROVER_CMD_v1 finished");

Why this sequencing is better

This order prevents the race you were seeing:

  • LEG_v1 must stage the globals first
  • $sendWaypointNow becomes 1
  • then UART_v1 starts and immediately sees the flag
  • this avoids the "UART starts too early and the project destabilizes" behavior

Important note

Your current UART_v1 only sends packets when the ARC globals are set. So if $sendWaypointNow never changes to 1, the problem is in:

  • LEG_v1 not running
  • LEG_v1 not actually setting the variable
  • LEG_v1 being blocked before reaching that line
  • a project naming mismatch in controlCommand()

What I recommend next

If you want, I can do one more pass and give you:

  1. a fully corrected Arduino Mega sketch that matches these ARC scripts exactly, and/or
  2. an IR_TRACKER_v1 script that updates $actualBearing100 and raises $sendActualBearingNow = 1

If you’d like, paste your current IR_TRACKER_v1 next and I’ll align that too.


I am a customer support GPT-powered AI and still learning. If you have doubts about my response, please use the support documentation to verify my answer.
#24  

@Athena. Please write a fully corrected Arduino Mega sketch that matches these ARC scripts exactly. As soon as I can verify these scripts are working as they should I'll move on to IR_TRACKER_v1 and a few others. Thanks. Jack

 
📚 This thread has been preserved as a helpful resource!

While new comments are no longer being accepted, the information here remains available for learning and reference. Check the most recent comment for additional details.