Settings - portapack-mayhem/mayhem-firmware GitHub Wiki
This section provides a set of utilities that can be used to configure some aspects of the PortaPack and are described below. Settings are saved in persistent memory.
Audio
This setting allows adjustment of the following audio parameters:
- Tone Key (CTCSS) mixer setting when transmitting, as a percent of the audio level.
- Audio Beep on speaker/headphone in certain apps when receiving a data packet.
Radio
In the radio section there are three options,
- Enable/disable the Clock Output. (it can be activated / deactivated by top title bar (CLKout icon) : green icon means activated, or thought that radio menu (check-box)
Note 1 : In r9 Hackrf platform , due to our complex fw Architecture and usage of Si5351A , we have fixed the synthetized CLK out freq to 10Mhz.
Note 2 : In all previous r1 to r8 Hackrf platforms , as we are using Si5351C, we do not have that limitation , and user can change the CLKOUT frequency between 4 kHz to 60000 kHz; press OK when the frequency is highlighted to select which digit position to modify and then use the encoder to scroll through the digit values. (it works with both clock references, the internal Hackrf (25Mhz) and the external -when available- from Portapack (TCXO 10Mhz ). Once enabled the CLK_out , the new introduced frequency will be updated to the CLK_out port, as soon as you press below SAVE button.
Note 3 : Zooming previous picture , when the unit detects that external CLOCK_in -usually 10Mhz reference- (from Portapack or from external source) , it is indicated in the top title CLK_in icon with some top arrow below the icon (right picture) . In case of no detection , it is indicated with some "X" below the icon (left picture),and in that case, the system takes the internal 25Mhz Hackrf clock reference.
Warning note : be awared that some of current market Portapack boards may have an integrated low ppm TCXO 10Mhz clock generator mounted, and when it is built in, it is connected in parallel to the external Hackrf CLK_in port connector. So in that special case , that internal PP clock signal is present always in the SMA CLK_in connector (this s a strange case, because in those devices, CLK_in is behaving as real embedded ref. output of internal TCXO 10Mhz clock) , and you should better not connect any other external signal generator there (unless you dissassembly the Portapack from Hackrf) , because otherwise, you will connect two clock signal generators in parallel -the embedded one to the external one -, and you may damage that Portapack TCXO clock IC circuit.
Here below , you can see two different examples of the embedded TCXO 10Mhz ref. clock, in a PP H1 brd (left side ) , PP H2 brd (right side) boards :
-
Enable/disable the Antenna Bias voltage. (it can be activated / deactivated by top title bar (DC bias icon) : green icon means activated, or thought that radio menu (check-box) . If enabled, ensure that all devices attached to the antenna connector can accept a DC bias voltage.
-
Enable/disable the External TCXO Clock input. (it can be activated / deactivated by that radio menu (check-box). Sometimes, in low battery charge voltage, or other low output TCXO voltage amplitude (much lower than the expected 3.3V pk-pk from ground) , we may have some boot problems with that external TCXO signal and in that case, we may want to deactivate it.
User Interface
The UI interface setting for the following can be Enabled (tick) or Disabled (x) or selected value for the backlight timeout:
- Touchscreen can be enabled or disabled.
- Backlight off after 5,15,30 seconds, 1,3,5,10 minutes, or never (default).
- Show the Splash screen at power-up.
- Show the clock - Selects whether to display date and time on the home screen (update by moving the cursor to the select item and use the rotary knob to adjust the value).
- Back button in menu - Enables a "Back" button on all menu screens.
- Show/Hide Status Icons - Select which status bar icons are visible or hidden.
Date/Time
Set the date and time which will appear on the home screen (if enabled), in log entries, and file time stamps. A coin cell is required to keep the time updated when the PortaPack is off. If the coin cell battery is dead/missing but there is an SD card, the date will be advanced by 1 day every time the Portapack is rebooted, so that log entries/files will be in chronologically ascending order.
If Daylight Savings Time (DST) is enabled, the time is advanced by one hour during the indicated date range specified as the Nth Day-of-Week in Nth Month (note that the time displayed on this screen is assumed to already be corrected for DST so the time entered should be the same as appears on other clocks). To learn the Daylight Savings Time date range for your area, see Wikipedia Daylight Savings Time By Country. The precise hour of the time change is as shown on the screen and is not configurable.
Note that it takes about a second to save the time when the Save button is pressed. Daylight Savings Time is supported in firmware version 2.0.0 or higher.
Calibration
This provides an app for the calibration of the touch screen and alignment by following on screen instruction.
You have to keep pressed for at least a second on each target for the app to guess the touch area correctly and show next target on release.
Touchscreen Threshold
The touchscreen’s resistance detection layer can be eventually wore out (it’s inside the soft layer so use screen protector won’t slow it down) by using it, or it’s originally bad quality, so you maybe need to tune the threshold if you can’t touch an area, or some region are kept pressing even if you are not pressing it (which causes the back light keeps on forever because the device think you are keep touching the screen)
In the best case the threshold should be 1, but considering the most case that the layer already kind of damaged, we default it to 32.
If you are having issues listed above, just press Auto detect, and follow the guide, and it will automatically tune to a value that good for your device.
When auto detecting, don’t touch the screen, until count down finished. otherwise it will give you a bad value. But don’t worry if you mistakenly touched, just need to start over and nothing bad would happen.
App Settings
Settings for each app are saved in corresponding .ini files in the /SETTINGS folder to maintain persistence, if a formatted SD card is installed. An updated .ini file is saved whenever the app is closed. To reset an app to default settings, the corresponding .ini file may be safely deleted and a new file will be created automatically when the app is subsequently executed. Alternatively, individual lines in the file may be deleted to reset only a subset of application settings. For debug purposes, note that some additional configuration settings may be found in the .ini file that are not configurable in the app itself.
blacklist
To disable specific apps completely, a text file named "blacklist" can be created manually in the SETTINGS folder using the Notepad application. Unwanted applications should be listed in this file using their case-sensitive application name (text that appears under the app's screen icon), and they will be disabled (hidden) effective on the next boot. List one application per line. (Requires 1.8.0+ firmware and an SD card)
Config Mode
In some cases a PortaPack may start up intermittently in Config Menu mode, such as when the power button is pressed twice rapidly, or if a little electrical noise occurs when a USB cable is attached. If this occurs frequently (dark screen and blinking LEDs), the Config Menu code can be disabled using the Settings -> Config Mode app (which sets a flag in persistent memory to disable Config Menu activation).
Converter
Set up convert or down convert mode.
Widgets:
- show / hide icon, hiding will also disable any up / down conversion
- enable / disable converter
- (+) or (-) set the offset sign
- set the offset
When using an upconverter it's common to use an offset to access the correct frequency. As an example, if you want to use a HamItUp which is designed to listen from 60KHz to 30MHz, you'll need to tune your portapack to 125 MHz (or any other frequency used in the upconverter local oscillator) + the frequency you need.
Doing the calculation and tuning while adding the frequencies can be a bit tedious. Don't worry: just got into your portapack's settings, Radio menu, and set the shifting you need. You can set up conversion (+) or down conversion (-) in the Settings/Converter menu.
When the option is on, the displayed frequency is the one you want to tune in, and the real tuned frequency is displayed frequency plus or minus offset. When the option is off, the displayed frequency is the one you want to tune in, and the real tuned frequency is the displayed frequency.
You can turn it on and off using the checkbox while in Radio menu, or using the top bar icon 'Freq', with an arrow telling you if it's up or down conversion.
Note: This has the same effect as using the top bar 'Freq' icon. While in the radio menu, the synchronisation of the top bar 'Freq' status and the checkbox is not implemented when toggling the top bar 'up' icon. The status is saved, and the last to talk is setting the status.
QR code
Set the size of the displayed QR code in the RadioSonde app. (As of the n_240322 build, the regular QR code is displayed larger and this settings screen is no longer available)
P.Memory Mgmt
Set persistent memory options.
There are 256 bytes of persistent memory where settings are saved when there is a working coin battery. Note that a dead/missing coin battery will not prevent startup or display any messages, but settings will be lost after a power cycle. To prevent this, settings may be stored in a file on the SD card versus in the persistent memory, if enabled. Widgets:
- use sdcard for pmem: if checked the firmware will try to load last saved settings at startup. The checkbox is configuring a flag file under SETTINGS for it to work without coin battery.
- save p.mem to sdcard : save actual persistent memory onto the sdcard
- load p.mem from sdcard : manually load persistent memory from sdcard
- !reset p.mem, load defaults! : reset the persistent memory to defaults
FreqCorrect
Set TX and or RX Frequency correction in Hz.
A value between [-4,+4] MHz of correction is accepted, else it's truncated due to the variable used in persistent memory.
Use the '+' or '-' filed to change to correction mode (addition or subtraction ).
Use the MHz RX and MHz TX field to set the correction in each mode.
Settings are automatically saved in persistent memory.
Encoder Dial
Allows the sensitivity of the encoder dial position between Low, Normal, and High (this adjusts the number of steps for a full rotation). The rotation rate multiplier adjusts the number of steps that occur when the dial is rotated faster, for faster scrolling through frequencies, file lists, volume setting, etc.
SD Card
Enables higher speed access to the SD card (only works on higher-speed SD card models).
Use the Test button to try it before saving this setting in persistent memory. Files may not be read or written properly if this is enabled on a slower SD card.
Brightness
It’s not really changing the voltage of LED backlight, but use a “cover layout” like those brightness adjustments android app do (actually it’s changing all the rendering color but I was just make it sounds more clear). So don’t expect image quality but it indeed saves some eyesight in night. Brightness may also be adjusted by clicking the brightness icon on the status bar.
what if you enabled dark brightness and now in sunlight and can’t see the screen?
The brightness icon is the most top-right button on screen, thus you can: boot, press many times right and up arrow button, then press center button, so you can adjust the brightness even if you can’t see the screen.
Menu Color
The Menu Color app can be used to change the background color scheme of the app menu buttons from the default grey to suit your preference.