Frequently Asked Questions

Quick answers for Senquip users. For further help, contact support@senquip.com.

Getting Connected

What SIM card should I use?

The ORB-C1 uses a Micro SIM. The SIM can be either 1.8 V or 3.3 V, and must be for an operator that supports the network used by your variant: CAT-1 for -H devices or CAT-M1 for -G devices. Don’t use a Nano SIM in an adapter, as it can come loose in the carrier and damage the SIM holder.

For volume applications, Senquip can supply devices with SIMs soldered to the PCB during manufacture. Soldered SIMs are more reliable in high-vibration environments.

See SIM Card Install.

Can I have a PIN on my SIM?

No, the SIM must not have a PIN. You can remove the PIN by putting the SIM in a phone and turning off the SIM PIN in the phone’s settings. For example, see Vodafone’s guide Turn use of PIN on or off.

Which variant should I use in my country?

Senquip offers two variants of each device, for instance ORB-C1-G and ORB-C1-H. The -G variant is for 4G LTE CAT-M1 networks and the -H variant is for 2G, 3G and 4G LTE CAT-1 networks. If your country has CAT-M1, use the -G variant for better range.

To check whether a country has CAT-M, use the GSMA Mobile IoT Deployment Map and select the country to see which providers offer which networks.

Why does Senquip prefer the 4G LTE CAT-M1 network?

4G and 5G networks can transfer data far faster than IoT devices need, so network operators introduced the IoT services NB-IoT and CAT-M1. These use less power and reach further, which means longer battery life and better coverage in buildings and remote areas. Senquip prefers CAT-M1 over NB-IoT because its data rates allow updates in the field and it supports roaming between towers in mobile applications.

3G networks have been switched off in many countries, including Australia and New Zealand.

Why won’t my device connect to the cellular network?

Check that:

  • The APN is set correctly in the network settings, or that Auto APN is turned on. Some SIMs also need a Username and Password.

  • The signal is strong enough where the device is installed.

  • The SIM is active, has no PIN, and supports the network type the device uses.

For -G devices, also check that the network supports CAT-M1 (sometimes called CAT-M).

If the settings are correct but the device still won’t reconnect, power-cycle it. See Connecting to an LTE Network with the Embedded Webserver.

What is Auto APN?

With Auto APN turned on, the device reads the SIM and looks up a suitable APN in a database, so it can connect without the APN being entered. If Auto APN doesn’t work for your SIM, contact support@senquip.com to have your service provider added.

Why won’t my device connect when the APN is correct?

If the SIM is roaming, check that Allow Roaming is turned on and that the SIM provider supports roaming in the installation country. CAT-M (LTE-M) is often left out of roaming agreements, even where ordinary LTE roaming is available.

Can a device be locked to a particular cellular network?

Yes, on supported devices and firmware. This helps where roaming between networks causes connection problems. Contact support@senquip.com for details.

What does a “PPP WDT Triggered” error mean?

The cellular data connection stopped responding and was restarted automatically by the watchdog. Occasional occurrences are normal.

How can I improve reception in a cabinet or below ground?

Use a device with an external antenna connection, such as the QUAD, and place the antenna above ground or outside the metal enclosure. Check the coverage at the antenna’s position. See Network Connection.

Can Senquip operate where there is no cellular coverage?

Yes. New Senquip devices are Direct to Cell ready, with service depending on network availability and support in your region. An external satellite modem, such as Iridium EDGE, is another option.

Why can’t I see my device on my local Wi-Fi network?

If you know the device’s IP address on your network, you can log in to its web server, as long as the web server is running. The web server only runs in setup mode, unless Web Server is turned on in the general settings. It also stops while the device sleeps; to keep the device awake, turn on Device Always On.

The web server is turned off when the device uses a cellular connection, because leaving it open on a public network is a security risk.

How can I check my Wi-Fi coverage?

Wi-Fi is affected by the number of transmitters, the layout of the site and how the device is mounted. Turn on Report Network Info in the endpoint settings to have the device report the quality of its connection, so you can map coverage.

Why has my phone’s hotspot stopped accepting devices?

