Manual

Work in progress!

Onboard Configuration Menu

Each Blamco light gun comes with an onboard configuration menu. You can use this feature to set and change various configurable settings. The menu system can be activated using the Reload/B button on your gun. While activated, it pauses the standard play mode function.

All of the changes made in the system menu will be saved permanently. 

Enter / Exit Menu

To activate the configuration menu, the camera MUST be aimed off screen. Press and hold the Reload/B button for 4 seconds. When entering the system menu, the haptic motor will make a long buzz, and the addressable LED will turn blue.

Figure 2.0

[ Add picture of Blue LED]

To resume standard play mode function, press and hold the Reload/B button again for 4 seconds. When exiting the system menu, the haptic motor will make a long buzz, and the addressable LED will turn off.

Available Menu Content

The system menu provides access to config various aspects of the gun functionality. The menu system has only two levels with each menu having a list of options to select from. Each menu is color coded to help you know where you are in the menu. The available menus, in order:

  1. Calibration Menu - Blue Led
    1. Calibrate Point of Aim
      1. Center, Top, Bottom, Left, Right
    2. Adjust Point of Aim
      1. Top, Bottom, Left, Right
  2. Select Calibration Profile - Green Led
    1. Profile 1, Profile 2, Profile 3, Profile 4
  3. Select Full Auto Mode - Red Led
    1. Single Shot, Full Auto, Disabled
  4. Select Pedal Mode - Yellow Led
    1. Assigned Key, Right Mouse, Middle Mouse
  5. Select Offscreen Mode - Purple Led
    1. Off, Move Offscreen, Shoot Offscreen
  6. Advanced Menu - Orange Led
    1. Select Player Id
      1. Player 1, Player 2, Player 3, Player 4
    2. Select LED Positioning
      1. Quadrilateral, Crosshair
    3. Select Sensitivity Level
      1. Normal, High, Max
    4. Factory Reset
      1. Confirm reset
    5. Reboot for Upgrade
      1. Confirm reboot

Navigating the Menu

You can navigate through the menu options using the buttons on your Blamcon!. As you navigate the haptic feedback will buzz to let you know when you’ve changed or selected a menu item, and the addressable LED will change colors to indicate which menu item you’re on.

  • Button A
    • Single press - cycle menu items forward
  • Button B
    • Single press - cycle menu items back
  • Trigger
    • Single press - Enter/Select current menu item

Once you’ve selected a menu, you MUST select an option or exit the entire menu system. When you select a menu option it will save your selection and will exit the menu to game play mode. There are a couple of exceptions to this navigation where the settings require a firmware reboot. Each of these selections will exit the menu system and initiate a board reset in order for the changes to take effect:

  1. Select Player Id - when a new Player Id is selected
  2. IR Camera Sensitivity Level - when a new sensitivity level is selected
  3. Factory Reset - after double confirmation

Onboard Menu Options

Calibration Menu

This is the first option on the menu as it’s the first thing you must do with every Blamco light gun. THe Blamcon CORE gives you the ability to configure up to 4 different calibration profiles, for each support LED configuration. THis means there are four profiles for Quadrilateral LED, and four profiles for Crosshair. That’s a total of 8 different profiles so you can setup and use your Blamcon with different LED configurations without having to re-calibrate each time.

The calibration process includes an LED guidance system. The addressable LED guidance system will change colors to help you understand what the camera is detecting and whether you need to make any corrections to get the best result from the calibration process. Your goal is to have a green LED before capturing each of the five cursor positions. Here’s a simple guide or legend to help you understand what each LED color represents and any corrections you should make.

  • Red - If the addressable LED is red then it can’t see any of your IR LEDs. 
    • Check that your IR lEDs are plugged in and on. The human eye can’t see IR light but an easy trick is to use your phone camera. Hold the camera up to the IR LEDs and you should see a purple glow.
    • Check your distance to the screen. Try stepping back so the camera can see all four IR LEDs in its view. If you have a compatible fisheye lens, try installing that to increase the camera’s field of vision.
  • Amber - If the addressable LED is amber means that the camera can see some IR LEDs but not all four.
    • Check your distance to the screen. Try stepping back so the camera can see all four IR LEDs in its view. If you have a compatible fisheye lens, try installing that to increase the camera’s field of vision.
  • Blue - If the addressable LED is blue means that the camera can see all fourIR LEDs but an angle has been detected. This is usually normal.
    • You are holding the lightgun at a slight angle. A natural position is to hold the light gun controller slightly off center. Try tilting the camera slowly in either direction. If small adjustments make the LED turn green then hold and continue the calibration process. If you can’t get the LED to turn green, then it may indicate that your camera is installed incorrectly. 
    • Check the camera installation. If you purchased a kit from Props3D, it should come clearly marked which way is up. If you purchased your camera elsewhere  it’s a common mistake to install the camera in the incorrect orientation. Loosen the inset screw and adjust the camera so it’s as close to center as possible.
    • Check that your IR LEDs are installed correctly. If you are using a lightbar, check that it’s level as possible and adjust if necessary. If you are using separate IR LEDs, make sure they are installed at the same level and positioned as evenly as possible.
  • Green - If the addressable LED is green means that the camera can see all four IR LEDs and there is no detectable angle. Excellent
    • Aim down the iron sight and find the cursor. Using a steady hand, capture the cursor position, and repeat the process for all five positions. Each time you move to a new cursor position, make tiny adjustments to get the green LED.
    • Don’t worry if you can’t keep the LED in a green steady state. Along as it’s close you should see the LED change between blue and green rapidly means you are close to the threshold and within 2 degrees of a level IR configuration in the camera view.
