CropWatch Knowledge Base
EN English

Sensor settings

Every sensor has a settings page: its name, its group, the location it belongs to, the crop on a soil sensor, its licence, its calibration certificates and who is allowed to see it. The sensor's owner can also delete it from there. This guide goes through the page one card at a time, including the two boxes that do more than they look like they do.

On this page

What this page is for

The settings page: a Back To Device Detail button, then the Device Settings, Device Sensor Certificates and Device Owner Permissions cards

Three of the five cards; Device license and Danger zone are not drawn. Click the picture to see it full size.

Three of the five cards; Device license and Danger zone are not drawn. Click the picture to see it full size.

Every sensor has a settings page. It is where you change what CropWatch knows about a sensor, rather than anything the sensor itself measures: what it is called, which location it belongs to, and who is allowed to see it.

The cards on it, from top to bottom. You only see the ones that apply to this sensor and to you:

  • Device Settings: the name, the group, the TTI Device ID, the location and, on a soil sensor, the crop.
  • Device license: whether one of your licences is assigned to this sensor.
  • Device Sensor Certificates: calibration paperwork to download. Only on sensors CropWatch made.
  • Device Owner Permissions: each person's level on this sensor.
  • Danger zone: deleting the sensor. Only the sensor's owner sees this card.

Nothing here changes how the sensor behaves. It will not report more often, measure anything different, or wake up sooner. How often a sensor reports comes from the model of sensor it is; no screen in CropWatch sets it, so if it needs changing, ask support.

Opening the settings page

There are two ways in. Which one you see depends on your level at the sensor's location:

  • From the sensor itself. Open the sensor and look along the row of buttons at the top of its page for “Settings”. It is the last one, after “Signal”. The location's owner and its Admins see it.
  • From the list of sensors at a location. Open the location, find the sensor's row, and press the cog at the far right, under “Actions”, beside the eye button. It has no words on it. Admins and Managers of the location see it.

If you see neither, your level at this location is User or Viewer. Ask the location's owner or an Admin. Sharing access explains why a person has one level for the location and another for each sensor.

Opening the page is not the same as being allowed to save. Saving the first card needs Manager or above on this sensor itself. Without it, everything fills in normally, but pressing Update Device shows a red bar reading “You do not have permission to perform this action on this device”, and nothing is changed.

The boxes on the first card

The Device Settings card: the DevEUI and group chips, then Device Name, Group, TTI Device ID and Location, with the Update Device button below

The numbers match the list beside it.

The numbers match the list beside it.

The first card, “Device Settings”, holds four boxes, and a fifth on soil sensors. Only the name has to be filled in; the rest can stay as they are.

  1. The chips along the top cannot be edited. They show the sensor's DevEUI (its permanent serial number, useful when contacting support) and, if it has one, “Current group:” followed by its group. The group chip shows the saved value, so it does not change as you type.
  2. Device Name: what the sensor is called everywhere in CropWatch.
  3. Group: an optional label.
  4. TTI Device ID: best left alone. See below.
  5. Location: which location the sensor belongs to. Read the warning before changing it.
  6. Update Device: saves the whole card at once.

On a soil sensor a fifth box, “Crop”, sits after Location. See Crop.

Device Name

This is the name you see on the dashboard, in the list of a location's sensors, in alert emails and on reports. Changing it here changes it everywhere at once.

Give it a name somebody else would recognise while standing in the field. “Greenhouse 1 — north end” beats “Sensor 4”.

It cannot be left empty. Clear the box and “Device name is required.” appears under it, and the save button stops working until you type something. The limit is 120 characters, far longer than any sensible name. Spaces at the start and end are trimmed off when it saves.

Renaming a sensor does not affect the readings it has already sent. The history stays exactly as it is; only the label on it changes.

Group

Group is a free-text label you can type anything into — “Greenhouses”, “South block”, “Trial plots”. There is no list to pick from, and no spelling to get right, because nothing checks it.

