2024年6月6日木曜日

RC-S300をpowershellから動かしてみる

 

RC-S300を買ってみたよ。winscard.dllの関数をcallすることで簡単に読み取りとかできる(もちろん読み取れるようにしてあるデータだけ)。が、なぜかpowershellから動かしてみようと思う。

さて、C#から動かしている事例はまぁまぁあるし、PC/SC wrapper classes for .NET(https://www.nuget.org/packages/PCSC/)を使うという手もある。が、あえて、ここは最近マイブームのpowershellを使ってみる。
で、参考サイトはこちらhttps://qiita.com/rhene/items/725dfe4a6b6307731cbfていうかこちらの記事をまるっとpowershellに移植する。powershellにはC#を取り込めるので、APIの宣言とかはそのまま流用する(というかそうする必要がある)。Main部分をpowershellに翻訳していくが、powershellでは記述が難しい部分はdllをインポートする(APIを宣言してある)ためのC#コードに追加して乗り切る。
まずは、定数
nfc_constant.ps1
  1. $nfc_constant_cscode = @'
  2. public const uint SCARD_S_SUCCESS = 0;
  3. public const uint SCARD_E_NO_SERVICE = 0x8010001D;
  4. public const uint SCARD_E_TIMEOUT = 0x8010000A;
  6. public const uint SCARD_SCOPE_USER = 0;
  7. public const uint SCARD_SCOPE_TERMINAL = 1;
  8. public const uint SCARD_SCOPE_SYSTEM = 2;
  10. public const int SCARD_STATE_UNAWARE = 0x0000;
  11. public const int SCARD_STATE_CHANGED = 0x00000002;
  12. public const int SCARD_STATE_PRESENT = 0x00000020;
  13. public const UInt32 SCARD_STATE_EMPTY = 0x00000010;
  14. public const int SCARD_SHARE_SHARED = 0x00000002;
  15. public const int SCARD_SHARE_EXCLUSIVE = 0x00000001;
  16. public const int SCARD_SHARE_DIRECT = 0x00000003;
  18. public const int SCARD_PROTOCOL_T0 = 1;
  19. public const int SCARD_PROTOCOL_T1 = 2;
  20. public const int SCARD_PROTOCOL_RAW = 4;
  22. public const int SCARD_LEAVE_CARD = 0;
  23. public const int SCARD_RESET_CARD = 1;
  24. public const int SCARD_UNPOWER_CARD = 2;
  25. public const int SCARD_EJECT_CARD = 3;
  27. // SCardStatus status values
  28. public const int SCARD_UNKNOWN = 0x00000000;
  29. public const int SCARD_ABSENT = 0x00000001;
  30. public const int SCARD_PRESENT = 0x00000002;
  31. public const int SCARD_SWALLOWED = 0x00000003;
  32. public const int SCARD_POWERED = 0x00000004;
  33. public const int SCARD_NEGOTIABLE = 0x00000005;
  34. public const int SCARD_SPECIFICMODE = 0x00000006;
  35. '@
  37. set-variable -name SCARD_S_SUCCESS -value 0 -option constant
  38. set-variable -name SCARD_E_NO_SERVICE -value 0x8010001D -option constant
  39. set-variable -name SCARD_E_TIMEOUT -value 0x8010000A -option constant
  41. set-variable -name SCARD_SCOPE_USER -value 0 -option constant
  42. set-variable -name SCARD_SCOPE_TERMINAL -value 1 -option constant
  43. set-variable -name SCARD_SCOPE_SYSTEM -value 2 -option constant
  45. set-variable -name SCARD_STATE_UNAWARE -value 0x0000 -option constant
  46. set-variable -name SCARD_STATE_CHANGED -value 0x00000002 -option constant
  47. set-variable -name SCARD_STATE_PRESENT -value 0x00000020 -option constant
  48. set-variable -name SCARD_STATE_EMPTY -value 0x00000010 -option constant
  49. set-variable -name SCARD_SHARE_SHARED -value 0x00000002 -option constant
  50. set-variable -name SCARD_SHARE_EXCLUSIVE -value 0x00000001 -option constant
  51. set-variable -name SCARD_SHARE_DIRECT -value 0x00000003 -option constant
  53. set-variable -name SCARD_PROTOCOL_T0 -value 1 -option constant
  54. set-variable -name SCARD_PROTOCOL_T1 -value 2 -option constant
  55. set-variable -name SCARD_PROTOCOL_RAW -value 4 -option constant
  57. set-variable -name SCARD_LEAVE_CARD -value 0 -option constant
  58. set-variable -name SCARD_RESET_CARD -value 1 -option constant
  59. set-variable -name SCARD_UNPOWER_CARD -value 2 -option constant
  60. set-variable -name SCARD_EJECT_CARD -value 3 -option constant
  62. # SCardStatus status values
  63. set-variable -name SCARD_UNKNOWN -value 0x00000000 -option constant
  64. set-variable -name SCARD_ABSENT -value 0x00000001 -option constant
  65. set-variable -name SCARD_PRESENT -value 0x00000002 -option constant
  66. set-variable -name SCARD_SWALLOWED -value 0x00000003 -option constant
  67. set-variable -name SCARD_POWERED -value 0x00000004 -option constant
  68. set-variable -name SCARD_NEGOTIABLE -value 0x00000005 -option constant
  69. set-variable -name SCARD_SPECIFICMODE -value 0x00000006 -option constant