Calibrating Point of Aim

To start calibration, use the trigger to select the first option in the menu. The addressable LED should be Blue. Once you’ve selected the menu, you must select which profile you want to configure. You will start on Profile 1, and you can press button A to advance the menu to Profile 2. If you press button A, again it will cycle back to Profile 1. Once you’ve selected a profile for calibration, follow these instructions to complete the process.

  • Press the trigger to start calibrating
    • Rumble will buzz once when entering this step, if present
  • Mouse cursor should move to center of the screen
    • Aim down the iron sight and find the cursor. Using a steady hand, capture the cursor position.
      • Make tiny adjustments to get the green LED.
    • When the LED is green, pull the trigger to capture position
  • Mouse cursor should move to top edge of the screen
    • Repeat process
  • Mouse cursor should move to bottom edge of the screen
    • Repeat process
  • Mouse cursor should move to left edge of the screen
    • Repeat process
  • Mouse cursor should move to right edge of the screen
    • Repeat process

At this point, the calibration settings will be saved on-board and the menu will exit completely to game play mode. At any time you can cancel the calibration process operation by pressing and holding Reload/Button B for four seconds to exit the menu system.

Adjusting Point of Aim

To start adjusting point of aim, use the trigger to select the first option in the menu. The addressable LED should be Blue. Once you’ve selected the menu, you must navigate to the Adjust Point of Aim menu item. You will start on Calibrate Point of Aim, and you can press button A to advance the menu to Adjust Point of Aim. If you press button A, again it will cycle back to Calibrate Point of Aim. Once you’ve selected Adjust Point of Aim, follow these instructions to complete the process.

  • Press the trigger to start Adjusting
    • Rumble will buzz once when entering this step, if present
  • Mouse cursor should move to top edge of the screen
    • Aim down the iron sight and find the cursor.
    • Use Button A to move the cursor up, or the Button B to move it down
    • Move the cursor into a position best 
  • Mouse cursor should move to bottom edge of the screen
    • Repeat process
  • Mouse cursor should move to left edge of the screen
    • Repeat process
  • Mouse cursor should move to right edge of the screen
    • Repeat process

At this point, the calibration settings will be saved on-board and the menu will exit completely to game play mode. At any time you can cancel the adjustment process by pressing and holding Reload/Button B for four seconds to exit the menu system.

Select Calibration Profile

This menu gives you the ability to switch between 4 different calibration profiles. This is convenient if you want to play games in different aspect ratios i.e. 4:3, or if you have different screen setups you want to use your lightgun with, like say, bringing it to a friend’s house.

Once you calibrate the four different profiles you’ll want to switch between them for different games. By default, the firmware will default to Profile 1 until you change it.

Once you’ve entered the configuration menu, navigate to the Select Profile menu pressing button A. It should take one button press from the calibration menu. The addressable LED should be Green. Once you’ve selected the menu, there are two profiles for you to select from. You will start on Profile 1, and you can press button A to advance the menu to Profile 2, then Profile 3, and Profile 4. If you press button A, again it will cycle back to Profile 1. As you navigate the options, the haptic motor will buzz to count the selected profile. For example, when you navigate to Profile 2, you should feel two soft buzzes. Once you’ve navigated to the Profile you want to change to, press the trigger to select it.

At this point, if the Profile was changed it will be saved for future game play. You’ll still be in the configuration menu and back at the top level Select Profile menu. You can navigate to other menu items or exit the menu. At any time you can cancel this selection process by pressing Reload/Button B to exit configuration mode. Once you exit the menu system, the new calibration profile should be in effect.

Full Auto Mode

If your Blamco light gun has a recoil action, then it has a solenoid installed. By default the recoil action will be a single shot based on the trigger action during game play mode. The Full Auto Mode setting allows you to change the behavior of the recoil to full auto or disabled altogether. 

