Amateur Radio Callsign AG4OJ - Nextion Displays

Current & Past Release Notes

December 24th, 2019

 Return To The Main Page
 Return To The Main Page, link to the left. It's December 24th, 2019. The current revision number is 191224A, all earlier version are now considered archived and obsolete. Use of earlier versions are not recommended due to the ongoing code maturity, other code changes of Pi-Star, The MMDVMHost, and the Nextion Display Driver.
 
Remember here, certain touch display features will not work without installing the Nextion Display Driver, Installation Guides below this section. Nextion Display code download links below this section.
 
A. This version removes the date formatting from the Nextion code. This means that the default date, DD/MM/YY from Pi-Star / MMDVMHost is what will display on the MMDVM idle screen of this Nextion coded firmware files.
 
B. All downloaded files have been checked and made sure that they contain the correct version number this time. I hope I fixed this correctly.
 
C. When selecting a different country template "locales", like “en_US” because I'm in the US, the date and time format will not display right without changing the corresponding items in the locales template. The “%Y” needs to be changed to “%y” which changes the 2020 to 20. The “%r” needs to be changed to “%T” which changes the time from AM/PM to 24hours. A tutorial to show how to do this will come soon.
 

December 20th, 2019

 Return To The Main Page
 Return To The Main Page, link to the left. It's December 20th, 2019. The current revision number is 191220A, all earlier version are now considered archived and obsolete. Use of earlier versions are not recommended due to the ongoing code maturity, other code changes of Pi-Star, The MMDVMHost, and the Nextion Display Driver.
 
Remember here, certain touch display features will not work without installing the Nextion Display Driver, Installation Guides below this section. Nextion Display code download links below this section.
 
A. The latest version of the Nextion Display GUI, v0.59, was used to compile this latest version of my Display coded files for all the different Nextion Display sizes. Final testing showed marked improvements / enhancements in the use of this version of the GUI.
 
B. Modular code updates to all of the modules were done to make assembly of the different versions of the display code easier. This reduces coding errors, making quicker assembly, and compiling. Fonts sizes are standardized between the different mode displays.
 
C. The Dual Time Slot Handler code, meaning the Time Slot Timer (Time Slot Status Generators / Time Slot Master Controller And Switcher), for the DMR screen has been completely rewritten. This adds features and streamlined faster code, making it more responsive. Fewer, if any, image switching jitters are shown anymore.
 
1. Transmit Priority Override Mode. When a local transmission, like your radio being keyed, is received by the hotspot / repeater, the screen code will switch to displaying that Time Slot on the screen.
 
This will also “LOCK” the Time Slot to your Transmitted Time Slot during the transmission and for 20 seconds afterwards This no matter what the state of either Time Slot is for 20 seconds afterwards.
 
IF both Time Slots are being transmitted on into the Hotspot/repeater, then the first Transmitter detected takes Time Slot Screen Priority. This is mostly the same behavior as it was before.
 
2. Receive Priority Override Mode. When pressing the Screen Status Button under the "DMR" logo, you will select, switch to the other Time Slot, displaying it on the screen. The button background will turn gray while pressed showing that you pressed the button.
 
This Time Slot change will then be “LOCKED” to the newly selected Time Slot for 20 seconds no matter what the state of either of the incoming Time Slots may change to afterwards.
 
Continuously pressing the Screen Status Button resets the 20 second Control Timer, switches the Time Slot shown, and overrides the Standard Operating Mode until the Control Timer expires. Transmit Priority Override above overrides this feature. Mostly the same behavior as it was before.
 
3. Time Slot Priority Override Mode. (NEW) When pressing either of the Time Slot Buttons, Located to the left of the DMR page logo and Screen Status Button below it, it will add a white border around the pressed Time Slot Button. This makes that selected Time Slot Button take screen priority even if the other Time Slot was already displaying an active Network Transmission.
 
What this means is that while the selected Time Slot Button has a white border around it and it receives an incoming Network Transmission (turns from green with white border to red with white border), it will take control of the display, displaying it's information on the display, even if the other Time Slot is in Network Transmit (red background only).
 
This also means that while the selected Time Slot Button is in Network Listening (Green Background with white border), and the other Time Slot is in Network Transmission (Red Background only), the other Time Slot gets to display it's information on the screen over the Priority Time Slot. This is like the DMR radio's promiscuous mode, yet, for this DMR display.
 
