57 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			57 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
| Files in this directory are edited output from `solaar show` providing
 | |
| information about devices and receivers that Solaar supports.  This
 | |
| directory does not contain information about all devices and receivers that
 | |
| Solaar supports.  Information is generally only added when provided in a
 | |
| Solaar issue.
 | |
| 
 | |
| Directions for constructing the files are given below.  The files
 | |
|   Unifying Receiver C52B.txt
 | |
|   Craft Advanced Keyboard 4066.txt
 | |
|   Craft Advanced Keyboard B350.txt
 | |
|   MX Master 3 Wireless Mouse 4082.txt
 | |
|   MX Master 3 Wireless Mouse B023.txt
 | |
| are good examples of following the directions below.
 | |
| 
 | |
| 
 | |
| File Naming
 | |
| 
 | |
| Logitech device names are often reused so the names of files can't just be
 | |
| the device name.  File names start with the name of the device or receiver
 | |
| as given in the first line of of output for the device.  The file name
 | |
| continues with a space and the WPID, if the device is connected to a
 | |
| receiver, or the second half of the USB ID, if the device is connected via
 | |
| USB or Bluetooth.  The WPID or USB ID are in upper case.  As devices can
 | |
| behave differently when connected via a receiver or USB or Bluetooth there
 | |
| should be a file for each possible connection method.
 | |
| 
 | |
| Files that do not follow this naming convention are retained for historical purposes.
 | |
| 
 | |
| 
 | |
| File Contents
 | |
| 
 | |
| Each file should contain the output of `solaar show NAME` where NAME
 | |
| is enough of the full name of a device or receiver to identify it.
 | |
| The output of `solaar show` will provide information on all connnected
 | |
| devices and receivers including their names.
 | |
| The output of `solaar show NAME` can be edited
 | |
| to remove serial numbers and variable information such as the current values
 | |
| of settings.
 | |
| Passing the style requirements for Solaar documentation may require removing
 | |
| trailing white space on lines.
 | |
| 
 | |
| For older devices probes of the device registers should be
 | |
| included but for newer devices this is not necessary.
 | |
| 
 | |
| Unifying receivers can pair with any device that has the Unifying logo.
 | |
| Bolt receivers can pair with any device that has the Bolt logo.
 | |
| Nano and Lightspeed receivers can only pair with certain devices,
 | |
| so the end of their files should state the devices that they have
 | |
| been seen to be paired with or are part of.
 | |
| 
 | |
| 
 | |
| Updating Files
 | |
| 
 | |
| Newer versions of Solaar add support for more settings so it is useful to
 | |
| provide updated versions of these files if there is information from the
 | |
| current version of `solaar show NAME` that is not in the existing file.
 |