Skip to content

Publish via CloudCannon #678

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 30, 2025
Merged

Publish via CloudCannon #678

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions docs/products/btn1/setup/getting-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,18 +6,26 @@ description: Step by step guide to getting started with your BTN-1!

This will guide you through adding on switches and keycaps to your BTN-1 then adding it to your Wi-Fi and Home Assistant!

### Installing Brown Switches
### Physical Setup

###### Installing Brown Switches

1\. Line up the two gold pins with the holes on your BTN-1, then press down gently. Be careful, as the pins can bend or get damaged if too much force is used.

![](../../../assets/btn-1-install-switches-gif.webp)

### Installing Keycaps
###### Installing Keycaps

1\. Line up the + on the keycap with the + on the top of the switch you installed. It may require a little pressure, but it should press on smoothly. Once placed, lightly tap to ensure the keycap is fully seated.

![](../../../assets/btn-1-getting-started-installing-keycaps-gif.webp)

###### Flip Power Switch

**1\.** Ensure the power switch is **turned on**. ** ** Because the BTN-1 includes a battery, it must have a physical on/off switch. When the device is on its side, flipping the switch **away from you** turns it **on**, and flipping it **toward you** turns it **off**.

![](../../../assets/btn-1-flip-power-switch-on.webp)

### Connecting Through Hotspot

To connect through the sensor's onboard hotspot follow the below:
Expand All @@ -44,7 +52,7 @@ To connect through the sensor's onboard hotspot follow the below:

5\. Once connected, the sensor's dashboard will automatically close. You've successfully connected your sensor to your Wi-Fi.

[Click here for next steps!](https://wiki.apolloautomation.com/products/btn1/setup/getting-started/#connecting-to-home-assistant-via-esphome-integration){ .md-button .md-button--primary }
[Click here for next steps!](https://wiki.apolloautomation.com/products/btn1/setup/getting-started/#connecting-to-home-assistant-via-esphome-integration){ .md-button .md-button--primary }

### Connecting with <a href="https://www.home-assistant.io/integrations/improv_ble" target="_blank" rel="noopener">Improv via BLE</a>

Expand Down Expand Up @@ -106,4 +114,4 @@ wifi_password: "your-wifi-pass-here"

2\. Your device is now added to home assistant via the ESPHome integration, and you can easily navigate to it by going to settings -&gt; <a href="http://homeassistant.local:8123/config/integrations/integration/esphome" target="_blank" rel="noopener">ESPHome integration</a> -&gt; click on the name of your new device!

[Click here to setup a blueprint and easily automate using your BTN-1! :simple-blueprint:](https://wiki.apolloautomation.com/products/btn1/examples/blueprint/){ .md-button .md-button--primary }
[Click here to setup a blueprint and easily automate using your BTN-1! :simple-blueprint:](https://wiki.apolloautomation.com/products/btn1/examples/blueprint/){ .md-button .md-button--primary }