Most phone hotspots allow only 3 to 5 devices to connect at once, and some newer phones allow 10. Once the limit is reached, no more devices can connect. Disconnect devices you are no longer testing.

The orange light is solid, but no data is arriving. Why?

The device has connected to the network but can’t reach the Senquip servers. The ports it uses are probably blocked. See Network Requirements and the next question.

How can I check that the ports to a server are open?

On a Windows PC on the same network, run this in PowerShell, using your server’s hostname and port (8883 for MQTT over TLS, 443 for HTTPS):

Test-NetConnection your-server-hostname -Port 8883

TcpTestSucceeded : True confirms that the PC can reach that host and port. It does not check MQTT or HTTPS sign-in. See Network Requirements for the ports the Senquip Portal uses.

Setting Up and Updating

I pressed the Setup button and nothing happens. Why?

New devices are shipped in freight mode, which saves the internal battery and stops the device transmitting in transit.

To leave freight mode, apply power or insert AA batteries.

See Freight Mode.

Why do the lights stay off when I open the device?

The device is most likely asleep, which saves power. The lights come on when it next wakes for a measurement cycle. To use the device straight away, press the Setup button to enter setup mode, or press Reset to restart it and start a measurement cycle. To be able to reach the device at any time, turn on Device Always On in the general settings.

Why does setup mode keep switching off?

The device leaves setup mode when settings are saved and it restarts, when the lid is closed, or when there has been no activity for a few minutes. Don’t cover the light sensor while you work, and don’t leave the device idle for long.

See Setup Mode.

Why won’t my Android phone stay connected to the device’s Wi-Fi?

Phones connect to the best Wi-Fi network available. The device’s access point has no internet access, so the phone may switch to another network. On Android, open the Wi-Fi settings, go to Intelligent Wi-Fi and turn off Switch to better Wi-Fi networks.

I turned on the web server, but I lose contact with it every few minutes. Why?

The web server stops when the device sleeps between measurement cycles. To keep it running, turn on Device Always On in the general settings.

Do I need an account to use the Senquip Connect app?

No. Local access to a device uses the device’s setup password.

I have lost my password. What can I do?

If you are an administrator of the device, open ADMIN ‣ Device Passwords on the Senquip Portal for the recovery options. Otherwise, contact your administrator or support@senquip.com. See Passwords.

I changed a setting on the Senquip Portal, but the device hasn’t changed. Why?

A setting changed on the Senquip Portal waits in a queue until the device next connects. To see whether it has been applied, open the command queue at the top of any settings page; applied changes are shown in green.

The device doesn’t contact the Senquip Portal while it sleeps. To apply a change straight away, for example when testing before deployment, press Reset: the device connects after restarting and loads any waiting settings.

Configuration via Senquip Portal must also be turned on in the endpoint settings. See Configuration via Senquip Portal.

Can I save my settings to a file, or copy them to another device?

Yes. On the device’s Admin settings page, first request the device’s current settings, then export the settings, script and Senquip Portal settings to a file. To copy settings from another device, use the import option on the same page.

Will a factory reset lose my settings?

Yes. A factory reset clears the settings, including the Wi-Fi settings and the script. Export the settings first, then use setup mode to restore the network connection after the reset.

If you have already reset the device and can’t remember a setting, open the command queue at the top of any settings page on the Senquip Portal. It shows the settings previously sent to the device. See Factory Reset.

Will a firmware update lose my settings?

No. A firmware update keeps your settings. New settings added by the update take their default values. Major firmware updates may reset some stored values, such as non-volatile variables used in scripts and hour meters.

How long does a firmware update take, and what if it fails?

It depends on the connection and its signal strength: typically about 5 minutes on Wi-Fi and 15 to 20 minutes on cellular. The orange light flashes during the update. If the update is interrupted it fails safely: the device keeps running its current firmware and the update has to be started again. See Firmware Updates.

Why won’t my device accept a firmware update?

A heavy measurement or reporting load can leave too little processing time for an update. Increase a short Base Interval to 60 seconds, apply the update, then set the interval back.

Senquip Portal

I created an account but didn’t get a confirmation email.

The email has most likely been blocked by your company’s mail server or gone to your junk or spam folder. About 2% of accounts are created with a mistyped email address, so check the address too. If the problem continues, contact support@senquip.com and we will confirm your account manually.

