Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
HOWTO: Install 02Micro OZ711EC1 Smartcard Reader Driver
View unanswered posts
View posts from last 24 hours

 
Reply to topic    Gentoo Forums Forum Index Documentation, Tips & Tricks
View previous topic :: View next topic  
Author Message
forgotten1
Guru
Guru


Joined: 11 Jan 2005
Posts: 477
Location: East Coast, USA

PostPosted: Thu Jul 20, 2006 6:58 pm    Post subject: HOWTO: Install 02Micro OZ711EC1 Smartcard Reader Driver Reply with quote

HOWTO: Install 02Micro OZ711EC1 Smartcard Reader Driver

I wrote:
"Sharing to benefit others as their sharing has benefited me."


CHANGE LOG:
Code:
20070212 - Added notice regarding bad source code link, and consequent negative impact to ebuild.
20060807 - Added missing kernel compilation step.
20060728 - gentoo-sources 2.6.17-r4 marked stable.  Removed instructions for installing testing version.
         - The ebuild contains the correct address for the driver, removed link and related instructions.
         - Reboot not necessary, simply restart pcscd.  Instructions changed.
20060726 - New ebuild tested successfully.  Warning removed.
         - Removed udev rule creation, corrected in ebuild.
         - Added HOWTOs to References section at page bottom.
20060725 - The ebuild previously used, has been removed.  The link has been updated.
         - Added printable links where appropriate.
         - Added additional reference (Additional HOWTO).
20060721 - Added note to testing step, to point out necessary option to use if using gpg
20060720 - Original posting.


NOTICE: This HOWTO is based on source code that can no longer be found on www.musclecard.com. The ebuild consequently is no longer useful. Eric Piel has been reworking the code, but I am not sure where he is at. I am not in contact with him. I do have three versions of the original source code, and would be happy to share it with those that wish to take a crack at producing a newer production ready driver. If you message me with your email address, I will forward it on to you. It has been my desire for quite some time to learn to build a kernel module, and this may be just the excuse to get me started.

NOTICE: This HOWTO has been tested on a Dell Inspiron 600m. Other laptops are known to have this reader installed, and although I cannot guarantee this will work on them, it should. As always, the user of this information is responsible for any outcome experienced.

SUPPORT: As a reminder, this is not a support forum. If you have any difficulties with this HOWTO and require extra help, PM me.

CONTINUAL IMPROVEMENT: I will accept any constructive criticism that will improve this document. Please PM me with your suggestions.

SUMMARY: This uses one package that is marked "testing." The package marked testing is pcsc-lite-1.3.1-r1. Pcmciautils is used instead of the deprecated pcmcia-cs package. A third party ebuild is used, we will therefore be using an overlay. This ebuild is not maintained yet, but there is a bug in bugzilla for it. Hotplug is also used.

