More info

2025-07-20 17:46:17 +02:00
5 changed files with 46 additions and 127 deletions
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -3,7 +3,7 @@ name: Build and Deploy
 on:
  push:
    branches:
-      - master
+      - master  # Change to your default branch if different
  workflow_dispatch:
    inputs:
      environment:
@@ -28,7 +28,7 @@ on:

 jobs:
  build:
-    runs-on: self-hosted
+    runs-on: self-hosted  # Ensure your self-hosted runner is configured
    environment: ${{ github.event.inputs.environment || 'prod' }}
    steps:        
    - name: Get Current User
@@ -43,7 +43,7 @@ jobs:
    - name: Set up .NET
      uses: actions/setup-dotnet@v2
      with:
-        dotnet-version: '9.0'
+        dotnet-version: '9.0'  # Change to your required .NET version

    - name: Restore .NET Dependencies
      run: dotnet restore ./HomeApi.sln
@@ -75,24 +75,6 @@ jobs:
          Write-Host "ChromeHeadlessShell not found in published output"
        }

-    # Check wwwroot and manually copy if missing
-    - name: Ensure wwwroot is Included
-      run: |
-        if (-not (Test-Path -Path "./output/dotnet/wwwroot")) {
-          Write-Host "wwwroot folder not found in published output, manually copying..."
-          
-          # Check if wwwroot exists in project directory
-          $sourceWwwroot = "./HomeApi/wwwroot"
-          
-          if (Test-Path -Path $sourceWwwroot) {
-            Write-Host "Found wwwroot directory in source, copying..."
-            New-Item -ItemType Directory -Path "./output/dotnet/wwwroot" -Force
-            Copy-Item -Path "$sourceWwwroot/*" -Destination "./output/dotnet/wwwroot" -Recurse -Force
-          } else {
-            Write-Host "WARNING: Could not find wwwroot in source directory!"
-          }
-        }
-
    - name: Generate SemVer version
      if: ${{ github.event.inputs.create_release != 'false' }}
      id: semver
@@ -100,11 +82,10 @@ jobs:
      with:
        token: ${{ secrets.GITHUB_TOKEN }}
        branch: master
-        patchAll: true
+        patchAll: true  # Always increment patch number

    - name: Create GitHub Release
      if: ${{ github.event.inputs.create_release != 'false' }}
-      id: create_release
      uses: actions/create-release@v1
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -114,61 +95,6 @@ jobs:
        draft: false
        prerelease: false
      
