Skip to content

Commit e0fa5f2

Browse files
committed
docs: finalized readme file for first version
1 parent 27ea4e0 commit e0fa5f2

1 file changed

Lines changed: 53 additions & 50 deletions

File tree

README.md

Lines changed: 53 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,80 +1,83 @@
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
202

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
2222

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).
2424

25-
- Python 3.6 or higher
26-
- MQTT broker (e.g., Mosquitto)
27-
- Zebra FX7500 RFID reader
25+
## 📜 License
2826

29-
### Installation
27+
This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.
3028

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:**
3251

3352
```bash
3453
git clone https://github.com/yourusername/RFID-Reader-FX7500.git
3554
cd RFID-Reader-FX7500
3655
```
3756

38-
2. Install the required Python packages:
57+
2. **Install the required packages:**
3958

4059
```bash
4160
pip install -r requirements.txt
4261
```
4362

44-
### Usage
45-
46-
1. Set up the MQTT broker:
63+
3. **Set up the MQTT broker:**
4764

4865
```bash
4966
./mqtt_set_up.sh
5067
```
5168

52-
2. Run the main script:
69+
4. **Run the main script:**
5370

5471
```bash
5572
python main.py
5673
```
5774

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
6876

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.
7078

71-
### Plotting Data
79+
## 📊 Plots
7280

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).
7482

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

Comments
 (0)