@li0ard/umarsh Umarsh (transit pass system) parser
Umarsh (Умарш, short for "Удобный маршрут", which traslates to "convenient route") - developer of public transport transit pass system. It delivers turnkey projects for numerous regions (Omsk, Nizhny Novgorod, Yekaterinburg, etc.)
import { BitmapB , IDSector } from "@li0ard/umarsh" ;
const transport = Uint8Array . fromHex ( "FFFFFF7F.....25" ) ;
console . log ( new BitmapB ( transport ) . toString ( ) ) ;
const lasttrip = Uint8Array . fromHex ( "25F33472363900000000363035300000" ) ;
console . log ( new IDSector ( lasttrip ) ) ;
Sector
Description
Keys
0
Manufacturer block, last trip block (isn't used on every region)
Key A static per region. Key B diversified from UID
1
Unused. High-entropy blob or zero-filled
Key A/B static per region
2
Unused. High-entropy blob or zero-filled
Key A/B static per region
3
Unused. High-entropy blob or zero-filled
Key A/B static per region
4
Unused. High-entropy blob or zero-filled
Key A/B static per region
5
Unused. High-entropy blob or zero-filled
Key A/B static per region
6
Unused. High-entropy blob or zero-filled
Key A/B static per region
7
Unused. High-entropy blob or zero-filled
Key A/B static per region
8
Transport layout
Key A static per region. Key B diversified from UID, required to read sector
9
Unused. High-entropy blob or zero-filled
Key A/B static per region
10
Unused. High-entropy blob or zero-filled
Key A/B static per region
11
Unused. High-entropy blob or zero-filled
Key A/B static per region
12
Unused. High-entropy blob or zero-filled
Key A/B static per region
13
Unused. High-entropy blob or zero-filled
Key A/B static per region
14
Unused. High-entropy blob or zero-filled
Key A/B static per region
15
Unused. High-entropy blob or zero-filled
Key A/B static per region
Date is a packed date with 7 bits for year (based on 2000), 4 for month and 5 for day
Time is a packed time where value is hours * 100 + minutes
Last trip block (aka ID Sector) Sector 0, block 1. Everything is big-endian
Start bit
End bit
Length in bits
Purpose
0
3
4
Transport type
4
15
12
Pay time (see above)
16
31
16
Pay date (see above)
32
79
48
Route number (in ASCII)
80
127
48
Transport number (in ASCII)
Transport layout (aka BitmapB) Whole sector 8. Everything is big-endian.
Start bit
End bit
Length in bits
Purpose
0
127
128
Irreversible value (as Mifare Value Block). Purpose not entirely clear
128
128
1
Processing method of block 4. Purpose not entirely clear
129
130
2
Card technological type (eg. Passenger, Operator)
133
135
2
Bitmap version
136
151
16
Card expiration date (see above)
152
167
16
Reserved for LT as expireDateNextPeriod
168
174
7
Initial zone
175
175
1
Zone presentation
176
182
7
Final zone
184
191
8
Offline counter
192
219
28
Card number
197
199
3
Region code (HI)
224
227
4
Region code (LO)
228
231
4
Last operation terminal type
232
238
7
Card series
240
246
7
Product type (also discount percent for EP if <= 99)
247
247
1
Personal card flag
248
255
8
Transport type mask
256
271
16
Transit pass expiration/activate date (see above)
272
278
7
Validity period
279
279
1
Activation state flag
280
303
24
Last operation terminal number
304
319
16
Last operation date (see above)
320
343
24
Balance part (Custom for each card type)
327
327
1
Transaction parity
343
343
1
Lock state flag
Start bit
End bit
Length in bits
Purpose
320
326
7
Balance. Units (HI)
328
335
8
Balance. Units (LO)
336
342
7
Balance. Fractional
Start bit
End bit
Length in bits
Purpose
320
326
7
Pass cost. Units (HI)
328
335
8
Pass cost. Units (LO)
336
342
7
Pass cost. Fractional
Start bit
End bit
Length in bits
Purpose
320
326
7
Trips quantity (HI)
328
335
8
Trips quantity (LO)
Start bit
End bit
Length in bits
Purpose
152
167
16
Expire date (Next period)
168
175
8
Trips quantity (Next period, HI)
176
182
7
Trips quantity (Next period, LO)
320
326
7
Trips quantity (HI)
328
335
8
Trips quantity (LO)
132
132
1
ltpCntTripsPurchasedInCurrentPeriod (HI)
336
342
7
ltpCntTripsPurchasedInCurrentPeriod (LO)
Start bit
End bit
Length in bits
Purpose
320
326
7
Trips quanitity (HI)
328
335
8
Trips quanitity (LO)
328
331
4
Trips quanitity (Suburban, LO)
336
342
7
Trips quanitity (Suburban, HI)