@geastack/core 0.1.39 → 0.1.40

package/include/platform/atomic_file.h

@@ -0,0 +1,72 @@
+// SPDX-License-Identifier: Apache-2.0
+#pragma once
+
+#include <cerrno>
+#include <cstdint>
+#include <cstdio>
+#include <string>
+#include <sys/stat.h>
+#include <vector>
+
+namespace gea::platform::storage {
+
+struct FileOperations {
+  using Handle = std::FILE *;
+  Handle open(const std::string &path) {
+    return std::fopen(path.c_str(), "wb");
+  }
+  std::size_t write(Handle file, const std::vector<std::uint8_t> &bytes) {
+    return std::fwrite(bytes.data(), 1, bytes.size(), file);
+  }
+  bool close(Handle file) { return std::fclose(file) == 0; }
+  bool move(const std::string &from, const std::string &to) {
+    return std::rename(from.c_str(), to.c_str()) == 0;
+  }
+  bool remove(const std::string &path) {
+    return std::remove(path.c_str()) == 0 || errno == ENOENT;
+  }
+  bool destinationExists(const std::string &path) const {
+    struct stat info{};
+    return ::stat(path.c_str(), &info) == 0;
+  }
+};
+
+// POSIX/FAT can replace a destination with rename; SPIFFS requires moving it
+// aside first. Never truncate the current file while writing its replacement.
+// If the second rename fails, restore the backup (and retain it on disk even
+// when the filesystem also rejects that recovery rename).
+template <typename Operations>
+bool writeFileAtomically(const std::string &path,
+                         const std::vector<std::uint8_t> &bytes,
+                         Operations &files) {
+  const auto temporary = path + ".tmp";
+  auto file = files.open(temporary);
+  if (!file)
+    return false;
+  const bool written = files.write(file, bytes) == bytes.size();
+  const bool closed = files.close(file);
+  if (!written || !closed) {
+    files.remove(temporary);
+    return false;
+  }
+  if (files.move(temporary, path))
+    return true;
+  if (!files.destinationExists(path)) {
+    files.remove(temporary);
+    return false;
+  }
+  const auto backup = path + ".bak";
+  if (!files.remove(backup) || !files.move(path, backup)) {
+    files.remove(temporary);
+    return false;
+  }
+  if (!files.move(temporary, path)) {
+    files.move(backup, path);
+    files.remove(temporary);
+    return false;
+  }
+  files.remove(backup);
+  return true;
+}
+
+} // namespace gea::platform::storage

package/include/platform/file_cache.h

@@ -8,11 +8,14 @@ namespace gea::platform::storage {
 // targets without persistent storage transparently fall back to no caching.
 bool ensureMounted();
 
-// Register the platform's mount provider. A target with persistent storage (e.g.
-// a microSD card) calls this at startup with its mount function. Done via
+// Register the platform's mount provider. A target with persistent storage
+// (e.g. a microSD card) calls this at startup with its mount function. Done via
 // explicit registration rather than a weak symbol so the provider's translation
 // unit is guaranteed to be linked in (see the waveshare-p4-7 sdcard_mount.cpp,
 // wired from app_main).
 void setMountProvider(bool (*provider)());
 
-}  // namespace gea::platform::storage
+// Used by built-in flash storage only when no target-specific provider exists.
+void setFallbackMountProvider(bool (*provider)());
+
+} // namespace gea::platform::storage

package/include/power.h

@@ -6,6 +6,8 @@ class Power {
 public:
 	static bool init();
 	static int batteryPercent();
+	static bool charging();
+	static bool vibrate(double durationMs, int strength);
 };
 
 }  // namespace gea::platform::power

package/include/services/frame_scheduler.h

@@ -65,6 +65,12 @@ public:
 	static int frameIntervalMs();
 	static void setFrameRate(double fps);
 	static double frameRate();
+#if defined(ESP_PLATFORM) && defined(GEA_NATIVE_DEBUGGER) && GEA_NATIVE_DEBUGGER
+	// Debug cap applies to timer, TE and input-driven frames. Application FPS
+	// changes cannot exceed it; zero restores normal scheduling.
+	static void setDebuggerFrameRate(int fps);
+	static int debuggerFrameRate();
+#endif
 	static int nowMs();
 };
 

package/include/wifi.h

