-
Notifications
You must be signed in to change notification settings - Fork 1
Getting Started
This guide installs a prebuilt NAMO firmware image, connects one device to Wi-Fi, and opens its local dashboard. It does not cover building the hardware, compiling firmware, floorplan setup, or multi-device pairing.
Prepare the following:
- A completed NAMO device using a Seeed Studio XIAO ESP32S3 with 8 MB Flash and 8 MB PSRAM
- An LD2450-series radar connected to the reference pins
- A data-capable USB cable
- Chrome or Edge on a computer that can use Web Serial
- A password-protected 2.4 GHz Wi-Fi network
- A phone or computer that can connect to the temporary NAMO setup network
The LD2410C, PIR, light, temperature, and humidity sensors are optional. NAMO can be set up without them, but the features provided by missing sensors will not be available.
[photo]
Open NAMO Releases and download:
namo-v<version>-factory.bin
Use the factory image only for the first USB installation. The ota image is for updating a NAMO device that is already running.
When checksums are provided with the release, compare the downloaded file with checksums.txt before installing it.
- Connect the XIAO ESP32S3 to the computer with a data-capable USB cable.
- Open ESPHome Web in Chrome or Edge.
- Select Connect and choose the XIAO serial port.
- Select Install.
- Choose the downloaded
namo-v<version>-factory.binfile. - Wait until writing and verification finish.
- Disconnect and reconnect USB power if the device does not restart automatically.
Do not unplug the device while the firmware is being written.
[photo]
After the first boot, NAMO starts a temporary setup Wi-Fi network. Its name begins with presence-sensor or is shown as a Presence Sensor setup network.
Connect your phone or computer to that network with this password:
psensor7777
The setup network does not provide internet access. If the operating system suggests disconnecting or switching networks, choose to remain connected.
Open this address in a browser:
http://192.168.4.1/setup
[photo]
- Wait for the nearby Wi-Fi list to appear.
- Select your Wi-Fi network, or enter its name manually if it is not listed.
- Enter the Wi-Fi password.
- Select Connect.
Open Wi-Fi networks are not supported. The password must contain between 8 and 63 characters.
NAMO checks the connection before storing it. Keep the setup page open while this is in progress. A normal connection may take several seconds, and the setup network can briefly become unstable while NAMO scans or changes Wi-Fi state.
During initial setup, NAMO creates a device-specific ESPHome API security key. Copy it when the setup page displays it and store it in a secure place.
You will need this key when adding the device to Home Assistant. The key is not your Wi-Fi password and should not be posted in screenshots, issue reports, or public configuration files.
If the device already has an API key, the setup page keeps the existing key instead of replacing it.
[photo]
When Wi-Fi setup succeeds, the setup page displays the device IP address.
- Reconnect your phone or computer to the same home Wi-Fi network used by NAMO.
- Select Open dashboard, or enter the displayed address in a browser.
The dashboard address uses this form:
http://<device-ip>/dashboard
The device also advertises an mDNS name similar to presence-sensor-aabbcc.local. .local addresses generally work most consistently on macOS and iOS, but may fail on Windows or some Android devices, browsers, and networks. This does not indicate a device fault; use the IP address shown by the setup page or router instead.
If the dashboard asks how the device will be integrated, choose the option that matches your installation and follow the on-screen handoff. Home Assistant users should keep the API key copied in the previous step.
[photo]
- The dashboard shows the device as connected.
- Firmware and dashboard versions are visible.
- Wi-Fi signal information appears under device status.
- The radar map responds when the LD2450 detects a target.
A floorplan is not required for standalone radar detection. You can create or upload one later to use rooms, shared coordinates, and multi-device fusion.
Confirm that the phone or computer is still connected to the NAMO setup network, then open http://192.168.4.1/setup again. Disable mobile-data auto-switching temporarily if the phone keeps leaving the network because it has no internet access.
Select Refresh. The setup connection may briefly drop during a new scan; reconnect to the NAMO setup network if prompted.
Check the network name and password, then try again. NAMO supports password-protected 2.4 GHz Wi-Fi and rejects open networks.
Reconnect the phone or computer to the home Wi-Fi first. Use the IP address shown by the setup page, or find the presence-sensor device in the router's client list.
Confirm that the USB cable supports data, try another USB port, and close programs that may already be using the serial port.
Caution
Never expose a NAMO device directly to the public internet. Do not publish the NAMO dashboard or API through router port forwarding, DMZ, a public IP address, a public reverse proxy, or an internet tunnel. Adding HTTPS does not make direct device exposure safe. For remote access, keep every NAMO address private and use a VPN that connects to the trusted local network. See Network and security for the complete configuration policy.
- Use a different ESPHome API key for every NAMO device.
- Keep NAMO on a trusted local network.
- Do not redistribute firmware built with personal Wi-Fi information or private signing keys.