Using the iPad App
Overview
Teaching: 30 min
Exercises: 0 minQuestions
Active user privilage is required.
How do I go/down through PID hieratchy, scan QR codes, and post Locations via iPad?
Objectives
To be able to go through the PID hieratchy with the PID Display
To be able to deal with Item Locations with the Shipment Tracker
Contents
Section Description Basics General overview of the iPad app. Requirements Device requirements Deployment How to download the app Login Page How to login PID Display PID management system Shipment Tracker Utilizing the pid system to keep track of shipment crates QR-Code Scanning and generating QR codes Local Storage storage location
Basics
Requirements
The iPad app can be utlized on either a MacBook or iPad. The following are the specifics for each device.
iPad:
- iPadOS 14.0 or newer For reference, we have been using an iPad with the following specifications since 2019:
- 6th generation
- 128 GB storage
- 9.7 inch (diagonal) display
- A10 Fusion Chip with 64-bit architecture, Embedded M10 coprocessor
- Model # : MR7J2LL/A
Mac:
- macOS 11 (Big Sur) or newer The app also runs on Macs with both Intel and Apple M chips.
Deployment
iPad app Deployment: As of now, you must contact Hajime Muramatsu and send send him your E-mail address. You will then be sent an invitation, which includes a link to download an app called TestFlight. You can then intsall the app via TestFlight. This method is subject to change.
Mac Deployment: The latest version of the app can be downloaded at https://www-users.cse.umn.edu/~hmuramat/iOS/CPAProductionChecklists.zip. To do so you will need Username: DUNE and Password: DUNEana.
Login Page
When the app is launched, you will see the following page. You can either login using your credentials or run a “guest” session, which allows you to use all the capabilities of the app except for communicating with the HWDB. You can also choose between the “Production” version or “Development” version of the app. When opening the app for the first time after download, you must register your FNAL certification. The proceduce is shown in the video below. Click the info button to get a moveable popup window for more information.
This video shows the step by step proceduce of obtaining a certificate through CILogin.
In particular
you set a go to CILogin, select FermiLab, sign in, set the password for the certificate, download it, and move
it to the App folder. You are then able to attach the certificate with the set username and password.
Once you have logged in, you will see the following:
Provide your name. Will be used for locally saved file names.
Provide at least one E-mail address. Will be used to send our Emails.
Select your institution by tapping it. Will be used when request the HWDB to generate a new PID(s).
PID Display
The PID Display is a PID viewer that is hierarchically structured, meaning you are first provided the highest-level category System ID from which you can specify until you reach the desired PID. If you have previously synced to the HWDB for that Component Type, the display orders the PIDs based on what are stored locally (SQLite). This is useful if you need PID lists (particularly long lists) with poor network connections.
The proceduce is shown in the video below. Click the info button to get a moveable popup window for more information.
This video shows the use of the PID Display. The PID Display is set up in a heirachical
manner, where the most broad categories are at the highest level and is specified at each subsequent level.
In particular: System -> Subsystem -> Component Type -> PID.
Once you are at the PID, you have several options: info, test, and qr-code.
With info you can get more information about the part including subcomponents. With test you can check the test
types associated with the item, as well as the history of those test types. With qr you can generate a qr code
for the part and save it.
You will notice that each level of the PID Display can be independently updated to sync with the HWDB, but it can also be done all at once using the “Sync All” button present on the top right of the System ID list page. It takes some time to sync them all. But it ultimately depends on the amount of the contents the DB currently holds. For now, it takes only ~2mins.
Shipment Tracker
The Shipment Tracker provides a UI to deal with Location info of components in the HWDB. It allows you to easily view the location history of an Item, provides info on sub-components (if any exist). It also allows you to enter a new location and create a new item for which you can produce the corresponsing QR-code. It also lets you attach a picture associated with a particular location.
You pick a particular Component Type to start. E.g., a Component Type, DUNE CPA shipping crate. Select an existing or create PID. E.g., a PID = one of your DUNE CPA shipping crates. If any, assign its sub-component PIDs. E.g., PIDs for CPA assembly tools and CPA Panels. Start by selecting a Component Type (e.g., a Type for shipping crate).You can select one either by scanning a QR code (see below)or select from the list (see the next page). You could also select a Component Type from the list. It shows Types that have been previously selected on your iPad. If you don’t see what you want, you can add a new Type.
The proceduce is shown in the video below. Click the info button to get a moveable popup window for more information.
This video shows one of the two ways to add component types to the shipment tracker. This is the easier of the two, allowing you to simply scan the qr code. Clicking on the item scanned sends you to the location history of that particular item.
This video shows one of the two ways to add component types to the shipment tracker. In the case you do not have the qr code you can add the component type through the PID Display. Once you have selected a component type, you can select it on the shipment tracker home page and directly add PIDs to it.
The location history is shown in the order of “Time(CST)”. You can add a new log or look at the individual entry more in detail. The proceduce is shown in the video below. Click the info button to get a moveable popup window for more information.
This video shows you the features of the History Log of a certain PID. You can access any
individual log and email the details.
These logs cannot be modified once they are submitted.
You can also create a new log, where you can record comments and add pictures by taking a
picture through the app. You can also edit your local date and time, which is converted to CST for
storage purposes.
Upon saving, an email is automatically generated with the details of the picture you added.
Currently, the HWDB does not have the capability to link an image to a location entry. The information, therefore, is stored as a Test of the PID with Test Type Name = _location_info.
Upon adding a component type to the shipment tracker, you can directly add PIDs . You can also assign subcomponents here. The proceduce is shown in the video below. Click the info button to get a moveable popup window for more information.
Through this you can add PIDs to a specific component type. You can also add available subcomponents to the PID based on its definition.
QR-Code
QR-codes are easy to generate on the iPad app. The proceduce is shown in the video below. Click the info button to get a moveable popup window for more information.
Returning to the History log of a particular PID, we can also generate a qr-code for the PID.
Additional lines can also be added if desired and the qr-code can be saved in a variety of formats.
The qr-code can also be directly printed through the app using AirPrint.
Local Storage
The info of the generated “Type List” is stored within the app folder. CPAProductionChecklists -> Tracker -> _tracker_typeidlist Pictures taken in the app and QR codes generated are also stored in the Tracker folder.
Individual user information is stored here, except for sensitive data like passwords.
Local Database is stored here.
Where Type List information is stored.
Where images captured throught the app are stored
Where QR-codes generated by the app are stored.
Key Points
Currently need to send an email to Hajime Muramatsu to register your iPad.
For the Mac version, you can directly download (a zip file). It runs with both Intel/Apple chips.