Application Manual

Versions list and features

Quick Start Guide

Once you provide power to the controller for the first time, you will need to configure the WiFi:

• Open your phone or computer, open the WiFi/Network Settings
• Search for an Access Point named "reHamRadio-AP" and "Connect" to it using the password: rehamradio
• A new WiFi Manager pop-up will allow you to choose your Home Access Point (or phone hotspot for field operation)
• Provide the password and click "Save"
• Your controller will connect to your home access point and will be assigned an IP address
• Open your browser and open the controller link: http://rehamradio.local (version 0.3.1-beta or newer)
• In case that the link does not open (a known issue on some devices), you will need to use the IP address, that can be found using the Arduino IDE Serial Monitor console, or by using a free Network Scanner application on your mobile phone.

To reset the WiFi settings or password:

• On the ESP board locate the "RST" button
• Double click that button within 2 seconds to reset the WiFi Manager credentials
  
• Once the WiFi Manager is reset, a new configuration process is needed, the same as explained in the Quick Start Guide

User Interface

Controller

• Hostname -
  Display the controller hostname. It helps recognize when there are multiple controllers on the network. The hostname can be used to access the application using a link of this format: http://<Hostname>.local
• Motor Status -
  Represent the current status of the motor: "Idle", "Tuning", "Idle - Edge", "Watchdog Timeout!"
  
• Motor Position Slider -
  Available only when the Range Limit feature is enabled. Represents the motor position within the range. This slider is "read only" and cannot be changed.
  
• Speed Slider -
  Control the speed of the motor, from fast tuning and down to slow fine tuning.
  
• Memory buttons -
  Each button will recall the relevant memory position and will move the motor to that position.
  
• SCAN button -
  Toggle switch. Once on, can be switched off with the following options: Click again, Click Left / Right buttons, or by the Watchdog timeout. When using the SCAN feature, the motor will move in the direction last used by the Left / Right buttons.
  
• Directional buttons -
  Directional buttons that will move the motor in each direction.
  

System

• Network Information -
  Information about the controller IP address and MAC address. 
• Chip Information -
  Information about the controller parameters. Useful for debugging the controller status.
  

Settings

• Hostname -
  The option to set a dedicated hostname for the controller. It's useful when operating multiple controllers on the network. In addition, that hostname is in use in the dedicated access link in the following format: http://<Hostname>.local
  After updating the hostname and clicking on the "Update" button, the controller will reboot itself to effect the change.
• Watchdog -
  When enabled, will stop the motor movement when reaching the watchdog value. When disabled, the motor will run non-stop, until it will be stopped by the user. The watchdog timeout is calculated from the time the motor starts a new movement from an Idle status. Once the motor stops, the watchdog timer is reset.
• Range Limits -
  When enabled, the motor will be allowed to move in a range in between the "Min Limit" and "Max Limit". If the motor will hit one of these limits, it will stop and the motor status will show "Idle - Edge". In this situation, the motor can be moved only into the allowed range direction.
  To narrow the range, use the "Set Min" and "Set Max" buttons.
  To extend the limits, you will need to disable this feature, move the motor to wider limits and enable this feature back.
  NOTE:
  The Range Limits are virtual, and based on motor steps counting and are NOT based on any external physical limit switches. You need to be aware that if you are planning any maintenance to the antenna or make any changes to the motor position, you MUST adjust the range limits again. Avoiding that can damage the capacitor!
• Switch Button Directions -
  When enabled, it will change the direction of the directional buttons. This can be helpful, when the motor itself is installed in the opposite direction or upside-down.
  
• Memory Setup -
  To set a memory, first move the motor to the required position. Then, from the "settings" tab, provide a name for that memory (up to 5 characters) and click on the "M" number button to set it. Once set, you can go back to the "Controller" tab and see that the new name has been set on the relevant button. The memory names and positions are saved even when the controller is without power.
• Firmware Update -
  Used to update the firmware (software version) by uploading a binary file. The binary file can be found on the GitHub repository. After uploading new firmware, the controller will reboot itself and the new version will be active. Uploading firmware using this feature is the simplest way to update the version and allow us to skip the use of the Arduino IDE and the needs of loading manually special libraries (version 0.3.1-beta or newer).
• Activation Key -
  Some features are available only when the application is activated. To check if the application is activated, you can check the application version at the bottom of the screen. When not activated it will show "Community Version" and when activated it will show "Activated Version." To know which feature needs an activation, you can check the "Versions list and features" above.
  To get an activation key, please contact us using the Contact form.

About

• Quick links for useful information
  
  

Known Issues