README.md 2.5 KB

Flipper Seos

Flipper app for reading and emulating Seos-compatible cards/fobs/mobile credentials.

Demo Video

To do:

  • Fix iso14443a-4 framing
  • ASN.1 for serializing/deserializing
  • Support for larger message wrapping/unwrapping
  • CMAC checking where I missed it

Keys

The app uses all 00 keys by default. If you'd like to use your own keys, use the format of the keys-example.txt to specify them, and place into SD Card/apps_data/seos/keys.txt

Hardware for BLE support

  1. Install/setup nordic SDK
  2. Install Toolchain manager
  3. Launch Toolchain manager
  4. Next to SDK version click down arroy and "open terminal"
  5. navigate to samples/bluetooth/hci_uart_3wire

nRF52840

  1. Edit boards/nrf52840dk_nrf52840.overlay and change current-speed to 460800 to match Flipper app.

  2. west build -b nrf52840dk_nrf52840 -p auto

  3. west flash

nRF52840 dongle

  1. Copy boards/nrf52840dongle_nrf52840.overlay to hci_uart_3wire
  2. Might need to: nrfutil install nrf5sdk-tools
  3. west build -b nrf52840dongle_nrf52840 -p auto
  4. nrfutil nrf5sdk-tools pkg generate --hw-version 52 --sd-req=0x00 --application ./build/hci_uart_3wire/zephyr/zephyr.hex --application-version 1 app.zip
  5. Put dongle into DFU by pressing 'reset' button
  6. nrfutil nrf5sdk-tools dfu usb-serial -pkg app.zip -p /dev/cu.usbmodemD39BF26162261

Connection

flipper purpose pin color nRF52840 dk pin nRF52840 dongle pin
rx 16 yellow P0.06 P0.20
tx 15 orange P0.08 P0.24
gnd 11 black any ground GND
power 5v red VIN 3-5v VBUS

Note

This software incorporates a third-party implementation of Seos™ technology. It is not developed, authorized, licensed, or endorsed by HID Global, ASSA ABLOY, or any of their affiliates. References to Seos™ are solely for descriptive and compatibility purposes.

No guarantee of compatibility or functionality is made. This implementation may not work with all Seos™-enabled systems, and its performance, security, and reliability are not assured. Users assume all risks associated with its use.

Seos™, HID Global, and ASSA ABLOY are trademarks or registered trademarks of their respective owners. This software is not associated with or sponsored by them in any way.