User manual

Table of contents

  1. Setup your PlusCart
  2. Connect to local WiFi
  3. Connect to the PlusStore and create a "My ROMs" space
  4. Exit ROM emulation
  5. Firmware Update FOTA
  6. Favorite ROMs
  7. Popular ROMs
  8. Recently Added ROMs
  9. Offline ROMs
  10. Offline Autostart ROM
  11. Misc information
  12. Bug reports

Setup your PlusCart

To fully enjoy your PlusCart you need to perform 2 steps:

Connect to local WiFi

Since firmware version v0.14.2 there are three options available to connect the PlusCart to a local WiFi network:

  1. Wi-Fi Protected Setup (Push button method) (Setup -> WPS connect)

    Turn on your WiFi-router's discovery mode by pushing the WPS button ( either an actual hardware button or a virtual one in your router's setup menu).

    Then select "WPS connect" in your PlusCart's "Setup" menu.

  2. Connect with WiFi password (Setup -> WiFi connect)

    At the moment only uppercase chars, digits and some special chars (ASCII 32 - 96) are possible for the WiFi password.

    The "Keyboard" only shows the last 12 characters typed in, but the password (or email at the PlusStore connect menu) can be up to 199 chars long.

    If your WiFi password uses not supported chars, try to use a guest WiFi at your local router, with an simple password.

    After the WiFi connect you should have access to the PlusStore's "Public ROMs" folder.

  3. Connect with WiFi Manager Portal (Setup -> Start WiFi Manager Portal)

    To start the WiFi Manager just select "Setup" -> "start WiFi Manager Portal" at the PlusCart menu and then connect your Smartphone or PC to the new (unsecured) network "PlusCart(+)" and go to the web page http://192.168.4.1

    Select the option "Configure WiFi" a WiFi scan is performed by the PlusCart and a list with the available networks will be shown. Select your network, type in your password and press the "save" button.

    After your PlusCart is connected to your local WiFi and the internet, a new button "PlusStore connect" in the WiFi Manager main menu will occure. Here you can connect/create your PlusStore account (see 2.)

Connect to the PlusStore and create a "My ROMs" space

Insert your email address, or your PlusStore username, at the menu entry (Setup -> Plus connect).

An PlusStore account will be created, if no PlusStore account exists for that email. An confirmation email for the account will be send to the email address, with an link to finish the registration.

If an PlusStore account already exists with this email, an "confirmation" email for the connect will be send.

either way check your emails and confirm or finish your registration.

  1. Upload ROM files to the "My ROMs" space

    For syncing a local folder install the nextcloud client the nextcloud server URL is (plusstore.firmaplus.de)

    Also the Web Interface can be used to upload and delete files in the "My ROMs" space.

Exit ROM emulation

To exit a game just press and hold first Joystick to the right (or press Paddle button) and press Reset on the console. The exit function should work with every game, that is reading Joystick/Paddle-button and the console-switches in a kernel loop. Some (classic) games read the joystick only in the game loop and not at the title screen, so you have to start the game before you can use the exit function.

Firmware Update FOTA

The menu entry "** Update **" indicates that a new firmware is available in the PlusStore. Selecting this entry will start the FOTA (firmware over the air) update.

The update was successfull if you see a menu list with "Testing xx" entries, then restart your VCS (since version v0.13.6 no restart is necessary).

The actual firmware version can be seen in the "Setup" menu header.

Favorite ROMs

Files marked as favorites in nextcloud will appear in the PlusCart menu folder "Favorites". Nextcloud folders marked as favorites will be ignored.

Popular ROMs

The "Popular ROMs" folder contains the 11 most downloaded ROMs of the last 4 weeks from the "Public ROMs" area.

Recently Added ROMs

The "Recently Added ROMs" folder contains the 35 newest ROMs from the "Public ROMs" area.

Offline ROMs

Offline ROMs can be uploaded to the PlusCart's flash memory. The ROMs have to be packed into a standard TAR archive. The requirements for that TAR archive are:

There are two options available to flash the TAR archive to the PlusCart:

  1. Flashing offline ROMs by using the PlusStore

    1a. (firmware versions v0.13.6 and newer)

    • create an "Offline" folder at root dir of your shared folder (by nexcloud client or webapp).
    • place the ROM files and folders in that "Offline" directory (max. 896 kB minus 512 bytes per file or folder).
    • If the generated tar file is not bigger than 896 kB, a new menu entry "Setup" -> "Download offline ROMs" will appear in the PlusCart menu.
    • By selecting the "Download offline ROMs" entry, the tar file is automatically generated and downloaded.
    • after flashing, the tarfile will be appended with the timestamp it was flashed by the PlusStore API (e.g. ROMs-1578684865.tar)

    1b. (firmware versions before v0.13.6)

    • create an "Offline" folder at root dir of your shared folder (by nexcloud client or webapp).
    • place the TAR archive in that "Offline" directory.
    • rename the TAR archive to "ROMs.tar".
    • when starting the PlusCart a new menu entry "* Flash ROMs" appears, by selecting it the TAR archive will be flashed.
    • after flashing the filename will be appended by the timestamp it was flashed by the PlusStore API (e.g. ROMs-1578684865.tar)
  2. Flashing with SMT32CubeProgrammer

    • flashing to Flash Sector 5 (0x08020000), to select the TAR archive in SMT32CubeProgrammer's file selector the TAR archive has to be renamed to *.bin (this option doesn't work with versions between v0.11.0 and v0.13.6)
    • since firmware version v0.13.6 you have to select "Setup" - > "Detect offline ROMs" to detect the flashed offline ROMs.

With both options the previously flashed offline ROMs will be deleted!

Offline Autostart ROM

Upload a file that starts with "Autostart." to your nextcloud "Offline" folder and then select "Setup" -> "Download offline ROMs" at the PlusCart menu.

The autostart file can also be flashed with the STM32CubeProgrammer ( see Offline ROMs ).

caution: Make sure that the exit function works with the autostart ROM. To get rid of an autostart ROM, that doesn't work with the PlusCart exit function, the flash area for the offline ROMs has to be erased with the STM32CubeProgrammer.

Misc information

You don't have to put your ROM files into the My ROMs folder, if you use the root folder the ROMs will be the first in the PlusCart start menu

Only 135 entries (ROMs and directories) are possible per folder ( 1024 files and folders since version v0.13.6)

Max 32 chars per filename or directory name.

The full pathname of a file must not be longer than 256 chars

Bug reports

please mail bug reports to: incoming+firmaplus-atari-2600-pluscart-14327336-issue-@incoming.gitlab.com