aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: a31e3158ff788be6c01059c3d89518a4821754cd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
<!---
Copyright 2019 Robin Krahl <robin.krahl@ireas.org>
SPDX-License-Identifier: CC0-1.0
-->

# ntw

`ntw` is an experimental firmware for the Nitrokey Pro.  It is in very early
development and supports:

- connecting as a USB device with the Nitrokey Pro’s product and vendor ID
- connecting as a HID class device
- using these Nitrokey commands:
  - `GET_STATUS`
  - `READ_SLOT_NAME`

## Resources

### Development Setup

- NUCLEO-F103RB: [data sheet][NUCLEO-F103RB-ds]
- XNUCLEO-F103RB: [Waveshare wiki][XNUCLEO-F103RB-wiki]
- STM32F103RB: [data sheet][STM32F103RB-ds], [reference manual][STM32F103RB-rm]

[NUCLEO-F103RB-ds]: https://www.st.com/resource/en/data_brief/nucleo-f103rb.pdf
[XNUCLEO-F103RB-wiki]: https://www.waveshare.com/wiki/XNUCLEO-F103RB
[STM32F103RB-ds]: https://www.st.com/resource/en/datasheet/stm32f103rb.pdf
[STM32F103RB-rm]: https://www.st.com/content/ccc/resource/technical/document/reference_manual/59/b9/ba/7f/11/af/43/d5/CD00171190.pdf/files/CD00171190.pdf/jcr:content/translations/en.CD00171190.pdf

### Protocols

- [Universal Serial Bus Specification][usb], Revision 1.1
- [Universal Serial Bus: Device Class Definition for Human Interface Devices
  (HID)][hid], Firmware Specification, Version 1.11

[usb]: http://esd.cs.ucr.edu/webres/usb11.pdf
[hid]: https://www.usb.org/sites/default/files/documents/hid1_11.pdf

## Contact

For bug reports, patches, feature requests or other messages, please send a
mail to [ntw-dev@ireas.org][].

## License

This project is licensed under the [GNU General Public License version 3][GPL]
or later.  The documentation and configuration files contained in this
repository are licensed under the [Creative Commons Zero][CC0] license.  You
can find a copy of the license texts in the `LICENSES` directory.

`ntw` complies with [version 2.0 of the REUSE practices][reuse].

[ntw-dev@ireas.org]: mailto:ntw-dev@ireas.org
[GPL]: https://www.gnu.org/licenses/gpl-3.0.en.html
[CC0]: https://creativecommons.org/publicdomain/zero/1.0/
[reuse]: https://reuse.software/practices/2.0/