/
README.txt
112 lines (98 loc) · 4.61 KB
/
README.txt
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
################################################################################
# MODROOSTER README #
################################################################################
The ModRooster impact tester was designed by Tufts University ME-43 students
Daniel McGinn, Olivia Montgomery, Shea Nelson, Jacob Siegelbaum, and Hans
Tercek under the supervision of Professor Natasha Wright for ReMaterials,
Ahmedabad, India, during the fall of 2017.
Note: vim and nano are installed on the Raspberry Pi to ease file
modification. To edit a file:
vim <filename>
or
nano <filename>
################################################################################
# HOW TO RUN #
################################################################################
LOCAL ACCESS:
Login credentials:
username: user
password: rematerials
Note: Password will not display as it is being typed in. Hit 'enter'
once password entry is completed.
REMOTE ACCESS:
To execute, user should make sure they are SSH'ed into the Raspberry Pi
Note: SSH is a standard method of connecting to devices that are on the same
WiFi network. To SSH, make sure you are connected to the following
network:
WiFi Network: 'ReMaterials'
Password: 'rematerials'
Security: WPA2
Note: Not all consoles have built-in SSH functionality:
macOS: 'Terminal' app has built-in functionality.
Linux: 'Console' app has built-in functionality.
Windows: 'Putty' SSH client is a popular method of SSHing in Windows.
It can be found for free online. Follow online instructions
to set-up.
To SSH, complete the following commands:
ssh user@rematerials.local
password: rematerials
SSH Details (for reference):
Username: 'user@rematerials.local'
Password: 'rematerials'
PROGRAM EXECUTION:
From console, execute the following command from the home directory. No
directory navigation should be necessary:
./runTestTimed.py <iterations>
Note: <iterations> is the desired number of tests to be run. If no value
s specified, the script will use the fallback base number of tests.
Input will be verified before progressing with the testing.
################################################################################
# INCLUDED FILES #
################################################################################
Navigate to Desktop directory to find ('cd ~/Desktop' when SSH'ed into Pi)
runTestTimed.py
Runs the impact tester with a timing and limit switch condition. If the
upper switches are not depressed, once the lift time is met, the next
test will be run automatically.
**** This is the PREFERRED method to be run.
runTestNoTimer.py
Runs the impact tester without a timing condition. There is NO fallback
timed loop for lifting the weight. Only use this if it is guaranteed the
mass will depress the upper limit switches consistently and without fail.
**** Failure to properly configure upper limits can result in COMPLETE
SYSTEM FAILURE.
droptests.txt
Logs the tests completely run by the ModRooster. This file can be later
accessed should tests be terminated prematurely and it is unclear how
many tests were fully executed.
################################################################################
# HOW IT WORKS #
# (runTestTimed.py) #
################################################################################
The program features four primary steps to run the tester (as referenced as
sections within the script):
1. INITIALIZATION
2. SPI READ
3. RUNPROG
4. TEST SETUP
1. INITIALIZATION
Test variables and Raspberry Pi pins can be specified by editing the
script itself. Additionally, a debug feature can be enabled to ease
troubleshooting.
2. SPI READ
This is not currently implemented (as of Fall 2017), but can be later
integrated to allow for SPI data reading. Note: an analog to digital
converter will probably need to be added.
3. RUNPROG
This runs the tester. The motor and clutch are run in parallel, turned
on when a 'True' value is sent to the relay pin, and are off by default.
This loop runs until the desired number of tests are reached. It can be
broken into the following substeps:
a. Setup Raspberry Pi pinout based on pins specified in '1. Base setup'
b. Engages clutch and motor
c. Waits until lift time has elapsed or until an upper limit switch is
hit.
d. If c. is completed, logs completed test to logfile and continues with
testing.
4. TEST SETUP
Reads user input to configure and verify number of tests to be run.