|
1 | | -# 📡 RFID-Reader-FX7500 |
2 | | - |
3 | | -Contains the necessary scripts, files, and documentation to use the Zebra FX7500 RFID reader. |
4 | | - |
5 | | -## 📂 Directory Structure |
6 | | - |
7 | | -- **src/**: Contains the source code for the RFID reader and plotting scripts. |
8 | | - - `reader.py`: Script to read data from the RFID reader and write it to a file. |
9 | | - - `plotting.py`: Script to plot the RFID data. |
10 | | - - `__init__.py`: Marks the directory as a Python package. |
11 | | -- **docs/**: Contains the documentation files. |
12 | | - - `01_Regular_Set_Up.md`: Guide for regular setup of the Zebra FX7500 RFID reader. |
13 | | - - `02_Network_Set_Up.md`: Guide for network setup of the Zebra FX7500 RFID reader. |
14 | | -- **results/**: Directory where the RFID data files will be saved. |
15 | | -- **assets/**: Contains images used in the documentation. |
16 | | -- `main.py`: Main script to run the RFID reader. |
17 | | -- `mqtt_set_up.sh`: Script to set up the MQTT broker. |
18 | | -- `plots.ipynb`: Jupyter Notebook for plotting the RFID data. |
19 | | -- `requirements.txt`: External dependencies. |
| 1 | +# 📡 RFID Reader FX7500 |
20 | 2 |
|
21 | | -## 🚀 Getting Started |
| 3 | +This repository contains the code and setup instructions for the Zebra FX7500 RFID Reader. |
| 4 | + |
| 5 | +## 📋 Table of Contents |
| 6 | + |
| 7 | +- [📡 RFID Reader FX7500](#-rfid-reader-fx7500) |
| 8 | + - [📋 Table of Contents](#-table-of-contents) |
| 9 | + - [🛠️ Regular Set Up](#️-regular-set-up) |
| 10 | + - [🌐 Network Set Up](#-network-set-up) |
| 11 | + - [📜 License](#-license) |
| 12 | + - [📂 Project Structure](#-project-structure) |
| 13 | + - [🚀 Getting Started](#-getting-started) |
| 14 | + - [📄 Main Script](#-main-script) |
| 15 | + - [📊 Plots](#-plots) |
| 16 | + |
| 17 | +## 🛠️ Regular Set Up |
| 18 | + |
| 19 | +For the regular setup of the Zebra FX7500 RFID Reader, please refer to the [Regular Set Up Guide](./docs/01_Regular_Set_Up.md). |
| 20 | + |
| 21 | +## 🌐 Network Set Up |
22 | 22 |
|
23 | | -### Prerequisites |
| 23 | +For the network setup of the Zebra FX7500 RFID Reader, please refer to the [Network Set Up Guide](./docs/02_Network_Set_Up.md). |
24 | 24 |
|
25 | | -- Python 3.6 or higher |
26 | | -- MQTT broker (e.g., Mosquitto) |
27 | | -- Zebra FX7500 RFID reader |
| 25 | +## 📜 License |
28 | 26 |
|
29 | | -### Installation |
| 27 | +This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details. |
30 | 28 |
|
31 | | -1. Clone the repository: |
| 29 | +## 📂 Project Structure |
| 30 | + |
| 31 | +``` |
| 32 | +RFID-Reader-FX7500/ |
| 33 | +├── docs/ |
| 34 | +│ ├── 01_Regular_Set_Up.md |
| 35 | +│ └── 02_Network_Set_Up.md |
| 36 | +├── src/ |
| 37 | +│ ├── reader.py |
| 38 | +│ └── plotting.py |
| 39 | +├── main.py |
| 40 | +├── mqtt_set_up.sh |
| 41 | +├── requirements.txt |
| 42 | +├── LICENSE |
| 43 | +└── README.md |
| 44 | +``` |
| 45 | + |
| 46 | +## 🚀 Getting Started |
| 47 | + |
| 48 | +To get started with the Zebra FX7500 RFID Reader, follow these steps: |
| 49 | + |
| 50 | +1. **Clone the repository:** |
32 | 51 |
|
33 | 52 | ```bash |
34 | 53 | git clone https://github.com/yourusername/RFID-Reader-FX7500.git |
35 | 54 | cd RFID-Reader-FX7500 |
36 | 55 | ``` |
37 | 56 |
|
38 | | -2. Install the required Python packages: |
| 57 | +2. **Install the required packages:** |
39 | 58 |
|
40 | 59 | ```bash |
41 | 60 | pip install -r requirements.txt |
42 | 61 | ``` |
43 | 62 |
|
44 | | -### Usage |
45 | | - |
46 | | -1. Set up the MQTT broker: |
| 63 | +3. **Set up the MQTT broker:** |
47 | 64 |
|
48 | 65 | ```bash |
49 | 66 | ./mqtt_set_up.sh |
50 | 67 | ``` |
51 | 68 |
|
52 | | -2. Run the main script: |
| 69 | +4. **Run the main script:** |
53 | 70 |
|
54 | 71 | ```bash |
55 | 72 | python main.py |
56 | 73 | ``` |
57 | 74 |
|
58 | | -3. Plot the data using the Jupyter Notebook: |
59 | | - |
60 | | - ```bash |
61 | | - jupyter notebook plots.ipynb |
62 | | - ``` |
63 | | - |
64 | | -## 📄 Documentation |
65 | | - |
66 | | -- [Regular Set Up](./docs/01_Regular_Set_Up.md) |
67 | | -- [Network Set Up](./docs/02_Network_Set_Up.md) |
| 75 | +## 📄 Main Script |
68 | 76 |
|
69 | | -## 📊 Examples |
| 77 | +The main script is located at [main.py](./main.py). It includes the main flow of the program, imports necessary modules, and defines the main function. |
70 | 78 |
|
71 | | -### Plotting Data |
| 79 | +## 📊 Plots |
72 | 80 |
|
73 | | -To plot the RFID data, use the `plotting.py` script. For example: |
| 81 | +The plots are generated using the data from the RFID reader. The plotting script is located at [src/plotting.py](./src/plotting.py). |
74 | 82 |
|
75 | | -```python |
76 | | -import src.plotting as plt |
77 | | - |
78 | | -filename = './results/test.csv' |
79 | | -plt.plot_data(filename) |
80 | | -``` |
| 83 | +For more details, refer to the [plots.ipynb](./plots.ipynb) notebook. |
0 commit comments