Vail Adapter Firmware Update

This page guides you through the process of updating the firmware on your Vail Adapter.

Step 1: Choose Vail Adapter version

Select the version of your Vail Adapter:

Step 2: Plug in Vail Adapter

Use a USC-C cable capable of data, and plug the adapter into your computer.

Step 3: Enter Boot Mode

Instructions on how to enter boot mode.

Activity Log:


    


    

        
Step 4: Download UF2 File

        
Select your adapter version above, then download the appropriate firmware file.

        Download UF2 File
    


    

        
Step 5: Drag and Drop UF2 File

        
Now that you have the firmware file, let's copy it to your Vail Adapter. Follow these steps carefully:

        
    
            
  1. Open File Explorer: Open your computer's file explorer (Finder on a Mac, File Explorer on Windows).
    2. 
            
  2. Find the UF2 File: Go to your "Downloads" folder, or wherever you saved the downloaded UF2 file from Step 4. You should see the file you just downloaded (e.g., "non_pcb_basic.uf2").
    3. 
            
  3. Look for the Adapter Drive: When your Vail Adapter is in boot mode (from Step 3), it will appear as a new USB drive on your computer. This drive might be named something like "ADAPTERBOOT", "QTPYBOOT", "RPI-RP2", or similar.
    4. 
            
  4. Drag and Drop: Click on the downloaded UF2 file, hold the mouse button down, and drag it over to the Vail Adapter drive that appeared in the previous step. Release the mouse button to drop the file onto the drive.
    5. 
            
  5. Wait for Completion: The LED on your Vail Adapter might flash rapidly while the file is being copied. Once the copy is complete, the adapter drive may automatically disappear from your file explorer. This is normal.
    6. 
        

        
If the drive doesn't disappear, wait about 30 seconds after the LED stops flashing before proceeding to the next step.

    


        

            
Step 6: Finalize Update

            
You're almost done! Follow these last few steps to complete the firmware update:

            
    
                
  1. Wait a Moment: After the UF2 file has been copied to the adapter (and the drive may have disappeared), wait about 10 seconds. This gives the adapter a little time to process the new firmware.
    2. 
                
  2. Unplug the Adapter: Carefully unplug the Vail Adapter from your computer's USB port.
    3. 
                
  3. Plug it Back In: Plug the Vail Adapter back into your computer's USB port.
    4. 
                
  4. IMPORTANT - GO TO https://vail.fly.dev/ OR https://vail.woozle.org/:  Go to a Vail Repeater site to set your key type, speed, and tone. This will save to the device so that it can be used in practice oscillator mode or with keyboard enabled sites like VBAND.
    5. 
            

            
That's it! The firmware update should now be complete, and your Vail Adapter is ready to use with the new firmware. You may see a new drive appear, or the device might enumerate differently, which is normal.