{"id":22344956,"url":"https://github.com/seeed-studio/oshw-sensecap-watcher","last_synced_at":"2026-03-04T20:03:55.246Z","repository":{"id":259573441,"uuid":"873960002","full_name":"Seeed-Studio/OSHW-SenseCAP-Watcher","owner":"Seeed-Studio","description":"SenseCAP Watcher: Intelligent ESP32S3-based device with Himax WiseEye2 AI, capable of seeing, hearing, and interacting using advanced AI and the LLM-enabled SenseCraft suite. Perfect for environment-aware applications in automation and security.","archived":false,"fork":false,"pushed_at":"2025-01-08T08:43:57.000Z","size":57415,"stargazers_count":143,"open_issues_count":0,"forks_count":9,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-05-26T00:02:54.497Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.seeedstudio.com/SenseCAP-Watcher-W1-A-p-5979.html","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Seeed-Studio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-17T02:36:35.000Z","updated_at":"2025-05-24T02:24:36.000Z","dependencies_parsed_at":"2025-02-28T07:19:12.349Z","dependency_job_id":null,"html_url":"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher","commit_stats":null,"previous_names":["seeed-studio/oshw-sensecap-watcher"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Seeed-Studio/OSHW-SenseCAP-Watcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Studio%2FOSHW-SenseCAP-Watcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Studio%2FOSHW-SenseCAP-Watcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Studio%2FOSHW-SenseCAP-Watcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Studio%2FOSHW-SenseCAP-Watcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Seeed-Studio","download_url":"https://codeload.github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Studio%2FOSHW-SenseCAP-Watcher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30091581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T19:41:02.502Z","status":"ssl_error","status_checked_at":"2026-03-04T19:40:05.550Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-04T09:15:42.502Z","updated_at":"2026-03-04T20:03:55.223Z","avatar_url":"https://github.com/Seeed-Studio.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eSenseCAP Watcher\u003c/h1\u003e\n\n\u003cimg alt=\"SenseCAP Watcher Readme\" src=\"assets/watcher_banner.png\"\u003e \u003c/img\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://discord.gg/jGWQStEvEp\"\u003e\u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/862602258452578314?label=Join%20Community\"\u003e\u003c/a\u003e\n\u003ca href=\"https://x.com/seeedstudio\" \u003e\u003cimg src=\"https://img.shields.io/twitter/follow/seeedstudio.svg?style=social\" /\u003e \u003c/a\u003e\n\u003cbr\u003e\n\u003ca href=\"https://www.reddit.com/r/Seeed_Studio/submit/?type=TEXT\" target=\"_blank\"\u003e\u003cimg alt=\"Share on Reddit\" src=\"https://img.shields.io/twitter/url?url=https%3A%2F%2Fwww.reddit.com%2Fr%2FSeeed_Studio%2F\u0026style=social\u0026logo=Reddit\u0026label=Reddit\"\u003e\u003c/a\u003e\u0026nbsp;\n\u003ca href=\"https://www.linkedin.com/shareArticle?mini=true\u0026url=https%3A//github.com/Seeed-Studio/OSHW-SenseCAP-Watcher\" target=\"_blank\"\u003e\u003cimg alt=\"Share on LinkedIn\" src=\"https://img.shields.io/twitter/url?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2F1475165%2Fadmin%2Fdashboard%2F\u0026style=social\u0026logo=LinkedIn\u0026label=LinkedIn\"\u003e\u003c/a\u003e\u0026nbsp;\n\u003ca href=\"https://www.facebook.com/sharer/sharer.php?u=https%3A//github.com/Seeed-Studio/OSHW-SenseCAP-Watcher\" target=\"_blank\"\u003e\u003cimg alt=\"Share on Facebook\" src=\"https://img.shields.io/twitter/url?url=https%3A%2F%2Fwww.facebook.com%2Fseeedstudiosz%2F\u0026style=social\u0026logo=Facebook\u0026label=Facebook\"\u003e\u003c/a\u003e\u0026nbsp;\n\u003ca href=\"https://t.me/share/url?text=Awesome%20communication%20engine!\u0026url=https%3A%2F%2Fgithub.com%2FSeeed-Studio%2FOSHW-SenseCAP-Watcher\" target=\"_blank\"\u003e\u003cimg alt=\"Share on Telegram\" src=\"https://img.shields.io/twitter/url?url=https%3A%2F%2Fwww.facebook.com%2Fseeedstudiosz%2F\u0026style=social\u0026logo=Telegram\u0026label=Telegram\"\u003e\u003c/a\u003e\u0026nbsp;\n\u003ca href=\"https://wa.me/?text=Awesome%20communication%20engine!%5Cn%20https%3A%2F%2Fgithub.com%2FSeeed-Studio%2FOSHW-SenseCAP-Watcher\" target=\"_blank\"\u003e\u003cimg alt=\"Share on Whatsapp\" src=\"https://img.shields.io/twitter/url?url=https%3A%2F%2Fwww.facebook.com%2Fseeedstudiosz%2F\u0026style=social\u0026logo=Whatsapp\u0026label=Whatsapp\"\u003e\u003c/a\u003e\u0026nbsp;\n\u003ca href=\"mailto:?subject=Awesome%20Physical%20AI%20Agent\u0026body=Checkout%20this%20awesome%20physical%20ai%20agent%3A%0Ahttps%3A//github.com/Seeed-Studio/OSHW-SenseCAP-Watcher\" target=\"_blank\"\u003e\u003cimg alt=\"Share on Mail\" src=\"https://img.shields.io/twitter/url?url=https%3A%2F%2Fwww.facebook.com%2Fseeedstudiosz%2F\u0026style=social\u0026logo=GMail\u0026label=GMail\"\u003e\u003c/a\u003e\n\u003cbr\u003e\n\u003ca href=\"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/stargazers\"\u003e\u003cimg alt=\"GitHub Repo stars\" src=\"https://img.shields.io/github/stars/Seeed-Studio/OSHW-SenseCAP-Watcher\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/network/members\"\u003e\u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/Seeed-Studio/OSHW-SenseCAP-Watcher\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/pulls\"\u003e\u003cimg alt=\"GitHub Pull Requests\" src=\"https://img.shields.io/github/issues-pr/Seeed-Studio/OSHW-SenseCAP-Watcher?label=pull%20request\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/issues\"\u003e\u003cimg alt=\"GitHub Issues\" src=\"https://img.shields.io/github/issues/Seeed-Studio/OSHW-SenseCAP-Watcher\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/graphs/contributors\"\u003e\u003cimg alt=\"GitHub contributors\" src=\"https://img.shields.io/github/contributors/Seeed-Studio/OSHW-SenseCAP-Watcher\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/blob/main/LICENSE\"\u003e\u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/Seeed-Studio/OSHW-SenseCAP-Watcher\"\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n## :grinning: Introduction\n\nSenseCAP Watcher is built on ESP32S3, incorporating a Himax WiseEye2 HX6538 AI chip with Arm Cortex-M55 \u0026 Ethos-U55, excelling in image and vector data processing. Equipped with a camera, microphone, speaker, SenseCAP Watcher can see, hear, talk. Plus, with LLM-enabled SenseCraft suite, SenseCAP Watcher understands your commands, perceives its surroundings, and triggers actions accordingly.\n\n[![Watcher Introduction](https://img.youtube.com/vi/ny22Z0cAIqE/0.jpg)](https://www.youtube.com/watch?v=ny22Z0cAIqE)\n\n## :smile: Table of Open Source Material\n\n- [📁 Firmwave](./Firmware/): Watcher's factory firmware bin files.\n\n    - [ ESP32](./Firmware/ESP32/): SenseCAP Watcher ESP32 main chip firmware.\n\n    - [ Himax](./Firmware/Himax/): SenseCAP Watcher Himax AI Chip firmware.\n\n- [📁 Hardware](./Hardware/): Open source hardware documentation available for Watcher.\n\n    -[📎 SenseCAP Watcher v1.0 Schematic](./Hardware/SenseCAP_Watcher_v1.0_SCH.pdf)\n\n    -[📎Espressif ESP32-S3 Datasheet](./Hardware/esp32-s3_datasheet.pdf)\n\n    -[📎Himax HX6538-A Datasheet](./Hardware/HX6538_datasheet.pdf)\n\n- [📁 Documentation](./Documentation/): All Wiki documents about Watcher.\n\n- [📁 Applications](./Applications/): Application projects using SenseCAP Watcher will be continuously updated.\n\n- [📁 assets](./assets/): Image material used in the README.\n\n\n## :wink: SenseCAP Watcher Quick Start Guide\n\n### :point_right: Must-Do\n\nBefore using Watcher as a space assistant, we must ensure that the following three steps are performed successfully, which is the basis for all subsequent steps.\n\n#### :point_right: Step 1. Installation Packaging\n\nThe Watcher comes with a unique packaging that doubles as a stylish, calendar-like stand. By placing the Watcher inside this stand, you can create an attractive decoration for your home. Follow the step-by-step instructions below and refer to the accompanying video for a visual guide on how to install your Watcher in its stand.\n\nhttps://files.seeedstudio.com/wiki/watcher_getting_started/watcher-packaging.mp4\n\n#### :point_right: Step 2. Power On\n\nTo power on your Watcher device, press and hold the wheel button located on the upper right corner for approximately 3 seconds until the Seeed Studio logo appears on the screen.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./assets/power_on.gif\" width=\"550\" /\u003e\n\u003c/div\u003e\n\nOnce the logo is displayed, release the button and allow the device to complete its initialization process. After a few moments, the Watcher will display its main menu, indicating that it is ready for use.\n\n**If the device won't turn on with a long press, the device may be low on power and you may need to connect a cable to power it up before you can wake up the Watcher.**\n\n#### :point_right: Step 3. Device Binding\n\n**[SenseCraft Pro](https://wiki.seeedstudio.com/watcher_price/) will automatically activate the trial service when your device is tethered to the SenseCraft APP.**\n\nAfter powering on your Watcher, if it has not been previously bound to a device, it will prompt you to connect to the SenseCraft app. Alternatively, you can find the \"Connect to APP\" option in the Settings menu. The Watcher will then display a QR code to download the SenseCraft app.\n\nYou can either scan the QR code or use the provided link to download the app.\n\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://sensecraft-app-download.seeed.cc\"\u003e\n        \u003cstrong\u003e\u003cspan\u003eDownload APP 🖱️\u003c/span\u003e\u003c/strong\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\nTo proceed with binding your Watcher to the SenseCraft app, follow these steps:\n\n**1.** On your Watcher, rotate the wheel button clockwise to enter the QR code interface for binding the device.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/1.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\n**2.** Open the SenseCraft app on your mobile device and tap the plus sign (+) in the top right corner to add your Watcher by scanning the QR code.\n\n**Ensure that your mobile device's Bluetooth permissions are enabled, as the binding process requires a Bluetooth connection.**\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/2.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\n**3.** After successfully scanning the QR code, the app will navigate to the network configuration page. Select a 2.4GHz Wi-Fi network to connect your Watcher to the internet.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/3.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\nTap the \"Next\" button to proceed.\n\n**4.** Choose a name for your Watcher and select an appropriate group for it.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/4.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\nTap the \"Finish\" button to complete the setup process.\n\n**5.** The SenseCraft app will display a tutorial page, providing guidance on how to use your Watcher. Take a moment to familiarize yourself with the instructions.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/5.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\nOnce the setup is complete, the app will open a chat window to communicate with your Watcher, while the Watcher will return to its main menu.\n\nWith the binding process finished, your Watcher is now connected to the SenseCraft app, and you can start exploring its features and capabilities. The app serves as a convenient way to interact with your Watcher, adjust settings, and receive notifications remotely.\n\n### :point_right: Schedule a task for Watcher\n\nNext, select the method you want to use to schedule an executable task for Watcher.\n\n#### :point_right: Built-in task templates\n\nTo run a task from the Task Templates on your Watcher, follow these steps:\n\n**1.** From the main menu, use the wheel button to navigate to the **Task Templates** option.\n\n**2.** Press the wheel button to enter the Task Templates submenu.\n\n**3.** Scroll through the available task templates using the wheel button until you find the desired model task.\n\n**4.** Press the wheel button to select and start running the chosen task.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./assets/run_template.gif\" width=\"550\" /\u003e\n\u003c/div\u003e\n\nOnce the task begins, the Watcher will display an animated emoji face on the screen. This emoji indicates that the device is actively monitoring for the target object specified by the selected task template.\n\nWhen the Watcher detects the target object, the display will switch from the emoji animation to a real-time view of the detected object. This allows you to see what the Watcher has identified.\n\nIf the target object moves out of the Watcher's view or is no longer detected, the display will automatically return to the animated emoji face, signifying that the device is still monitoring for the target.\n\nTask Templates:\n\n- :red_haired_man: Human Detection:\n\n   - This task template is designed to detect the presence of human beings.\n\n   - When the Watcher identifies a **person**, it will trigger an alarm notification.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/task-temp-people-detected.png\" width=\"180\" /\u003e\n\u003c/div\u003e\n\n- :smirk_cat: Pet Detection:\n\n   - The Pet Detection task template focuses on recognizing cats or dogs.\n\n   - If the Watcher detects a **cat**, it will trigger an alarm notification.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/task-temp-pet.png\" width=\"180\" /\u003e\n\u003c/div\u003e\n\n- :vulcan_salute: Gesture Detection:\n\n   - This task template is configured to identify the \"paper\" hand gesture.\n\n   - When the Watcher recognizes the **paper gesture**, it will trigger an alarm notification.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/task-temp-gesture.png\" width=\"180\" /\u003e\n\u003c/div\u003e\n\nEach of these task templates has specific alarm triggering conditions based on the detection of their respective targets: humans, cats, or the paper gesture. By using these templates, you can quickly set up the Watcher to monitor for the desired object without the need for extensive configuration.\n\n#### :point_right: Through the APP\n\n**Fees may apply for using some of SenseCraft AI's services, please refer to the documentation below for details: [SenseCraft AI for Watcher Plans and Benefits](https://wiki.seeedstudio.com/watcher_price/)**\n\nThe SenseCraft APP allows you to send Tasks to your Watcher device. In this example, we will demonstrate the process of sending a task using one of the sample tasks provided by Watcher. Let's use the command *If you see a candles, please notify me*.\n\n**1.** Open the SenseCraft APP and navigate to the chat window for your connected Watcher device.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/6.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\n**2.** In the chat window, either select the desired task from the available options or manually type in the command *If you see a candles, please notify me*. Send the command to your Watcher by tapping the send button or pressing enter.\n\n**3.** Upon receiving the command, Watcher will interpret it and break it down into a task flow consisting of **When**, **Do**, and **Capture Frequency** components.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/7.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\nReview the parsed task flow to ensure that Watcher has correctly understood your command. The app will display the interpreted task details for your verification. If any part of the task flow does not align with your intended command, you can modify the task details by accessing the **Detail Config** section within the app.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/8.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\n**4.** Once you have confirmed or adjusted the task details, click the **Run** button to send the finalized task to your Watcher.\n\nWatcher will download the task instructions, and once the download is complete, it will transform into a vigilant monitoring system, ready to detect any instances of candles.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/9.svg\" width=\"600\" /\u003e\n\u003c/div\u003e\n\n**5.** If Watcher identifies a candles, it will send an alert based on the predefined settings, which may include flashing lights, audible alarms, and notifications through the SenseCraft APP.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./assets//10.svg\" width=\"400\" /\u003e\n\u003c/div\u003e\n\n\n**Please note that due to the time constraints of the task flow, there will be a minimum interval between consecutive alerts to avoid excessive notifications**.\n\nBy following these steps, you can effectively send commands to your Watcher using the SenseCraft APP, enabling it to perform specific monitoring tasks and notify you when the specified conditions are met.\n\nRemember to regularly review and adjust your Watcher's settings and task flows to ensure optimal performance and alignment with your monitoring requirements. For a more detailed description and explanation of the APP's tasks and options, as well as a detailed description of the intervals, please read **[Watcher Task Assignment Guideline](https://wiki.seeedstudio.com/getting_started_with_watcher_task/)** to learn more.\n\n#### :point_right: By Voice\n\n**Fees may apply for using some of SenseCraft AI's services, please refer to the documentation below for details: [SenseCraft AI for Watcher Plans and Benefits](https://wiki.seeedstudio.com/watcher_price/)**\n\nThe Watcher offers a convenient and intuitive way to send tasks or engage in conversation using voice commands, thanks to its \"Push to Talk\" feature. This functionality is accessible from any screen or interface on the device, making it easy to interact with the Watcher without navigating through menus. Here's a step-by-step guide on how to use this feature:\n\n1. Activate Push to Talk:\n\n   - Locate the Wheel Button on the top-right corner of the Watcher.\n   - Press and hold the Wheel Button to enter the voice input interface.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./assets/push_to_talk.gif\" width=\"550\" /\u003e\n\u003c/div\u003e\n\n2. Speak Your Command or Message:\n\n   - While holding the Wheel Button, clearly speak your task or message to the Watcher.\n   - You can assign tasks, such as \"Tell me if the baby is crying\" or \"If the dog is stealing food, say stop Copper\". (Copper is the name of my dog.)\n\n3. Release the Wheel Button:\n\n   - Once you have finished speaking, release the Wheel Button.\n   - The Watcher will process your voice input and determine whether it is a task assignment.\n\n4. Task Assignment:\n\n   - If the Watcher recognizes your voice input as a task assignment, it will automatically break down your task into relevant components.\n   - The Watcher will display cards on its screen, showing the **Object** (what to monitor), **Behavior** (what action to look for), **Notification** (how to alert you), **Time Range** (when to monitor), and **Frequency** (how often to monitor).\n   - Review the displayed information to ensure it accurately represents your intended task.\n   - If the details are correct, confirm the task, and the Watcher will begin executing it according to the specified parameters.\n   - If Watcher misunderstands your task, long press the scroll wheel button and you can continue through the dialogue to try to correct Watcher's understanding of the task. If you still can't understand it correctly after several attempts, we recommend that you use the SenseCraft APP to place the task.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/80.jpg\" width=\"500\" /\u003e\n\u003c/div\u003e\n\nTips for Optimal Usage:\n\n- Speak clearly and at a moderate pace to ensure accurate voice recognition.\n- When speaking, please get as close to Watcher as possible, about **3 ~ 10cm** distance speaking recognition accuracy is best.\n- Minimize background noise to improve the Watcher's ability to understand your voice commands.\n- Be specific and concise when assigning tasks to help the Watcher accurately interpret your intentions.\n\nBy leveraging the Push to Talk feature, you can effortlessly send tasks and engage in conversations with the Watcher, making your interaction with the device more natural and efficient.\n\n**If you encounter an error of **0x7002**, it means that the current Watcher's network status is not good and the audio service call failed, please change the network or location and retry again.**\n\n\n### :point_right: To end a running task\n\n1. Tap the screen once or press the wheel button.\n\n2. A confirmation popup will appear with two options: **Main Menu** and **End Task**. To terminate the task, either tap **End Task** on the screen or use the scroll wheel to navigate to \"End Task\" and press the scroll wheel button to confirm.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/end_task.png\" width=\"180\" /\u003e\n\u003c/div\u003e\n\n3. Alternatively, you can end the task via the SenseCraft APP on your mobile device by pressing the **End** button on the task card.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/end-task-phone.png\" width=\"200\" /\u003e\n\u003c/div\u003e\n\n\n## :kissing: Flash Firmware\n\nWhen you download the firmware for SenseCAP Watcher, you will notice that it comes with two different firmwares, so keep an eye out for the distinction.\n\n1. ESP32 Firmware\n\n2. Himax Firmware\n\n### :point_right: For ESP32 Firmware\n\n**Please be especially careful with the partition address of the flash firmware to avoid incorrectly erasing the SenseCAP Watcher's own device information (EUI, etc.), otherwise the device may not be able to connect to the SenseCraft server properly! Please make a note of the necessary information about the device before flashing the firmware to ensure that there is a way to recover it!**\n\nYou will see these messages when the device is powered up and switched on.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./assets/production_information.png\" width=\"600\" /\u003e\n\u003c/div\u003e\u003cbr\u003e\n\n**Please also keep your information about these devices safe to avoid losing them!**\n\nIf you are using Linux/MacOS, you can flash Watcher's firmware using the command line.\n\nYou can use the following two commands to complete the ESP32 firmware flash.\n\n```\npip3 install --upgrade esptool\n \nesptool.py --chip esp32s3 -b 2000000 --before default_reset --after hard_reset write_flash --flash_mode dio --flash_size 32MB --flash_freq 80m 0x0 bootloader/bootloader.bin 0x8000 partition_table/partition-table.bin 0x10d000 ota_data_initial.bin 0x110000 factory_firmware.bin 0x1910000 srmodels/srmodels.bin 0x1a10000 storage.bin\n```\n\nIf you are using Windows, you can use [esptool](https://www.espressif.com/sites/default/files/tools/flash_download_tool_3.9.6.zip).\n\nYou will need to flash 5 firmware for the SenseCAP Watcher and you will find two serial ports (one for esp32, another for himax) when the Watcher is connected to the computer. **The serial port for flash memory could be any of these**.\n\nOpen esptool and select the MCU model:\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./assets/esptool-mcu.png\" width=\"200\" /\u003e\n\u003c/div\u003e\u003cbr\u003e\n\nFollow the diagram below to enter the correct address and select the correct firmware.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./assets/esptool-flasher.png\" width=\"600\" /\u003e\n\u003c/div\u003e\u003cbr\u003e\n\n**If you find that there is no progress when flashing, then the wrong flash serial port may be selected and you may need to switch to another one.**\n\n### :point_right: For Himax Firmware\n\n**We do not recommend that any user make any kind of modifications to the Himax firmware. The methods we provide are limited to use for restoring the firmware in special cases.**\n\nNext, you need to switch to another serial port, which is the serial port of the Himax chip, please operate the Himax chip under this serial port.\n\nMake sure your Python version is above 3.8.\n\nExecute the following commands to install python-sscma and finish burning the firmware and model. Models only support model files that are supported in SenseCraft AI.\n\n```\npip3 install python-sscma\n\nsscma.cli flasher -f firmware.img\n```\n\n\n## :dragon_face: Quick Build SenseCAP Watcher ESP32's Firmware\n\nSenseCAP Watcher source repository address:\n\n```\nhttps://github.com/Seeed-Studio/SenseCAP-Watcher-Firmware\n```\n\nThe project provides basic SDK for the SenseCAP Watcher, as well as the examples for getting started. It is based on the [ESP-IDF](https://github.com/espressif/esp-idf).\n\n### :point_right: Getting Started\n\n#### :point_right: Install ESP IDF\n\nFollow instructions in this guide\n[ESP-IDF - Get Started](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html)\nto setup the built toolchain used by SSCMA examples. Currently we're using the latest version `v5.1`.\n\n#### :point_right: Clone and Setup the Repository\n\n1. Clone our repository.\n\n    ```sh\n    git clone https://github.com/Seeed-Studio/SenseCAP-Watcher\n    ```\n\n2. Go to `SenseCAP-Watcher` folder.\n\n    ```sh\n    cd SenseCAP-Watcher\n    ```\n\n3. Fetch the submodules.\n\n    ```sh\n    git submodule update --init\n    ```\n\n#### :point_right: Build and Run Examples\n\n1. Go to examples folder and list all available examples.\n\n    ```sh\n    cd examples \u0026\u0026 \\\n    ls\n    ```\n\n2. Choose a `factory_firmware` and enter its folder.\n\n    ```sh\n    cd factory_firmware\n    ```\n\n3. Generate build config using ESP-IDF.\n\n    ```sh\n    # set build target\n    idf.py set-target esp32s3\n    ```\n\n4. Build the demo firmware.\n\n    ```sh\n    idf.py build\n    ```\n\n5. Flash the demo firmware to device and Run.\n\n    To flash (the target serial port may vary depend on your operating system, please replace `/dev/ttyACM0` with your device serial port).\n\n    ```\n    idf.py --port /dev/ttyACM0 flash\n    ```\n\n    Monitor the serial output.\n\n    ```\n    idf.py --port /dev/ttyACM0 monitor\n    ```\n\n##### :point_right: Tip\n\n- Use `Ctrl+]` to exit monitor.\n\n- The previous two commands can be combined.\n\n    ```sh\n    idf.py --port /dev/ttyACM0 flash monitor\n    ```\n\n## :dizzy: Table of Wiki Documentation\n\nIntroducing the Watcher Product Catalogue, your comprehensive guide to setting up, using, and maintaining your Watcher device. Discover the key features, customization options, and mounting possibilities that make Watcher the perfect monitoring solution. With detailed instructions, troubleshooting tips, and specifications, this catalogue empowers you to fully utilize your Watcher and experience peace of mind through advanced surveillance technology.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://files.seeedstudio.com/wiki/watcher_getting_started/Infrastructure.png\" width=\"800\" /\u003e\n\u003c/div\u003e\n\n- :open_book: [Quick start guide](https://wiki.seeedstudio.com/getting_started_with_watcher/)\n\n- :open_book: [Price and benefits](https://wiki.seeedstudio.com/watcher_price/)\n\n- :open_book: [Product Overview](http://wiki.seeedstudio.com/product_overview_with_watcher/)\n\n    - [Hardware Overview](http://wiki.seeedstudio.com/watcher_hardware_overview/)\n\n    - [Operation Guideline](http://wiki.seeedstudio.com/watcher_operation_guideline/)\n\n    - [Task Assignment Guideline](http://wiki.seeedstudio.com/getting_started_with_watcher_task/)\n\n- :open_book: [Software Framework Overview](http://wiki.seeedstudio.com/watcher_software_framework_overview/)\n\n    - [SenseCraft APP Introduction](http://wiki.seeedstudio.com/sensecap_app_introduction/)\n\n    - [Watcher Software Service Introduction](http://wiki.seeedstudio.com/watcher_software_service_framework/)\n\n    - [Deploy Watcher's AI Capabilities Locally](http://wiki.seeedstudio.com/watcher_local_deploy/)\n\n- :open_book: [Notification](http://wiki.seeedstudio.com/notifications_with_watcher_main_page/)\n\n    - [UART Output](http://wiki.seeedstudio.com/uart_output/)\n\n    - [HTTP Proxy Notification](http://wiki.seeedstudio.com/http_proxy_notification/)\n\n        - [Smart Home](http://wiki.seeedstudio.com/smart_main_page/)\n\n            - [Integrate Watcher to Home Assistant](http://wiki.seeedstudio.com/integrate_watcher_to_ha/)\n\n        - [Node-RED Integration](http://wiki.seeedstudio.com/notification_with_watcher/)\n\n            - [Watcher to Node-RED](http://wiki.seeedstudio.com/watcher_to_node_red/)\n\n            - [Watcher \u0026 Node-RED to IFTTT](http://wiki.seeedstudio.com/watcher_node_red_to_ifttt/)\n\n            - [Watcher \u0026 Node-RED to Kafka](http://wiki.seeedstudio.com/watcher_node_red_to_kafka/)\n\n            - [Watcher \u0026 Node-RED to Open Interpreter](http://wiki.seeedstudio.com/watcher_node_red_to_open_interpreter/)\n\n            - [Watcher \u0026 Node-RED to P5JS](http://wiki.seeedstudio.com/watcher_node_red_to_p5js/)\n\n            - [Watcher \u0026 Node-RED to Telegram](http://wiki.seeedstudio.com/watcher_node_red_to_telegram/)\n\n            - [Watcher \u0026 Node-RED to Twilio](http://wiki.seeedstudio.com/watcher_node_red_to_twilio/)\n\n            - [Watcher \u0026 Node-RED to Discord](http://wiki.seeedstudio.com/watcher_node_red_to_discord/)\n\n            - [Watcher \u0026 Node-RED to MongoDB](http://wiki.seeedstudio.com/watcher_node_red_to_mongodb/)\n\n            - [Watcher \u0026 Node-RED to WhatsApp](http://wiki.seeedstudio.com/watcher_node_red_to_whatsapp/)\n\n- :open_book: [Application](http://wiki.seeedstudio.com/applications_with_watcher_main_page/)\n\n    - [Use Case](http://wiki.seeedstudio.com/use_case/)\n\n    - [Development](http://wiki.seeedstudio.com/development/)\n\n        - [Traning Model For Watcher](http://wiki.seeedstudio.com/training_model_for_watcher/)\n\n\n\n## :sunglasses: License\n\nThis project is licensed under the Apache License, Version 2.0 (the \"License\");\n\nYou may not use this file except in compliance with the License.\n\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and limitations under the License.\n\nPlease see the [LICENSE](./LICENSE) file for more details.\n\n---\n\n## :hugs: Thank you all!![![](https://raw.githubusercontent.com/aregtech/areg-sdk/master/docs/img/pin.svg)](#thank-you)\n\nSpecial thanks to all contributors and supporters that starred this repository.\n\n**Our amazing contributors**:\n\n\u003ca href=\"https://github.com/Seeed-Studio/SenseCAP-Watcher-Firmware/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=Seeed-Studio/SenseCAP-Watcher-Firmware\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=Seeed-Studio/OSHW-SenseCAP-Watcher\" /\u003e\n\u003c/a\u003e\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\nDo you like this project? Please join us or [give](https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher) a ⭐. This will help to attract more contributors.\n\nDo you have an idea or found a bug? Please open an [issue](https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/issues/new/choose) or start a [discussion](https://github.com/Seeed-Studio/OSHW-SenseCAP-Watcher/discussions).\n\n\n**Follow us** at\u003cbr /\u003e\n\n\u003ca href=\"https://discord.gg/jGWQStEvEp\"\u003e\u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/862602258452578314?label=Join%20Community\"\u003e\u003c/a\u003e\n\u003ca href=\"https://x.com/seeedstudio\" \u003e\u003cimg src=\"https://img.shields.io/twitter/follow/seeedstudio.svg?style=social\" /\u003e \u003c/a\u003e\n[![Follow us on LinkedIn](https://img.shields.io/badge/LinkedIn-seeedstudio-blue?style=flat\u0026logo=linkedin\u0026logoColor=b0c0c0\u0026labelColor=363D44)](https://www.linkedin.com/company/seeedstudio/)\n\n\n\u003cdiv align=\"right\"\u003e[ \u003ca href=\"#grinning-introduction\"\u003e↑ Back to top ↑\u003c/a\u003e ]\u003c/div\u003e\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseeed-studio%2Foshw-sensecap-watcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseeed-studio%2Foshw-sensecap-watcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseeed-studio%2Foshw-sensecap-watcher/lists"}