-    - name: Create placeholder appsettings for release
-      if: ${{ github.event.inputs.create_release != 'false' }}
-      run: |
-        $appSettings = @{
-          Logging = @{
-            LogLevel = @{
-              Default = "Information"
-              "Microsoft.AspNetCore" = "Warning"
-            }
-          }
-          ApiConfiguration = @{
-            EspConfiguration = @{
-              InformationBoardImageUrl = "http://server_ip:port/home/default.jpg"
-              UpdateIntervalMinutes = [int]"${{ vars.ESP_UPDATE_INTERVAL }}"
-              BlackTextThreshold = [int]"${{ vars.ESP_BLACK_TEXT_THRESHOLD }}"
-              EnableDithering = [System.Convert]::ToBoolean("${{ vars.ESP_ENABLE_DITHERING }}")
-              DitheringStrength = [int]"${{ vars.ESP_DITHERING_STRENGTH }}"
-              EnhanceContrast = [System.Convert]::ToBoolean("${{ vars.ESP_ENHANCE_CONTRAST }}")
-              ContrastStrength = [int]"${{ vars.ESP_CONTRAST_STRENGTH }}"
-              IsHighContrastMode = [System.Convert]::ToBoolean("${{ vars.ESP_HIGH_CONTRAST_MODE }}")
-            }
-            Keys = @{
-              Weather = "SET THIS TO YOUR KEY"
-              ResRobot = "SET THIS TO YOUR KEY"
-            }
-            BaseUrls = @{
-              Nominatim = "${{ vars.NOMINATIM_URL }}"
-              Aurora = "${{ vars.AURORA_URL }}"
-              Weather = "${{ vars.WEATHER_URL }}"
-              ResRobot = "${{ vars.RES_ROBOT_URL }}"
-            }
-            DefaultCity = "CITY ADDRESS"
-            DefaultStation = "YOUR STATION"
-          }
-          AllowedHosts = "*"
-        }
-        
-        $appSettings | ConvertTo-Json -Depth 10 | Set-Content -Path "./output/dotnet/appsettings.json"
-        Write-Host "Created placeholder appsettings.json successfully"
-
-    - name: Zip the build for github release
-      if: ${{ github.event.inputs.create_release != 'false' }}
-      run: Compress-Archive -Path './output/*' -DestinationPath './output/HomeScreen_Build_${{ steps.semver.outputs.next }}.zip' -CompressionLevel Optimal -Force
-
-    - name: Upload Release Asset
-      if: ${{ github.event.inputs.create_release != 'false' }}
-      uses: actions/upload-release-asset@v1
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      with:
-        upload_url: ${{ steps.create_release.outputs.upload_url }} 
-        asset_path: ./output/HomeScreen_Build_${{ steps.semver.outputs.next }}.zip
-        asset_name: HomeScreen_Build_${{ steps.semver.outputs.next }}.zip
-        asset_content_type: application/zip
-      
    - name: Generate appsettings.json
      run: |
        $appSettings = @{
@@ -208,6 +134,24 @@ jobs:
        $appSettings | ConvertTo-Json -Depth 10 | Set-Content -Path "./output/dotnet/appsettings.json"
        Write-Host "Generated appsettings.json successfully"

+    # Check wwwroot and manually copy if missing
+    - name: Ensure wwwroot is Included
+      run: |
+        if (-not (Test-Path -Path "./output/dotnet/wwwroot")) {
+          Write-Host "wwwroot folder not found in published output, manually copying..."
+          
+          # Check if wwwroot exists in project directory
+          $sourceWwwroot = "./HomeApi/wwwroot"
+          
+          if (Test-Path -Path $sourceWwwroot) {
+            Write-Host "Found wwwroot directory in source, copying..."
+            New-Item -ItemType Directory -Path "./output/dotnet/wwwroot" -Force
+            Copy-Item -Path "$sourceWwwroot/*" -Destination "./output/dotnet/wwwroot" -Recurse -Force
+          } else {
+            Write-Host "WARNING: Could not find wwwroot in source directory!"
+          }
+        }
+
    - name: Upload Artifacts
      uses: actions/upload-artifact@v4
      with:
@@ -215,7 +159,7 @@ jobs:
        path: ./output/dotnet

  deploy:
-    runs-on: self-hosted
+    runs-on: self-hosted  # Ensure your self-hosted runner is configured
    needs: build
    environment: ${{ github.event.inputs.environment || 'prod' }}

--- a/HomeApi.csproj
+++ b/HomeApi.csproj
@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net9.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+        <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
+    </PropertyGroup>
+
+</Project>
--- a/HomeApi/Models/Response/TrafikLabsApiResponse.cs
+++ b/HomeApi/Models/Response/TrafikLabsApiResponse.cs
@@ -1,5 +1,4 @@
 namespace HomeApi.Models.Response;
-
 public class TrafikLabsApiResponse
 {
    public List<Departure> Departure { get; set; }
--- a/Program.cs
+++ b/Program.cs
@@ -0,0 +1,3 @@
+// See https://aka.ms/new-console-template for more information
+
+Console.WriteLine("Hello, World!");
--- a/README.md
+++ b/README.md
@@ -1,39 +1,16 @@
-[![myxelium - Wireless_Eink_HomeScreen](https://img.shields.io/static/v1?label=myxelium&message=Wireless_Eink_HomeScreen&color=purple&logo=github)](https://github.com/myxelium/Wireless_Eink_HomeScreen "Go to GitHub repo")
-[![stars - Wireless_Eink_HomeScreen](https://img.shields.io/github/stars/myxelium/Wireless_Eink_HomeScreen?style=social)](https://github.com/myxelium/Wireless_Eink_HomeScreen)
-[![forks - Wireless_Eink_HomeScreen](https://img.shields.io/github/forks/myxelium/Wireless_Eink_HomeScreen?style=social)](https://github.com/myxelium/Wireless_Eink_HomeScreen)
-[![GitHub tag](https://img.shields.io/github/tag/myxelium/Wireless_Eink_HomeScreen?include_prereleases=&sort=semver&color=purple)](https://github.com/myxelium/Wireless_Eink_HomeScreen/releases/)
-[![License](https://img.shields.io/badge/License-GPL-purple)](https://www.gnu.org/licenses/gpl-3.0.en.html)
-[![issues - Wireless_Eink_HomeScreen](https://img.shields.io/github/issues/myxelium/Wireless_Eink_HomeScreen)](https://github.com/myxelium/Wireless_Eink_HomeScreen/issues)
-[![Build and Deploy](https://github.com/Myxelium/Wireless_Eink_HomeScreen/actions/workflows/build.yml/badge.svg)](https://github.com/Myxelium/Wireless_Eink_HomeScreen/actions/workflows/build.yml)
-# What why how
-This is a project I created that pulls weather data from the internet, transforms it into custom images, and displays them on an e-ink screen powered by an ESP32.
-
-## What This Project Does
-
-I wanted a low-power way to see weather information at a glance, so I built this system that:
-
- Fetches real-time weather data from online APIs
- Processes and converts the data into visual images (temperature graphs, forecast icons, etc.)
- Sends these images wirelessly to an ESP32 microcontroller
- Displays the information on an energy-efficient e-ink screen
- Updates periodically while consuming minimal power
+# This [![Build and Deploy](https://github.com/Myxelium/HomeScreen/actions/workflows/build.yml/badge.svg)](https://github.com/Myxelium/HomeScreen/actions/workflows/build.yml)
+Core api and Esp32 code for displaying weather data and public transport information on a e-ink display.

 <img width="800" height="480" alt="image" src="https://github.com/user-attachments/assets/ef5af0c6-ea3a-494d-b2af-3de6e70b3e6a" />

-# How do I get to use this without programming knowledge?
-Check in the wiki for the guide how to get everything working!
-### 😺 [Wiki Get Started Guide](https://github.com/Myxelium/Wireless_Eink_HomeScreen/wiki/)
-
-## Git Notes
-All commits has to follow this [Conventional Commits style](https://www.conventionalcommits.org/) to pass the pipeline.
-## Features 😺
+## Features
 - Display current weather data
 - Display public transport information
 - Display time and date

-## Requirements 🫥
- [ESP32 board](https://www.waveshare.com/wiki/E-Paper_ESP32_Driver_Board)
- [E-ink display (e.g. Waveshare 7.5 inch)](https://www.waveshare.com/7.5inch-e-paper-hat.htm)
+## Requirements
+- ESP32 board
+- E-ink display (e.g. Waveshare 7.5 inch)

 # Installation

@@ -101,7 +78,6 @@ API endpoints:

 When running, API documentation is available through Scalar at `/scalar`.

-```mermaid
 flowchart TD
 subgraph ESP32 Device
 ESP[ESP32 E-Ink Display]
@@ -110,10 +86,10 @@ ESP -->|HTTP GET /home/default.jpg| API
 end

    subgraph HomeApi
-        API[HomeControllerAPI]
+        API[HomeController (API)]
        API -->|MediatR| Handlers
        Handlers -->|Service Calls| Services
-        Services -->|Refit Http Clients| Clients
+        Services -->|Refit Clients| Clients
        Clients -->|External APIs| ExtAPIs
        API -->|Returns JSON/JPEG| ESP
    end
@@ -129,17 +105,3 @@ end
    ExtAPIs -.-> AuroraAPI
    ExtAPIs -.-> NominatimAPI
    ExtAPIs -.-> ResRobotAPI
-```
-
-# ESP32 configuration and building
-<img width="4096" height="1842" alt="image" src="https://github.com/user-attachments/assets/5acf1b3b-f9bb-48bd-b310-a2852544eaba" />
-
-Best way of getting the ESP32 ready for code upload is to follow this guide [WAVESHARE ESP32 GUIDE](https://web.archive.org/web/20250706150325/https://www.waveshare.com/wiki/E-Paper_ESP32_Driver_Board).
-Once you have it ready so you can upload code to it copy my code in: Esp32_Code/INFOSCREEN_WITH_INTERVAL from this repo.
-
-Install following libraries (if more is needed search for them and install them too): 
-* ArduinoJson
-* GUI_Paint
-* JPEGDEC
-
-You need the Waveshare examples installed since it uses code from them download them here [Download](https://files.waveshare.com/upload/5/50/E-Paper_ESP32_Driver_Board_Code.7z) or check above link.