Why do I get a network error when I sign in?

The Senquip Portal needs your computer’s clock to be accurate to secure the connection. If it is more than a few minutes out, sign-in fails with a network error. Correct the time on your computer and try again.

Do I need a hosted plan to configure or update my device?

No. Every Senquip device includes a Basic plan for the life of the device, which allows settings changes, firmware updates, scripting and viewing current data on the Senquip Portal. See Management and Hosting on the Senquip Portal.

Can I see historical data on the Basic plan?

The Basic plan shows current data, updated at most every 5 minutes, and doesn’t keep more than a day of history. Hosted plans store data for 2 years and add charts, dashboards, and email and SMS alerts. To upgrade, use Subscriptions on the Senquip Portal. See Adding or Cancelling a Hosted Plan.

How many users can a device have?

Up to 50 users can be added to each device. See Device Level User Administration.

Why can’t I add a user to a device?

You must be an administrator of the device, and the person must have an activated Senquip Portal account. On the device page, open the users panel, enter the email address the person signed up with, and choose their permission: Admin, User, Operator or View. If the email address doesn’t belong to an activated account, the user isn’t added. See Device Level User Administration.

I have many devices. How can I tell them apart?

Give each device a meaningful Device Name when it is installed, and add devices to groups on the Senquip Portal. You can also choose which columns the device summary shows, for example fuel level, utilisation and alerts. If a device hasn’t been named, turn on its GPS to find where it is. See Group Management.

Why does sorting the All group only sort the first page?

When All is chosen, sorting is limited to the first page so that the page stays fast for users with hundreds of devices. Create your own groups to sort all of their devices.

What happens if I take out a subscription during the free trial?

The subscription starts straight away. The 90-day trial continues alongside it and is still available if the subscription is cancelled within the 90 days.

Will I be warned before my hosted plan expires?

Yes. You will receive an email 30 days and 5 days before the plan expires. Add Senquip to your trusted senders so that the reminders don’t go to your junk or spam folder.

Which payment methods can I use?

Payment methods vary by region and include credit card, direct debit, Google Pay and Apple Pay.

How do I change my payment details?

Sign in to the Senquip Portal, select Account at the top right, then Billing Detail, then the Edit Billing Detail or View Invoices banner. This opens the secure payment portal, where you can add a payment method with Add payment method and remove one with the cross next to it.

Where can I find my invoices?

Open the secure payment portal as described in the previous question. Your invoice history is at the bottom of the page; select an invoice to see its details and download a copy.

Data and Alerts

I have signed in, but no data is showing. Why?

Data only appears once the device has sent measurements to the Senquip Portal at least once. New devices arrive in freight mode and haven’t sent any data. Apply power to leave freight mode and set up the network; the device then sends data at its Transmit Interval.

I added a measurement, but its widget isn’t showing. Why?

Your browser may be showing a cached copy of the page. Hold down Ctrl and click the browser’s reload button, or press Ctrl+F5.

Also check that the widget hasn’t been hidden: press the eye icon on the device page to choose which widgets are shown, and in what order. See Device Data Page Configuration.

Why are measurements missing from the stored data?

If a device can’t connect, it retries several times and then discards the data and goes back to sleep. To keep data while there is no coverage, turn on Offline Buffer in the endpoint settings. See Data Buffer.

If the Transmit Interval is longer than the Base Interval, only the measurement taken at the transmit time is sent. To keep every measurement, turn on Batch Transmit in the general settings. See Measurement and Transmit Intervals.

Why are measurements arriving more often than my transmit interval?

While an alert, warning or alarm is active, the device sends at the Exception Interval instead, so that events are reported faster.

If Batch Transmit is turned on, the device stores every measurement and sends them together at the Transmit Interval, so the Senquip Portal shows a measurement for every base interval. In the raw data, the server timestamps of a batch are all close together. If the base interval is too short for the device to sleep and the network is connected, each measurement is sent straight away.

Why is my device buffering data?

The connection is unavailable or too slow to keep up with reporting. Check the signal quality and the connection on the device’s Diagnostics page, and whether the backlog clears when the connection improves. See Data Buffer.

