@geastack/core 0.1.41 → 0.1.42

package/include/platform/uart.h

@@ -0,0 +1,58 @@
+#pragma once
+
+#include <cstddef>
+#include <cstdint>
+
+// Target-owned implementation. Unsupported platforms report unavailable.
+extern "C" {
+bool gea_uart_open(int port, int tx, int rx, int baud, int rxBytes, int txBytes)
+    __attribute__((weak));
+bool gea_uart_is_open(int port) __attribute__((weak));
+void gea_uart_close(int port) __attribute__((weak));
+int gea_uart_read(int port, void *bytes, std::size_t capacity)
+    __attribute__((weak));
+int gea_uart_write(int port, const void *bytes, std::size_t length)
+    __attribute__((weak));
+int gea_uart_available(int port) __attribute__((weak));
+int gea_uart_writable(int port) __attribute__((weak));
+}
+
+namespace gea::platform::uart {
+struct Config {
+  int tx;
+  int rx;
+  int baudRate;
+  int rxBufferSize = 4096;
+  int txBufferSize = 4096;
+};
+
+class Uart {
+public:
+  static bool open(int port, const Config &config) {
+    return gea_uart_open &&
+           gea_uart_open(port, config.tx, config.rx, config.baudRate,
+                         config.rxBufferSize, config.txBufferSize);
+  }
+  static bool isOpen(int port) {
+    return gea_uart_is_open && gea_uart_is_open(port);
+  }
+  static void close(int port) {
+    if (gea_uart_close)
+      gea_uart_close(port);
+  }
+  // Nonblocking. -1 means unavailable/closed/error; 0 means no progress.
+  static int read(int port, void *bytes, std::size_t capacity) {
+    return gea_uart_read ? gea_uart_read(port, bytes, capacity) : -1;
+  }
+  // Enqueues the complete buffer, or returns 0 if it cannot fit yet.
+  static int write(int port, const void *bytes, std::size_t length) {
+    return gea_uart_write ? gea_uart_write(port, bytes, length) : -1;
+  }
+  static int available(int port) {
+    return gea_uart_available ? gea_uart_available(port) : -1;
+  }
+  static int writable(int port) {
+    return gea_uart_writable ? gea_uart_writable(port) : -1;
+  }
+};
+} // namespace gea::platform::uart

package/index.d.ts

@@ -1322,6 +1322,33 @@ export interface GpioController {
 
 export declare const Gpio: GpioController
 
+export interface UartOptions {
+  tx: number
+  rx: number
+  baudRate: number
+  /** Receive/transmit queue bytes. Defaults to 4096 each. */
+  rxBufferSize?: number
+  txBufferSize?: number
+}
+
+/** Hardware UART, 8 data bits, no parity, one stop bit (8N1). */
+export interface UartController {
+  /** Claims a free controller and pins. False on conflict/invalid configuration. */
+  open(port: number, options: UartOptions): boolean
+  isOpen(port: number): boolean
+  close(port: number): void
+  /** Nonblocking read into the supplied view; returns bytes read, or -1 on error. */
+  read(port: number, buffer: Uint8Array): number
+  /** Nonblocking whole-buffer enqueue; 0 means backpressure, -1 means error. */
+  write(port: number, buffer: Uint8Array): number
+  /** Queued readable bytes, or -1 when unavailable. */
+  available(port: number): number
+  /** Writable queue capacity, or -1 when unavailable. */
+  writable(port: number): number
+}
+
+export declare const Uart: UartController
+
 export interface LedController {
   // A WS2812/NeoPixel strand on one pin — what "the onboard LED" is on most
   // modern ESP32 modules.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/core",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "description": "GeaStack app API, reactivity headers, runtime sources, and type declarations.",
   "license": "Apache-2.0",
   "repository": {
@@ -66,7 +66,7 @@
     "@geajs/core": "1.5.1",
     "@geajs/vite-plugin": "1.5.0",
     "@geastack/compiler": "^1.0.29",
-    "@geastack/geatsc-plugin-gea": "^0.1.22",
+    "@geastack/geatsc-plugin-gea": "0.1.23",
     "opentype.js": "^2.0.0",
     "vite": "^8.0.0"
   }

package/runtime/host.ts

@@ -6,6 +6,7 @@
 // fails the representation coverage guard for the whole `Geolocation` literal
 // below. lib.dom's GeolocationPositionError also carries PERMISSION_DENIED /
 // POSITION_UNAVAILABLE / TIMEOUT, which our host object never sets.
+import type { UartOptions } from '../index'
 import type {
   CanvasRenderingContext2D,
   GeolocationCoordinates,
@@ -354,6 +355,15 @@ declare const __gea_Gpio: {
   write(pin: number, level: boolean): boolean
   read(pin: number): boolean
 }
+declare const __gea_Uart: {
+  open(port: number, tx: number, rx: number, baud: number, rxBytes: number, txBytes: number): boolean
+  isOpen(port: number): boolean
+  close(port: number): void
+  read(port: number, buffer: Uint8Array): number
+  write(port: number, buffer: Uint8Array): number
+  available(port: number): number
+  writable(port: number): number
+}
 declare const __gea_Led: {
   // A WS2812/NeoPixel strand on one pin — what "the onboard LED" is on most
   // modern ESP32 modules. set() is the one-call default (attach if needed,
@@ -1031,6 +1041,31 @@ export const Gpio = {
     return __gea_Gpio.read(pin)
   },
 }
+export const Uart = {
+  open(port: number, options: UartOptions): boolean {
+    if (typeof __gea_Uart === 'undefined') return false
+    return __gea_Uart.open(port, options.tx, options.rx, options.baudRate,
+      options.rxBufferSize ?? 4096, options.txBufferSize ?? 4096)
+  },
+  isOpen(port: number): boolean {
+    return typeof __gea_Uart !== 'undefined' && __gea_Uart.isOpen(port)
+  },
+  close(port: number): void {
+    if (typeof __gea_Uart !== 'undefined') __gea_Uart.close(port)
+  },
+  read(port: number, buffer: Uint8Array): number {
+    return typeof __gea_Uart !== 'undefined' ? __gea_Uart.read(port, buffer) : -1
+  },
+  write(port: number, buffer: Uint8Array): number {
+    return typeof __gea_Uart !== 'undefined' ? __gea_Uart.write(port, buffer) : -1
+  },
+  available(port: number): number {
+    return typeof __gea_Uart !== 'undefined' ? __gea_Uart.available(port) : -1
+  },
+  writable(port: number): number {
+    return typeof __gea_Uart !== 'undefined' ? __gea_Uart.writable(port) : -1
+  },
+}
 export const Led = {
   set(pin: number, r: number, g: number, b: number): boolean {
     return __gea_Led.set(pin, r, g, b)

package/runtime-surface.ts

@@ -57,6 +57,8 @@ export type {
  * gets today.
  */
 export type {
+  UartOptions,
+  UartController,
   AccelerometerController,
   AccelerometerReading,
   AppsController,