contrib/file/magic/Magdir/tplink

   1
   2 #------------------------------------------------------------------------------
   3 # $File: tplink,v 1.2 2017/12/14 05:52:56 christos Exp $
   4 # tplink: File magic for openwrt firmware files
   5
   6 # URL: https://wiki.openwrt.org/doc/techref/header
   7 # Reference: http://git.openwrt.org/?p=openwrt.git;a=blob;f=tools/firmware-utils/src/mktplinkfw.c
   8 # From: Joerg Jenderek
   9 # check for valid header version 1 or 2
  10 0               ulelong         <3
  11 >0              ulelong         !0
  12 # test for header padding with nulls
  13 >>0x100         long            0
  14 >>>0            use             firmware-tplink
  15
  16 0               name            firmware-tplink
  17 >0              ubyte           x               firmware
  18 !:mime application/x-tplink-bin
  19 !:ext   bin
  20 # hardware id like 10430001 07410001 09410004 09410006
  21 >0x40           ubeshort        x               %x
  22 >0x42           ubeshort        x               v%x
  23 # hardware revision like 1
  24 >0x44           ubelong         !1              (revision %u)
  25 # vendor_name[24] like OpenWrt or TP-LINK Technologies
  26 >4              string          x               %.24s
  27 # fw_version[36] like r49389 or ver. 1.0
  28 >0x1c           string          x               %.36s
  29 # header version 1 or 2
  30 >0              ubyte           !1              V%X
  31 # ver_hi.ver_mid.ver_lo
  32 >0x98           long            !0              \b, version
  33 >>0x98          ubeshort        x               %u
  34 >>0x9A          ubeshort        x               \b.%u
  35 >>0x9C          ubeshort        x               \b.%u
  36 # region code 0~universal 1~US
  37 >0x48           ubelong         x
  38 #>>0x48         ubelong         0               (universal)
  39 >>0x48          ubelong         1               (US)
  40 >>0x48          ubelong         >1              (region %u)
  41 # total length of the firmware. not always true
  42 >0x7C           ubelong         x               \b, %u bytes or less
  43 # unknown 1
  44 >0x48           ubelong         !0              \b, UNKNOWN1 0x%x
  45 # md5sum1[16]
  46 #>0x4c          ubequad         x               \b, MD5 %llx
  47 #>>0x54         ubequad         x               \b%llx
  48 # unknown 2
  49 >0x5c           ubelong         !0              \b, UNKNOWN2 0x%x
  50 # md5sum2[16]
  51 #>0x60          ubequad         !0              \b, 2nd MD5 %llx
  52 #>>0x68         ubequad         x               \b%llx
  53 # unknown 3
  54 >0x70           ubelong         !0              \b, UNKNOWN3 0x%x
  55 # kernel load address
  56 #>0x74          ubelong         x               \b, 0x%x load
  57 # kernel entry point
  58 #>0x78          ubelong         x               \b, 0x%x entry
  59 # kernel data offset. 200h means direct after header
  60 >0x80           ubelong         x               \b, at 0x%x
  61 # kernel data length and 1 space
  62 >0x84           ubelong         x               %u bytes
  63 # look for kernel type (gzip compressed vmlinux.bin by ./compress)
  64 >(0x80.L)       indirect        x
  65 # root file system data offset
  66 >0x88           ubelong         x               \b, at 0x%x
  67 # rootfs data length and 1 space
  68 >0x8C           ubelong         x               %u bytes
  69 # in 5.32 only true for offset ~< FILE_BYTES_MAX=9 MB defined in ../../src/file.h
  70 >(0x88.L)       indirect        x
  71 #>(0x88.L)      string          x               \b, file system '%.4s'
  72 #>(0x88.L)      ubequad         x               \b, file system 0x%llx
  73 # bootloader data offset
  74 >0x90           ubelong         !0              \b, at 0x%x
  75 # bootloader data length only resonable if bootloader offset not null
  76 >>0x94          ubelong         !0              %u bytes
  77 # pad[354] should be 354 null bytes.
  78 #>0x9E          ubequad         !0              \b, padding 0x%llx
  79 # But at 0x120 18 non null bytes in examples like
  80 # wr940nv4_eu_3_16_9_up_boot(160620).bin
  81 # wr940nv6_us_3_18_1_up_boot(171030).bin
  82 #>0x120         ubequad         !0              \b, other padding 0x%llx