mifare-access-condition-builder 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6003272e84a05fd5886ce5690dc75bc25fc389b8379b215f5a5a9d8adafc6af9
+  data.tar.gz: 6eb0b72658c878a0a0d06e006387f85b898babeef3a14c20343b5fb6be62ee76
+SHA512:
+  metadata.gz: 9bf4ac69c61585e825ac25255fb0fd769d24c17c8003e578492481340b2cca2ba45a1a0a49b7d5116f552a3dd2cebf80b77777805ad595c24c72abc14dd370de
+  data.tar.gz: 8ab182615b9e2b111b67012011169230f66fcce9ba222e63311b5aeb3d465eb30abc018ea2f76f18676ee2af8339c5bb512307e7d32e556be001d9654aab2ea7

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2011-12-19
+
+* 1 major enhancement
+
+  * Birthday!
+

data/README.md

@@ -0,0 +1,53 @@
+mifare-access-condition-builder
+===============================
+
+https://github.com/larskanis/mifare-access-condition-builder
+
+A GUI to calculate the access condition bytes of sectors of Mifare contactless chip cards
+
+REQUIREMENTS
+------------
+
+* Ruby
+* Fox toolkit (required on MacOS and Linux, builtin on Windows)
+
+INSTALL + RUN
+--------------
+
+* On Windows install the Rubyinstaller (with or without Devkit) https://rubyinstaller.org/downloads/
+* On Linux use `sudo apt install ruby-dev g++ libxrandr-dev libfox-1.6-dev` or similar
+
+Then run on the command line:
+
+```sh
+$ gem install mifare-access-condition-builder
+$ mifare_access_condition_builder
+```
+
+![Screenshot](screenshot.png?raw=true "GUI of the mifare-access-condition-builder")
+
+LICENSE
+-------
+
+(The MIT License)
+
+Copyright (c) 2024 Lars Kanis - Sincnovation Falkenstein GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+require "rubocop/rake_task"
+
+Minitest::TestTask.create
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]
+task gem: :build

data/exe/mifare_access_condition_builder

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'mifare_access_condition_builder'
+require 'fox16'
+
+app = Fox::FXApp.new("MifAccMain", "ComCard")
+MifareAccessConditionBuilder::MainWindow.new(app)
+app.create
+app.run

data/lib/mifare_access_condition_builder/version.rb

@@ -0,0 +1,3 @@
+module MifareAccessConditionBuilder
+  VERSION = '1.1.0'
+end

data/lib/mifare_access_condition_builder.rb

