2.0.0 firmware updates

Mark Thompson 2024-02-15 09:33:55 -06:00
parent 31bfcbf5b3
commit 6163348101

@ -1,8 +1,9 @@
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 Tone Key (CTCSS) mixer setting when transmitting 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)
@ -41,19 +42,19 @@ In the radio section there are three options,
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.
* 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 - 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.
* 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
![SCR_0034](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/22e1660a-ef1e-429b-af6d-81a8f612b893)
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.
Set the date and time which will appear on the home screen, 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.
![SCR_0034](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/22e1660a-ef1e-429b-af6d-81a8f612b893)
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](https://en.wikipedia.org/wiki/Daylight_saving_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 versions 1.9.2 or higher.
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
![SCR_0036](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/8ffcbfde-6261-4d64-a1ce-5704f8f8b741)
@ -62,33 +63,29 @@ This provides an app for the calibration of the touch screen and alignment by fo
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
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.
![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):
* Load app settings
* Save app settings
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
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)
![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).
![SCR_0037](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/28b4fd52-ec77-4f14-9b56-300ef2ce75c1)
## Converter
Set up convert or down convert mode.
![PortapackConverter](https://www.nilorea.net/wp-content/uploads/2023/03/PORTAPACK_CONVERTER.png)
Set up convert or down convert mode. Widgets:
Widgets:
* show / hide icon, hiding will also disable any up / down conversion
* enable / disable converter
* (+) or (-) set the offset sign
@ -106,25 +103,27 @@ 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
Set the size of the displayed QR code in the RadioSonde app.
![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
Set persistent memory options.
![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.
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
![PORTAPACK_FREQCORRECTION](https://github.com/portapack-mayhem/mayhem-firmware/assets/3157857/4c313bb6-1125-4b43-8b1b-c3721f3041b1)
Set TX and or RX Frequency correction in Hz.
![PORTAPACK_FREQCORRECTION](https://github.com/portapack-mayhem/mayhem-firmware/assets/3157857/4c313bb6-1125-4b43-8b1b-c3721f3041b1)
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 ).
@ -134,15 +133,18 @@ 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 position between Low, Normal, and High (this adjusts the number of steps for a full rotation), and the rotation rate multiplier (adjusts the number of steps that occur when the dial is rotated faster).
Allows the sensitivity of the encoder dial to be adjusted between Low, Normal, and High.
![SCR_0067](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/fcfb7208-32ce-4e06-a2cb-07b238425f2b)
## SD Card
Enables higher speed access to the SD card (only works on higher-speed SD card models).
![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.
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
Its not really changing the voltage of led backlight, but use a “cover layout” like those brightness adjustments android app do (actually its changing all the rendering color but I was just make it sounds more clear)
So dont expect image quality but it indeed saves some eyesight in night.
Its not really changing the voltage of LED backlight, but use a “cover layout” like those brightness adjustments android app do (actually its changing all the rendering color but I was just make it sounds more clear). So dont 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. Since it's changing the colors, a screen-shot taken with a dimmed screen will be dimmed in the screen-shot as well.
![SCR_0068](https://github.com/portapack-mayhem/mayhem-firmware/assets/129641948/47d907fa-2bc4-44db-84de-a048e87dc857)