Once you’ve entered the configuration menu, navigate to the Full Auto menu by pressing button A. It should take three button presses from the calibration menu. The addressable LED will change to Yellow for this menu. Once you’ve selected the menu, there are three settings for you to select from. You will start on the default setting called Single Shot, and you can press button A to advance the menu to Full Auto. If you press button A again it will advance the menu to Disabled. If you press button A again it will cycle back to Single Shot. As you navigate the options, the haptic motor will buzz to count the selected option. For example, when you navigate to Disabled, you should feel three soft buzzes. Once you’ve navigated to the option you want to change to, press the trigger to select it.

At this point, if the setting was changed it will be saved for future game play. You’ll still be in the configuration menu and back at the top level Select Full Auto menu. You can navigate to other menu items or exit the menu. At any time you can cancel this selection process by pressing Reload/Button B to exit configuration mode. Once you exit the menu system, the new Full Auto setting should take effect.

Pedal Reload Mode

If you have a pedal installed with your Blamco light gun, you find that the default behavior of the pedal is to act as a special key command when it’s activated. The pedal is mapped to the ‘T’ key by default. In some games it’s convenient to have the pedal act as a proxy to the Reload or B button. You can easily switch the pedal function using the Pedal Reload menu.

Enter the configuration menu, navigate to the Pedal Reload menu by pressing button A. It should take four button presses from the calibration menu. The addressable LED will change to Yellow for this menu. 

Offscreen Reload Mode

Some games require the ability to reload your weapon by shooting your light gun off screen. By default, the Blamco light gun disables the trigger button while the camera is aimed offscreen during game play. This setting allows you to enable this feature so you can send a reload command when the trigger is fired while the camera is pointing off screen.

Enter the configuration menu, navigate to the Offscreen Reload menu by pressing button A. It should take five button presses from the calibration menu. The addressable LED will change to Yellow for this menu. 

Advanced Menu

Changing Player Id

The firmware for each gun is preset to be player 1 device. However, this can be changed if you want to use two guns at the same time for multiplayer games. There are four player Ids to select so that the gun is registered with a different device Id.

Once you’ve entered the configuration menu, navigate to the Select Player Id menu by pressing button A. It should take two button presses from the calibration menu. The addressable LED should be Purple. Once you’ve selected the menu, there are four Player Ids for you to select from. You will start on Player Id 1, and you can press button A to advance the menu to Player Id 2. When you get to Player Id 4, if you press button A again it will cycle back to Player Id 1. As you navigate the options, the haptic motor will buzz to count the selected Player Id. For example, when you navigate to Player Id 3, you should feel three soft buzzes. Once you’ve navigated to the Player Id you want to change to, press the trigger to select it.

At this point, if the Player Id was changed it will be saved for future game play and the firmware will reset for the changes to take effect. This is necessary so that the device can properly register with the Operating System. After a short pause, the gun will be back in game play mode. If the Player Id is not changed, and you’ve selected the same Player Id as before you’ll still be in the configuration menu and back at the top level Select Player Id menu. You can navigate to other menu items or exit the menu. At any time you can cancel this selection process by pressing Reload/Button B to exit configuration mode.

Each Player Id should register as a different device when plugged in. If the device is not being recognized correctly after changing the Player Id, you may need to change your selection. First, unplug the gun and plug it back in to see if it’s recognized. If not, you may need to change Player Id again. If you are only using two guns, then have one gun on Player 1 and change the other to Player 2.

LED Positioning

TODO - describe the interaction

IR Camera Sensitivity Level

You can change the sensitivity of the IR Camera to accommodate the environment you are playing in, or if you have a weaker IR LED setup. There are three settings available: Normal, High, and Max. By default the firmware is programmed with the Normal setting since it’s the most common and reliable setting.

Why should you change the sensitivity? Good question. In general, this is not a setting that you should bother with unless you know what you’re doing. If the IR Camera can not detect your IR LEDs reliably, you may want to try other settings to see if it improves. It can be hard to determine if your LEDs are hard to detect by the camera. First, make sure that you are standing back far enough so that the camera can see all the LEDs, or install the fish-eye lens.

Enter the configuration menu, navigate to the Offscreen Reload menu by pressing button A. It should take five button presses from the calibration menu. The addressable LED will change to Yellow for this menu.

Factory Reset

You can use this menu option to erase all of the stored settings which effectively sets the firmware back into the state it was shipped

Reboot for Upgrade

This is a convenient option when you want to reboot your Blamcon so you can upgrade it’s firmware. 

TODO - describe the interaction

Firmware Upgrades

From time to time, we are planning to release updates.

Reboot your light gun in mass storage mode. There are two ways to do this, please see the user guide for instructions. Once your Blamcon is seen as a storage device, simply copy the firmware binary into the root folder. It will reboot automatically and load the new firmware.

  1. Use the Onboard Menu system to reboot in storage mode. 
  2. While pointing the camera off screen, press and hold the B button for 15 seconds, and your light gun will reboot in storage mode.