This Mode can only be selected for one Time Slot at a time or neither of them. Selecting the one with the white border will disable this Mode completely. Selecting the other one without the white border will make it switch to the other one. Transmit Priority Override and Receive Priority Override explained above overrides this feature until the 20 second Control Timer expires. This is a new, added behavior.
 
4. Standard Operating Mode. With all the Modes above disabled or inactive, Which ever Time Slot is in active Network Transmission first is the one that will be displayed on the DMR screen. When that Time Slot drops into Network Receive, and the other Time Slot is still in Network Transmission, it will become the displayed Time Slot.
 
When both are in Network Receive, the last one that dropped out of Network Transmission will be one showing it's Time Slot and Talk Group numbers on the Display. When both Time Slots go into Network Transmission, the first one into that state will be displayed. The first three modes explained above this one takes priority over this mode.
 
5. Time Slot Status Indicators, Screen Status Button Colors. Green background with black letters is Network Receive (Waiting for some one to talk, from the Network or Locally). Red background with black letters is Network Transmit (Someone is talking from the Network and any Network added "Hang" Time). Red background with white letters is a local RF Transmission into the Hotspot/Repeater. (You are or someone is transmitting into the hotspot/repeater locally)
 
Time Slot Status Indicators can have a white border around them indicating Time Slot Priority is set. This will be on the green background of the Network Receive and on the red background of the Network Transmit. Transmit Priority Override doesn't show the Time Slot Priority white border as it overrides it. Even so, the Time Slot Priority Mode Status will return when the Local RF Transmission is stopped.
 
Transmit Priority Override Mode's 20 second Control Timer still applies until it expires. This means that even though a Time Slot Priority Override Mode is set to a different Time Slot, the Transmit Priority Override Control Timer may still force the other Time Slot to displayed. Wait 20 seconds for the Control Timer to expire. This same effect can be duplicated with Receive Priority Override Mode as it uses the same Control Timer.
 
6. So, you say you have a single Hat MMDVM board, only having Time Slot two active. What does all of this mean for me? Well, the 1st Time Slot Indicator will always show a blank gray spot, or, a number 1 with a green background. MMDVM Host still sends out a Time Slot 1 message, even if it's only doing Time Slot 2. This code makes it possible for future hardware upgrades, like a dual hat, without unnecessary display code reprogramming.
 

December 4th, 2019

 Return To The Main Page
 Return To The Main Page, link to the left. It's December 4th, 2019. During a recent display code upgrade check, I noticed that one of the messages for DSTAR is not being sent properly anymore, the t2 message from the MMDVMHost. Don't get this message problem being the Nextion Display Driver. This happens without the Nextion Display Driver even being installed. It seems that if you do a fresh install of v3.4.17 and v4.1.0-RC4 without doing any updates or upgrades, this message works just fine.
 
So, until I can find out how to get this missing message to return, anyone who updates/upgrades their Pi-Star versions will loose the "via REF001 C" type of message on the DSTAR part of display. I will not be updating/upgrading any of my Hotspots/Repeaters after I reinstall v3.4.17 on all of my equipment. The Raspbian OS can be updated, just not any of the underlying Pi-Star stuff.
 

November 12th, 2019

 Return To The Main Page
 Return To The Main Page, link to the left. It's November 12th, 2019. The current revision number is 191112A, all earlier version are now considered archived and obsolete. Use of earlier versions are not recommended due to the ongoing maturity, code changes of Pi-Star, The MMDVMHost, and the Nextion Display Driver. Remember here, certain touch display features will not work without installing the Nextion Display Driver, Installation Guides below.
 
Updated for use with Pi-Star/MMDVM Host Versions 3.4.17 (Updated) and 4.1.0RC6 (Updated) under current tests with no problems. Current download Version 1.17 on 191112 of the ON7LDS GitHub Nextion Driver tests with no problems. MMDVM Modem Firmware v1.4.17 used in all tests.
 
A. The use of "stripped.csv" is suggested for the decoding of the DMR users. An updated version of this file will be provided as a download link on this website. Full directions to install this file to your Hotspot/Repeater requires sending me an Email.
 
B. The DMR screen user information has been reformatted again for the recent changes in the Nextion Display Driver v1.17. YES, changes have occurred even though the version number didn't change.
 
C. Other display code changes were made, yet, not note worthy.
 

