fwupd/data/installed-tests
Richard Hughes 85226fd9d1 Remove potentially problematic language
Red Hat wants to drive an initiative in correcting problematic and potentially
divisive language in open source projects. These naming conventions and
descriptive phrases are hurtful and offensive to many of our colleagues across
the open source universe.

See https://www.redhat.com/en/blog/making-open-source-more-inclusive-eradicating-problematic-language
2020-06-30 17:31:17 +01:00
..
fakedevice123.bin Add an installed test for device update 2017-06-15 20:19:03 +01:00
fakedevice123.bin.asc Add an installed test for device update 2017-06-15 20:19:03 +01:00
fakedevice123.metainfo.xml Add an installed test for device update 2017-06-15 20:19:03 +01:00
fakedevice124.bin Add an installed test for device update 2017-06-15 20:19:03 +01:00
fakedevice124.bin.asc Add an installed test for device update 2017-06-15 20:19:03 +01:00
fakedevice124.metainfo.xml Add an installed test for device update 2017-06-15 20:19:03 +01:00
fwupd-tests.xml installed-tests: Adjust to actually use a remote for installed tests 2018-11-29 09:40:06 -06:00
fwupdmgr.sh trivial: remove references to hardware.py (Fixes: #2007) 2020-04-15 20:27:21 -05:00
fwupdmgr.test.in Add an installed test for device update 2017-06-15 20:19:03 +01:00
meson.build build: Re-use installed tests directory 2020-04-15 20:16:46 +01:00
README.md Remove potentially problematic language 2020-06-30 17:31:17 +01:00
remote.conf.in installed-tests: Adjust to actually use a remote for installed tests 2018-11-29 09:40:06 -06:00

Installed tests

A test suite that can be used to interact with a fake device is installed when configured with -Ddaemon=true and -Dtests=true.

By default this test suite is disabled.

Enabling

To enable the test suite:

  1. Modify /etc/fwupd/daemon.conf to remove the test plugin from DisabledPlugins
    # sed "s,^Enabled=false,Enabled=true," -i /etc/fwupd/remotes.d/fwupd-tests.conf
    
  2. Enable the fwupd-tests remote for local CAB files.
    # fwupdmgr enable-remote fwupd-tests
    

Using test suite

When the daemon is started with the test suite enabled a fake webcam device will be created with a pending update.

Integrated Webcam™
  DeviceId:             08d460be0f1f9f128413f816022a6439e0078018
  Guid:                 b585990a-003e-5270-89d5-3705a17f9a43
  Summary:              A fake webcam
  Plugin:               test
  Flags:                updatable|supported|registered
  Vendor:               ACME Corp.
  VendorId:             USB:0x046D
  Version:              1.2.2
  VersionLowest:        1.2.0
  VersionBootloader:    0.1.2
  Icon:                 preferences-desktop-keyboard
  Created:              2018-11-29

Upgrading

This can be upgraded to a firmware version 1.2.4 by using fwupdmgr update or any fwupd frontend.

$ fwupdmgr get-updates
Integrated Webcam™ has firmware updates:
GUID:                    b585990a-003e-5270-89d5-3705a17f9a43
ID:                      fakedevice.firmware
Update Version:          1.2.4
Update Name:             FakeDevice Firmware
Update Summary:          Firmware for the ACME Corp Integrated Webcam
Update Remote ID:        fwupd-tests
Update Checksum:         SHA1(fc0aabcf98bf3546c91270f2941f0acd0395dd79)
Update Location:         ./fakedevice124.cab
Update Description:      Fixes another bug with the flux capacitor to prevent time going backwards.

$ fwupdmgr update
Decompressing…         [***************************************]
Authenticating…        [***************************************]
Updating Integrated Webcam™…                                   ]
Verifying…             [***************************************] Less than one minute remaining…

Downgrading

It can also be downgraded to firmware version 1.2.3.

$ fwupdmgr downgrade
Choose a device:
0.	Cancel
1.	08d460be0f1f9f128413f816022a6439e0078018 (Integrated Webcam™)
2.	8a21cacfb0a8d2b30c5ee9290eb71db021619f8b (XPS 13 9370 System Firmware)
3.	d10c5f0ed12c6dc773f596b8ac51f8ace4355380 (XPS 13 9370 Thunderbolt Controller)
1
Decompressing…         [***************************************]
Authenticating…        [***************************************]
Downgrading Integrated Webcam™…               \                ]
Verifying…             [***************************************] Less than one minute remaining…