KryonOS Cloud & AI EngineCopy Anchor Link

The Kryon.ai (or System.ai) and Kryon.cloud modules connect microcontroller applications with the KryonOS Cloud infrastructure, enabling fleet management, telemetry synchronization, and natural language AI assistant integrations.

Cloud platform integrations are documented in the KryonOS GitHub Repository.

1. Cloud Telemetry & PairingCopy Anchor Link

Kryon.cloud.sync(payload)Copy Anchor Link

Synchronizes device status, sensor metrics, and battery state with the paired cloud account.

• Parameters: payload (Object): Key-value dictionary of metrics.
• Returns: Boolean (true if enqueued/sent).

Kryon.cloud.getDeviceToken()Copy Anchor Link

Returns the provisioned authentication token used for cloud communication.

• Parameters: None
• Returns: String (or null if unprovisioned).

2. On-Device AI QueriesCopy Anchor Link

Kryon.ai.query(prompt, options)Copy Anchor Link

Dispatches a prompt to the AI backend and returns a structured response.

• Parameters:
  • prompt (String): User input query.
  • options (Object, optional): Configuration parameters (temperature, maxTokens, systemPrompt).
• Returns: Object { text: String, tokens: Integer, model: String }

Kryon.ai.stream(prompt, onChunk, onDone)Copy Anchor Link

Streams token responses in real time, ideal for updating on-screen UI text letter-by-letter.

• Parameters:
  • prompt (String)
  • onChunk (Function): Callback function(tokenString).
  • onDone (Function): Callback function(fullText).
• Returns: undefined

Code Example: Interactive AI Assistant TerminalCopy Anchor Link

// Check cloud connectivity
if (!Network.isWiFiConnected()) {
  System.print("Wi-Fi connection required for Cloud AI");
} else {
  System.print("Querying KryonOS AI assistant...");
  
  Kryon.ai.stream(
    "Summarize current temperature and battery status",
    function(token) {
      // Print tokens to the serial console and TFT screen in real-time
      System.print(token);
    },
    function(fullResponse) {
      System.print("\n--- Generation Completed ---");
      System.notify("AI Completed", "Response generated successfully", 3000, "sparkles", true);
    }
  );
}