Scanner-MAUI

Description 📝

This project aimed to build a Windows app that reads data form a portable network scanner, which records among other things LoRa network signal strength and location.

---

The app has the following features:

1. Oncoming real-time data reading and visualization directly from the scanner through serial port connection.

2. Users have the ability to choose the baud rate and "COM" port number.

3. Show the network location on the map.

4. Ability to read historical data from its SD card and apply filters based on the network name, and clear the SD card.

5. When reading the SD card the application generates a CSV file that includes the data.

---

Configuration:

When cloning the repository to your device make sure to create a "Secrets" file that includes the necessary API keys. Follow the next instructions:

1. Right click on the project name.

2. Select "Manage User Secrests".

3. Rename the file to your liking. Make sure it is a json file. Example yourfileName.josn. The file content should look like:

   {
       "Settings": {
           "API-key": "your api key",
           "EsriAPI": "your api key"
       }
   }
   

4. To get the API key from maanmittauslaitos, an account with them is necessary maanmittauslaitos.

5. For the second API key a developer account with Esri is necessary. Esri.

6. Make sure the json file name mathches the file name in the Directory.Build.targets file.

For debugging comment these lines in the Scanner-MAUI.csproj file:

 <TargetFrameworks>net7.0-android;net7.0-ios;net7.0-maccatalyst</TargetFrameworks>
 <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">11.0</SupportedOSPlatformVersion>
 <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">13.1</SupportedOSPlatformVersion>
 <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">21.0</SupportedOSPlatformVersion>

And for publishing uncomment them.

---

Issues:

1. Every time a connection to the serial port is established, and after the process is done, to reconnect, the connection with serial port should be ended manually by pressing the stop button in the UI. True for both Real-time data and Historical data pages.

2. Syncfusion guage meter causes the app to crash when resizing the Real-Time data page.

3. Every time a scan is done and the serial port is disconnected the user must exit the page and then go back to it before initilizing another serial port connection, otherwise the UI will log double values.

4. The copied CSV file (User\public) doesn't get emptied when clearing the SD card. However, the original CSV (in the app data dir) does get cleared.

5. The lodaing animation (activity indicator) in the historical data page doesn't lock up the UI to prevent the user from clicking (selecting the network name).

6. More testing needed for the app in general.