add ts-only API that surfaces redirect return result (#6346)

Author: riknoll

libs/core/serial.cpp

@@ -113,7 +113,7 @@ namespace serial {
     }
 
     /**
-    * Read multiple characters from the receive buffer. 
+    * Read multiple characters from the receive buffer.
     * If length is positive, pauses until enough characters are present.
     * @param length default buffer length
     */
@@ -144,8 +144,8 @@ namespace serial {
         case SerialPin::USB_TX: name = USBTX; return true;
         case SerialPin::USB_RX: name = USBRX; return true;
 #endif
-        default: 
-          auto pin = getPin(p); 
+        default:
+          auto pin = getPin(p);
           if (NULL != pin) {
             name = (PinName)pin->name;
             return true;
@@ -185,6 +185,22 @@ namespace serial {
 #endif
     }
 
+    //%
+    int redirectWithStatus(SerialPin tx, SerialPin rx) {
+#if MICROBIT_CODAL
+      if (getPin(tx) && getPin(rx)) {
+        is_redirected = 1;
+        return uBit.serial.redirect(*getPin(tx), *getPin(rx));
+      }
+#else
+      PinName txn;
+      PinName rxn;
+      if (tryResolvePin(tx, txn) && tryResolvePin(rx, rxn))
+        return uBit.serial.redirect(txn, rxn);
+#endif
+      return MICROBIT_INVALID_PARAMETER;
+    }
+
     /**
     Set the baud rate of the serial port
     */

libs/core/shims.d.ts

@@ -1053,7 +1053,7 @@ declare namespace serial {
     function writeBuffer(buffer: Buffer): void;
 
     /**
-     * Read multiple characters from the receive buffer. 
+     * Read multiple characters from the receive buffer.
      * If length is positive, pauses until enough characters are present.
      * @param length default buffer length
      */