LogoLogo
  • Volunteer Documentation
  • Help Center
    • Volunteering
      • Our National Broadand Studies
      • The Benefits of Volunteering
      • How Volunteers Are Selected
      • Becoming a Volunteer
      • Waiting List Status
      • Stopping Volunteering
    • Your Whitebox
      • Introduction to Your Whitebox
      • Whitebox Setup
      • Test Interruption (Cross-Traffic)
      • Whitebox Model Specs
      • Whitebox Data Usage
    • Your Account
      • Logging In
      • Introduction to Your Dashboard
      • Understanding Your Broadband Package
      • Changing Your Email Address
      • Changing Your Password
      • Changing Your Personal Details
      • Changing Providers or Packages
      • Pausing Email Alerts
      • Using Instant Tests
      • Viewing Your Raw Data
    • Our Tests
      • Our Core Tests
      • Our Test Servers
      • Our Test Access Points
      • Our Video Streaming Tests
      • Understanding Download and Upload Speeds
      • Understanding Latency and Packet Loss
      • Understanding Jitter
      • Understanding Single- Versus Multi-Thread
    • Troubleshooting
      • Troubleshooting Your Whitebox
      • Troubleshooting Cisco Real Speed Tests
  • What's New
    • Changelog
Powered by GitBook
On this page
  • Technology
  • Remote Updates
  • Firmware
  1. Help Center
  2. Your Whitebox

Introduction to Your Whitebox

Last updated 3 months ago

The Whitebox is a purpose-built hardware measurement device. It supports a wide range of network and application-specific measurements, including download speed, upload speed, video streaming, online gaming stability, latency, and packet loss, to name just a few. It can also detect the presence of user-generated cross traffic (see for more information).

The Whitebox is:

  • A dedicated device capable of highly accurate internet performance tests.

  • A trusted measurement unit that you can use to track your home internet performance, so you can be confident that you are getting the service you expect.

  • Part of our specially developed Test Kit, which is used by internet service providers (ISPs) and government regulators, and includes an account and dashboard.

The Whitebox is NOT...

  • a way to improve your internet speed or performance by itself.

  • a replacement for your router and/or modem.

  • a replacement for any other Wi-Fi access points in your home.

  • a smart meter for electricity and gas usage.

The Whitebox does not directly improve your internet performance. It provides you with the data to help you improve your internet performance.

Technology

The Whitebox stays in one place and only runs regular tests when you are not using the internet. This reduces the window for variables and other external factors that can influence the metrics. Thanks to this diligent testing method, the Whitebox gives you more consistent data about your home broadband performance over time.

Remote Updates

The Whitebox communicates with our cloud to retrieve its test schedule and configuration. These updates occur automatically, approximately once per hour. The Whitebox retrieves configuration updates using the IETF LMAP protocol, and communicates over HTTPS using TLS 1.2. Additionally, we will periodically issue firmware updates which are applied automatically by the Whitebox. No user interaction is required for the Whitebox to retrieve software or configuration updates.

Firmware

The Whitebox runs a custom distribution of Linux, derived from OpenWrt. Many standard OpenWrt features have been removed to save space on the device, and some additional features have been added to support the measurements.

The custom firmware is flashed at the factory and is not directly upgradeable by the user hosting the Whitebox. The firmware is remotely upgradeable by our team. This cut-down operating system provides network connectivity and the measurement applications alone – there is no web interface and the Whitebox provides no routing functionality. Users have no ability to disable, reconfigure or influence the Whitebox software in any way through normal usage.

Our firmware makes use of General Public License (GPL) v2.0 licensed code. We publish our firmware source code in compliance with the GPL.

All metrics and data gathered by your Whitebox can be viewed on your .

To find out more about how to interpret the data your Whitebox gathers, see . For different Whitebox model specifications, see .

account
Our Tests
Whitebox Model Specs
Test Interruption (Cross Traffic)
A cartoon of a Whitebox with legs and arms
View of top of real SamKnows Whitebox