Be aware of how little it does at the moment. The group appears as a column on the main dashboard when you use the table view on a computer; it is hidden on a phone, and that is the whole of it.

Groups do not affect alert rules, reports or who can see a sensor. If you are looking for a way to organise sensors that actually changes what people see, use locations instead.

TTI Device ID

This one is not for everyday use. It holds the name the sensor goes by on the radio network that carries its readings, and CropWatch only needs it for sensors that can be switched on and off remotely. A sensor added with the guided add-a-sensor steps has it filled in for you.

Leave it alone. You can type in it, and pressing Update Device answers “Device settings updated.” in green, but the value does not stick: reload the page and the old value is back. Nothing was saved, despite the message.

The box also checks what you type when you press the button. Capital letters are turned into small ones, and anything other than letters, numbers and hyphens brings up “TTI device IDs must use lowercase letters, numbers, and hyphens only.” under the box. If that happens, reload the page before you change anything else: the Update Device button stays grey until you do.

If a sensor of yours needs this set (you will know, because a remote switch does not respond), contact support rather than typing it here.

Location, and what moving a sensor really does

The Location list holds every location you have access to. Changing it moves the sensor there: it leaves the old location's list of sensors and appears in the new one.

The readings are safe. A sensor's history belongs to the sensor, not to the site it sat at, so every reading it has ever sent moves with it and the charts look exactly the same afterwards. Nothing is left behind and nothing is lost.

Moving a sensor also rebuilds the list of who can see it, from scratch. Everyone who had a level on it at the old location loses access the moment you save. You become its Admin, and everybody at the new location starts as Disabled on it until an Admin turns them back on, one at a time, on this page. If other people rely on this sensor, tell them before you move it.

Ownership moves too. The owner of the new location becomes the sensor's owner. Move a sensor you own into somebody else's location and they own it from then on, which also means only they can delete it.

Two smaller things to expect:

  • The list has an “Unassigned” option at the top, but saving with it chosen stops with “Location is required.” under the box. Every sensor has to belong to a location. Reload the page afterwards, because the Update Device button stays grey until you do.
  • You need Manager or above at the destination location too. Without it the save is refused with “You do not have permission to move this device to that location”.

Crop (soil sensors only)

The lower half of the Device Settings card: TTI Device ID and Location, the Crop box set to Tomato with the line “Sets the growing targets this soil sensor's readings are judged against.” under it, and the grey Update Device button

The Crop box sits under Location, on soil sensors only.

The Crop box sits under Location, on soil sensors only.

Soil sensors have a fifth box, “Crop”. Under it is the line “Sets the growing targets this soil sensor's readings are judged against.”

Open the list and pick what is growing around the probe, or “No crop” to clear it, then press Update Device. The crop decides which targets the sensor's readings are compared with on its own page. Crop targets and growing advice explains what those targets show.

The box appears only on soil sensors. If the list of crops cannot be loaded, the box is left off the card altogether; reload the page a little later.

Saving, and why the button is grey

The Update Device button greyed out when nothing has changed, and dark when it can be pressed

Grey means nothing has changed yet.

Grey means nothing has changed yet.

One button saves the whole card. Until you change something it is greyed out and does nothing, which is deliberate rather than broken: there is nothing to save yet.

As soon as you edit a box it turns dark and can be pressed. It goes grey again if you put the value back the way it was, and while the name box is empty.

When you press it, a coloured bar appears under the chips:

  • Green, “Device settings updated.” It saved.
  • Red: something stopped it, and the bar says what. “Please correct the highlighted fields.” means look for red text under one of the boxes. A bar starting “You do not have permission” means your level on this sensor, or at the location you picked, is too low.

If red text appears under the TTI Device ID, Location or Crop box after you press the button, the button stays grey even once you have corrected the box. Reload the page and make the change again.

If you leave the page without pressing Update Device, nothing is saved. There is no automatic save and no warning on the way out.

The licence card

The Device license card with a green License 4 chip, the line “This device holds one of your licenses. Unassigning frees the license so it can be used by another device.” and the Unassign license button

