Skip to content

Web_console.md

Latest commit

 

History

History
227 lines (160 loc) · 7.97 KB

Web_console.md

File metadata and controls

227 lines (160 loc) · 7.97 KB

Web console

Jump to command reference

How to connect

If your DCHDMI is already connected to your local WiFi network:

  1. Open the OSD and go to WiFi Setup.

  2. Make sure it says [Connected] instead of [Access point] on the screen.

    WiFi connected

  3. Press Y to reveal the Web login password. You can skip that, if you set an password in the Web console's setup.

  4. Use a browser of your choice and enter the IP address shown next to IP address in the browsers address bar.

    If you are using macOS or Linux with a running avahi daemon or Windows with iTunes installed, you can also use DCHDMI's zeroconf-Hostname (default: dc-firmware-manager.local)

  5. A login window should open. Enter Web login username and Web login password.

  6. A command prompt should be displayed.

How to update the Firmware from the web console

This assumes your DCHDMI is connected to a WiFi network.

  1. Connect to the web console.

  2. Optional: use check to see, if a new firmware is available.

  3. download new firmware

  4. flash new firmware

  5. reset DCHDMI to (re-)start with the new firmware.

I don't want to connect my DCHDMI to my WiFi network, how do I update manually?

  1. Download the firmware files to your computer:

    a) Unified FPGA firmware: https://dc.i74.de/fw/master/DCxPlus-v2.dc

    If you're current firmware isn't v4.0 or newer, also download this Transitional FPGA firmware:
    https://dc.i74.de/fw/master/DCxPlus-default.dc

    b) ESP firmware: https://dc.i74.de/esp/master/4MB-firmware.bin

    c) Web console: https://dc.i74.de/esp/master/esp.index.html.gz

  2. Open the OSD and enter the WiFi Setup page.

  3. Make sure it says [Access point] on the screen.

    WiFi connected

  4. Press Y to reveal passwords.
    To be able to connect to the DCHDMI access point you will need the information marked red.
    For web console access you will need the information marked yellow.

    WiFi connected

  5. Connect your WiFi capable computer to the DCHDMI access point using:

    • SSID: Access point SSID

    • Password: Access point password

  6. When connected to DCHDMI AP, use a browser of your choice and enter 192.168.4.1 in the browsers address bar.

  7. The Web console should be displayed and setup mode should be started. Just hit CTRL-D to exit the setup.

  8. If your current firmware is v4.0 or newer:
    Use the select command and select the previously downloaded Unified FPGA firmware (DCxPlus-v2.dc) from the file chooser.

    If you're current firmware isn't v4.0 or newer:
    Use the select command and select the previously downloaded Transitional FPGA firmware (DCxPlus-default.dc) from the file chooser.

  9. uploadfpga to upload the file.

  10. Use select again to select the previously downloaded ESP firmware (4MB-firmware.bin).

  11. uploadesp to upload.

  12. Use select once again to select the Web console (esp.index.html.gz) file.

  13. And upload it using uploadindex.

  14. Now use flash to flash/apply all files to your DCHDMI.

  15. reset DCHDMI to (re-)start with the new firmware

  16. Only if you ugraded from a version before v4.0:

    1. Use the select command and select Unified FPGA firmware (DCxPlus-v2.dc) from the file chooser.

    2. uploadfpga to upload the file.

    3. You're now able to switch between Standard and Relaxed.

Commands

Basic commands

Command Description
config Show current DCHDMI configuration data
setup Enter setup mode, to edit configuration
check Check for new firmware using Firmware Server and Firmware Version configuration data
download Download firmware from Firmware Server to staging area
flash Flash firmware from staging area
reset Reset DCHDMI. This also resets the Dreamcast
help Show available basic commands
helpexpert Show available expert commands
clear Clear terminal screen
exit Exit terminal

Expert commands

Command Description
check[type](1) Check for new type firmware using Firmware Server and Firmware Version configuration data
select Select a file to upload from your computer
upload[type] Upload selected file to staging area for type
file Print information about selected file
download[type] Download type firmware from Firmware Server to staging area
flash[type] Flash type from staging area
reset[type](2) Reset type
cleanup Remove all staged firmware files and forget about previously flashed versions
ls List files in filesystem

(1) [type]: fpga, esp or index
(2) There is no resetindex command

Special commands

Command Description
flashfpgasecure Flash FPGA firmware while disabling the FPGA
banner Print DCHDMI banner
get_mac Print MAC address of DCHDMI
flash_chip_size Print ESP flash chip size
res_[resolution](1) Switch to resolution
deinterlace_[deint](2) Use deinterlacer deint (only works in 15kHz mode)
generate_on Generate test video image
generate_off Disable test video image
testdata Shows test screen
resetpll Reset PLL
osd (on,off) Show/hide OSD
hq2x (on,off) Activate/deactivate HQ2X filter (only in 960p/1080p mode with Relaxed firmware active)
240p_offset ([0-9]+) Set offset for 240p mode (pixel x2)
osd (on,off) Show/hide OSD
spi_flash_erase Erase FPGA configuration memory
osdwrite\
  [column]\
  [row]\
  "[text]"		 Write [text] to OSD starting at [column]/[row]

(1) [resolution]: vga, 480p, 960p or 1080p
(2) [deint]: bob or passthru