bool eeprom_test(void) {
/* Set up I2C access to the EEPROM. */
eeprom_i2c_setup();
/* Get the current write protection flag state. */
bool write_protection = BP_EE_WP;
/* Enable writing to the EEPROM. */
BP_EE_WP = LOW;
/* Write 0xFF (the default value) to offset 0. */
eeprom_write_byte(0xFF, 0);
bp_delay_ms(I2C_WRITE_DELAY_TIME);
/* Write 0x10 to offset 0. */
eeprom_write_byte(0x10, 0);
bp_delay_ms(I2C_WRITE_DELAY_TIME);
/* Checks if writing 0x10 actually succeeded. */
bool result = (eeprom_read_byte(0) == 0x10);
/* Set offset 0 to the appropriate value. */
eeprom_write_byte(0xFF, 0);
/* Restore the old write protection flag state. */
BP_EE_WP = write_protection;
return result;
}
uint8_t perform_selftest(bool show_progress, bool jumper_test) {
errors = 0;
if (!show_progress) {
bus_pirate_configuration.quiet = true;
}
/* Alert the user to perform the required manual operations if needed. */
if (show_progress && jumper_test) {
/* Print alert. */
BPMSG1163;
BPMSG1251;
/* Wait for a character to come in. */
user_serial_read_byte();
}
/* Start the test procedure. */
BPMSG1164;
/* Check whether AUX0 goes HIGH when requested. */
BP_AUX0 = HIGH;
BP_AUX0_DIR = OUTPUT;
BPMSG1165;
check_result(BP_AUX0, HIGH);
BP_AUX0 = LOW;
BP_AUX0_DIR = INPUT;
/* Check whether the LED line goes HIGH when requested. */
BP_LEDMODE = HIGH;
BP_LEDMODE_DIR = OUTPUT;
BPMSG1166;
check_result(BP_LEDMODE, HIGH);
BP_LEDMODE = LOW;
/* Check whether the pull-up line goes HIGH when requested. */
BP_PULLUP_ON();
BPMSG1167;
check_result(BP_PULLUP, HIGH);
/* Check whether the pull-up line goes LOW when requested. */
BP_PULLUP_OFF();
BPMSG1168;
check_result(BP_PULLUP, LOW);
/* Check whether the regulated voltage line goes HIGH when requested. */
BP_VREG_ON();
bp_delay_ms(PWR_STATE_TEST_DELAY);
BPMSG1169;
check_result(BP_VREGEN, HIGH);
#ifdef BUSPIRATEV4
/* Test the internal EEPROM. */
BPMSG1265;
/* Check the I2C flash clock line. */
BPMSG1266;
check_result(BP_EE_SCL, HIGH);
/* Check the I2C flash data line. */
BPMSG1267;
check_result(BP_EE_SDA, HIGH);
/* Check the I2C flash WRITE PROTECT line. */
BPMSG1268;
check_result(BP_EE_WP, HIGH);
/* Performs a more complete EEPROM test. */
BPMSG1269;
check_result(eeprom_test(), true);
#endif /* BUSPIRATEV4 */
/* ADC check. */
BPMSG1170;
/* Turn ADC on. */
ADCON();
#ifdef BUSPIRATEV4
/* Check whether the voltage coming in from the USB port is within range. */
BPMSG1270;
perform_adc_test(BP_ADC_USB, V5L, V5H);
#endif /* BUSPIRATEV4 */
/* Check whether the +5v rail output is within range. */
BPMSG1171;
perform_adc_test(BP_ADC_5V0, V5L, V5H);
#ifdef BUSPIRATEV4
/* Test the +5v pull-up line. */
BP_5VPU_ON();
BPMSG1171;
bpSP;
BPMSG1172;
bp_delay_ms(PWR_STATE_TEST_DELAY);
perform_adc_test(BP_ADC_VPU, V5L, V5H);
BP_5VPU_OFF();
if (jumper_test) {
/*
* Check whether the +3.3v rail output is within range when measured from
* outside the board circuitry, once a jumper wire is manually placed
* between the +3.3v rail pin and the ADC input pin.
*/
BPMSG1174;
perform_adc_test(BP_ADC_PROBE, V33L, V33H);
}
/*
* Check whether the +3.3v rail output is within range when measured from
* inside the board circuitry.
*/
BPMSG1173;
perform_adc_test(BP_ADC_3V3, V33L, V33H);
/* Test the +3.3v pull-up line. */
BP_3V3PU_ON();
BPMSG1173;
bpSP;
BPMSG1172;
bp_delay_ms(PWR_STATE_TEST_DELAY);
perform_adc_test(BP_ADC_VPU, V33L, V33H);
BP_3V3PU_OFF();
#elif defined(BUSPIRATEV3)
if (jumper_test) {
/*
* Check whether the +5v pull-up output is within range when measured from
* outside the board circuitry, once a jumper wire is manually placed
* between the +5v pull-up pin and the ADC input pin.
*/
BPMSG1172;
perform_adc_test(BP_ADC_VPU, V5L, V5H);
}
/* Check whether the +3.3v rail output is within range. */
BPMSG1173;
perform_adc_test(BP_ADC_3V3, V33L, V33H);
if (jumper_test) {
/*
* Check whether the +3.3v rail output is within range when measured from
* outside the board circuitry, once a jumper wire is manually placed
* between the +3.3v rail pin and the ADC input pin.
*/
BPMSG1174;
perform_adc_test(BP_ADC_PROBE, V33L, V33H);
}
#endif /* BUSPIRATEV4 || BUSPIRATEV3 */
/* Turn ADC off. */
ADCOFF();
/*
* Pull all I/O pins HIGH with pull-ups deactivated, and check the pins
* state afterwards.
*/
BPMSG1175;
IODIR &= ~ALLIO;
IOLAT |= ALLIO;
bp_delay_ms(PIN_STATE_TEST_DELAY);
perform_pins_state_test(HIGH);
/*
* Pull all I/O pins LOW with pull-ups active and check the pins state
* afterwards.
*/
BPMSG1176;
IOLAT &= ~ALLIO;
if (jumper_test) {
#ifdef BUSPIRATEV4
BP_3V3PU_ON();
#endif /* BUSPIRATEV4 */
BP_PULLUP_ON();
}
bp_delay_ms(PIN_STATE_TEST_DELAY);
perform_pins_state_test(LOW);
if (jumper_test) {
/*
* Pull all I/O pins HIGH with pull-ups active and check the pins state
* afterwards.
*/
/* TODO: should this be done without jumpers too? */
BPMSG1177;
IODIR |= ALLIO;
bp_delay_ms(PIN_STATE_TEST_DELAY);
perform_pins_state_test(HIGH);
#ifdef BUSPIRATEV4
BP_3V3PU_OFF();
#endif /* BUSPIRATEV4 */
}
if (show_progress && jumper_test) {
/*
* Alert the user to check the LED on/off states, and prompt for a key
* to be pressed to continue.
*/
BP_VREG_ON();
BP_MODELED_ON();
#ifdef BUSPIRATEV4
BP_USBLED_ON();
#endif /* BUSPIRATEV4 */
BPMSG1178;
MSG_ANY_KEY_TO_EXIT_PROMPT;
user_serial_read_byte();
#ifdef BUSPIRATEV4
BP_USBLED_OFF();
#endif /* BUSPIRATEV4 */
BP_MODELED_OFF();
BP_VREG_OFF();
}
bp_reset_board_state();
BPMSG1179;
bp_write_dec_byte(errors);
BPMSG1180;
bus_pirate_configuration.quiet = false;
return errors;
}