Morph 4K: Difference between revisions

Line 1,181:

:# Click on Mobile Hotspot

:# Verify Band is set to 2.4 GHz

== Updating Firmware ==

=== Updating via WiFi ===

[[File:Morph_4K_Firmware_Update_Complete.png|thumb|300px|right|Example of Update Firmware screen after Morph's firmware updater completes the download, verify, and install steps]]

''You must complete [[Morph_4K#WiFi_Setup_Wizard|WiFi Setup Wizard]] in order to proceed. Also as of the 3.9.x firmware, a microSD is always required to run Update Firmware.''

# With Morph connected to WiFi, open the main menu and go to System > Firmware > Update Channel.

# Choose either the stable or testing channel (stable is recommended), then press OK on the remote to save this setting.

# Back on the Firmware menu, select Check for Update.

#* If an update is available, you will see the message "New version is available for download." Press OK on the remote to view the Firmware Changelog and then press OK again to begin the update.

#* If no update is available, you will see the message "Firmware is up-to-date". Press back on the remote to return to the Firmware menu.

# Select Update Firmware and then press OK on the remote to begin the process.

#* Morph will first download the latest update to the device and then install it. Please wait for this process to finish before attempting to use or power off Morph via physical switch (same goes for standby via remote power button).

#* If the firmware downloads, but fails to install, then remove the microSD card from the Morph, insert it into your PC, and delete the '''fw''' and '''update''' folders. Then place the microSD back into the Morph and repeat the previous steps.

# When the update has finished installing, you will see the message "Bootloader is up-to-date!" as shown in the picture on the right. Press OK on the remote to restart Morph.

# The main menu will appear letting you know the latest firmware has installed. Press OK on the remote to mark this version as valid.

#* If for any reason you prefer to revert to the previously installed version, press back on the remote.

If the firmware fails to download, then re-attempt the update with System > Firmware > Update Firmware after you apply these troubleshooting steps:

:* Go to System > Wifi and confirm Morph's SignalQ percentage, the signal quality strength to the router, is at least ~50% or move it closer to the router

:* Confirm the router's 2.4 GHz band is separate from 5 GHz (Morph's WiFi antenna only supports 2.4 GHz)

:* Confirm the router's 2.4 GHz band is not using a VPN (the VPN tunnel may slow internet traffic)

:* Confirm the router's 2.4 GHz band has the channel set to either 1, 6, or 11 (these are non-overlapping channels; others are more susceptible to interference)

:* If everything above is correct, then as a last resort restart the router

:# Unplug the power cable/turn off the router

:# Wait 60 seconds and then plug the power cable back in/turn on the router

:# Wait at least 5 minutes for the router to re-establish internet connectivity to all devices

These steps should resolve the issue. However if you are still unable to update Morph via WiFi, then attempt to update via SD card instead.

=== Updating via SD Card ===

[[File:Pixel_FX_Firmware_Download_Website.png|thumb|300px|right|[https://firmware.pixelfx.co/ PixelFX Firmware Download Website]]]

When no WiFi access is available, especially if Morph is on launch firmware v3.0.5, it is possible to update Morph using the [[Morph_4K#MicroSD_Port|microSD port]] on the front of the device. Morph supports both exFAT and FAT32 formats.

==== Download Firmware to MicroSD ====

The latest Morph firmware can be downloaded in a few ways.

*; Directly from [https://firmware.pixelfx.co/ https://firmware.pixelfx.co/]

# Select Morph4K from the product list. You must have your Device ID ready in order to download it.

#* The Device ID is found either in the Morph menu under System > Info or in the [http://morph4k.local/ Web Interface] after clicking on [[Morph_4K#Device_Info|Show Device Info]].

# Once you've added the Device ID, choose the stable version (or testing, if you prefer) and click on Download Firmware.

# After the firmware file has finished downloading, place it on the root directory of the microSD card and rename it '''morph4k-update.fx'''. Then safely eject the microSD from your computer.

*; Using Morph to generate a direct download link via text file to the microSD

# Insert a microSD card into Morph while fully powered off via physical switch (not standby mode via remote power button), then briefly hold down the first button from the left (O underneath it) and turn it on.

# Morph's LED will double-blink red continuously while it writes a text file to the root of the microSD card called ''firmware-download-url.txt''. This file contains a link that you can use to automatically download the latest firmware from the last chosen [[Morph_4K#Update_Channel|Update Channel]].

#* This is also another way to retrieve the Device ID via the URL path <code>...uuid='''<Device ID>'''&pid=morph4k...</code> and it's visible in the downloaded file name <code>morph4k-update-testing_'''<Device ID>'''.fx</code>.

# After the firmware file has finished downloading, place it on the root directory of the microSD card and rename it '''morph4k-update.fx'''. Then safely eject the microSD from your computer.

*; Using Morph's Web Interface

# If you've successfully connected Morph to your local SSID by following the [[Morph_4K#WiFi_Setup_Wizard|WiFi Setup Wizard]] (even though you're unable to update via WiFi), then the firmware file can be downloaded from the [http://morph4k.local/ Web Interface] under the [[Morph_4K#Manual_FW_Update|Manual FW Update]] section by clicking '''Download firmware for manual update'''.

# This will redirect you to the [https://firmware.pixelfx.co/ PixelFX Firmware Download Website] with a pre-populated Device ID. You can choose the latest stable version (or testing, if you prefer) and click on Download Firmware.

# After the firmware file has finished downloading, place it on the root directory of the microSD card and rename it '''morph4k-update.fx'''. Then safely eject the microSD from your computer.

Once you have the latest firmware file on the microSD, proceed with one of the two update methods below.

==== Method A. Flash Morph with MicroSD Card ====

# With Morph fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.

# Briefly hold down the first button from the left (O underneath it) on Morph and turn it on.

# Morph's LED will double-blink red, then double-blink green about five times, and then double-blink yellow continuously. This means the flashing process is underway.

# Once it is complete, the LED will remain white. At this point, you can power cycle the Morph.

# Open the main menu to see from the bottom right-hand corner that Morph is now running the latest firmware.

==== Method B. Using "Update Firmware from SD Card" ====

[[File:Morph_4K_Firmware_Submenu.png|thumb|300px|right|Example of the Firmware submenu with the option for Update Firmware from SD Card available when a microSD card is detected]]

''Morph must be on at least firmware version 3.1.0 to proceed''

# With Morph fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.

# Turn Morph on, open the main menu, and go to System > Firmware > Update Firmware from SD Card.

# You will see two fields, Current FW and Install FW, along with the chosen firmware file at the bottom.

#* If you see ''morph4k-update.fx.verified'', then press right on the remote once to select the '''morph4k-update.fx''' file.

#* You can tell the file is correct when the Install FW is now different from the Current FW.

# Press OK on the remote to start installing the firmware.

# Once complete, press OK again to restart Morph.

# The main menu will appear letting you know the latest firmware has installed. Press OK on the remote to mark this version as valid.

#* If a ''morph4k-update.fx.verified'' file was already on the microSD card, it will be overwritten with the latest firmware version.

=== Using the Rescue System ===

In the event you're unable to access Morph's main menu and [[Morph_4K#Web_Interface|Web Interface]], such as experiencing power failure during a firmware update, then you can use the Rescue System to re-flash Morph with the latest firmware.

==== Rescue System via WiFi ====

[[File:Rescue_System_with_Reformat_Filesystem.png|thumb|300px|right|[http://192.168.4.1/rescue.html Rescue page] accessible from Morph's '''Rescue-System''' SSID]]

# Start with Morph fully powered off via physical switch (not standby mode via remote power button), briefly hold down the first button from the left (O underneath it) on Morph and turn it back on.

# Morph's LED will double-blink red continuously. This means Morph is in Rescue System mode and is broadcasting a private WiFi connection.

# Using a laptop or desktop with wireless connectivity, open the WiFi connections list and click on the SSID labeled '''Rescue-System'''.

#* Enter the password '''Rescue-System''' (same as SSID) and wait for your device to complete the connection.

#* If DHCP is disabled on your device and you're using a static IP address, be sure to re-enable DHCP in order to connect to the '''Rescue-System''' SSID.

# In your browser, go to the address [http://192.168.4.1/rescue.html http://192.168.4.1/rescue.html]. Keep the browser window open and switch your laptop/desktop back to your local SSID.

# Go back to the browser window and click on Firmware Download. This will take you to the [https://firmware.pixelfx.co/ PixelFX Firmware Download Website] with a pre-populated Device ID.

# In the version list, choose the latest stable version (or testing, if you prefer) and click on Download Firmware.

# After the firmware file has finished downloading, rename it '''morph4k-update.fx'''.

# Switch back to the '''Rescue-System''' SSID and return to the browser window with the address [http://192.168.4.1/rescue.html http://192.168.4.1/rescue.html].

#* Refresh the browser window to make sure the rescue page is still accessible while connected to the '''Rescue-System''' SSID.

# Click on Browse... and select the '''morph4k-update.fx''' file.

# You will see the option to Reformat Filesystem. Leave this unchecked for now.

# Click on Upload and wait patiently while the firmware file uploads and then installs on Morph.

# Once complete, you will see a "Successfully Updated Firmware" message in the browser window. Morph will automatically restart.

#* If the process fails, then click on Browse... and select the '''morph4k-update.fx''' file again.

#* Check the box next to Reformat Filesystem. This will factory reset the Morph, deleting all custom profiles and stored data.

#* Click on Upload and wait patiently while Morph's filesystem is reformatted, then the firmware file will upload and install on Morph.

#* Once complete, you will see a "Successfully Updated Firmware" message in the browser window. Morph will automatically restart.

# It is now safe to use Morph. Open the main menu to confirm the latest firmware has installed.

These steps should recover Morph to a working state. However if you are still unable to recover Morph through the Rescue System via WiFi, then attempt the Rescue System via SD card instead.

==== Rescue System via SD Card ====

# Take the '''morph4k-update.fx''' file that you downloaded during the [[Morph_4K#Rescue_System_via_WiFi|Rescue System via WiFi]] steps and place it on the root directory of a microSD card (both FAT32 and exFAT are supported).

# Safely eject the microSD from your computer. Make sure Morph is fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.

# Briefly hold down the first button from the left (O underneath it) on Morph and turn it on.

# Morph's LED will double-blink red, then double-blink green about five times, and then double-blink yellow continuously. This means the flashing process is underway.

# Once it is complete, the LED will remain white. At this point, you can power cycle the Morph.

# Open the main menu to see from the bottom right-hand corner that Morph is now running the latest firmware.

==== Common Errors ====

:* Error -7: Usually caused by filesystem corruption, try again with the "Reformat Filesystem" option selected.

:* Error -18: Incorrect firmware. A checksum or device-Id does not match. Start the process again and follow the instructions to download the firmware for your target unit. Do not attempt to use firmware downloaded on another Morph unit.

==== Updating the Rescue System ====

New firmware specifically for the rescue system may occasionally be released. Please only update your rescue system firmware if instructed to do so by PixelFX support. To update the Rescue System firmware, follow the steps below.

# Place the '''morph4k-rescue.binc''' file, provided to you by PixelFX support, onto the root directory of a microSD card (both FAT32 and exFAT are supported).

# Safely eject the microSD from your computer. Make sure Morph is fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.

# Power on Morph, open the main menu, and navigate to System > Firmware where you should see the option Rescue Mode Update.

#* If you do not see the option Rescue Mode Update, check that your SD card is inserted and that you copied the update file correctly.

# Select Rescue Mode Update, press OK on the remote and then press OK again to confirm.

# When the update is complete, you should see the message "Rescue update successfully finished!". Press the back button and the process is complete.

@@ Line 1,181: / Line 1,181: @@
 :# Click on Mobile Hotspot
 :# Verify Band is set to 2.4 GHz
+== Updating Firmware ==
+=== Updating via WiFi ===
+[[File:Morph_4K_Firmware_Update_Complete.png|thumb|300px|right|Example of Update Firmware screen after Morph's firmware updater completes the download, verify, and install steps]]
+''You must complete [[Morph_4K#WiFi_Setup_Wizard|WiFi Setup Wizard]] in order to proceed.  Also as of the 3.9.x firmware, a microSD is always required to run Update Firmware.''
+# With Morph connected to WiFi, open the main menu and go to System > Firmware > Update Channel.
+# Choose either the stable or testing channel (stable is recommended), then press OK on the remote to save this setting.
+# Back on the Firmware menu, select Check for Update.
+#* If an update is available, you will see the message "New version is available for download."  Press OK on the remote to view the Firmware Changelog and then press OK again to begin the update.
+#* If no update is available, you will see the message "Firmware is up-to-date".  Press back on the remote to return to the Firmware menu.
+# Select Update Firmware and then press OK on the remote to begin the process.
+#* Morph will first download the latest update to the device and then install it.  Please wait for this process to finish before attempting to use or power off Morph via physical switch (same goes for standby via remote power button).
+#* If the firmware downloads, but fails to install, then remove the microSD card from the Morph, insert it into your PC, and delete the '''fw''' and '''update''' folders.  Then place the microSD back into the Morph and repeat the previous steps.
+# When the update has finished installing, you will see the message "Bootloader is up-to-date!" as shown in the picture on the right. Press OK on the remote to restart Morph.
+# The main menu will appear letting you know the latest firmware has installed.  Press OK on the remote to mark this version as valid.
+#* If for any reason you prefer to revert to the previously installed version, press back on the remote.
+If the firmware fails to download, then re-attempt the update with System > Firmware > Update Firmware after you apply these troubleshooting steps:
+:* Go to System > Wifi and confirm Morph's SignalQ percentage, the signal quality strength to the router, is at least ~50% or move it closer to the router
+:* Confirm the router's 2.4 GHz band is separate from 5 GHz (Morph's WiFi antenna only supports 2.4 GHz)
+:* Confirm the router's 2.4 GHz band is not using a VPN (the VPN tunnel may slow internet traffic)
+:* Confirm the router's 2.4 GHz band has the channel set to either 1, 6, or 11 (these are non-overlapping channels; others are more susceptible to interference)
+:* If everything above is correct, then as a last resort restart the router
+:# Unplug the power cable/turn off the router
+:# Wait 60 seconds and then plug the power cable back in/turn on the router
+:# Wait at least 5 minutes for the router to re-establish internet connectivity to all devices
+These steps should resolve the issue.  However if you are still unable to update Morph via WiFi, then attempt to update via SD card instead.
+=== Updating via SD Card ===
+[[File:Pixel_FX_Firmware_Download_Website.png|thumb|300px|right|[https://firmware.pixelfx.co/ PixelFX Firmware Download Website]]]
+When no WiFi access is available, especially if Morph is on launch firmware v3.0.5, it is possible to update Morph using the [[Morph_4K#MicroSD_Port|microSD port]] on the front of the device.  Morph supports both exFAT and FAT32 formats.
+==== Download Firmware to MicroSD ====
+The latest Morph firmware can be downloaded in a few ways.
+*; Directly from [https://firmware.pixelfx.co/ https://firmware.pixelfx.co/]
+# Select Morph4K from the product list.  You must have your Device ID ready in order to download it.
+#* The Device ID is found either in the Morph menu under System > Info or in the [http://morph4k.local/ Web Interface] after clicking on [[Morph_4K#Device_Info|Show Device Info]].
+# Once you've added the Device ID, choose the stable version (or testing, if you prefer) and click on Download Firmware.
+# After the firmware file has finished downloading, place it on the root directory of the microSD card and rename it '''morph4k-update.fx'''.  Then safely eject the microSD from your computer.
+*; Using Morph to generate a direct download link via text file to the microSD
+# Insert a microSD card into Morph while fully powered off via physical switch (not standby mode via remote power button), then briefly hold down the first button from the left (O underneath it) and turn it on.
+# Morph's LED will double-blink red continuously while it writes a text file to the root of the microSD card called ''firmware-download-url.txt''.  This file contains a link that you can use to automatically download the latest firmware from the last chosen [[Morph_4K#Update_Channel|Update Channel]].
+#* This is also another way to retrieve the Device ID via the URL path <code>...uuid='''<Device ID>'''&pid=morph4k...</code> and it's visible in the downloaded file name <code>morph4k-update-testing_'''<Device ID>'''.fx</code>.
+# After the firmware file has finished downloading, place it on the root directory of the microSD card and rename it '''morph4k-update.fx'''.  Then safely eject the microSD from your computer.
+*; Using Morph's Web Interface
+# If you've successfully connected Morph to your local SSID by following the [[Morph_4K#WiFi_Setup_Wizard|WiFi Setup Wizard]] (even though you're unable to update via WiFi), then the firmware file can be downloaded from the [http://morph4k.local/ Web Interface] under the [[Morph_4K#Manual_FW_Update|Manual FW Update]] section by clicking '''Download firmware for manual update'''.
+# This will redirect you to the [https://firmware.pixelfx.co/ PixelFX Firmware Download Website] with a pre-populated Device ID.  You can choose the latest stable version (or testing, if you prefer) and click on Download Firmware.
+# After the firmware file has finished downloading, place it on the root directory of the microSD card and rename it '''morph4k-update.fx'''.  Then safely eject the microSD from your computer.
+Once you have the latest firmware file on the microSD, proceed with one of the two update methods below.
+==== Method A. Flash Morph with MicroSD Card ====
+# With Morph fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.
+# Briefly hold down the first button from the left (O underneath it) on Morph and turn it on.
+# Morph's LED will double-blink red, then double-blink green about five times, and then double-blink yellow continuously.  This means the flashing process is underway.
+# Once it is complete, the LED will remain white. At this point, you can power cycle the Morph.
+# Open the main menu to see from the bottom right-hand corner that Morph is now running the latest firmware.
+==== Method B. Using "Update Firmware from SD Card" ====
+[[File:Morph_4K_Firmware_Submenu.png|thumb|300px|right|Example of the Firmware submenu with the option for Update Firmware from SD Card available when a microSD card is detected]]
+''Morph must be on at least firmware version 3.1.0 to proceed''
+# With Morph fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.
+# Turn Morph on, open the main menu, and go to System > Firmware > Update Firmware from SD Card.
+# You will see two fields, Current FW and Install FW, along with the chosen firmware file at the bottom.
+#* If you see ''morph4k-update.fx.verified'', then press right on the remote once to select the '''morph4k-update.fx''' file.
+#* You can tell the file is correct when the Install FW is now different from the Current FW.
+# Press OK on the remote to start installing the firmware.
+# Once complete, press OK again to restart Morph.
+# The main menu will appear letting you know the latest firmware has installed.  Press OK on the remote to mark this version as valid.
+#* If a ''morph4k-update.fx.verified'' file was already on the microSD card, it will be overwritten with the latest firmware version.
+=== Using the Rescue System ===
+In the event you're unable to access Morph's main menu and [[Morph_4K#Web_Interface|Web Interface]], such as experiencing power failure during a firmware update, then you can use the Rescue System to re-flash Morph with the latest firmware.
+==== Rescue System via WiFi ====
+[[File:Rescue_System_with_Reformat_Filesystem.png|thumb|300px|right|[http://192.168.4.1/rescue.html Rescue page] accessible from Morph's '''Rescue-System''' SSID]]
+# Start with Morph fully powered off via physical switch (not standby mode via remote power button), briefly hold down the first button from the left (O underneath it) on Morph and turn it back on.
+# Morph's LED will double-blink red continuously.  This means Morph is in Rescue System mode and is broadcasting a private WiFi connection.
+# Using a laptop or desktop with wireless connectivity, open the WiFi connections list and click on the SSID labeled '''Rescue-System'''.
+#* Enter the password '''Rescue-System''' (same as SSID) and wait for your device to complete the connection.
+#* If DHCP is disabled on your device and you're using a static IP address, be sure to re-enable DHCP in order to connect to the '''Rescue-System''' SSID.
+# In your browser, go to the address [http://192.168.4.1/rescue.html http://192.168.4.1/rescue.html].  Keep the browser window open and switch your laptop/desktop back to your local SSID.
+# Go back to the browser window and click on Firmware Download.  This will take you to the [https://firmware.pixelfx.co/ PixelFX Firmware Download Website] with a pre-populated Device ID.
+# In the version list, choose the latest stable version (or testing, if you prefer) and click on Download Firmware.
+# After the firmware file has finished downloading, rename it '''morph4k-update.fx'''.
+# Switch back to the '''Rescue-System''' SSID and return to the browser window with the address [http://192.168.4.1/rescue.html http://192.168.4.1/rescue.html].
+#* Refresh the browser window to make sure the rescue page is still accessible while connected to the '''Rescue-System''' SSID.
+# Click on Browse... and select the '''morph4k-update.fx''' file.
+# You will see the option to Reformat Filesystem.  Leave this unchecked for now.
+# Click on Upload and wait patiently while the firmware file uploads and then installs on Morph.
+# Once complete, you will see a "Successfully Updated Firmware" message in the browser window.  Morph will automatically restart.
+#* If the process fails, then click on Browse... and select the '''morph4k-update.fx''' file again.
+#* Check the box next to Reformat Filesystem.  This will factory reset the Morph, deleting all custom profiles and stored data.
+#* Click on Upload and wait patiently while Morph's filesystem is reformatted, then the firmware file will upload and install on Morph.
+#* Once complete, you will see a "Successfully Updated Firmware" message in the browser window.  Morph will automatically restart.
+# It is now safe to use Morph.  Open the main menu to confirm the latest firmware has installed.
+These steps should recover Morph to a working state.  However if you are still unable to recover Morph through the Rescue System via WiFi, then attempt the Rescue System via SD card instead.
+==== Rescue System via SD Card ====
+# Take the '''morph4k-update.fx''' file that you downloaded during the [[Morph_4K#Rescue_System_via_WiFi|Rescue System via WiFi]] steps and place it on the root directory of a microSD card (both FAT32 and exFAT are supported).
+# Safely eject the microSD from your computer.  Make sure Morph is fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.
+# Briefly hold down the first button from the left (O underneath it) on Morph and turn it on.
+# Morph's LED will double-blink red, then double-blink green about five times, and then double-blink yellow continuously.  This means the flashing process is underway.
+# Once it is complete, the LED will remain white. At this point, you can power cycle the Morph.
+# Open the main menu to see from the bottom right-hand corner that Morph is now running the latest firmware.
+==== Common Errors ====
+:* Error -7: Usually caused by filesystem corruption, try again with the "Reformat Filesystem" option selected.
+:* Error -18: Incorrect firmware. A checksum or device-Id does not match. Start the process again and follow the instructions to download the firmware for your target unit. Do not attempt to use firmware downloaded on another Morph unit.
+==== Updating the Rescue System ====
+New firmware specifically for the rescue system may occasionally be released. Please only update your rescue system firmware if instructed to do so by PixelFX support. To update the Rescue System firmware, follow the steps below.
+# Place the '''morph4k-rescue.binc''' file, provided to you by PixelFX support, onto the root directory of a microSD card  (both FAT32 and exFAT are supported).
+# Safely eject the microSD from your computer.  Make sure Morph is fully powered off via physical switch (not standby mode via remote power button), insert the microSD card face up in the card reader.
+# Power on Morph, open the main menu, and navigate to System > Firmware where you should see the option Rescue Mode Update.
+#* If you do not see the option Rescue Mode Update, check that your SD card is inserted and that you copied the update file correctly.
+# Select Rescue Mode Update, press OK on the remote and then press OK again to confirm.
+# When the update is complete, you should see the message "Rescue update successfully finished!". Press the back button and the process is complete.