C#のコードのまま取り込めるのかと思ったけど、うまくいかなかったのでpowershell的な定義を追加。C#記述はそのままそうっとしておく。
次はwinscard.dllを呼び出すためのおまじない。
nfc_pcsc.ps1
  1. $nfc_pcsc_cscode = @'
  3. [DllImport("winscard.dll")]
  4. public static extern uint SCardEstablishContext(uint dwScope, IntPtr pvReserved1, IntPtr pvReserved2, out IntPtr phContext);
  6. [DllImport("winscard.dll", EntryPoint = "SCardListReadersW", CharSet = CharSet.Unicode)]
  7. public static extern uint SCardListReaders(
  8.     IntPtr hContext, byte[] mszGroups, byte[] mszReaders, ref UInt32 pcchReaders);
  10. [DllImport("winscard.dll")]
  11. public static extern uint SCardReleaseContext(IntPtr phContext);
  13. [DllImport("winscard.dll", EntryPoint = "SCardConnectW", CharSet = CharSet.Unicode)]
  14. public static extern uint SCardConnect(IntPtr hContext, string szReader,
  15.         uint dwShareMode, uint dwPreferredProtocols, ref IntPtr phCard,
  16.         ref IntPtr pdwActiveProtocol);
  18. [DllImport("winscard.dll")]
  19. public static extern uint SCardDisconnect(IntPtr hCard, int Disposition);
  21. [StructLayout(LayoutKind.Sequential)]
  22. public class SCARD_IO_REQUEST
  23. {
  24.     internal uint dwProtocol;
  25.     internal int cbPciLength;
  26.     public SCARD_IO_REQUEST()
  27.     {
  28.         dwProtocol = 0;
  29.     }
  30. }
  32. [DllImport("winscard.dll")]
  33. public static extern uint SCardTransmit(IntPtr hCard, IntPtr pioSendRequest, byte[] SendBuff, int SendBuffLen, SCARD_IO_REQUEST pioRecvRequest,
  34.         byte[] RecvBuff, ref int RecvBuffLen);
  36. [DllImport("winscard.dll")]
  37. public static extern uint SCardControl(IntPtr hCard, int controlCode, byte[] inBuffer, int inBufferLen, byte[] outBuffer, int outBufferLen, ref int bytesReturned);
  39. [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
  40. public struct SCARD_READERSTATE
  41. {
  42.     internal string szReader;
  43.     internal IntPtr pvUserData;
  44.     internal UInt32 dwCurrentState;
  45.     internal UInt32 dwEventState;
  46.     internal UInt32 cbAtr;
  47.     [MarshalAs(UnmanagedType.ByValArray, SizeConst = 36)]
  48.     internal byte[] rgbAtr;
  49. }
  51. [DllImport("winscard.dll", EntryPoint = "SCardGetStatusChangeW", CharSet = CharSet.Unicode)]
  52. public static extern uint SCardGetStatusChange(IntPtr hContext, int dwTimeout, [In, Out] SCARD_READERSTATE[] rgReaderStates, int cReaders);
  54. [DllImport("winscard.dll")]
  55. public static extern int SCardStatus(IntPtr hCard, string szReader, ref int cch, ref int state, ref int protocol, ref byte[] bAttr, ref int cByte);
  57. [DllImport("kernel32.dll", SetLastError = true)]
  58. public static extern IntPtr LoadLibrary(string lpFileName);
  60. [DllImport("kernel32.dll")]
  61. public static extern void FreeLibrary(IntPtr handle);
  63. [DllImport("kernel32.dll")]
  64. public static extern IntPtr GetProcAddress(IntPtr handle, string procName);
  66. public static uint MySCardTransmit(
  67.     IntPtr hCard,
  68.     byte[] SendBuff,
  69.     int SendBuffLen,
  70.     int cbPciLength,
  71.     byte[] RecvBuff,
  72.     ref int RecvBuffLen
  73. ){
  74.     uint ret;
  75.     SCARD_IO_REQUEST ioRecv = new SCARD_IO_REQUEST();
  76.     ioRecv.cbPciLength = cbPciLength;
  77.     IntPtr handle = LoadLibrary("Winscard.dll");
  78.     IntPtr pci = GetProcAddress(handle, "g_rgSCardT1Pci");
  79.     FreeLibrary(handle);
  80.     ret = SCardTransmit(hCard, pci, SendBuff, SendBuffLen, ioRecv,RecvBuff, ref RecvBuffLen);
  81.     return ret;
  82. }
  83. '@
MySCardTransmitってのは参考サイトのコードの中でpowershellで表現が難しかった部分をC#側に記述したもの。ここ以外は工夫はない。
で、次は本命のスクリプト
nfc_read.ps1
  1. . ".\nfc_constant.ps1"
  2. . ".\nfc_pcsc.ps1"
  4. #add-type -name nfc_constant -namespace user -memberdefinition $nfc_constant_cscode
  5. add-type -name nfc_pcsc -namespace user -memberdefinition $nfc_pcsc_cscode
  7. $hContext=1
  8. <# #############################
  9. 1. SCardEstablishContext
  10. ############################# #>
  11. write-output "***** 1. SCardEstablishContext *****"
  12. $ret = [user.nfc_pcsc]::SCardEstablishContext($SCARD_SCOPE_USER, 0, 0, [ref]$hContext)
  13. if ($ret -ne $SCARD_S_SUCCESS){
  14.     $msg=$null
  15.     if($ret -eq $SCARD_E_NO_SERVICE){
  16.         $msg="No service found."
  17.     }else{
  18.         $msg="Failed to connect the service. code = " + $ret
  19.     }
  20.     write-output $msg
  21.     exit
  22. }
  23. if($hContext -eq 0){
  24.     write-output "Failed to take the context."
  25.     exit
  26. }
  27. write-output "Connected to the service."
  29. <# #############################
  30. 2. SCardListReaders
  31. ############################# #>
  32. write-output "***** 2. SCardListReaders *****"
  33. $pcchReaders=0
  34. $ret = [user.nfc_pcsc]::SCardListReaders($hContext, $null, $null, [ref]$pcchReaders)
  35. if ($ret -ne $SCARD_S_SUCCESS){
  36.     write-output "Failed to detect reader."
  37.     exit
  38. }
  39. [array]$bszReaders=new-object byte[] ($pcchReaders*2)
  40. $ret = [user.nfc_pcsc]::SCardListReaders($hContext, $null, $bszReaders, [ref]$pcchReaders)
  41. if ($ret -ne $SCARD_S_SUCCESS){
  42.     write-output "Failed to get reader name."
  43.     exit
  44. }
  45. $mszReaders=[System.Text.Encoding]::Unicode.GetString($bszReaders)
  46. $nullindex=$mszReaders.IndexOf("`0`0")
  47. $readerName=$mszReaders.substring(0,$nullindex)
  48. write-output "Reader detected."
  49. write-output $readerName
  51. <# #############################
  52. 3. SCardConnect
  53. ############################# #>
  54. write-output "***** 3. SCardConnect *****"
  55. $hCard=0
  56. $activeProtocol=0
  57. $ret = [user.nfc_pcsc]::SCardConnect($hContext, $readerName, $SCARD_SHARE_SHARED, $SCARD_PROTOCOL_T1, [ref]$hCard, [ref]$activeProtocol);
  58. if ($ret -ne $SCARD_S_SUCCESS){
  59.     write-output "Failed to connect to cards. code = "+$ret
  60.     exit
  61. }
  62. write-output "Connected to a card."
  64. <# #############################
  65. 4. SCardTransmit
  66. ############################# #>
  67. write-output "***** 4. SCardTransmit *****"
  68. $maxRecvDataLen=256
  69. [array]$recvBuffer=new-object byte[] ($maxRecvDataLen+2)
  70. $sendBuffer=@(0xff, 0xca, 0x00, 0x00, 0x00)
  72. $pcbRecvLength=$recvBuffer.Length
  73. $cbSendLength=$sendBuffer.Length
  75. $ret = [user.nfc_pcsc]::MySCardTransmit($hCard, $sendBuffer, $cbSendLength,255, $recvBuffer, [ref]$pcbRecvLength)
  76. if ($ret -ne $SCARD_S_SUCCESS)
  77. {
  78.     write-output "Failed to send to NFC card. code = " + $ret
  79.     exit
  80. }
  81. $szRecv = ([System.Text.Encoding]::ASCII.GetString($recvBuffer)).substring(0,$pcbRecvLength)
  82. write-output "Received data from the card."
  83. write-output $szRecv | Format-Hex
  85. <# #############################
  86. 5. SCardDisconnect
  87. ############################# #>
  88. write-output "***** 5. SCardDisconnect *****"
  89. $ret = [user.nfc_pcsc]::SCardDisconnect($hCard, $SCARD_LEAVE_CARD)
  90. if ($ret -ne $SCARD_S_SUCCESS)
  91. {
  92.     write-output "Failed to disconnect the card. code = " + $ret
  93.     exit
  94. }
  95. write-output "Disconnected the card."
コンソール出力を英文化したのは決してかぶれているからではない。VSCodeの化け回避のためなの(υ´•̥̥̥ ﻌ •̥̥̥`υ)
では、動かしてみる。ちょっと前にPN5180のモジュールを買ったときにおまけでついていたタグを読んでみる。
こんなん。で、
まぁ、うまくいったらしい。

Powershell、、、意外と面白い。コンパイラやインタプリタが不要なのがよい。記述がちょっと呪文系だけど、まぁ言語なんてそんなもん。C#で記述して取り込めることを利用してWindowsAPIをCallできるので、応用できる範囲も広い。こういうので、こまいことをちゃちゃっとやれるような、そんな能力が給料に反映され、みんながデジタル技術の獲得を目指すことで本当のDXがちょっと近づいてくるんじゃないだろうかな、、、って発想は自分で手を動かしている小者にしか湧いてこないよなー。世の中そんなもん。せめてお互い称賛しあえるような雰囲気になってほしい。
at
Labels: ,

1 件のコメント:

  1. 匿名2024年6月11日 7:56

    データの表示が正しくない。
    81~83行目を
    $out_string=""
    for($i=0;$i -lt $pcbRecvLength;$i++){
    $out_string=$out_string + " " + [System.String]::Format("{0:x2}", $recvBuffer[$i])
    }
    write-output $out_string
    って感じで、普通に書くと正しくなる。

    返信削除

登録: コメントの投稿 (Atom)