A sensor that holds one of your licences.

A sensor that holds one of your licences.

The second card, “Device license”, shows whether one of your licences is assigned to this sensor. It reads one of two ways:

  • One of your licences is on it. A green chip at the top right names it, such as “License 2”, or reads “Included”. The card says “This device holds one of your licenses. Unassigning frees the license so it can be used by another device.”
  • None of your licences is on it. The card says “This device has no license assigned. Assign one from the billing page.”, and the “Billing” button beside it takes you there.

“Unassign license” takes the licence off this sensor so you can give it to another one. A box asks “Unassign the license from this device? The device keeps its data, but it will need a license again before it can be re-registered.” Press “Unassign license” in the box to confirm, and “License unassigned.” appears on the card.

The card only knows about licences on your own account. If somebody else added the sensor and it uses one of their licences, the card says it has none. Nothing is wrong with the sensor: the licence holder sees the licence on this card when they open the page.

Calibration certificates

The Device Sensor Certificates card: an SHT43 row with its serial number and a download button, and below it the SHT4x series certificate with its own download button

Two certificates: one for your chip, one for the family.

Two certificates: one for your chip, one for the family.

The “Device Sensor Certificates” card holds calibration certificates: the paperwork showing that the temperature and humidity chip inside the sensor was checked against a known standard. If you are audited, or a buyer asks for proof, this is what they want.

There are two, and they are not the same thing:

  • The one with a serial number: an ISO 17025 certificate for the exact chip in your sensor, fetched fresh when you press the button. The chips beside it show which chip it is, its serial number and the sensor model.
  • “SHT4x series certificate”: the general certificate for that family of chips. It says nothing about your particular sensor, and it is the same file for everybody.

Each row has a small button on the right with a downward arrow and no words on it. Pressing it opens the PDF in a new tab. Ask for the one with the serial number if you are given the choice; it is the stronger document.

This card only appears on sensors CropWatch manufactured. If it is missing entirely, your sensor came from another maker and its paperwork comes from them. On a CropWatch sensor with no chip serial recorded, you get the card with only the general certificate in it.

Who can see this sensor

The Device Owner Permissions card: a person's name and email, a Permission Level dropdown reading Admin, and an Update Permission button

One row per person, each saved on its own.

One row per person, each saved on its own.

The “Device Owner Permissions” card lists the people who have a level of their own on this sensor. Each row shows a person's name and email, a “Permission Level” box, and its own “Update Permission” button.

Each row saves separately. Change one person's level, press the button on that row, and “Permission updated for” followed by their email appears under it. Changing several people means pressing several buttons.

Only the sensor's owner and its Admins can save here. Anyone else who presses the button gets “You do not have permission to perform this action on this device”. Two more refusals you may meet:

  • “You cannot change your own access level”: nobody can change their own row.
  • “The resource owner's access cannot be changed”: the owner always keeps full control.

There is no way to add or remove a person here. People are added at the location, not at the sensor; see Giving someone access. If the card reads “No device owners were returned for this device.”, nobody has a level of their own on this sensor yet.

What the levels mean

The five permission levels: Admin, Manager, User, Viewer and Disabled, with what each one is allowed to do

Five choices, each allowing less than the one above.

Five choices, each allowing less than the one above.

The Permission Level box offers five levels. Each one sets what a person can do with this one sensor:

  • Admin: everything a Manager can do, and can save the Device Owner Permissions card, so can change other people's levels on this sensor, up to Admin.
  • Manager: can rename the sensor, group it, move it, choose its crop, switch a relay, and set up alert rules and reports on it. Cannot use the Device Owner Permissions card.
  • User: everything a Viewer can do, plus adding notes to the readings of an air temperature and humidity sensor. Changes no settings.
  • Viewer: can look at the sensor and its readings, and change nothing.
  • Disabled: cannot see the sensor at all. It disappears from their dashboard and their location's list.

Whoever owns the sensor outranks all of this: they always have full control, whatever the list says, and they are the only one who can delete it. Every level is described in The six levels, and Who can do what, at a glance puts them side by side.