Why am I receiving SMS alarms but not email alarms?

Check your junk or spam folder, and ask your IT team whether antivirus or email filtering is blocking Senquip emails. If the email allowance goes down when an alarm is raised but no email arrives, ask your IT team to check quarantine and allow emails from Senquip. See Event Reporting.

How can I download or export data?

Each Raw Data download from a device page is limited to 50 MB. For more data, or for data from many devices in a group or fleet, use the Senquip API. See Historical Data.

Where can I find the IMEI, IMSI and ICCID?

On the device’s Diagnostics page. The IMEI is shown for every device with a cellular modem. The IMSI and ICCID belong to the SIM and are shown when a SIM is fitted and answers the device’s requests for them.

Can I use symbols as units?

Yes. Copy the symbol, such as °C, into the units field. On Windows, Alt+0176 on the numeric keypad types the degree symbol. See Calibration.

How accurate is the device’s clock, and how often is it synchronised?

The device sets its clock from a time server (NTP), with cellular or GPS time as alternatives. The server and how often the device checks it are set in the Time Server settings on the Network settings page.

Sending Data to Your Own Systems

Do I have to use the Senquip Portal?

No. The device can send data directly to your own MQTT or HTTPS server, to the Senquip Portal, or to both. UDP is also available. See Endpoint Setup.

Can I disconnect completely from the Senquip Portal?

Yes. To stop sending data to the Senquip Portal, turn off Send Data to Senquip Portal in the endpoint settings. To stop settings changes from the Senquip Portal, turn off Configuration via Senquip Portal; after that, settings can only be changed locally in setup mode.

Why is data not reaching my own MQTT, HTTP or UDP server?

Open the device page and select Diagnostics. The Endpoint Status table shows the last status code for each of your own endpoints (MQTT, HTTP and UDP), with a description. A code of 0 means the last transmission succeeded and 99 means the endpoint has not started. The same table shows when the device last connected to the Senquip Portal.

To check that the server can be reached at all, see How can I check that the ports to a server are open? above.

Does Senquip have an API?

Yes. The Senquip API gives access to device data and to management functions, including settings and script updates. See the API documentation for access requirements and limits.

Why does a configuration API request return an HTTP 500 error?

Check that the request body matches the format the API endpoint requires.

Can settings be changed through my own MQTT broker?

Yes. A device script can subscribe to a configuration topic and apply the settings it receives. Allow only authorised publishers, check the settings before applying them, and restart the device where required. See MQTT.

Can scripts be updated from an external system?

Yes. An external system can update device scripts through the Senquip API. The device needs a Wi-Fi or cellular connection to the Senquip Cloud to receive the update.

Inputs and Outputs

Modbus and RS485

Why is my Modbus device not responding, or failing often?

Check the wiring, the Type (RS232 or RS485), the baud rate, parity, stop bits and slave address. Make sure the connected device is set up as a slave and that the request matches its register map.

On RS485, fit termination at the two ends of the main cable. Turn on Termination Resistor only if the device is at an end that needs termination. See Serial interface.

What if a Modbus device can’t keep up with the requests?

Reduce the request rate and, where the device supports it, read consecutive registers in one request. Leave enough time between requests for the device to respond.

Why are my Modbus values incorrect?

Check that the Function matches the device’s register map: 01 for coils, 02 for discrete inputs, 03 for holding registers and 04 for input registers. Check whether the documented addresses need converting to zero-based offsets. Then check the register address, signed or unsigned format, scaling, and byte and word order, and whether the device uses special values to mean data is unavailable.

Why are Modbus values shown to only 2 decimal places?

By default, Modbus values are sent with 2 decimal places. To keep more precision, scale the value with calibration. For example, 1.23456 V is sent as 1.23 V without calibration, and as 1234.56 mV with a calibration of 0-1 in to 0-1000 out. If the result must be in volts, use a script to send the value with the number of decimal places you need.

My Modbus device is powered from the Senquip device and takes a while to boot. What should I do?

Set the Start Time on the current source that powers the device. Modbus reads wait until it has elapsed.

Can I set a baud rate other than the standard rates?

