Automatic Device Discovery¶
Overview¶
The Automatic Device Discovery feature streamlines the onboarding process for mobile devices in the Quad TEO testing environment. When a new Android phone or iPhone is connected to a Test Node, the system automatically detects it and creates a preliminary device entry in the system. MCM modems are not discovered automatically; add them by hand (see MCM modem setup).
How It Works¶
- Connect a new mobile device to the Test Node via USB
- The system automatically detects the connection
- A new device entry is created on the Mobile Ids page
- Basic device information is automatically populated
- The device appears with a default name format:
NewDevice_<number>
Automatically Detected Parameters¶
The system automatically retrieves and records the following device information:
| Parameter | Description |
|---|---|
| UDID | Unique Device Identifier - a permanent device-specific string (stored as the Device ID) |
| Platform | Android or iOS |
| Device Model | Chosen from the brand and the major OS version, for example Samsung And_16 |
| MSISDN | Read from the phone when possible; otherwise a +00000… placeholder |
These parameters form the foundation for device identification within the test environment. The default RAN is LTE Auto.
Required Manual Configuration¶
After automatic discovery, several critical fields must be manually configured to ensure proper test execution:
| Field | Description | Importance |
|---|---|---|
| MSISDN | Mobile Subscriber ISDN Number (phone number), when it was not read from the phone | Critical for call/SMS testing |
| National Format | Local format of the phone number (not filled in automatically) | Required for proper dialing |
| IMSI | International Mobile Subscriber Identity | Essential for network identification |
| IMEI | International Mobile Equipment Identity | Required for device authentication |
⚠️ Important Warning: The system initially populates IMSI and IMEI with random placeholder values. These placeholders must be replaced with accurate information before conducting tests. Failure to update these values with correct information will result in test failures and unreliable results.
Why doesn't my phone appear?¶
- The OS version is not supported yet. A phone is registered only when TEO has a device model for its brand and major OS version (see Supported devices). Otherwise nothing is created and no message is shown. Contact Quadified support to add the model.
- iPhone support is off on the node. iPhones are discovered only when the Test Node has iPhone support enabled (see Advanced node settings).
- The phone is not trusted or not in developer mode. Check the USB debugging prompt (Android) or Trust This Computer and Developer Mode (iPhone), then reconnect the cable.
- It is an MCM modem. Modems are always added by hand.
Brands are recognised by the name the phone reports: "Redmi" phones are treated as Xiaomi and "Google" phones as Google Pixel.
Best Practices¶
- Rename the device from the default
NewDevice_<number>to a descriptive name that clearly identifies the device - Verify all information is correct before adding the device to any test suites