Localisation and geographical values for the smart home project. More...

Macros
#define	BOCHUM_01
	Location code for Bochum.
#define	DAWN_UTC(x)
	Get dawn in s from UTC midnight.
#define	DUSK_UTC(x)
	Get dawn in s from UTC midnight.
#define	HALF_RISE_DELTA
	The difference from mean to minimum or maximum sunrise in minutes.
#define	HALF_SET_DELTA
	The difference from mean to minimum or maximum sunset in minutes.
#define	LOCATION
	The current location.
#define	MEAN_DAWN
	Mean dawn time over the year.
#define	MEAN_DUSK
	Mean dusk time over the year.
#define	MEAN_SUN_RISE
	Mean sunrise time over the year.
#define	MEAN_SUN_SET
	Mean sunset time over the year.
#define	SUNRISE_UTC(x)
	Get sunrise in s from UTC midnight.

Detailed Description

Localisation and geographical values for the smart home project.

Copyright (c)  2018  2026  Albrecht Weinert
weinert-automation.de      a-weinert.de
 
    /         /      /\
   /         /___   /  \      |
   \        /____\ /____\ |  _|__
    \  /\  / \    /      \|   |
     \/  \/   \__/        \__/|_                                 

Revision history

Rev. 146 20.09.2026
Rev. 144 12.06.2018 : new
Rev. 164 11.07.2018 : sunset/sunrise location parameters; local macros
Rev. 145 20.09.2026 : comment corr.

This file contains some localisation, geographical and individual technical data for the current smart home project as well as for co-responding experimental / demonstrator set-up started 2018.
When porting to other locations etc. do change the values in question or, better, define a new LOCATION macro. Currently we've got BOCHUM_01, only.

Macro Definition Documentation

◆ LOCATION

#define LOCATION

The current location.

The value is set to ::Bochum_01 (default,44801).

◆ BOCHUM_01

#define BOCHUM_01

Location code for Bochum.

Bochum resp. 51.4818deg N, 7.2162deg E gets the code 44801.
The value is Bochum Querenburg's German postal code.

The macro LOCATION has to be set with the code of an implemented location; 448701 rep. BOCHUM_01 is the default.

◆ MEAN_SUN_RISE

#define MEAN_SUN_RISE

Mean sunrise time over the year.

The unit is s in day UTC. The value 6:24 CET = 5:24 UTC = 324 min.

See also: also MEAN_SUN_SET HALF_RISE_DELTA HALF_SET_DELTA MEAN_DAWN MEAN_DUSK HALF_RISE_DELTA HALF_SET_DELTA LOCATION

◆ MEAN_SUN_SET

#define MEAN_SUN_SET

Mean sunset time over the year.

The unit is s in day UTC. The value 18:37 CET = 17:37 UTC = 1057 min UTC

See also: also MEAN_SUN_RISE

◆ MEAN_DAWN

#define MEAN_DAWN

Mean dawn time over the year.

The unit is s in day UTC. This dawn is the civil twilight defined as 31 min before rise.

See also: also MEAN_SUN_RISE

◆ MEAN_DUSK

#define MEAN_DUSK

Mean dusk time over the year.

The unit is s in day UTC. This dawn is the civil twilight defines as 33 min after sunset.

See also: also MEAN_SUN_SET

◆ HALF_RISE_DELTA

#define HALF_RISE_DELTA

The difference from mean to minimum or maximum sunrise in minutes.

minutes to min. resp. max. sunrise

The value is 131 minutes.

See also: also MEAN_SUN_RISE HALF_SET_DELTA

◆ HALF_SET_DELTA

#define HALF_SET_DELTA

The difference from mean to minimum or maximum sunset in minutes.

minutes to min. resp. max. sunset

The value is 135 minutes.

See also: also MEAN_SUN_RISE HALF_RISE_DELTA

◆ SUNRISE_UTC

#define SUNRISE_UTC ( x )

Get sunrise in s from UTC midnight.

Get sunset in s from UTC midnight.

The value will be approximately (but very fast) calculated on base of the the location's (and optimally year's) sunset data.
Caveat: Consider the units and bases of the parameters. See getDaySunrise and getDaySunrise

Parameters

x	day in the year (0 is January 1st)

See also: also SUNRISE_UTC

◆ DAWN_UTC

#define DAWN_UTC ( x )

Get dawn in s from UTC midnight.

See also: also SUNRISE_UTC

◆ DUSK_UTC

#define DUSK_UTC ( x )