Clove v1.0.0

Initial Release

This is the initial public release of CLOVE, an Android framework engineered to streamline application development and seamlessly bridge communication with embedded systems. This production baseline comes equipped with our core system capabilities, including an AI-assisted dashboard design framework, automated zero-CORS configuration wrappers, and high-performance, plug-and-play modules built to abstract underlying hardware operations for Bluetooth Classic, BLE, Wi-Fi, and local USB serial devices. For absolute application installation instructions and local asset deployment guidelines, please read the primary README.md file.

Predefined Methods

All methods listed below are introduced as core baseline features for this initial production release. From the next release onward, modifications will be marked based on a direct comparison between the immediate previous release and the current build, using the inline labels $\textcolor{#2ea44f}{\text{[ADDED]}}$, $\textcolor{#2563eb}{\text{[UPDATED]}}$, $\textcolor{#d97706}{\text{[DEPRECATED]}}$, and $\textcolor{#dc2626}{\text{[REMOVED]}}$ to highlight structural changes.

Root Level Core Methods

• Clove.ready()
• Clove.connectIoT(config, callback)

Clove.device (System Analytics)

• Clove.device.info()

Clove.network (Connectivity Mapping)

• Clove.network.status()

Clove.storage (Local Storage)

• Clove.storage.get(key)
• Clove.storage.set(key, value)
• Clove.storage.remove(key)
• Clove.storage.clear()

Clove.file (Sandbox File System)

• Clove.file.write(path, data)
• Clove.file.read(path, options)
• Clove.file.exists(path)
• Clove.file.remove(path)
• Clove.file.open(path, mimeType)
• Clove.file.getAssetURL(path)

Clove.http (Network Pipelines)

• Clove.http.request(options)
• Clove.http.get(url, options)
• Clove.http.post(url, data, options)
• Clove.http.put(url, data, options)
• Clove.http.patch(url, data, options)
• Clove.http.delete(url, options)
• Clove.http.setHeader(host, header, value)
• Clove.http.setDataSerializer(serializer)

Clove.notification (User Experience Feedback)

• Clove.notification.alert(msg, title, btn)
• Clove.notification.confirm(msg, title, btns)
• Clove.notification.prompt(msg, title, btns, defText)
• Clove.notification.beep(times)
• Clove.notification.vibrate(ms)

Clove.bluetooth (Bluetooth Classic SPP)

• Clove.bluetooth.list()
• Clove.bluetooth.discoverUnpaired()
• Clove.bluetooth.connect(address)
• Clove.bluetooth.disconnect()
• Clove.bluetooth.write(data)
• Clove.bluetooth.read()
• Clove.bluetooth.readUntil(delimiter)
• Clove.bluetooth.subscribe(delimiter, callback)
• Clove.bluetooth.unsubscribe()
• Clove.bluetooth.isConnected()
• Clove.bluetooth.isEnabled()
• Clove.bluetooth.enable()

Clove.ble (Bluetooth Low Energy GATT)

• Clove.ble.scan(services, seconds)
• Clove.ble.stopScan()
• Clove.ble.connect(id)
• Clove.ble.disconnect(id)
• Clove.ble.read(id, serviceUuid, characteristicUuid)
• Clove.ble.write(id, serviceUuid, characteristicUuid, data)
• Clove.ble.writeWithoutResponse(id, serviceUuid, characteristicUuid, data)
• Clove.ble.startNotification(id, serviceUuid, characteristicUuid, callback)
• Clove.ble.stopNotification(id, serviceUuid, characteristicUuid)
• Clove.ble.isEnabled()

Clove.wifi (Wi-Fi Infrastructure Linkages)

• Clove.wifi.getSSID()
• Clove.wifi.getIP()
• Clove.wifi.list()
• Clove.wifi.connect(ssid, pass, algo, hid)
• Clove.wifi.disconnect()
• Clove.wifi.isEnabled()

Clove.usb (Wired Serial Interfaces)

• Clove.usb.requestPermission(options)
• Clove.usb.open(options)
• Clove.usb.close()
• Clove.usb.write(data)
• Clove.usb.read(callback)

Clove.camera (Image Captures)

• Clove.camera.getPicture(options)

Clove.geolocation (Spatial Tracking)

• Clove.geolocation.getCurrentPosition(options)
• Clove.geolocation.watchPosition(callback, options)
• Clove.geolocation.clearWatch(watchId)

Clove.mqtt (Asynchronous Pub/Sub Client)

• Clove.mqtt.connect(options)
• Clove.mqtt.disconnect()
• Clove.mqtt.publish(topic, payload, options)
• Clove.mqtt.subscribe(topic, callback, options)
• Clove.mqtt.unsubscribe(topic)

System Compatibility

• Android Environment: Optimized for Android 8.0 (API Level 26) and above. Requires standard system permissions for Bluetooth, Location (for BLE scanning), and USB Host capabilities.
• Supported IoT Hardware: Out-of-the-box compatibility with any embedded system or micro-controller utilizing standard protocols, including:
  • Espressif Ecosystem: ESP32, ESP8266 (Wi-Fi / BLE / Bluetooth Classic)
  • Arduino & Modules: Arduino Uno, Nano, Mega paired with HC-05/HC-06 or HM-10 chips
  • Single Board Computers: Raspberry Pi 4/5, Raspberry Pi Pico W
  • Wired Serial Devices: Devices using CH340, CP210X, or FTDI USB-to-TTL hardware bridges