Adding somebody new

People are given access to a whole location, not to one sensor at a time. To add somebody, go to the location: open it, press “Location settings” at the top of its page, and use the card titled “Add new user to (location name) with permissions”. Only the location's owner and its Admins can open that page.

Type their email, choose a Permission Level, and press Add Permission. The switch on that card decides what they get on the sensors already in the location:

  • “Apply to all devices in this location” on: they get the level you chose on every one of those sensors.
  • Off: they join the location but are Disabled on every sensor in it, so they see the location and none of its readings.

That second case is what the Device Owner Permissions card is for: turning sensors on, one at a time, for somebody who joined with the switch off. Giving someone access goes through the whole process, including changing and removing people.

Deleting a sensor

The Delete “GH1 Soil”? box: the list of what is removed, the note that the licence is released, the sensor's name and DevEUI, the DevEUI typed into the confirmation box, the tick box checked, and the red Delete this device permanently button

Type the DevEUI and tick the box before the last button can be pressed.

Type the DevEUI and tick the box before the last button can be pressed.

Deleting removes a sensor from CropWatch for good, together with everything it has ever sent. Only the sensor's owner can do it. For the owner, a red “Danger zone” card sits at the bottom of the page, with “Delete this device”, the line “Permanently deletes this device and all of its data. This cannot be undone.”, and a “Delete device” button. Nobody else sees this card.

Pressing “Delete device” opens a confirmation box. Its heading names the sensor, as in Delete “Greenhouse 1”? Under the red “This cannot be undone.” it lists what is removed:

  • “All of its sensor readings and history”
  • “Its notes and alerts”
  • “Its rule and report assignments, including its alert history”
  • “Access to its past reports in CropWatch”
  • “Everyone's access to this device”

Below the list it says “Its license is released, so you can assign it to another device.”, and shows the sensor's name and DevEUI so you can check you have the right one. Then:

  1. Type the DevEUI into the box whose label reads “To confirm, type the DevEUI” and then the DevEUI itself. Capitals and small letters both work. If what you type does not match, “The DevEUI you typed does not match this device.” appears.
  2. Tick “I understand that this device and all of its data will be permanently deleted.”
  3. Press “Delete this device permanently”. It stays grey until both steps above are done.

While it works, the box cannot be closed. A sensor with a long history takes a while, and the box counts as it goes, for example “Deleting… 120,000 data rows removed so far.” When it finishes you land on the location's page, and the sensor is no longer in its list.

If it stops partway, the card says “Part of this device's data was deleted, but the device still exists. Press Delete device again to continue.” Press it again and go through the box once more; it carries on from where it stopped. If you only want a sensor out of sight, move it to another location or set people to Disabled on it instead. Both of those can be undone; deleting cannot.

Quick answers

  • There is no Settings button on my sensor. It is shown to the location's owner and Admins. A Manager can use the cog in the location's list of sensors instead. Anyone else, ask whoever manages your CropWatch account.
  • The Update Device button is grey. Nothing has been changed yet, or a box needs fixing. If red text appeared under a box after you pressed the button, reload the page.
  • It said it saved, but my change came back. If it was the TTI Device ID, that box cannot be saved from this page. Anything else, try again and read the coloured bar carefully.
  • Where do I add a new person? At the location, not here. See Adding somebody new.
  • Somebody is listed as Disabled and I did not do that. They were added to the location with “Apply to all devices in this location” switched off, or the sensor was moved here from another location. Set their level here.
  • How do I delete a sensor? Only its owner can, from the Danger zone card at the bottom of this page. See Deleting a sensor.
  • I moved a sensor and my colleagues lost it. That is what moving does. Put them back on this page, or ask an Admin to.
  • The licence card says there is no licence, but the sensor works. The card only shows licences on your own account. The sensor is most likely using a licence on the account of whoever added it.
  • The certificates card is not there. The sensor was not made by CropWatch, so its paperwork comes from its maker.