October 18st, 2019

 Return To The Main Page
 Return To The Main Page, link to the left. It's October 18th, 2019. The current revision number is 191018A, all earlier version are now considered archived and obsolete. Use of earlier versions are not recommended due to the ongoing maturity, code changes of the Nextion Display Driver and the MMDVMHost. (Updated for use with Pi-Star/MMDVM Host Versions 3.4.17 (Updated) and 4.1.0RC6 (Updated) under current tests with no problems. Version 1.17 of the ON7LDS GitHub Nextion Driver still being monitored under close scrutiny level testing.)
 
A. The DMR Page Handler has been updated to handle the rearranged user information fields on both time slots. These changes started in Version 1.16 of the Nextion Display Driver on the ON7LDS GitHub account. I'm watching this closely to make sure I got it all reformatted correctly.
 
B. If you don't understand the installation instructions to use the newest version of the Nextion Display Driver, I will be posting an instructional guide group of webpages shortly. Sorry, I can only do so much with my limited eyesight problems. I want pictures and such which takes a lot of editing.
 
C. In this new version of the Nextion Display Driver, v1.17, there is a bug in the new way the driver handles the DMR user information. For example, a CSV entry ... 1234567,XXNXXX,FirstName,,,,COUNTRY, ... The COUNTRY name will be moved up, ripples into the Last Name position, in this example because it's blank, of the defined text strings because of the completely blank fields not being properly handled in the Nextion Display Driver code. This is only a bug, it doesn't break anything, it will just look odd on the display / screen when it happens. This means that it has nothing to do with my display / screen code.
 

October 6st, 2019

 Return To The Main Page
 Return To The Main Page, link to the left. It's October 6th, 2019. The current revision number is 191006A, all earlier version are now considered archived and obsolete. Use of earlier versions are not recommended due to the ongoing maturity, code changes of the Nextion Display Driver and the MMDVMHost (Updated for use with Pi-Star/MMDVM Host Versions 3.4.17 (Updated) and 4.1.0RC6 (Updated) under current tests with no problems).
 
A. The FLAG CODE has went through another revision, this again for speed, redundant code reduction. This will most probably be the last time this will have to be done.
 
B. DMR Time Slot Manager has been revised to make sure a switch takes place if the MMDVM Host / NDD fails to send one or the other Time Slot information messages. Or, more so fails to send one of the messages right away. Yeah, this can happen, on very rare occasions. This fixes a failed / slow changing of the display.
 
C. DMR Page Handler only decodes 1x1, 2x1, 1x2, 1x3, 2x2, and 2x3 callsigns. 7, 8, and 9 digits, DMR IDs and TG#s will now just pass through with no flag decode. Callsign Decode Error will now trigger at the tenth digit.
 
D. YSF Page Handler now filters the callsign field. As long as the callsign is suffixed by a " ", "/", or a "-" AND it's a 1x1, 2x1, 1x2, 1x3, 2x2, or 2x3 callsign, it will be decoded, Country Name and flag being displayed. (i.e. "AG4OJ BILL", "AG4OJ/BILL", "AG4OJ-BILL") This means that things like "AMERICALNK" will not decode to Spain and Spain's flag anymore. This also means that callsigns all crammed together with no " ", "/", or "-" will not be decoded. SO, "AG4OJBILLY" will not decode AG4OJ as being the Untied States of America with the USA Flag. This is not FOOL PROOF by no means, it just reduces the incorrect decode of other messages being sent in the callsign field of the YSF message stream.
 

October 1st, 2019

 Return To The Main Page
 Return To The Main Page, link to the left. It's October 1st, 2019. The current revision number is 191001A, all earlier version are now considered archived and obsolete. Use of earlier versions are not recommended due to the ongoing maturity, code changes of the Nextion Display Driver and the MMDVMHost (Updated for use with the latest GitHub ON7LDS Nextion Display Driver v1.15. Pi-Star/MMDVM Host Versions 3.4.17 (Updated) and 4.1.0RC6 (Updated) under current tests with no problems).
 
A. Since this display is driven by a busy serial port at times, timers used to drive this display code have been relaxed to afford more time to process all of the serially sent commands properly. Remember, power supply requirements of bigger displays, your Pi-Zero W/Modem board may handle a 2.4" and 3.5", yet, 4.3" and above could cause all kinds of problems.
 
Using High Speed Serial settings in Pi-Star can make elusive intermittent problems. High Speed Serial is not necessary for my display code and High Speed Serial has it's own set of additional problems. Like RF interference from the Hotspot MMDVM board, Raspberry Pi board, WIFI/Bluetooth Transmissions, and, even more so, close proximity higher powered transmitters.
 
