English

Français
العربية

English

Français
العربية

Appearance

Translation awaiting review

This page was recently translated and has not been reviewed yet. If in doubt, the French version is the reference. French version

Commissioning the Edge Box ​

The Edge Box is the farm's Sqiya box. A farm has only one Edge Box.

What the Sqiya team gives you ​

Before your visit, the Sqiya team gives you:

  • the serial number of the Edge Box, in the format SQY-EDGE-000001;
  • its activation code, in the format ABCD-1234.

WARNING

The activation code is valid for 24 hours and can be used only once. The Sqiya team cannot show it again: write it down carefully and do not share it.

1. Connect the Edge Box to the network ​

The Edge Box needs the Internet to enroll, then to send its data. It opens its own connections to the Sqiya Cloud: no port needs to be opened to the box from the Internet.

  1. Place the Edge Box in a sheltered spot, with electricity and covered by the farm's Internet network.
  2. Connect it to the farm's network.
  3. Check that the network allows secure outgoing connections to the Internet:
    • HTTPS, port 443;
    • Secure MQTT (TLS), port 8883.
  4. If the farm has LoRa equipment, place the Edge Box so that it covers the zones by radio (see Sensors and valves).

To be completed by the Sqiya team

The following points are not documented yet: supported type of network connection (Ethernet cable, Wi-Fi, 4G router), recommended power supply, mounting and protection of the box, meaning of the indicator lights.

2. Enroll the Edge Box ​

Enrollment links the Edge Box to the farmer's farm in Sqiya. It is done only once.

  1. Power on the Edge Box, connected to the Internet.
  2. Enter the serial number and the activation code on the Edge Box.
  3. The Edge Box contacts the Sqiya Cloud. If the code is correct, it receives its own credentials and keeps them encrypted on the box.
  4. The activation code is then invalidated: it cannot be used again.
  5. The Edge Box downloads the farm configuration (zones, equipment, schedules, rules, thresholds) and starts sending heartbeat signals to the Cloud.

To be completed by the Sqiya team

How to enter the serial number and the code on the Edge Box (screen, local web page, installer tool) is not documented yet.

TIP

No farmer email or password is stored on the Edge Box: it has its own identity, separate from the user accounts.

If enrollment fails ​

SituationWhat to do
Unknown serial numberCheck the serial number you entered. If it is correct, contact the Sqiya team.
Code expired, already used or wrongAll three cases give the same answer. Check what you entered, then ask the Sqiya team for a new code.
Edge Box already enrolledThe box has already been enrolled once. Contact the Sqiya team: they must deactivate it before giving you a new code.

The code has expired ​

A code not used within 24 hours no longer works.

  1. Contact the Sqiya team with the serial number of the Edge Box.
  2. The Sqiya team generates a new code. The old one no longer works.
  3. Start the enrollment again with the new code, within 24 hours.

Re-enrolling a box ​

To replace or reinstall an Edge Box that is already enrolled, the Sqiya team first deactivates it. Its old credentials are then destroyed. The team then gives you a new activation code.

After enrollment ​

  • The Edge Box sends a heartbeat signal to the Cloud every 5 minutes.
  • Each time, it checks whether the farm configuration has changed, and downloads it if needed.
  • In the farmer's app, the dashboard shows Sqiya box — online.

The Edge Box is offline ​

With no heartbeat for 15 minutes, the Cloud considers the Edge Box offline. The farmer sees Sqiya box — offline with the message: Irrigation keeps running locally on the box; only remote monitoring is interrupted.

During the outage:

  • sensors, schedules, rules and safety features keep running on the box, with the last configuration received;
  • readings and events are kept on the box (up to 30 days);
  • manual commands from the app do not get through, and are never carried out later.

When the Internet comes back, the Edge Box sends all the pending data, without duplicates, and fetches the up-to-date configuration.

TIP

If the app shows a message such as 12 item(s) waiting to be sent while the box is online, the data is having trouble getting through. Check the quality of the Internet connection, then tell the Sqiya team if the number does not go down.

To check the installation from end to end, see Check the installation.