Skip to content

Simplify and standardize testing of BeagleBoard.org designs

License

Notifications You must be signed in to change notification settings

stashlukj/beagle-tester

 
 

Repository files navigation

beagle-tester

Supported boards

Supported scanners

Software setup

For production, the boards should be flashed with an approved production image ahead of beginning this test. No additional software setup steps should be performed. The first 12 characters of the EEPROM should also be valid ahead of running this test, though the additional serial number characters need not and should not be programmed until this test is run.

If not already setup, on a recent BeagleBoard.org Debian image, perform:

apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y roboticscape
cd /opt/source
git clone https://github.com/jadonk/beagle-tester
cd beagle-tester
make && make install

Serial number barcode format

Each board that has an on-board EEPROM should have an associated 16 digit serial number placed onto a barcode on the board.

The first 4 ASCII characters indicate the board type:

  • BeagleBone Black - 00C0
  • BeagleBone Black Wireless - BWA5
  • BeagleBone Blue - BLA2

The second 4 characters should indicate the manufacturing week in the format YYWW, where YY is currently 16 and WW is currently 30.

The next 4 characters should be a manufacturer-specific product code. If you are a new manufacturer, please choose something unique you can use to identify your boards.

Allocations include, but are not limited to:

  • BBGW for GHI manufactured BeagleBone Black Wireless
  • ELnn for Embest manufactured BeagleBone Blue

The final 4 characters are a sequential decimal number. If more than 10,000 boards are manufactured that week, roll over the top digit to an ASCII hex character.

BeagleBone Black

Required equipment

  • TV: HDMI TV capable of 1280x720p60 (720p) (HDMI monitor if no audio testing) with HDMI-to-microHDMI cable
  • Router: Ethernet router (configured to answer DHCP requests and answer pings on the provided gateway) with Ethernet cable
  • Host: BeagleBone Black or other computer (configured to make DHCP requests over USB RNDIS interface and answer pings)
  • Scanner: A supported barcode scanner (listed above) (along with a suitable 16 character barcode on the device under test)
  • Power: Approved 5V power brick
  • DUT: BeagleBone Black (device) under test

Test steps

  1. Connect microHDMI on DUT to TV
  2. Connect Ethernet on DUT to router
  3. Connect a wire from TP4 to ground to enable EEPROM writing of board revision and serial number
  4. Connect DUT to power
  5. Wait for the BeagleBoard.org desktop to show (should be under 2 minutes)
  6. Connect scanner
  7. Wait for the CISPR test animation and audio playback (should be under 15 seconds) CISPR image
  8. Connect USB client port on DUT to host
  9. Scan the 16 character barcode
  10. Pass or fail will be indicated by a respectively green or red box on the TV
  11. Disconnect scanner
  12. Disconnect host
  13. Disconnect power
  14. Disconnect remaining devices

BeagleBone Black Wireless

Required equipment

  • TV: HDMI TV capable of 1280x720p60 (720p) (HDMI monitor if no audio testing) with HDMI to microHDMI cable
  • AP: BeagleBone Black Wireless acting as a WiFi access point (should be default on production image) (SSID: BeagleBone-XXXX, PSK: BeagleBone)
  • Host: BeagleBone Black Wireless or other computer (configured to make DHCP requests over USB RNDIS interface and answer pings)
  • Scanner: Supported barcode scanner (listed above) (along with a suitable 16 character barcode on the device under test)
  • Power: Approved 5V power brick
  • DUT: BeagleBone Black Wireless (device) under test

Test steps

  1. Ensure AP is functioning nearby
  2. Connect microHDMI on DUT to TV
  3. Connect a wire from TP1 to ground to enable EEPROM writing of board revision and serial number
  4. Connect DUT to power
  5. Wait for the BeagleBoard.org desktop to show (should be under 2 minutes)
  6. Connect USB host on DUT to scanner
  7. Wait for the CISPR test animation and audio playback (should be under 15 seconds) CISPR image
  8. Connect USB client on DUT to host
  9. Scan the 16 character barcode
  10. Pass or fail will be indicated by a respectively green or red box on the TV
  11. Disconnect scanner
  12. Disconnect host
  13. Disconnect power
  14. Disconnect remaining devices

BeagleBone Blue

Required equipment

  • AP: BeagleBone Blue acting as a WiFi access point (use beagle-tester-host-setup.sh script) (SSID: BeagleBone-XXXX, PSK: BeagleBone)
  • Host: BeagleBone Blue or other computer (configured to make DHCP requests over USB RNDIS interface and answer pings, use beagle-tester-host-setup.sh script)
  • Scanner: Supported barcode scanner (listed above) (along with a suitable 16 character barcode on the device under test)
  • Power: Approved 12V power brick
  • DUT: BeagleBone Blue (device) under test

Test steps

  1. Ensure AP is functioning nearby
  2. Connect a wire from WP to GND to enable EEPROM writing of board revision and serial number
  3. Connect DUT to power
  4. Connect USB host on DUT to scanner
  5. Wait for the G and R LEDs to be lit
  6. Connect USB client on DUT to host
  7. Scan the 16 character barcode
  8. Pass or fail will be indicated by respectively G or R led flashing exclusively (blue LEDs 0-3 will flash indicating the test number executing and if blue LEDs 0-3 stop flashing before G or R begin flashing, then the board hung and failed)
  9. Disconnect scanner
  10. Disconnect host
  11. Disconnect power

BeagleBoard-xM

Required equipment

  • TV: DVI-D/HDMI TV capable of 1280x1024 with HDMI cable
  • Router: Ethernet router (configured to answer DHCP requests and answer pings on the provided gateway)
  • Host: BeagleBone Black or other computer (configured to make DHCP requests over USB RNDIS interface and answer pings)
  • Scanner: Supported barcode scanner (listed above) (along with a suitable 16 character barcode on the device under test)
  • Flashdrives: Three (3) USB 2.0 HS capable flash drives
  • Speaker: Speaker with 1/8" audio patch cable
  • Power: Approved 5V power brick
  • DUT: BeagleBoard-xM (device) under test

Test steps

  1. Connect HDMI on DUT to TV
  2. Connect Ethernet on DUT to router
  3. Connect 3x USB host on DUT to flashdrives
  4. Connect audio output on DUT to speaker
  5. Connect DUT to power
  6. Wait for the BeagleBoard.org desktop to show (should be under 2 minutes)
  7. Connect USB host on DUT to scanner
  8. Wait for the CISPR test animation and audio playback (should be under 15 seconds) CISPR image
  9. Connect USB client on DUT to host
  10. Scan a barcode to begin the test
  11. Pass or fail will be indicated by a respectively green or red box on the TV xM pass image
  12. Disconnect scanner
  13. Disconnect host
  14. Disconnect power
  15. Disconnect remaining devices

About

Simplify and standardize testing of BeagleBoard.org designs

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 92.9%
  • Shell 4.2%
  • Makefile 1.8%
  • Python 1.1%