Lets Get To It:

  1. Install gentoo-sources This HOWTO requires stable gentoo sources 2.6.17-r4 (or above). This step may be omitted if already installed.

    Code:
    USE="symlink" emerge gentoo-sources


  2. Configure kernel.

    Code:
    cd /usr/src/linux
    make menuconfig


    This is the minimal configuration necessary. I cannot remember where I learned ISA and PCI Hotplug are necessary, but they are. If I find that post again, I will include it in the references below.

    Code:
    Bus options (PCI, PCMCIA, EISA, MCA, ISA)  -->
    --- PCI support
          PCI access mode (Any)  -->
    [ ]   PCI Express support
    [*] ISA support
    [ ]   EISA support
    [ ] MCA support
    < > NatSemi SCx200 support
        PCCARD (PCMCIA/CardBus) support  -->
          <*> PCCard (PCMCIA/CardBus) support
          [ ]   Enable PCCARD debugging
          <*>   16-bit PCMCIA
          [ ]     Load CIS updates from userspace (EXPERIMENTAL)
          [ ]     PCMCIA control ioctl (obsolete)
          ---   32-bit CardBus support
          ---   PC-card bridges
          <*>   CardBus yenta-compatible bridge support
          < >   Cirrus PD6729 compatible bridge support
          < >   i82092 compatible bridge support
          < >   i82365 compatible bridge support
          < >   Databook TCIC host bridge support
        PCI Hotplug Support
          <*> Support for PCI Hotplug (EXPERIMENTAL)
          < >   Fake PCI Hotplug driver
          < >   Compaq PCI Hotplug driver
          < >   ACPI PCI Hotplug driver
          [ ]   CompactPCI Hotplug drikver
          < >   SHPC PCI Hotplug driver


  3. Compile kernel

    Code:
    make && make modules_install


  4. Copy new kernel to /boot

    Code:
    mount /boot
    cp arch/i386/boot/bzImage /boot/<kernel version>


  5. Modify grub.conf and add the following:

    Code:
    title=Gentoo Linux <kernel version>
    root (hd0,0)
    kernel /boot/<kernel version> root=/dev/hda3


  6. Install pcmciautils. The pcmcia-cs package is deprecated. You may already have performed this step.

    Code:
    emerge pcmciautils


  7. Install pcsc-lite. This package is marked "testing." I could not get the driver to work with the "stable" version. The driver does work with versions 1.3.0 through 1.3.1-r1. This HOWTO uses 1.3.1-r1.

    Code:
    echo '=sys-apps/pcsc-lite-1.3.1-r1' >> /etc/portage/package.keywords
    emerge pcsc-lite
    rc-update add pcscd boot


  8. Install hotplug. Don't forget to add it to the battery runlevel if you have one. You may have already performed this during your install.

    Code:
    emerge hotplug
    rc-update add hotplug default <battery>


  9. Prepare the overlay. We create the overlay, and the category at the same time. I've selected app-laptop, but you can use another category if you so choose.

    Code:
    mkdir -p /usr/local/portage/app-laptop
    echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf


  10. Download the packed unmaintained third party ebuild from this link:

    (https://bugs.gentoo.org/attachment.cgi?id=92703)

  11. Move the ebuild to the overlay and unpack it.

    Code:
    mv <path to downloaded file>/pcsc-o2micro-ozscr-drv.tgz /usr/local/portage/app-laptop/
    cd /usr/local/portage/app-laptop
    tar xvf pcsc-o2micro-ozscr-drv.tgz


  12. Install the ozscrlx driver. If you are using coldplug, you can safely ignore the second command.

    Code:
    emerge pcsc-o2micro-ozscr-drv
    echo ozscrlx >> /etc/modules.autoload.d/kernel-2.6


  13. Test it.

    Code:
    /etc/init.d/pcscd restart
    lspcmcia (you should see an entry for the device)


    If you happen to have one of those OpenPGP smartcards (http://www.g10code.com/p-card.html) or FSF Fellowship smartcards (https://www.fsfe.org/en/fsfeuser/register), you can test it with gnupg:

    Code:
    gpg --card-status



NOTE: If you are going to use gpg with the OpenPGP card, you must set the --disable-ccid option when running the command, or add this to your .bashrc:
Code:
alias gpg="gpg --disable-ccid"

If you do not do that, you will get errors similar to this when attempting to generate keys:
Code:
gpg: apdu_send_simple(0) failed: unknown status error
gpg: generating key failed
gpg: key generation failed: general error
Key generation failed: general error
gpg: apdu_send_simple(0) failed: unknown status error
gpg: failed to set `CHV-STATUS-1': general error
gpg: error setting forced signature PIN flag: general error


Good luck. Remember, if you have troubles, PM me, this isn't a support forum. And I welcome any suggestions for improvement of this HOWTO. Hopefully this HOWTO will become obsolescent fast.

References / HOWTOs:
Bugzilla Bug 113562 (https://bugs.gentoo.org/show_bug.cgi?id=113562)
Re: [Muscle] Re: O2MICRO Smartcardbus reader "Open Port F10000 failed" (http://archives.neohapsis.com/archives/dev/muscle/current/0003.html)
MuscleCard Card Reader Drivers (http://www.musclecard.com/sourcedrivers.html)
How to use the Fellowship Smartcard (http://www.gnupg.org/howtos/card-howto/en/smartcard-howto-single.html)
HOWTO: Gnupg / OpenPGP Smartcard / Dual OS (https://forums.gentoo.org/viewtopic-t-483698.html)
_________________
Return the Favor | Problem fixed? Add [Solved] to your title | Google the Forums


Last edited by forgotten1 on Mon Feb 12, 2007 12:55 pm; edited 1 time in total
Back to top
View user's profile Send private message
rmh3093
Advocate
Advocate


Joined: 06 Aug 2003
Posts: 2138
Location: Albany, NY

PostPosted: Sat Nov 18, 2006 10:21 pm    Post subject: Reply with quote

i tried using this e-build and applying the patches manually and they both fail
_________________
Do not meddle in the affairs of wizards, for they are subtle and quick to anger.
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Documentation, Tips & Tricks All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum