swICC लाइब्रेरी

प्रोजेक्ट को रिकर्सिवली क्लोन करना आवश्यक है। केवल ZIP डाउनलोड करना पर्याप्त नहीं है।

Software ICC (या swICC) एक फ्रेमवर्क है जो अधिकांश प्रकार के स्मार्ट कार्ड विकसित करने का आसान और लचीला तरीका प्रदान करता है। यह किसी भी swICC-आधारित कार्ड को PC/SC इंटरफ़ेस के माध्यम से PC से जोड़ने की अनुमति देता है (swICC PC/SC रीडर का उपयोग करके), जो स्मार्ट कार्ड को PC से जोड़ने के लिए वास्तविक मानक है।

दायरा

• सॉफ़्टवेयर में स्मार्ट कार्ड विकसित करने के लिए फ्रेमवर्क, बिना किसी हार्डवेयर निर्भरता के।
• कोई भी swICC-आधारित कार्ड swICC PC/SC रीडर का उपयोग करके PC/SC के माध्यम से PC से जुड़ सकता है।
• स्मार्ट कार्ड फ़ाइल सिस्टम को JSON का उपयोग करके परिभाषित किया जा सकता है, उदाहरण ./test/data/disk में मौजूद हैं। FS को .swiccfs फ़ाइल के रूप में डिस्क पर सहेजा जा सकता है, और वापस कार्ड में लोड किया जा सकता है।
• प्रचुर मात्रा में डीबग उपयोगिताएँ।
• इसमें उपयोग में आसान BER-TLV इम्प्लीमेंटेशन शामिल है।

इंस्टॉलेशन

• प्रोजेक्ट को कंपाइल करने के लिए आपको make, cmake, और gcc चाहिए। कोई अतिरिक्त रनटाइम निर्भरता नहीं।

1. sudo apt-get install make cmake gcc
2. git clone --recurse-submodules [email protected]:tomasz-lisowski/swicc.git
3. cd swicc
4. make main-dbg (बिल्डिंग के बारे में अधिक जानकारी के लिए ./doc/install.md देखें)।
5. ./build/libswicc.a से लिंक करें (जैसे -Llib/swicc/build -lswicc) और include पथ में ./include जोड़ें (जैसे -Ilib/swicc/include)।
6. अपने प्रोजेक्ट में सभी हेडर शामिल करने के लिए #include <swicc/swicc.h> जोड़ें।

उपयोग

न्यूनतम स्मार्ट कार्ड बनाने के लिए निम्नलिखित करें:

1. पहले इंस्टॉलेशन निर्देशों का पालन करना सुनिश्चित करें और सुनिश्चित करें कि ./build/libswicc.a मौजूद है।
2. mkdir card
3. cd card
4. ./card डायरेक्टरी के अंदर main.c फ़ाइल में निम्नलिखित कोड कॉपी करें।

#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <swicc/swicc.h>

swicc_net_client_st client_ctx = {0U};

static void sig_exit_handler(__attribute__((unused)) int signum)
{
    fprintf(stderr, "Shutting down...\n");
    swicc_net_client_destroy(&client_ctx);
    fflush(NULL);
    exit(0);
}

int32_t main(int32_t const argc, char const *const argv[const argc])
{
    swicc_disk_st disk = {0U};
    swicc_ret_et ret = swicc_diskjs_disk_create(&disk, "../test/data/disk/006-in.json");
    if (ret == SWICC_RET_SUCCESS)
    {
        swicc_st swicc_ctx = {0U};
        ret = swicc_fs_disk_mount(&swicc_ctx, &disk);
        if (ret == SWICC_RET_SUCCESS)
        {
            ret = swicc_net_client_sig_register(sig_exit_handler);
            if (ret == SWICC_RET_SUCCESS)
            {
                ret =
                    swicc_net_client_create(&client_ctx, "127.0.0.1", "37324");
                if (ret == SWICC_RET_SUCCESS)
                {
                    ret = swicc_net_client(&swicc_ctx, &client_ctx);
                    if (ret != SWICC_RET_SUCCESS)
                    {
                        fprintf(stderr, "Failed to run network client.\n");
                    }
                    swicc_net_client_destroy(&client_ctx);
                }
                else
                {
                    fprintf(stderr, "Failed to create a client.\n");
                }
            }
            else
            {
                fprintf(stderr, "Failed to register signal handler.\n");
            }
            swicc_terminate(&swicc_ctx);
        }
        else
        {
            fprintf(stderr, "Failed to mount disk.\n");
            swicc_disk_unload(&disk);
        }
    }
    else
    {
        fprintf(stderr, "Failed to create disk.\n");
    }

    return 0;
}

5. कार्ड बनाने के लिए gcc main.c -I../include -L../build -lswicc -o card.elf चलाएँ।
6. PC/SC के माध्यम से कार्ड के साथ इंटरैक्ट करने के लिए, आपको एक swICC कार्ड सर्वर शुरू करना होगा, जैसे swICC PC/SC रीडर।
7. ./card.elf जो कार्ड को कार्ड रीडर से जोड़ देगा।
8. pcsc_scan (pcsc-tools पैकेज का हिस्सा) कार्ड के कुछ विवरण दिखाएगा।
9. आप वास्तविक कार्ड की तरह ही PC/SC के माध्यम से कार्ड के साथ इंटरैक्ट करना शुरू कर सकते हैं।

कस्टम कार्ड लागू करने के लिए, नेटवर्क क्लाइंट चलाने से पहले swicc_apduh_pro_register के माध्यम से एक APDU demuxer पंजीकृत करना आवश्यक है, साथ ही APDU हैंडलर भी जो प्राप्त कमांड के आधार पर demuxer द्वारा कॉल किए जाते हैं। फ्रेमवर्क का अधिक उन्नत तरीके से उपयोग करने का एक अच्छा उदाहरण swSIM प्रोजेक्ट है, जो swICC का उपयोग करके एक SIM कार्ड लागू करता है।