Device configuration

IBM® Maximo® Visual Inspection Mobile has many device-level settings that you can configure. Before you configure these settings, make sure that IBM Maximo Visual Inspection Mobile is set up to work with IBM Maximo Visual Inspection. For more information, see Setting up IBM Maximo Visual Inspection Mobile.

To access the Configure Device menu, tap the icon next to the device name.

If the device you want to configure is not listed, tap Change to Another Device. This action searches for other devices that are connected on the same MQTT broker. It can take up to 10 seconds to see all devices. The device in your hand is prefixed by Local. Other devices are prefixed by Remote.

The following settings are available:
  • Socket Trigger > Trigger Config
  • App Settings
  • Location Details
  • Twilio Settings
  • Socket Notification
  • Auto-Capture

Socket Trigger > Trigger Config

An external system can start the device by using a socket-based connection.

The device accepts a trigger message that is similar to the MQTT trigger format, except that it uses comma-separated values. The following example is a sample trigger message:
"date","ref","triggerString"
IBM Maximo Visual Inspection Mobile responds with PASS or FAIL over the socket connection, depending on the inspection results.
Note: The response merely signals back to the calling system whether the inspection passed or failed, as defined by the configured rules in the inspection. Detailed inspection results are still sent by the configured channels, such as MQTT notification or Socket Notification.

To maintain a persistent socket-based connection, the calling system can send a pingreq message, to which the app responds with PINGOK. Any processing errors, such as a nonconforming trigger message, results in a NOTOK response instead.

App settings

Flash mode

Controls the camera flash mode.

Upload to IBM Maximo Visual Inspection

Saves photos from collections and inspections to the data set that is defined in the inspection that is used.

Upload failures only

Uploads images to IBM Maximo Visual Inspection when an inspection fails.
Note: Avoid toggling this option on because it skews the results on the dashboard. Instead, archive old images from the server by using a script.

Image pixel dimensions

Refer to the size of the photo that is uploaded to the IBM Maximo Visual Inspection data set.
  • Use the default settings.
  • When you use Visual Trigger, bar code or OCR Trigger, or Video mode, the maximum image size that can be uploaded is 1080 pixels.

Shutter time

Controls how much time to give the iOS camera to auto focus.

Use lens position Retain the focal length that is used on the first photo so less auto focus time is needed for subsequent photos. This setting is useful in high volume production lines where the device is mounted and always has the same angle.

Lens reset refers to the number of images that use the same focal length.

Save to Photos saves the images to the mobile device's photo library.
Note: Toggling this option on can significantly impact local storage.

Enable continuous learning

Enables the use latest model inspection setting.
  • When Use Latest Model is turned on, inferences always occur on the last model that is deployed in a IBM Maximo Visual Inspection project.
  • If models are enabled for Core ML, the most recent trained model is used.
Note: Enable continuous learning does not turn on use latest model. It enables the setting so it can be turned on in an inspection. If enable continuous learning is not turned on, you cannot turn on use latest model for any inspections.

Always on camera

Prevents the inference results screen from displaying.
  • This option can be useful if you take rapid photos up to one photo per second in auto-capture mode.
  • This option is also useful in video mode, if you set the rule inspect when label detected to run every frame.

Notify on inspection pass

Sends a notification message through MQTT, even if an inspection passes. By default, only failed inspections send notifications.

Camera zoom level

Specifies the camera zoom level to use. Zoom level can also be applied by using a pinch gesture on the camera preview screen. Regardless of zoom method, the setting is retained if the device is mounted or placed in a fixed position.

Dashboard refresh interval

Specifies how frequently the app's dashboard is refreshed.

Frame rate throttle

Controls the number of frames per second to read from the camera when the app is in video mode. The app automatically switches to video mode in the following scenarios:
  • When the app is in auto-capture mode and the inspection is defined to use visual trigger.
  • When the app is in manual capture mode and you toggle enable streaming on during an inspection.
Note: A smaller frame rate throttle reduces the thermal load and energy consumption. Select the maximum value only if your device is equipped with an A13 Bionic chip or higher.

Location details

Edit here the location details that were entered on the welcome screen.

If you change the location details, ensure that any systems that send MQTT messages to this device are reconfigured. IBM Maximo Visual Inspection Mobile resubscribes to the MQTT topics with the specified location and device name in the topic path.

Twilio settings

When Twilio notifications are on, the thresholdMsg field in the more comprehensive MQTT message payload is sent out as a text message by using Twilio Cloud Messaging. You must specify the account name.
Note: For the account username, specify the Twilio account SID.

From No.

Sets a phone number in the Twilio account and is used as the message sender.

Supervisor No.

Is the phone number that text messages are sent to.

Socket notification

Writes out to a socket the JSON payload that is identical to the MQTT message for inspection results.

This setting is useful if MQTT brokers are not available.

Auto-Capture

Send trigger to secondary device

Is typically used with a visual trigger or a bar code and OCR trigger. The use case for this option involves two devices and two inspections.
  • One device is positioned up close.
  • Another device is mounted further back with a clear line of sight to the same object.
    1. The first device reads the object's bar-code or serial number and does a primary inspection.
    2. An inspection rule from the first device triggers a secondary inspection, which is done on the second device.

Image Trigger Delay

Controls the number of seconds to wait after a visual trigger or a bar code or OCR trigger is triggered before the inspection is run. This setting applies to inspections that are triggered on primary or secondary devices.

Pass video frame to inspection

By default, a new photo is taken in streaming video mode, in accordance with the inspection that is specified in the visual trigger setting. By toggling pass video frame to inspection on, the default behavior is overridden, and the video frame itself is used as the image for the secondary inspection.

Select inspection

This Visual Trigger setting specifies which inspection to run when video frames are streamed in auto-capture mode. The inspection that is selected must use a Core ML model and must have at least one label.

Mode

Specifies whether OCR runs in fast or accurate mode.

Note: Accurate mode uses significant resources.

Frames to reset

Used after a bar code or OCR text is read. This setting specifies the number of frames that have the same bar code or text to ignore before the next scan is done.

Add rule

Defines regular expression rules for reading bar codes or OCR text. When a match is found, you can run an inspection by passing the value that was read as the reference. If you leave Trigger empty, then the device sends the value that was read on an MQTT topic that is called ibmvi/barcodeocrvalue.