@@ -7,61 +7,76 @@
 namespace gea::framework::network {
 
 struct WifiNetwork {
-	std::string ssid;
-	int rssi = 0;
-	bool secured = false;
+  std::string ssid;
+  int rssi = 0;
+  bool secured = false;
 };
 
 class WifiDriver {
 public:
-	virtual ~WifiDriver() = default;
+  virtual ~WifiDriver() = default;
 
-	virtual bool init() = 0;
-	virtual bool enabled() const = 0;
-	virtual void setEnabled(bool enabled) = 0;
-	virtual bool connected() const = 0;
-	virtual int rssi() = 0;
-	virtual std::string ssid() = 0;
-	virtual std::string ip() const = 0;
-	virtual std::string mac() = 0;
-	virtual void configure(const std::string &ssid, const std::string &password) = 0;
-	virtual void scan() = 0;
-	virtual bool scanning() const = 0;
-	virtual int scanCount() const = 0;
-	virtual WifiNetwork networkAt(int index) const = 0;
-	virtual std::vector<WifiNetwork> scanResults() const = 0;
-	virtual void setWebState(bool connected, const char *ssid, const char *ip, int rssi);
-	virtual void setWebScanCount(int count);
-	virtual void setWebScanEntry(int index, const char *ssid, int rssi, bool secured);
+  virtual bool init() = 0;
+  virtual bool enabled() const = 0;
+  virtual void setEnabled(bool enabled) = 0;
+  virtual bool connected() const = 0;
+  virtual int rssi() = 0;
+  virtual std::string ssid() = 0;
+  virtual std::string ip() const = 0;
+  virtual std::string mac() = 0;
+  virtual void configure(const std::string &ssid,
+                         const std::string &password) = 0;
+  virtual bool startAccessPoint(const std::string &, const std::string &) {
+    return false;
+  }
+  virtual void stopAccessPoint() {}
+  virtual std::string accessPointMac() { return {}; }
+  virtual bool startCaptivePortal() { return false; }
+  virtual void stopCaptivePortal() {}
+  virtual void scan() = 0;
+  virtual bool scanning() const = 0;
+  virtual int scanCount() const = 0;
+  virtual WifiNetwork networkAt(int index) const = 0;
+  virtual std::vector<WifiNetwork> scanResults() const = 0;
+  virtual void setWebState(bool connected, const char *ssid, const char *ip,
+                           int rssi);
+  virtual void setWebScanCount(int count);
+  virtual void setWebScanEntry(int index, const char *ssid, int rssi,
+                               bool secured);
 };
 
 class WifiAdapter {
 public:
-	static void setDriver(WifiDriver *driver);
-	static WifiDriver *driver();
+  static void setDriver(WifiDriver *driver);
+  static WifiDriver *driver();
 
-	bool init() const;
-	bool enabled() const;
-	void setEnabled(bool enabled) const;
-	bool connected() const;
-	int rssi() const;
-	std::string ssid() const;
-	std::string ip() const;
-	std::string mac() const;
-	void configure(const std::string &ssid, const std::string &password) const;
-	void scan() const;
-	bool scanning() const;
-	int scanCount() const;
-	WifiNetwork networkAt(int index) const;
-	std::vector<WifiNetwork> scanResults() const;
-	void setWebState(bool connected, const char *ssid, const char *ip, int rssi) const;
-	void setWebScanCount(int count) const;
-	void setWebScanEntry(int index, const char *ssid, int rssi, bool secured) const;
+  bool init() const;
+  bool enabled() const;
+  void setEnabled(bool enabled) const;
+  bool connected() const;
+  int rssi() const;
+  std::string ssid() const;
+  std::string ip() const;
+  std::string mac() const;
+  void configure(const std::string &ssid, const std::string &password) const;
+  bool startAccessPoint(const std::string &ssid,
+                        const std::string &password) const;
+  void stopAccessPoint() const;
+  std::string accessPointMac() const;
+  bool startCaptivePortal() const;
+  void stopCaptivePortal() const;
+  void scan() const;
+  bool scanning() const;
+  int scanCount() const;
+  WifiNetwork networkAt(int index) const;
+  std::vector<WifiNetwork> scanResults() const;
+  void setWebState(bool connected, const char *ssid, const char *ip,
+                   int rssi) const;
+  void setWebScanCount(int count) const;
+  void setWebScanEntry(int index, const char *ssid, int rssi,
+                       bool secured) const;
 };
 
-inline WifiAdapter wifi()
-{
-	return WifiAdapter{};
-}
+inline WifiAdapter wifi() { return WifiAdapter{}; }
 
-}  // namespace gea::framework::network
+} // namespace gea::framework::network