@@ -0,0 +1,301 @@
+#! /usr/bin/env ruby
+# -*- coding: utf-8 -*-
+###########################################################################
+#    Copyright (C) 2004 by Lars Kanis
+#    <kanis@comcard.de>
+#
+# Copyright: See COPYING file that comes with this distribution
+###########################################################################
+#
+
+require 'rubygems'
+require 'fox16'
+require 'fox16/colors'
+
+module MifareAccessConditionBuilder
+
+autoload :VERSION, 'mifare_access_condition_builder/version'
+
+class MainWindow < Fox::FXMainWindow
+  include Fox
+
+  AccBlock = Struct.new :bits, :descs, :key_b_readable
+
+  def initialize(app)
+    # Initialize base class
+    super(app, "Mifare Access Condition Builder #{VERSION}", nil, nil, DECOR_ALL, 0, 0, 750, 250)
+
+    # Tooltips einschalten und auf dauerhafte Anzeige einstellen.
+    FXToolTip.new(getApp(), TOOLTIP_PERMANENT)
+
+    #    scrollwindow = FXScrollWindow.new(self, LAYOUT_FILL_X | LAYOUT_FILL_Y)
+    top = FXVerticalFrame.new(self, LAYOUT_FILL_X | LAYOUT_FILL_Y){|theFrame|
+      theFrame.padLeft = theFrame.padRight = theFrame.padBottom = theFrame.padTop = 5
+      theFrame.vSpacing = 5
+
+      FXHorizontalFrame.new(theFrame, LAYOUT_FILL_X|LAYOUT_FILL_Y){|hex_frame|
+        FXLabel.new(hex_frame, 'Hex-Eingabe (3 Byte):')
+        @hex_input = FXTextField.new(hex_frame,0, nil, 0, TEXTFIELD_NORMAL|LAYOUT_FILL_X){|this|
+          this.connect(SEL_COMMAND, method(:hex_changed))
+          this.text = 'FF 07 80'
+        }
+      }
+      @message = FXLabel.new(theFrame, ''){|this|
+        this.textColor = FXColor::Red
+      }
+
+      @acc_blocks = []
+      FXMatrix.new(theFrame, 8, MATRIX_BY_COLUMNS | LAYOUT_FILL_X, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0){|matrix|
+        [''].+(DataBitsHead).each{|labeltext|
+          FXLabel.new(matrix, labeltext, nil, LAYOUT_FILL_COLUMN|LAYOUT_FILL_X)
+        }
+
+        for blocknr in 0..2 do
+          acc_block = AccBlock.new nil, []
+          FXLabel.new(matrix, "Block #{blocknr}", nil, LAYOUT_FILL_X)
+          acc_block.bits = FXTextField.new(matrix,10, nil, 0, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X)
+          acc_block.bits.connect(SEL_COMMAND, method(:bits_changed))
+          FXLabel.new(matrix,'->')
+          for desc in 0...5
+            acc_block.descs << FXLabel.new(matrix, '', nil, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X|TEXTFIELD_READONLY){|this|
+              this.backColor = FXColor::LightGoldenrod1
+              bits_field = acc_block.bits
+              this.connect(SEL_LEFTBUTTONPRESS){|sender, sel, ptr|
+                desc_clicked(sender, sel, ptr, bits_field, acc_block.key_b_readable ? :data_key_b_readable : :data_key_b_secret)
+              }
+            }
+          end
+          @acc_blocks << acc_block
+        end
+      }
+      FXMatrix.new(theFrame, 10, MATRIX_BY_COLUMNS | LAYOUT_FILL_X, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0){|matrix|
+        [''].+(TrailerBitsHead).each{|labeltext|
+          FXLabel.new(matrix, labeltext, nil, LAYOUT_FILL_COLUMN|LAYOUT_FILL_X)
+        }
+
+        acc_block = AccBlock.new nil, []
+        FXLabel.new(matrix, "Block 3", nil, LAYOUT_FILL_X)
+        acc_block.bits = FXTextField.new(matrix,10, nil, 0, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X)
+        acc_block.bits.connect(SEL_COMMAND, method(:bits_changed))
+        FXLabel.new(matrix,'->')
+        for desc in 0...7
+          acc_block.descs << FXLabel.new(matrix,'', nil, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X|TEXTFIELD_READONLY){|this|
+            this.backColor = FXColor::PaleGreen
+            bits_field = acc_block.bits
+            this.connect(SEL_LEFTBUTTONPRESS){|sender, sel, ptr|
+              desc_clicked(sender, sel, ptr, bits_field, :trailer)
+            }
+          }
+        end
+        @acc_blocks << acc_block
+      }
+    }
+    # sinnvolle default-Werte in Felder eintragen
+    hex_changed
+  end
+
+  def create
+    super
+    show(PLACEMENT_SCREEN)
+    app.addTimeout(1) do
+      @hex_input.setFocus
+    end
+  end
+
+  def display_error
+    begin
+      yield
+    rescue InvalidArgument => e
+      @message.text = e.to_s
+    else
+      @message.text = ''
+    end
+  end
+
+  def hex_changed(sender=nil, sel=nil, ptr=nil)
+    hex = @hex_input.text
+#     puts "hex-input: #{hex}"
+
+    bits = nil
+    display_error do
+      bits = acc_hex_to_bits(hex)
+      # puts bits
+
+      @acc_blocks.each_with_index do |bl, blidx|
+        bl.bits.text = bits[blidx]
+      end
+    end
+
+    display_bits_desc
+  end
+
+  def bits_changed(sender=nil, sel=nil, ptr=nil)
+    blocksbits = @acc_blocks.map{|ab| ab.bits.text }
+#     puts "bits-input: #{blocksbits.inspect}"
+
+    hex = ''
+    display_error do
+      hex = acc_bits_to_hex(blocksbits).upcase
+#       puts hex
+    end
+    display_bits_desc
+
+    @hex_input.text = [hex[0,2], hex[2,2], hex[4..-1]].join(" ")
+  end
+
+  class InvalidArgument < RuntimeError # :nodoc:
+  end
+
+  def acc_hex_to_bits(hex)
+    hex = hex.gsub(/\s/, '')
+    raise InvalidArgument, "3 Byte Hex-String erwartet: #{hex.inspect}" unless hex=~/^[0-9a-f]{6,6}$/i
+
+    blocksbits = ['','','','']
+    nibbles = [hex[2,1].hex, hex[5,1].hex, hex[4,1].hex]
+    nibbles.each do |nibble|
+#       puts "nibble: #{nibble.inspect}"
+      blocksbits.each_with_index do |blockbits, bbidx|
+        onoff = (nibble >> bbidx) & 1
+#         puts "onoff: #{onoff.inspect} bits: #{blockbits.inspect}"
+        blockbits << (onoff>0 ? '1' : '0')
+      end
+    end
+    hex2 = acc_bits_to_hex(blocksbits)
+    raise InvalidArgument, "Hex-Daten sind inkonsistent: #{hex}!=#{hex2}" unless hex.upcase==hex2.upcase
+
+    return blocksbits
+  end
+
+  def acc_bits_to_hex(blocksbits)
+    raise InvalidArgument, "Bits fuer 4 Bloecke erwartet: #{blocksbits.inspect}" unless blocksbits.length==4
+
+    blocksbits.each_with_index do |bit, bidx|
+      raise InvalidArgument, "3 Bit String für Block #{bidx} erwartet: #{bit.inspect}" unless bit=~/^[0-1]{3,3}$/i
+    end
+
+    nibbles = [0,0,0]
+    blocksbits.each_with_index do |blockbits, bbidx|
+      nibbles.each_with_index do |nibble, nidx|
+        onoff = blockbits[nidx,1].hex
+        nibble |= onoff << bbidx
+        nibbles[nidx] = nibble
+      end
+    end
+    return sprintf("%x%x%x%x%x%x",
+      nibbles[1] ^ 0xf, nibbles[0] ^ 0xf,
+      nibbles[0], nibbles[2] ^ 0xf,
+      nibbles[2], nibbles[1])
+  end
+
+  DataBitsHead = ['bits','','read', 'write', 'increment', 'dec,tran,dec', 'description']
+  DataBitsDesc = {
+    '000' => [['A|B', 'A|B', 'A|B', 'A|B'], ['A', 'A', 'A', 'A'], 'transport config'],
+    '010' => [['A|B', '-'  , '-'  , '-'  ], ['A', '-', '-', '-'], 'read/write block'],
+    '100' => [['A|B', 'B'  , '-'  , '-'  ], ['A', '-', '-', '-'], 'read/write block'],
+    '110' => [['A|B', 'B'  , 'B'  , 'A|B'], ['A', '-', '-', 'A'], 'value block'],
+    '001' => [['A|B', '-'  , '-'  , 'A|B'], ['A', '-', '-', 'A'], 'value block'],
+    '011' => [['B'  , 'B'  , '-'  , '-'  ], ['-', '-', '-', '-'], 'read/write block'],
+    '101' => [['B'  , '-'  , '-'  , '-'  ], ['-', '-', '-', '-'], 'read/write block'],
+    '111' => [['-'  , '-'  , '-'  , '-'  ], ['-', '-', '-', '-'], 'read/write block'],
+  }
+  TrailerBitsHead = ['bits','', 'read A', 'write A', 'read ACC', 'write ACC', 'read B', 'write B', 'description']
+  TrailerBitsDesc = {
+    '000' => ['-', 'A', 'A'  , '-', 'A', 'A', 'Key B may be read'],
+    '010' => ['-', '-', 'A'  , '-', 'A', '-', 'Key B may be read'],
+    '100' => ['-', 'B', 'A|B', '-', '-', 'B', ' '],
+    '110' => ['-', '-', 'A|B', '-', '-', '-', ' '],
+    '001' => ['-', 'A', 'A'  , 'A', 'A', 'A', 'Key B may be read, transport config'],
+    '011' => ['-', 'B', 'A|B', 'B', '-', 'B', ' '],
+    '101' => ['-', '-', 'A|B', 'B', '-', '-', ' '],
+    '111' => ['-', '-', 'A|B', '-', '-', '-', ' '],
+  }
+
+  def display_bits_desc
+    @acc_blocks.each_with_index do |acc_block, blidx|
+      if blidx==3
+        descs = TrailerBitsDesc[acc_block.bits.text] || Array.new(6,'')
+      else
+        trailer = TrailerBitsDesc[@acc_blocks.last.bits.text]
+        ws_descs, wr_descs, desc = DataBitsDesc[acc_block.bits.text] || [Array.new(4,'')]*2
+        if trailer && trailer[4].tr("-","").empty?
+          descs = ws_descs + [desc] # Key B can't be read
+          acc_block.key_b_readable = false
+        else
+          descs = wr_descs + [desc] # Key B may be read
+          acc_block.key_b_readable = true
+        end
+      end
+      descs.each_with_index{|desc, descidx| acc_block.descs[descidx].text = desc.to_s }
+    end
+  end
+
+  def desc_clicked(sender, sel, ptr, bits_field, data_or_trailer)
+    sd = SelectionDialog.new(data_or_trailer, sender, "Select Access Conditions", opts: DECOR_ALL, height: 320, width: 600)
+    if sd.execute > 0
+      bits = sd.selected_bits
+      bits_field.text = bits
+      bits_changed
+    end
+  end
+
+  class SelectionDialog < FXDialogBox
+    include Fox
+
+    attr_reader :selected_bits
+
+    def initialize(data_or_trailer, *args)
+      super(*args)
+
+      if data_or_trailer == :data_key_b_readable || data_or_trailer == :data_key_b_secret
+        FXLabel.new(self, "Mögliche Bit-Kombinationen für Datenblöcke:")
+
+        FXMatrix.new(self, 7, MATRIX_BY_COLUMNS | LAYOUT_FILL_X, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) do |matrix|
+          DataBitsHead.each do |labeltext|
+            FXLabel.new(matrix, labeltext, nil, LAYOUT_FILL_COLUMN|LAYOUT_FILL_X)
+          end
+
+          DataBitsDesc.sort.each do |bits, (ws_descs, wr_descs, desc)|
+            descs = (data_or_trailer == :data_key_b_readable ? wr_descs : ws_descs) + [desc]
+            field = FXLabel.new(matrix, bits, nil, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X|TEXTFIELD_READONLY){|this| this.backColor = FXColor::LightGoldenrod1 }
+            FXLabel.new(matrix,'->')
+            for desc in descs
+              FXLabel.new(matrix, desc, nil, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X|TEXTFIELD_READONLY) do |this|
+                this.backColor = FXColor::LightGoldenrod1
+                b = bits
+                this.connect(SEL_LEFTBUTTONPRESS) do
+                  @selected_bits = b
+                  self.handle(self, FXSEL(SEL_COMMAND, ID_ACCEPT), nil)
+                end
+              end
+            end
+          end
+        end
+      elsif data_or_trailer == :trailer
+        FXLabel.new(self, "Mögliche Bit-Kombinationen für Trailerblöcke:")
+
+        FXMatrix.new(self, 9, MATRIX_BY_COLUMNS | LAYOUT_FILL_X, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) do |matrix|
+          TrailerBitsHead.each do |labeltext|
+            FXLabel.new(matrix, labeltext, nil, LAYOUT_FILL_COLUMN|LAYOUT_FILL_X)
+          end
+
+          TrailerBitsDesc.each do |bits, descs|
+            field = FXLabel.new(matrix, bits, nil, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X|TEXTFIELD_READONLY){|this| this.backColor = FXColor::PaleGreen }
+            FXLabel.new(matrix,'->')
+            for desc in descs
+              FXLabel.new(matrix, desc, nil, TEXTFIELD_NORMAL|LAYOUT_FILL_COLUMN|LAYOUT_FILL_X|TEXTFIELD_READONLY) do |this|
+                this.backColor = FXColor::PaleGreen
+                b = bits
+                this.connect(SEL_LEFTBUTTONPRESS) do
+                  @selected_bits = b
+                  self.handle(self, FXSEL(SEL_COMMAND, ID_ACCEPT), nil)
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+
+end
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: mifare-access-condition-builder
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+original_platform: ''
+authors:
+- Lars Kanis
+bindir: exe
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDLjCCAhagAwIBAgIBDDANBgkqhkiG9w0BAQsFADA9MQ4wDAYDVQQDDAVrYW5p
+  czEXMBUGCgmSJomT8ixkARkWB2NvbWNhcmQxEjAQBgoJkiaJk/IsZAEZFgJkZTAe
+  Fw0yNDA1MDIxMTAwNDVaFw0yNTA1MDIxMTAwNDVaMD0xDjAMBgNVBAMMBWthbmlz
+  MRcwFQYKCZImiZPyLGQBGRYHY29tY2FyZDESMBAGCgmSJomT8ixkARkWAmRlMIIB
+  IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApop+rNmg35bzRugZ21VMGqI6
+  HGzPLO4VHYncWn/xmgPU/ZMcZdfj6MzIaZJ/czXyt4eHpBk1r8QOV3gBXnRXEjVW
+  9xi+EdVOkTV2/AVFKThcbTAQGiF/bT1n2M+B1GTybRzMg6hyhOJeGPqIhLfJEpxn
+  lJi4+ENAVT4MpqHEAGB8yFoPC0GqiOHQsdHxQV3P3c2OZqG+yJey74QtwA2tLcLn
+  Q53c63+VLGsOjODl1yPn/2ejyq8qWu6ahfTxiIlSar2UbwtaQGBDFdb2CXgEufXT
+  L7oaPxlmj+Q2oLOfOnInd2Oxop59HoJCQPsg8f921J43NCQGA8VHK6paxIRDLQID
+  AQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUvgTdT7fe
+  x17ugO3IOsjEJwW7KP4wDQYJKoZIhvcNAQELBQADggEBAH+LA+CcA9vbbqtuhK4J
+  lG1lQwA+hCKiueQgVsepNbXyDzx6PMC8ap/bFaKSaoUWABBA/bsh3jDNXT/eVZrN
+  lFP8cVGrznSYIBG8D/QQmJKpvDBJgnC4Zk01HkhYlqJC4qCTn9X+/uZNHLPLbAEL
+  xl3P43zyL3GQb1IP9bp0xV6oxwG9FO9Rk8bYDojky/69ylowFI5aODS39v01Siu2
+  FsEjM9tMSNb7lQRywQ/432KXi+8AAPTm+wdGnlt3wLE9w2TTpGUBsNKk+QiytTZO
+  zwbjAdVlRm0pg/vpDzzFmRf1GYVckMm8hpCRt8BP0akAbNyw1snYvZBwgLqxztru
+  bEo=
+  -----END CERTIFICATE-----
+date: 2024-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fxruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.20
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.20
+description: 'Calculate the access condition bytes of sectors of Mifare contactless
+  chip cards '
+email:
+- lars.kanis@sincnovation.com
+executables:
+- mifare_access_condition_builder
+extensions: []
+extra_rdoc_files: []
+files:
+- History.txt
+- README.md
+- Rakefile
+- exe/mifare_access_condition_builder
+- lib/mifare_access_condition_builder.rb
+- lib/mifare_access_condition_builder/version.rb
+- screenshot.png
+homepage: https://github.com/larskanis/mifare-access-condition-builder
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/larskanis/mifare-access-condition-builder
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.0.dev
+specification_version: 4
+summary: Calculate the access condition bytes of sectors of Mifare contactless chip
+  cards
+test_files: []