The location page

There are three ways in:

• From the dashboard: every location card has a small arrow in its top bar, beside the location's name. Press it.
• From Locations in the side menu: this opens All Locations, a list of every location you can see, arranged under their groups. Press the eye button at the end of a row.
• From the Overview page: press a location's name in its list of locations. See The Overview page.

The “Back to Dashboard” button at the top of the page takes you to the dashboard. If you arrived from a dashboard filtered to one location group, that filter is still on when you get back.

Four cards under the header sum the location up. Like the rest of the page, they count only the sensors you have access to: a sensor that is Disabled for you is not listed or counted anywhere here.

• Devices: how many sensors there are, with “Total in this location” underneath.
• Online: how many are reporting on time, and the same as a share, such as “75% reporting on schedule”.
• Needs attention: sensors that are Offline or have never reported, split underneath as “1 offline · 0 never reported”. The number turns red when it is above zero. When nothing needs looking at, the card says “All devices healthy”.
• Last uplink: how long ago the newest reading from any sensor here arrived, such as “3 min ago”, with that sensor's name underneath. “No data yet” means no sensor here has sent anything.

Every sensor sends readings on a fixed schedule, its reporting interval: every 10 minutes, for example. CropWatch compares the time of each sensor's newest reading with that interval and gives the sensor one of three statuses. The table shows them, in the colours used all over the page.

If CropWatch does not know a sensor's interval, it uses 10 minutes.

Refresh updates readings and statuses only. A sensor that was added to this location, or moved here, while the page was open appears once you reload the page in your browser.

When the location has a map position, the Map card shows it on a map from OpenStreetMap. The large pin is the location itself. Sensors that were given their own position when they were added show as small round dots in their status colour: green, red or purple. Point at a dot with the mouse to see which sensor it is.

• Moving the map: drag it.
• Zooming: use the plus and minus buttons in the top left corner, or pinch on a phone or tablet.
• The mouse wheel: scrolls the page, not the map, so the map does not trap you while you scroll past it.

Below the map are the exact Latitude and Longitude, and a copy button that puts both on the clipboard as one line, ready to paste into a message. “Open in Google Maps”, at the top of the card, opens the same spot in Google Maps in a new tab, which gives you directions to the site. The map opens at the zoom that was saved with the position.

The Devices card lists every sensor at the location that you can see, under a line such as “4 devices in this location”. It shows ten at a time, with page controls at the bottom.

To find a sensor:

• Status chips: “All 4”, “Online 3”, “Offline 1” and “Never reported 0” show only the sensors with that status. The numbers follow the statuses as they change. Press the All chip to see every sensor again.
• Search...: type part of a sensor's name or of its Device EUI. The list narrows as you type.
• Column headings: press one to sort by it, press it again to reverse the order, and a third time to return to the original order. On a phone, a sort list above the table does the same job.
• “10 rows”: shows 20, 50 or 100 sensors per page instead.
• The ⋮ button: “Columns Settings” chooses which columns are shown, and “Refresh” redraws the list. It does not fetch new readings; the Refresh button at the top of the page does that.

Signal shows how well your gateways hear each sensor, as up to four bars. Two radio measurements sit behind the bars: RSSI, how strong the signal is when it arrives, and SNR, how far it stands out above background noise. Each is graded on its own and the bars show the worse grade, so a strong signal in an electrically noisy spot still shows as weak. RSSI and SNR explains both numbers.

• Three or four green bars: Strong.
• Two yellow bars: Okay.
• One red bar: Weak. Readings still arrive, but the sensor is close to the edge of range, where readings start to go missing.
• Empty bars with a red crossed-out circle: no gateway has heard this sensor.

Point at the bars to see the numbers behind them, for example “Signal strength: Strong · RSSI -95 dBm · SNR 7.5 dB”.

Many sensors are heard by more than one gateway. The column shows the best of them, counting only gateways that heard the sensor within 24 hours of its newest reading. A gateway that picked the sensor up once, weeks ago, cannot make it look better than it is, and a sensor that has gone quiet keeps the signal of its last readings. Gateways you do not have access to count as well. Sorting by Signal puts sensors with no signal first, then runs from fewest bars to most.

The table shows where the grades change: a reading gets the number of bars that both of its numbers reach. To see each gateway separately, open the sensor and press its Signal button. Gateways in the app covers the gateways themselves.

Each row ends with its buttons, under “Actions”:

• The eye button: opens the sensor's own page, with its readings and charts. Everyone with access to the sensor sees it.
• The cog: opens the sensor's settings page, where it can be renamed, grouped or moved to another location. Only the location's owner, Admins and Managers see it. See Sensor settings.

“View” in the Needs attention list opens the same sensor page as the eye button. Pressing a row itself does nothing; use the buttons.

The last card on the page, Location details, lists the location's basic facts in two columns: Name, Group and Description, then Created (the date the location was made), Coordinates and Location ID. A dash means the item has not been set.

The buttons go by your level on the location. Which sensors are listed goes by your level on each sensor. User and Viewer see exactly the same page. Sharing access and permission levels explains the levels.

• The map says “This location has no coordinates yet”. No map position has been saved. The owner or an Admin can set one; see Location settings.
• A sensor I expected is not in the list. It is Disabled for you, or it belongs to another location. See When someone cannot see something.
• I added a sensor and it is not in the list. Reload the page in your browser; Refresh only updates readings. Until its first reading arrives, a new sensor shows as Never reported.
• A sensor says Offline but I think it is working. Press Refresh. If a new reading has arrived, it turns green. If it stays red, check its Signal column; a weak signal is a common reason for missed readings, and How to improve a weak signal lists what to try.
• The Signal column shows empty bars with a red circle. No gateway has heard the sensor. Check that your gateway is powered and connected, and that the sensor is within its range.
• There is no Location settings button. Your level on this location is User or Viewer. Ask the owner or an Admin.
• I pressed Location settings and got “Forbidden”. You are a Manager of this location. The settings page currently opens only for the owner and Admins.
• Some columns are missing on my phone. Narrow screens hide them. The wider the screen, the more you get: Last seen and Signal come back first, then Temp and Humidity, and CO₂ and Device EUI need a wide computer screen.
• The page shows no sensors, no map and no Location details card. You do not have access to this location, or it has been deleted. Ask the location's owner.