Yes. You can set any baud rate, such as 62500, which can be useful for some machine diagnostic interfaces.

Can Senquip collect Modbus data when another master is already polling?

Yes. Senquip can listen to the existing Modbus traffic and send the decoded readings to the Senquip Portal without adding requests of its own. See application note APN0046 on Modbus sniffing.

Can Senquip send commands on an RS485 bus that already has a Modbus master?

Modbus RTU has no way to share the bus between masters. Commands can sometimes be sent in a confirmed gap in the existing polling cycle, but check the bus timing carefully to avoid collisions.

Does an RS485 connection need a common ground?

Both devices need a suitable signal reference and must stay within the interface’s common-mode voltage limits. Large ground differences can damage the transceivers; use isolation where necessary.

CAN and J1939

Does a CAN bus need termination?

Yes. Fit a 120 ohm terminator at each end of the main CAN bus. Check what is already fitted before adding resistors, as missing or extra termination causes communication errors. See CAN Bus interface.

Why am I receiving no CAN data?

Check the CAN H and CAN L wiring, the bit rate, termination and capture filters, and that the other device is transmitting. If Senquip is the only other device on the bus, the sender may need it to acknowledge messages; turn on TX Enable. See CAN Bus interface.

I sent a CAN message and it is flooding the bus. Why?

CAN automatically resends a message that no other device acknowledges. Make sure there is at least one other active CAN device on the network.

Can Senquip share a diagnostic port with a service tool?

Yes, with a suitable pass-through adapter. Leave TX Enable turned off for passive monitoring, and turn it on only when transmitting or acknowledging is needed.

What engine information can Senquip read over J1939?

Senquip can decode standard J1939 parameters, such as engine speed, temperatures and fuel use, when the machine provides them. Proprietary messages need the manufacturer’s decoding information.

Can Senquip request J1939 data that is not broadcast?

Yes, if the ECU supports requests for that parameter. Turn on CAN transmission and send the request PGN from a script, with the right destination and polling interval.

Does connecting Senquip let it control my machine?

No. Control has to be set up deliberately. CAN transmission is turned off by default, and only a user with ADMIN permission can turn it on.

GPS

Does the GPS work with other satellite systems?

Yes. The receiver uses GPS, GLONASS, BeiDou, Galileo and QZSS satellites. Senquip says GPS rather than the more correct GNSS because the term is more widely understood.

I turned on GPS, but there is no GPS data. Why?

The device needs a clear view of the sky, not through metal. Mount it as described in the installation chapter. In poor reception areas it can take longer to find satellites; increase the GPS Max Time to 240 or even 360 seconds. See GPS.

How accurate is the GPS?

With a clear view of the sky, the position is accurate to better than 2.5 m 50% of the time, and better than 5 m 95% of the time. Accuracy depends on the mounting position and orientation, the view of the sky, the weather and the time of day. The best results come from mounting the device upright with a clear view of the sky.

Can I attach an external GPS or cellular antenna?

No. The ORB uses internal antennas. For an external antenna, use the QUAD.

Bluetooth

How many Bluetooth (BLE) connections are supported at once?

Up to four BLE client connections, although available memory and the application may limit the practical number. See Bluetooth interface.

Can scripts subscribe to BLE sensor notifications?

Yes. Scripts can discover BLE characteristics, subscribe to notifications and process the data received.

Can a BLE notification subscription be cancelled without disconnecting?

Not at present. Disconnecting from the BLE device cancels its notification subscriptions.

Power and Batteries

How can I make the battery last longer?

Measure and transmit less often, shorten the time sensors are powered, and turn off what you don’t use, such as GPS and Wi-Fi. Poor cellular coverage also increases power use. Use the Senquip battery calculator to estimate the run time for your application. See Low Power Operation.

Why doesn’t my device sleep between measurement cycles?

It only sleeps if the gap between cycles is long enough to be worth it, which depends on the network and the measurements turned on. For example, with GPS on and a base interval of 1 minute, the device stays awake, because finding satellites again would take longer than the sleep. These are the shortest base intervals that let the device sleep:

Condition

Shortest base interval

On Wi-Fi

10 seconds

On cellular

120 seconds

