Skip to main content
Version: 5.0.x {nightly}

User maps

By the term “map”, we refer to an end-user selectable configuration for the drivetrain system. This allows the user to choose the best settings for the given ride conditions. The configuration is made in the way, that if a particular map is entered, its parameters (defined in the particular map folder) are applied to driver as limiting values. This can be seen in the picture below

usermaps.jpg

Map parameters

The description of parameters for each map is in the particular map folder. More about individual maps settings

Here is a description of parameters, that are common for all maps

ParameterDescription
mapcntNumber of user maps
restmapcntNumber of restricted user maps
initmapThe number of map activated at startup
-1 = Restore last map
mapoptsBitwise parameter
1: change map on level (enable maplut)
2: Change restricted maps separatelly from normal maps
4: Disarm vehicle on map change
8: Count restricted maps from 0 on China displays
128: Geofencing msg required from device startup
maplutUsed when maps is changed by level (not by button)
maplpfWhen max power and speed is changed the limit is changed over ramp or lpf.
- positive value lpf
- negative value ramp
kphlimitLimit maximum speed [kph]
pwrlimitLimit maximum power [W]

Map abs limits

If the map setting is higher than kphlimit or pwrlimit, the limit is used instead.
Also, it is used as a reference for relative values in CAN message 0x626

Map types

There are 5 types of maps:

  • Safety map (map0): This map is in default configuration loaded directly after start of the system. Its parameters are set in the way, that the ride is not possible, until next map is activated. Map0 is possible to reach only during startup, it is not accessible later during map change. If function of safety map is not required, it is possible to set initializing map to another map, defined by parameter initmap.
  • Normal map: This type of map is accesible during the normal operating conditions. The system can cycle between these maps without any limitations
  • Restricted map: This type of map is accessible only when in_maplock is activated. Transition between normal / restricted maps can be configured by parameter mapopts
  • Reverse map (revmap): This map is activated only if in_reverse is active. It can be used for entering reverse or boost mode (depends on its parameters). Disarming is actiaved when entering reverse map.
  • Reserve map: This map is activated only if the battery SOC (or voltage) is below the value in parameter reservelevel. Reverse map can be activated only once per ride. Parameter reservemap defines what particular map (must be in range of accesible maps) is used for this functionality.

More about map count and order