Protect (RF Choke), twist the wires together, and RF insulate the back of the display when using the hotspot in High Speed Serial and/or Higher Power RF environments. Also, note here that the displays themselves can emit RF noise that can interfere with other receivers. These displays are meant to be installed into a protective case. Cases that protect the display and protect the environment they operate in.
 
1. This is a tinkerers platform, iTead Nextion Displays, Raspberry Pis, Raspbian, Pi-Star, MMDVM Host, NDD, etc. ANYTHING at ANYTIME can and will go wrong, just take a deep breath. ANYONE who expects complete perfection, and/or near like, commercial product performance needs to think extra long and hard before buying/building one of these things. Realize the time needed when assemblying, using, and/or trouble shooting one of these things. All of this can be a steep learning curve for any layman.
 
2. ANYONE making all of these pieces into a commercial product is asking for heavy customer support costs and complaints. Just Saying, In My Humble Opinion, over what I have seen in almost 40 years as a Professional Engineer. If you paid a good price for a commercial product based around these pieces, make sure you get your monies worth of support calls in when you need them, because you will. Something around, about these things are always in flux.
 
3. I know many of you have PAID a PRICE to own one of these hotspots. Many have bought your own Raspberry Pi Board, MMDVM Modem board, and Display. Some have made their own special holder for it all. You have spent many hours learning how to take care of that little hotspot. So, in turn, since you have done all that hard work, I make the next statement.
 
4. With all of this being said, I'm still willing to program my screen coded files for everyone cost free. I answer all Emails as soon as I can, Email link at the bottom of this page. Any phone calls must first leave a message, I don't answer/call back unknown phone numbers, EVER.
 
B. Display of Dual Time Slots for DMR has been added. This was done in a way that no screen space was wasted when one of the Time Slots don't have anything to show. There's no need for two different versions of this code. The code defaults to the first active Time Slot. The Screen Status Images that are shown under the "DMR" logo is also a button, that, when pressed, will switch the active Time Slot being displayed on the screen. (The button turns gray when pressed) The two numbers to the right of the DMR logo/Screen Status Button are Time Slot Status Indicators only.
 
1. Transmit Priority Over-ride Selection. When a local transmission, like your radio being keyed, received by the hotspot/repeater, the screen code will switch to that Time Slot and display your transmit info on that Time Slot Screen. This will also "LOCK" the Time Slot to your Transmitted Time Slot during the transmission and for 20 seconds afterwards (No matter what the state of either Time Slots are afterwards). IF both Time Slots are being transmitted on into the Hotspot/repeater, then the first Transmitter takes screen priority.
 
2. Receive Priority Over-ride Selection. When pressing the Screen Status Button under the "DMR" logo, you will select the other Time Slot. The button background will turn gray while pressed showing that you pressed the button. This Time Slot change will then be "LOCKED" to the new Time Slot selection for 10 seconds no matter what the state of either Time Slots are at the time. After 10 seconds it will return to Standard Operating Mode. The Screen Status Button resets the timer and over-rides selected Time Slot every time it is pressed.
 
3. Standard Operating Mode. Which ever Time Slot is in active "NETWORK" transmission first is the one that will be displayed on the screen. When that Time Slot drops into NETWORK Receive, and the other Time Slot is still in NETWORK Transmission, it will become the displayed Time Slot. When both are in NETWORK Receive, the last one that dropped out of NETWORK Transmission will be the shown Time Slot on the Display. When both Time Slots are in NETWORK Transmission, the first one into that state will be displayed.
 
4. Time Slot Status Indicators, Screen Status Button colors. Green background with black letters is NETWORK Receive (Waiting for some one to talk). Red background with black letters is NETWORK Transmit (Someone is talking and/or NETWORK "HANG" Time). Red background with white letters is local RF Transmit into the Hotspot/Repeater. (You are, someone is transmitting into the hotspot/repeater locally)
 
5. So, you say you have a single Time Slot, single Hat MMDVM board. What does all of this mean for you? Well, the 1st Time Slot Indicator will always show a blank gray spot, or, a number 1 with a green background. MMDVM Host still sends out a Time Slot 1 message, even if it's only doing Time Slot 2. This code makes it possible for future hardware upgrades, like a dual hat, without unnecessary display code changes. This means swapping out displays programmed with the same screen code version is made easier.