Updated Settings (markdown)

Mark Thompson 2024-01-22 11:04:52 -06:00
parent 2708cde0fe
commit b06cc380c3

@ -1,6 +1,8 @@
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 allow the setting of the tone Key mixer setting as a percent of the audio level.
![SCR_0035](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/a614b3dd-8ae7-4ba6-8702-09ac05ebf758)
This allow the setting of the Tone Key (CTCSS) mixer setting as a percent of the audio level.
## Radio
In the radio section there are three options,
1. 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)
@ -35,7 +37,10 @@ In the radio section there are three options,
external TCXO signal and in that case, we may want to deactivate it.
## User Interface
![SCR_0041](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/a5565fa3-48ae-4ff2-9452-e4882b86b616)
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 seconds( default) or can be set to 5,15,30 seconds or 1,3,5,10 minutes.
* Show the Splash screen at power-up.
* Show the clock - This allows the date and time to be updated by moving the cursor to the select item and use the rotary knob to adjust the value.
@ -51,10 +56,16 @@ If Daylight Savings Time (DST) is enabled, the time is advanced by one hour duri
Note that it takes about a second to save the time when the Save button is pressed. Daylight Savings Time is supported in firmware versions 1.9.2 or higher.
## Calibration
This provides an app for the calibration of the screen and alignment by following on screen instruction.
![SCR_0036](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/8ffcbfde-6261-4d64-a1ce-5704f8f8b741)
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.
## App Settings
![SCR_0043](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/45f0ac0b-d822-44f8-a643-9cf54c017c84)
![SCR_0046](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/06c05ef9-d599-49c0-8c7c-9afd2a1c4a70)
![SCR_0048](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/e101d06c-7f5e-4112-a635-cbbf8c6d9bea)
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.
Note: In firmware versions prior to 1.8.0, apps use the .ini settings file ONLY if the following configuration settings are enabled (in 1.8.0+ this is the default behavior and the Settings->AppSettings screen will not appear in firmware versions 1.8.0 to 1.9.1):
@ -63,10 +74,15 @@ Note: In firmware versions prior to 1.8.0, apps use the .ini settings file ONLY
In firmware version 1.9.2 and later, there is a new App Settings application that simplifies access to the .ini files in the SETTINGS folder.
### blacklist
## blacklist
![SCR_0044](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/9687c092-6c7d-42bd-b075-bb81b3871245)
![SCR_0045](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/876df1ef-2faa-4051-9e8c-475337b584b4)
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
![SCR_0037](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/28b4fd52-ec77-4f14-9b56-300ef2ce75c1)
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
@ -90,11 +106,13 @@ You can turn it on and off using the checkbox while in Radio menu, or using the
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
![SCR_0042](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/735bf4c0-24fa-4c2d-b84b-6551ff8d15b9)
Set the size of the displayed QR code in the RadioSonde app.
* show larger or not
## P.Memory Mgmt
![PORTAPACK_PMEMTOSDCARD](https://www.nilorea.net/wp-content/uploads/2023/03/PORTAPACK_PMEMTOSD.png)
![SCR_0039](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/7abd585c-1eaa-45b5-beb7-c7da27ddaa5d)
Set persistent memory from/to sd card options. It's particularly useful to keep different default settings than those configured by the firmware if there is no/dead coin battery. Information messages will be displayed at each widget trigger. If loading at startup is failing, it will not show any message, the boot may continue like nothing happened. 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. Each time you correctly exit an app using the back button, it's persistent settings, if any, are saved to the sdcard.
@ -116,4 +134,11 @@ Use the MHz RX and MHz TX field to set the correction in each mode.
Settings are automatically saved in persistent memory.
## Encoder Dial
![SCR_0038](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/26162090-395b-4fcd-b331-7b05e59b6895)
Allows the sensitivity of the encoder dial to be adjusted between Low, Normal, and High.
## SD Card
![SCR_0040](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/ec2409fc-f830-4a48-8328-8e386e131491)
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.