Skip to content
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

Add docs for the cell connection sensor #1062

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add docs for the cell connection sensor #1062

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ced93fc
add docs for the cell_connection sensor
MeGilles May 6, 2024
b39be89
Merge branch 'home-assistant:master' into add-docs-for-the-cell_conne…
MeGilles May 6, 2024
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
6 changes: 5 additions & 1 deletion docs/core/sensors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -385,8 +385,12 @@ For Android several different types of connection sensors are available and they
| `transport_type` | The transport type for the current network connection. An attribute will reflect if the current network is metered. |
| `hotspot_state` | Whether or not the device is currently broadcasting a WiFi hotspot. (Not available on Wear OS) |
| `ip6_addresses` | The ip6_addresses bound to the currently active network |
| `cell_connection` | The id of the currently connected network mobile network cell. |

![Android](/assets/android.svg) The `bssid` sensor offers settings to let you rename the current mac address to help avoid the need for templates and secret usage in automations and the front end. This is generally useful if you have multiple access points and want an easy way to differentiate between them.
The `cell_connnection` sensor offers a way to locate devices with a low level of precision. This is generally usefull when using the `minimal` flavor of the app lacking locations services. The value of the sensor uniquely identify mobile network cells, following the definition of [opencellid.org](https://opencellid.org). It is composed of the network type, the mobile country code (MCC), the mobile network code (MNC), the location area code (LAC) and the cell identification code (CID), separated by colons. The location of the cell can be querried on [opencellid.org](https://opencellid.org). More information is available on their [wiki](https://wiki.opencellid.org/wiki/FAQ).
These settings are turned off by default. These sensors require either [Background Location](https://developer.android.com/reference/android/Manifest.permission#ACCESS_BACKGROUND_LOCATION) or [Fine Location](https://developer.android.com/reference/android/Manifest.permission#ACCESS_FINE_LOCATION) permissions, depending on what version of Android you run.

![Android](/assets/android.svg) The `bssid` sensor offers settings to let you rename the current mac address to help avoid the need for templates and secret usage in automations and the front end. This is generally useful if you have multiple access points and want an easy way to differentiate between them. These settings are turned off by default. These sensors require either [Background Location](https://developer.android.com/reference/android/Manifest.permission#ACCESS_BACKGROUND_LOCATION) or [Fine Location](https://developer.android.com/reference/android/Manifest.permission#ACCESS_FINE_LOCATION) permissions, depending on what version of Android you run.

## Current Time Zone Sensor
![Android](/assets/android.svg)
Expand Down