KIPR Wombat Firmware | KISS Institute for Practical Robotics

KIPR Wombat Firmware

Current Stable Firmware Version: 31.2.0
Please make sure you backup all your program files before you proceed! 

School networks frequently have blocks against websites like Github. If you are worried this may be an issue at your school we recommend trying the update on a home network.

If you feel as if you need help with this process, please contact us at 405-579-4609 or info@kipr.org.

Update via USB Flash Drive
  1. Download the firmware v31.2.0 below and copy the .zip file to a flash drive.
  2. Plug in your flash drive with the update as a zip file.
  3. Hit cancel if a window pops up.
  4. Go to Settings -> Update.
  5. Select the update from the list and tap USB Update.
  6. Wait for Wombat to reboot.
Click Here to Download v31.2.0.zip!
Previous Firmware Versions

USB Solution:  

  1. Plug in your flash drive with the update as a zip file.
  2. Hit cancel if a window pops up.
  3. Go to Settings -> Update.
  4. Select the update from the list and tap USB Update.
  5. Wait for Wombat to reboot.

Online Update Solution:  

  1. Connect your controller to a Wi-Fi network by navigating to Network screen. Click on Settings -> Advanced -> Network
  2. Once you are on the network screen, check the bottom left dropdown menu and make sure it is in Client Mode (Not AP Mode)
  3. Once in Client Mode, you can connect to an available network by tapping on the “Connect to…” button
  4. If you do not have Wi-Fi access, you can plug in an ethernet cable that is providing internet into controller instead of Wi-Fi. (This could be the one your computer is plugged into)
  5. Go to the Home screen
  6. Click on Settings
  7. Click on Update
  8. Click on Online Update
  9. Click Yes
  10. If you get an error that says git is not available, please update using the USB solution.

Program Backup & Transfer:

None Needed

USB Solution:  

  1. Extract the wombat-os-31.x.x.zip to a USB
  2. Make sure the extracted folder does  not have the same folder nested inside
  3. Plug in your flash drive to the controller
  4. Hit cancel if a window pops up.
  5. Go to Settings -> Update.
  6. Select the update from the list and tap USB Update.
  7. Wait for Wombat to reboot.

Online Update Solution:  

  1. Make sure your Wombat is not in the Create 3 Ethernet mode. This can be checked by going to Motors and Sensors -> Create 3 and making sure the toggle on the page is switched to Wi-Fi. If it is not, click the toggle and Yes to switch it to Wi-Fi mode. Wait for the Wombat to reboot, then check the page again to make sure it switched. You can also check the About page to see if the IP address 192.168.186.3 shows up when the Wombat is plugged into Ethernet. If it doesn’t all is fine. If it does, then repeat the process using the toggle on the Create 3 page.
  2. Connect your controller to a Wi-Fi network by navigating to Network screen. Click on Settings -> Advanced -> Network
  3. Once you are on the network screen, check the bottom left dropdown menu and make sure it is in Client Mode (Not AP Mode)
  4. Once in Client Mode, you can connect to an available network by tapping on the “Connect to…” button
  5. If you do not have Wi-Fi access, you can plug in an Ethernet cable that is providing internet into controller instead of Wi-Fi. (This could be the one your computer is plugged into)
  6. Go to the Home screen
  7. Click on Settings
  8. Click on Update
  9. Click on Online Update
  10. Click Yes

Program Backup & Transfer:

None Needed

Solution:  SD Card Swap

 

Program Backup & Transfer:

 

Option 1:  Download files using IDE

Option 2: Copy file contents to other documents

Option 3: Use Backup and Restore buttons under Settings -> Backup to transfer files to a flash drive that is plugged in and onto the new SD card once it is replaced. If files are named incorrectly (emojis, ? marks, etc.), they may not get copied.

Solution:  SD Card Swap

 

Program Backup & Transfer:

 

  1. Boot up Wombat and plug a mouse into it, a keyboard can also be helpful but is not necessary.
  2. Plug a micro SD reader into the Wombat with a new SD card in it.
  3. When a window pops up asking what you want to do, hit OK.
  4. On the side navigate to /home/kipr/Documents/KISS
  5. Copy all folders and users.json
  6. In the sidebar, scroll to the top and click rootfs
  7. Inside that go to /home/kipr/Documents/KISS
  8. Delete the users.json in this folder
  9. Paste your folders and users.json into this folder
  10. Turn off Wombat, and replace the SD card with the one you just modified
  11. Check to make sure programs are there

Solution:  SD Card Swap

 

Program Backup & Transfer:

 

  1. Boot up Wombat and plug a mouse into it, a keyboard can also be helpful but is not necessary.
  2. Plug a micro SD reader into the Wombat with a new SD card in it.
  3. Go to Settings -> Hide UI (If not visible, enable under Settings -> GUI).
  4. Open the file explorer by clicking the square icon in the bottom left corner.
  5. On the side navigate to /home/root/Documents/KISS
  6. Copy all folders and users.json
  7. In the sidebar, scroll to the top and click rootfs
  8. Inside that go to /home/kipr/Documents/KISS
  9. Delete the users.json in this folder
  10. Paste your folders and users.json into this folder
  11. Turn off Wombat, and replace the SD card with the one you just modified
  12. Check to make sure programs are there
Missing Your WiFi IP Address?

NOTE:

If your Wi-Fi IP address doesn’t show up right away on the About page, Enable and then Disable the Event Mode toggle and then refresh the About page by going Home and then back to About.
Explore the New Wombat IDE

If you're interested in testing out the new IDE for the Wombat, please download the image here:

Click here to download v32.0.0.img
Please note the new IDE is still in development and is not the current stable version for the Wombat. We'd love to hear your feedback!
KIPR Wombat OS Image

Please download the OS image and follow the instructions below.

 

KIPR Wombat Image V31.2.0

This can fix a variety of issues like a touch screen no longer responding or if you just want to erase everything that is currently on a controller.

Warning: This will remove all programs on the controller so be sure to back them up somewhere.

Image Reflash Instructions

  1. Save any programs you wish to keep to a device that is not the Wombat
  2. Obtain a screwdriver and a microSD card reader for this process and at least 8GB of space on your computer
  3. Download the Wombat-31.2.0.img file to your computer and unzip it
  4. While waiting for download, unscrew SD card cover on bottom of Wombat
  5. Pull out the SD card
  6. Insert SD card into the reader that is connected to your computer
  7. Hit cancel on anything asking you if want to reformat the drive that was just plugged in
  8. Download Balena Etcher or other similar image writing software.
  9. Once the image is downloaded, open Balena Etcher and click Flash from File and select the image file you just downloaded
  10. Then click Select Target and select the SD card drive that is plugged in (it should be about 8GB in size)
  11. Click Flash! and wait for it to finish
  12. Once it is finished, remove the SD card and put it back into the Wombat and screw the cover back on.