GPS turned on

180 seconds, or the GPS Max Time if longer

See Measurement and Transmit Intervals.

Does the device take measurements when it wakes from hibernate?

Yes. Waking from hibernate is a normal measurement cycle, and all turned-on measurements are made. If a script has set a timer for later, the device doesn’t wait for it before going back to hibernate. See General Setup.

Why does the first measurement after a reset take longer?

After a reset, the device loads its operating system, configures itself and loads your settings. This takes a few seconds.

How do I make a device safe for shipping?

Put it in freight mode. In freight mode the battery drain is almost zero and all transmitters are off. Enter freight mode from the web server, from the Admin settings page on the Senquip Portal, or by pressing the Setup button three times in setup mode.

The device leaves freight mode when power is applied or batteries are inserted.

See Freight Mode.

Do I need a fuse in the power supply?

It is always a good idea to fuse the supply to any electronic device. A 1 A fuse is a suitable size.

I wired my device incorrectly. Have I damaged it?

Senquip devices are protected against the most common wiring faults, such as reversed supply voltage. Some inputs, such as the serial port, can be damaged if connected to the supply voltage.

How long will the internal battery last?

The internal LiPo battery is expected to last 5 years without significant loss of capacity. Its life is shortened by temperatures above 55 °C or below -10 °C, an unusually high number of charge cycles, or being left discharged for a long time. Spare batteries are available from Senquip and can be fitted by a qualified technician.

See Internal Rechargeable Battery.

I’m on solar and losing data at night and on cloudy days. Why?

The solar panel is probably not supplying enough energy to run your application and keep the internal battery charged. Watch the internal battery voltage on the Senquip Portal for a while after installing.

A charged LiPo battery reaches about 4.2 V; below 3.5 V it is low.

The simplest way to use less energy is to increase the Base Interval. Use the Senquip battery calculator to size the panel. See Internal Rechargeable Battery.

My device hasn’t been used for a while and is slow to make its first connection. Why?

If the device was left unpowered for a long time, especially with a fast update rate, the internal LiPo battery will have run flat. When power returns, the device first preconditions the battery before running normally. With the lid open, the green light pulses slowly while this happens.

See Internal Rechargeable Battery.

Do I need AA batteries as a backup in a solar installation?

No. The internal battery is enough to run the device overnight and in low sunlight in most solar applications, and in low-power configurations it can run the device for months. AA batteries are only needed where there is no permanent or solar power, but they can be added as extra backup. See Replaceable AA batteries.

How long will the device run on AA batteries?

It depends on how often the device measures and transmits, and on the sensors attached. Left sleeping, a device could last up to 10 years. In a typical application sending hourly over cellular, expect about 2 years from a set of batteries. For the longest life, use good-quality lithium batteries, such as Energizer Ultimate Lithium. The device can monitor its batteries and report when they are low. Use the Senquip battery calculator to estimate the life for your application. See Replaceable AA batteries.

Which AA batteries can I use?

Alkaline or lithium batteries are recommended. NiCd batteries (1.2 V) will work but don’t last long. 3.6 V lithium thionyl chloride batteries last longest, although the gain over lower-cost lithium batteries, such as Energizer Lithium, is small.

Why is my AA battery voltage lower than I expect?

Four 1.5 V batteries should read 6 V, but you may see 5.5 V. Batteries have internal resistance, so the voltage drops when current is drawn, for example while the internal battery is charging. There is also a small drop across the protection circuit between the batteries and the measurement.

Will my ORB enter hibernate if AA batteries are fitted?

Yes. If hibernate is turned on, it is triggered when the supply voltage falls below 9.5 V, whether or not AA batteries are fitted. Hibernate can be turned off in the general settings. See General Setup.

Scripting

How do I get access to scripting?

You must be an administrator of the device to open its scripting page. See Scripting.

Does my script run on the Senquip Portal?

No. Your script runs on the device in the field, so it keeps running even if the device loses its network connection.

If my script fails, will my device fail?

Usually not. If a script fails, it stops and the device keeps running. But scripting is an advanced feature, and a badly written script can stop a device working or even make it unrecoverable. Read the scripting guide carefully before loading a script.

