Device configuration
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.
- App Settings
- Location Details
- Twilio Settings
- Socket Notification
- Auto-Capture
An external system can start the device by using a socket-based connection.
"date","ref","triggerString"IBM Maximo Visual Inspection Mobile responds with PASS or FAIL over the socket connection, depending on the inspection results.
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
Image pixel dimensions
- 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.
Enable continuous learning
- 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.
Always on camera
- 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.
Specifies how frequently the app's dashboard is refreshed.
Frame rate throttle
- 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.
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
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. 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
- One device is positioned up close.
- Another device is mounted further back with a clear line of sight to the same object.
- The first device reads the object's bar-code or serial number and does a primary inspection.
- 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.
Specifies whether OCR runs in
fast
or accurate
mode.
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
.