Last modified by YellowFox_RD on 2025/03/06 14:09
From version 3.1
edited by Dominic Lippmann
on 2025/01/23 13:02
Change comment: There is no comment for this version
To version 1.1
edited by YellowFox_RD
on 2025/01/16 12:51
Change comment: Imported from XAR

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.yf-dominic
1 +XWiki.YellowFox_RD
Content
... ... @@ -1,8 +1,5 @@
1 1  (% class="box" %)
2 -(((
3 -Table of Contents
4 -)))
5 -
2 +(((Table of Contents)))
6 6  {{toc/}}
7 7  
8 8  At the object settings you can manage the settings for your vehicle. This includes how it's displayed in the portal, which functions are supported and which data is collected.
... ... @@ -9,164 +9,96 @@
9 9  
10 10  
11 11  = Overview =
12 -
13 13  On opening the object settings you will see an overview page first. Here you can see all vehicles of which you own the required rights. The table helps you to get a quick overview about the current settings. You can filter the view by using the free-text search and vehicle group restriction. Click on the gear wheel at the top right of the table to edit the table view. The table offers a variety of columns which can be shown or hidden and changed in their order.
14 -
15 15  = Edit settings =
16 -
17 17  To edit the settings of a vehicle, hover its line in the table and click on "edit" in the action menu on the right side. If you want to edit multiple vehicles at once, select them by enabling their checkbox and click on "edit multi selection".
18 18  
19 19  == Structure of vehicle dialog ==
20 -
21 21  After starting the edit mode for one or multiple vehicles, the vehicle dialog will open. A vehicle can have a lot of settings. For reasons of clarity, these are structured into multiple sections. By using the tabs on top you can switch between //Base data// and //Settings//. //Base data// is more like information about your vehicle and settings which are relevant for displaying the data at the portal. //Settings //contains the technical settings of the box, like how often it should send data. Both sections contain multiple subsections. These can vary from vehicle to vehicle. Based on your box modell, its booked tariff and modules some sections might be hidden.
22 -The subsections hold the actual settings. Usually they are displayed as tiles. They display the current settings in the most easily comprehensible style. If you opened the vehicle dialog with multiple vehicles and these vehicles have different values for a the same setting, the settings will be displayed as mixed. To edit a setting, click on the pencil icon at the top right corner of the tile. The tile will switch to edit mode. To edit multiple tiles you can also click on the //Edit settings// button at top right corner. This will switch all visible tiles to edit mode. To save your changes, click on the //Save //button at bottom right corner of the tile. Click on the// Save changes// button in bottom right corner to save all changes at once. If you changed something, but don't want to save it, click the cross icon in top right corner of the tile to discard your changes. You can also use the //Discard changes// button at the bottom left corner to do this for all tiles.
23 -
15 +The subsections hold the actual settings. Usually they are displayed as tiles. They display the current settings in the most easily comprehensible style. If you opened the vehicle dialog with multiple vehicles and these vehicles have different values for a the same setting, the settings will be displayed as mixed. To edit a setting, click on the pencil icon at the top right corner of the tile. The tile will switch to edit mode. To edit multiple tiles you can also click on the //Edit settings// button at top right corner. This will switch all visible tiles to edit mode. To save your changes, click on the //Save //button at bottom right corner of the tile. Click on the// Save changes// button in bottom right corner to save all changes at once. If you changed something, but don't want to save it, click the cross icon in top right corner of the tile to discard your changes. You can also use the //Discard changes// button at the bottom left corner to do this for all tiles.
24 24  === Pending changes ===
25 -
26 26  Changes that have to be sent to the box, will be displayed with an orange border after save. Right to the headline of the tile you will also see an icon displaying this. If you click on it, you will see exactly which changes are still pending. The system tries to send the changes as soon as possible to the vehicle. If the vehicle confirms the changes, the border will disappear. If the vehicle can not be contacted, the system will try again later. As an admin you can set at //My profile// what is the maximum time that the system tries to contact the vehicle.
27 -
28 28  === Failed changes ===
29 -
30 30  If the vehicle could not  be contacted during the maximum of notification time, the settings will be marked as failed. The tile will get a red border and another icon next to the headline. You can click on this as well and see which setting failed. You might also resend it from there.
31 -
32 32  ==== Multi-change ====
33 -
34 34  If you edit multiple vehicles at once, after clicking on save, it will not save the data immediately, but show you an overview of all changes. Here you can uncheck some vehicles by using the checkboxes on the left side to seclude single vehicles from the change.
35 35  
36 36  [[image:setcar_3.png]]
37 37  
38 38  == Base data ==
39 -
40 40  At base data you will see some general info and settings of your vehicle.
41 -
42 42  === Map ===
43 -
44 44  ==== Map symbol ====
45 -
46 46  The map symbol defines which symbol shall be used to show this vehicle in the map. You can choose between different symbols and colors to represent your vehicle in the best way. Some symbol types are only available in one color.
47 -
48 48  ==== Routing profile ====
49 -
50 50  If you do a routing request at the portal, the best route will be calculated. This route depends on a lot of factors like your vehicles size, its emission or what it's transporting. These factors can be grouped as a routing profile which you can assign to your vehicle here. This profile will be used automatically on planning a new route for this vehicle.
51 -
52 52  === Odometer ===
53 -
54 54  These settings are unavailable if your vehicle uses an automatic source for getting odometer values like the Digitacho. Automatic sources should always be preferred to odometer calculation via GPS.
55 -
56 56  ==== Odometer ====
57 -
58 58  By default the odometer value is calculated by the vehicles GPS data. This might lead to variation or you might have to set the intial value. You can do this here. Please notice that there are some requirements for using this function. You can change the odometer value every 10 minutes at max. You have to wait until the vehicle confirmed the last value before you can send another. The new odometer value can not be lower than the last manual value. Editing the odometer value can not be reverted!
59 -
60 60  ==== Correction factor ====
61 -
62 62  Calculating the odometer value based on GPS data might lead to variation. These might be adjusted by adding a general correction factor. If you set a value different from 1, each driven kilometre will be multiplied by this value in the future.
63 -
64 64  === Demarcation ===
65 -
66 66  If you connect a telematic box with your vehicle, these two are one unit for YellowFox. All data that is collected by your vehicle belongs to the box as well. However you might want to connect the box to another vehicle in the future, e.g. because the vehicle is broken or will be sold. To not mix the data of the old and new vehicle, it might be useful to demaracte the vehicle first. On demarcation a virtual vehicle is created. All data that has been collected by the vehicle resp. box until then will be assigned to the virtual vehicle and can be accessed via this. The virtual vehicle does not produce any additional costs. All new data will be assigned to the real vehicle. Of course you can undo the demaraction if you need to. A virtual vehicle can not be demaracted again. Please notice that if you delete the real vehicle, the virtual vehicle will be lost as well.
67 67  The demarcation can be cancelled in the original vehicle under "History". To do this, click on the "Show history" slider in the "Demarcation" tab in the originally demarcated vehicle and select "Undo" as the action for the demarcation to be deleted.
68 -
69 69  === Report ===
70 -
71 71  ==== Idle report ====
72 -
73 73  To enable the correct evaluation at the idle report, the vehicle has to be activated for this report. Only then the vehicle will send special position messages on detecting an idle state and if the idle has state has ended.
74 -
75 75  ==== Digitacho profile ====
76 -
77 77  Vehicle which do cross-border passenger service apply to other work time laws than for example transport vehicles. Drivers of such vehicles are allowed to work 2 working weeks after another and have to do 2 week idle times afterwards.
78 78  If the bus profile is selected, it affects the D8 data of all drivers using this vehicle.
79 -
80 80  ==== Travel-time report ====
81 -
82 82  Here you can set how the travel-time should be recorded. By default this is the time between ignition on and ignition off. You might change this to another input. Furthermore you can decide if the speed should be used for idle detection.
83 -
84 84  ==== Cost center ====
85 -
86 86  Here you can set a cost center for the vehicle. It will be used for accounting and can also be requested via interfaces.
87 -
88 88  === Technical data ===
89 -
90 90  At technical data you can see the technical attributes of the telematic box, such as IMEI or serial number. These can not be edited. Furthermore you can add a vehicle identification number if it was not added automatically. Each vehicle identification number owns a "valid from" and can be changed. This enables you to change the VIN if the telematic box was transferred to another physical vehicle.
91 -
92 92  ==== Fuel cap monitoring ====
93 -
94 94  If you own a fuel cap connected via YellowFox, you can see here how much of the guaranteed battery lifetime remains. YellowFox guarantees 3 years of battery life.
95 -
96 96  ==== System administration ====
97 -
98 98  At system administration you will find some critical settings that can help you during problems with the box.
99 -
100 100  ===== Delete position data =====
101 -
102 102  Here you can delete all position data before a certain date. This might e.g. be useful to reset the box after a test phase. For technical reasons the date must be older than 8 weeks. Please notice that deleteing the data can not be undone.
103 -
104 104  ===== Restart box =====
105 -
106 106  Here you can force a restart of the box. This might be useful if the box e.g. froze for some reason.
107 -
108 108  ===== Request PikoSys version =====
109 -
110 110  If your box is connected to a PikoSys, you can request its version here.
111 -
112 112  == Settings ==
113 -
114 114  === Locating ===
115 -
116 116  Locating settings are the most important part of any telematics box. These settings state when and how often position data should be sent. You can use different triggers for this.
117 -
118 118  ==== GPS-based locating ====
119 -
120 120  This sends messages based on position data. The trigger for a position message can be
121 -
122 122  (((
123 123  * time interval
124 124  * distance
125 125  * course change
126 126  )))
127 -
128 128  Some boxes also support intelligent locating. This means time, distance and course change will be combined for a more efficient result.
129 -
130 130  ==== Locating on underspeed or overspeed ====
131 -
132 132  These settings are based on a specific velocity. If your vehicle exceeds or undercuts these values, specific position messages will be sent.
133 -
134 134  ==== Selfgeofence ====
135 -
136 136  By using a Selgeofence, the vehicle can monitor its position and send an alarm on irregularities. You can define when the Selfegofence should become active and if it should be deactivated or even blocked by a specific telemetry input.
137 137  Furthermore it is possible to activate or deactivate the Selfegeofencing right now by clicking on the respective button.
138 -
139 139  ==== Telemetry-based locating ====
140 -
141 141  By default position messages are only sent while the ignition is on. This extends your battery life as it is not being loaded with ignition off. You can add further telemetry inputs which trigger position messages. If such a input gets turned on, the vehicle will send location messages based on the locating settings.
142 -
143 143  ==== Battery management ====
144 -
145 145  This setting is only for devices with a battery. Typically such boxes are used for vehicles and objects which do not have a battery themselves and can not use the ignition state for locating. For such boxes you can set if the vehicle should send position messages on movement or stay in sleep mode. You can also set how long the box should stay active after wake up. In this way you can simulate an ignition as the box gets active when the vehicle moves and returns to sleep mode while standing.
146 146  These settings influence the battery life as each position message costs energy.
147 -
148 148  ==== Locate without movement ====
149 -
150 150  This setting is only for devices with a battery. Here you can set if the box should sent position messages while standing. This could help you to check regularly if the box is still available. Set if and when the box should send messages. The selectable intervals my differ based on box type.
151 151  These settings influence the battery life as each position message costs energy.
152 -
153 153  === Telemetry ===
154 -
155 155  Telemetry inputs collect data like the ignition state or states of other connected components like pumps or brushs. These inputs are registered by our support during registration of the box at YellowFox portal. Each input has a name and labels for its status messages (what to show if the input is "on" or "off"). These settings can only by changed by our support. Please contact us if you need assistance for this.
156 156  Each input can have a connected component. In this case a status change will lead to special impacts on the YellowFox portal. The following components can be assigned:
157 -
158 158  (((
159 159  * fuel cap: This influences the data for telemetry report.
160 160  * home switch: This helps you to register home drives for your logbook.
161 161  * private switch: If this input is active, all registered drives will be marked as private drive. Based on your company settings this might mean that the drive will not be shown at all.
162 162  )))
163 -
164 164  === Driver behaviour ===
165 -
166 166  At the driver behaviour settings you can set limits up from which a driving behaviour is evaluated as positive or negative. These values are used for the driver behaviour report.
167 167  Depending on vehicle type and use case these values might differ. That is why you can set them individually for each vehicle. As assistance YellowFox offers you some default profiles which you can use via "Preset for configuration". Click on the checkmark to load the preset. You can now alter values if you need to. Click on "Save changes" to confirm your changes. You might also use the configuration of another vehicle of your own fleet as a preset.
168 168  The following values can be set for driver behaviour:
169 -
170 170  (((
171 171  * **Braking deceleration**: Extreme braking can wear off your vehicle much faster. Set how intense the braking is allowed to be.
172 172  * **Acceleration**: Extreme acceleration can be a safety issue. Set how fast the vehicle is allowed to accelerate.
... ... @@ -176,31 +176,18 @@
176 176  * **Threshold outside of motorway**: For country roads and city traffic you can set an individual speed limit.
177 177  * **Threshold wear-free braking:** If you have connected a retarder brake via FMS to YellowFox, you can set the threshold for wear-free braking. Wear-free braking calculates the ratio of retarder braking relative to service brake. As the retarder brake can not be used to brake until the vehicle is standing, you can set that braking below a certain velocity shall be ignored. This threshold is 7 km/h by default.
178 178  )))
179 -
180 180  === Temperature ===
181 -
182 182  A vehicle can gather temperature data via sensors. Each vehicle can have up to 8 digital inputs (like e.g. connected Thermoking or Euroscan) and up to 4 analogue inputs (temperature is measured by voltage at a telemetry input). Here you can set several settings for these inputs.
183 -
184 184  ==== Message interval ====
185 -
186 186  As long as the vehicle is in motion, each position message will also contain temperature data. If the ignition is off, no position messages are sent by default. In case of e.g. a cooling vehicle you might want to observe the status of cooling even when the vehicle is not moving. Therefore you can define a message interval while "ignition off". Based on your setting the vehicle will send position data as well as temperature data even while standing.
187 -
188 188  ==== Configuration per input ====
189 -
190 190  Each input can have its own alarm configuration. Define what is the valid temperature range for each input. If a temperature is measured which is outside of this range, an alarm can be started. Define how long the temperature has to be outside of the range to start the alarm and how long it should be valid. You might also deactivate this setting for each input individually.
191 -
192 192  ==== Correction values ====
193 -
194 194  This setting is only relevant if you have analogue inputs. Measuring temperature via those can be unprecise. Set a correction value which should be set off against each temperature value. You can set it for each input individually.
195 -
196 196  === Display ===
197 -
198 198  If your device is a display or a vehicle connected to a display, you can define settings for the display.
199 -
200 200  ==== Display type ====
201 -
202 202  No matter the fact if your vehicle is connected to a display or your current vehicle is a display itself, here you can see what kind of display it is and whats the current firmware version. The display type is the device type. An usual smartphone with installed fleet app is called "Fleet". A device that acts as timemanager als also called "Timemanager". In the past YellowFox used to sell even more types of displays. These will be displayed if needed. Following types are possible:
203 -
204 204  (((
205 205  * MDT
206 206  * Garmin (FMI)
... ... @@ -207,95 +207,60 @@
207 207  * Fleet
208 208  * Timemanager
209 209  )))
210 -
211 -Furthermore you can see how the display was connected to the box if it is connected. A display can be connected by cable or [[virtually>>doc:YellowFox Standard Portal.Verwaltung.Fahrzeuge verbinden.WebHome||anchor="Fahrzeugeverbinden-Displaysverbinden"]].  
126 +Furthermore you can see how the display was connected to the box if it is connected. A display can be connected by cable or [[virtually>>doc:/display/ds/Fahrzeuge+verbinden||anchor="Fahrzeugeverbinden-Displaysverbinden"]].  
212 212  Finally you can see the display version. If the display communicates with the YellowFox portal, the version is submitted automatically. By clicking on "Query" you might request the version manually as well. If the display is available it will send a position message including the installed version number.
213 -
214 214  ==== Set-Up ====
215 -
216 216  To use some modules on the display, it is necessary to send their configurations first. These might be e.g. be the fuel cards which are allowed, the possible drive types for the logbook or settings of activities for the timerecording.
217 -
218 218  ==== Booting Hint ====
219 -
220 220  On display start you can set a hint or form to be displayed. You might use this to remind your drivers of a vehicle check or even do the vehicle check via a custom form.
221 221  Choose first if you want to use a hint or form and when it should be displayed. Based on your selection you need to decide next, what content should be used. If you have chosen a form you can set, if the form is mandatory or if the driver is allowed to skip it. Using a form is not supported by all devices and might therefore not be offered to you.
222 -
223 223  ==== Login of unknown persons ====
224 -
225 225  Here you can set if a driver with an unknown personnel key is allowed to login. If this function is deactivated, only keys which are known to personnel management are allowed.
226 -
227 227  ==== Connect display ====
228 -
229 229  Display can be connected to vehicles via cable or virtually. Virtual connections are a purely technical connection only known to YellowFox. Usually you add these kind of connections via the portal. If you want your display to be able to virtually connect to a vehicle by itself, you need a QR code. This can be created for each vehicle. Afterwards you might print it and put it in your vehicle. The display can now scan it via the app and will be connected to the vehicle automatically.
230 -
231 231  ==== Disconnect virtual display ====
232 -
233 233  If your display has a virtual connection, this connection can usually only be disconnected via the portal. If you activate this function, it might also be disconnected via the app.
234 -
235 235  ==== Display event configuration ====
236 -
237 237  The following events can be specified here in order to provide specific information in the vehicle during an action or to fill out a specific form (e.g. departure check):
238 -
239 239  (((
240 240  * Application start
241 241  * Driver authentication
242 242  * Shift start (DigiTacho/D8) = only from firmware version 4.2.6.1 and higher
243 243  )))
244 -
245 245  For these, it is possible to display additional information as
246 -
247 247  (((
248 248  * Display a message with title and description or
249 249  * opening a form for filling in
250 250  )))
251 -
252 252  to be displayed. This ensures that important information is transmitted directly and immediately.
253 -
254 254  === Driver authentication ===
255 -
256 256  Vehicles with a digitacho device have a mandatory driver authentication. This can be useful for other vehicles as well.
257 -
258 258  ==== Authentication ====
259 -
260 260  Here you can set how the driver should authenticate. For vehicles with a digitacho it makes sense to just use the authentication of the digitacho. For other vehicles you have alternatives like e.g. NFC keys.
261 -
262 262  ==== Invalid authentication ====
263 -
264 -If the driver misses to authenticate, you can react to this. Set if in this case a specific output should switch to active for a specific time. You could connect something to this output which alerts the driver like a light or sound. Furthermore you can set if a YellowFox alarm should be triggered as well, also see [[alarm manager>>doc:YellowFox Standard Portal.Verwaltung.Alarmmanager.WebHome]].
265 -
157 +If the driver misses to authenticate, you can react to this. Set if in this case a specific output should switch to active for a specific time. You could connect something to this output which alerts the driver like a light or sound. Furthermore you can set if a YellowFox alarm should be triggered as well, also see [[alarm manager>>doc:/display/ds/Alarmmanager]].
266 266  ==== Discard authentication ====
267 -
268 268  If the driver does not log off after driving and the next driver does not login, he might drive under the name of the first driver. This would be a problem if you want to evaluate the driving data later on. That is why you can set if the authentication should be discared after the ignition turns off. By doing so the next driver is forced to authenticate again.
269 -
270 270  === Operating hours counter ===
271 -
272 272  An operating hours counter records how long a telemetry input has been active. You can connect up to 2 operating hours counters to your box, but please notice that this is not supported by all box types.
273 273  You can set per operating hours counter which telemetry input it should observe. Usually the counter increases steadily, but you are able to set a manual value as well. This might be useful to e.g. reset the counter. If you leave the field empty, the counter will count regularly. As changes to the operating hours counter are a critical setting, you need to confirm your changes by entering your password.
274 -
275 275  === YellowPad ===
276 -
277 -The YellowPad is a small keypad with 11 keys. Four of these keys can have self-assigned functions. This might be useful for example for silent alarms in taxis or to send a default message. Each key can be edited individually. The following functions are possible:
278 -
164 +The YellowPad is a small keypad with 11 keys. Four of these keys can have self-assigned functions. This might be useful for exmaple for silent alarms in taxis or to send a default message. Each key can be edited individually. The following functions are possible:
279 279  (((
280 -* Send logbook state: Set a pre-defined [[logbook state>>doc:YellowFox Standard Portal.Berichte.Fahrtenbuch.WebHome]].
281 -* Send message: Send a pre-defined [[message>>doc:YellowFox Standard Portal.Aufträge.Nachrichten.WebHome]].
282 -* Send alarm message: Raise an alarm at the [[alarm manager>>doc:YellowFox Standard Portal.Verwaltung.Alarmmanager.WebHome]].
166 +* Send logbook state: Set a pre-defined [[logbook state>>doc:/display/ds/Fahrtenbuch]].
167 +* Send message: Send a pre-defined [[message>>doc:/display/ds/Nachrichten]].
168 +* Send alarm message: Raise an alarm at the [[alarm manager>>doc:/display/ds/Alarmmanager]].
283 283  * Send vehicle position: Send a position message immediately, regardless of the set locating interval.
284 284  * Project time recording: Book "begin" and "end" for time recording. Can only be assigned to keys 1 and 2 and only to both at once. Only available if you have unlocked this function. This is an deprecated function which was replaced by new time recording.
285 285  )))
286 -
287 287  === Follow up time ===
288 -
289 289  Normally the telematic box sends data to YellowFox only while driving and can only wait for new commands during this time. Optionally other telemetry inputs can trigger this state. The follow up time states, how long after start of inactivity the box should stay in standby mode and will therefore be available for new commands. Only in this mode the box can still be located. The follow up time restarts with every ignition off. After the follow up time ends, the box will shut down automatically. During standby mode the box uses about 200 to 250 mA by using a 12V on-board power supply. To save battery a follow up time greater than 6 days makes only sense rarely. On starting the next drive the box will wake up automatically.
290 290  Some boxes have more complex settings. These can have a configuration for power save mode. This mode has more detailled information about the types of messages that can be send during standby and how long the box shall stay online. This helps you to operate the power supply more detailled, but is not supported by all box types.
291 -
292 292  === Outputs ===
293 -
294 294  Outputs can be connected to various components, which can then be operated by the telematic box. It is possible to activate and deactivate these ports. An example would be a lamp or an audio signal. Using the settings you can see the current state of the output and alter its state.
295 295  Outputs are used for example at the driver authentication. Here they can be operated on raising a warning/alarm.
296 296  
297 297  = Vehicle groups =
298 -
299 299  //Vehicle group management is only available if you have admin rights.//
300 300  Vehicle groups help you to sort your vehicles. For example, you might create groups for your distinct affiliates or departments. The created groups are available at many places in the portal and help you to select multiple vehicles easily. Via vehicle group management you can create new groups and assign vehicles to them. Click on “Create new vehicle group” to start the process. An input mask will open. Here you first must set a name for your group. Afterwards you select the vehicle that should belong to this group. To edit an existing group, click on “Edit group” in the action menu of the overview table. Here you can also find actions to delete or duplicate a group. At the overview table you can see the currently assigned vehicles. Click on the X of a vehicle to remove it from a group fast.
301 301  You can also edit the vehicle assignment via the vehicle overview of the vehicle-specific settings. To do so, click on “Edit group assignments” at the action menu. If you have selected multiple vehicles, you might also use the multi action on bottom right of the table. This helps you to easily add multiple groups to one or many vehicles. Please notice, that the old assignments will be overwritten. If your vehicles had different assignments before and you do not explicitly check them again, they might be lost.