MBA2MFII

Introduction

MBA2MFII is designed to quickly and accurately convert data from the Measuring Mobile Broadband America ("MBA" or "FCC Speed Test") app released by the Federal Communications Commission ("FCC") into the Challenge Speed Test CSV file format required for the Mobility Fund Phase II ("MF-II") Challenge Process. Data recorded by the FCC Speed Test app can be exported in JSON format, which must be converted in order to be uploaded into the MF-II Challenge Process Portal, hosted by the Universal Service Administrative Company ("USAC").

Additional information about the MF-II Challenge Process, how to participate, and the USAC MF-II Challenge Portal is available on the MF-II webpage.

Installing

MBA2MFII is a command-line script that supports Python 2.7 or Python 3.

Install and update using pip:

pip install git+https://github.com/jonathanmccormack/mba2mfii

Usage

Command-line

Usage: mba2mfii [options] [INPUT]... [OUTPUT]

Optional Parameters:
    -i, --device-imei           Use specified Device IMEI
    -d, --device-id             Override device detection and use specified Device ID
    -p, --provider-id           Override provider detection and use specified Provider ID
        --clobber               Overwrite existing output file
        --dry-run               Perform all actions except writing output file
        --verbose               Increase verbosity to DEBUG level
    -h, --help                  Show this usage message and quit
        --version               Show version information about this script

Description

Converts one or more INPUTs to OUTPUT.

Arguments provided for INPUT should be either an individual JSON file or a folder containing JSON files exported from the FCC Speed Test app. INPUT files are converted and exported as OUTPUT in CSV format matching the Challenge Speed Test file structure.