Paul Russell / Mbed 2 deprecated FOTA4

This is a modified "BLE_Default_App". It doesn't use retargetStdout() which allows it to work with online Libs available on 20150123 (nRF51822, BLE_API)

Dependencies:   BLE_API mbed nRF51822

App for FOTA testing:

  • IO:
    • Blinks a LED on platform to show App alive
    • LEDs also follow buttons to show immediate response.
    • BLE UART has ping message, and also echos back any received bytes (Use with Android App: nRF UART 2.0).
  • It compiles and runs as FOTA and non-FOTA platform which may assist debugging
    • platform "Nordic nRF51822 FOTA" for FOTA Loading
    • platform "Nordic nRF51822" for mbed drive loading
  • Supports mbed and non-mbed PCBs (all compiled using platform "Nordic nRF51822 FOTA")
  • Compile options available for:
    • nRF51822-mkit (Includes USB Serial Debug)
    • nRF51822-EK
    • nRF51822-Beacon (nRFBeacon)
    • Atomwear (Button and LED on main PCB only)
    • *If anyone gets this working with other publicly available PCBs let me know and we can add it in

main.cpp@5:ac98ff227ad7, 2015-01-30 (annotated)

Committer:
prussell
Date:
Fri Jan 30 10:45:47 2015 +0000
Revision:
5:ac98ff227ad7
Parent:
4:3a065a4e3ca6
Child:
6:85f68f27170c
FOTA bug Fixed (Thanks Wayne!)

; Atomwear Button & LEDs Tested OK

Who changed what in which revision?