How can I tell if there is an error in my script?

The scripting page checks for some errors as you type. To find out why a script that looks correct has failed, press the bell button on the scripting page and turn on Send Script Errors. Errors then appear as script events in the events widget on the device page.

A common cause is using a data field that isn’t there: measurements that are unavailable may be left out. Check that each field exists and has the expected type before using it, for example typeof obj.analog1 === "number".

Why do I get a “calling non-callable” error?

Your script is probably calling a function that isn’t in the firmware on your device. Update to the latest firmware.

Why can’t I see the script that is loaded on my device?

Your browser may be showing a cached copy. Clear the browser cache or do a hard reload; in Google Chrome, open the developer tools, then right-click the reload button.

What does “Script: CPU Threshold Exceeded” mean?

The script used more than its allowed processing time. Reduce the work done in each callback and filter out input data you don’t need.

Should I turn off the script watchdog if my script keeps stopping?

No. The watchdog protects the device from scripts that use too much processing time; turning it off can make the device unreachable. Reduce the script’s workload instead.

What is the maximum script size?

It depends on the firmware; current firmware allows 20,000 bytes. Check the scripting guide for your device before loading a larger script.

How can I make a script smaller?

Move repeated code into functions, remove unused entries from lookup tables, and use arrays instead of objects with repeated field names where practical. Minification then removes comments and unnecessary spaces from the uploaded copy.

Can a script affect battery life?

Yes. Long-running operations, frequent measurements and SQ.keep_awake() can stop the device sleeping and increase power use.

Why do my script variables reset after sleep?

The script restarts when the device wakes, so ordinary variables start again. Use the non-volatile storage functions for values that must survive sleep.

Can I send custom values from a timer function?

Yes, in current firmware (SFW002 and later).

How can I see what data my script receives?

Temporarily send the data handler’s input to a spare custom parameter, for example SQ.dispatch(3, data). Remove it when you have finished.

How can a script raise an alert?

Call SQ.dispatch_event(index, SQ.ALERT, 'Message') when the condition is met. The index identifies the custom parameter, and the message is limited to 30 characters.

How can I stop a brief abnormal reading from raising an alarm?

Require several abnormal readings in a row before raising the alarm, and reset the count when readings return to normal. Choose the count to suit the measurement interval and the delay you can accept.

Can events such as impacts be used in scripts?

Yes. On supported firmware, events are included in the data passed to the device handler and can be detected by the script.

Does mJS support try, catch and throw?

No. Handle errors with explicit checks.

How should I check numeric custom settings?

Check for missing, empty and non-numeric values before applying range limits, and use a sensible default when a check fails. Comparisons alone won’t catch NaN.

How should I poll several Modbus registers from a script?

Read them one after another using callbacks: start each read only after the previous one has finished.

Can I send raw Modbus messages from a script?

Yes. SERIAL.write() sends frames you build yourself, and SQ.crc() calculates the Modbus CRC. The Modbus parser rejects received packets with an invalid CRC; if your script handles raw serial data itself, check the CRC in the script.

How do I read individual bits from a Modbus register?

Use the standard JavaScript bitwise operators to pick out individual status or alarm bits.

Can Senquip write floating-point values over Modbus?

Yes. A 32-bit float takes two 16-bit registers, so check the target device’s byte and word order. See application note APN0020, Writing to Modbus Devices.

How can I reduce the load of a CAN decoding script?

Set CAN filters so the script only receives the messages it decodes. Turn off raw CAN reporting once debugging is finished to reduce memory use and data traffic.

Security

Is my data secure?

Senquip devices use unique client certificates and TLS with mutual authentication to communicate with the Senquip Portal. The device’s flash memory is encrypted, and your own certificates can be loaded for secure communication with other endpoints. See Data security.

Does Senquip have access to my data?

No. Senquip staff can only see your data if you give them access to a device, for example so that they can help with setup. As an administrator, you can remove that access at any time.

Can I protect my scripts from being viewed?

Yes. Use the lock on the scripting page so that only you can see and edit the script.

Why is the web server turned off on a cellular connection?

To reduce exposure to unwanted access from the network. Use the Senquip Portal for remote configuration, and setup mode for local access.