Skip to content

Device_Setup_Guide.md

Latest commit

 

History

History
106 lines (73 loc) · 3.52 KB

Device_Setup_Guide.md

File metadata and controls

106 lines (73 loc) · 3.52 KB
Raw

Haptique Extender (Kincony AG Hub) — Setup Guide

This guide helps you configure the Haptique Extender firmware (KinkonyAGFW) on your Kincony AG Hub and connect it with your Haptique RS90 system.

⚙️ Step 1: Hardware & Requirements

  • Kincony AG Hub (ESP32-based)
  • USB-to-Mini-USB cable
  • Firmware file: bin/Haptique_Kincony_AG_Firmware_V1.Main.bin
  • A computer (Windows/macOS/Linux)

⚡ Step 2: Flash the Firmware

Option A — Flash via Haptique Online Firmware Tool (Recommended)

  1. Open the firmware installer page: https://support.haptique.io/en/firmware/install
  2. Connect the Kincony device to your laptop using a USB cable.
  3. Scroll down and click Connect.
  4. Select the Kincony COM port If unsure — unplug and reconnect the device, then select the new COM port.
  5. Follow the on-screen instructions to flash the firmware.
  6. Open Log View, press Reset Device, and wait for the log output.
  7. Copy the token & IP address displayed — you’ll use them for communication later. 💡 This method requires no software installation and works directly from your browser.

Option B — Using esptool.py (Cross-Platform)

  1. Download and install esptool.py.
  2. Connect your Kincony AG Hub via Mini-USB.
  3. Open a terminal and run: 
    python -m esptool --chip esp32 write-flash 0x0 Haptique_Kincony_AG_Firmware_V1.Main.bin
  4. Wait until flashing completes and the device restarts.

💡 Tip: No external UART adapter is needed — the mini-USB port supports native flashing.

Option C — Using Kincony Flash Tool (Windows)

  1. Download from Kincony Flash Tool page.
  2. Open the tool and select the firmware file:
    bin/Haptique_Kincony_AG_Firmware_V1.Main.bin -> 0x0
  3. Choose the correct COM port, BAUD - 115200 and click Start to flash.
image

⚙️ The Kincony tool provides a simple UI but works on Windows only.

🌐 Step 3: Connect to Device Wi-Fi

  1. Power the device.
  2. Connect your computer/phone to the AP:
    • SSID: HAP_IRHUB
    • Password: 12345678
  3. Open http://192.168.4.1/api/status or http://haptique-extender/api/status in a browser.

📶 Step 4: Configure Wi-Fi

Use a REST client (like curl or Postman) to send:

curl -X POST -H "Content-Type: application/json" -d '{"ssid":"YourWiFi","pass":"YourPass"}' http://192.168.4.1/api/wifi/save

Once connected, find the new IP address in your router’s DHCP list or call /api/status again.

🎯 Step 5: Verify Connection

After successful setup:

  • /api/status → returns device info and IP
  • /api/ir/last → retrieves the last captured IR signal
  • /api/ir/send → transmits a test IR signal

🧠 Troubleshooting

Issue Possible Cause Solution
Hostname not resolving mDNS disabled on router Use device IP instead
POST request fails Wrong content type Use Content-Type: application/json
IR send not working Incorrect format Check JSON body syntax
Wi-Fi fails 5 GHz network Use 2.4 GHz SSID only

🧩 Next Steps

  • Integrate with Haptique Configapp for RS90
  • Contribute improvements via GitHub pull requests
  • Share your feedback on new API features

© 2025 Cantata Communication Solutions — All rights reserved.