UserRevisionLine numberNew contents of line
prussell 3:3651f1a58d9e 1 //To load over FOTA set platform to "Nordic nRF51822 FOTA" and use DFU feature of App "nRF Master Control Panel" (Hex file <100K)
prussell 4:3a065a4e3ca6 2 //To use normal mbed loading set platform to "Nordic nRF51822" and copy to mbed drive (Hex File >250KB)
prussell 3:3651f1a58d9e 3
prussell 0:aa7314f3fa84 4 /* mbed Microcontroller Library
prussell 4:3a065a4e3ca6 5 * Copyright (c) 2006-2015 Paul Russell
prussell 0:aa7314f3fa84 6 *
prussell 0:aa7314f3fa84 7 * Licensed under the Apache License, Version 2.0 (the "License");
prussell 0:aa7314f3fa84 8 * you may not use this file except in compliance with the License.
prussell 0:aa7314f3fa84 9 * You may obtain a copy of the License at
prussell 0:aa7314f3fa84 10 *
prussell 0:aa7314f3fa84 11 * http://www.apache.org/licenses/LICENSE-2.0
prussell 0:aa7314f3fa84 12 *
prussell 0:aa7314f3fa84 13 * Unless required by applicable law or agreed to in writing, software
prussell 0:aa7314f3fa84 14 * distributed under the License is distributed on an "AS IS" BASIS,
prussell 0:aa7314f3fa84 15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
prussell 0:aa7314f3fa84 16 * See the License for the specific language governing permissions and
prussell 0:aa7314f3fa84 17 * limitations under the License.
prussell 0:aa7314f3fa84 18 */
prussell 0:aa7314f3fa84 19
prussell 3:3651f1a58d9e 20 //==============================
prussell 3:3651f1a58d9e 21 // Build Options for D_PCB
prussell 4:3a065a4e3ca6 22 #define D_MKIT 1 // nRF51822-mkit
prussell 4:3a065a4e3ca6 23 #define D_EK 2 // nRF51822-EK
prussell 4:3a065a4e3ca6 24 #define D_BEACON 3 // nRF51822-Beacon
prussell 4:3a065a4e3ca6 25 #define D_ATOMWEAR 4 // Atomwear
prussell 3:3651f1a58d9e 26 //==============================
prussell 3:3651f1a58d9e 27 // Compile Options:
prussell 5:ac98ff227ad7 28 #define D_BLE_UART 1 // Include BLE UART functionality?
prussell 5:ac98ff227ad7 29 #define D_PING_SEC 1 // Ping Rate in Seconds
prussell 4:3a065a4e3ca6 30
prussell 4:3a065a4e3ca6 31 #define D_PCB D_MKIT // Select target PCB
prussell 4:3a065a4e3ca6 32 //#define D_PCB D_EK // Select target PCB
prussell 4:3a065a4e3ca6 33 //#define D_PCB D_BEACON // Select target PCB
prussell 4:3a065a4e3ca6 34 //#define D_PCB D_ATOMWEAR // Select target PCB
prussell 3:3651f1a58d9e 35
prussell 3:3651f1a58d9e 36 //==============================
prussell 0:aa7314f3fa84 37 #include "mbed.h"
prussell 0:aa7314f3fa84 38 #include "BLEDevice.h"
prussell 0:aa7314f3fa84 39
prussell 3:3651f1a58d9e 40 //============================== Process PCB Options:
prussell 3:3651f1a58d9e 41 #if D_PCB==D_MKIT
prussell 5:ac98ff227ad7 42 const char *pcDeviceName = "FOTA4r5m";
prussell 4:3a065a4e3ca6 43 const char *pcPingBLE = "m4\n"; // May need "\n" to push BLE Tx
prussell 4:3a065a4e3ca6 44 const char *pcPingUART = "u4\n";
prussell 4:3a065a4e3ca6 45
prussell 4:3a065a4e3ca6 46 #define DEBUG(...) { printf(__VA_ARGS__); } //UART: p0.08~p0.11, Debug OK over USB Serial
prussell 4:3a065a4e3ca6 47 DigitalIn bB1in(BUTTON1); //p0.16 =Button1
prussell 4:3a065a4e3ca6 48 DigitalIn bB2in(BUTTON2); //p0.17 =Button2
prussell 4:3a065a4e3ca6 49 InterruptIn B1int(BUTTON1); //p0.16 =Button1
prussell 4:3a065a4e3ca6 50 InterruptIn B2int(BUTTON2); //p0.17 =Button2
prussell 4:3a065a4e3ca6 51 DigitalOut bL1out(LED1); //p0.18 =LED1
prussell 4:3a065a4e3ca6 52 DigitalOut bL2out(LED2); //p0.19 =LED2
prussell 4:3a065a4e3ca6 53 //PwmOut fL1pwm(LED1); float fL1level = 0.1;//p0.18 =LED1, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 54 //PwmOut fL2pwm(LED2); float fL2level = 0.1;//p0.19 =LED2, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 55 //AnalogIn adcA(p1); //p0.01 =AIN2
prussell 4:3a065a4e3ca6 56 //AnalogIn adcB(p2); //p0.02 =AIN3
prussell 4:3a065a4e3ca6 57
prussell 4:3a065a4e3ca6 58 #define D_0_LED_TICKER { bL1out=((uTicker1++)&0x01);} // LED Follows Ticker (May also follow a button)
prussell 4:3a065a4e3ca6 59 #define D_1_LED_BUTTON { bL1out = !bB1in;} // LED Follows !Button
prussell 4:3a065a4e3ca6 60 #define D_2_LED_BUTTON { bL2out = !bB2in;} // LED Follows !Button
prussell 4:3a065a4e3ca6 61 #define D_OPERATION_LED "mkit: LED1=Ticker+Button1, LED2=Button2"
prussell 4:3a065a4e3ca6 62
prussell 3:3651f1a58d9e 63 #elif D_PCB==D_EK
prussell 5:ac98ff227ad7 64 const char *pcDeviceName = "FOTA4r5e";
prussell 4:3a065a4e3ca6 65 const char *pcPingBLE = "e4\n"; // May need "\n" to push BLE Tx
prussell 4:3a065a4e3ca6 66
prussell 4:3a065a4e3ca6 67 #define DEBUG(...) {} //Serial Debug not connected
prussell 4:3a065a4e3ca6 68 DigitalIn bB1in(BUTTON1); //p0.16 =Button0
prussell 4:3a065a4e3ca6 69 DigitalIn bB2in(BUTTON2); //p0.17 =Button1
prussell 4:3a065a4e3ca6 70 InterruptIn B1int(BUTTON1); //p0.16 =Button0
prussell 4:3a065a4e3ca6 71 InterruptIn B2int(BUTTON2); //p0.17 =Button1
prussell 4:3a065a4e3ca6 72 DigitalOut bL1out(LED1); //p0.18 =LED0
prussell 4:3a065a4e3ca6 73 DigitalOut bL2out(LED2); //p0.19 =LED1
prussell 4:3a065a4e3ca6 74 //PwmOut fL1pwm(LED1); float fL1level = 0.1;//p0.18 =LED0, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 75 //PwmOut fL2pwm(LED2); float fL2level = 0.1;//p0.19 =LED1, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 76 //AnalogIn adcA(p1); //p0.01 =AIN2
prussell 4:3a065a4e3ca6 77 //AnalogIn adcB(p2); //p0.02 =AIN3
prussell 4:3a065a4e3ca6 78
prussell 4:3a065a4e3ca6 79 #define D_0_LED_TICKER { bL1out=((uTicker1++)&0x01);} // LED Follows Ticker (May also follow a button)
prussell 4:3a065a4e3ca6 80 #define D_1_LED_BUTTON { bL1out = !bB1in;} // LED Follows !Button
prussell 4:3a065a4e3ca6 81 #define D_2_LED_BUTTON { bL2out = !bB2in;} // LED Follows !Button
prussell 4:3a065a4e3ca6 82 #define D_OPERATION_LED "EK: LED0=Ticker+Button0, LED1=Button1"
prussell 4:3a065a4e3ca6 83
prussell 4:3a065a4e3ca6 84 #elif D_PCB==D_BEACON
prussell 5:ac98ff227ad7 85 const char *pcDeviceName = "FOTA4r5b";
prussell 4:3a065a4e3ca6 86 const char *pcPingBLE = "b4\n"; // May need "\n" to push BLE Tx
prussell 4:3a065a4e3ca6 87
prussell 4:3a065a4e3ca6 88 #define DEBUG(...) {} //Serial Debug not connected
prussell 4:3a065a4e3ca6 89 DigitalIn bB1in(p8); //p0.08 =SW1
prussell 4:3a065a4e3ca6 90 DigitalIn bB2in(p18); //p0.18 =SW2
prussell 4:3a065a4e3ca6 91 InterruptIn B1int(p8); //p0.08 =SW1
prussell 4:3a065a4e3ca6 92 InterruptIn B2int(p18); //p0.18 =SW2
prussell 4:3a065a4e3ca6 93 DigitalOut bLRout(p16); //p0.16 =LEDR
prussell 4:3a065a4e3ca6 94 DigitalOut bLGout(p12); //p0.12 =LEDG
prussell 4:3a065a4e3ca6 95 DigitalOut bLBout(p15); //p0.15 =LEDB
prussell 4:3a065a4e3ca6 96 //PwmOut fLRpwm(p16); float fLRlevel = 0.1; //p0.16 =LEDR, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 97 //PwmOut fLGpwm(p12); float fLGlevel = 0.1; //p0.12 =LEDG, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 98 //PwmOut fLBpwm(p15); float fLBlevel = 0.1; //p0.15 =LEDB, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 99 //AnalogIn adcA(p1); //p0.01 =AIN2
prussell 4:3a065a4e3ca6 100 //AnalogIn adcB(p2); //p0.02 =AIN3
prussell 4:3a065a4e3ca6 101
prussell 4:3a065a4e3ca6 102 #define D_0_LED_TICKER { bLRout=((uTicker1++)&0x01);} // LED Follows Ticker (May also follow a button)
prussell 4:3a065a4e3ca6 103 #define D_1_LED_BUTTON { bLGout = bB1in;} // LED Follows Button
prussell 4:3a065a4e3ca6 104 #define D_2_LED_BUTTON { bLBout = bB2in;} // LED Follows Button
prussell 5:ac98ff227ad7 105 #define D_OPERATION_LED "Beacon: Red=Ticker, Green=SW1, Blue=SW2"
prussell 4:3a065a4e3ca6 106
prussell 4:3a065a4e3ca6 107 #elif D_PCB==D_ATOMWEAR // USBSerial=None, ButtonLED=atomwear, LEDx=Buttonx, LEDw=Buttony|Ticker
prussell 5:ac98ff227ad7 108 const char *pcDeviceName = "FOTA4r5a";
prussell 4:3a065a4e3ca6 109 const char *pcPingBLE = "a\n"; // May need "\n" to push BLE Tx
prussell 4:3a065a4e3ca6 110
prussell 4:3a065a4e3ca6 111 #define DEBUG(...) {} //Serial Debug not connected
prussell 4:3a065a4e3ca6 112 DigitalIn bB1in(p29); //p0.29 =S1
prussell 4:3a065a4e3ca6 113 InterruptIn B1int(p29); //p0.29 =S1
prussell 4:3a065a4e3ca6 114 DigitalOut bLBout(p17); //p0.17 =LEDB
prussell 4:3a065a4e3ca6 115 DigitalOut bLWout(p18); //p0.18 =LEDW
prussell 4:3a065a4e3ca6 116 //PwmOut fLBpwm(p17); float fLBlevel = 0.1; //p0.17 =LEDB, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 117 //PwmOut fLWpwm(p18); float fLWlevel = 0.1; //p0.18 =LEDW, BrightnessFloat(0.0~1.0)
prussell 4:3a065a4e3ca6 118 //AnalogIn adcA(p1); //p0.01 =AIN2
prussell 4:3a065a4e3ca6 119 //AnalogIn adcB(p2); //p0.02 =AIN3
prussell 4:3a065a4e3ca6 120
prussell 4:3a065a4e3ca6 121 #define D_0_LED_TICKER { bLBout=((uTicker1++)&0x01);} // LED Follows Ticker (May also follow a button)
prussell 4:3a065a4e3ca6 122 #define D_1_LED_BUTTON { bLWout = bB1in;} // LED Follows Button
prussell 4:3a065a4e3ca6 123 #define D_OPERATION_LED "Atomwear: Blue=Ticker, White=S1"
prussell 4:3a065a4e3ca6 124
prussell 3:3651f1a58d9e 125 #else
prussell 3:3651f1a58d9e 126 #error Unknown PCB
prussell 3:3651f1a58d9e 127 #endif
prussell 0:aa7314f3fa84 128
prussell 4:3a065a4e3ca6 129 //============================== BLE
prussell 0:aa7314f3fa84 130 BLEDevice ble;
prussell 4:3a065a4e3ca6 131 #if D_BLE_UART==1
prussell 4:3a065a4e3ca6 132 #include "UARTService.h"
prussell 4:3a065a4e3ca6 133 UARTService *uartServicePtr;
prussell 4:3a065a4e3ca6 134 #define D_OPERATION_BLE ", BLE-UART=[Echo typing, and ping on Ticker]\n"
prussell 4:3a065a4e3ca6 135 #else
prussell 4:3a065a4e3ca6 136 #define D_OPERATION_BLE ", BLE-UART not enabled\n"
prussell 4:3a065a4e3ca6 137 #endif
prussell 0:aa7314f3fa84 138
prussell 4:3a065a4e3ca6 139 #include "DeviceInformationService.h"
prussell 4:3a065a4e3ca6 140 //? #include "DFUService.h" //Required if "DFUService dfu(ble)" is explicitely declared
prussell 0:aa7314f3fa84 141
prussell 3:3651f1a58d9e 142 //============================== Handle Button Activity
prussell 3:3651f1a58d9e 143 void onButton(void)
prussell 3:3651f1a58d9e 144 { // Handle any button changes
prussell 3:3651f1a58d9e 145 DEBUG("B\n");
prussell 4:3a065a4e3ca6 146
prussell 4:3a065a4e3ca6 147 D_1_LED_BUTTON; // Update LED from Button
prussell 4:3a065a4e3ca6 148 #ifdef D_2_LED_BUTTON
prussell 4:3a065a4e3ca6 149 D_2_LED_BUTTON; // Update LED from Button
prussell 3:3651f1a58d9e 150 #endif
prussell 3:3651f1a58d9e 151 };
prussell 3:3651f1a58d9e 152
prussell 3:3651f1a58d9e 153 //============================== Handle Ticker1
prussell 3:3651f1a58d9e 154 uint8_t uTicker1;
prussell 3:3651f1a58d9e 155 void onTicker1(void)
prussell 0:aa7314f3fa84 156 {
prussell 3:3651f1a58d9e 157 DEBUG(pcPingUART);
prussell 4:3a065a4e3ca6 158 D_0_LED_TICKER; // Update LED from Ticker
prussell 0:aa7314f3fa84 159
prussell 4:3a065a4e3ca6 160 #if D_BLE_UART==1
prussell 3:3651f1a58d9e 161 if (uartServicePtr != NULL) {
prussell 3:3651f1a58d9e 162 ble.updateCharacteristicValue(uartServicePtr->getRXCharacteristicHandle(), (const uint8_t *)pcPingBLE, strlen(pcPingBLE)); // BLE UART = Ping Message (Max 20char)
prussell 3:3651f1a58d9e 163 }
prussell 4:3a065a4e3ca6 164 #endif
prussell 0:aa7314f3fa84 165 }
prussell 0:aa7314f3fa84 166
prussell 3:3651f1a58d9e 167 //============================== Handle BLE: Disconnect, Written...
prussell 3:3651f1a58d9e 168 void onDisconnect(Gap::Handle_t tHandle, Gap::DisconnectionReason_t eReason)
prussell 0:aa7314f3fa84 169 {
prussell 3:3651f1a58d9e 170 // When BLE Disconnected mkit may output over long DEBUG over USB Serial (Careful of IO clash on other PCBs)
prussell 3:3651f1a58d9e 171 DEBUG("\nBLEi: Callback_BLE_Disconnect(Handle:%d, eReason:0x%02x=", tHandle, eReason );//PR: Occurs properly when click disconnect in App nRFToolbox:HRM
prussell 3:3651f1a58d9e 172 switch(eReason) {
prussell 3:3651f1a58d9e 173 case Gap::REMOTE_USER_TERMINATED_CONNECTION: DEBUG("REMOTE_USER_TERMINATED_CONNECTION"); break;
prussell 3:3651f1a58d9e 174 case Gap::CONN_INTERVAL_UNACCEPTABLE: DEBUG("CONN_INTERVAL_UNACCEPTABLE"); break;
prussell 3:3651f1a58d9e 175 case Gap::LOCAL_HOST_TERMINATED_CONNECTION: DEBUG("LOCAL_HOST_TERMINATED_CONNECTION"); break;
prussell 3:3651f1a58d9e 176 default: DEBUG("UNKNOWN"); break;
prussell 3:3651f1a58d9e 177 }
prussell 3:3651f1a58d9e 178 DEBUG("), Restarting Advertising\n", tHandle, eReason );//PR: Occurs properly when click disconnect in App nRFToolbox:HRM
prussell 5:ac98ff227ad7 179 ble.startAdvertising(); // restart advertising //20150130: Thanks to Wayne Keenan (waynek) for spotting this missing line!!
prussell 0:aa7314f3fa84 180 }
prussell 0:aa7314f3fa84 181
prussell 0:aa7314f3fa84 182 void onDataWritten(const GattCharacteristicWriteCBParams *params)
prussell 0:aa7314f3fa84 183 {
prussell 4:3a065a4e3ca6 184 #if D_BLE_UART==1
prussell 0:aa7314f3fa84 185 if ((uartServicePtr != NULL) && (params->charHandle == uartServicePtr->getTXCharacteristicHandle())) {
prussell 0:aa7314f3fa84 186 uint16_t bytesRead = params->len;
prussell 0:aa7314f3fa84 187 DEBUG("BLE-UART Echo Rx[%u]=[%*s]\n", bytesRead, params->len, params->data);
prussell 0:aa7314f3fa84 188 ble.updateCharacteristicValue(uartServicePtr->getRXCharacteristicHandle(), params->data, bytesRead);
prussell 0:aa7314f3fa84 189 } else {
prussell 3:3651f1a58d9e 190 DEBUG("Unexpected Characteristic Write, Handle:%d\n", params->charHandle);
prussell 0:aa7314f3fa84 191 }
prussell 4:3a065a4e3ca6 192 #else
prussell 4:3a065a4e3ca6 193 DEBUG("Unexpected Characteristic Write, Handle:%d\n", params->charHandle);
prussell 4:3a065a4e3ca6 194 #endif
prussell 0:aa7314f3fa84 195 }
prussell 0:aa7314f3fa84 196
prussell 3:3651f1a58d9e 197 //==============================
prussell 0:aa7314f3fa84 198 int main(void)
prussell 0:aa7314f3fa84 199 {
prussell 3:3651f1a58d9e 200 Ticker ticker1;
prussell 3:3651f1a58d9e 201 ticker1.attach(onTicker1, D_PING_SEC); //Ping Rate
prussell 0:aa7314f3fa84 202
prussell 2:0931d94f42a2 203 DEBUG("BLE Init %s\n", pcDeviceName);
prussell 5:ac98ff227ad7 204 DEBUG("After FOTA loading any unused IO pins may hold previous state, initialize all pins or reset to clear\n");
prussell 0:aa7314f3fa84 205 ble.init();
prussell 3:3651f1a58d9e 206 ble.onDisconnection(onDisconnect);
prussell 2:0931d94f42a2 207 ble.onDataWritten(onDataWritten);
prussell 0:aa7314f3fa84 208
prussell 0:aa7314f3fa84 209 ble.accumulateAdvertisingPayload(GapAdvertisingData::BREDR_NOT_SUPPORTED | GapAdvertisingData::LE_GENERAL_DISCOVERABLE);
prussell 0:aa7314f3fa84 210 ble.accumulateAdvertisingPayload(GapAdvertisingData::SHORTENED_LOCAL_NAME, (const uint8_t *)pcDeviceName, strlen(pcDeviceName));
prussell 0:aa7314f3fa84 211
prussell 0:aa7314f3fa84 212 ble.setAdvertisingType(GapAdvertisingParams::ADV_CONNECTABLE_UNDIRECTED); /* needs to be connectable to allow use of DFUService */
prussell 3:3651f1a58d9e 213 //ble.setAdvertisingInterval(1600); /* 1s; in multiples of 0.625ms. */
prussell 3:3651f1a58d9e 214 ble.setAdvertisingInterval(Gap::MSEC_TO_ADVERTISEMENT_DURATION_UNITS(1000)); //PR: Advertise 1sec (1Hz)
prussell 0:aa7314f3fa84 215 ble.startAdvertising();
prussell 0:aa7314f3fa84 216
prussell 4:3a065a4e3ca6 217 //DeviceInformationService deviceInfo(ble, "ARM", "Model1", "SN1000", "hw-rev1", "fw-rev1");
prussell 4:3a065a4e3ca6 218 DeviceInformationService deviceInfo(ble, "ARM", pcDeviceName, "SN1000", "hw-rev1", "fw-rev1");
prussell 0:aa7314f3fa84 219
prussell 4:3a065a4e3ca6 220 //Enable FOTA DFU
prussell 4:3a065a4e3ca6 221 //? DFUService dfu(ble); // Included implicitely by ble.init() for FOTA platforms, but doing explicitly may be desired for some cases
prussell 0:aa7314f3fa84 222
prussell 4:3a065a4e3ca6 223 #if D_BLE_UART==1
prussell 4:3a065a4e3ca6 224 UARTService uartService(ble); //Setup BLE UART
prussell 0:aa7314f3fa84 225 uartServicePtr = &uartService;
prussell 4:3a065a4e3ca6 226 #endif
prussell 3:3651f1a58d9e 227
prussell 4:3a065a4e3ca6 228 DEBUG(D_OPERATION_LED D_OPERATION_BLE);
prussell 4:3a065a4e3ca6 229 B1int.fall(&onButton); B1int.rise(&onButton); // Button1
prussell 4:3a065a4e3ca6 230 #ifdef D_2_LED_BUTTON
prussell 4:3a065a4e3ca6 231 B2int.fall(&onButton); B2int.rise(&onButton); // Button2
prussell 4:3a065a4e3ca6 232 #endif
prussell 0:aa7314f3fa84 233 for (;;) {
prussell 0:aa7314f3fa84 234 ble.waitForEvent();
prussell 3:3651f1a58d9e 235 }
prussell 0:aa7314f3fa84 236 }
prussell 3:3651f1a58d9e 237 //========== end: main.cpp ==========
prussell 3:3651f1a58d9e 238